Acceso Publico

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.

Informacion de la factura

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

window.open('https://sandbox.cucu.bo/api/v1/public/invoice/{cuf}/pdf');

import requests

response = requests.get(
    'https://sandbox.cucu.bo/api/v1/public/invoice/{cuf}/pdf'
)
with open('factura.pdf', 'wb') as f:
    f.write(response.content)

Descargar Ticket (80mm)

GET /api/v1/public/invoice/{cuf}/ticket

Descarga la factura en formato ticket para impresoras de 80mm (diseno CUCU).

Descargar Ticket SIAT (formato oficial)

GET /api/v1/public/invoice/{cuf}/ticketsiat

Descarga el ticket replicando la Representacion Grafica oficial de impuestos.gob.bo: mismo diseno que el documento que emite el SIN (tipografia con serifa, separadores punteados, detalle de items linea por linea, totales, leyendas fiscales y QR). Util cuando el cliente necesita un ticket identico al formato del impuesto.

curl -O https://sandbox.cucu.bo/api/v1/public/invoice/2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74/ticketsiat

window.open('https://sandbox.cucu.bo/api/v1/public/invoice/{cuf}/ticketsiat');

Descargar Chititicket (ticket reducido)

GET /api/v1/public/invoice/{cuf}/chititicket

Descarga un ticket reducido (formato POS): incluye emisor y sucursal, NIT / N° de factura / codigo de autorizacion, datos del cliente (razon social y NIT/CI/CEX), totales, importe literal y QR. No incluye el detalle de items ni las leyendas largas — pensado para impresion rapida en punto de venta.

curl -O https://sandbox.cucu.bo/api/v1/public/invoice/2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74/chititicket

window.open('https://sandbox.cucu.bo/api/v1/public/invoice/{cuf}/chititicket');

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

GET /f/{cuf}

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.

Información General

Endpoints Disponibles

Documentos Sector

Utilidades y Soporte

Informacion de la factura

Path Parameters

Descargar PDF (A4)

Descargar Ticket (80mm)

Descargar Ticket SIAT (formato oficial)

Descargar Chititicket (ticket reducido)

Descargar XML

Descargar ZIP

Pagina de verificacion

​Informacion de la factura

​Path Parameters

​Descargar PDF (A4)

​Descargar Ticket (80mm)

​Descargar Ticket SIAT (formato oficial)

​Descargar Chititicket (ticket reducido)

​Descargar XML

​Descargar ZIP

​Pagina de verificacion

Informacion de la factura

Path Parameters

Descargar PDF (A4)

Descargar Ticket (80mm)

Descargar Ticket SIAT (formato oficial)

Descargar Chititicket (ticket reducido)

Descargar XML

Descargar ZIP

Pagina de verificacion