SIAT Bolivia — Electronic invoicing (SIN, Online Invoicing)

Overview

The SIAT nodes connect your workflows to Bolivia’s electronic invoicing (SIN — National Tax Service, Online Invoicing). The SIAT uses three codes: CUIS (system start), CUFD (daily, valid for 24h, with its control code) and CUF (per invoice, generated by the issuer). The invoice is an XML signed with XMLDSig and sent over SOAP (GZIP-compressed).

Node	What it does
SIAT: Get CUFD (siatObtenerCufd)	Gets the daily CUFD + control code (and CUIS)
SIAT: Issue invoice (siatEmitirFactura)	Generates the CUF, builds the XML, signs and sends it
SIAT: Cancel invoice (siatAnular)	Cancels an invoice by its CUF with a reason code
SIAT: Rendering / QR (siatRepresentacion)	Generates the printable representation with QR

In Bolivia you need a valid (daily) CUFD

To issue, you first need a valid CUFD (lasts 24h) and its control code — get them with SIAT: Get CUFD at the start of the day. The CUF is generated per invoice (SIN algorithm: modulo 11 + hexadecimal + control code). Authentication uses the SIN’s apikey (delegated token). The general VAT rate is 13% and is included in the price.

Credential

The nodes use a credential of type SIAT. Create it under Credentials → Add → Bolivia / SIN (SIAT) with:

Field	Description
Issuer NIT	The tax ID number.
Certificate (.p12)	With its password; used to sign.
SIN Apikey / Token	The delegated token to authenticate the WS.
System code	The one assigned when registering your system.
Branch / Point of sale	Codes of the issuing point.
Modality	1 online electronic, 2 computerized.
Environment	Test (pilot) or Production.

Get the CUFD

Node: SIAT: Get CUFD. Returns the daily CUFD and its control code. Check Get CUIS if you don’t have the CUIS yet. Save those values to pass to the issuing nodes (or leave them in the credential).

Issue an invoice

Node: SIAT: Issue invoice. precioUnitario values are VAT-inclusive (Bolivia). Pass the valid cufd and codigo_control.

{
  "comprador": { "nit": "987654321", "razonSocial": "Bolivia Client SA", "tipoDocumento": 5 },
  "items": [
    { "descripcion": "Consulting service", "cantidad": 1, "precioUnitario": 113, "codigoProductoSin": "99100", "actividadEconomica": "620000" }
  ]
}

Buyer’s tipoDocumento: 1 ID card, 5 NIT. The node generates the CUF, returns the reception code and the QR.

Cancel an invoice

Node: SIAT: Cancel invoice. Cancels by CUF with a reason code from the SIN catalog (1 wrongly issued invoice, etc.). Requires a valid CUFD.

Printable rendering (QR)

Node: SIAT: Rendering / QR. Generates the printable rendering in HTML (exportable to PDF), with the CUF, the lookup QR and the SIN’s mandatory legend.

Error handling

Situation	Retryable	What to do
SIN rejects / observes	No	The node returns the messages. Fix the invoice.
Expired CUFD	No	Get a new CUFD (lasts 24h).
Invalid apikey	No	Check the SIN delegated token.
Network / Timeout	Yes	Transient; automatically retried.

SIN pilot environment

Always test in the pilot environment (pilotosiat) before production, and validate the XML structure against the SIN’s XSD. The full XAdES signature must be validated against the pilot.

See also

• Retry queue (DLQ) — how failed executions are retried.
• HTTP node — for services not covered by these nodes.