# Qué es Facturia (/docs/empezar)

## En una frase [#en-una-frase]

Facturia emite, recibe y declara documentos tributarios electrónicos chilenos por API, para tantas
empresas como quieras, con un sandbox gratis que no toca el SII.

## Lo que hacemos por ti [#lo-que-hacemos-por-ti]

Cuando envías un documento, esto es lo que ocurre sin que tengas que programarlo:

**Asignamos el folio** desde un CAF real de esa empresa y ese tipo de documento. Un folio jamás se
emite dos veces: el motor sostiene una restricción única sobre `(RUT de empresa, tipo_dte, folio)`.

**Armamos y firmamos el XML** con el certificado digital de la empresa, que vive cifrado en una
bóveda por inquilino y nunca sale de ahí. El certificado no es un argumento de la llamada de emisión.

**Lo transmitimos al SII** y guardamos el `track_id`.

**Lo seguimos hasta un estado terminal**, consultando las dos capas de estado del SII (la del sobre
y la del documento) y publicando un solo `status`.

**Generamos el PDF** con el layout que ya pasó la revisión de muestras impresas del SII, y te
avisamos con un webhook.

Además recibimos los DTE de tus proveedores en una casilla de intercambio propia, mantenemos tu
Registro de Compras y Ventas sincronizado, calculamos tu F29 y —si tú lo enciendes— lo declaramos.

## Lo que sigue siendo tuyo [#lo-que-sigue-siendo-tuyo]

* **El certificado digital** pertenece a una persona natural que debe ser usuario autorizado de la
  empresa ante el SII. Lo cargas una vez y puedes purgarlo cuando quieras con
  `DELETE /v1/empresas/{empresa_id}/certificate`; eso revoca la custodia y suspende la emisión, sin
  hablar con soporte.
* **El mandato** que nos autoriza a actuar ante el SII es revocable en cualquier momento.
* **Las decisiones tributarias.** Toda automatización viene apagada por defecto salvo la solicitud
  de folios. Nada declara un formulario ni emite un documento por un default que elegimos nosotros.
* **El tipo de cambio** de un cargo en moneda extranjera lo pones tú. No inventamos una cifra que
  define la base imponible de un documento tributario.

> **Nunca pedimos tu clave tributaria**
>
> Toda la suite tributaria funciona con una sesión autenticada por certificado contra la zona de datos
> del propio SII. En Facturia no hay clave tributaria: no la pedimos, no la guardamos y no la
> necesitamos.

## El modelo de recursos [#el-modelo-de-recursos]

```
account
├── api_key                (modo, scopes, lista blanca de empresas)
├── webhook_endpoint  ──▶  event ──▶ webhook_delivery
├── usage_record           (libro inmutable; se anota al aceptar el SII)
└── empresa                (una por RUT; el límite de tenencia de todo lo de abajo)
    ├── certificate        (custodia del .pfx, vencimiento)
    ├── mandato            (autorización revocable para actuar ante el SII)
    ├── onboarding         (draft → … → emitting; certificación por tipo de documento)
    ├── automation_settings(auto_emit_46, auto_file_f29, auto_request_folios, …)
    ├── branding           (logo, formatos de impresión)
    ├── caf / folio_range  (disponibilidad por tipo_dte)
    ├── document           (DTE emitido) ──▶ artefactos, eventos, referencias
    ├── received_document  (DTE de proveedor) ──▶ commercial_response
    ├── connection         (feed bancario Fintoc → gastos)
    └── tax
        ├── rcv_entry      (compras / ventas, estado_contable, caracterización)
        ├── expense        (cargo en moneda extranjera → candidato a tipo 46)
        ├── statement      (cartola CSV/XLSX subida → gastos)
        ├── suggestion     (acción detectada, p. ej. emitir un tipo 46)
        ├── f29_proposal   (calculado, por período, + .txt listo para subir)
        └── f29_filing     (job asíncrono: prepared → uploading → submitted → accepted)
```

**La empresa es el límite de tenencia.** Nada lo cruza: ni folios, ni documentos, ni RCV, ni
payloads de webhook, ni consumo. Una cuenta es un contenedor de facturación y control de acceso
sobre muchas empresas.

## Los ocho tipos de documento [#los-ocho-tipos-de-documento]

| `tipo_dte` | Documento                    | Los precios son           | Notas                                        |
| ---------- | ---------------------------- | ------------------------- | -------------------------------------------- |
| 33         | Factura electrónica (afecta) | netos                     | El único con copia cedible en el lanzamiento |
| 34         | Factura no afecta o exenta   | netos                     | Todas las líneas exentas                     |
| 39         | Boleta electrónica (afecta)  | **brutos (IVA incluido)** | Receptor opcional (`66666666-6`)             |
| 41         | Boleta exenta                | **brutos**                | Receptor opcional                            |
| 46         | Factura de compra            | netos                     | Tú retienes el IVA                           |
| 52         | Guía de despacho             | netos                     | Requiere un bloque `dispatch`                |
| 56         | Nota de débito               | netos                     | Requiere una referencia                      |
| 61         | Nota de crédito              | netos                     | Requiere una referencia                      |

Las boletas (39/41) viajan por un transporte distinto al de las facturas — REST en vez de SOAP, por
lotes, con su propio token y su propia certificación. Eso es invisible para ti: mismo endpoint,
mismos campos, mismos estados.

## Siguiente paso [#siguiente-paso]

- [Quickstart](/docs/empezar/quickstart): Una llave de sandbox y una boleta emitida, con el ciclo de estados real.

- [Conceptos](/docs/empezar/conceptos): Empresa, documento, modo y el header `Facturia-Empresa`.

- [De sandbox a producción](/docs/empezar/produccion): Los dos carriles, el mandato, los pasos que hace una persona en el SII y la puesta en vivo.