cucuWebhooks

Description

Registers, lists, edits and deletes CUCU webhook endpoints (up to 20), rotates their secret and queries or redelivers deliveries. Events: invoice., contingency., siat.*, certificate.expiring, cufd.renewal_failed, cuis.renewal_failed. 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 SIAT: CUCU is an authorised provider handling signing, CUIS/CUFD codes and submission to the SIN. Node: “Gestionar webhooks”.

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	cucu credential
operation	select	No	Operation — create, list, get, update, delete, rotate_secret, deliveries, redeliver
endpoint_id	text	No	Endpoint ID
url	text	No	URL (https)
events	text	No	Events — Comma-separated: , group. or exact event
description	text	No	Description
active	select	No	Active — “, true, false
delivery_id	text	No	Delivery ID
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 cucu with the fields:

• API key: starts with sk_test_ (sandbox) or sk_live_ (production); the environment is inferred from the prefix
• Environment: automatic, testing or production (if it contradicts the key, nothing is sent)
• Default point of sale (UUID): used when the node does not specify one
• Company ID (UUID): for branches and certificate status
• Webhook secret (whsec_…): to verify event signatures

Output

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

The output is stored under the configured key (output_key, default cucu) and the rest of data is kept. On error: error.message, error.type and, where applicable, status, code and siat_code.

Usage Example

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

Notes

• Creates, lists, updates and deletes endpoints, rotates the secret, lists deliveries and redelivers a failed one.
• The URL must be https and events look like invoice.* or *. The secret (whsec_…) is only shown on create or rotate.

Related Nodes

• cucuVerificarWebhook - Verificar firma de webhook