facturaBoConsultar

Description

Queries invoices: get one by CUF (local state and links), check its real SIAT state in real time, or list with filters (state, dates, client NIT) reading one or several pages.

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: «Consultar facturas».

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	facturabo credential
operation	select	Yes	Operation — get, status, list
cuf	text	No	CUF — Unique Invoice Code (returned on issue)
state	select	No	State — "", EMITIDA, ANULADA, OFFLINE
from	text	No	From — YYYY-MM-DD
to	text	No	To
client_document	text	No	Client NIT or ID
limit	number	No	Results per page — Max 100
after	text	No	After (CUF) — Pagination: the “next” of the previous response
all_pages	boolean	No	Read all pages
max_pages	number	No	Max pages
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": "list",
  "invoices": [
    {
      "cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
      "invoice_number": 12,
      "state": "EMITIDA",
      "issued_at": "2026-10-26T10:00:00",
      "url_public": "https://api.factura.bo/f/2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
      "url_pdf": "https://…/pdf",
      "url_xml": "https://…/xml",
      "url_ticket": "https://…/ticket",
      "siat_response": {
        "codigoEstado": 908
      }
    }
  ],
  "count": 1,
  "pages_read": 1,
  "next": null,
  "truncated": false,
  "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": "list",
  "state": "EMITIDA",
  "from": "2026-10-01",
  "to": "2026-10-31",
  "limit": 50,
  "all_pages": true
}

Notes

• Operations: get an invoice by CUF (local state and links), check its real state with the SIAT in real time, and list with filters (state, dates, client NIT; up to 100 per page).
• Pagination is cursor-based: despues_de takes the CUF of the last invoice (the siguiente of the response). With “all pages” it walks up to the cap; if cut short, truncated is true.

Related Nodes

• facturaBoEmitirFactura - Emitir factura
• facturaBoDocumento - Descargar o enviar documento
• facturaBoAnular - Anular o revertir factura