SIAT Bolivia — Facturación electrónica (SIN, Facturación en Línea)

Descripción

Los nodos SIAT conectan tus workflows con la facturación electrónica de Bolivia (SIN — Servicio de Impuestos Nacionales, Facturación en Línea). El SIAT usa tres códigos: CUIS (inicio de sistemas), CUFD (diario, vigente 24h, con su código de control) y CUF (por factura, lo genera el emisor). La factura es un XML firmado con XMLDSig y se envía por SOAP (comprimido con GZIP).

Nodo	Qué hace
SIAT: Obtener CUFD (siatObtenerCufd)	Obtiene la CUFD del día + código de control (y CUIS)
SIAT: Emitir factura (siatEmitirFactura)	Genera el CUF, arma el XML, lo firma y lo envía
SIAT: Anular factura (siatAnular)	Anula una factura por su CUF con un código de motivo
SIAT: Representación / QR (siatRepresentacion)	Genera la representación imprimible con QR

En Bolivia hace falta una CUFD vigente (diaria)

Para emitir, primero necesitás una CUFD vigente (dura 24h) y su código de control — obtenelos con SIAT: Obtener CUFD al inicio del día. El CUF se genera por factura (algoritmo del SIN: módulo 11 + hexadecimal + código de control). La autenticación usa el apikey (token delegado) del SIN. El IVA general es 13% e va incluido en el precio.

Credencial

Los nodos usan una credencial de tipo SIAT. Creala en Credenciales → Agregar → Bolivia / SIN (SIAT) con:

Campo	Descripción
NIT del emisor	El número de identificación tributaria.
Certificado (.p12)	Con su contraseña; se usa para firmar.
Apikey / Token del SIN	El token delegado para autenticar los WS.
Código de sistema	El asignado al registrar tu sistema.
Sucursal / Punto de venta	Códigos del punto emisor.
Modalidad	1 electrónica en línea, 2 computarizada.
Ambiente	Pruebas (piloto) o Producción.

Obtener la CUFD

Nodo: SIAT: Obtener CUFD. Devuelve la CUFD del día y su código de control. Marcá Obtener CUIS si todavía no tenés el CUIS. Guardá esos valores para pasárselos a los nodos de emisión (o dejalos en la credencial).

Emitir una factura

Nodo: SIAT: Emitir factura. Los precioUnitario van con IVA incluido (Bolivia). Pasale la cufd y el codigo_control vigentes.

{
  "comprador": { "nit": "987654321", "razonSocial": "Cliente Bolivia SA", "tipoDocumento": 5 },
  "items": [
    { "descripcion": "Servicio de consultoría", "cantidad": 1, "precioUnitario": 113, "codigoProductoSin": "99100", "actividadEconomica": "620000" }
  ]
}

tipoDocumento del comprador: 1 CI, 5 NIT. El nodo genera el CUF, devuelve el código de recepción y el QR.

Anular una factura

Nodo: SIAT: Anular factura. Anula por CUF con un código de motivo del catálogo del SIN (1 factura mal emitida, etc.). Requiere una CUFD vigente.

Representación impresa (QR)

Nodo: SIAT: Representación / QR. Genera la representación imprimible en HTML (exportable a PDF), con el CUF, el QR de consulta y la leyenda obligatoria del SIN.

Manejo de errores

Situación	Reintentable	Qué hacer
SIN rechaza / observa	No	El nodo devuelve los mensajes. Corregí la factura.
CUFD vencida	No	Obtené una CUFD nueva (dura 24h).
Apikey inválido	No	Revisá el token delegado del SIN.
Red / Timeout	Sí	Problema pasajero; se reintenta automáticamente.

Ambiente piloto del SIN

Probá siempre en el ambiente piloto (pilotosiat) antes de producción, y validá la estructura del XML contra el XSD del SIN. La firma XAdES completa debe validarse contra el piloto.

Ver también

• Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones que fallan.
• Nodo HTTP — para servicios no cubiertos por estos nodos.