API, EDI o tarifario: cómo integrar a tus transportistas

Los tres métodos se presentan casi siempre como una escalera: la API arriba, el EDI aceptable y la hoja de cálculo abajo. Ese relato es falso y le cuesta dinero al comisionista de transporte, porque los tres no hacen el mismo trabajo. Lo que los separa es qué viaja y quién tiene que construir algo.

Lee otra vez la tercera columna. Con API o EDI, el transportista tiene que haber invertido antes en la conexión para que tú puedas usarla: tu lista de transportistas queda limitada por el presupuesto informático de otras empresas. Con un tarifario, el PDF o el Excel que ya está en tu bandeja de entrada es la superficie de integración, y el trabajo lo planificas tú.

Tampoco son excluyentes, y lo normal es un despacho que usa los tres a la vez: API en las dos redes de paquetería, EDI con el único cargador que lo exige y tarifarios para todo lo demás. Lo que decide el orden es la cobertura. Empezar por la API deja parte del panel sin poder cotizar durante todo el tiempo que tarde el primer conector; empezar por el tarifario deja el panel entero cotizable y después añades conectores donde el volumen los justifique.

Cargavo, TMS para comisionistas de transporte, transitarios y agentes de carga con equipos de 2 a 25 personas, solo implementa el tercer método. Es una decisión de alcance, no un olvido, y el resto de esta guía explica el razonamiento sin adornos, incluidos los casos en que la respuesta correcta es otra. Para el contexto completo del alta, mira la categoría de alta de transportistas y el pilar sobre integración de transportistas para comisionistas.

Los proveedores dicen «nos integramos con transportistas» como si un transportista tuviera una sola puerta. En la práctica hablas con servicios distintos, y un transportista puede ofrecer uno sin los otros:

• Tarificación: envías origen, destino y expedición, y recibes un precio. Es la única que importa para la cotización de fletes.
• Reserva y documentación: envías una expedición confirmada y recibes número de envío, etiqueta y CMR.
• Seguimiento: consultas una referencia y recibes un estado y el justificante de entrega.

Las redes de paquetería y exprés tarifican por número de cuenta, peso y dimensiones, y ahí el endpoint de tarificación es genuinamente útil porque el precio sí puede cambiar de un envío a otro. El grupaje paletizado, la carga consolidada y la carga completa son otra cosa: tu precio es una tarifa negociada para el año y, en la mayoría de los casos, la oficina del transportista la guarda como una tabla específica de tu cuenta, la misma que te mandó por correo en enero. La llamada de tarificación, cuando existe, te devuelve esa tabla guardada. Estás pagando una integración para que te digan un número que ya tienes.

Hay tres costes operativos que casi nadie calcula. Versionado: cuando el transportista publica la v3 y retira la v2, el plazo lo pone él, no tú. Latencia: una comparación multitransportista va tan rápido como el endpoint más lento, así que necesitas tiempos de espera y un precio de reserva, es decir, necesitas igualmente una tarifa guardada. Opacidad: una API responde una expedición cada vez, así que no puedes barrerla para comprobar que todos los tramos de 100 kg a 3.000 kg de una ruta tienen sentido. Un tarifario guardado se puede auditar; un endpoint es una caja negra que solo se interroga llamada a llamada.

Nada de esto convierte las API en algo malo. Las convierte en la herramienta de los flujos donde el precio es de verdad dinámico, que en un comisionista de transporte que trabaja con tarifas contratadas es la minoría del panel. Amplía en cotizar con transportistas regionales que no tienen API.

Este es el punto peor entendido de toda la integración de transportistas, así que conviene decirlo sin matices: el EDI va después del precio, no es una fuente de precio. Basta mirar qué transporta cada mensaje estándar.

Un 204 o un IFTMIN pueden llevar una tarifa, pero es una tarifa que tú decidiste antes de enviar el mensaje. Un 210 o un INVOIC te dicen lo que el transportista facturó, lo cual sirve para conciliar y no sirve para cotizar, porque llega semanas después de que te comprometieras con un precio de venta. No existe un equivalente EDI de la pregunta «¿cuánto costaría esta expedición?».

Lo segundo que hay que saber es que el EDI es un proyecto por socio. Cada conexión necesita un acuerdo de transporte (certificados AS2, un buzón SFTP o una VAN), un mapeo segmento a segmento de tus datos sobre su guía de implementación, un ciclo de pruebas en el que ambas partes certifican mensajes de muestra, y una persona con nombre y apellidos a cada lado para cuando un mapeo se rompa. Dos transportistas que usan el mismo estándar tendrán calificadores distintos, segmentos de referencia distintos y campos obligatorios distintos.

Donde el EDI sí justifica su coste es un flujo contractual de alto volumen que se repite todos los días con el mismo socio y, muy a menudo, quien lo exige es tu cliente, no tu transportista. Un gran cargador que impone mensajes 204 y 214 te está imponiendo el EDI como proveedor suyo. Es un requisito real y no tiene nada que ver con cómo fijas precios: seguirás necesitando una tarifa en algún sitio para saber qué cobrar. Ese trabajo se explica en la gestión del tarifario de transportistas.

La objeción de la frescura suena definitiva hasta que preguntas con qué frecuencia se mueve realmente el número de debajo. Un contrato de grupaje o de carga parcial declara un periodo de validez y, dentro de ese periodo, el transportista queda vinculado. Cotizar desde un tarifario en vigor es cotizar el contrato, que es exactamente lo que el transportista va a facturar.

Lo que sí se mueve cada mes es el recargo por combustible, y es indexado, no negociado. Un ejemplo completo sobre una ruta.

Tarifa válida del 1 de enero de 2026 al 31 de diciembre de 2026. Tipo de tarifario weight_zone, zona 2, tramo de 1.000 a 1.999 kg a 14,80 € por 100 kg. Expedición: 1.240 kg.

• Precio de compra base: 12,40 × 14,80 € = 183,52 €. El motor prueba además el suelo del tramo siguiente, 2.000 kg a 12,30 € por 100 kg = 246,00 €, que es peor, así que se mantienen los 183,52 €.
• Recargo por combustible de febrero: índice de 1,61 € por litro frente a una base de 1,40 €, con el gasóleo ponderado al 30 % de la estructura de coste. (1,61 − 1,40) ÷ 1,40 × 0,30 = 4,5 %. El precio de compra pasa a 191,78 €.
• Precio de venta con un 18 % de margen aplicando p/(1−m): 191,78 € ÷ 0,82 = 233,88 €. Margen obtenido: 42,10 €.
• Marzo: el índice sube a 1,68 €. (1,68 − 1,40) ÷ 1,40 × 0,30 = 6,0 %. Compra 194,53 €, venta 194,53 € ÷ 0,82 = 237,23 €.

Entre febrero y marzo el precio de venta se movió 3,35 €. El tarifario no cambió, no hubo integración de por medio y lo único que cambió fue una cifra de índice publicada. Puedes reproducir la cuenta con la calculadora de recargo por combustible. Esa es la forma honesta de la frescura tarifaria en transporte terrestre contratado: una tabla estable más un coeficiente indexado.

El riesgo real de desactualización no es técnico sino administrativo: cotizar con una tarifa cuya fecha de validez ya pasó porque nadie registró la nueva. Ese problema tampoco lo resuelve una API, y por eso las fechas de validez son obligatorias en cada tarifario. El checklist de alta de transportistas detalla qué capturar al cargarlo, y los cuatro tipos de tarifario explican qué forma tiene el tuyo.

La cobertura es el argumento que zanja la discusión en un despacho pequeño, y se ve mejor con un ejemplo construido. Toma un panel de 14 transportistas del tipo que maneja un comisionista de transporte terrestre mediano y pregunta qué puede ofrecer cada uno.

Es un panel ilustrativo, no una estadística de mercado, pero reconstrúyelo con tu propia lista y la forma no te sorprenderá. Las columnas que importan son la primera y la última: una estrategia que empieza por la API deja 2 transportistas cotizables enseguida y 12 rutas calculadas a mano durante meses, mientras que una estrategia que empieza por el tarifario deja los 14 cotizables en el orden en que tú decidas hacer el trabajo.

El reparto no es casual. Una API de tarificación merece la pena para un transportista cuyo precio varía por envío entre miles de cuentas. Un transportista regional de 25 camiones tiene jefes de tráfico, no desarrolladores, vende una tarifa anual que no se mueve durante el día y estaría gastando dinero en publicar números que ya te ha mandado por correo. No la va a construir nunca, y hace bien.

También importa comercialmente, porque la cola larga suele ser donde está el margen: el transportista regional más barato en su propia ruta lo cotizan menos competidores que la red nacional a la que llega todo el mundo. Cargavo, TMS para comisionistas de transporte y agentes de carga, trata esa cola larga como el caso por defecto y no como la excepción; mira cómo comparar varios transportistas en la misma ruta.

Los límites, dichos claramente, para que puedas descartarnos si te descalifican. Cargavo no tiene conectividad API con transportistas ni conectividad EDI. Tampoco es una bolsa de cargas, ni un sistema de gestión de flota o de asignación de conductores, ni un mercado de licitaciones, ni un programa de contabilidad o facturación.

Lo que eso te cuesta: nada de tarificación de paquetería que varíe por horas, nada de seguimiento automático extraído de los sistemas del transportista, nada de volcar una carga en el TMS del transportista de forma automática y nada de conciliación de facturas por EDI. Si ese es tu cuello de botella diario, la compra correcta es una plataforma centrada en conectividad y este es el producto equivocado.

Lo que obtienes a cambio es que todos los transportistas de tu lista se pueden cotizar con las mismas reglas desde el primer día. Un transportista se da de alta introduciendo su Excel o CSV existente como uno de cuatro modelos de tarifario: weight_zone (zonas × tramos de peso), pallet (precio por número de palets o pallets × zona), mpl_bracket (tramos de metro lineal de carga × zona) y hybrid_weight (importe fijo por debajo de un umbral y tarifa unitaria por encima). Un único motor lee los cuatro, calcula el peso facturable y produce el precio de compra y el de venta: compra sin márgenes, venta con ellos, aplicados en el servidor por cliente, por tarifario o por tramo, en porcentaje con p/(1−m) o como importe absoluto.

De ahí salen dos consecuencias que la conectividad no te da. Primera: el cliente nunca ve un precio de compra ni un margen, porque viven en el servidor y no se envían al portal. Segunda: una cotización aceptada (Q-YYYY-NNNN) se convierte en una expedición seguida (S-YYYY-NNNN) como un único expediente continuo, en español, inglés, francés o alemán, y en EUR, USD, GBP, CHF, CAD, MAD o PLN a partir del plan Growth.

La carga de tarifarios está incluida en todos los planes: Starter 49 €/mes, Growth 149 €/mes, Scale 399 €/mes, con facturación anual equivalente a unos dos meses gratis, 14 días de prueba gratis y sin tarjeta de crédito. Los límites completos están en la página de precios; el procedimiento práctico, en dar de alta a un transportista sin API.

Las decisiones de integración se toman por intuición y se defienden con adjetivos. Haz la división. Supongamos que un conector de tarificación para un transportista te cuesta 4.000 € de tiempo de desarrollo más el mantenimiento, y que te permite ganar un tráfico que hoy rechazas, con el margen de 42,10 € por expedición calculado antes. El umbral de amortización es 4.000 € ÷ 42,10 € ≈ 95 expediciones. A 2 expediciones por semana, son unas 48 semanas hasta que el conector se paga solo, y el reloj del mantenimiento no se para nunca.

Haz la misma división para un conector que ahorra tiempo en lugar de generar ingresos, y sé honesto con el dato de entrada: el ahorro son los minutos que quitas de un trabajo que haces hoy de verdad, no el máximo teórico.

Hay cuatro situaciones que sí justifican el proyecto:

• Volumen de paquetería y exprés, donde el precio varía legítimamente por envío según dimensiones y cuenta, y una tarifa guardada no puede reproducirlo.
• Una exigencia del cliente: un gran cargador que impone mensajes 204 y 214, o sus equivalentes EDIFACT, como condición del contrato. No es negociable y no tiene relación con cómo calculas precios.
• Un transportista dominante que mueve una parte grande de tus expediciones diarias, donde el envío automático de órdenes y los estados eliminan una jornada real de trabajo a la semana.
• Conciliación de facturas a volumen, cuando cuadrar a mano cientos de facturas mensuales contra los precios de compra esperados se ha convertido en un puesto de trabajo.

Lo que no lo justifica: creer que una API devuelve un precio más fresco que tu contrato, o un pliego de compra que puntúa el «número de integraciones» en vez de «qué parte de tu panel puedes cotizar hoy». Un comisionista que empieza por los tarifarios cubre el panel entero primero y puede añadir después un conector allí donde se cumpla uno de los cuatro casos. Empezar por la API deja la mayor parte del panel sin cotizar mientras se construye el primero.

El orden es todo el argumento: cubre el panel y después optimiza los flujos que lo sostienen. El siguiente paso práctico está en el checklist de alta de transportistas.