Skip to main content

​
API Reference

REST API para facturacion electronica Bolivia. JSON, paginada, versionada.

​
URL Base

Sandbox

https://sandbox.cucu.bo
SIAT Piloto — facturas de prueba, sin validez fiscal. Gratis, sin limites.

Produccion

https://api.cucu.bo
SIAT Produccion — facturas fiscalmente validas ante el SIN.

​
Autenticacion

Todas las llamadas autenticadas requieren el header X-API-Key: 
curl -X GET https://sandbox.cucu.bo/api/v1/invoices \
  -H "X-API-Key: YOUR_API_KEY"
La key sk_test_ de arriba es de demo — usala libremente para probar sin registrarte. Ver Autenticacion para mas detalles.

​
Formato de respuesta

Todas las respuestas usan el wrapper estandar ApiResponse: 
{
  "success": true,
  "message": "Operacion exitosa",
  "data": {
    // Datos del recurso
  },
  "error": null,
  "timestamp": "2026-02-11T12:00:00"
}
CampoTipoDescripcion
successbooleantrue si la operacion fue exitosa
messagestringMensaje descriptivo (puede ser null)
dataobjectDatos del recurso o resultado
errorobjectDetalle del error (null si exito)
timestampstringFecha/hora ISO 8601

​
Paginacion

Los endpoints de listado usan paginacion con page y size: 
GET /api/v1/invoices?page=0&size=20

{
  "success": true,
  "data": {
    "content": [ /* ... array de recursos ... */ ],
    "page": 0,
    "size": 20,
    "totalElements": 150,
    "totalPages": 8,
    "first": true,
    "last": false
  }
}
ParametroTipoDefaultDescripcion
pageinteger0Numero de pagina (base 0)
sizeinteger20Elementos por pagina (max 50)

​
Content-Type

Todas las peticiones con body requieren: 
Content-Type: application/json

​
Versionado

La API usa versionado en la URL: /api/v1/. Cambios breaking se anuncian con anticipacion y se introducen en una nueva version (/api/v2/).

​
Tipos de documento sector

Todos los tipos de documento usan el endpoint unificado POST /api/v1/invoices con el campo invoiceType en el body.
codigoDocumentoSectorinvoiceTypeDocumento SectorModalidad
1ELECTRONIC_SALECompra VentaElectronica
1COMPUTERIZED_SALECompra VentaComputarizada
2NOTE_CREDIT_DEBITNota Credito-DebitoElectronica
3ELECTRONIC_EXPORTExportacionElectronica
3COMPUTERIZED_EXPORTExportacionComputarizada
4ELECTRONIC_FREE_ZONEZona FrancaElectronica
5ELECTRONIC_DUTY_FREETasa CeroElectronica
8ELECTRONIC_SECTOR_EDUCATIONSector EducativoElectronica
8COMPUTERIZED_SECTOR_EDUCATIONSector EducativoComputarizada
10ELECTRONIC_HEALTH_SERVICEServicios de SaludElectronica
11ELECTRONIC_BASIC_SERVICEServicios BasicosElectronica
13ELECTRONIC_AIRLINEAerolineasElectronica
14ELECTRONIC_HOTELAlojamientoElectronica
14COMPUTERIZED_HOTELAlojamientoComputarizada
15ELECTRONIC_HOSPITALHospitales y ClinicasElectronica
15COMPUTERIZED_HOSPITALHospitales y ClinicasComputarizada
16ELECTRONIC_GAMES_LUCKJuegos de AzarElectronica
18ELECTRONIC_TELECOMTelecomunicacionesElectronica
18COMPUTERIZED_TELECOMTelecomunicacionesComputarizada
23ELECTRONIC_FINANCIALEntidades FinancierasElectronica
24ELECTRONIC_INSURANCESegurosElectronica
24COMPUTERIZED_INSURANCESegurosComputarizada
Cada tipo de documento sector puede requerir campos adicionales en el request body. Ver la referencia de cada sector para los campos especificos.

​
Endpoints disponibles

Facturas

Crear, listar, obtener, cancelar facturas. El core de la API.

Contingencia

Manejo de eventos offline cuando el SIAT no esta disponible.

Codigos SIAT

Verificacion de NIT, CUFD y comunicacion con el SIAT.

Catalogos

Sincronizacion y consulta de catalogos del SIN.

Acceso publico

Descarga publica de PDF, XML, ZIP por CUF.

AI & RAG

Chat, validacion inteligente y resolucion de errores con AI.