cucuCufd

Descripción

Gestiona la CUFD (Código Único de Facturación Diaria) de un punto de venta: ver la activa, regenerarla o «asegurar» que haya una vigente (la renueva solo si no hay o vence pronto). CUCU la renueva sola; úsalo al inicio del día o si ves el evento cufd.renewal_failed.

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: «CUFD del punto de venta».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial cucu
operation	select	No	Operación — ensure, get, renew
pos_id	text	No	Punto de venta (UUID) — Vacío = el punto de venta por defecto de la credencial
renew_before_minutes	number	No	Renovar si vence en menos de (min)
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": "ensure",
  "renewed": false,
  "cufd": "BQUFDZ…",
  "control_code": "C1D2E3",
  "expires_in_minutes": 612
}

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": "ensure",
  "renew_before_minutes": 60
}

Notas

• «Asegurar» solo pide un CUFD nuevo si no hay, está inactivo o vence antes de los minutos indicados; así se puede ejecutar a menudo sin gastar peticiones.
• El CUFD dura un día en el SIAT. CUCU suele renovarlo solo; este nodo es útil para tareas programadas o comprobaciones.

Nodos Relacionados

• cucuContingencia - Contingencia (SIAT caído)
• cucuEmitirFactura - Emitir factura