Introducción

API Endpoint

La API de Logictracker proporciona acceso programático para gestionar y actualizar datos relacionados con las rutas, específicamente para CREAR NUEVAS RUTAS.

Para utilizar la API, el cliente debe contar con dos credenciales fundamentales: IdEmpresa y HashApi. Si aún no las posee, por favor contacte a nuestro soporte técnico en soporte@logictracker.com para obtenerlas y comenzar a integrar la API.

Crear Ruta

# Ejemplo de Solicitud HTTP
POST /api/Routes/Create HTTP/1.1
Host: apirest.logictracker.com
Content-Type: application/json

{
    "IdEmpresa": "TU_ID_EMPRESA",
    "HashApi": "TU_HASH_API",
    "Codigo": "20200910O144800",
    "Patente": "AB123CD",
    "CodigoTransportista": "122471",
    "LegajoChofer": "LEGAJO_CHOFER",
    "FechaHora": "10/09/2024 14:48:03",
    "Entregas": [
        {
            "CodigoPuntoEntrega": "4008",
            "FechaProgramada": "10/09/2024 15:50:00",
            "Remitos": [
                {
                    "Codigo": "3006868",
                    "Productos": [
                        {
                            "Code": "337",
                            "Description": "LA CBSA.OLEO CÑL X 20 KG",
                            "Comment": "No golpear",
                            "Quantity": 520
                        }
                    ]
                }
            ]
        }
    ]
}
                

Para crear una nueva ruta, realice una solicitud POST a la siguiente URL:
https://apirest.logictracker.com/api/Routes/Create

# Ejemplo de Respuesta de la API

{
    "response": {
        "codigo": 200,
        "mensaje": "OK",
        "id": 23771189
    }  
}
                

Parámetros del Cuerpo de la Solicitud (Request Body)

Nombre	Tipo	Obligatorio	Descripción
IdEmpresa	Int	Sí	ID único proporcionado por Logictracker para el cliente que hace la consulta.
HashApi	String	Sí	HASH único proporcionado por Logictracker para el cliente que consulta la API.
Codigo	String	Sí	Código único de la ruta que se desea crear.
Patente	String	No	Patente del vehículo que realizará la ruta.
CodigoTransportista	String	No	Código del transportista asignado a la ruta.
LegajoChofer	String	No	Legajo que identifica al chofer asignado a la ruta.
FechaHora	String	No	Fecha y hora programada para la ejecución de la ruta.
Entregas	Lista<Entregas>	Sí	Lista de entregas (puntos de entrega) asociadas a la ruta.

Parámetros de Entregas

Nombre	Tipo	Obligatorio	Descripción
CodigoPuntoEntrega	String	Sí	Código del punto de entrega.
FechaProgramada	String	Sí	Fecha y hora programada para la entrega.
Remitos	Lista<Remitos>	No	Lista de remitos a entregar.

Parámetros de Remitos

Nombre	Tipo	Obligatorio	Descripción
CodigoRemito	String	Sí	Código del remito.
Productos	Lista<Productos>	No	Lista de productos que componen el remito.

Parámetros de Producto

Nombre	Tipo	Obligatorio	Descripción
SuppliesCode	String	Sí	Código único del producto.
SuppliesDescription	String	Sí	Descripción del producto.
Comment	String	No	Comentarios adicionales sobre el producto.
Quantity	Int	Sí	Cantidad de unidades del producto.

Parámetros de Respuesta

Nombre	Tipo	Descripción
response	GenericResponse	Objeto que contiene la respuesta generica de la API.

Parámetros de Respuesta Genérica

Nombre	Tipo	Descripción
codigo	Int	Código de la respuesta de la API.
mensaje	String	Mensaje que describe la respuesta de la API.
id	Int	En caso de haber creado una nueva entidad, la API devuelve el ID de la entidad generada.

Errores

La llamada a la API de Routes/Create puede devolver los siguientes códigos de error dentro del objeto GenericResponse.

Código	Mensaje
200	OK
400	Solicitud sin contenido en el cuerpo (body null).
401	Consulta sin ID de empresa/hash. Asegúrese de incluir en su solicitud IdEmpresa y HashApi.
500	Excepcion en api/Routes/Create. Entre en contacto con el area de sistemas de LOGICTRACKER y envie el CONTENIDO DEL REQUEST para ser analizado.