cucuValidarCliente

Descripción

Obtiene el nombre o razón social oficial a partir de un NIT o CI (padrón de contribuyentes), con su estado en el SIN, o verifica formalmente un NIT ante el SIAT. Úsalo una vez por documento, antes de emitir; no en cada tecla.

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

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial cucu
operation	select	No	Operación — padron, nit
document_type	select	No	Tipo de documento — 5, 1, 2, 3, 4
document_number	text	Sí	Número de documento
complement	text	No	Complemento del CI — Si hay homónimos, la respuesta lo pide
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

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

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

Notas

• «Padrón» consulta el nombre de un NIT o CI; «NIT» valida un NIT contra el SIAT con el punto de venta.
• Un CI puede tener varios homónimos: si necesita complemento, needs_complement es true y usable_for_invoice es false.
• Un NIT no registrado en el SIN no es válido para facturar.

Nodos Relacionados

• cucuEmitirFactura - Emitir factura