facturaBoValidarNit

Descripción

Verifica un NIT ante el SIAT antes de emitir. Úsalo una vez por cliente, no en cada factura. Si no pasa y aun así quieres emitir, usa el código de excepción 1 en la factura.

Forma parte del Hub Fiscal de Bolivia como alternativa a la conexión directa con el SIAT: factura.bo (SimplifyIT S.R.L.) es un proveedor que construye y firma el XML y lo envía al SIN. Nodo: «Validar NIT».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial facturabo
nit	text	Sí	NIT
branch_code	number	No	Sucursal (código SIAT) — 0 = casa matriz. Vacío = la sucursal por defecto de la credencial
point_of_sale_code	number	No	Punto de venta (código SIAT) — 0 = punto principal. Vacío = el 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 facturabo con los campos:

• API key: se obtiene en app.factura.bo → Más → API Key
• Entorno: pruebas (sandbox, SIAT piloto) o producción; la clave no lo delata, lo eliges tú
• NIT y código de sistema del SIAT: para sincronizar CUIS/CUFD y catálogos
• Sucursal y punto de venta por defecto: 0 = casa matriz / punto principal
• Secreto de webhooks (whsec_…): para verificar la firma de los eventos

Salida

{
  "success": true,
  "nit": 1023456789,
  "valid": true,
  "message": "NIT VALIDO",
  "data": {
    "valido": true,
    "mensaje": "NIT VALIDO"
  },
  "environment": "production"
}

La salida se guarda en la clave configurada (output_key, por defecto facturabo) y se conserva el resto de data. En error: error.message, error.type y, si aplica, status y siat_code.

Ejemplo de Uso

{
  "credentials_id": "cred-facturabo",
  "nit": "1023456789"
}

Notas

• Verifica el NIT ante el SIAT con el punto de venta indicado. Úsalo una vez por cliente, no en cada factura.
• Si el NIT no es válido y aun así quieres emitir, usa el código de excepción 1 en «Emitir factura».

Nodos Relacionados

• facturaBoEmitirFactura - Emitir factura