cucuCatalogo

Descripción

Lista o sincroniza los catálogos del SIAT que necesitas para facturar: métodos de pago (308 códigos), unidades de medida, motivos de anulación, monedas, tipos de documento, eventos significativos, actividades económicas, productos SIN y leyendas. Sincroniza una vez al inicio y a diario.

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: «Catálogos del SIAT».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial cucu
operation	select	No	Operación — list, sync
catalog	select	No	Catálogo — payment-methods, unit-measures, cancellation-reasons, currencies, document-types, significant-events, activities, products, legends, all
activity_code	text	No	Código de actividad — Filtra productos o leyendas por actividad
search	text	No	Buscar texto — Filtra los resultados por código o descripción
limit	number	No	Máximo de resultados — 0 = todos
pos_id	text	No	Punto de venta (UUID) — Vacío = el punto de venta por defecto de la credencial
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

{
  "catalog": "payment-methods",
  "count": 5,
  "total": 308,
  "truncated": true,
  "items": [
    {
      "code": "1",
      "description": "EFECTIVO"
    }
  ]
}

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",
  "catalog": "payment-methods",
  "search": "tarjeta",
  "limit": 50
}

Notas

• Lista los catálogos paramétricos del SIAT (métodos de pago, unidades de medida, productos SIN, leyendas…) con filtro de texto y límite.
• «Sincronizar» fuerza a CUCU a descargar de nuevo un catálogo (o todos) desde el SIAT.

Nodos Relacionados

• cucuEmitirFactura - Emitir factura
• cucuCufd - CUFD del punto de venta