Totvs Planejamento de Rotas

Árvore de páginas

Versões comparadas

Versão antiga 17

changes.mady.by.user Alex Santana Fogaca

Gravado em

comparado com

Nova versão 18

changes.mady.by.user Usuário desconhecido (willian.godoy)

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Atualiza catálogo de mensagens

Introdução

draw.io Diagram
bordertrue
viewerToolbartrue
fitWindowfalse
diagramNameTPR_visualizacao_rota
simpleViewerfalse
width
diagramWidth342
revision1

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 ISO2021-01-21T10:01:00.0-03:00
YYYY-MM-DDThh:mm:ss.sTZD
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

TPRVR0000Sucesso.
TPRVR0001Data da criação da chamada no sistema externo é obrigatória.
TPRVR0002O sistema possui mais de 4096 caracteres.
TPRVR0003A versão possui mais de 4096 caracteres.
TPRVR0004O valor do qualificadores possui mais de 4096 caracteres.
TPRVR0005Qualificadores não estão em um formato JSON válido.
TPRVR0006São obrigatórios ao menos dois pontos geográficos.
TPRVR0007%s não é uma latitude válida [-90.0, 90.0].
TPRVR0008%s não é uma longitude válida [-180.0, 180.0].
TPRVR0009Chamada remota falhou: %s.
TPRVR0010Formato inválido.
TPRVR0011JSON inválido.

Anexos

Anexos