Facturiadocs
Reception

Received documents

The <rut>@dte.facturia.cl casilla, where your suppliers' DTEs come from, and how to read them.

Your suppliers' DTEs (documentos tributarios electrónicos, Chile's electronic tax documents) arrive by two routes and land in one place. Facturia gives every empresa a reception address:

This is the address you register with the SII (Chile's tax authority) as the empresa's Mail Contacto Empresas — we do it during onboarding. Everything that lands there is parsed, validated, acknowledged at the technical level (the RespuestaEnvio the standard demands) and published.

Separately, we reconcile against the RCV (registro de compras y ventas, the SII's purchase and sales register), so documents issued against your RUT (Chile's taxpayer id) that never reached the casilla — the mailbox the exchange delivers to — show up anyway.

Trap

You have 8 days to claim, and silence accepts

Chilean law gives the receiver 8 days — calendar days — to reject a 33/34/43 it has received. Silence is acceptance — aceptación tácita — and past day 8 the document is irrevocably accepted and becomes freely transferable.

That is why default_if_silent ships on every object, and why Facturia never acts for you unless you turn on auto_accept_received: doing nothing is a legally loaded decision, and it is the one we take by default.

The whole thing is explained in The 8-day window. If you are going to read a single page of this documentation, make it that one.

List and read

curl -G https://api.facturia.cl/v1/received_documents \
  -H "Authorization: Bearer $FACTURIA_KEY" -H "Facturia-Empresa: $EMPRESA" \
  -d "issue_date[gte]=2026-08-01" -d tipo_dte=33 -d commercial_response_state=pending
{
  "id": "rdoc_01K2R9M3D8V5QW7N",
  "object": "received_document",
  "mode": "live",
  "tipo_dte": 33,
  "folio": 8812,
  "emisor": { "rut": "96790240-3", "legal_name": "Proveedor Austral SpA", "giro": "Distribución mayorista" },
  "issue_date": "2026-08-12",
  "received_at": "2026-08-12T18:22:41Z",
  "source": "intercambio",
  "totals": { "net": 450000, "iva": 85500, "exempt": 0, "total": 535500 },
  "items": [ { "description": "Insumos varios", "quantity": 30, "unit_price": 15000, "amount": 450000 } ],
  "references": [],
  "xml_url": "https://api.facturia.cl/v1/received_documents/rdoc_01K2R9M3D8V5QW7N/xml",
  "pdf_url": "https://api.facturia.cl/v1/received_documents/rdoc_01K2R9M3D8V5QW7N/pdf",
  "sii": { "estado": "DOK", "cedible": true },
  "rcv": { "entry_id": "rcv_01K2RA...", "estado_contable": "REGISTRO", "period": "2026-08" },
  "commercial_response": {
    "state": "pending",
    "state_reason": null,
    "deadline_at": "2026-08-20T23:59:59-04:00",
    "days_remaining": 6,
    "available_actions": ["accept", "reject_content", "reject_partial", "reject_total", "acknowledge_receipt"],
    "default_if_silent": "accepted",
    "history": []
  },
  "created_at": "2026-08-12T18:22:44Z"
}

The source field

ValueMeans
intercambioIt arrived at the <rut>@dte.facturia.cl casilla
rcvWe found it in the SII's register while reconciling
manualIt was uploaded by hand

A document carrying source: "rcv" is telling you something: your supplier issued it against your RUT but never sent it to your casilla. The clock runs all the same.

The artefacts

# El XML tal como llegó, con la firma intacta
curl -L https://api.facturia.cl/v1/received_documents/rdoc_01K2R9M3D8V5QW7N/xml \
  -H "Authorization: Bearer $FACTURIA_KEY" -H "Facturia-Empresa: $EMPRESA" -o proveedor.xml

# El PDF renderizado del documento recibido
curl -L https://api.facturia.cl/v1/received_documents/rdoc_01K2R9M3D8V5QW7N/pdf \
  -H "Authorization: Bearer $FACTURIA_KEY" -H "Facturia-Empresa: $EMPRESA" -o proveedor.pdf

The XML is the legal artefact, not our reading of it

GET /v1/received_documents/{received_document_id}/xml returns the bytes exactly as they arrived, with the signature intact. Our parse of the document is a convenience; that file is what counts before the SII and before a court. expand=raw_xml returns the same thing inline.

expand=raw_xml is a single-document parameter. On the list endpoint it answers 400 invalid_field: inlining a whole signed envelope per row would turn one page of facturas — Chile's B2B invoices — into a hundred file reads.

Events

EventWhen it fires
received_document.createdA supplier DTE arrived (by intercambio or by reconciliation against the RCV)
received_document.deadline_approaching2 days left of the 8-day window and the state is still pending
received_document.acceptedAn acceptance was registered
received_document.rejectedA claim was registered
received_document.receipt_acknowledgedThe goods receipt was granted

On this page