Modalidades de facturación SIAT en Bolivia explicadas

Cuando registras una empresa ante el SIN para facturar, uno de los primeros datos que defines es la modalidad de facturación. No es un detalle menor: determina cómo se emite cada factura, qué credenciales necesitas y, en algunos casos, cómo se agrupan tus documentos antes de mandarlos a Impuestos.

Qué es la modalidad

La modalidad describe el mecanismo técnico con el que tu empresa emite ante el SIN. En la API de facturación, la modalidad es un campo propio de la empresa, con dos valores posibles:

electronic       # electrónica (la modalidad por defecto)
computarized     # computarizada

Una vez que defines la modalidad a nivel de empresa, todos los puntos de venta de esa empresa la heredan automáticamente. No es algo que configures caja por caja: si tienes diez puntos de venta, los diez comparten la misma modalidad.

{
  "nit": "1234567890",
  "business_name": "XMART SRL",
  "metadata": { "modality": "electronic" }
}

Si más adelante necesitas cambiarla, se actualiza a nivel de empresa:

PUT /companies/{company_uid}

{ "modality": "computarized" }

Modalidad electrónica

Es la modalidad por defecto y la más común para negocios que facturan con conexión a internet de forma regular. Cada venta se convierte en una factura individual que se firma y se envía al SIN, normalmente en segundo plano y sin que el cliente note ninguna demora:

POST /invoices

La API acepta dos formas de despacho para esta modalidad:

• mode=async (el comportamiento por defecto): la factura se guarda al instante y se despacha al SIN por detrás. Pocos segundos después queda CONFIRMED.
• mode=sync: espera la respuesta del SIN antes de responderte, útil si tu flujo necesita saber de inmediato si la factura fue validada o rechazada.

Modalidad computarizada

La modalidad computarizada suele asociarse a negocios con alto volumen de operaciones, donde emitir y enviar una factura a la vez sería demasiado lento. Para estos casos, la API expone un endpoint de emisión masiva:

POST /invoices/massive

Este endpoint permite emitir hasta 500 facturas en una sola petición. Por detrás, el sistema procesa cada una, detecta la empresa, la sucursal y el punto de venta correspondientes, y las agrupa en paquetes para enviarlas al SIN de forma eficiente.

También existe el flujo de cajas para emisión masiva acumulada durante el día:

POST /boxes/open      # abrir una caja
POST /boxes/close     # cerrarla y dividirla en paquetes por punto de venta
POST /boxes/send       # enviar esos paquetes al SIN

Al listar tus cajas con GET /boxes, la respuesta ya viene filtrada para mostrarte solo las de modalidad masiva, así que no necesitas indicar ningún tipo de forma manual: el sistema ya sabe que ese flujo es para tu modalidad.

Cómo saber en qué modalidad se emitió una factura

Cada factura que consultas con la API trae dos campos que aclaran exactamente cómo se generó:

{
  "modality": "electronic",
  "emission_type": "online"
}

• modality: la modalidad de la empresa en el momento de emitir (electronic o computarized).
• emission_type: cómo se despachó puntualmente esa factura (online, offline si fue durante una contingencia, o massive si vino dentro de un lote).

Puedes usar ambos campos como filtros al listar facturas:

GET /invoices?modality=computarized&emission_type=massive

Migrar histórico entre modalidades

Si vienes de otro sistema y necesitas traer tu histórico de facturas, la API detecta la modalidad automáticamente a partir de cada XML firmado que subas, sin que tengas que indicarla a mano:

POST /invoices/migrate

El proceso lee el tipo de documento dentro del XML para determinar si esa factura corresponde a modalidad electrónica o computarizada, y arma sucursales y puntos de venta según los códigos que ya traía el XML del sistema anterior.

Catálogos de facturación compartidos entre modalidades

Sea cual sea tu modalidad, la lista de valores permitidos para facturar (formas de pago, monedas, unidades de medida, tipos de documento de identidad, actividades económicas) es la misma: viene directamente de los catálogos oficiales del SIN, y no cambia según cómo emitas.

GET /catalogs?catalog_type=payment_methods

Esto significa que si tu empresa cambia de modalidad electrónica a computarizada, o viceversa, no tienes que reconstruir esas listas de referencia: siguen siendo válidas y se sincronizan igual, independientemente del tipo de emisión que elijas para tus facturas.

Notas de crédito y débito en cada modalidad

Un punto que conviene tener claro: las notas de crédito y débito no se emiten por el mismo endpoint que las facturas normales, sin importar la modalidad de tu empresa. Tienen su propia ruta dedicada:

POST /invoices/notes

Esto aplica igual en modalidad electrónica o computarizada. Lo que sí cambia entre modalidades es el volumen esperado: si emites notas dentro de un cierre masivo, probablemente las vas a generar en el mismo lote que las facturas que corrige, en vez de una por una.

Cuál modalidad te conviene

En términos generales:

• Si emites facturas una por una, en el momento de cada venta, con conexión a internet disponible casi siempre, la modalidad electrónica es la más directa: cada venta se convierte en una llamada a la API y listo.
• Si tu operación implica volúmenes altos, cierres de caja con muchas ventas acumuladas, o procesos por lotes, la modalidad computarizada junto con el endpoint de emisión masiva o el flujo de cajas suele ajustarse mejor a ese ritmo.

Ninguna decisión es definitiva: la modalidad se puede ajustar a nivel de empresa si tu operación cambia con el tiempo.

Si quieres ver el detalle técnico completo, revisa nuestra página de facturación electrónica, y si buscas precios y límites según tu volumen, están en los planes de la API.