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 | |||||
|---|---|---|---|---|---|
| Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
| truckPlate | String | Sim | 10 | Consiste na placa do caminhão que está sendo integrada para bloqueio. | Aceita qualquer sequência alfa numérica sem validação. |
| start | String | Sim | 29 | 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 | Sim | 29 | 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. |
| observations | String | Não | 255 | Consiste num campo informativo, permitindo, entre outras coisas, cadastro de motivo de bloqueio. | O Campo é puramente informativo e não é validado. |
Layout de resposta
| Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
|---|---|---|---|---|---|
| Result | result[] | Sim | N/A | Elemento de agrupamento de todos os Caminhões | |
| Success | Boolean | Sim | 1 | Flag de sucesso ou falha | |
| result, tipo de dado utilizado nas integrações do TOL\TRE | |||||
|---|---|---|---|---|---|
| Nome | Tipo | Obrigatório | Tamanho | Descrição | Observação |
| errorCodes | string | Não | 30 | Lista de códigos de erros | |
| errorMessage | string | Não | 255 | Mensagens de erros | |
| identifier | string | Não | 30 | Identificador da tabela dos erros | |
| success | Boolean | Sim | 1 | Flag de sucesso ou falha | |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas