# Received documents (/en/docs/recepcion)

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:

```
77928532-4@dte.facturia.cl
```

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](/en/docs/recepcion/ventana-8-dias). If you are
> going to read a single page of this documentation, make it that one.

## List and read [#list-and-read]

```bash
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
```

```json
{
  "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 [#the-source-field]

| Value         | Means                                               |
| ------------- | --------------------------------------------------- |
| `intercambio` | It arrived at the `<rut>@dte.facturia.cl` casilla   |
| `rcv`         | We found it in the SII's register while reconciling |
| `manual`      | It 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 [#the-artefacts]

```bash
# 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 [#events]

| Event                                    | When it fires                                                                |
| ---------------------------------------- | ---------------------------------------------------------------------------- |
| `received_document.created`              | A supplier DTE arrived (by intercambio or by reconciliation against the RCV) |
| `received_document.deadline_approaching` | 2 days left of the 8-day window and the state is still `pending`             |
| `received_document.accepted`             | An acceptance was registered                                                 |
| `received_document.rejected`             | A claim was registered                                                       |
| `received_document.receipt_acknowledged` | The goods receipt was granted                                                |

- [The 8-day window](/en/docs/recepcion/ventana-8-dias): The deadline, what happens if you do nothing, and how to test it without waiting a week.

- [Commercial response](/en/docs/recepcion/respuesta-comercial): ACD, RCD, RFP, RFT and ERM — the five actions and their hard rules.