- REST: sandbox
https://sandbox.cucu.bo/api/v3, producciónhttps://api.cucu.bo/api/v3. EnvíaX-API-Keyy, para cuerpos JSON,Content-Type: application/json. - OpenAPI:
GET /api/v3/openapi?format=jsonen ambos hosts. MCP:POST /mcpen esos mismos hosts conX-API-Key(conexión y ejemplos). - Errores REST:
success: false,error.code,error.traceIdyerror.docUrl. Para validación, leeerror.errors[](field,code,message). Los campos fuera del esquema se rechazan con400 VALIDATION_ERRORyUNKNOWN_FIELD. 422 SIAT_REJECTED: leedata.diagnosisy corrige los datos antes de emitir otra vez. Catálogo de errores.
Inicio en cinco pasos
- Consigue una API Key de sandbox y prueba
GET /api/v3/ping. - Consulta
GET /api/v3/points-of-sale. Guarda elidcomopointOfSaleIdy verificaauthorizedSectors. - Consulta los catálogos del SIN del emisor para obtener actividad, producto, unidad y método de pago.
- Envía el cuerpo a
POST /api/v3/invoices/previewy revisadata.validydata.validations[]. - Emite con el mismo cuerpo y una
Idempotency-Keypor venta. Reusa la clave y el cuerpo ante un timeout, guardadata.idydata.cufy consultadata.siatState. Ejemplo ejecutable.