cucuContingencia

Descripción

Gestiona los eventos de contingencia cuando el SIAT no responde: comprobar la conexión, abrir un evento (corte de internet, falla del SIAT, virus, otro), cerrarlo (envía los paquetes de facturas emitidas offline), ver el evento activo, listar eventos de un día, reenviar un paquete y regularizar facturas emitidas fuera de la ventana. Cerrar un evento no garantiza que el SIAT haya aceptado todo: revisa el estado de cada paquete.

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: «Contingencia (SIAT caído)».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial cucu
operation	select	No	Operación — check_connection, start, end, active, list, resend, regularize
pos_id	text	No	Punto de venta (UUID) — Vacío = el punto de venta por defecto de la credencial
branch_id	text	No	ID de la sucursal (UUID)
motivo	select	No	Motivo del evento — 1, 2, 3, 4
description	text	No	Descripción
event_id	text	No	ID del evento (UUID)
event_date	text	No	Fecha del evento
end_date	text	No	Fecha de fin — ISO 8601, posterior al inicio. Vacío = ahora
repetitions	number	No	Repeticiones (certificación) — 1 a 10. Solo para el proceso de certificación
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": "end",
  "data": {
    "id": "880e8400-e29b-41d4-a716-446655440020",
    "finalizado": true
  },
  "warnings": [
    "2 paquete(s) no validado(s): REJECTED, SENT"
  ]
}

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": "start",
  "branch_id": "770e8400-e29b-41d4-a716-446655440010",
  "motivo": "2",
  "description": "Falla del SIAT"
}

Notas

• Gestiona eventos significativos: comprobar la conexión con el SIAT, iniciar y cerrar un evento, regularizar, listar y ver el activo.
• Al cerrar o regularizar, si quedan paquetes sin validar se avisa en warnings.

Nodos Relacionados

• cucuEmisionMasiva - Emisión masiva
• cucuCufd - CUFD del punto de venta