# factura.bo — API de Facturación Electrónica para Bolivia (SIAT)

> API REST que permite a cualquier sistema (ERP, e-commerce, punto de venta, software a medida)
> emitir facturas electrónicas fiscales en Bolivia, integrada con el SIAT de Impuestos Nacionales.
> Soporta las modalidades Electrónica en Línea (firma digital) y Computarizada en Línea, los 15
> sectores de documentos fiscales, notas de crédito/débito, anulaciones, contingencia offline y
> validación de NIT. Operada por SimplifyIT S.R.L. (Bolivia).

## Documentación

- [Guía de integración](https://api.factura.bo/guia): quickstart, autenticación por API key, ejemplos curl de los 15 sectores
- [Swagger UI](https://api.factura.bo/docs): referencia interactiva de todos los endpoints
- [OpenAPI JSON](https://api.factura.bo/openapi.json): especificación completa para generar clientes

## Entornos

- Producción: https://api.factura.bo (SIAT real)
- Sandbox: https://apisandbox.factura.bo (SIAT piloto, para pruebas)
- Autenticación: cabecera X-API-KEY (solicitar a gm@simplifyit.com.bo)
- Acceso público por CUF (sin autenticación): GET /f/{cuf} — página de verificación
  de la factura con descargas permanentes de PDF y XML para el cliente final
- Webhooks firmados (HMAC-SHA256, estándar Standard Webhooks) con reintentos:
  eventos factura.emitida, factura.anulada, factura.anulacion_revertida, contingencia.paquete_enviado, creditos.bajos,
  siat.caido y siat.recuperado (para activar contingencia automáticamente)

## Estado del SIAT en tiempo real (gratuito, sin API key)

- [Página de estado](https://api.factura.bo/estado): ¿está caído el SIAT hoy? Estado actual del SIAT
  de Impuestos Nacionales (producción y piloto), latencia y uptime de los últimos 90 días,
  sondeado cada 5 minutos con la operación oficial verificarComunicacion
- [GET /v1/estado](https://api.factura.bo/v1/estado): el mismo estado en JSON para integraciones y monitoreo

## Servidor MCP (Model Context Protocol)

- URL: https://api.factura.bo/mcp (transporte HTTP, header X-API-KEY)
- Herramientas: emitir_factura, consultar_factura, listar_facturas, validar_nit,
  consultar_creditos, consultar_tipo_de_cambio, listar_sectores
- Permite a asistentes de IA (Claude, ChatGPT, Cursor) emitir y consultar facturas
  electrónicas bolivianas conversando. Sandbox: https://apisandbox.factura.bo/mcp

## Tipo de cambio BCB (gratuito, sin API key)

- [Página web](https://api.factura.bo/tipo-de-cambio): dólar USD/BOB y UFV oficiales del Banco Central de Bolivia
- [GET /ExchangeRate](https://api.factura.bo/ExchangeRate): JSON con usd_bob y ufv_bob, actualizado cada noche
- [GET /ExchangeRate/history](https://api.factura.bo/ExchangeRate/history): histórico de cotizaciones

## Integración con Odoo

- Addon "SimplifyIT: Facturación Electrónica Bolivia (SIAT)" para Odoo 19 (Community y Enterprise):
  emisión de facturas al SIAT desde account.move, notas de crédito, anulación, validación de NIT
  y renovación automática del CUFD.
- Addon gratuito "SimplifyIT: Tipo de Cambio BCB" para Odoo 17, 18 y 19: actualiza USD/BOB/UFV a diario.
- Sitio del producto: https://factura.bo

## Contacto

- Email: gm@simplifyit.com.bo
- Empresa: SimplifyIT S.R.L., Bolivia — https://www.simplifyit.com.bo