n8n-nodes-facturabo

Nodo de n8n para emitir y consultar facturas electrónicas del SIAT de Bolivia con factura.bo.

Incluye dos nodos:

• factura.bo (acción): emitir, consultar, listar y anular facturas; validar NIT; ver tu cuenta y el tipo de cambio oficial del BCB.
• factura.bo Trigger: dispara un workflow cuando ocurre un evento (factura emitida, anulada, créditos bajos, SIAT caído…). Registra y elimina el webhook en factura.bo automáticamente y verifica la firma HMAC de cada entrega.

Instalación

En n8n self-hosted: Settings → Community Nodes → Install e ingresa n8n-nodes-facturabo.

O manualmente:

npm install n8n-nodes-facturabo

Credenciales

Crea una credencial factura.bo API:

• Entorno: Sandbox (SIAT piloto, para pruebas) o Producción (SIAT real).
• API Key: la obtienes en app.factura.bo → Más → API Key, o escribiendo a gm@simplifyit.com.bo.

La prueba de credenciales llama a GET /v1/cuenta.

Antes de facturar

El punto de venta necesita CUIS/CUFD sincronizados (el CUFD vence cada 24 h). Hoy esa sincronización se hace desde app.factura.bo o con POST /v1/sincronizar. Una vez sincronizado, el nodo Emitir ya factura.

Ejemplo

1. factura.bo Trigger → evento factura.emitida.
2. Conecta un nodo de Google Sheets / correo / WhatsApp con los datos del evento (CUF, número, PDF).

O al revés: cuando llega un pedido pagado (Shopify, WooCommerce, un formulario…), un nodo factura.bo → Emitir genera la factura y devuelve el CUF y el PDF.

Desarrollo

npm install
npm run build      # tsc + copia de iconos

Soporte

api.factura.bo/guia · gm@simplifyit.com.bo · un producto de SimplifyIT S.R.L.