Facturiadocs
Start here

What Facturia is

A multi-empresa API for Chilean electronic invoicing — what it does for you, what stays yours, and how it is built inside.

In one sentence

Facturia issues, receives and files Chilean electronic tax documents (DTE) over an API, for as many empresas — Chilean companies, one per RUT — as you like, with a free sandbox that never touches the SII, Chile's tax authority.

What we do for you

When you send a document, this is what happens without you having to write any of it:

We assign the folio — the pre-authorised sequential number a DTE must carry — out of a real CAF (código de autorización de folios, the SII-signed block of folios) held by that empresa for that document type. A folio is never issued twice: the engine holds a unique constraint on (empresa RUT, tipo_dte, folio).

We build and sign the XML with the empresa's digital certificate, which lives encrypted in a per-tenant vault and never leaves it. The certificate is not an argument of the issuance call.

We transmit it to the SII and store the track_id.

We follow it to a terminal state, querying both of the SII's status layers (the envelope's and the document's) and publishing a single status.

We generate the PDF with the layout that already passed the SII's printed-samples review, and we tell you with a webhook.

We also receive your suppliers' DTEs in a casilla de intercambio of our own — the mailbox the SII delivers exchange traffic to — keep your Registro de Compras y Ventas in sync, compute your F29 (the monthly VAT return) and, if you switch it on, file it.

What stays yours

  • The digital certificate belongs to a natural person, who has to be an authorised user of the empresa at the SII. You upload it once and can purge it whenever you want with DELETE /v1/empresas/{empresa_id}/certificate; that revokes custody and suspends issuance, without talking to support.
  • The mandato — the revocable power of attorney that lets us act before the SII on your behalf — can be withdrawn at any moment.
  • The tax decisions. Every automation ships switched off except the folio request. Nothing files a return or issues a document because of a default we picked.
  • The exchange rate on a charge in foreign currency is yours to set. We do not invent a figure that defines the taxable base of a tax document.

We never ask for your clave tributaria

The whole tax suite runs on a certificate-authenticated session against the SII's own data area. There is no clave tributaria — the taxpayer's SII password — in Facturia: we do not ask for it, we do not store it and we do not need it.

The resource model

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)

The empresa is the tenancy boundary. Nothing crosses it: not folios, not documents, not RCV, not webhook payloads, not usage. An account is a billing and access-control container over many empresas.

The eight document types

tipo_dteDocumentPrices areNotes
33Factura electrónica (afecta)netThe only one with a copia cedible (the transferable copy used for factoring) at launch
34Factura no afecta o exentanetEvery line exempt
39Boleta electrónica (afecta)gross (IVA, Chile's VAT, included)Receptor optional (66666666-6)
41Boleta exentagrossReceptor optional
46Factura de compranetYou withhold the IVA
52Guía de despachonetRequires a dispatch block
56Nota de débitonetRequires a reference
61Nota de créditonetRequires a reference

Boletas (39/41) travel over a different transport from facturas — REST instead of SOAP, in batches, with their own token and their own certification. That is invisible to you: same endpoint, same fields, same statuses.

Next step

On this page