facturaBoWebhooks

Description

Registers, lists and deletes webhooks, rotates their secret and sends a test event. Events: factura.emitida, factura.offline, factura.anulada, factura.anulacion_revertida, nota.emitida, contingencia.paquete_enviado, creditos.bajos, siat.caido, siat.recuperado. The secret (whsec_…) is shown only on create and rotate: store it in the credential.

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

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	facturabo credential
operation	select	No	Operation — create, list, delete, rotate_secret, test
webhook_id	text	No	Webhook ID
url	text	No	URL (https) — Must answer 2xx in under 10 s
events	text	No	Events — Comma-separated: , group. or exact event. Empty = all
output_key	text	No	Output key — The result is added to data[key] keeping the rest of the data

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

{
  "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"
}

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

{
  "credentials_id": "cred-facturabo",
  "operation": "create",
  "url": "https://app.floogos.com/webhooks/facturabo",
  "events": "factura.*, siat.caido"
}

Notes

• Events: factura.emitida, factura.offline, factura.anulada, factura.anulacion_revertida, nota.emitida, contingencia.paquete_enviado, creditos.bajos, siat.caido, siat.recuperado and webhook.prueba. Subscribe with *, a prefix (factura.*) or the exact name.
• The URL must be https and answer 2xx within 10 s; otherwise there are retries with exponential backoff. siat.caido fires after 3 consecutive failed probes.
• The secret is only shown on create and rotate.

Related Nodes

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