# Inserción de venta

Permite ingresar una orden en una tienda Fenicio.

## Request

Se deberá realizar un llamado `POST` a la URL correspondiente, siendo el último segmento `{agregar}.`

<table data-full-width="false"><thead><tr><th width="135">Método</th><th>URL</th></tr></thead><tbody><tr><td><code>POST</code></td><td><code>/API_V1/ordenes/agregar</code></td></tr></tbody></table>

### Ejemplo

`https://example.com/API_V1/ordenes/agregar`

<table><thead><tr><th width="218">Clave</th><th width="270">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>id</code></strong> </td><td>String(32)</td><td>Identificador de la orden en el  Fenicio origen.</td></tr><tr><td><strong><code>moneda</code></strong></td><td>String(4)</td><td>Código ISO 4217 de la moneda. Ejemplo: UYU</td></tr><tr><td><strong><code>codigoTributario</code></strong></td><td>String(32) | null</td><td>Número de registro tributario de la empresa.</td></tr><tr><td><strong><code>razonSocial</code></strong></td><td>String(64) | null</td><td>Nombre legal de la empresa.</td></tr><tr><td><strong><code>comprador</code></strong></td><td><a href="../../referencia/modelos-de-datos/api-v1#comprador"><strong>Comprador</strong></a></td><td>Datos del comprador.</td></tr><tr><td><strong><code>items</code></strong></td><td>List&#x3C;<a href="../../referencia/modelos-de-datos/api-v1#item"><strong>Item</strong></a>></td><td>Detalle de los productos que contiene la orden.</td></tr><tr><td><strong><code>pago</code></strong></td><td><a href="../../referencia/modelos-de-datos/api-v1#pago"><strong>Pago</strong></a> | null</td><td>Datos del pago realizado para la orden.</td></tr><tr><td><strong><code>entrega</code></strong></td><td>idTipoEnvio | null</td><td>ID del tipo de envío asignado en la tienda de destino para esa orden.</td></tr><tr><td></td><td>idSucursal | null</td><td>ID de la sucursal asignada en la tienda de destino para esa orden.</td></tr><tr><td></td><td><a href="../../referencia/modelos-de-datos/api-v1#entrega"><strong>Entrega</strong></a> | null</td><td>Datos de como se entregará la orden realizada. (Localidades <a href="../../referencia/descargables#csv-localidades-fenicio">utilizar el formato Fenicio</a>).</td></tr><tr><td><strong><code>direccionfacturacion</code></strong></td><td><a href="../../referencia/modelos-de-datos/api-v1#direccion"><strong>Direccion</strong></a>  | null</td><td>Datos de facturación asociados al medio de pago utilizado en la orden. Puede coincidir o no con la dirección de envío.</td></tr><tr><td><strong><code>observaciones</code></strong></td><td>String (255) | null</td><td>Observaciones generales de la orden.</td></tr></tbody></table>

### Ejemplo <a href="#ejemplo-1" id="ejemplo-1"></a>

#### Orden con envío

```json
{
 "id": "6",
    "moneda": "UYU",
    "codigoTributario": "215555680000",
    "razonSocial": "RIO SA",
    "comprador": {
        "nombre": "Ana",
        "apellido": "Castro",
        "documento": {
            "nro": "215555680000",
            "tipo": "pasaporte",
            "pais": "uy"
        },
        "email": "anacastro@gmail.com",
        "telefono": "+59899999999"
    },
    "items": [
        {
          "sku": "1:pulp01:pulp01:U:1",
          "nombre": "Pulsera plata",
          "cantidad": 1,
          "cantidadRegalo": 1,
          "importe": 600
        },
        {
          "sku": "1:camul01:camul01:s:1",
          "nombre": "Camisa multicolor",
          "cantidad": 2,
          "cantidadRegalo": 1,
          "importe": 800
        },
        {
          "sku": "1:pulor02:pulor02:U:1",
          "nombre": "Pulsera de cadena de oro",
          "cantidad": 1,
          "cantidadRegalo": 0,
          "importe": 1700
        },
        {
          "sku": "1:Base:azul:m:1",
          "nombre": "Remeras",
          "cantidad": 1,
          "cantidadRegalo": 1,
          "importe": 640
        }
    ],
    "pago": {
        "id": 123,
        "metodo": "Visa",
        "importe": 4640,
        "cuotas": 1,
        "moneda": "UYU",
        "autorizacion": "56789"
    },
    "entrega": {
        "tipo": "ENVIO",
        "idTipoEnvio": 1,
        "destinatario": "Sara Castro",
        "franjaHoraria": {
            "desde": "2025-01-15T09:09:00-0300",
            "hasta": "2025-01-15T18:21:00-0300"
        },
        "costo": 100,
        "direccion": {
            "idLocalidad": 1,
            "calle": "Pablo de María",
            "nroPuerta": "1011",
            "nroApartamento": "5",
            "codigoPostal": 11100,
            "latitud": -34.904840,
            "longitud": -56.166982,
            "observaciones": "Observaciones de la dirección"
        },
        "destinatario": "Pedro perez"
    },
    "direccionFacturacion": {
        "idLocalidad": 1,
        "calle": "Jose Ellauri",
        "nroPuerta": "780",
        "nroApartamento": "2",
        "codigoPostal": 11300,
        "latitud": -34.917402,
        "longitud": -56.1555789,
        "observaciones": "Observaciones de la dirección"
    },
    "observaciones": "Observaciones de la compra"
}
```

#### Orden con retiro

```json
{
 "id": "6",
    "moneda": "UYU",
    "codigoTributario": "215555680000",
    "razonSocial": "RIO SA",
    "comprador": {
        "nombre": "Ana",
        "apellido": "Castro",
        "documento": {
            "nro": "215555680000",
            "tipo": "pasaporte",
            "pais": "uy"
        },
        "email": "anacastro@gmail.com",
        "telefono": "+59899999999"
    },
    "items": [
        {
          "sku": "1:pulp01:pulp01:U:1",
          "nombre": "Pulsera plata",
          "cantidad": 1,
          "cantidadRegalo": 1,
          "importe": 600
        },
        {
          "sku": "1:camul01:camul01:s:1",
          "nombre": "Camisa multicolor",
          "cantidad": 2,
          "cantidadRegalo": 1,
          "importe": 800
        },
        {
          "sku": "1:pulor02:pulor02:U:1",
          "nombre": "Pulsera de cadena de oro",
          "cantidad": 1,
          "cantidadRegalo": 0,
          "importe": 1700
        },
        {
          "sku": "1:Base:azul:m:1",
          "nombre": "Remeras",
          "cantidad": 1,
          "cantidadRegalo": 1,
          "importe": 640
        }
    ],
    "pago": {
        "id": 123,
        "metodo": "Visa",
        "importe": 4640,
        "cuotas": 1,
        "moneda": "UYU",
        "autorizacion": "56789"
    },
   "entrega": {
        "tipo": "RETIRO",
        "retira": "Prueba Retira",
        "codigoSucursal": "sucen"
   },
        "destinatario": "Pedro perez"
    },
    "direccionFacturacion": {
        "idLocalidad": 1,
        "calle": "Jose Ellauri",
        "nroPuerta": "780",
        "nroApartamento": "2",
        "codigoPostal": 11300,
        "latitud": -34.917402,
        "longitud": -56.1555789,
        "observaciones": "Observaciones de la dirección"
    },
    "observaciones": "Observaciones de la compra"
}
```

## Response

<table><thead><tr><th width="131">Clave</th><th width="134">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>error</code></strong></td><td>Boolean</td><td>Valor booleano que indica si se generó algún error en la consulta.</td></tr><tr><td><strong><code>msj</code></strong></td><td>String</td><td>Mensaje descriptivo con el número de venta correspondiente en la tienda de destino.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guia.fenicio.help/developers/api-v1/insercion-de-venta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.