Documentos recibidos

La casilla <rut>@dte.facturia.cl, de dónde vienen los DTE de tus proveedores y cómo leerlos.

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:

[email protected]

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. Si vas a leer una sola página de esta documentación, que sea esa.

Listar y leer

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

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

# 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.

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

El plazo, qué pasa si no haces nada, y cómo probarlo sin esperar una semana.

Respuesta comercial

ACD, RCD, RFP, RFT y ERM — las cinco acciones y sus reglas duras.