Á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
borderfalse
viewerToolbartrue
fitWindowfalse
diagramDisplayName
lboxtrue
revision8
diagramNameTRE - Aquisição de Caminhões
simpleViewerfalse
width
linksauto
tbstylehidden
diagramWidth342

Sistemas envolvidos

  • TOTVS Otimização Logística / TOTVS Roteirização e Entrega

  • Sistema Externo: ERPs que se conectam ou pretendem se conectar com TOL/TRE

Escopo:

O Objetivo deste desenvolvimento é permitir a integração de caminhão via sistema externo. Com o cadastro de caminhão, é possível bloquear o uso de uma placa por determinada janela de tempo, de acordo com configuração. Isso permite, por exemplo, inviabilizar o uso de uma placa devido a indisponibilidade como manutenção. 

Destaca-se ainda que o bloqueio de placas via tela de caminhões, seja via browser, seja via integração:

  • Não afeta viagens antigas. Isso significa que apenas viagens criadas depois do cadastro da configuração levarão em conta o fato de haver placas indisponíveis.
  • Gera indisponibilidade na otimização da placa cadastrada, no período de tempo da janela prevista.
  • Via operação manual é permitido escolher qualquer veículo, mesmo que bloqueado, apesar da violação do período bloqueado em Programação > Caminhões.

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

  • Versões mínimas

    • TRE:  ?

    • Protheus:  ?

    • Datasul: ?

  • Esta integração não demanda instalações ou atualizações adicionais.

Layout de requisição

createTruck/deleteTruck Integração SOAP, síncrona
NomeTipoObrigatórioTamanhoDescriçãoObservações
truckPlateStringSim10Consiste na placa do caminhão que está sendo integrada para bloqueio.Aceita qualquer sequência alfa numérica sem validação. 
start(

String

) formato ISO8601

Sim29

Consiste na data/hora de início de bloqueio da placa. A partir dessa hora, a placa torna-se bloqueada para otimização.

Segue ISO 8601. 

Exemplo 1: "2021-09-03T17:14:25.450-03:00"


A data de início de bloqueio, startTime, deverá ser menor do que a data de fim de bloqueio, endTime.
end(

String

) formato ISO8601

Sim29

Consiste na data/hora de fim de bloqueio da placa. A partir dessa hora, a placa torna-se bloqueada para otimização.

Segue ISO Segue ISO 8601. 

Exemplo 1: "2021-09-03T17:14:25.450-03:00"

A data de início de bloqueio, startTime, deverá ser menor do que a data de fim de bloqueio, endTime.
observationsStringNão255Consiste num campo informativo, permitindo, entre outras coisas, cadastro de motivo de bloqueio.O Campo é puramente informativo e não é validado.

Layout de resposta


NomeTipoObrigatórioTamanhoDescriçãoObservações
Resultresult[]SimN/AElemento de agrupamento de todos os Caminhões
SuccessBooleanSim1Flag de sucesso ou falha

Âncora
result
result

result, tipo de dado utilizado nas integrações do TOL\TRE
NomeTipoObrigatórioTamanhoDescriçãoObservação
errorCodesstringNão30Lista de códigos de erros
errorMessagestringNão255Mensagens de erros
identifierstringNão30Identificador da tabela dos erros
successBooleanSim1Flag de sucesso ou falha

Anexos