cucuAdministrar

Descripción

Administra tu empresa en CUCU: listar y crear sucursales, listar y crear puntos de venta (se registran en el SIAT), marcarlos como configurados, importar los puntos de venta que ya existen en el SIAT y ver el estado y vencimiento del certificado digital. La subida del certificado y su llave privada se hace desde el panel de CUCU, no desde un workflow.

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: «Sucursales, puntos de venta y certificado».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial cucu
operation	select	No	Operación — list_branches, create_branch, list_pos, create_pos, configure_pos, sync_pos, certificate_status
company_id	text	No	ID de la empresa (UUID) — Vacío = el de la credencial
branch_id	text	No	ID de la sucursal (UUID)
pos_id	text	No	Punto de venta (UUID) — Vacío = el punto de venta por defecto de la credencial
name	text	No	Nombre
address	text	No	Dirección
siat_code	number	No	Código de sucursal en el SIAT — Vacío = el siguiente disponible
city	text	No	Ciudad
municipality	text	No	Municipio
phone	text	No	Teléfono
email	text	No	Email
description	text	No	Descripción del punto de venta
siat_type_pos	number	No	Tipo de punto de venta SIAT — Vacío = 5 (por defecto de CUCU)
online	select	No	Opera en línea — “, true, false
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": "certificate_status",
  "data": {
    "hasCertificate": true,
    "certificateValid": true
  }
}

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": "list_branches"
}

Notas

• Sucursales, puntos de venta y estado del certificado de la empresa (necesita company_id en la credencial).
• La subida del certificado y la llave privada NO está en el nodo a propósito: así no pasan por las trazas del workflow. Hazlo desde el panel de CUCU.

Nodos Relacionados

• cucuCufd - CUFD del punto de venta
• cucuContingencia - Contingencia (SIAT caído)