Árvore de páginas

Introdução

Sistemas Envolvidos

  • TOTVS Otimização Logística

  • Sistema Externo: Todos os ERPs que se conectam ou pretendem se conectar com os produtos de planejamento logístico da TOTVS.

Escopo

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

  • Versões mínimas

    • TOL:  6.4.0

    • Protheus:  ?

    • Datasul: ?

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

Layout de Requisição

publishTenderingService: Integração SOAP, síncrona
NomeTipoObrigatórioTamanhoDescriçãoObservações
messageIdintSim10ID da mensagem de solicitação de liberação de uma viagem do TOL
tripTenderingNotificationtripTenderingNotification[]SimN/AElemento de agrupamento de todas as solicitações de liberações de viagens do TOLDeverá haver pelo menos 1 solicitação de liberação de viagem nesta lista;

tripTenderingNotification, tipo de dado utilizado nas integrações do TOL

Nome

TipoObrigatórioTamanhoDescriçãoObservações
regionSourceIdstringSim30Identificador da regional;Deve ser uma regional válida;
basketSourceIdstringNão30ID da cesta onde esta operação foi realizada manualmente pelo usuário no TOLEste campo poderá não ser enviado nos casos em que a liberação foi solicitada de forma automática e não através da tela do TOL (nestes casos, não se pode identificar a cesta do usuário);
identifier (trip)intSim10ID da viagem cuja liberação está sendo solicitada pelo TOL;
creationDateData/hora (string)Sim29Data de criação da viagem
freightValuefloatSim13Valor do frete da viagem;
carrierIdstringSim255ID da transportadora da viagem;
vehicleIdstringSim255ID do tipo de veículo da viagem;
vehicleDescriptionstringNão255Descrição do tipo de veículo da viagem;
truckLicensePlatestringNão8Placa do caminhão da viagem;Esta placa poderá ser informada pela transportadora ao aceitar a viagem (Partner Collaboration);
truckLicensePlateStatestringNão2Estado da placa do caminhão da viagem;
truckStatusIdstringNão2Identificador da situação do caminhão;0=Desconhecido, 1=Agregado, 2=Frota própria, 3=Frota terceirizada;
truckStatusDescriptionstringNão255Descrição da situação do caminhão;
truckAxlesQuantityintNão10Número de eixos do caminhão;Serão contabilizados os eixos de todos os baús do caminhão;
tripClassificationSourceIdStringSim30Classificação da viagem
classificationsclassifications []NãoN/AElemento de agrupamento de todas as classificações de uma viagem;
attributes attributes[]NãoN/AElemento de agrupamento de todas os atributos de uma viagem;
commentsstringNão255Observações da viagem;
loadsload[]SimN/AElemento de agrupamento de todas as cargas de uma viagem;Deverá haver pelo menos 1 carga nesta lista;

load, tipo de dado utilizado nas integrações do TOL

Nome

TipoObrigatórioTamanhoDescriçãoObservações
identifier (load)intSim10ID da carga da viagem;
serviceTypeIdintSim1ID do tipo de serviço da carga;Full truck load (FTL);
Less than truck load (LTL);
serviceTypeDescriptionstringSim255Descrição do tipo de serviço da carga;
loadModeintSim1ID do tipo de carga;1=Estivada; 2=Paletizada; 3=Mista;
modalintSim1ID do modal da carga;1=Rodoviário; 2=Aquaviário; 3=Ferroviário; 4=Aéreo;
distancefloatSim13Distância da carga;
freightfloatSim13Frete da carga;
dispatchLimitTimeData/hora (string)Não29Data limite para o despacho da carga;Última janela de tempo possível para a carga;
stopsstop[]SimN/AElemento de agrupamento de todas as paradas de uma carga de uma viagem;Deverão haver pelo menos 2 paradas nesta lista;

stop, tipo de dado utilizado nas integrações do TOL

Nome

TipoObrigatórioTamanhoDescriçãoObservações
identifier (stop)intSim10ID da parada de uma carga de uma viagem;
localitySourceIdstringSim30ID da localidade da parada de uma carga de uma viagem;
transportZoneIdstringSim255ID da zona de transporte da parada de uma carga de uma viagem;
transportZoneDescriptionstringNão50Descrição da zona de transporte da parada de uma carga de uma viagem;


sequenceOnLoadintSim10Sequência da parada de uma carga de uma viagem;
subStopssubStop[]SimN/AElemento de agrupamento de todas as sub-paradas de uma carga de uma viagem;Deverá haver, pelo menos, 1 sub-parada para uma parada;

subStop, tipo de dado utilizado nas integrações do TOL

Nome

TipoObrigatórioTamanhoDescriçãoObservações
identifier (sub-stop)intSim10ID da sub-parada de uma carga de uma viagem;
arrivalTimeData/hora (string)Sim29Data planejada de chegada do veículo na sub-parada de uma carga de uma viagem;
startServiceTimeData/hora (string)Sim29

Data planejada de início do carregamento/descarregamento na sub-parada de uma carga de uma viagem;


endServiceTimeData/hora (string)Sim29

Data planejada de término do carregamento/descarregamento na sub-parada de uma carga de uma viagem;


departureTimeData/hora (string)Sim29Data planejada de partida do veículo da sub-parada de uma carga de uma viagem;
dockIdintNão10

ID da doca planejada de carregamento/descarregamento na sub-parada de uma carga de uma viagem;


dockDescriptionstringNão255

Descrição da doca planejada de carregamento/descarregamento na sub-parada de uma carga de uma viagem;


loadedShipmentUnitsSimN/AElemento de agrupamento das unidades de embarque que serão carregadas em uma parada de uma carga de uma viagem;Deverá haver pelo menos 1 unidade de embarque nesta lista;
unloadedShipmentUnitsshipmentUnit[]SimN/AElemento de agrupamento das unidades de embarque que serão descarregadas em uma parada de uma carga de uma viagem;Deverá haver pelo menos 1 unidade de embarque nesta lista;

shipmentUnit, tipo de dado utilizado nas integrações do TOL

Nome

TipoObrigatórioTamanhoDescriçãoObservações
identifier (shipment unit)intSim10ID da unidade de embarque de uma parada de uma carga de uma viagem;
shipmentUnitCategoryIdintSim1ID da categoria de invólucro da unidade de embarque;1=Pacote; 2=Granel não unitizável; 3=Pallet; 4=Granel unitizável; 5=Bobina; 6=Skid; 7=Tubo; 8=Feixe de tubos;
shipmentUnitDescriptionstringNão20Descrição da categoria de invólucro da unidade de embarque;BULK; BULK_UNIT, PACK; PALLET; DRUM; SKID; TUBE; TUBE_PACK;
shipmentUnitQtyfloatSim13Quantidade de unidades de embarque de uma parada de uma carga de uma viagem;
weightfloatSim13Peso das unidades de embarque de uma parada de uma carga de uma viagem;
volumefloatSim13Volume das unidades de embarque de uma parada de uma carga de uma viagem;
lengthfloatSim13Comprimento das unidades de embarque de uma parada de uma carga de uma viagem;
widthfloatSim13Largura das unidades de embarque de uma parada de uma carga de uma viagem;
heightfloatSim13Altura das unidades de embarque de uma parada de uma carga de uma viagem;
palletHeightTotalfloatSim13Altura máxima total das unidades de embarque de uma parada de uma carga de uma viagem;
deliveryUnitListdeliveryUnit[]SimN/AEntidade de agrupamento das unidades de entrega de uma parada de uma carga de uma viagem;Deverá haver pelo menos 1 unidade de entrega nesta lista;

deliveryUnit, tipo de dado utilizado nas integrações do TOL

Nome

TipoObrigatórioTamanhoDescriçãoObservações
identifier (delivery unit)stringSim30ID da unidade de entrega;
orderSourceIdstringSim30ID do pedido de transporte da unidade de entrega;
orderTypeSourceIdstringSim30Código do tipo do pedido;
orderItemSourceIdstringSim30ID do item de pedido de transporte da unidade de entrega;
productSourceIdstringSim30ID do produto da unidade de entrega;
sequenceCompositionintNão10

Sequência da composição do SKU da unidade de entrega (apenas para SKUs que são multi-volume);


quantityfloatSim13Quantidade das unidades de entrega;
pricefloatSim13Preço das unidades de entrega;
deliveryDateData/hora (string)Sim29Data planejada de entrega da unidade de entrega;
integrationSourcestringSim30ID da origem de dados;
classificationsclassifications []NãoN/AElemento de agrupamento de todas as classificações de uma unidade de entrega
attributes attributes[]NãoN/AElemento de agrupamento de todas os atributos de uma unidade de entrega

classifications, tipo de dado utilizado nas integrações do TOL

Nome

TipoObrigatórioTamanhoDescriçãoObservações
typestringSim255Tipo da classificação da viagem;
valuestringSim255Valor da classificação da viagem;

attributes, tipo de dado utilizado nas integrações do TOL

Nome

TipoObrigatórioTamanhoDescriçãoObservações
namestringSim255Nome do atributo da viagem;
valuestringSim255Valor do atributo da viagem;

Layout de Resposta

publishTenderedTripResponse, tipo de dado utilizado nas integrações do TOL
NomeTipoObrigatórioTamanhoDescriçãoObservações
publishTenderedTripResponsestringSim1

Mensagem de confirmação de recebimento da oferta da viagem para

"S" ou "N";

Catalogo de mensagens

CódigoMensagemDescrição

Anexos

  Arquivo Modificado
Arquivo TOL_oferta_viagem draw.io diagram 06 jul, 2021 by Julio Vinicius Oliveira dos Santos
Arquivo PNG TOL_oferta_viagem.png TOL_oferta_viagem exported to image 06 jul, 2021 by Julio Vinicius Oliveira dos Santos

  • Sem rótulos