Histórico da Página

Pickup

Image Added 1. Contexto de Negócio (Introdução)

Com a crescente demanda por otimização nos processos logísticos de distribuição na busca por um melhor aproveitamento dos veículos, tanto na questão de carregamento quanto na roteirização das entregas, tornou-se necessário proporcionar aos cliente

do TOTVS OMS uma solução para atender essas necessidades.

Visando esta solução foi realizada a integração entre o

TOTVS OMS da linha Protheus  com a funcionalidade TOTVS Otimização Logística por intermédio de arquivos no formato XML, utilizando os

WebServices existentes no TOL, sem transformação de mensagens e sem

a utilização de

Sistemas intermediários (TOTVS EAI, TOTVS ESB, entre outros).

Com esta integração, o

TOTVS OMS  passou a utilizar os recursos

do TOTVS Otimização Logística, o qual efetuará a roteirização e o arranjo das cargas com base na demanda de transportes enviados pelo TOTVS OMS, devolvendo para este as cargas montadas e roteirizadas.

Para a montagem de carga serão consideradas as configurações das restrições logísticas e as funções-objetivos de otimização registradas

no TOTVS Otimização Logística.

São exemplos de funções-objetivo:

• Máxima ocupação dos veículos.
• Diminuição dos prazos de entrega.
• Redução da quantidade de viagens.

Image Added 2. Sistemas Envolvidos

2.1. TOTVS OMS

A sigla OMS significa Order Management System, ou seja, gerenciamento de pedidos Pedidos e serviços que compreende as fases de captação, validação, avaliação, formação de carga e geração de mapa de separação ou, como é também conhecido, lista de separação.

Para obter mais detalhes sobre o OMS TOTVS, acesse a página no TDN: Gestão de Distribuição (SIGAOMS).

Cockpit Logístico Neolog

informações detalhadas, acesse a página TOTVS OMS. no TDN.

2.2. TOTVS OTIMIZAÇÃO LOGÍSTICA

É um Sistema O Cockpit Logístico é um sistema vertical desenvolvido pela Neolog, empresa do ecossistema TOTVS, que dispõe de módulos para Planejamento da Malha de Distribuição, Programação de Transportes e Monitoramento de Cargas.

Para obter mais detalhes sobre o Cockpit Logístico Neolog, acesse o link: informações detalhadas, acesse o link http://www.neolog.com.br/neolog-site/index.php/cockpit-logistico/

.

Image Added 3. Escopo

O escopo desta integração permitirá o envio dos pedidos de venda liberados (crédito / estoque) no TOTVS OMS para a formação das viagens no

TOL e o recebimento

destas viagens geradas no

TOTVS Otimização Logística, por meio de um XML no TOTVS OMS, para a geração das cargas.

Para complementar o escopo do envio dos pedidos será necessário enviar os cadastros envolvidos com as informações dos pedidos, como produtos, clientes, fornecedores, filiais, transportadoras e tipos de veículos.

Faz parte do processo de integração o recebimento das mensagens de publicação de viagens, reprogramação e cancelamento de viagens.

Image Added 4.

Pré-requisitos Instalação / Implantação / Utilização

Cockpit Logístico

4.1. TOTVS Otimização Logística

• TOL

  Cockpit Logístico

  na versão/release 5.6.1.

• Parâmetros de aquisição ativos (acesso pelo menu em Administração >

  Cockpit Logístico

  TOTVS Otimização Logística).

• Web Services ativos.

4.2. Protheus

• Protheus versão  12.1.17 ou superior.

• Parâmetros de integração com

  Cockpit Logístico

  o TOL configurados (acesso pelo menu em

  Atualizações > Cockpit Logístico > Parâmetros

  Atualizações > TOTVS Otimização Logística > Parâmetros Integração).

• Web Service Server para recebimento de mensagens do

  Cockpit Logístico

  TOL.

Image Added 5. Instalação / Configuração

5.1. Configuração Web Service AppServer Protheus

• Para que seja possível receber as viagens

  do Cockpit Logístico

  do TOTVS Otimização Logística é necessário configurar um Web Service no servidor de aplicação Protheus.

• É recomendado criar um Web Service com as seguintes configurações (modificando o arquivo Appserver.ini):

;Serviço webserver HTTP
[HTTP]
ENABLE=1
PATH=<Caminho_Cache_imagens>;C:\TOTVS\Prottheus\data\web
PORT=<porta>;8080
INSTANCES=<nInicio>,<nMaximo>;1,10
SESSIONTIMEOUT=60
INSTANCENAME=WS_HTTP
 
;URL de resposta
 [<ip ou nome>:<porta>/neolog]
ENABLE=1
PATH=<Caminho_Cache_imagens>;C:\TOTVS\Prottheus\data\web
ENVIRONMENT=<ambiente>
INSTANCENAME=WS_NEOLOG
RESPONSEJOB=JOB_WS_NEOLOG
DEFAULTPAGE=wsindex.apw
 
;JOB de resposta
[JOB_WS_NEOLOG]
TYPE=WEBEX
ENVIRONMENT=<ambiente>
INSTANCES=<nInicio>,<nMaximo>;1,10
INSTANCENAME=JOB_WS_NEOLOG
ONSTART=OMSXStart
ONCONNECT=OMSXConnect

• Para testar o serviço, inicie um navegador e digite: http://<ip ou nome>:<porta>/neolog/PublishReleasedTrip.APW?WSDL.

• Um WSDL (descrição do serviço em

  xml

  XML)

  deve ser

  será exibido no navegador..

• Para que seja possível reprogramar/cancelar as viagens

  do Cockpit Logístico

  do TOTVS Otimização Logística é necessário configurar as informações de conexão com o DBAccess diretamente na seção [Environment] (modificando o arquivo Appserver.ini), conforme exemplo abaixo:

;Nome do Ambiente acessado pelo Web Service
[Environment]
SourcePath=C:\Totvs\Protheus\Apo
RootPath=C:\Totvs\Protheus\Data
StartPath=\system\
. . . ; outras chaves
DBDatabase=MSSQL
DBAlias=PLS101
DBServer=192.168.1.20
DBPort=7890

• Para evitar

  erros

  inconsistências do tipo Failed Handshake

  SSL recomenda

  SSL recomenda-se incluir a seguinte configuração no

  appserver

  Appserver.ini:

[SSLConfigure]
TryProtocols=1
Verbose=1

5.2. Parametrização TOTVS Otimização Logística

Para configurar o envio de viagens do

TOL para o Web Service Protheus, acesse

o TOL e execute os seguintes passos:

1. Administração > Integração, selecione a pasta Fontes de Dados e clique em Inserir.
2. Digite o código, a descrição e o código da base (Sugestãosugestão: PROTHEUS).
3. Seção Cancelamento de Viagem Liberada

• • No campo URL,  digite digite http://<ip ou nome>:<porta>/neolog/CancelService.APW.
  • No campo Tempo Máximo de Espera por Resposta, informe o timeout do serviço (recomendado 30000).

4. Seção Execução da Viagem

• • No campo URL, digite: NA (Não Atribuído).
  • No campo Tempo Máximo de Espera por Resposta, informe o timeout do serviço (recomendado 1000).

5. Seção Solicitação de liberação de Viagem

• • No campo URL, digite http://<ip ou nome>:<porta>/neolog/PublishReleasedTrip.APW.
  • No campo Tempo Máximo de Espera por Resposta, informe o  timeout do timeout do serviço (recomendado 30000).

6. Seção Solicitação de Reprogramação de Viagem

• • No campo URL, digite: http://<ip ou nome>:<porta>/neolog/ReprogramService.APW.
  • No campo Tempo Máximo de Espera por Resposta, informe o timeout do o timeout do serviço (recomendado 30000).

7. Clique em Salvar.

5.3. Parametrização TOTVS OMS

• Acesse o menu Atualizações >

   CockPit Logístico > 

   TOTVS Otimização Logística > Parâmetros Integração (OMSXCPL1).

• Para o correto funcionamento da integração, parametrize o Protheus da seguinte forma:

Parametrização Adicional Integração

• Algumas parametrizações da integração devem ser realizadas no arquivo de configuração do do servidor Protheus (Appserver.ini), pois são utilizadas antes de iniciar qualquer processo de conexão com o SGDB.
• As configurações abaixo devem ser incluídas no arquivo na seção [NEOLOG]:

;Configuração integração com o Cockpit Logístico
[NEOLOG]
DefaultCompany=<empresa>
Debug=1
DebugPath=<caminho relativo> ;logs\neolog

Onde:

Integração OMS Protheus x Cockpit Logístico Neolog (Planejamento)Controle de Versão

O grupo TOTVS, representado por suas marcas, administrará as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Integração OMS Protheus x Cockpit Logístico Neolog (Planejamento)Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim, as equipes de suporte dos produtos BackOffice Protheus estarão aptas a efetuar a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

5.4. Parametrização Adicional Integração

• Algumas parametrizações da integração devem ser realizadas no arquivo de configuração do servidor Protheus (Appserver.ini), pois são utilizadas antes de iniciar qualquer processo de conexão com o SGDB.

• As configurações abaixo devem ser incluídas no arquivo na seção [NEOLOG]:

Configuração integração com o TOTVS Otimização Logística:
[NEOLOG]
DefaultCompany=<empresa>
Debug=1
DebugPath=<caminho relativo> ;logs\neolog

Onde:

• DefaultCompany
  Empresa padrão para integração entre o TOTVS OMS e o TOTVS Otimização Logística.
  Se não for informado não será considerado, sendo sempre enviada nas mensagens nos campos que identificam os códigos, além do próprio código, a concatenação da empresa e do campo Filial do respectivo cadastro/processo.
  Caso esteja parametrizada será enviada apenas a concatenação do código com campo Filial do respectivo cadastro/processo. Clique aqui para obter mais detalhes.
  
  

  Informações
  title Dados da Filial Protheus
  Será verificado no cadastro de Filiais Protheus se utiliza o conceito de Gestão de Empresas, será enviado ao invés de Empresa/Filial o modelo Empresa/Unidade/Filial. Exemplo: M SP 01

• Debug
  Indicador de que o processo de gravação dos arquivos XML das mensagens trocadas entre o TOTVS OMS e o TOL está ativo.
  Caso esteja com o valor 1, será considerado ativo; caso contrário, será considerado inativo.
  Caso esta configuração não exista será assumido, por padrão, que o Debug está ativo.
  
  

• DebugPath
  Caminho onde serão gravados os arquivos de log do XML, o qual deve ser sempre relativo a pasta RootPath, pois o processo de integração pode rodar em modo JOB e, desta forma, não tem acesso a diretórios locais da máquina.
  Caso não esteja parametrizado será considerado o caminho padrão system/neolog.
  
  

Image Added 6. Controle de Versão

O Grupo TOTVS, representado por suas marcas, administrará as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas devem ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Image Added 7. Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim, as equipes de suporte dos produtos BackOffice Protheus estarão aptas a efetuar a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Image Added 8. Mensagens

Integração OMS Protheus x Cockpit Logístico Neolog (Planejamento)Mensagens

Image Added 9. Fluxo das Informações

Os cadastros devem ser realizados

no TOTVS OMS

e integrados

ao TOTVS Otimização Logística.

A ativação da integração, no entanto, não impede a inclusão, alteração e exclusão de registros no

TOL, mas esse procedimento não é recomendado, pois as operações realizadas sobre os cadastros no

TOL não são replicadas para os respectivos cadastros no Protheus.

Apenas as operações de inclusão e alteração são consideradas na integração e são efetuadas sempre que ocorrerem, desde que parametrizadas para serem on-line.

A operação de eliminação sobre os registros de cadastros não é integrada, pois não é possível verificar a integridade referencial no sistema de destino para considerá-la como restrição de eliminação dos registros no Protheus.

O sucesso das operações de inclusão e alteração de registros pode ser verificado acessando o programa de consulta no menu do

TOL em: Interface - Log.

O sistema de origem dos dados não recebe o status do processamento dos registros enviados, por isso, considera integrado com base apenas na confirmação de recepção da mensagem de integração.

9.1. Filiais

• Tipo de Fluxo: Protheus > Cockpit LogísticoProtheus > TOTVS Otimização Logística.

• Mensagem: LocalityAcquisitionService

• O envio de empresas/filiais não O envio de empresas/filiais ou empresas/unidade/filiais não é automático, ou seja, ao cadastrar no Protheus uma nova empresa/filial, para que essas informações sejam replicadas para o Cockpit Logístico TOTVS Otimização Logística é necessário executar a carga de dados disponível em:   SIGAOMS > Atualizações > TOTVS Otimização Logística > Cockpit Logístico > Carga de dados, assinalando a opção SM0 - Cadastro de Filiais.

• Os dados serão enviados ao Cockpit Logístico ao TOTVS Otimização Logística por meio do método updateLocalities.

• Esses dados, por sua vez, serão salvos como localidade e poderão ser visualizados no CPL em: Cadastro > Localidades.
  
  

9.2. Clientes

• Tipo de Fluxo: 

  Protheus > Cockpit Logístico

  Protheus > TOTVS Otimização Logística.

• Mensagem: LocalityAcquisitionService

• Ao cadastrar um cliente no Protheus, quando a integração estiver ativa os dados serão enviados

  ao Cockpit Logístico

  ao TOTVS Otimização Logística por meio do método updateLocalities.

• Esses dados, por sua vez, serão salvos como localidade e poderão ser visualizados no

  CPL

  TOL em: Cadastro > Localidades.

• Fornecedores

• Tipo de Fluxo: 

  Protheus > Cockpit Logístico

  Protheus > TOTVS Otimização Logística.

• Mensagem: LocalityAcquisitionService ou CarrierAcquisitionService

• Ao cadastrar um fornecedor no Protheus, quando a integração estiver ativa os dados serão enviados

  ao Cockpit Logístico

  ao TOTVS Otimização Logística por meio do método updateLocalities (conforme parametrização do cadastro SA2, de acordo com o comentado acima).

• Esses dados, por sua vez, serão salvos como localidade e poderão ser visualizados no

  CPL

  TOL em: Cadastro > Localidades.

9.3. Transportadores

• Tipo de Fluxo:

   Protheus > Cockpit Logístico

   Protheus > TOTVS Otimização Logística.

• Mensagem: CarrierAcquisitionService

• Ao cadastrar um transportador no Protheus, quando a integração estiver ativa os dados serão enviados

  ao Cockpit Logístico

  ao TOTVS Otimização Logística por meio do método CarrierAcquisitionService.

• Esses dados, por sua vez, serão salvos como transportadoras e poderão ser visualizados no

  CPL

  TOL em: Cadastro > Transportadoras.

9.4. Produtos

• Tipo de Fluxo: Protheus > Cockpit Logístico Protheus > TOTVS Otimização Logística.
• Mensagem: ProductAcquisitionService
• Ao cadastrar um produto no Protheus, quando a integração estiver ativa os dados serão enviados ao Cockpit Logístico por TOTVS Otimização Logística por meio do método ProductAcquisitionService.
• Esses dados, por sua vez, serão salvos como produtos simples e poderão ser visualizados no CPL TOL em: Cadastro > Produtos Simples.

9.5. Tipos de Veículo

• Tipo de Fluxo:

   Protheus > Cockpit Logístico

   TOTVS Otimização Logística

• Mensagem: VehicleAcquisitionService

• Ao cadastrar um tipo de veículono Protheus, quando a integração estiver ativa os dados serão enviados ao

  Cockpit Logístico

  TOTVS Otimização Logística por meio do método VehicleAcquisitionService.

• Esses dados, por sua vez, serão salvos como veículos e poderão ser visualizados no

  CPL

  TOL em: Cadastro > Veículos.

9.6. Pedidos de Venda

• Tipo de Fluxo: Protheus > Cockpit LogísticoProtheus > TOTVS Otimização Logística
• Mensagem: OrderAcquisitionService

Image Added 10. Detalhamento das Mensagens

10.1. Mensagem de Integração dos Registros do Cadastro de Filiais

10.2. Mensagem de Integração dos Registros do Cadastro de Clientes

10.3. Mensagem de Integração dos Registros do Cadastro de Fornecedor Como Localidade

10.4. Mensagem de Integração dos Registros do Cadastro de Fornecedor Como Transportadora

10.5. Mensagem de Integração dos

Image Added 12. Funcionalidades Não Contempladas

¹ _{É possível que uma viagem no}

Image Added14. Quebras de Pedidos 

A integração encontra-se preparada para tratar a realização de quebras no pedido

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<soap:Body>
		<ns2:publishReleasedTrip xmlns:ns2="urn:neolog:cockpit:TripReleaseRequestPublishingService">
			<messageId>10082</messageId>
			<orderBreakParts>
				<orderBreakPart>
					<regionSourceId>DEFAULT</regionSourceId>
					<orderBreakPartId>81</orderBreakPartId>
					<orderSourceId>0101-000002-PED169</orderSourceId>
					<orderTypeSourceId>Padrao</orderTypeSourceId>
					<orderItemSourceId>0101-000002-PED169-01</orderItemSourceId>
					<loadId>1097</loadId>
					<shipmentUnitId>1</shipmentUnitId>
					<quantShipmUnits>10.0</quantShipmUnits>
					<quantProdUnits>10.0</quantProdUnits>
				</orderBreakPart>
			</orderBreakParts>
			<tripReleaseRequests>
				<tripReleaseRequest>
					<regionSourceId>DEFAULT</regionSourceId>
					<identifier>50316</identifier>
					<freightValue>0.0</freightValue>
					<carrierId>DEF</carrierId>
					<vehicleId>Padrao</vehicleId>
					<vehicleDescription>Veículo Padrão</vehicleDescription>
					<loads>
						<load>
							<identifier>1097</identifier>
							<serviceTypeId>1</serviceTypeId>
							<serviceTypeDescription>FULL_TRUCK_LOAD</serviceTypeDescription>
							<loadMode>2</loadMode>
							<modal>1</modal>
							<distance>460.92184</distance>
							<freight>0.0</freight>
							<stops>
								<stop>
									<identifier>1234</identifier>
									<localitySourceId>FIL-01-01</localitySourceId>
									<transportZoneId>Agrupador Padrão.ZT</transportZoneId>
									<transportZoneDescription>Agrupador Padrão.ZT</transportZoneDescription>
									<sequenceOnLoad>1</sequenceOnLoad>
									<subStops>
										<subStop>
											<identifier>1288</identifier>
											<arrivalTime>2019-07-15T00:01:00.000-03:00</arrivalTime>
											<startServiceTime>2019-07-15T00:01:00.000-03:00</startServiceTime>
											<endServiceTime>2019-07-15T00:16:00.000-03:00</endServiceTime>
											<departureTime>2019-07-15T00:16:00.000-03:00</departureTime>
											<loadedShipmentUnits>
												<shipmentUnit>
													<identifier>1494</identifier>
													<shipmentUnitCategoryId>1</shipmentUnitCategoryId>
													<shipmentUnitDescription>Fardo</shipmentUnitDescription>
													<shipmentUnitQty>10.0</shipmentUnitQty>
													<weight>10.0</weight>
													<volume>0.3025</volume>
													<length>0.55</length>
													<width>0.25</width>
													<height>0.22</height>
													<palletHeightTotal>0.0</palletHeightTotal>
													<deliveryUnitList>
														<deliveryUnit>
															<identifier>1494</identifier>
															<orderSourceId>0101-000002-PED169</orderSourceId>
															<orderTypeSourceId>Padrao</orderTypeSourceId>
															<orderItemSourceId>0101-000002-PED169-01</orderItemSourceId>
															<productSourceId>OMS001-0101</productSourceId>
															<quantity>10.0</quantity>
															<price>100.0</price>
															<deliveryDate>2019-07-15T00:16:00.000-03:00</deliveryDate>
															<integrationSource>DEFAULT</integrationSource>
														</deliveryUnit>
													</deliveryUnitList>
												</shipmentUnit>
											</loadedShipmentUnits>
										</subStop>
									</subStops>
								</stop>
								<stop>
									<identifier>1235</identifier>
									<localitySourceId>CLI-000001-01-01</localitySourceId>
									<transportZoneId>Agrupador Padrão.ZT</transportZoneId>
									<transportZoneDescription>Agrupador Padrão.ZT</transportZoneDescription>
									<sequenceOnLoad>2</sequenceOnLoad>
									<subStops>
										<subStop>
											<identifier>1289</identifier>
											<arrivalTime>2019-07-15T00:16:00.000-03:00</arrivalTime>
											<startServiceTime>2019-07-15T00:16:00.000-03:00</startServiceTime>
											<endServiceTime>2019-07-15T00:31:00.000-03:00</endServiceTime>
											<departureTime>2019-07-15T00:31:00.000-03:00</departureTime>
											<unloadedShipmentUnits>
												<shipmentUnit>
													<identifier>1494</identifier>
													<shipmentUnitCategoryId>1</shipmentUnitCategoryId>
													<shipmentUnitDescription>Fardo</shipmentUnitDescription>
													<shipmentUnitQty>10.0</shipmentUnitQty>
													<weight>10.0</weight>
													<volume>0.3025</volume>
													<length>0.55</length>
													<width>0.25</width>
													<height>0.22</height>
													<palletHeightTotal>0.0</palletHeightTotal>
													<deliveryUnitList>
														<deliveryUnit>
															<identifier>1494</identifier>
															<orderSourceId>0101-000002-PED169</orderSourceId>
															<orderTypeSourceId>Padrao</orderTypeSourceId>
															<orderItemSourceId>0101-000002-PED169-01</orderItemSourceId>
															<productSourceId>OMS001-0101</productSourceId>
															<quantity>10.0</quantity>
															<price>100.0</price>
															<deliveryDate>2019-07-15T00:16:00.000-03:00</deliveryDate>
															<integrationSource>DEFAULT</integrationSource>
														</deliveryUnit>
													</deliveryUnitList>
												</shipmentUnit>
											</unloadedShipmentUnits>
										</subStop>
									</subStops>
								</stop>
							</stops>
						</load>
					</loads>
				</tripReleaseRequest>
			</tripReleaseRequests>
		</ns2:publishReleasedTrip>
	</soap:Body>
</soap:Envelope>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
	<soapenv:Header/>
	<soapenv:Body>
		<unb:doUnblockReleasedTrip xmlns:unb="http://www.neolog.com.br/cpl/acquisition/unblockRelTrip/" xmlns:erp="http://www.neolog.com.br/cpl/acquisition/eRPMessageResponse/" xmlns:ord="http://www.neolog.com.br/cpl/acquisition/orderBreakRemovalRequest/" xmlns:ord1="http://www.neolog.com.br/cpl/acquisition/orderBreakId/" xmlns:ord2="http://www.neolog.com.br/cpl/acquisition/orderBreakResponse/" xmlns:trip="http://www.neolog.com.br/cpl/acquisition/tripReleaseResponse/" xmlns:trip1="http://www.neolog.com.br/cpl/acquisition/tripLoadsSourceId/">
			<unb:unblockReleasedTrips>
				<unb:unblockReleasedTrips>
					<unb:unblockReleasedTrip>
						<unb:identifier>10082</unb:identifier>
						<unb:regionSourceId>DEFAULT</unb:regionSourceId>
						<unb:orderBreakResponses>
							<ord2:orderBreakResponses>
								<ord2:orderBreakResponse>
									<ord2:breakId>81</ord2:breakId>
									<ord2:orderId>0101-000002-PED169-81</ord2:orderId>
									<ord2:orderItemId>0101-000002-PED169-81-01</ord2:orderItemId>
									<ord2:regionSourceId>DEFAULT</ord2:regionSourceId>
									<ord2:status>1</ord2:status>
								</ord2:orderBreakResponse>
							</ord2:orderBreakResponses>
						</unb:orderBreakResponses>
						<unb:tripReleaseResponses>
							<trip:tripReleaseResponseList>
								<trip:tripReleaseResponses>
									<trip:tripReleaseResponse>
							</ord2:orderBreakResponses>
						</unb:orderBreakResponses>
						<unb:tripReleaseResponses>
							<trip:tripReleaseResponseList>
								<trip:tripReleaseResponses>
									<trip:tripReleaseResponse>
										<trip:itemId>0101-000002-PED169-01         </trip:itemId>
										<trip:orderSourceId>0101-000002-PED169            </trip:orderSourceId>
										<trip:regionSourceId>DEFAULT</trip:regionSourceId>
										<trip:status>1</trip:status>
										<trip:tripCode>50316</trip:tripCode>
									</trip:tripReleaseResponse>
								</trip:tripReleaseResponses>
							</trip:tripReleaseResponseList>
						</unb:tripReleaseResponses>
					</unb:unblockReleasedTrip>
				</unb:unblockReleasedTrips>
			</unb:unblockReleasedTrips>
		</unb:doUnblockReleasedTrip>
	</soapenv:Body>
</soapenv:Envelope>

										<trip:itemId>0101-000002-PED169-01         </trip:itemId>
										<trip:orderSourceId>0101-000002-PED169            </trip:orderSourceId>
										<trip:regionSourceId>DEFAULT</trip:regionSourceId>
										<trip:status>1</trip:status>
										<trip:tripCode>50316</trip:tripCode>
									</trip:tripReleaseResponse>
								</trip:tripReleaseResponses>
							</trip:tripReleaseResponseList>
						</unb:tripReleaseResponses>
					</unb:unblockReleasedTrip>
				</unb:unblockReleasedTrips>
			</unb:unblockReleasedTrips>
		</unb:doUnblockReleasedTrip>
	</soapenv:Body>
</soapenv:Envelope>

Image Added15. Pontos de Entrada Relacionados

• DT PE OMSCPL6A - Permite alterar validações na desatualização de pedidos do TOL

• DT PE OMSCPL6B - Permite inserir validações no envio do pedido para o TOL

• DT PE OMSCPL7C - Permite a manipulação da carga gerada para viagem TOL

• DT PE OMSCPLAV - Permite a manipulação das tabelas da viagem (DK0 e DK1)

• DT PE OMSXCPL1 - Permite alterar o XML antes do envio para o TOL

• DT PE OSCP6QRY - Filtro dos pedidos que serão exibidos na rotina de Envio de Pedido para o TOL

• DT PE OMSTOL01 - Permite interromper a inclusão/alteração de registros das tabelas relacionadas ao processo de liberação de viagens pelo TOL (Totvs Otimização Logística)

Image Added16. Teste de Conexão Fora do Protheus

Para verificar se o problema de conexão está no Protheus ou no TOTVS Otimização Logística, é possível realizar uma requisição para o servidor do TOL por uma ferramenta externa, exemplo: SoapUI, Postman, entre outras.

Para tanto, é possível utilizar a Endereço WebService de Autenticação, informado no parâmetro MV_CPLUAUT, junto com os usuário e senha de acesso,

Exemplo

• Tipo de requisição: POST
• URL: URL Informada no parâmetro MV_CPLUAUT
• Body da requisição: 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:aut="http://www.neolog.com.br/cpl/gateway/authentication/">
<soapenv:Header/>
<soapenv:Body>
	<aut:credentials>
		<username>[email protected]</username>
		<password>ABC123</password>
	</aut:credentials>
</soapenv:Body>
</soapenv:Envelope>

O TOTVS Otimização Logística retornará com a informação do token de acesso.

Exemplo

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns3:authenticationToken xmlns:ns3="http://www.neolog.com.br/cpl/gateway/authentication/">
            <successful>true</successful>
            <token>f28b0bc763d1481aaa7f714c43660196</token>
        </ns3:authenticationToken>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Image Added17. Validação de XMLS

Para impedir que ocorram inconsistência no Protheus por XMLS mal formatados, foi desenvolvida a funcionalidade de validar XMLS, baseadas em XSD.

Ao consumir o WebService do Protheus com as mensagens de Liberação de Viagem (publishReleasedTripService), Reprogramação de Viagem (publishReprogrammingService) e Cancelamento de Viagem (publishCancelService), os XMLS passarão por uma pré-validação de estrutura.

17.1. Estrutura Para Pré-validação

Inclua a pasta xsd dentro da system, com os seguintes arquivos:

• envelope.xsd

• publishCancelService.xsd

• publishReleasedTripService.xsd

• publishReprogrammingService.xsd

Image Added

17.1. Falhas de Estrutura

As falhas ocorridas durante o processo serão retornadas para o XML de Resposta e/ou Log Appserver:

• XXXX-XX-XXT09:39:25.122000-03:00 10084|OMSXWS > OMSValXSD > Verificando as configurações de validação de XML baseada em Schema XSD.

• XXXX-XX-XXT09:39:25.123000-03:00 10084|OMSXWS > OMSValXSD > Validação do XML de entrada através de XSD não executada por não existir o diretório \system\xsd com os xsds no servidor.

• XXXX-XX-XXT09:39:25.123000-03:00 10084|OMSXWS > OMSValXSD > Análise das configurações de validação de baseada em Schema XSD concluída.

• XXXX-XX-XXT09:39:43.890000-03:00 10084|OMSXWS > OMSXConnect > Conteúdo de cErro: Opening and ending tag mismatch: ns2:publishReprogrammingService line 1 and tagParaErro:

• Opening and ending tag mismatch: soap:Body line 1 and ns2:publishReprogrammingService

• Opening and ending tag mismatch: soap:Envelope line 1 and soap:Body

• Extra content at the end of the document

17.2. Falha na Liberação da Viagem

Caso ocorra falha na liberação da viagem, será retornado "N" para a Neolog-TOL e a inconsistência de estrutura estará no log do Protheus:

Image Added

17.3. Falha de Reprogramação ou Cancelamento

Se forem falhas de reprogramação ou cancelamento será retornada a inconsistência no XML de resposta e também para o log:

Image Added

17.4. Se Não Estiver Habilitado

Estas mensagens serão exibidas no log e processo de validação será descartado:

• XXXX-XX-XXT10:42:29.347000-03:00 10292|OMSXWS > OMSValXSD > Verificando as configurações de validação de XML baseada em Schema XSD.
• XXXX-XX-XXT10:42:29.347000-03:00 10292|OMSXWS > OMSValXSD > Validação do XML de entrada através de XSD não executada por não existir o diretório \system\xsd com os XSDS no servidor.
• XXXX-XX-XXT10:42:29.347000-03:00 10292|OMSXWS > OMSValXSD > Análise das configurações de validação de baseada em Schema XSD concluída.

Image Added 18. Geração de Logs

18.1. Função Para Gerar Mensagens Auxiliares Para o Log

Para auxiliar na análise de inconsistências foi desenvolvida uma função para gerar mensagens auxiliares para o log, sendo que ela insere informações como queries e conteúdos de variáveis.
Para habilitar são necessários três parâmetros em todos os ambientes:

LOGCPLOMS=.T.
FWFRAME_TRACELOG=1
LOGTIPOMS=CONSOLE

• O terceiro parâmetro, LOGTIPOMS, define a forma de saída das mensagens.
• Para separar as mensagens e salvar com o nome de omscpl.log dentro da pasta system, informe ARQUIVO.
• Para salvar no log do Appserver (console.log), não coloque o parâmetro LOGTIPOMS no Appserver.ini ou informe como LOGTIPOMS=CONSOLE

Integração OMS Protheus x Cockpit Logístico Neolog (Planejamento) Pontos de Entrada Relacionados

• OMSCPL6A - Permite Alterar Validações na Desatualização de Pedidos do CPL
• OMSCPL6B - Permite Inserir Validações no Envio do Pedido Para o Cockpit Logístico
• OMSCPL7C - Permite a Manipulação da Carga Gerada Para a Viagem CPL
• OMSCPLAV - Permite a Manipulação das Tabelas da Viagem (DK0 e DK1)
• OMSXCPL01 - Permite Alterar o XML Antes do Envio Para o Cockpit Logístico
• OSCP6QRY - Filtro dos Pedidos Que Serão Exibidos na Rotina de Envio de Pedido Para o CPL (OMSXCPL6)