cucuWebhooks

Descripción

Registra, lista, modifica y elimina los endpoints de webhooks de CUCU (hasta 20), rota su secreto y consulta o reenvía entregas. Eventos: invoice., contingency., siat.*, certificate.expiring, cufd.renewal_failed, cuis.renewal_failed. 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: CUCU es un proveedor autorizado que se ocupa de la firma, los códigos CUIS/CUFD y el envío al SIN. Nodo: «Gestionar webhooks».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial cucu
operation	select	No	Operación — create, list, get, update, delete, rotate_secret, deliveries, redeliver
endpoint_id	text	No	ID del endpoint
url	text	No	URL (https)
events	text	No	Eventos — Separados por coma: , grupo. o evento exacto
description	text	No	Descripción
active	select	No	Activo — “, true, false
delivery_id	text	No	ID de la entrega
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 cucu con los campos:

• API key: empieza por sk_test_ (sandbox) o sk_live_ (producción); el entorno se deduce del prefijo
• Entorno: automático, pruebas o producción (si contradice la clave, no se envía nada)
• Punto de venta por defecto (UUID): se usa si el nodo no indica uno
• ID de empresa (UUID): para sucursales y estado del certificado
• Secreto de webhooks (whsec_…): para verificar la firma de los eventos

Salida

{
  "operation": "create",
  "data": {
    "id": "wh_1",
    "secret": "whsec_…",
    "active": true
  },
  "notice": "El secreto solo se muestra ahora: guárdalo en la credencial."
}

La salida se guarda en la clave configurada (output_key, por defecto cucu) y se conserva el resto de data. En error: error.message, error.type y, si aplica, status, code y siat_code.

Ejemplo de Uso

{
  "credentials_id": "cred-cucu",
  "operation": "create",
  "url": "https://app.floogos.com/webhooks/cucu",
  "events": "invoice.*, contingency.opened"
}

Notas

• Crea, lista, actualiza y borra endpoints, rota el secreto, consulta entregas y reenvía una entrega fallida.
• La URL debe ser https y los eventos tienen la forma invoice.* o *. El secreto (whsec_…) solo se muestra al crear o rotar.

Nodos Relacionados

• cucuVerificarWebhook - Verificar firma de webhook