Skip to content

✅ 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ámetroTipoRequeridoDescripción
posIdIntID del Punto de Venta (POS) que envía la solicitud.
branchIdIntID de la sucursal.
cufsArray<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 (endpoint ValidPackage).
  • 🔁 El procesamiento puede ser asíncrono en el backend; revisa codigoEstado y mensajesList para el resultado final.
  • ❗ Si necesitas revertir una confirmación, usa el endpoint de Anulación.