curl -X GET https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status \
-H "X-API-Key: YOUR_API_KEY"
const response = await fetch(
'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status',
{ headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const data = await response.json();
import requests
response = requests.get(
'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status',
headers={'X-API-Key': 'YOUR_API_KEY'}
)
print(response.json())
{
"success": true,
"data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"invoiceNumber": 5,
"cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
"state": "VALIDATED",
"siatCode": 908,
"siatDescription": "FACTURA VALIDADA",
"emissionType": "NORMAL",
"lastChecked": "2026-02-11T14:30:00"
},
"timestamp": "2026-02-11T14:30:00"
}
Endpoints Disponibles
Estado de Factura
Verifica el estado actual de una factura ante el SIAT.
GET
/
api
/
v1
/
invoices
/
{id}
/
status
curl -X GET https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status \
-H "X-API-Key: YOUR_API_KEY"
const response = await fetch(
'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status',
{ headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const data = await response.json();
import requests
response = requests.get(
'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status',
headers={'X-API-Key': 'YOUR_API_KEY'}
)
print(response.json())
{
"success": true,
"data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"invoiceNumber": 5,
"cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
"state": "VALIDATED",
"siatCode": 908,
"siatDescription": "FACTURA VALIDADA",
"emissionType": "NORMAL",
"lastChecked": "2026-02-11T14:30:00"
},
"timestamp": "2026-02-11T14:30:00"
}
Consulta el estado mas reciente de una factura directamente en el SIAT. Util para verificar si una factura fue procesada correctamente o si cambio de estado.
Estados posibles (
Anulacion (
Cuando
Si la anulacion se revierte, la factura vuelve a
Path Parameters
| Parametro | Tipo | Req | Descripcion |
|---|---|---|---|
id | string | Si | UUID de la factura |
Headers
| Parametro | Tipo | Req | Descripcion |
|---|---|---|---|
X-API-Key | string | Si | Tu API Key |
curl -X GET https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status \
-H "X-API-Key: YOUR_API_KEY"
const response = await fetch(
'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status',
{ headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const data = await response.json();
import requests
response = requests.get(
'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status',
headers={'X-API-Key': 'YOUR_API_KEY'}
)
print(response.json())
{
"success": true,
"data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"invoiceNumber": 5,
"cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
"state": "VALIDATED",
"siatCode": 908,
"siatDescription": "FACTURA VALIDADA",
"emissionType": "NORMAL",
"lastChecked": "2026-02-11T14:30:00"
},
"timestamp": "2026-02-11T14:30:00"
}
Estados posibles (siatState)
| Estado | Descripcion |
|---|---|
PENDING | Factura creada, pendiente de envio al SIAT |
PROCESSING | En proceso de recepcion/validacion en el SIAT |
VALIDATED | Validada exitosamente por el SIAT |
ACCEPTED | Recibida por el SIAT, pendiente de validacion final |
REJECTED | Rechazada por el SIAT (ver codigo de error) |
CANCELLED | Anulada |
OFFLINE_PENDING | Emitida en modo offline/contingencia, pendiente de envio en paquete |
ERROR | Error interno al procesar la factura |
Anulacion (cancellationType)
Cuando siatState es CANCELLED, el campo cancellationType indica como se anulo:
| Valor | Descripcion |
|---|---|
SIAT | Anulacion por servicio web, dentro de plazo (hasta el dia 9 del mes siguiente) |
ADMINISTRATIVE | Anulacion fuera de plazo aprobada por Resolucion Administrativa del SIN (RND 102600000025). El campo administrativeResolution trae el numero de Resolucion. Ver Anulacion Administrativa |
VALIDATED y
cancellationType vuelve a null: una factura vigente nunca arrastra el tipo de una
anulacion que ya no existe.