Las órdenes se cargan usando la API de LastMile con el método de creación de guías. Esta información luego viaja mediante API interna hacia Ondemand.
URL de la API
https://codigodeactivación.dispatchtrack.com/api/external/v1/dispatches, recuerda añadir el código de activación de tu cuenta.
Código de activación: es el código que nos permite validar tu cuenta, todas las cuentas tienen un código otorgado. En caso de no conocer tu código de activación, escríbenos a través del correo soporte@dispatchtrack.com.
Parámetros del Payload
El payload debe contener los siguientes parámetros:
"mode": 3
-Es el número que corresponde al modo "pickup and drop". Estas son órdenes cuya recogida y entrega se realizará dentro de la misma ruta. Solo se utiliza en Ondemand.
"min_delivery_time":
-Fecha y hora mínima para la entrega. Debe corresponder al día en el que se quieren asignar las órdenes.
"max_delivery_time":
-Fecha y hora máxima para la entrega. Debe corresponder al día en el que se quieren asignar las órdenes.
"latitude":
-Latitud de la dirección de entrega.
"longitude":
-Longitud de la dirección de entrega.
"place":
-Nombre del Centro de despacho (tienda) al que corresponde la guía. Es indispensable enviarlo para ocupar el modo de asignación automático.
"pickup_address":
-Objeto JSON que contiene los siguientes parámetros:
"name": String con la dirección de recogida.
"latitude": Latitud del punto de recogida.
"longitude": Longitud del punto de recogida.
Ejemplo:
{
"identifier": "3456768789-0",
"contact_name": "Margarita Lopez",
"min_delivery_time": "2024-07-18 11:07:00-0400",
"max_delivery_time": "2024-07-18 14:17:00-0400",
"contact_address": "Vicuña Mackenna 5000, Macul, CHILE",
"latitude": -33.5010048,
"longitude": -70.6178255,
"contact_phone": "34543534",
"contact_id": "173945062",
"contact_email": "nombre.apellido@gmail.com",
"place": "Servicio Express",
"mode": 3,
"pickup_address": {
"name": "Apoquindo 5550, las condes, chile",
"latitude": -33.4099304,
"longitude": -70.5765329
},
"items": [
{
"code": "SKU123",
"description": "LED Monitor",
"quantity": 1
},
{
"code": "SKU124",
"description": "Monitor",
"quantity": 3
}
]
}
Información Importante:
Modo de Operación de Ondemand:
Ondemand solo trabaja con guías de recogida en modo 3 (pick up and delivery) o guías de recogida inmediata. La recogida y entrega se gestionan dentro de la misma ruta con el mismo número de orden, sin necesidad de cargar la guía dos veces.
Envío de Órdenes:
Las órdenes deben enviarse exclusivamente mediante integración.
Las guías deben ser creadas usando el método proporcionado en API Dispatch.
Las órdenes viajan internamente desde LastMile a Ondemand a través de la API.
Creación y Edición de Órdenes:
No se pueden crear o editar órdenes desde Ondemand. Esto debe hacerse en LastMile, ya sea mediante la web o la API.
Llave API:
Necesitas una llave API creada en LastMile. Esta llave permite a Ondemand conectarse con Dispatchtrack para crear la ruta.
Las rutas se crean en LastMile usando el endpoint de creación de rutas de la API externa.
La vinculación de la llave API es realizada por Dispatchtrack. Para ello, contacta a soporte en soporte@dispatchtrack.com.
Portal de API:
Para más detalles sobre el uso de la API, visita el siguiente portal: Dispatchtrack API Docs.
Pregunta Frecuente
¿Qué hacer si cargo una guía o pedido dos veces en el sistema?
Debes gestionar solo una de ellas. El otro pedido debe dejarse como pendiente.