facturaBoAdministrar

Descripción

Administra tu cuenta de factura.bo: ver créditos, modalidad y estado; consumo de créditos por día o mes; sincronizar el CUIS y la CUFD (recomendado a diario a las 00:05 hora de Bolivia, la CUFD vence cada 24 h); listar, crear y cerrar puntos de venta; listar sucursales; y ver el estado público de la API y del SIAT.

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: «Cuenta, sincronización y puntos de venta».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial facturabo
operation	select	No	Operación — account, usage, sync, list_pos, create_pos, close_pos, branches, status
from	text	No	Desde (consumo)
to	text	No	Hasta (consumo)
group_by	select	No	Agrupar consumo por — "", dia, mes
nit	text	No	NIT de la empresa (sincronizar) — Vacío = el de la credencial
system_code	text	No	Código de sistema SIAT (sincronizar) — Vacío = el de la credencial
branch_code	number	No	Sucursal (código SIAT) — 0 = casa matriz. Vacío = la sucursal por defecto de la credencial
point_of_sale_code	number	No	Punto de venta (código SIAT) — 0 = punto principal. Vacío = el de la credencial
name	text	No	Nombre del punto de venta
pos_type	select	No	Tipo de punto de venta — "", 1, 2
reference	text	No	Referencia (idempotencia) — Reutilízala en reintentos para recuperar el código asignado
pos_code	number	No	Código del punto de venta (cerrar)
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": "account",
  "data": {
    "creditos": 120,
    "modalidad": 1
  },
  "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": "sync",
  "branch_code": 0,
  "point_of_sale_code": 0
}

Notas

• «Sincronizar» obtiene el CUIS y la CUFD; la CUFD vence cada 24 h, así que se recomienda programarlo a diario a las 00:05 (hora de Bolivia). Un rechazo 123 significa CUFD vencido.
• Los puntos de venta se crean con una referencia estable: reutilízala en reintentos para recuperar el código asignado. Las cuentas demo reciben códigos simulados.
• «Estado de la API y del SIAT» es público (no envía la clave).

Nodos Relacionados

• facturaBoCatalogo - Catálogos del SIAT
• facturaBoContingencia - Contingencia (SIAT caído)