# Documentos recibidos (/docs/recepcion)

Los DTE de tus proveedores llegan por dos caminos y caen en un solo lugar. Facturia le da a cada
empresa una dirección de recepción:

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

Esta es la dirección que registras en el SII como el *Mail Contacto Empresas* de la empresa —
nosotros lo hacemos durante la puesta en marcha. Todo lo que llega ahí se parsea, se valida, se acusa
a nivel técnico (el `RespuestaEnvio` que exige el estándar) y se publica.

De forma independiente, reconciliamos contra el RCV, así que los documentos emitidos contra tu RUT
que nunca llegaron a la casilla igual aparecen.

> **Trampa — Tienes 8 días corridos para reclamar, y el silencio acepta**
>
> La ley chilena le da al receptor **8 días corridos** para rechazar un 33/34/43 recibido. El silencio
> es aceptación — la *aceptación tácita* — y pasado el día 8 el documento queda irrevocablemente
> aceptado y se vuelve libremente transferible.
>
> Por eso `default_if_silent` viene en cada objeto, y por eso **Facturia nunca actúa por ti** salvo que
> enciendas `auto_accept_received`: no hacer nada es una decisión jurídicamente cargada, y es la que
> tomamos por defecto.
>
> Está explicado entero en [La ventana de 8 días](/docs/recepcion/ventana-8-dias). Si vas a leer una
> sola página de esta documentación, que sea esa.

## Listar y leer [#listar-y-leer]

```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"
}
```

### El campo `source` [#el-campo-source]

| Valor         | Significa                                            |
| ------------- | ---------------------------------------------------- |
| `intercambio` | Llegó a la casilla `<rut>@dte.facturia.cl`           |
| `rcv`         | Lo encontramos en el registro del SII al reconciliar |
| `manual`      | Se cargó a mano                                      |

Que un documento tenga `source: "rcv"` es información: significa que tu proveedor lo emitió contra tu
RUT pero nunca lo mandó a tu casilla. El plazo corre igual.

## Los artefactos [#los-artefactos]

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

> **El XML es el artefacto legal, no nuestra lectura de él**
>
> `GET /v1/received_documents/{received_document_id}/xml` devuelve los bytes exactamente como llegaron,
> con la firma intacta. Nuestro parseo del documento es una comodidad; ese archivo es lo que vale ante
> el SII y ante un tribunal. `expand=raw_xml` devuelve lo mismo en línea.
>
> `expand=raw_xml` es un parámetro **de un solo documento**. En el listado responde
> `400 invalid_field`: incorporar un sobre firmado completo por fila convertiría una página de facturas
> en cien lecturas de archivo.

## Eventos [#eventos]

| Evento                                   | Cuándo se dispara                                                           |
| ---------------------------------------- | --------------------------------------------------------------------------- |
| `received_document.created`              | Llegó un DTE de proveedor (por intercambio o por reconciliación con el RCV) |
| `received_document.deadline_approaching` | Quedan 2 días de la ventana de 8 y el estado sigue en `pending`             |
| `received_document.accepted`             | Se registró una aceptación                                                  |
| `received_document.rejected`             | Se registró un reclamo                                                      |
| `received_document.receipt_acknowledged` | Se otorgó el recibo de mercaderías                                          |

- [La ventana de 8 días](/docs/recepcion/ventana-8-dias): El plazo, qué pasa si no haces nada, y cómo probarlo sin esperar una semana.

- [Respuesta comercial](/docs/recepcion/respuesta-comercial): ACD, RCD, RFP, RFT y ERM — las cinco acciones y sus reglas duras.