API RNDC para empresas
Conecta tu ERP al RNDC con una API REST
Reporta miles de remesas y manifiestos desde SAP, Oracle o tu software propio. Sin SOAP, sin XML y sin pelear con el web service del Ministerio.
Acceso por solicitud · Documentación técnica y sandbox incluidos
Para quién es
¿Para quién es la API RNDC?
La API es para empresas que ya tienen su propio software y reportan muchos despachos al RNDC: generadores de carga con ERP, transportadoras con TMS y equipos de TI que hoy mantienen una integración SOAP con el Ministerio.
Generadores de carga con ERP propio
Tu ERP ya tiene el pedido, el cliente y la mercancía. La API toma esos datos y los reporta al RNDC sin que nadie los copie a mano.
Transportadoras con TMS propio
Tu sistema despacha cientos de viajes. La API recibe remesas y manifiestos en lote y te devuelve el resultado de cada uno.
Equipos de TI que hoy mantienen el SOAP
Si sostienen una integración directa con el web service del Ministerio, pueden pasar a JSON y dejarnos los cambios del RNDC.
El problema
¿Por qué es difícil integrarse directo al RNDC?
El RNDC no tiene una API moderna. Su web service es SOAP con mensajes XML, reglas estrictas por documento y errores en códigos cortos. Construirlo es posible; mantenerlo cada vez que el Ministerio cambia algo es lo que consume a los equipos de TI.
- La remesa intermunicipal tiene 44 campos y todos deben ir en el XML, aunque estén vacíos.
- Las fechas solo se aceptan en formato dd/MM/yyyy. Con otro formato, el RNDC rechaza el documento.
- Cada documento usa un procesoid distinto (3 remesa, 83 remesa urbana, 4 manifiesto, 32 anulación) por el mismo endpoint SOAP.
- Los errores del Ministerio llegan como códigos cortos que tu equipo debe traducir y resolver.
- Cuando el Ministerio cambia algo, como la migración al RNDC2, la integración propia vuelve a ser trabajo de TI.
Si quieres ver el detalle técnico, lee nuestra guía del web service del RNDC.
Cómo funciona
¿Cómo funciona la API de Fassiltrans?
Tu sistema envía los documentos en JSON, Fassiltrans los valida y los traduce al formato SOAP del Ministerio, y el RNDC responde. Tú recibes el resultado de cada documento, y si usas webhooks te avisamos cuando algo cambia.
- 01
Tu sistema envía JSON
Tu ERP o TMS manda las remesas y manifiestos a la API por HTTPS, con tu llave de API. Uno por uno o en lotes.
- 02
Fassiltrans valida y traduce
Revisamos cada campo con las reglas del RNDC, convertimos fechas y códigos al formato del Ministerio y armamos el mensaje SOAP.
- 03
El RNDC responde y te avisamos
Recibes el resultado de cada documento: aceptado con su radicado o rechazado con un mensaje claro. Si usas webhooks, te avisamos solos.
Para tu equipo de TI
¿Cómo se ve una llamada a la API?
Así se ve un envío de dos remesas en un solo lote. La primera pasa la validación y sale al RNDC. La segunda trae el código de mercancía a 6 dígitos y la API la detiene antes del Ministerio, con un mensaje que tu equipo entiende.
POST /v1/remesas/bulk
Authorization: Bearer <tu_llave_de_api>
Content-Type: application/json
{
"remesas": [
{
"referencia_externa": "PED-2026-10421",
"fecha_cargue": "2026-10-01",
"origen_dane": "11001000",
"destino_dane": "76001000",
"mercancia_codigo": "2523",
"peso_kg": 32000,
"remitente_nit": "900123456",
"destinatario_nit": "800987654"
},
{
"referencia_externa": "PED-2026-10422",
"fecha_cargue": "2026-10-01",
"origen_dane": "11001000",
"destino_dane": "05001000",
"mercancia_codigo": "252310",
"peso_kg": 18000,
"remitente_nit": "900123456",
"destinatario_nit": "811456789"
}
]
}HTTP/1.1 207 Multi-Status
Content-Type: application/json
{
"resultados": [
{
"referencia_externa": "PED-2026-10421",
"estado": "enviada_al_rndc",
"id": "rem_8f3k2"
},
{
"referencia_externa": "PED-2026-10422",
"estado": "rechazada_por_validacion",
"errores": [
{
"campo": "mercancia_codigo",
"mensaje": "El código de mercancía va a 4 dígitos (ej. 2523). Recibimos 6."
}
]
}
]
}Capacidades
¿Qué incluye la API RNDC?
La API cubre el ciclo completo de reporte: envíos masivos de remesas y manifiestos, validación previa, webhooks, PDF oficiales, consultas de SICETAC, terceros y vehículos, un sandbox para pruebas y una skill para que los agentes de IA de tu equipo escriban la integración.
Envíos masivos
Cientos de remesas y manifiestos en una sola llamada, con el resultado de cada documento por separado.
Validación antes del RNDC
Revisamos formato, campos obligatorios y reglas del Ministerio antes de enviar. El error te llega claro, no como un código.
Webhooks
Tu sistema recibe un aviso cuando el RNDC acepta o rechaza un documento, o cuando se registra el cumplido.
PDF oficiales
Descarga el PDF de cada remesa y manifiesto para imprimir o enviar a tu cliente.
Ambiente de pruebas
Un sandbox para probar la integración completa sin reportar documentos reales al RNDC.
Consultas
Flete mínimo SICETAC, terceros y vehículos, en el mismo formato JSON.
Skill para agentes de IA
Una skill para Claude Code, Codex o Cursor: el asistente de tu equipo conoce la API, sus esquemas y sus errores, y escribe la integración contigo.
La decisión
¿API, integración SOAP propia o portal del Ministerio?
Las tres opciones llevan los documentos al RNDC. La diferencia está en cuánto trabajo pone tu equipo: construir y mantener el SOAP, digitar en el portal, o enviar JSON y dejar que Fassiltrans se encargue del resto.
| Construir tu SOAP | Portal del Ministerio | API Fassiltrans | |
|---|---|---|---|
| Puesta en marcha | Semanas o meses de desarrollo: cliente SOAP, XML y reglas por documento. | Inmediata, pero cada documento lo digita una persona. | Tu equipo envía JSON; la conexión al RNDC ya está hecha. |
| Volumen | Lo que tu equipo construya y mantenga. | Pensado para trabajo manual, no para miles de despachos. | Lotes de cientos de documentos por llamada. |
| Errores | Códigos del Ministerio que tu equipo debe interpretar. | Se corrigen a mano en pantalla. | Validación previa y mensajes claros por campo. |
| Cambios del Ministerio | Cada cambio es trabajo nuevo de TI. | Hay que aprender la pantalla nueva. | Los absorbemos nosotros; tu integración sigue igual. |
| Seguimiento | Consultas periódicas para saber el estado. | Revisar el portal. | Webhooks cuando algo cambia. |
Seguridad
¿Es segura la integración?
Cada empresa usa sus propias llaves de API, todo viaja por HTTPS, cada envío queda en un registro de auditoría y tus credenciales del RNDC se guardan cifradas. Nunca aparecen en respuestas de la API ni en registros.
Llaves por empresa
Cada empresa usa sus propias llaves de API.
Tráfico cifrado
Toda la comunicación viaja por HTTPS.
Auditoría
Cada envío queda registrado: quién, cuándo y qué respondió el RNDC.
Credenciales RNDC protegidas
Tu usuario y contraseña del RNDC se guardan cifrados y nunca salen en respuestas ni registros.
Preguntas frecuentes
- El RNDC del Ministerio de Transporte solo ofrece un web service SOAP con mensajes XML. Fassiltrans ofrece una API REST con JSON encima de ese servicio: tu sistema nos envía los datos, nosotros los validamos y los reportamos al RNDC, y te devolvemos el resultado.
- Sí. Los documentos se reportan a nombre de tu empresa, con tus credenciales del RNDC. Las guardamos cifradas y nunca aparecen en respuestas ni registros.
- La API acepta lotes de cientos de remesas o manifiestos y te devuelve el resultado de cada uno por separado. El tamaño de lote para tu operación lo definimos en la llamada técnica.
- El RNDC a veces no responde. En ese caso la API te lo dice con un estado claro y tus datos quedan guardados en Fassiltrans, listos para reenviar sin volver a armar el documento.
- Sí. Con el acceso recibes un sandbox para probar toda la integración sin reportar documentos reales al RNDC, junto con la documentación técnica.
- Sí. La API usa HTTP y JSON, así que se conecta desde cualquier ERP o TMS que pueda hacer una llamada HTTP: SAP, Oracle, Dynamics o un desarrollo propio. No es un conector oficial de ningún fabricante; tu equipo hace la llamada desde su sistema.
- Sí. Entregamos una skill para agentes de código como Claude Code, Codex o Cursor. El asistente de tu equipo conoce los endpoints, los esquemas y los errores de la API, y ayuda a escribir y probar la integración.
- Depende del volumen de documentos de tu operación. Lo revisamos contigo en una llamada técnica de 30 minutos y te enviamos una propuesta.
Guías
Sigue leyendo sobre integración con el RNDC
- Conectar tu ERP con el RNDCLas tres formas de integrar SAP, Oracle o Dynamics y qué dato va en cada campo.
- Reportar al RNDC de forma masivaPortal, integración SOAP propia o API: cuál sirve para tu volumen.
- API REST vs web service SOAPQué cambia para tu equipo de TI: formato, errores, reintentos y webhooks.
- Qué exigirle a un proveedor de integraciónDiez criterios para elegir sin quedar atado.
Conecta tu sistema al RNDC
Agenda una llamada técnica de 30 minutos con nuestro equipo. Revisamos tu ERP o TMS, tu volumen y los pasos para darte acceso al sandbox.
Agenda una llamada técnica