Documentos recibidos y RADIAN

Consulta con AdapterDian las facturas que otras empresas te emiten y responde ante la DIAN con eventos RADIAN antes de que venza el plazo.

El ámbito /receptions/v1 es tu bandeja de compras: las facturas que otros te emiten, y cómo respondes por ellas ante la DIAN.

La bandeja

GET /receptions/v1/received-documents consulta al proveedor tecnológico en cada llamada, que es quien recibe los documentos de la DIAN. Nada de este ámbito se guarda en el adaptador.

Filtros: issued_from e issued_to (inclusivos, YYYY-MM-DD), issuer_tax_id (con o sin puntos y dígito de verificación), number, cufe y page. Un rango de fechas amplio tarda más que un día suelto.

El id de cada elemento es el que exige el endpoint de eventos. Es el identificador del proveedor, no un UUID.

Carga por CUFE

Un documento puede llegarte por otra vía (el emisor te lo manda por correo) antes de aparecer en la bandeja. Agrégalo con su CUFE:

POST /receptions/v1/received-documents
{ "cufe": "…" }

Responde con eventos RADIAN

Tres días hábiles

Vencido el plazo, la factura se entiende aceptada tácitamente y ya no se puede reclamar.

El orden es obligatorio: acuse → recibo del bien → aceptación o reclamo. Una transición inválida vuelve como 409.

`type`	Evento
`acknowledgement`	Acuse de recibo
`goods_receipt`	Recibo del bien o servicio
`claim`	Reclamo. Exige `claim_concept_code`.
`express_acceptance`	Aceptación expresa
`tacit_acceptance`	Aceptación tácita

actor es quien responde por tu empresa ante la DIAN, con su documento de identidad, nombre, cargo y dependencia. Un reclamo sin claim_concept_code se rechaza con 422 antes de salir: sin causal la DIAN no registra la objeción.

POST /receptions/v1/received-documents/{id}/events

curl -X POST https://adapterdian.piensait.com/functions/v1/receptions/v1/received-documents/$ID/events \
  -H "Authorization: Bearer $ADAPTERDIAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "claim",
    "actor": {
      "identification_document_code": "31",
      "identification": "901724254",
      "first_name": "Laura",
      "last_name": "Restrepo",
      "job_title": "Recepcion de facturas",
      "organization_department": "Compras"
    },
    "claim_concept_code": "02"
  }'

La respuesta es 202 con status: "accepted" y acknowledged_at. Responder documentos recibidos exige invoices:write.