Criar Pedido

Para enviar um conjunto de pedidos para serem roteirizados através do Gestão de Pedidos, você precisa enviar uma requisição HTTP do tipo POST para https://company.routeasy.com.br/orders/import passando a api_key Verifique se o plano contratado possui acesso ao módulo Gestão de Pedidos

A api_key é a chave que você receberá da equipe RoutEasy..

Schema do objeto Orders

CampoTipoDescriçãoObrigatório
ordersArrayTodas as informações dos pedidos devem vir dentro deste arraySim
orders.siteStringID de FilialNão ¹
orders.service_typeStringTipo de serviço (delivery/pickup)Não (Default: "delivery")
orders.locationObjectDados referentes ao clienteSim
orders.location.headquarter_codeStringCódigo agregador do clienteNão
orders.location.codeStringCódigo do clienteSim
orders.location.nameStringNome do clienteSim
orders.location.addressObjectDados referentes a localização do clienteSim
orders.location.address.routeStringLogradouroSim
orders.location.address.street_numberStringNúmeroSim
orders.location.address.neighborhoodStringBairroSim
orders.location.address.cityStringCidadeSim
orders.location.address.stateStringEstadoSim
orders.location.address.countryStringPaísNão
orders.location.address.postal_codeStringPostal CodeNão
orders.location.address.additional_infoStringComplementoNão
orders.location.address.geocodeObjectObjeto de GeolocalizaçãoNão
orders.location.address.geocode.latFloatLatitudeNão
orders.location.address.geocode.lngFloatLongitudeNão
orders.location.phoneStringTelefone do clienteNão
orders.location.emailStringE-mail do clienteNão
orders.location.customer_profileStringCampo contendo o ID do perfil de clienteNão
orders.additional_infoArray de stringsObservação 1, Observação 2, Observação 3,Não
orders.location.additional_info (delivery info)StringObservaçõesNão
orders.location.additional_info_1 (delivery info)StringInf. Adicionais 1Não
orders.location.additional_info_2 (delivery info)StringInf. Adicionais 2Não
orders.constraintsObjetoRestrições OperacionaisNão
orders.constraints.priority ²NumberPrioridade para o atendimento do clienteNão (Default: 0)
orders.constraints.sequenceNumberPrioridade na sequência de atendimento do clienteNão (Default: 0)
orders.constraints.skillsArray de StringsArray de Strings contendo característicasNão
orders.constraints.regionStringRegião/Cluster do PedidoNão
orders.constraints.prohibited_vehiclesArray de StringsArray de Strings de IDs de veículos proibidosNão
orders.constraints.window_dailyArray de ObjetosArray contendo as janelas de atendimentoNão
orders.constraints.window_daily.start_timeStringHorário de início da janela de atendimentoNão
orders.constraints.window_daily.end_timeStringHorário de término da janela de atendimentoNão
orders.loads ³Array de NumbersCapacidadesNão
orders.itemsArray de ObjectsConjunto de Itens contidos no pedidoNão
orders.items.codeStringCódigo do item no pedidoNão
orders.items.nameStringNome do item no pedidoNão
orders.items.qtyNumberQuantidade do item no pedidoNão
orders.invoice_numberStringNota FiscalNão
orders.order_numberStringNúmero do PedidoSim
orders.shipment_numberStringNúmero da RemessaNão
orders.service_timeNumberTempo de atendimento (em minutos)Não
orders.schedule_dateArrayIntervalos de data permitidos para realização do atendimento ao clienteNão
orders.schedule_date.start_dateTimestampData mínima para chegada no clienteNão
orders.schedule_date.end_dateTimestampData máxima para chegada no clienteNão

Obs.:
[1]: O campo site só é obrigatório quando a company possui mais de uma filial cadastrada. Caso haja apenas uma, o envio será feito para a única filial existente.
[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.
[2] 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.
[3]: 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.
[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).

Language
Authorization
Header
Click Try It! to start a request and see the response here!