📑 Consulta — Compras a Confirmar

Servicio que permite consultar las compras realizadas y registradas a nuestro NIT en los servidores del SIN.
Devuelve un archivo con las facturas reportadas por los Emisores a una fecha determinada para nuestro NIT.

🔹 Endpoint

POST http://sandbox.cucu.ai/api/v1/invoice/shopping/Consult

🧾 Parámetros (Request)

Parámetro	Tipo	Requerido	Descripción
`posId`	`Int`	✅	ID del Punto de Venta.
`branchId`	`Int`	✅	ID de la sucursal.
`date`	`String`	✅	Fecha de consulta en formato `yyyy-MM-dd HH:mm:ss`.

🔧 Ejemplo Request

json

{
  "posId": 1,
  "branchId": 1,
  "date": "2025-09-04 22:41:00"
}

📬 Ejemplo Response (OK)

El campo data.archivo normalmente contiene un archivo comprimido (base64/gzip).

json

{
  "message": "COMPLETED",
  "errors": null,
  "success": true,
  "data": {
    "archivo": "H4sIAAAAAAAAAO2U3Y6aQBTHufYpCPfKDA4gDbJRPhqTxjRVH2AKs7uzEcbMDGa7T9+BYUXE9Kbt9qYnRuV/fofzNZAB468bgAB4CJlA2+2vA31kQhe4ivEBdM2Gh8AwP6A0w6iFxNwAv53rtrk/UNpHWPjwWh7NM+GCsmppwRmwTFLlrKDV09I67LPpwjLViKoCH1lFltYPIqyHaBLGrBL1UeKYlSeOt1TuCD/TnLJEsmhiKgsrKtOSCsYjN4DQQ8CZh3YvaojjN1btWE7xsdPjQ3wwd7Nvsy+z0B67dVhT4RNb1ZJx+oZV2ipyFr6T+U6AULaeI2+VrOOFG7tJtoYL4ARJMl+vsswLPIjSOUqh5wIfqggU2nfu1rVQl4SzDOey5jiCCPiqg4F2zSU1TWgZgXemu9bII8mfcdNDWytw3CkIpgDtAfjUftR/9R3aA06HlqySbM8kPuppR86sPWShPfLoAFqeGJdkk5MIvKNX2hAiz8WYasQhdnoZU0rTkMQCi96vL7WLSc62bFe/EMliTgqqzscFvOccpBXpK1EtilHui2OA71XiWE1+hF8cGhf193Zq/SQvigYKIvK6SdDfqZeutvKZPsoY86sJDuXbBepWN+e7O+yd3SHXE8moyFVhlwxDuVsAPbHuCKD5ollBL2iCqKe4YAfRqZsiciEKQnus3+UT1T2np/bZ+Jpuk0263aej6GtqEtq/fkn863fffzOMn8NfUO8ACAAA",
    "mensajesList": [
      {
        "codigo": 2222,
        "descripcion": "Consulta realizada con éxito.",
        "advertencia": null,
        "numeroArchivo": null,
        "numeroDetalle": null
      }
    ],
    "transaccion": true
  }
}

⚠️ Consideraciones

🗜️ data.archivo suele ser un contenido comprimido (gzip) codificado en base64. Para obtener el archivo real: decodifica Base64 → descomprime gzip → obtendrás el archivo (por ejemplo CSV o JSON según implementación).
⏱️ La consulta puede devolver mucho contenido según la fecha; usa filtros de fecha para reducir tamaño.
🔒 Asegúrate de que las cabeceras y autenticación (si aplica) estén correctamente enviadas.

📑 Consulta — Compras a Confirmar ​

🔹 Endpoint ​

🧾 Parámetros (Request) ​

🔧 Ejemplo Request ​

📬 Ejemplo Response (OK) ​