cucuValidarCliente

Description

Gets the official name or business name from a NIT or ID (taxpayer registry), with its SIN status, or formally verifies a NIT against the SIAT. Use it once per document, before issuing; not on every keystroke.

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: “Validar cliente (padrón / NIT)”.

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	cucu credential
operation	select	No	Operation — `padron`, `nit`
document_type	select	No	Document type — `5`, `1`, `2`, `3`, `4`
document_number	text	Yes	Document number
complement	text	No	ID complement — If there are namesakes, the response asks for it
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

{
  "operation": "padron",
  "found": true,
  "business_name": "CUCU S.R.L.",
  "official": true,
  "usable_for_invoice": true,
  "needs_complement": false
}

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": "padron",
  "document_type": 5,
  "document_number": "591164023"
}

Notes

“Registry” looks up the name for a tax ID or ID card; “NIT” validates a NIT against SIAT using the point of sale.
An ID card can have several namesakes: if a complement is needed, needs_complement is true and usable_for_invoice is false.
A NIT not registered with the SIN is not valid for invoicing.

cucuEmitirFactura - Emitir factura