facturaBoValidarNit

Description

Verifies a NIT against the SIAT before issuing. Use it once per client, not on every invoice. If it fails and you still want to issue, use exception code 1 on the invoice.

Part of the Bolivia Fiscal Hub as an alternative to connecting directly to the SIAT: factura.bo (SimplifyIT S.R.L.) is a provider that builds and signs the XML and sends it to the SIN. Node: «Validar NIT».

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	facturabo credential
nit	text	Yes	NIT
branch_code	number	No	Branch (SIAT code) — 0 = head office. Empty = the credential default branch
point_of_sale_code	number	No	Point of sale (SIAT code) — 0 = main point. Empty = the credential one
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 facturabo with the fields:

API key: get it at app.factura.bo → More → API Key
Environment: testing (sandbox, pilot SIAT) or production; the key does not reveal it, you choose
NIT and SIAT system code: to sync CUIS/CUFD and catalogs
Default branch and point of sale: 0 = head office / main point
Webhook secret (whsec_…): to verify event signatures

Output

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

The output is stored under the configured key (output_key, default facturabo) and the rest of data is kept. On error: error.message, error.type and, where applicable, status and siat_code.

Usage Example

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

Notes

Verifies the NIT against the SIAT using the given point of sale. Use it once per client, not on every invoice.
If the NIT is invalid and you still want to issue, use exception code 1 in “Issue invoice”.

facturaBoEmitirFactura - Emitir factura