Consultar el calendario de salidas

Qué vas a lograr

Saber qué salidas troncales van a pasar por una tienda, cuándo cierra cada una y cuánto lugar le queda. Con eso tu sistema decide cuándo y cuánto liberar para esa tienda. Consultar el calendario no cambia nada en TMS.

Antes de empezar

• Tenés una credencial de integración activa de tu empresa. La solicitud lleva su clave en el encabezado de API key.
• La tienda existe en TMS con su código, el mismo con el que sincronizaste las ubicaciones.
• La tienda es parada de al menos una ruta troncal activa. Las rutas troncales las define el despachador en la web, con sus días y hora de salida, el corte, la capacidad, el umbral de overflow y el horizonte en días (ver definir una ruta troncal).
• TMS crea las salidas de cada ruta troncal activa una vez por hora, hasta el horizonte de esa ruta. Una salida que todavía no se creó no aparece en el calendario.

Paso a paso

1. Pedí el calendario con el código de la tienda como destino. Es el único dato obligatorio.
2. Si querés las salidas a partir de otro momento, agregá la fecha desde, en formato ISO (por ejemplo, 2026-10-20 o 2026-10-20T08:00:00). Sin ella, TMS usa el momento de la solicitud.
3. Si querés otra cantidad de salidas, mandá el límite. Por defecto son 20; TMS acepta entre 1 y 100.
4. Leé la respuesta. Trae el código de la tienda y la lista de salidas, de la más próxima a la más lejana.
5. Leé cada salida. Trae su número, la ruta troncal a la que pertenece (número y nombre), la fecha y hora de salida, la hora de corte, la capacidad en m³, lo ocupado, lo disponible y el umbral de overflow en porcentaje.
6. Calculá cuánto podés mandar con lo disponible. TMS lo calcula como la capacidad multiplicada por el umbral, menos lo ocupado, y nunca da menos de cero. Lo ocupado es el volumen de las transferencias que ya entraron en esa salida.

Ejemplo

Una salida de 40 m³ con umbral de 90 % y 30 m³ ocupados tiene 6 m³ disponibles.

Qué pasa después

• Consultar no reserva lugar. Cuando enviás pedidos de transferencia para la tienda, TMS los asigna a la próxima salida que todavía no pasó el corte, y lo disponible baja.
• Si una transferencia no entra en lo disponible, igual queda en esa salida, en overflow. No suma a lo ocupado del calendario y el despachador decide en la web qué hacer con ella.
• Al pasar la hora de corte, en los minutos siguientes TMS confirma la salida, o la cancela si quedó vacía. En los dos casos deja de aparecer en el calendario.
• La salida confirmada te llega como evento de ruta confirmada, por la lectura de eventos o por webhook.

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 "destino (site_code) requerido"	Falta el código de la tienda. Agregalo como destino.
La respuesta dice "Tienda … no encontrada"	En tu empresa no hay una ubicación con ese código. Revisá el código o sincronizá las ubicaciones.
La respuesta dice "desde inválido (ISO)"	Mandá la fecha desde en formato ISO, o no la mandes.
La lista de salidas viene vacía	La tienda no es parada de una ruta troncal activa, las salidas de esas fechas todavía no se crearon por el horizonte, o ya pasaron el corte. Consultá con el despachador.
Lo disponible es cero	La salida llegó a su umbral. Lo que mandes ahora para esa tienda queda en overflow de esa salida. Si podés esperar, mandalo después de su hora de corte: entra en la salida siguiente.

Más casos en Problemas frecuentes.