# 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#usuario"><strong>Usuario</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#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#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#ordenentrega"><strong>OrdenEntrega</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#direccionfacturacion"><strong>DireccionFacturación</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>