Introdução

draw.io Diagram
border true viewerToolbar true fitWindow false diagramDisplayName lbox true revision 3 diagramName TPR Geolocalização simpleViewer false width links auto tbstyle hidden diagramWidth 480

Sistemas Envolvidos

• TPR:

  • TOTVS Planejamento de Rotas

• Sistema Externo:

  • Todos os ERPs que se conectam ou pretendem se conectar com os produtos de planejamento logístico TOTVS.

Integração

• Formato de entrada/saída: JSON

Escopo

• Integração assíncrona de geolocalização, compostas pela chamada e pelos callbacks, nestas, receberemos uma lista endereços e, quando possível, retornaremos em pacotes de 100 linhas a latitude e a longitude para serem armazenadas no sistema externo;

• Por que não incluir este processo dentro da integração de roteirização?
  • Para simplificar o fluxo de roteirização isolando as complexidades da geolocalização em um fluxo específico;
  • Para garantir que ao chamar a integração de roteirização o cliente não receba e seja cobrado, por uma rota com 9 de 10 dos pedidos necessários quando um deles esta  com o endereço mal formatado;

• Por que assíncrona?
  • Alguns provedores externos limitam as chamadas em determinados período de tempo;
    • Por exemplo: O Google limita em 20 mil chamadas por minuto o que em chamadas maiores pode gerar uma espera de alguns minutos;
  • De forma assíncrona poderemos balancear as chamadas entre os clientes e não deixar alguém que quer geolocalizar 10 linhas esperando em uma fila de 100 mil, por exemplo;

Pré-requisitos instalação/implantação/utilização

• Para clientes Protheus versão xxxxxx;
• Para clientes Datasul versão xxxxxx;
• Para clientes externos contratação do trial via TOTVS Store;

Âncora
TPRGeolocation TPRGeolocation

Layout de Requisição

Layout de Resposta

Âncora
TPRCatErros TPRCatErros

Catálogo de Erros

Anexos