Pedir las rutas por carrier de un lote de pedidos

Qué vas a lograr

Que TMS reparta entre tus transportistas los pedidos que enviaste para carrier y que siguen pendientes. Por cada transportista y servicio arma una ruta con sus pedidos, ya confirmada y sin vehículo propio. Tu sistema recibe en la respuesta las rutas que se crearon y los pedidos que no encontraron transportista.

Antes de empezar

• Tenés una credencial de integración activa de tu empresa. Cada solicitud de esta guía lleva su clave en el encabezado de API key.
• Ya enviaste los pedidos a rutear marcados para carrier. Entran solo los que están pendientes: los que TMS no pudo geocodificar quedan afuera.
• Tu empresa tiene reglas de carrier activas. Cada regla dice a qué transportista va un pedido, y con qué servicio, según la provincia, la localidad, el comienzo del código postal o un peso máximo.
• Hoy las reglas de carrier no se cargan ni se cambian desde la web ni por la API.

Paso a paso

1. Pedí la generación de rutas por carrier, con la fecha de salida en formato año-mes-día (por ejemplo, 2026-10-16). Si no mandás fecha, TMS usa la de hoy. Esa fecha queda como la salida de todas las rutas que se crean.
2. Esperá la respuesta. TMS toma todos los pedidos pendientes para carrier de tu empresa en ese momento: no se elige un lote de pedidos puntual.
3. Mirá cómo se eligió el transportista de cada pedido. TMS recorre las reglas activas por prioridad, de la menor a la mayor, y se queda con la primera que coincide. Una regla coincide cuando el pedido cumple todas sus condiciones; las mayúsculas y los espacios al principio o al final no cuentan.
4. Leé la lista de rutas creadas. Cada una trae su número de ruta, el transportista, el servicio y cuántos pedidos lleva. Los pedidos que van con el mismo transportista y el mismo servicio quedan en la misma ruta, una parada por pedido.
5. Leé la lista de pedidos sin regla. Viene con tu referencia de documento, o con el número de pedido de TMS si no la mandaste. Esos pedidos siguen pendientes.
6. Leé la lista de grupos salteados. Un grupo se saltea cuando otra generación, hecha al mismo tiempo, ya tomó alguno de sus pedidos. Ese grupo no se crea y los demás sí.
7. Levantá el evento de ruta confirmada de cada ruta creada. Trae las paradas con su dirección, los pedidos con tu referencia, el transportista, el servicio y la fecha. Lo leés con la lectura de eventos de ruta, o te llega al webhook si tu credencial tiene uno configurado.

Qué pasa después

• Los pedidos que entraron en una ruta pasan a estado Planificada. Desde ese momento ya no los podés cancelar por la API: la respuesta dice que la orden está en estado Planificada.
• Las rutas quedan planificadas y confirmadas, sin vehículo, y aparecen en la lista de Rutas de la web.
• Si volvés a pedir la generación, solo entran los pedidos que sigan pendientes. Los que ya tienen ruta no se repiten.
• Los pedidos que envíes después esperan a la próxima generación.

Si algo no sale

Lo que ves	Qué hacer
La respuesta dice "API key requerida"	Agregá la clave de la credencial a la solicitud.
La respuesta dice "API key inválida"	La clave no existe o la credencial está revocada. Usá una credencial activa.
La respuesta dice "fecha inválida (YYYY-MM-DD)"	Mandá la fecha como año de cuatro dígitos, mes y día de dos, separados por guiones, o no mandes fecha.
No se creó ninguna ruta y no hay pedidos sin regla	No había pedidos pendientes para carrier. Revisá que los enviaste marcados para carrier y que no volvieron con el aviso de que no se pudo geocodificar el destino.
Un pedido aparece entre los sin regla	Ninguna regla activa coincide. Un pedido sin provincia, localidad o código postal no coincide con una regla que pide ese dato. Hoy no podés cambiar las reglas; mientras tanto, el pedido sigue pendiente y entra en la próxima generación si alguna regla lo cubre.
Un grupo aparece entre los salteados	Otra generación tomó esos pedidos. Leé los eventos de ruta: la ruta que los tomó está ahí.

Más casos en Problemas frecuentes.