cucuConsultar

Description

Queries invoices: get one by ID or CUF (with its lines), check its current SIAT status, search with filters (state, dates, client, number), list or view the totals dashboard. Lists can read several pages.

Part of the Bolivia Fiscal Hub as an alternative to connecting directly to SIAT: CUCU is an authorised provider handling signing, CUIS/CUFD codes and submission to the SIN. Node: “Consultar facturas”.

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	cucu credential
operation	select	Yes	Operation — get, status, search, list, dashboard
invoice_id	text	No	Invoice ID (UUID) — The id CUCU returns on issue. If empty, set the CUF
cuf	text	No	CUF — Unique Invoice Code. Used when no ID is given
state	select	No	State — “, VALIDATED, CANCELLED, OFFLINE_PENDING, REJECTED
from	text	No	From — YYYY-MM-DD
to	text	No	To
client_document	text	No	Client document
invoice_number	number	No	Invoice number
page	number	No	Page (from 0)
size	number	No	Page size — Max 50
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 cucu with the fields:

• API key: starts with sk_test_ (sandbox) or sk_live_ (production); the environment is inferred from the prefix
• Environment: automatic, testing or production (if it contradicts the key, nothing is sent)
• Default point of sale (UUID): used when the node does not specify one
• Company ID (UUID): for branches and certificate status
• Webhook secret (whsec_…): to verify event signatures

Output

{
  "operation": "search",
  "invoices": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "invoiceNumber": 42,
      "cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
      "state": "VALIDATED",
      "amountTotal": 500
    }
  ],
  "page": {
    "page": 0,
    "size": 20,
    "total": 1
  }
}

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

Usage Example

{
  "credentials_id": "cred-cucu",
  "operation": "search",
  "state": "VALIDATED",
  "from": "2026-01-01",
  "to": "2026-03-31",
  "size": 20
}

Notes

• Operations: get an invoice (by ID or CUF), its SIAT status, filtered search, list and summary dashboard.
• Search returns siatState; the node normalises it to state so every operation uses the same name.
• With “all pages” pagination is walked (max 50 per page) up to a cap; if cut short, truncated is true.

Related Nodes

• cucuEmitirFactura - Emitir factura
• cucuDocumento - Descargar o enviar documento
• cucuAnular - Anular o revertir factura