Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Introdução


draw.io Diagram
bordertrue
viewerToolbartrue
fitWindowfalse
diagramNameTRE_publicacao_ocorrencia
simpleViewerfalse
width
pageId607604148
diagramWidth342

Sistemas Envolvidos

  • API JavaScript
  • TPR: TOTVS Planejamento de Rotas

Integração

  • Formato de entrada/saída: JSON

Escopo

  • Dados ao menos dois pontos, e um token de acesso válido, esta integração retornara uma lista de pernas, ou seja, a sequencia de pontos que representa a rota a ser executada entre estes pontos;

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;

Layout de Requisição

TPRRouteView: Integração rest, sincrona
Path: .../v1/tpr-system-usage Método: POST
CampoTipoObrigatórioTamanhoDescriçãoValidaçõesExemplos
dateCallDate TimeSim
Data da criação da chamada no sistema externoFormato ISO
systemStringNão4096Identificador do sistema que fez a chamadaTexto Livre
versionStringNão4096Versão do sistema externoTexto Livre
qualifiersObjectNão4096String chave valorFormato Json
pointsTPRPoint[]Sim

Ao mínimo 2 pontos

Layout de Resposta

TPRRouteViewResponse, tipo de dado utilizado nas integrações do TPR
CampoTipoObrigatórioTamanhoDescriçãoValidaçõesExemplos
dateResponseDate TimeSim
Data do envio da resposta no TPRFormato ISO2021-01-21T10:01:00.0-03:00
YYYY-MM-DDThh:mm:ss.sTZD
versionStringSim4096Versão do TPR que executou a resposta-0.0.0.1
successBooleanSim
True se sucesso, false se falha-True
totalDistancedoubleSim
Distância total do plano de viagens, em kmMaior ou igual a zero
legsTPRLegs[]

Rota e distância entre dois pontos-
messageTPRMessage[]Não
Campo que deve ser exibido pelo sistema externo para o usuário-Tabela abaixo

Âncora
TPRLeg
TPRLeg

TPRLeg, tipo de dado utilizado nas integrações do TPR
CampoTipoObrigatórioTamanhoDescriçãoValidaçõesExemplos
distancedoubleSim
Distância percorrida entre as paradasMaior ou igual a zero, referente ao tipo de rota.122.56
pointsTPRPoint[]Sim
Pontos de rota desta pernaCaso não seja encontrada rota válida, o retorno contemplará apenas o ponto
de partida desta perna, exceto pela última leg, que contempla o ponto de chegada
também.

routeTypeStringSim
Tipo da rota realizada nesta perna.Valores possíveis: "ROAD", "GEODESIC"ROAD

Âncora
TPRPoint
TPRPoint

TPRPoint, tipo de dado utilizado nas integrações do TPR
CampoTipoObrigatórioTamanhoDescriçãoValidaçõesExemplos
latitudedoubleSim
Latitude do ponto geográficoEntre -90 e 90 inclusive;-23.45
longitudedoubleSim
Latitude do ponto geográficoEntre -180 e 180 inclusive;-46.32

Âncora
TPRMessage
TPRMessage

TPRMessage, tipo de dado utilizado nas integrações do TPR
CampoTipoObrigatórioTamanhoDescriçãoValidaçõesExemplos
messageCodeStringSim
Código de identificação da mensagemCódigo existente e validoTPR0001
messageStringSim4096Mensagem escritaTexto Livre"E-mail Invalido"

Catálogo de Mensagens

Âncora
TPRCatMsg
TPRCatMsg

Código

Mensagem

Descrição

TPRVR0001

Anexos

Anexos