Introducción
API Endpoint
https://apirest.logictracker.com/
Nuestra API proporciona acceso programático para obtener el HISTORIAL de estado de ORDENES por medio de su tracking number.
ORDERS GET HISTORY
# Ejemplo Request HTTP
POST /api/Orders/GetHistory HTTP/1.1
Host: apirest.logictracker.com
Content-Type: application/json
{
"OrderTrackingNumber": "2483017.2157136.43322"
}
# Ejemplo Request CURL
curl --location --request POST 'https://apirest.logictracker.com/api/Orders/GetHistory' \
--header 'Content-Type: application/json' \
--data-raw '{
"OrderTrackingNumber": "2483017.2157136.43322"
}
'
Para obtener informacion de un tracking number, debe realizar una llamada POST a la siguiente URL:
https://apirest.logictracker.com/api/Orders/GetHistory
# Ejemplo API Respuesta
{
"latitudCamion": 0.0,
"longitudCamion": 0.0,
"fechaHoraPosicion": null,
"estadoJob": "VIAJE CERRADO",
"distanciaJob": 0.0,
"etaJob": null,
"descripcionCliente": "La salvia Carlos Alberto (E6177-99)",
"descripcionTransportista": "Na",
"descripcionChofer": "Na",
"calificacion": null,
"programadoJob": "02/10/2020 15:24 hs",
"camionDescripcion": "AE055YG (AE055YG)",
"telefonoChofer": "Na",
"empresa": "Grupo OL",
"puntoOrigen": {
"clientName": "Royal Canin",
"code": "RY",
"location": {
"code": "RY",
"description": "Royal Canin",
"latitude": -34.6263351,
"longitude": -58.8167839
}
},
"puntoDestino": {
"clientName": "La salvia Carlos Alberto",
"code": "E6177-99",
"location": {
"code": "E6177-99",
"description": "La salvia Carlos Alberto",
"latitude": -34.6728134,
"longitude": -58.7035179
}
},
"trackingNumber": "2483017.2157136.43322",
"orderCode": "E6177-99",
"urlLogoEmpresa": null,
"permiteCalificar": true,
"genericReponse": {
"codigo": 200,
"mensaje": "OK",
"id": 0
}
}
REQUEST BODY PARAMETERS
| Nombre |
Tipo |
Obligatorio |
Descripción |
| orderTrackingNumber |
String |
SI |
Tracking number provisto por Logictracker para hacer el segumiento. |
RESPONSE PARAMETERS
| Nombre |
Tipo |
Descripción |
| latitudCamion |
Float |
Latitud de la ubicación del camión que esta realizando la entrega. |
| longitudCamion |
Float |
Longitud de la ubicación del camión que esta realizando la entrega. |
| fechaHoraPosicion |
String |
Fecha y hora de la posición del camion que esta realizando la entrega. |
| estadoJob |
String |
Estado de la entrega. |
| distanciaJob |
String |
Distancia en KM entre la ubicación de la entrega y el camión. |
| etaJob |
String |
Tiempo aproximado de viaje entre la ubicación del camión y la ubicación de la entrega. |
| descripcionCliente |
String |
Descripción del cliente de la entrega. |
| descripcionTransportista |
String |
Descripción del transportista que esta realizando la entrega. (Na si no tiene transportista asignado). |
| descripcionChofer |
String |
Descripción del chofer que esta realizando la entrega. (Na si no tiene chofer asignado). |
| calificacion |
Calificacion |
Objeto que indica la calificación realizada por el cliente. |
| programadoJob |
String |
Fecha y hora programada para la entrega. |
| camionDescripcion |
String |
Descripción del camión que esta realizando la entrega. |
| telefonoChofer |
String |
Teléfono del chofer que está realizando la entrega (Na si el chofer no tiene teléfono asignado). |
| empresa |
String |
Nombre de la empresa que está gestionando la ruta. |
| puntoOrigen |
Puntos |
Objeto que indica el punto de origen de la ruta. |
| puntoDestino |
Puntos |
Objeto que indica el punto de destino de la ruta. |
| genericReponse |
GenericResponse |
Objeto que indica una respuesta generica de la API. |
| trackingNumber |
String |
Tracking number consultado. |
| orderCode |
String |
Código de la orden consultada. |
| urlLogoEmpresa |
String |
Link donde se encuentra el LOGO de la empresa que esta gestionando el viaje. |
GENERIC RESPONSE PARAMETERS
| Nombre |
Tipo |
Descripción |
| codigo |
Int |
Código respuesta de la API. |
| mensaje |
String |
Mensaje que describe la respuesta de la API. |
| id |
Int |
En caso de generar el alta de una entidad, la API puede devolver el ID de la entidad creada. |
PUNTOS PARAMETERS
| Nombre |
Tipo |
Descripción |
| clientName |
String |
Nombre del punto. |
| code |
String |
Código del punto. |
| location |
Location |
Objeto que indica la ubicación del punto. |
LOCATION PARAMETERS
| Nombre |
Tipo |
Descripción |
| code |
String |
Código de la ubicación del punto. |
| description |
String |
Descripción de la ubicación del punto. |
| latitude |
Float |
Latitud la ubicación del punto. |
| longitude |
Float |
Longitud la ubicación del punto. |
CALIFICACION PARAMETERS
| Nombre |
Tipo |
Descripción |
| puntaje |
Float |
Puntaje calificado por el cliente basándose en el servicio recibido. (de 1 (puntaje menor) a 5 (puntaje máximo)) |
| comentario |
String |
Comentario realizado por el cliente. |
Errors
La llama a la API de Orders/GetHistory puede devolver los siguientes códigos de error dentro del objeto GenericResponse
| Código |
Mensaje |
| 200 |
OK
|
| 400 |
Formato de order tracking number incorrecto.
|
| 401 |
Los ids provistos no pueden ser utilizados.
|
| 402 |
No existe distrito o no tiene habilitada api historial.estado.ordenes.
|
| 403 |
No existe orden / entrega.
|
| 404 |
Vehículo sin posición.
|
| 405 |
Error al calcular tiempo y distancia a la entrega.
|
| 500 |
Excepcion en api/Orders/GetHistory. Entre en contacto con el area de sistemas de LOGICTRACKER y envie el CONTENIDO DEL REQUEST para ser analizado.
|