Skip to content
Floogos

facturaBoCatalogo

Description

Section titled “Description”

Lists the SIAT catalogs you need to invoice (payment methods, units of measure, products and services, activities, cancellation reasons, currencies, countries, significant events, legends, sectors…) with text filter, or syncs them from the SIAT (all 18 catalogs).

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

Configuration

Section titled “Configuration”
FieldTypeRequiredDescription
credentials_idcredentialsYesfacturabo credential
operationselectNoOperation — list, sync
catalogselectNoCatalog — 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
searchtextNoSearch text — Filters by code or description
limitnumberNoMax results — 0 = all
nittextNoCompany NIT (on sync) — Empty = the credential one
system_codetextNoSIAT system code (on sync) — Empty = the credential one
output_keytextNoOutput key — The result is added to data[key] keeping the rest of the data

Credentials

Section titled “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

Section titled “Output”
{
  "success": true,
  "operation": "list",
  "catalog": "metodos_pago",
  "items": [
    {
      "codigo": 1,
      "descripcion": "EFECTIVO"
    }
  ],
  "count": 1,
  "matched": 1,
  "total": 308,
  "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

Section titled “Usage Example”
{
  "credentials_id": "cred-facturabo",
  "operation": "list",
  "catalog": "metodos_pago",
  "search": "tarjeta",
  "limit": 50
}

Notes

Section titled “Notes”
  • Catalogs: 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 and the list of sectores.
  • “Sync” downloads all 18 catalogs from the SIAT; it needs the NIT and system code (from the node or the credential).
Section titled “Related Nodes”