Recepción Paquete de Compras

El servicio permite la recepción de paquetes con facturas de compras realizadas y no declaradas por los emisores.

✅ Si los parámetros son correctos → se confirma la recepción del paquete.
❌ Si son incorrectos → devuelve los códigos de error correspondientes.

POST - https://sandbox.cucu.ai/api/v1/invoice/shopping/CreatePackage

🔹 Parámetros

Campo	Tipo	Req	Descripción
posId	Int	✔️	Código punto de venta
branchId	Int	✔️	Id de sucursal
date	String	✔️	Fecha y hora de recepción (yyyy-MM-dd HH:mm:ss)
data	[Array]	✔️	Lista de facturas de compra incluidas

Dentro de data (factura de compra):

Campo	Tipo	Req	Descripción
number	Int	✔️	Número secuencial de la factura
issuerNit	String	✔️	NIT del emisor de la factura
issuerBusinessName	String	✔️	Razón social del emisor
authorizationCode	String	✔️	Código de autorización (CUF)
invoiceNumber	String	✔️	Número de la factura
duiDimNumber	String	❌	Número DUI/DIM si aplica
emissionDate	Date	✔️	Fecha de emisión (yyyy-MM-ddTHH:mm:ss)
totalPurchaseAmount	Decimal	✔️	Monto total de la compra
iceAmount	Decimal	❌	Monto de ICE
iehdAmount	Decimal	❌	Monto de IEHD
ipjAmount	Decimal	❌	Monto de IPJ
rates	Decimal	❌	Tasas
otherNotSubjectToCredit	Decimal	❌	Otros no sujetos a crédito
exemptAmounts	Decimal	❌	Montos exentos
zeroRateAmount	Decimal	❌	Montos a tasa cero
subtotal	Decimal	✔️	Subtotal de la factura
discount	Decimal	❌	Descuentos aplicados
giftCardAmount	Decimal	❌	Tarjeta de regalo aplicada
totalAmountSubjectToVat	Decimal	✔️	Total sujeto a IVA
fiscalCredit	Decimal	✔️	Crédito fiscal calculado
purchaseType	Int	✔️	Tipo de compra (catálogo oficial)
controlCode	String	✔️	Código de control (si aplica)

🔹 Ejemplo Request

{
  "posId": 1,
  "branchId": 1,
  "date": "2025-09-18 23:21:00",
  "data": [
    {
      "number": 1573,
      "issuerNit": "591164023",
      "issuerBusinessName": "CUCU S.R.L",
      "authorizationCode": "2872F72944FB381BDD60E8B5FA151B562316FCB522014FEE907B12F74",
      "invoiceNumber": "1573",
      "duiDimNumber": "0",
      "emissionDate": "2025-09-10T22:30:00",
      "totalPurchaseAmount": 2.00,
      "iceAmount": 0.00,
      "iehdAmount": 0.00,
      "ipjAmount": 0.00,
      "rates": 0.00,
      "otherNotSubjectToCredit": 0.00,
      "exemptAmounts": 0.00,
      "zeroRateAmount": 0.00,
      "subtotal": 2.00,
      "discount": 0.00,
      "giftCardAmount": 0.00,
      "totalAmountSubjectToVat": 2.00,
      "fiscalCredit": 0.26,
      "purchaseType": 5,
      "controlCode": "0"
    }
  ]
}

---

🔹 Ejemplo Response

{
  "message": "COMPLETED",
  "errors": null,
  "success": true,
  "data": {
    "codigoDescripcion": "EN PROCESO",
    "codigoEstado": 5152,
    "codigoRecepcion": "0acd6e59-3c55-47bb-9ea9-23395b1e273e",
    "mensajesList": [
      {
        "codigo": 2220,
        "descripcion": "Archivo registrado con éxito.",
        "advertencia": null,
        "numeroArchivo": null,
        "numeroDetalle": null
      }
    ],
    "transaccion": true
  }
}