Integración

Cómo conectar tu ERP con el RNDC

SAP, Oracle, Dynamics o un ERP propio pueden reportar remesas y manifiestos al RNDC sin que nadie copie datos. Te explicamos las tres formas de hacerlo y qué dato del ERP va en cada campo.

Equipo de Cumplimiento RNDC de FassiltransActualizado: 1 de octubre de 2026

¿Qué significa conectar un ERP con el RNDC?

Conectar el ERP con el RNDC significa que los datos del pedido, el cliente, la mercancía y el vehículo salen de tu sistema y llegan al Ministerio sin que una persona los digite. El ERP ya tiene casi todo; falta traducirlo al formato que exige el RNDC.

Tu ERP ya guarda casi todo lo que el RNDC (Registro Nacional de Despachos de Carga) necesita: el número del pedido, el cliente con su NIT, la mercancía que se mueve, el peso y el origen y el destino del viaje. Cuando un transportador o un generador de carga crea un despacho en SAP, Oracle, Dynamics o un ERP propio, esos datos ya quedan registrados en alguna tabla del sistema.

El problema no es que falte información, sino que el RNDC exige ese mismo dato con otro nombre, otro formato o en otra unidad. El pedido de tu ERP tiene que convertirse en una remesa y, cuando corresponda, en un manifiesto, con sus campos exactos. Conectar el ERP con el RNDC es, en el fondo, un trabajo de traducción: tomar lo que ya existe en tu sistema y entregarlo en el formato que el Ministerio entiende, de forma automática y sin que nadie lo vuelva a escribir a mano.

Esa automatización tiene un beneficio directo: menos errores de digitación. Cuando una persona copia el peso, el NIT o la ciudad de destino desde el ERP hacia el portal del RNDC, siempre hay riesgo de equivocarse. Si el dato sale del ERP tal como está, el único trabajo que queda es traducirlo bien una vez, al construir la integración.

¿Cuáles son las tres formas de integrar un ERP con el RNDC?

Hay tres caminos: programar un cliente propio para el web service SOAP del Ministerio, exportar los datos del ERP y digitarlos en el portal o en una app web, o enviar JSON a una API intermedia. Cambian el tiempo de desarrollo, el mantenimiento y cuánto volumen aguantan.

Vía 1: construir un cliente SOAP propio

Tu equipo de TI programa la conexión directa al web service SOAP del RNDC: arma el mensaje XML, respeta el procesoid de cada documento y sostiene esa integración cuando el Ministerio cambia algo. Es la vía con más control, pero también la que más trabajo de desarrollo y mantenimiento pide. Hay que implementar cada documento (remesa, manifiesto, anulación) por separado, y cada vez que el Ministerio ajuste una regla, el ajuste cae sobre tu equipo.

Vía 2: exportar del ERP y digitar en el portal o en una app web

El ERP exporta o muestra los datos del pedido, y alguien los copia a mano en el portal del RNDC o en una app web como la de Fassiltrans. No hay que programar un cliente SOAP, pero el paso de digitar sigue siendo manual: una persona toma cada dato del ERP y lo vuelve a escribir en otra pantalla. Es semimanual, no una integración real.

Para pocos documentos al día puede ser suficiente. Con un volumen alto se vuelve un cuello de botella, porque el límite ya no lo pone el ERP ni el RNDC, sino cuántas personas hay disponibles para digitar. Si ese es tu caso, conviene revisar las formas de reportar al RNDC en volumen, incluyendo la integración SOAP propia y la API.

Vía 3: enviar JSON a una API intermedia

El ERP llama por HTTPS a una API como la API RNDC de Fassiltrans, con los datos en JSON. La API valida los campos, traduce el formato y reporta al RNDC por el web service. Tu equipo no toca SOAP ni XML, y el mantenimiento del lado del RNDC queda del lado del proveedor. Es la vía más rápida de poner en marcha cuando el ERP ya puede hacer una llamada HTTP, que es lo habitual en SAP, Oracle, Dynamics y la mayoría de los sistemas propios.

VíaPuesta en marchaMantenimientoVolumen
SOAP propioSemanas o mesesTu equipo de TIEl que construyas
Exportar y digitarInmediataManual en cada envíoLimitado por las personas que digitan
API intermediaDíasEl proveedorLotes por llamada

¿Qué dato del ERP va en cada campo de la remesa?

La mayoría de los campos de la remesa ya existen en tu ERP con otro nombre. El trabajo de la integración es mapearlos: decir qué columna del ERP alimenta cada campo del RNDC y en qué formato debe ir.

Antes de programar nada, conviene sentar el mapeo campo por campo: de dónde sale cada dato en el ERP y cómo debe llegar al RNDC. Esta tabla muestra un ejemplo simplificado de los cruces más comunes.

Dato del ERPCampo de la remesaOjo con
Fecha del pedidoFecha de carguedd/MM/yyyy
NIT del clienteRemitente / destinatarioDebe coincidir con el tercero registrado en el RNDC.
Código de productoCódigo de mercancía4 dígitos arancelarios (ej. 2523).
Ciudad de origen / destinoMunicipioCódigo DANE, no el nombre.
Peso del pedidoCantidadUnidad correcta (kg).
Ejemplo simplificado. La remesa intermunicipal completa tiene 44 campos.

¿Qué errores son los más comunes al integrar un ERP?

Los errores más comunes no son de programación sino de datos: fechas en otro formato, códigos de mercancía a 6 dígitos, municipios por nombre y terceros que no existen en el RNDC. Detectarlos antes de enviar ahorra rechazos.

  • Fechas en otro formato. El ERP suele guardar la fecha como yyyy-MM-dd. El RNDC solo acepta dd/MM/yyyy; si no la conviertes antes de enviar, rechaza el documento.
  • Código de mercancía a 6 dígitos. El ERP a veces maneja el código arancelario completo. El RNDC espera solo los primeros 4 dígitos; hay que recortarlo antes de mapearlo.
  • Municipio por nombre. El ERP guarda «Bogotá» o «Medellín». El RNDC pide el código DANE del municipio, no el nombre de la ciudad.
  • Terceros que no existen en el RNDC. Un cliente o proveedor puede estar en el ERP pero no estar registrado como tercero en el RNDC, y el documento se rechaza por ese dato.

La mayoría de estos errores se detectan antes de que lleguen al RNDC si la integración hace una validación previa. La API RNDC de Fassiltrans revisa el formato de cada campo y devuelve el error por campo, en lugar de un código genérico que hay que interpretar.

Lo importante es dónde se detecta el error. Si solo se descubre cuando el RNDC lo rechaza, el pedido ya se procesó en el ERP y alguien tiene que volver atrás a corregirlo. Validar antes de enviar evita ese retroceso y deja el dato correcto desde el origen.

¿Qué debe preparar tu equipo de TI antes de empezar?

Antes de escribir una línea de código, tu equipo necesita tres cosas: las credenciales del RNDC de la empresa, el mapeo de campos del ERP al RNDC y un ambiente de pruebas para no reportar documentos reales mientras desarrolla.

  1. Las credenciales del RNDC de la empresa.
  2. El mapeo de los campos del ERP a los campos del RNDC.
  3. El catálogo de terceros ya registrados en el RNDC.
  4. Los códigos DANE de los municipios que usa la operación.
  5. Un ambiente de pruebas para no reportar documentos reales mientras desarrolla.
  6. Un responsable que revise y resuelva los errores de validación.

Con la API RNDC de Fassiltrans, el sandbox y una skill para agentes de código como Claude Code, Codex o Cursor vienen incluidos con el acceso, así que tu equipo puede probar el mapeo y escribir la integración sin exponer datos reales desde el primer día.

Preguntas frecuentes

Sí, pero alguien tiene que construir la conexión. SAP no trae un conector para el RNDC: hay que programar el envío al web service SOAP del Ministerio o enviar los datos a una API intermedia que haga ese trabajo.

Conecta tu ERP al RNDC sin construir el SOAP

Agenda una llamada técnica de 30 minutos. Revisamos tu ERP, tu volumen y cómo darte acceso al sandbox.

Agenda una llamada técnica

Usamos cookies para analíticas y para recordar tus preferencias. Puedes aceptar o rechazar su uso.