facturaBoReportes

Description

Downloads the monthly VAT Sales Book (CSV in RCV format, ready for the SIN) or the monthly backup: a ZIP with the XML and PDF of every invoice in the period, named {number}_{cuf}.

Part of the Bolivia Fiscal Hub as an alternative to connecting directly to the SIAT: factura.bo (SimplifyIT S.R.L.) is a provider that builds and signs the XML and sends it to the SIN. Node: «Reportes contables».

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	facturabo credential
operation	select	No	Report — sales_book, backup
year	number	Yes	Year
month	number	Yes	Month
backup_format	select	No	Backup content — ambos, xml, pdf
include_content	boolean	No	Return the ZIP (base64)
max_mb	number	No	Max size (MB)
output_key	text	No	Output key — The result is added to data[key] keeping the rest of the data

Credentials

This module requires a credential of type facturabo with the fields:

• API key: get it at app.factura.bo → More → API Key
• Environment: testing (sandbox, pilot SIAT) or production; the key does not reveal it, you choose
• NIT and SIAT system code: to sync CUIS/CUFD and catalogs
• Default branch and point of sale: 0 = head office / main point
• Webhook secret (whsec_…): to verify event signatures

Output

{
  "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"
}

The output is stored under the configured key (output_key, default facturabo) and the rest of data is kept. On error: error.message, error.type and, where applicable, status and siat_code.

Usage Example

{
  "credentials_id": "cred-facturabo",
  "operation": "sales_book",
  "year": 2026,
  "month": 10
}

Notes

• The VAT Sales Book downloads as CSV in RCV format, ready for the SIN; rows counts the rows without the header.
• The monthly backup is a ZIP with the XML and/or PDF of every invoice in the period, named {number}_{cuf}. It is returned as base64 with a configurable cap (50 MB by default).

Related Nodes

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