> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.supay.dev/informacion-general/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.supay.dev/_mcp/server.

# Supay · Facturación electrónica para Bolivia

Emite facturas válidas ante el SIAT desde tu propio sistema, por API o con el
SDK TypeScript. Sin integrar SOAP a mano, sin gestionar CUIS/CUFD a mano.

> **Info**
>
> Beta cerrada: solo ambiente **PILOTO** del SIAT (sin validez fiscal).
> Pre-requisito único: la API corriendo (`GET /v1/health` → `{"status":"ok"}`).

## Por dónde empiezo

#### [Emitir mi primera factura](/empezar/quickstart)

5 minutos: health → preview → emit. El camino más corto a tu primer `ACCEPTED`.

#### [Operar un tenant](/empezar/onboarding)

20 minutos: empresa → sucursal → POS → P12 → setup SIAT → catálogos.

#### [Explorar sectores](/sectores)

Los 52 sectores con sus campos y ejemplos: compra-venta, salud, minería y más.

## Qué resuelve

| Sin Supay                                                | Con Supay                                        |
| -------------------------------------------------------- | ------------------------------------------------ |
| Integrar SOAP del SIAT a mano (12 fachadas, 51 sectores) | Un `POST /v1/invoices/emit` + SDK                |
| Gestionar CUIS/CUFD, firma XAdES, CUF y catálogos        | Automático (setup + renovación + sincronización) |
| Contingencia offline manual                              | Emisión `OFFLINE` + paquetes oficiales           |

## Cómo funciona (flujo día 1)

#### Alta del tenant

La empresa se registra (NIT + razón social) y recibe su `X-API-Key`.
Ver [Onboarding](/empezar/onboarding-del-tenant).

#### Puesta en marcha SIAT

Sucursal → punto de venta → certificado P12 → setup (CUIS + CUFD) →
sincronización de catálogos.

#### Facturación

`preview` (validar) → `emit` (crear y emitir) → `ACCEPTED`. XML y PDF
descargables. Ver [Emitir factura](/facturacion/emitir-factura).

#### Post-emisión

Consulta de estado, [anulación](/facturacion/anulacion-venta),
[contingencia](/facturacion/contingencia-offline) y
[paquetes](/facturacion/paquetes-y-masiva).

## Mapa del sitio

| Quiero...                            | Voy a...                                                |
| ------------------------------------ | ------------------------------------------------------- |
| Ver el modelo de datos               | [Modelo de datos](/informacion-general/modelo-de-datos) |
| Entender vocabulario fiscal          | [Glosario](/informacion-general/glosario-siat)          |
| Autenticarme (API key / JWT)         | [Autenticación](/empezar/autenticacion)                 |
| Emitir, anular, contingencia, lotes  | [Facturación](/facturacion/emitir-factura)              |
| CUIS/CUFD, catálogos, firma, compras | [Operaciones SIAT](/operaciones-siat/cuis-y-cufd)       |
| Ver el SDK como reflejo de la API    | [SDK TypeScript](/referencia/sdk-type-script)           |
| Entender un error                    | [Errores](/referencia/errores-accionables)              |

## Docs

- [Modelo de datos](https://docs.supay.dev/informacion-general/modelo-de-datos.md)
- [Glosario SIAT](https://docs.supay.dev/informacion-general/glosario-siat.md)