✅ Confirmación de Compras
Servicio que permite confirmar las compras registradas por los Emisores en el Registro de Compras y Ventas (RCV) a nuestro NIT.
Si los parámetros son correctos → se confirma la(s) compra(s). Si no → devuelve códigos de error.
🔹 Endpoint
POST http://sandbox.cucu.ai/api/v1/invoice/shopping/Confirm
🧾 Parámetros (Request)
Parámetro | Tipo | Requerido | Descripción |
---|---|---|---|
posId | Int | ✅ | ID del Punto de Venta (POS) que envía la solicitud. |
branchId | Int | ✅ | ID de la sucursal. |
cufs | Array<String> | ✅ | Lista de CUF/authorizationCode a confirmar (ej. ["2872..."] ). |
Formato de fecha: No aplica en este endpoint.
Nota: cufs
puede contener uno o varios CUF; el servicio procesará cada uno.
🔧 Ejemplo Request
json
{
"posId": 1,
"branchId": 1,
"cufs": [
"2872F72944FB381BDD60E8B5FA151B562316FCB522014FEE907B12F74"
]
}
📬 Ejemplo Response (OK)
json
{
"message": "COMPLETED",
"errors": null,
"success": true,
"data": {
"codigoDescripcion": "EN PROCESO",
"codigoEstado": 5152,
"codigoRecepcion": "9ddb2c9c-35ab-4199-bdf3-dff68ccfd635",
"mensajesList": [
{
"codigo": 2220,
"descripcion": "Archivo registrado con éxito.",
"advertencia": null,
"numeroArchivo": null,
"numeroDetalle": null
}
],
"transaccion": true
}
}
⚠️ Consideraciones
- ▶️ El campo
codigoRecepcion
es un identificador que permite luego validar la recepción (endpointValidPackage
). - 🔁 El procesamiento puede ser asíncrono en el backend; revisa
codigoEstado
ymensajesList
para el resultado final. - ❗ Si necesitas revertir una confirmación, usa el endpoint de Anulación.