cucuCatalogo

Description

Lists or syncs the SIAT catalogs you need to invoice: payment methods (308 codes), units of measure, cancellation reasons, currencies, document types, significant events, economic activities, SIN products and legends. Sync once at start and daily.

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: “Catálogos del SIAT”.

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	cucu credential
operation	select	No	Operation — list, sync
catalog	select	No	Catalog — payment-methods, unit-measures, cancellation-reasons, currencies, document-types, significant-events, activities, products, legends, all
activity_code	text	No	Activity code — Filters products or legends by activity
search	text	No	Search text — Filters results by code or description
limit	number	No	Max results — 0 = all
pos_id	text	No	Point of sale (UUID) — Empty = the credential default point of sale
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

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

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

Notes

• Lists SIAT parametric catalogs (payment methods, units of measure, SIN products, legends…) with text filter and limit.
• “Sync” forces CUCU to download a catalog (or all of them) from SIAT again.

Related Nodes

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