Criar Grupo de Pedidos

Schema das deliveries:

Campo	Tipo	Descrição	Obrigatório
headquarter_code	String	Código agregador do cliente	Não
code	String	Código do cliente	Sim
name	String	Nome do cliente	Sim
site	String	ID da filial	Não
invoice_number	String	Nota Fiscal	Não
order_number	String	Número do Pedido	Não
shipment_number	String	Número da Remessa	Não
additional_info	String	Observações	Não
additional_info_1	String	Observações #1	Não
additional_info_2	String	Observações #2	Não
custom_label	String	Nr Plano	Não
group	String	Origem CTE	Não
loads	Array	Capacidades ¹	Não
service_time	Float	Tempo de Serviço	Não
email	String	E-mail do Cliente	Não
phone	String	Telefone do Cliente	Não
service_type	String	Tipo de serviço (delivery \| pickup)	Não
customer_profile	String	Campo contendo o ID do perfil de cliente
constraints	Object	Objeto de Restrições	Não
constraints.priority	Number	Prioridade para o atendimento do cliente ²	Não (Default: 0)
constraints.sequence	Number	Prioridade na sequencia de atendimento do cliente ³	Não (Default: 0)
constraints.skills	String	Array de Strings contendo características	Não
constraints.prohibited_vehicles	String	Array de IDs de veículos proibidos	Não
constraints.region	String	Nome da região	Não
constraints.window_daily	Object Array	Array de objetos de janela horária	Não
constraints.window_daily.start_time	String	Data de início rs]	Não
constraints.window_daily.end_time	String	Data de término da janela ta"	Não
address	Object	Objeto de Endereço	Sim
address.route	String	Logradouro	Sim
address.street_number	String	Número	Sim
address.additional_info	String	Complemento	Sim
address.neighborhood	String	Bairro	Sim
address.city	String	Cidade	Sim
address.state	String	Estado	Sim
address.postal_code	String	CEP	Sim
address.country	String	País	Sim
address.geocode	Object	Objeto de Geolocalização	Sim
address.geocode.lat	Float	Latitude	Sim
address.geocode.lng	Float	Longitude	Sim

[1] O loads é um array de capacidades. O index[0] é o peso em quilo (kg) e o index[1] é o volume em metros cúbicos (m³). Os demais indexes são usados apenas em casos de multicapacidade.

[2] A priority define o nível de importância para o atendimento de um cliente em relação aos demais. Caso as restrições operacionais impeçam que o algoritmo atenda a totalidade dos clientes, os serviços que possuírem maior prioridade terão maiores chances de serem programados em rota do que clientes com baixa prioridade.

[3] O sequence define o nível de importância de um cliente em ser atendido antes dos demais clientes em uma mesma rota. Clientes com maior prioridade no sequenciamento serão programados pelo algoritmo para serem atendidos sempre antes de realizar o atendimento de clientes com menor prioridade, mesmo que seja necessário elevar a distância total da rota para respeitar essa restrição. Clientes que possuem a mesma sequence na rota terão a sua sequência de atendimento definida em razão de outras restrições e da busca pela redução da quilometragem total da rota.

[4] O formato tanto do start_time quanto do end_time da window_daily deve estar no formato "1970-01-01T10:00:00.000-0300" para horários com o fuso no horário de Brasília, sendo que o início em 1970-01-01 é para window_daily no dia "atual" da roteirização. Caso deseje colocar uma window_daily para dias futuros basta mudar o valor do dia na data (ex. 1970-01-02T10:00:00.000-0300 para uma janela no dia seguinte). E o -0300 ao final indica o fuso horário para o horário de Brasilia (GMT -03:00). Caso queira utilizar UTC no fuso, basta colocar o Z ao final, porém é necessário ajustar o horário (ex. "1970-01-01T10:00:00.000Z" para uma window_daily as 7:00 do horário de Brasilia).

Sobre os campos de endereço, você pode mandar ou só o objeto address.geocode preenchido ou os demais campos. Quando recebe address.geocode preenchido, o sistema pula a etapa de busca das coordenadas, caso não esteja, ele pega os dados do endereço e busca na API do Google. Ou seja, nenhum aí é obrigatório de verdade. Mas foi colocado tudo como "Sim" porque deve ser enviado um ou outro.

Roteirizando

Após enviar o grupo de deliveries no corpo da requisição POST, ele já se torna disponível dentro do RoutEasy e para acessá-lo deve-se ir na tela de criação de roteirização (+ Nova Roteirização), depois nos 3 pontos ao lado de "Importar Excel", e em "Integração de Sistemas.

1366 — No menu preto do lado esquerdo, ir em "+ Nova Roteirização", depois nos 3 pontos ao lado de "Importar Excel", e em "Integração de Sistemas.

Com isso irá aparecer um modal que mostra quais são os grupos de deliveries que já foram enviados para o sistema com os seus respectivos nomes.

Depois de escolher a Origem, ao clicar em Roteirizar, dá-se início ao processo de roteirização. Mas ao clicar em Editar, os pontos deste grupo de deliveries carregam no mapa, dando a oportunidade de fazer alterações importante antes de iniciar a roteirização (é recomendado clicar em Editar para verificar suas deliveries antes de enviar para roteirização).