facturaBoWebhooks

Descripción

Registra, lista y elimina webhooks, rota su secreto y envía un evento de prueba. Eventos: factura.emitida, factura.offline, factura.anulada, factura.anulacion_revertida, nota.emitida, contingencia.paquete_enviado, creditos.bajos, siat.caido, siat.recuperado. El secreto (whsec_…) solo se muestra al crear y al rotar: guárdalo en la credencial.

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: «Gestionar webhooks».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial facturabo
operation	select	No	Operación — create, list, delete, rotate_secret, test
webhook_id	text	No	ID del webhook
url	text	No	URL (https) — Debe responder 2xx en menos de 10 s
events	text	No	Eventos — Separados por coma: , grupo. o evento exacto. Vacío = todos
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": "create",
  "data": {
    "id": "wh_1",
    "secreto": "whsec_…"
  },
  "notice": "El secreto (whsec_…) solo se muestra ahora: guárdalo en la credencial.",
  "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": "create",
  "url": "https://app.floogos.com/webhooks/facturabo",
  "events": "factura.*, siat.caido"
}

Notas

• Eventos: factura.emitida, factura.offline, factura.anulada, factura.anulacion_revertida, nota.emitida, contingencia.paquete_enviado, creditos.bajos, siat.caido, siat.recuperado y webhook.prueba. Se suscribe con *, un prefijo (factura.*) o el nombre exacto.
• La URL debe ser https y responder 2xx en menos de 10 s; si no, hay reintentos con backoff exponencial. siat.caido se dispara tras 3 sondeos fallidos seguidos.
• El secreto solo se muestra al crear y al rotar.

Nodos Relacionados

• facturaBoVerificarWebhook - Verificar firma de webhook
• facturaBoContingencia - Contingencia (SIAT caído)