facturaBoDocumento

Descripción

Descarga el PDF (A4), el ticket de 80 mm o el XML fiscal de una factura (enlaces públicos que no caducan: 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: factura.bo (SimplifyIT S.R.L.) es un proveedor que construye y firma el XML y lo envía al SIN. Nodo: «Descargar o enviar documento».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial facturabo
operation	select	No	Operación — download, email
cuf	text	Sí	CUF — Código Único de Factura (lo devuelve la emisión)
format	select	No	Formato — pdf, ticket, xml, info
email	text	No	Email de destino — Solo al reenviar. Vacío = el email original del cliente. En sandbox no se envían emails
include_content	boolean	No	Devolver el contenido (base64)
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 facturabo con los campos:

• API key: se obtiene en app.factura.bo → Más → API Key
• Entorno: pruebas (sandbox, SIAT piloto) o producción; la clave no lo delata, lo eliges tú
• NIT y código de sistema del SIAT: para sincronizar CUIS/CUFD y catálogos
• Sucursal y punto de venta por defecto: 0 = casa matriz / punto principal
• Secreto de webhooks (whsec_…): para verificar la firma de los eventos

Salida

{
  "success": true,
  "operation": "download",
  "cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
  "format": "pdf",
  "filename": "factura_2872F7294502.pdf",
  "content_type": "application/pdf",
  "size": 48213,
  "content_base64": "JVBERi0xLjQ…",
  "url": "https://api.factura.bo/f/2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74/pdf",
  "environment": "production"
}

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

Ejemplo de Uso

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

Notas

• Formatos: pdf (A4), ticket (80 mm) y xml fiscal. Los enlaces /f/{cuf}/… son públicos y no caducan: 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), con un tope de tamaño configurable.
• Reenviar por email usa el correo del cliente o el que indiques. En sandbox nunca se envían emails (la API responde 403); en producción puede estar desactivado por cuenta.

Nodos Relacionados

• facturaBoEmitirFactura - Emitir factura
• facturaBoConsultar - Consultar facturas
• facturaBoReportes - Reportes contables