Eventos RADIAN

Qué es RADIAN

Registro de eventos del adquirente sobre facturas electrónicas recibidas (acuse, reclamo, recibo del bien, aceptación).

Endpoints

POST /api/ubl2.1/send-event
POST /api/ubl2.1/send-event-data
Authorization: Bearer <token_empresa>
Content-Type: application/json

Opción A — con AttachedDocument en base64

{
  "event_id": 1,
  "base64_attacheddocument": "<base64_AttachedDocument_XML>",
  "base64_attacheddocument_name": "ad0001.xml"
}

Opción B — solo con CUFE (recomendado si ya tienes el CUFE)

{
  "event_id": 1,
  "document_reference": {
    "cufe": "CUFE_DE_96_CARACTERES"
  }
}

Si event_id = 2 (reclamo), agrega:

"type_rejection_id": 1

Catálogo de eventos (event_id)

id	Código	Nombre
1	030	Acuse de recibo de la FEV
2	031	Reclamo de la FEV
3	032	Recibo del bien y/o prestación del servicio
4	033	Aceptación expresa
5	034	Aceptación tácita
6	02	Documento validado por la DIAN
7	04	Documento rechazado por la DIAN

Motivos de reclamo (type_rejection_id)

id	Motivo
1	Documento con inconsistencias
2	Mercancía no entregada totalmente
3	Mercancía entregada parcialmente
4	Servicio no prestado

Campos opcionales útiles

• issuer_party (identification_number, first_name, last_name, organization_department, job_title)
• sendmail, sendmailtome, email_cc_list
• resend_consecutive

Consultar eventos de un CUFE

POST /api/ubl2.1/status/events-document/{CUFE}
Authorization: Bearer <token>

Otras consultas:

POST /api/ubl2.1/query-events-cufe-dian/{cufe}/{ambiente}
POST /api/ubl2.1/query-events-uuid/{uuid}
POST /api/ubl2.1/query-events-prefix-number/{prefix}/{number}

Recepción de XML del vendedor

POST /api/process-seller-document-reception
Authorization: Bearer <token>
Content-Type: application/json

{
  "company_idnumber": "901xxx",
  "xml_document": "<base64_AttachedDocument>"
}

Buenas prácticas

1. Respeta la secuencia normativa de eventos.
2. El CUFE debe ser válido ante DIAN.
3. Prueba primero en Sandbox.
4. Guarda el consecutivo de evento que devuelve la API.

WhatsApp soporte RADIAN