Árvore de páginas

Introdução

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

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

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 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

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

  Arquivo Modificado
Arquivo XML create_truck_allocation.xml 12 nov, 2021 by Jefferson Andrade
Arquivo XML delete_truck_allocation.xml 12 nov, 2021 by Jefferson Andrade
Arquivo TRE - Aquisição de Caminhões draw.io diagram 05 jun, 2023 by Julio Vinicius Oliveira dos Santos
Arquivo PNG TRE - Aquisição de Caminhões.png TRE - Aquisição de Caminhões exported to image 05 jun, 2023 by Julio Vinicius Oliveira dos Santos

  • Sem rótulos