Tracking

Actualización del estado del pedido y de las coordenadas de entrega

Actualizar el estado del pedido

Para cambiar el estado del pedido, debe realizar una solicitud a la API utilizando el método POST al siguiente endpoint:

https://api.maplink.global/tracking/v1/orders/{{trackingId}}/status

Donde el término {{trackingId}} debe ser sustituido por el ID de la orden a actualizar.

A continuación se muestra un ejemplo de solicitud:

{
    "value": "ON_THE_WAY",
    "label": "Em trânsito"
}

Dónde:

  • value – Valores
    posibles: ["PREPARING", "ON_THE_WAY", "DONE", "NOT_DONE", "CANCELLED"].
  • label – Texto personalizado que se mostrará en la página de seguimiento.

Actualización de las coordenadas del mensajero

Para actualizar las coordenadas, debe realizar una solicitud a la API utilizando el método POST al siguiente endpoint:

https://api.maplink.global/tracking/v1/orders/{{trackingId}}/driver

Donde el término {{trackingId}} debe ser sustituido por el ID de la orden a actualizar.

Las coordenadas de la página de seguimiento se actualizan cada 15 segundos.

Las actualizaciones enviadas en menos de 15 segundos no se reflejarán en la página de seguimiento.

A continuación se muestra un ejemplo de solicitud:

{
    "name": "Maplink BR",
    "image": "https://example.com",
    "currentLocation": {
        "lat": -22.72725697031394,
        "lon": -47.636846753567944
    }
}

Dónde:

  • name – (Opcional) Nombre del conductor
  • image – (Opcional) URL de la foto del conductor que se mostrará en el sitio web
  • currentLocation – Objeto con las coordenadas actuales del conductor.
    • lat – Coordenada de latitud en grados decimales.
    • lon – Coordenada de longitud en grados decimales.