Introducción
API Endpoint
https://apirest.logictracker.com/
La API de LOGICTRACKER proporciona acceso programático para leer y actualizar datos de sus principales entidades de negocio.
Para utilizar nuestra API, el cliente necesitará 2 datos fundamentales: IdEmpresa y HashApi . Contáctenos en soporte@logictracker.com para obtener sus credenciales y comenzar a utilizar nuestra API.
Get Routes
# Ejemplo Request HTTP
POST /api/delivery/status HTTP/1.1
Host: apirest.logictracker.com
Content-Type: application/json
{
"IdEmpresa": TU_ID_EMPRESA,
"HashApi": "TU_HASH_API",
"FechaDesde": "28/07/2023 00:00:00",
"FechaHasta": "28/07/2023 23:59:00",
"RouteCode": "20230726|1",
"ShipmentCode": "ABC123"
}
# Ejemplo Request CURL
curl --location --request POST 'https://apirest.logictracker.com/api/delivery/status' \
--header 'Content-Type: application/json' \
--data-raw '{
"IdEmpresa": TU_ID_EMPRESA,
"HashApi": "TU_HASH_API",
"FechaDesde": "28/07/2023 00:00:00",
"FechaHasta": "28/07/2023 23:59:00",
"RouteCode": "20230726|1",
"ShipmentCode": "ABC123"
}'
Para obtener las estados de las rutas del dia, debe realizar una llamada POST a la siguiente URL:
https://apirest.logictracker.com/api/delivery/status
# Ejemplo API Respuesta
{
"response": {
"codigo": 200,
"mensaje": "OK",
"id": 0
},
"routes": [
{
"routeCode": "20200825-AST124-87864",
"status": 9,
"statusDescription": "VIAJE_STATE_CERRADO",
"deliveries": [
{
"deliveryCode": "7797010018",
"vehicleCode": "ABC123 - CO",
"employeeCode": "JUAN CARLOS",
"dateIn": "",
"dateOut": "07/02 15:37",
"dateManual": "",
"status": "Visitado",
"trackingNumber": "3736238.156213",
"choferDescripcion": "(123545) JUAN CARLOS",
"telefonoChofer": "",
"internoVehiculo": "155263-ABC123",
"transportista": "LT-TRANS",
"shipments": [
{
"ShipmentCode": "200",
"Date":"7/2/2024 13:58:00",
"comment": null,
"StateId": null,
"StateDescription": null,
"supplies": [
{
"SuppliesCode": "G",
"SuppliesDescription": "Generico",
"Comment": null,
"Quantity": 1
}
]
}
]
}
]
}
]
}
REQUEST BODY PARAMETERS
| Nombre |
Tipo |
Descripción |
| IdEmpresa |
Int |
Será un ID único provisto por Logictracker para el cliente que consulta la API. |
| HashApi |
String |
Será un HASH único provisto por Logictracker para el cliente que consulta la API. |
| FechaDesde |
String |
Será un HASH único provisto por Logictracker para el cliente que consulta la API. |
| FechaHasta |
String |
Será un HASH único provisto por Logictracker para el cliente que consulta la API. |
| RouteCode |
String (OPCIONAL) |
Código de la ruta que quiero buscar para el día indicado. |
| ShipmentCode |
String (OPCIONAL) |
Código de la entrega que quiero buscar para el día indicado. |
RESPONSE PARAMETERS
| Nombre |
Tipo |
Descripción |
| response |
GenericResponse |
Objeto que indica una respuesta generica de la API. |
| routes |
List<RoutesDeliveryStatus> |
Lista de rutas del dia. |
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. |
ROUTE DELIVERY STATUS PARAMETERS
| Nombre |
Tipo |
Descripción |
| RouteCode |
String |
Código de identificación de la ruta. |
| Status |
Int |
Código de identificación del estado de la ruta. |
| StatusDescription |
String |
Descripcion del estado de la ruta. |
| Deliveries |
List<DeliveryStatus> |
Lista de estados de los clientes que se tienen que visitar en la ruta. |
DELIVERY STATUS API PARAMETERS
| Nombre |
Tipo |
Descripción |
| DeliveryCode |
String |
Código de la entrega. |
| VehicleCode |
String |
Identificación del vehículo. |
| EmployeeCode |
String |
Identificación del chofer. |
| DateIn |
String |
Día y hora en que el vehículo ingreso al cliente. |
| DateOut |
String |
Día y hora en que el vehículo salió del cliente. |
| DateManual |
String |
Día y hora en que el chofer gestionó la entrega desde el celular. |
| Status |
String |
Estado del cliente. |
| TrackingNumber |
String |
Tracking number del cliente. |
| ChoferDescripcion |
String |
Identificación del chofer. |
| TelefonoChofer |
String |
Número de teléfono del chofer. |
| InternoVehiculo |
String |
Interno del vehículo. |
| Transportista |
String |
Transportista al que pertenece el vehículo. |
| StateId |
Int |
Id del estado de la entrega |
| StateDescription |
String |
Descripcion del estado de la entrega. |
| Shipments |
Shipment |
Detalle de los remitos del cliente. |
SHIPMENT PARAMETERS
| Nombre |
Tipo |
Descripción |
| ShipmentCode |
String |
Código del remito. |
| Date |
String |
Fecha del remito. |
| comment |
String |
Comentario del remito. |
| StateId |
Int |
Id del estado del remito. |
| StateDescription |
String |
Descripcion del estado del remito. |
| supplies |
List<Supplie> |
Listado de productos del remito. |
SUPPLIE PARAMETERS
| Nombre |
Tipo |
Descripción |
| SuppliesCode |
String |
Código del producto. |
| SuppliesDescription |
String |
Descripción del producto. |
| Comment |
String |
Comentario del producto. |
| Quantity |
Int |
Cantidad de productos. |
Errors
La llama a la API de delivery/status puede devolver los siguientes códigos de error dentro del objeto GenericResponse
| Código |
Mensaje |
| 200 |
OK
|
| 400 |
Request sin contenido en body, body request null.
|
| 401 |
Empresa no habilitada para consultar delivery status. Solicitar habilitación uso de API a LOGICTRACKER.
|
| 500 |
Excepcion en api/delivery/status. Entre en contacto con el area de sistemas de LOGICTRACKER y envie el CONTENIDO DEL REQUEST para ser analizado.
|
