facturaBoReportes

Descripción

Descarga el Libro de Ventas IVA de un mes (CSV en formato RCV, listo para el SIN) o el respaldo mensual: un ZIP con los XML y PDF de todas las facturas del período, nombrados {número}_{cuf}.

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: «Reportes contables».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial facturabo
operation	select	No	Reporte — sales_book, backup
year	number	Sí	Gestión (año)
month	number	Sí	Mes
backup_format	select	No	Contenido del respaldo — ambos, xml, pdf
include_content	boolean	No	Devolver el ZIP (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": "sales_book",
  "year": 2026,
  "month": 10,
  "filename": "libro_ventas_2026_10.csv",
  "rows": 120,
  "csv": "N;FECHA;NIT;…",
  "size": 18234,
  "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": "sales_book",
  "year": 2026,
  "month": 10
}

Notas

• El Libro de Ventas IVA se descarga en CSV con el formato RCV, listo para el SIN; rows cuenta las filas sin la cabecera.
• El respaldo mensual es un ZIP con los XML y/o PDF de todas las facturas del período, con nombres {numero}_{cuf}. Se devuelve en base64 con un tope configurable (50 MB por defecto).

Nodos Relacionados

• facturaBoDocumento - Descargar o enviar documento
• facturaBoConsultar - Consultar facturas