Qué es Facturia
Una API multiempresa de facturación electrónica chilena — qué hace por ti, qué sigue siendo tuyo y cómo está armada por dentro.
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
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
- 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
account
├── api_key (modo, scopes, lista blanca de empresas)
├── webhook_endpoint ──▶ event ──▶ webhook_delivery
├── usage_record (libro inmutable; facturable 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
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.