📗 2️⃣ Integração RoutEasy.A tela “4.2.17 - Roteirização - RoutEasy”, foi criada para centralizar as operações relacionadas a integrações com a API RoutEasy com exclusividade. Essa tela reúne o formulário de configuração da integração, o painel de acompanhamento e uma gradena qual se pode realizar os processos básicos de integração anteriormente disponíveis na tela “4.2.6 - Expedição”. Painel |
---|
| Localização da nova tela (Imagem 1). |
Painel |
---|
| Anteriormente, os campos de configuração e parametrização referentes à integração com a API RoutEasy, encontravam-se na tela “1.1.5 - Cadastro de empresas”, na aba “Manutenção” em “Integrações” no campo “Reasy/RoutEasy”. Com a criação da no va tela “4.2.17 - Roteirização - RoutEasy”, esses campos encontram-se na aba “Configurações”. |
Os processos de integração “Enviar ordens ao RoutEasy, Enviar romaneios ao RoutEasy e Receber sequenciamento do RoutEasy”, anteriormente disparados via opção em grade através da tela “4.2.6 - Expedição” em Programação de carregamento na grade superior (botão direito) e Expedição, na aba “Sugestão de carregamento #1” da grade (botão direito) passarão a ser atribuições da grade em “Roteirização - RoutEasy” em “Ordens”, acessíveis via botão direito na grade.
Integrar ordens selecionadas | realiza a criação de instâncias dos pedidos selecionados no sistema RoutEasy, da mesma forma que o antigo processo “Enviar ordens ao Reasy”. Além disso, essa opção, combinada com a filtragem por romaneio substitui a antiga opção “Enviar romaneios ao Reasy”. |
---|
Integrar tudo | opção auxiliar funcional, que realiza o processo de integração para todas as ordens disponíveis na grade da aba “Ordens”. | Receber sequenciamento | função disponível apenas para romaneios, que realizará atualização do sequenciamento das ordens pertencentes aos romaneios das ordens selecionadas ao solicitar o processo. Isso significa que, ao selecionar ordens na grade e utilizar essa opção, todos os romaneios que pertencem às ordens selecionadas, terão o sequenciamento atualizado. |
Observação: As antigas opções de integração da tela “Expedição” continuarão existindo, agora como atalhos para a nova tela “4.2.17 - Roteirização - RoutEasy”. Sendo assim, ao acionar alguma das três funcionalidades, o novo painel será chamado, com os mesmos pedidos selecionados, acionando automaticamente o tipo de integração selecionada, conforme os moldes acima descritos, mantendo o mesmo comportamento de integração que anteriormente. Painel |
---|
| Antes (Imagens 4 e 5). |
Painel |
---|
| Depois (via menu principal) (Imagem 7). |
O painel de acompanhamento de integrações logísticas, localizado na aba “Reasy”, em “Expedição”, passará a ser encontrado exclusivamente em “Roteirização - RoutEasy”, sob o título “Integraçã”o. A tela mantém exatamente os mesmos comportamentos anteriores, servindo como um painel de acompanhamento para ordens integradas com a RoutEasy.
Foi criado na API do integrador “WS Guarani RoutEasy” o ponto final de manipulação para o evento “Finalização de serviço da RoutEasy”, disponível via webhook (comunicação entre duas ferramentas). O comportamento desse manipulador contemplará a realização automática de baixa de pedidos entregues, além do preenchimento de informações da entrega e armazenamento de links de documentações disponibilizados pelo endpoint (ponto final). Painel |
---|
| Integrador “WS Guarani RoutEasy”: configuração padrão de banco de dados e credenciais, pelo menu “Configuração” optando em “Banco de Dados” (Imagens 10 e 11). |
Painel |
---|
| Para configurar o local da base de dados do integrador (não a do ERP), utilizar a opção Teste do painel principal do integrador: |
Painel |
---|
| Necessário que o cliente realize o cadastro do endereço da API do integrador, assim como a ativação do evento de finalização de serviço, que é a opção consumida pela API do integrador Guarani (Imagem 13). |
📗 3️⃣ Criar Configuração: De.. Para... (características).Na tela “4.2.17 - Roteirização - RoutEasy” foram adicionados recursos para denominação customizada dos tipos de frete, a fim de permitir a adição dessa informação às integrações de criação de pedidos junto à RoutEasy. Em “Roteirização - RoutEasy” em “Configuração” na aba “Descrições”, na qual serão contempladas gradesde convergência de denominação para informações que irão compôr as integrações RoutEasy. Painel |
---|
| A aba possui somente a grade chamada “[Frete]”, por meio da qual pode-se associar denominações para cada tipo de frete. A coluna “Tipo” demonstrará o tipo de frete, enquanto a “Descrição”, aceitará edição, recebendo a denominação desejada para aquele tipo de frete (Imagem 1). |
Foi adicionada a tela “4.2.17 - Roteirização - RoutEasyem “Configuração” na aba “[Informações Gerais]” o campo “Integrar cancelamento de ordens automaticamente?”, onde o usuário determinará a ativação da rotina automática de integração de cancelamento. Por padrão, esse campo estará setado como “NÃO”, de forma que se o usuário desejar utilizar esse recurso deverá ativá-lo manualmente. E quando ativado, a rotina verificará a cada cancelamento realizado no Guarani ERP, se há integração da ordem objeto do cancelamento. Painel |
---|
| No caso afirmativo, será realizada uma requisição para o endpoint “Cancelar Pedidos”, informando a ordem, a fim de realizar seu cancelamento junto à RoutEasy, de forma a refletir as atualizações realizadas no ERP (Imagem 2). |
Painel |
---|
| A integração de pedidos Guarani com RoutEasy não contempla pedidos cujo tipo de frete seja FOB. Contudo, devido à existência dessa demanda, foi criado na tela “4.2.17 - Roteirização - RoutEasy” em “Configuração” na aba “[Informações Gerais]”, o campo “Integrar ordens com frete tipo FOB?”, onde poderá ignorar o comportamento em questão, de forma que o processo de integração RoutEasy passará a aceitar todas as ordens, independentemente de seu tipo de frete (Imagem 5). |
Observação: por padrão, esse novo campo estará sempre optado como “NÃO”, para manter o comportamento legado. |