Generar eventos RADIAN
Acuse de recibo, aceptación, inscripción como título valor, endosos, mandato, protesto e informe de pago, sobre cualquier documento de la plataforma.
Integración
REST sobre JSON. Nada que instalar.
Una llave en un encabezado, un JSON en el cuerpo y una respuesta con el estado real de la DIAN. La documentación completa y las credenciales de prueba se entregan al iniciar la evaluación.
Autenticación
Una llave que usted crea y usted revoca
Las llaves de API se administran desde el portal. No hay que escribirnos para rotar una, ni para dar de baja la de un proveedor que salió.
Cada llave lleva permisos granulares: una puede registrar documentos de proveedores pero no negociar títulos valores, o generar unos tipos de evento y otros no. Si le falta el permiso, la respuesta lo dice de forma explícita — nunca falla en silencio.
X-API-Key: ••••••••••••••••••••
Content-Type: application/json
Qué resuelve la API
Cuatro operaciones cubren el ciclo completo
Todo se consume igual: una llamada, una llave y una respuesta con el estado real ante la DIAN.
Registrar documentos de proveedores
Envíe el identificador del documento y nosotros lo traemos de la DIAN, lo validamos y lo dejamos disponible para conciliar contra su ERP.
Consultar la trazabilidad
Recupere todos los eventos generados sobre un documento, con su fecha y su resultado ante la DIAN, para cuadrar contra su propio registro.
Seguir un proceso en curso
Cuando algo tarda más de lo normal, la respuesta le entrega un identificador de seguimiento para consultar el avance sin repetir la operación.
Respuestas
Sin ambigüedad sobre qué pasó
Cada llamada devuelve un código que distingue con claridad entre un error suyo, un rechazo de la DIAN y un problema nuestro. Cuando la DIAN rechaza, la respuesta trae la regla exacta que falló, no un mensaje genérico.
Esa distinción es la que le permite a su equipo saber si tiene que corregir un dato, llamar a su proveedor o llamarnos a nosotros.
- 200
- Procesado y aceptado por la DIAN
- 202
- Encolado: use el identificador de seguimiento para consultar el avance
- 400
- Datos inválidos o falta un campo requerido
- 401
- Falta la llave, o es inválida o fue revocada
- 403
- La llave existe pero no tiene el permiso requerido
- 404
- El documento no está en la plataforma para esta empresa
- 422
- La DIAN rechazó la operación. La respuesta trae la regla que falló
- 502
- Un servicio del que dependemos, la DIAN entre ellos, no respondió
Ambiente de pruebas
Los mismos contratos que producción, con datos de prueba. Puede evaluar la integración completa antes de firmar.
Especificación OpenAPI
El esquema de cada petición y cada respuesta, con ejemplos por tipo de evento. Se genera del código, así que no se desactualiza.
Conectores a medida
Si su sistema no habla REST, construimos el conector. Ya lo hemos hecho para colas de mensajes, archivos planos y servicios SOAP.
Pida las credenciales y la documentación
Le entregamos una llave del ambiente de pruebas y la especificación completa. Puede evaluar la integración entera antes de firmar nada.