Bolivia
In Bolivia, Floogos connects directly to the SIN (National Tax Service) through the SIAT (Invoicing System), with no mandatory intermediate provider: the engine itself builds the invoice XML, signs it with the issuer’s certificate, and speaks the SIN’s SOAP protocol, with the body compressed in GZIP.
Integration model
Section titled “Integration model”- Direct, no PAC: the flow goes straight to the SIAT’s SOAP services, depending on the mode (testing/pilot or production) and the certificate provided by the credential.
- Daily CUFD: before issuing any invoice, you need to obtain the CUFD (Daily Unique Invoicing Code), valid for 24 hours, together with its control code. The CUIS (System Startup Unique Code) can also be obtained there if you don’t have one yet.
- CUF per invoice: each invoice generates its own CUF (Unique Invoicing Code), computed from the issuer’s NIT, the issuance date, the day’s CUFD and other document data.
- Digital signature: the invoice XML is signed with XMLDSig using the credential’s certificate (.p12) before sending it.
- SOAP submission with GZIP: the signed XML is compressed and sent over SOAP to the SIN’s services, for reception and, optionally, status validation.
- 13% included VAT: the Value Added Tax is included in each item’s unit price, not reported as a separate tax.
When an invoice becomes valid
Section titled “When an invoice becomes valid”The SIN receiving the XML doesn’t close the process by itself. The issuance node can, in the same step, query the status validation (default behavior), and only then does the invoice become validated. If the SIN rejects it during reception or validation, it stays rejected and has no tax validity until it’s corrected and resent.
Available nodes
Section titled “Available nodes”| Node | Description |
|---|---|
| SiatObtenerCufd | Gets the valid CUFD (24h) and its control code; optionally the CUIS |
| SiatEmitirFactura | Generates the CUF, builds and signs the XML, and sends the sale invoice over SOAP/GZIP |
| SiatAnular | Cancels an invoice by its CUF with a reason code from the SIN catalog |
| SiatRepresentacion | Generates the printable representation (HTML/PDF) with the lookup QR |
Typical flow
Section titled “Typical flow”- SiatObtenerCufd — at the start of the day (or when the previous CUFD expires), the valid CUFD and its control code are obtained.
- SiatEmitirFactura — with that CUFD, each sale invoice is issued throughout the day.
- SiatAnular — if an already-issued invoice needs to be cancelled, it’s done by its CUF (also requires a valid CUFD).
- SiatRepresentacion — the HTML/PDF with the QR is generated to hand the customer their printed receipt.
Alternative: CUCU provider
Section titled “Alternative: CUCU provider”Besides the direct connection, Floogos offers nodes for CUCU (docs.cucu.bo), an authorised provider that handles signing, CUIS/CUFD codes and submission to the SIN. It uses the cucu credential (sk_test_ API key for sandbox, sk_live_ for production).
- Idempotency: every issue carries a key derived from the body, so a workflow retry does not duplicate the invoice.
- 20 sectors with their own fields (rental, utilities, education, hospitals, export…), validated before calling the API.
- Webhooks: the verification node checks the signature of CUCU events.
- Sectors 3 and 9 are listed as sandbox-only in the CUCU documentation.
| Node | Description |
|---|---|
| cucuAdministrar | Sucursales, puntos de venta y certificado |
| cucuAnular | Anular o revertir factura |
| cucuCatalogo | Catálogos del SIAT |
| cucuConsultar | Consultar facturas |
| cucuContingencia | Contingencia (SIAT caído) |
| cucuCufd | CUFD del punto de venta |
| cucuDocumento | Descargar o enviar documento |
| cucuEmisionMasiva | Emisión masiva |
| cucuEmitirFactura | Emitir factura |
| cucuEmitirLote | Emitir facturas en lote |
| cucuNotaCreditoDebito | Nota de crédito/débito |
| cucuValidarCliente | Validar cliente (padrón / NIT) |
| cucuVerificarWebhook | Verificar firma de webhook |
| cucuWebhooks | Gestionar webhooks |
Alternative: factura.bo provider
Section titled “Alternative: factura.bo provider”There are also nodes for factura.bo (api.factura.bo, by SimplifyIT S.R.L.), another authorised provider: it builds and signs the XML (electronic modality) or sends it with a control code (computerised modality) and talks to the SIN. It uses the facturabo credential (API key, environment, NIT and system code).
- 12 sectors, each with its own endpoint and fields, validated before calling the API.
- Idempotency with
X-Idempotency-Key(30 days) so retries never duplicate invoices. - Credit/debit notes from the original invoice by giving only the returned lines.
- Full contingency (event, package, validation) and webhooks with Standard Webhooks signatures.
- BCB exchange rate and reports (RCV Sales Book and monthly backup) included.
- Sandbox at
apisandbox.factura.bo(pilot SIAT) and production atapi.factura.bo; the key does not reveal the environment, the credential sets it.
| Node | Description |
|---|---|
| facturaBoAdministrar | Cuenta, sincronización y puntos de venta |
| facturaBoAnular | Anular o revertir factura |
| facturaBoCatalogo | Catálogos del SIAT |
| facturaBoConsultar | Consultar facturas |
| facturaBoContingencia | Contingencia (SIAT caído) |
| facturaBoDocumento | Descargar o enviar documento |
| facturaBoEmitirFactura | Emitir factura |
| facturaBoEmitirLote | Emitir facturas en lote |
| facturaBoNota | Nota de crédito/débito |
| facturaBoReportes | Reportes contables |
| facturaBoTipoCambio | Tipo de cambio |
| facturaBoValidarNit | Validar NIT |
| facturaBoVerificarWebhook | Verificar firma de webhook |
| facturaBoWebhooks | Gestionar webhooks |
- The
siatcredential type stores the certificate (.p12 or private key + cert PEM), its password, the issuer’s NIT, the SIN token/apikey (or delegated token) and the environment (testing/pilot or production). - The Floogos engine validates that the certificate is not expired before attempting to sign and send a document.