curl -X POST "https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cancel-administrative" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "resolucionAdministrativa": "Resolucion Administrativa N° 0001/2026", "motivo": 1 }'
const response = await fetch(
'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cancel-administrative',
{
method: 'POST',
headers: {
'X-API-Key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
resolucionAdministrativa: 'Resolucion Administrativa N° 0001/2026',
motivo: 1
})
}
);
const data = await response.json();
import requests
response = requests.post(
'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cancel-administrative',
headers={'X-API-Key': 'YOUR_API_KEY'},
json={'resolucionAdministrativa': 'Resolucion Administrativa N° 0001/2026', 'motivo': 1}
)
print(response.json())
{
"success": true,
"message": "Factura anulada administrativamente (fuera de plazo) exitosamente",
"data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"invoiceNumber": 5,
"cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
"siatState": "CANCELLED",
"cancellationType": "ADMINISTRATIVE",
"administrativeResolution": "Resolucion Administrativa N° 0001/2026",
"siatCodeState": 690
},
"timestamp": "2026-07-19T14:00:00"
}
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"details": "resolucionAdministrativa: El número de Resolución Administrativa de Aprobación del SIN es obligatorio"
},
"timestamp": "2026-07-19T14:00:00"
}
{
"success": false,
"error": {
"code": "CONFLICT",
"details": "La factura ya está anulada"
},
"timestamp": "2026-07-19T14:00:00"
}
Endpoints Disponibles
Anulación Administrativa (fuera de plazo)
Registra una anulación fuera de plazo aprobada por Resolución Administrativa del SIN (RND 102600000025).
POST
/
api
/
v1
/
invoices
/
{id}
/
cancel-administrative
curl -X POST "https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cancel-administrative" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "resolucionAdministrativa": "Resolucion Administrativa N° 0001/2026", "motivo": 1 }'
const response = await fetch(
'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cancel-administrative',
{
method: 'POST',
headers: {
'X-API-Key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
resolucionAdministrativa: 'Resolucion Administrativa N° 0001/2026',
motivo: 1
})
}
);
const data = await response.json();
import requests
response = requests.post(
'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cancel-administrative',
headers={'X-API-Key': 'YOUR_API_KEY'},
json={'resolucionAdministrativa': 'Resolucion Administrativa N° 0001/2026', 'motivo': 1}
)
print(response.json())
{
"success": true,
"message": "Factura anulada administrativamente (fuera de plazo) exitosamente",
"data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"invoiceNumber": 5,
"cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
"siatState": "CANCELLED",
"cancellationType": "ADMINISTRATIVE",
"administrativeResolution": "Resolucion Administrativa N° 0001/2026",
"siatCodeState": 690
},
"timestamp": "2026-07-19T14:00:00"
}
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"details": "resolucionAdministrativa: El número de Resolución Administrativa de Aprobación del SIN es obligatorio"
},
"timestamp": "2026-07-19T14:00:00"
}
{
"success": false,
"error": {
"code": "CONFLICT",
"details": "La factura ya está anulada"
},
"timestamp": "2026-07-19T14:00:00"
}
Registra la anulación de una factura fuera del plazo del servicio web (venció el día 9 del mes
siguiente a la emisión, o la factura ya fue usada en una Declaración Jurada).
Este procedimiento fue habilitado por la RND 102600000025 (13/07/2026), que modifica el Art. 38 de la
RND 102100000011. La anulación fuera de plazo es un trámite administrativo ante la Gerencia Distrital o
GRACO: el contribuyente presenta la solicitud con documentación de respaldo y el SIN, si la aprueba, emite
una Resolución Administrativa (notificada por buzón tributario, en un plazo de hasta 6 meses) y ajusta
el estado del documento en su base.
Este endpoint no llama al SIAT: el SIN ya aprobó y ajustó la anulación en su base. Sólo se usa
después de recibir la Resolución Administrativa de Aprobación, para reflejar la anulación
localmente. Para anular dentro de plazo use Anular Factura.
La factura queda en estado
CANCELLED con cancellationType: "ADMINISTRATIVE" y el número de
Resolución en administrativeResolution. Esta anulación no es reversible por servicio web
(Revertir Anulación la rechaza); cualquier reversión se gestiona ante el SIN.Path Parameters
| Parametro | Tipo | Req | Descripcion |
|---|---|---|---|
id | string | Si | UUID de la factura a anular |
Body
| Campo | Tipo | Req | Descripcion |
|---|---|---|---|
resolucionAdministrativa | string | Si | Número de la Resolución Administrativa de Aprobación emitida por el SIN |
motivo | integer | No | Código del catálogo SIAT de motivos de anulación (ver Catálogos, cancellation-reasons). Default: 1 |
Headers
| Parametro | Tipo | Req | Descripcion |
|---|---|---|---|
X-API-Key | string | Si | Tu API Key |
curl -X POST "https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cancel-administrative" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "resolucionAdministrativa": "Resolucion Administrativa N° 0001/2026", "motivo": 1 }'
const response = await fetch(
'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cancel-administrative',
{
method: 'POST',
headers: {
'X-API-Key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
resolucionAdministrativa: 'Resolucion Administrativa N° 0001/2026',
motivo: 1
})
}
);
const data = await response.json();
import requests
response = requests.post(
'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cancel-administrative',
headers={'X-API-Key': 'YOUR_API_KEY'},
json={'resolucionAdministrativa': 'Resolucion Administrativa N° 0001/2026', 'motivo': 1}
)
print(response.json())
{
"success": true,
"message": "Factura anulada administrativamente (fuera de plazo) exitosamente",
"data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"invoiceNumber": 5,
"cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
"siatState": "CANCELLED",
"cancellationType": "ADMINISTRATIVE",
"administrativeResolution": "Resolucion Administrativa N° 0001/2026",
"siatCodeState": 690
},
"timestamp": "2026-07-19T14:00:00"
}
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"details": "resolucionAdministrativa: El número de Resolución Administrativa de Aprobación del SIN es obligatorio"
},
"timestamp": "2026-07-19T14:00:00"
}
{
"success": false,
"error": {
"code": "CONFLICT",
"details": "La factura ya está anulada"
},
"timestamp": "2026-07-19T14:00:00"
}