facturaBoConsultar

Descripción

Consulta facturas: obtener una por CUF (estado local y enlaces), comprobar su estado real ante el SIAT en tiempo real, o listar con filtros (estado, fechas, NIT del cliente) leyendo una o varias páginas.

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

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial facturabo
operation	select	Sí	Operación — get, status, list
cuf	text	No	CUF — Código Único de Factura (lo devuelve la emisión)
state	select	No	Estado — "", EMITIDA, ANULADA, OFFLINE
from	text	No	Desde — AAAA-MM-DD
to	text	No	Hasta
client_document	text	No	NIT o CI del cliente
limit	number	No	Resultados por página — Máximo 100
after	text	No	Después de (CUF) — Paginación: el «siguiente» de la respuesta anterior
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 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": "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"
}

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": "list",
  "state": "EMITIDA",
  "from": "2026-10-01",
  "to": "2026-10-31",
  "limit": 50,
  "all_pages": true
}

Notas

• Operaciones: obtener una factura por CUF (estado local y enlaces), comprobar su estado real ante el SIAT en tiempo real y listar con filtros (estado, fechas, NIT del cliente; hasta 100 por página).
• La paginación es por cursor: despues_de recibe el CUF de la última factura (el siguiente de la respuesta). Con «todas las páginas» se recorre hasta el tope; si se corta, truncated es true.

Nodos Relacionados

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