Introducción

API Endpoint

https://apirest.logictracker.com/
                

Nuestra API proporciona acceso programático para leer y actualizar datos de sus principales entidades de negocio, en este caso CREAR ORDENES.

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.

Crate Order

# Ejemplo Request HTTP
POST /api/Orders/Create HTTP/1.1
Host: apirest.logictracker.com
Content-Type: application/json

{
    "IdEmpresa": TU_ID_EMPRESA,
    "HashApi": "TU_HASH_API",
    "Code": "20200910O144800",
    "Date": "10/09/2020 14:48:03",
    "CustomerCode": "122471",
    "CustomerTypeCode": "CODIGO_TIPO_CLIENTE",
	"BaseCode": "CODIGO_DE_LA_BASE",
    "DeliveryDate": "11/09/2020 14:48:03",
	"ServiceTypeCode": "D",
    "VehicleTypeCode": "D",
    "Weight": 200.7,
    "Volume": 12.4,
    "Priority": 1,
    "Supplies": [
        {
            "Code": "4008",
            "Description": "LEVADURA PRENSADA LCBSA X 10 KG",
            "Comment": "No puede perder cadena de frio",
            "Quantity": 150,
            "Price": "1200",
            "Weight": 12.5,
            "Volume": 15.2
        },
        {
            "Code": "337",
            "Description": "LA CBSA.OLEO CÑL X 20 KG",
            "Comment": "No golpear",
            "Quantity": 520,
            "Price": "700",
            "Weight": 10400.00,
            "Volume": 15.2
        }
    ]
}

# Ejemplo Request CURL
curl --location --request POST 'https://apirest.logictracker.com/api/Orders/Create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "IdEmpresa": TU_ID_EMPRESA,
    "HashApi": "TU_HASH_API",
    "Code": "20200910O144800",
    "Date": "10/09/2020 14:48:03",
    "CustomerCode": "122471",
    "CustomerTypeCode": "CODIGO_TIPO_CLIENTE",
	"BaseCode": "CODIGO_DE_LA_BASE",
    "DeliveryDate": "11/09/2020 14:48:03",
	"ServiceTypeCode": "D",
    "VehicleTypeCode": "D",
    "Weight": 200.7,
    "Volume": 12.4,
    "Priority": 1,
    "Supplies": [
        {
            "Code": "4008",
            "Description": "LEVADURA PRENSADA LCBSA X 10 KG",
            "Comment": "No puede perder cadena de frio",
            "Quantity": 150,
            "Price": "1200",
            "Weight": 12.5,
            "Volume": 15.2
        },
        {
            "Code": "337",
            "Description": "LA CBSA.OLEO CÑL X 20 KG",
            "Comment": "No golpear",
            "Quantity": 520,
            "Price": "700",
            "Weight": 10400.00,
            "Volume": 15.2
        }
    ]
}'
                

Para dar de alta una nueva ORDEN, debe realizar una llamada POST a la siguiente URL:
https://apirest.logictracker.com/api/Orders/Create

# Ejemplo API Respuesta 

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

REQUEST BODY PARAMETERS

Nombre	Tipo	Obligatorio	Descripción
idEmpresa	Int	SI	ID único provisto por Logictracker para el cliente que consulta la API.
hashApi	String	SI	HASH único provisto por Logictracker para el cliente que consulta la API.
code	String	SI	Código único de la ORDEN que queremos utilizar para el ALTA.
date	String	SI	Fecha y hora en que fue dada de alta la orden. Formato: dia/mes/año hora:minutos:segundos
customerCode	String	SI	Código del cliente que pertenece la orden.
customerTypeCode	String	SI	Código del tipo de cliente que pertenece la orden.
baseCode	String	NO	Código de la base a la que va a pertenecer la orden.
serviceTypeCode	String	NO	Código del tipo de servicio (tiene que haberse creado en plataforma logictracker).
vehicleTypeCode	String	NO	Código del tipo de vehiculo que necesita la orden (tiene que haberse creado en plataforma logictracker).
deliveryDate	String	NO	Fecha y hora estimado en que tiene que ser entraga la orden. Formato: dia/mes/año hora:minutos:segundos.
weight	Float	NO	Peso de la orden.
volume	Float	NO	Volumen de la orden.
priority	Int	NO	Prioridad de la orden.
comment	String	NO	Comentario de la orden.
supplies	List<Supplie>	NO	Lista de productos que contiene la orden.
urlTag	String	NO	Url donde se encuentra almacenada la etiqueta relacionada a la orden.
TrackingNumber	String	NO	Tracking number que se le asignara a la orden.
Shift	String	NO	Turno de la orden. Las opciones a enviar son: MAÑANA / TARDE / NOCHE / TODO_EL_DIA / PRESUPUESTO / SUCURSAL_PROPIA.

SUPPLIE PARAMETERS

Nombre	Tipo	Descripción
code	String	Código del producto.
description	String	Descripción del producto.
comment	String	Comentario del producto.
quantity	Int	Cantidad de productos.
price	String	Precio del producto.
weight	float	Peso del producto.
volume	String	Volumen del producto.

RESPONSE PARAMETERS

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

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.

Errors

La llama a la API de Orders/Create 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	Consulta sin id de empresa/hash. Asegurese de incluir en su request idEmpresa y hashApi provisto por LOGICTRACKER.
402	Empresa no habilitada para crear ordenes. Solicitar habilitación uso de API a LOGICTRACKER.
403	Hash invalido para consultar API. Asegurese que hashApi provisto por LOGICTRACKER sea el correcto.
404	Código de cliente nulo.
405	Código de orden nulo.
406	Fecha de orden nula.
407	Ya existe orden con código recibido.
408	No existe cliente con código recibido.
409	No existe tipo servicio con código recibido.
410	No existe tipo vehiculo con código recibido.
411	No existe tipo de cliente con código recibido.
500	Excepcion en api/Orders/Create. Entre en contacto con el area de sistemas de LOGICTRACKER y envie el CONTENIDO DEL REQUEST para ser analizado.