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}.

Método	URL
POST	/API_V1/ordenes/agregar

Ejemplo

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

Clave	Tipo	Descripción
id	String(32)	Identificador de la orden en el Fenicio origen.
moneda	String(4)	Código ISO 4217 de la moneda. Ejemplo: UYU
codigoTributario	String(32) | null	Número de registro tributario de la empresa.
razonSocial	String(64) | null	Nombre legal de la empresa.
comprador	Comprador	Datos del comprador.
items	List<Item>	Detalle de los productos que contiene la orden.
pago	Pago | null	Datos del pago realizado para la orden.
entrega	idTipoEnvio | null	ID del tipo de envío asignado en la tienda de destino para esa orden.
	idSucursal | null	ID de la sucursal asignada en la tienda de destino para esa orden.
	Entrega | null	Datos de como se entregará la orden realizada. (Localidades utilizar el formato Fenicio).
direccionfacturacion	Direccion | null	Datos de facturación asociados al medio de pago utilizado en la orden. Puede coincidir o no con la dirección de envío.
observaciones	String (255) | null	Observaciones generales de la orden.

Ejemplo

Orden con envío

{
 "id": "6",
    "moneda": "UYU",
    "codigoTributario": "215555680000",
    "razonSocial": "RIO SA",
    "comprador": {
        "nombre": "Ana",
        "apellido": "Castro",
        "documento": {
            "nro": "215555680000",
            "tipo": "pasaporte",
            "pais": "uy"
        },
        "email": "[e-mail]",
        "telefono": "[phone]"
    },
    "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

{
 "id": "6",
    "moneda": "UYU",
    "codigoTributario": "215555680000",
    "razonSocial": "RIO SA",
    "comprador": {
        "nombre": "Ana",
        "apellido": "Castro",
        "documento": {
            "nro": "215555680000",
            "tipo": "pasaporte",
            "pais": "uy"
        },
        "email": "[e-mail]",
        "telefono": "[phone]"
    },
    "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

Clave	Tipo	Descripción
error	Boolean	Valor booleano que indica si se generó algún error en la consulta.
msj	String	Mensaje descriptivo con el número de venta correspondiente en la tienda de destino.