cucuConsultar

Descripción

Consulta facturas: obtener una por ID o CUF (con sus líneas), ver su estado actual ante el SIAT, buscar con filtros (estado, fechas, cliente, número), listar o ver el panel de totales. Las listas admiten leer varias páginas.

Forma parte del Hub Fiscal de Bolivia como alternativa a la conexión directa con el SIAT: CUCU es un proveedor autorizado que se ocupa de la firma, los códigos CUIS/CUFD y el envío al SIN. Nodo: «Consultar facturas».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial cucu
operation	select	Sí	Operación — get, status, search, list, dashboard
invoice_id	text	No	ID de la factura (UUID) — El id que devuelve CUCU al emitir. Si lo dejas vacío, indica el CUF
cuf	text	No	CUF — Código Único de Factura. Se usa si no indicas el ID
state	select	No	Estado — “, VALIDATED, CANCELLED, OFFLINE_PENDING, REJECTED
from	text	No	Desde — AAAA-MM-DD
to	text	No	Hasta
client_document	text	No	Documento del cliente
invoice_number	number	No	Número de factura
page	number	No	Página (desde 0)
size	number	No	Tamaño de página — Máximo 50
all_pages	boolean	No	Leer todas las páginas
max_pages	number	No	Máximo de páginas
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 cucu con los campos:

• API key: empieza por sk_test_ (sandbox) o sk_live_ (producción); el entorno se deduce del prefijo
• Entorno: automático, pruebas o producción (si contradice la clave, no se envía nada)
• Punto de venta por defecto (UUID): se usa si el nodo no indica uno
• ID de empresa (UUID): para sucursales y estado del certificado
• Secreto de webhooks (whsec_…): para verificar la firma de los eventos

Salida

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

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

Ejemplo de Uso

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

Notas

• Operaciones: obtener una factura (por ID o CUF), su estado en el SIAT, buscar con filtros, listar y panel de resumen.
• La búsqueda devuelve siatState; el nodo lo normaliza a state para que todas las operaciones usen el mismo nombre.
• Con «todas las páginas» se recorre la paginación (máx. 50 por página) hasta un tope; si se corta, truncated es true.

Nodos Relacionados

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