Histórico da Página
Introdução
| draw.io Diagram | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Sistemas Envolvidos
TOTVS Otimização Logística / TOTVS Roteirização e Entrega
Sistema Externo: Todos os ERPs que se conectam ou pretendem se conectar com os produtos de planejamento logístico da TOTVS.TOL/TRE
Integração
Escopo
- Criação de viagem, documento, nota fiscal, itens, motorista, transportadora, dispositivo de rastreamento e dispositivo mobile
Pré-requisitos instalação/implantação/utilização
Versões mínimas
TOL\TRE: 6.4.0
Protheus: ?
Datasul: ?
Esta integração não demanda instalações ou atualizações adicionais.
Layout de Requisição
createMonitorablecreateMonitorableRequest, Integração SOAP, Síncrona | |||||
|---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
| driver | Aquisição de monitoraveldriver | Não | N/A | Motorista associado a viagem | |
| alternativeDrivers | Aquisição de monitoraveldriver[] | Não | N/A | Lista de motoristas alternativos da viagem | |
| trackerDevice | Aquisição de monitoraveltrackerDevice | Não | N/A | trackerDevice ou mobileDevice deve ser fornecido para viabilizar o rastreamento | |
| monitorables | Aquisição de monitoravelmonitorable[] | Não | N/A | Lista de monitoráveis | |
| relationships | Aquisição de monitoravelrelationshipType[] | Não | N/A | Lista de relação entre os monitoráveis | |
| Âncora | ||||
|---|---|---|---|---|
|
driver, tipo de dado utilizado nas integrações do do TOL\TRE | |||||
|---|---|---|---|---|---|
| Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
| driver | Não | N/A | Motorista da viagem | ||
| identifier | String | Sim | N/A | Identificação do motorista | Ex: Cpf, Matricula |
| user | Aquisição de monitoraveluser | Não | N/A | Dados de usuário e senha para acesso ao sistema | |
| Âncora | ||||
|---|---|---|---|---|
|
user, tipo de dado utilizado nas integrações do do TOL\TRE | |||||
|---|---|---|---|---|---|
| Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
| password | String | Sim | N/A | Senha | |
| String | Sim | N/A | E-mail associado ao usuário | ||
| profile | String | Sim | N/A | Profile de acesso do usuário, ex: root | |
| Âncora | ||||
|---|---|---|---|---|
|
trackerDevice, tipo de dado utilizado nas integrações do do TOL\TRE | |||||
|---|---|---|---|---|---|
| Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
| deviceId | string | Sim | N/A | Id do dispositivo | |
| providerID | string | Sim | N/A | Provedor do dispositivo | |
| Âncora | ||||
|---|---|---|---|---|
|
monitorable, tipo de dado utilizado nas integrações |
|---|
do TOL\TRE | |||||
|---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
| sourceId | string | Sim | N/A | Código do monitorável | Deve ser único ativo |
| type | string | Sim | N/A | Define o tipo de | |
| monitorável que pode |
| ser TRIP, LOAD, DOCUMENT e INVOICE | |
| origin |
| localityType | Não | N/A | Local de carregamento |
| shipper |
| entityDto | Não | N/A | Embarcador do monitorável |
| destination |
| localityType | Não | N/A | Local de descarregamento |
| custumer |
| entityDto | Não | N/A | Cliente do monitorável |
| carrier |
| entityDto | Não | N/A | Transportadora do monitorável |
| vehicle |
| entityDto | Não | N/A | Veículo do monitorável |
| truck |
| entityDto | Não | N/A | Placa do monitorável |
| loadingSequence | int | Não | N/A | Sequencia de carregamento | |
| unloadingSequence | int | Não | N/A | Sequencia de descarregamento | |
| quantity | int | Não | N/A | Quantidade de volumes |
| do monitorável | ||||
| value | double | Não | N/A | Valor |
| do monitorável | ||||
| volume | double | Não | N/A | Volume |
| do monitorável | ||||
| weight | double | Não | N/A | Peso |
| do monitorável | |||||
| contact | string | Não | N/A | Contato responsável pelo serviço | |
| Items |
| item[] | Não | N/A |
| Lista de itens dos |
| monitoráveis quando elegíveis |
| transitions |
| transition[] | Não | N/A |
| Lista de transições do monitorável | |
| extensions |
| extension[] | Não | N/A |
| Lista de dados adicionais específicos de cada |
| implementação |
| Âncora | ||||
|---|---|---|---|---|
|
entityDto, tipo de dado utilizado nas integrações do do TOL\TRE | |||||
|---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
sourceId | string | Sim | N/A | Código da entidade | |
name | string | Não | N/A | Nome da entidade | |
description | string | Não | N/A | Descrição da entidade | |
| Âncora | ||||
|---|---|---|---|---|
|
localityType, tipo de dado utilizado nas integrações do do TOL\TRE | |||||
|---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
locality | Não | N/A | Localidade onde a transição será efetuada | ||
address | Não | N/A | Endereço onde a transição será efetuada | ||
| Âncora | ||||
|---|---|---|---|---|
|
address, tipo de dado utilizado nas integrações do do TOL\TRE | |||||
|---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
street | String | Sim | N/A | Rua do endereço | |
street | String | Sim | N/A | Rua do endereço | |
number | String | Não | N/A | Número do endereço | |
complement | String | Não | N/A | Complemento do endereço | |
district | String | Não | N/A | Bairro do endereço | |
city | String | Não | N/A | Cidade do endereço | |
state | String | Não | N/A | Estado do endereço | |
country | String | Não | N/A | Pais do endereço | |
zipCode | String | Sim | N/A | CEP do endereço | |
geolocation | Não | N/A | Latitude e Longitude | ||
| Âncora | ||||
|---|---|---|---|---|
|
geolocation, tipo de dado utilizado nas integrações do do TOL\TRE | |||||
|---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
| latitude | double | Não | N/A | Latitude do endereço | |
| longitude | double | Não | N/A | Longitude do endereço | |
| Âncora | ||||
|---|---|---|---|---|
|
itemitems, tipo de dado utilizado nas integrações do do TOL\TRE | |||||
|---|---|---|---|---|---|
| Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
| sourceId | String | Sim | N/A | Código do item do monitorável | |
| sequence | int | Não | N/A | Quantidade do item do monitorável | |
| Product | Aquisição de monitoravelentityDto | Não | N/A | Produto do item do monitorável | |
| quantity | int | Não | N/A | Quantidade do item do monitorável | |
| value | double | Não | N/A | Valor do item do monitorável | |
| volume | double | Não | N/A | Volume do item do monitorável | |
| weight | double | Não | N/A | Peso do item do monitorável | |
| extensions | extension[] | Não | N/A | Dados Lista de dados adicionais específicos de cada implementação | |
| Âncora | ||||
|---|---|---|---|---|
|
transitionAquisitionType, tipo de dado utilizado nas integrações do do TOL\TRE | |||||
|---|---|---|---|---|---|
| Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
| sourceId | string | Sim | N/A | Código da transição | Deve ser único com o monitorável ativo |
| name | string | Sim | N/A | Nome da transição | |
| expectedTimestamp | dateTime | Sim | N/A | Data/Hora esperada para a transição | |
| limitTimestamp | dateTime | Não | N/A | Data/Hora limite para a transição | |
| location | Aquisição de monitoravellocalityType | Não | N/A | Local da transição | |
| extensions | extension[] | Não | N/A | Dados Lista de dados adicionais específicos de cada implementação | |
| Âncora | ||||
|---|---|---|---|---|
|
extension, tipo de dado utilizado nas integrações do do TOL\TRE | |||||
|---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
| key | String | Sim | N/A | Descrição da extensão | |
| textValue | String | Não | N/A | Opção para quando a extensão é uma string | |
| floatValue | double | Não | N/A | Opção para quando a extensão é valor | |
| integerValue | long | Não | N/A | Opção para quando a extensão é um valor inteiro | |
| instantValue | datetime | Não | N/A | Opção para quando a extensão é uma data e hora | |
| booleanValue | boolean | Não | N/A | Opção para quando a extensão é uma lógica | |
| Âncora | ||||
|---|---|---|---|---|
|
realtionshiprelationship, tipo de dado utilizado nas integrações do do TOL\TRE | |||||
|---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
| parentSourceId | string | Sim | N/A | Monitorável Pai | |
| children | stringchildrens[] | Sim | N/A | Lista de monitoráveis Filhos | |
| Âncora | ||||
|---|---|---|---|---|
|
childrenTypechildren, tipo de dado utilizado nas integrações do do TOL\TRE | |||||
|---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações | child
| childSourceIds | string | Sim | N/A | Monitoráveis filhos | |
Layout de Resposta
| createMonitorableResponse, tipo de dado utilizado nas integrações do TOL\TRE | |||||
|---|---|---|---|---|---|
| Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
| messeges | messegeType[] | Sim | N/A | Lista de respostas | |
| Âncora | ||||
|---|---|---|---|---|
|
| messageType, tipo de dado utilizado nas integrações |
|---|
| do TOL\TRE | |||||
|---|---|---|---|---|---|
| Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
| sourceId | string | Sim | N/A | Código do monitorável | |
| type | string | Sim | N/A | Define o tipo do monitorável que pode ser TRIP, LOAD, DOCUMENT e INVOICE | |
| result | boolean | Sim | N/A | Confirmação do sucesso ou falha do processo | |
| code | string | Não | N/A | Código do erro | |
| description | string | Não | N/A | Descrição do erro | |
Catalogo de mensagens
| Âncora | ||||
|---|---|---|---|---|
|
| Código | Mensagem | Descrição |
Anexos
| Anexos |
|---|
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas