facturaBoCatalogo

Descripción

Lista los catálogos del SIAT que necesitas para facturar (métodos de pago, unidades de medida, productos y servicios, actividades, motivos de anulación, monedas, países, eventos significativos, leyendas, sectores…) con filtro de texto, o los sincroniza desde el SIAT (los 18 catálogos).

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: «Catálogos del SIAT».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial facturabo
operation	select	No	Operación — list, sync
catalog	select	No	Catálogo — metodos_pago, unidades_medida, productos_servicios, actividades, actividades_documento_sector, motivos_anulacion, tipos_moneda, paises, tipos_documento_identidad, tipos_documento_sector, tipos_emision, tipos_factura, tipos_habitacion, tipos_punto_venta, eventos_significativos, leyendas, mensajes_servicios, fecha_hora, sectores
search	text	No	Buscar texto — Filtra por código o descripción
limit	number	No	Máximo de resultados — 0 = todos
nit	text	No	NIT de la empresa (al sincronizar) — Vacío = el de la credencial
system_code	text	No	Código de sistema SIAT (al sincronizar) — Vacío = el de la credencial
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",
  "catalog": "metodos_pago",
  "items": [
    {
      "codigo": 1,
      "descripcion": "EFECTIVO"
    }
  ],
  "count": 1,
  "matched": 1,
  "total": 308,
  "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",
  "catalog": "metodos_pago",
  "search": "tarjeta",
  "limit": 50
}

Notas

• Catálogos: actividades, actividades_documento_sector, eventos_significativos, fecha_hora, leyendas, mensajes_servicios, metodos_pago, motivos_anulacion, paises, productos_servicios, tipos_documento_identidad, tipos_documento_sector, tipos_emision, tipos_factura, tipos_habitacion, tipos_moneda, tipos_punto_venta, unidades_medida y la lista de sectores.
• «Sincronizar» descarga los 18 catálogos desde el SIAT; necesita el NIT y el código de sistema (del nodo o de la credencial).

Nodos Relacionados

• facturaBoEmitirFactura - Emitir factura
• facturaBoAdministrar - Cuenta, sincronización y puntos de venta