Skip to main content
  • REST: sandbox https://sandbox.cucu.bo/api/v3, producción https://api.cucu.bo/api/v3. Envía X-API-Key y, para cuerpos JSON, Content-Type: application/json.
  • OpenAPI: GET /api/v3/openapi?format=json en ambos hosts. MCP: POST /mcp en esos mismos hosts con X-API-Key (conexión y ejemplos).
  • Errores REST: success: false, error.code, error.traceId y error.docUrl. Para validación, lee error.errors[] (field, code, message). Los campos fuera del esquema se rechazan con 400 VALIDATION_ERROR y UNKNOWN_FIELD.
  • 422 SIAT_REJECTED: lee data.diagnosis y corrige los datos antes de emitir otra vez. Catálogo de errores.

Inicio en cinco pasos

  1. Consigue una API Key de sandbox y prueba GET /api/v3/ping.
  2. Consulta GET /api/v3/points-of-sale. Guarda el id como pointOfSaleId y verifica authorizedSectors.
  3. Consulta los catálogos del SIN del emisor para obtener actividad, producto, unidad y método de pago.
  4. Envía el cuerpo a POST /api/v3/invoices/preview y revisa data.valid y data.validations[].
  5. Emite con el mismo cuerpo y una Idempotency-Key por venta. Reusa la clave y el cuerpo ante un timeout, guarda data.id y data.cuf y consulta data.siatState. Ejemplo ejecutable.