cucuDocumento

Descripción

Descarga el PDF (A4), el XML firmado, el ticket de 80 mm, el ticket SIAT, el mini-ticket o el ZIP de una factura (enlaces públicos: el CUF hace de credencial), o reenvía la factura por email al cliente u otra dirección. La descarga se devuelve en base64.

Forma parte del Hub Fiscal de Bolivia como alternativa a la conexión directa con el SIAT: CUCU es un proveedor autorizado que se ocupa de la firma, los códigos CUIS/CUFD y el envío al SIN. Nodo: «Descargar o enviar documento».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial cucu
operation	select	No	Operación — download, email
invoice_id	text	No	ID de la factura (UUID) — El id que devuelve CUCU al emitir. Si lo dejas vacío, indica el CUF
cuf	text	No	CUF — Código Único de Factura. Se usa si no indicas el ID
format	select	No	Formato — pdf, xml, ticket, ticketsiat, chititicket, zip, info
email	text	No	Email de destino — Solo al reenviar. Vacío = el email original del cliente
include_content	boolean	No	Devolver el contenido (base64) — Desactívalo si solo necesitas la URL
max_mb	number	No	Tamaño máximo (MB)
output_key	text	No	Clave de salida — El resultado se añade a data[clave] sin perder el resto de datos

Credenciales

Este módulo requiere una credencial de tipo cucu con los campos:

• API key: empieza por sk_test_ (sandbox) o sk_live_ (producción); el entorno se deduce del prefijo
• Entorno: automático, pruebas o producción (si contradice la clave, no se envía nada)
• Punto de venta por defecto (UUID): se usa si el nodo no indica uno
• ID de empresa (UUID): para sucursales y estado del certificado
• Secreto de webhooks (whsec_…): para verificar la firma de los eventos

Salida

{
  "operation": "download",
  "format": "pdf",
  "filename": "factura_2872F7294502.pdf",
  "content_type": "application/pdf",
  "size": 48213,
  "content_base64": "JVBERi0xLjQ…",
  "url": "https://api.cucu.bo/api/v1/public/invoice/2872F…/pdf"
}

La salida se guarda en la clave configurada (output_key, por defecto cucu) y se conserva el resto de data. En error: error.message, error.type y, si aplica, status, code y siat_code.

Ejemplo de Uso

{
  "credentials_id": "cred-cucu",
  "operation": "download",
  "cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
  "format": "pdf"
}

Notas

• Formatos: pdf, ticket, ticketsiat, chititicket, xml y zip. Las descargas son públicas: el CUF hace de credencial y NO se envía la API key.
• El contenido va en base64 (se puede desactivar para obtener solo la URL). Hay un tope de tamaño configurable.
• También reenvía la factura por email (a otro destinatario si se indica).

Nodos Relacionados

• cucuEmitirFactura - Emitir factura
• cucuConsultar - Consultar facturas