Estos endpoints son publicos y no requieren API Key. El CUF (Codigo Unico de Factura) actua como token de acceso.
Los URLs de descarga se incluyen en la respuesta al crear una factura. Puedes compartirlos directamente con tus clientes.
GET /api/v1/public/invoice/{cuf}
Path Parameters
| Parametro | Tipo | Req | Descripcion |
|---|
cuf | string | Si | Codigo Unico de Factura |
{
"success": true,
"data": {
"invoiceNumber": 5,
"state": "VALIDATED",
"amountTotal": 500.00,
"clientBusinessName": "EMPRESA DEMO S.R.L.",
"emissionDate": "2026-02-11T12:00:00",
"downloads": {
"pdf": "/api/v1/public/invoice/{cuf}/pdf",
"ticket": "/api/v1/public/invoice/{cuf}/ticket",
"xml": "/api/v1/public/invoice/{cuf}/xml",
"zip": "/api/v1/public/invoice/{cuf}/zip"
}
}
}
Descargar PDF (A4)
GET /api/v1/public/invoice/{cuf}/pdf
Descarga la factura en formato PDF tamano A4.
curl -O https://sandbox.cucu.bo/api/v1/public/invoice/2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74/pdf
Descargar Ticket (80mm)
GET /api/v1/public/invoice/{cuf}/ticket
Descarga la factura en formato ticket para impresoras de 80mm.
Descargar XML
GET /api/v1/public/invoice/{cuf}/xml
Descarga el XML firmado digitalmente de la factura.
Descargar ZIP
GET /api/v1/public/invoice/{cuf}/zip
Descarga un ZIP que contiene: PDF A4 + Ticket 80mm + XML firmado.
Pagina de verificacion
Pagina web publica de verificacion de la factura o nota credito/debito. Muestra los datos completos del documento en formato visual con QR, ideal para compartir con clientes o verificar la autenticidad del documento.
https://sandbox.cucu.bo/f/2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74
El endpoint /f/{cuf} funciona tanto para facturas como para notas de credito/debito. Cada documento tiene su propio CUF unico.
Todos los archivos incluyen el header Cache-Control: public, max-age=31536000. Las facturas son inmutables una vez emitidas.