✅ 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
codigoRecepciones un identificador que permite luego validar la recepción (endpointValidPackage). - 🔁 El procesamiento puede ser asíncrono en el backend; revisa
codigoEstadoymensajesListpara el resultado final. - ❗ Si necesitas revertir una confirmación, usa el endpoint de Anulación.
