Bolivia

En Bolivia, Floogos se conecta directo al SIN (Servicio de Impuestos Nacionales) a través del SIAT (Sistema de Facturación), sin proveedor intermedio obligatorio: el propio motor arma el XML de la factura, lo firma con el certificado del emisor y habla el protocolo SOAP del SIN, con el cuerpo comprimido en GZIP.

Modelo de integración

• Directo, sin PAC: el flujo va contra los servicios SOAP del SIAT, según el modo (pruebas/piloto o producción) y el certificado que trae la credencial.
• CUFD diaria: antes de emitir cualquier factura hay que obtener la CUFD (Código Único de Facturación Diaria), vigente por 24 horas, junto con su código de control. También puede obtenerse ahí el CUIS (Código Único de Inicio de Sistemas) si todavía no se cuenta con uno.
• CUF por factura: cada factura genera su propio CUF (Código Único de Facturación), calculado a partir del NIT del emisor, la fecha de emisión, la CUFD del día y otros datos del documento.
• Firma digital: el XML de la factura se firma con XMLDSig usando el certificado (.p12) de la credencial antes de enviarlo.
• Envío por SOAP con GZIP: el XML firmado se comprime y se envía por SOAP a los servicios del SIN, para la recepción y, opcionalmente, la validación del estado.
• IVA 13% incluido: el Impuesto al Valor Agregado va incluido en el precio unitario de cada ítem, no se informa como impuesto aparte.

Cuándo queda válida una factura

Que el SIN reciba el XML no cierra el trámite por sí solo. El nodo de emisión puede, en el mismo paso, consultar la validación del estado (comportamiento por defecto), y solo entonces la factura queda validated. Si el SIN la rechaza en la recepción o en la validación, queda rejected y no tiene validez tributaria hasta corregir y reenviar.

Nodos disponibles

Nodo	Descripción
SiatObtenerCufd	Obtiene la CUFD vigente (24h) y su código de control; opcionalmente el CUIS
SiatEmitirFactura	Genera el CUF, arma y firma el XML, y envía la factura de compra-venta por SOAP/GZIP
SiatAnular	Anula una factura por su CUF con un código de motivo del catálogo del SIN
SiatRepresentación	Genera la representación impresa (HTML/PDF) con el QR de consulta

Flujo típico

1. SiatObtenerCufd — al inicio del día (o cuando venza la CUFD anterior), se obtiene la CUFD vigente y su código de control.
2. SiatEmitirFactura — con esa CUFD se emite cada factura de compra-venta a lo largo del día.
3. SiatAnular — si hace falta anular una factura ya emitida, se hace por su CUF (también requiere una CUFD vigente).
4. SiatRepresentación — se genera el HTML/PDF con el QR para entregarle al cliente su comprobante impreso.

Guías de uso

Paso a paso con ejemplos: Facturar en Bolivia con CUCU y Facturar en Bolivia con factura.bo.

Alternativa: proveedor CUCU

Además de la conexión directa, Floogos ofrece nodos para CUCU (docs.cucu.bo), proveedor autorizado que se ocupa de la firma, los códigos CUIS/CUFD y el envío al SIN. Se usa con la credencial cucu (API key sk_test_ para sandbox, sk_live_ para producción).

• Idempotencia: cada emisión lleva una clave derivada del cuerpo, así que un reintento del workflow no duplica la factura.
• 20 sectores con sus campos propios (alquiler, servicios básicos, educación, hospitales, exportación…), validados antes de llamar a la API.
• Webhooks: el nodo de verificación comprueba la firma de los eventos de CUCU.
• Los sectores 3 y 9 figuran solo en sandbox en la documentación de CUCU.

Nodo	Descripción
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

Alternativa: proveedor factura.bo

También hay nodos para factura.bo (api.factura.bo, de SimplifyIT S.R.L.), otro proveedor autorizado: construye y firma el XML (modalidad electrónica) o lo envía con código de control (modalidad computarizada) y habla con el SIN. Se usa con la credencial facturabo (API key, entorno, NIT y código de sistema).

• 12 sectores, cada uno con su endpoint y sus campos propios, validados antes de llamar a la API.
• Idempotencia con X-Idempotency-Key (30 días) para no duplicar facturas en reintentos.
• Notas de crédito/débito desde la factura original indicando solo las líneas devueltas.
• Contingencia completa (evento, paquete, validación) y webhooks con firma Standard Webhooks.
• Tipo de cambio del BCB y reportes (Libro de Ventas RCV y respaldo mensual) incluidos.
• Sandbox en apisandbox.factura.bo (SIAT piloto) y producción en api.factura.bo; la clave no delata el entorno, lo elige la credencial.

Nodo	Descripción
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

Notas

• La credencial de tipo siat guarda el certificado (.p12 o clave+cert PEM), su contraseña, el NIT del emisor, el token/apikey del SIN (o token delegado) y el ambiente (pruebas/piloto o producción).
• El motor Floogos valida que el certificado no esté vencido antes de intentar firmar y enviar un documento.