Réplica Integração OMS Protheus x Cockpit Logístico Neolog

Aviso

title	DOCUMENTO OBSOLETO!

Para obter informações atualizadas acesse o Documento de Integração: DI LOGTMS01-69 Integração OMS Protheus x Cockpit Logístico Neolog

...

Integrar o módulo de Gestão de Distribuição (SIGAOMS) com a funcionalidade Programação de Transportes do Cockpit Logístico da Neolog por Neolog por intermédio de arquivos no formato XML, utilizando os Web Services já existentes do Cockpit Logístico, sem transformação de mensagens e sem a utilização de sistemas intermediários (TOTVS EAI, TOTVS ESB, entre outros).

Para esta integração foram consideradas as alterações necessárias para que o planejamento das montagens de cargas do módulo Gestão de Distribuição (SIGAOMS) da linha Microsiga Protheus, utilize os recursos de Programação de Transportes do Cockpit Logístico. A Programação de Transportes fará a roteirização e o arranjo das cargas com base na demanda de transportes enviadas pelo módulo SIGAOMS considerando as configurações das restrições logísticas e as funções-objetivos de otimização registradas no Cockpit Logístico. São exemplos de funções-objetivo: Máxima ocupação dos veículos, Diminuição dos prazos de entrega e Redução da quantidade de viagens.
Para tanto, são utilizados os cadastros básicos já disponibilizados na integração entre o SIGATMS x Cockpit Logístico, sendo eles:

Produto;
Filial;
Cliente;
Tipo de veículo;
Fornecedores;
Transportadoras.

Além dos cadastros, foi realizada a integração dos pedidos de venda que utilizam as "Cargas". Os pedidos de venda são enviados para o Cockpit Logístico gerando "Pedidos de Transportes", para estes, o Cockpit Logístico realiza a análise e geração da viagem.

...

Entidade	Pontos de Integração
Transportadora	Cadastro de Transportadoras. Edição Transportadoras.
Fornecedor	Cadastro de Fornecedores. Edição de Fornecedor.
Tipo de Veículo	Cadastro de Tipo Veículo. Edição de Tipo Veículo.
Cliente	Cadastro de Cliente. Edição de Cliente.
Empresas/Filiais	Cadastro de Empresas/Filiais. Edição de Empresas/Filiais.
Produto	Cadastro de Produto. Edição de Produto.
Pedidos de Venda	Envio dos Pedidos de Vendas ao Cockpit Logístico. Cancelamento dos Pedidos de Vendas.
Montagem de Carga	Geração da viagem no Cockpit Logístico. Liberação da Viagem no Cockpit Logístico. Montagem de cargas OMS. Liberar Viagem no OMS.

Pré-requisitos

...

Para a Instalação / Implantação / Utilização

Cockpit Logístico

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).
Web Services ativos.

Protheus

Protheus versão / release 12.1.17 ou superior.
Parâmetro de integração com Cockpit Logístico ativo (MV_CPLINT == .T.).
Web Service de integração válido informado (MV_CPLURL).

Todos os parâmetros citados encontram-se no programa Parâm Integração (OMSXCPL1), que pode ser acessado pelo menu Atualizações - Atualizações > Cockpit Logístico.

Informações

title	Atenção:!

Não é escopo desse documento descrever a instalação do ERP Protheus e do Cockpit Logístico Neolog, nem suas configurações básicas.

Para ver visualizar o documento técnico referente Documento Técnico referente a esta integração, utilize este link: DT_LOGTMS01-512 - RÉPLICA _IINTEGRAÇÃO_OMS_X_COCKPIT_LOGÍSTICO_NEOLOG.

Para que a integração possa funcionar corretamente, o ambiente deve conter o módulo SIGAOMS e o Cockpit Logístico devidamente configurados.

Parametrização SIGAOMS

Por meio do menu Atualizações > CockPit Logístico > Param Integração (OMSXCPL1) , deve ser parametrizado o Protheus, para o correto funcionamento da integração, conforme abaixo:

Onde:

Titulo	Descrição	Parâmetro	Opções	Valor para Integração	Validação
Integração Cockpit Logístico?	Indica se a integração com o cockpit logístico está ativa.	MV_CPLINT		Sim / 1
Integração Suspensa?	Identifica se o Módulo do OMS não

esta

está integrado temporariamente aos outros módulos.	MV_CPLSTP		Não / 2
Integrar Clientes On line?	Salvar os dados dos clientes criados no Protheus automaticamente no Cockpit Logístico.	MV_CPLCLI		Sim / 1
Integrar Fornecedores On line?	Salvar os dados dos fornecedores criados no Protheus automaticamente no Cockpit Logístico (Localidades).	MV_CPLFOR		Sim / 1
Integrar Transportadora On line?	Salvar os dados das transportadoras criadas no Protheus automaticamente no Cockpit Logístico.	MV_CPLTRA		Sim / 1
Integrar Produtos On Line?	Salvar os dados dos produtos criados no Protheus automaticamente no Cockpit Logístico.	MV_CPLPRO		Sim / 1
Integrar Tipos de Veículos On Line?	Salvar os dados dos tipos de

veiculos

veículos criados no Protheus automaticamente no Cockpit Logístico.	MV_CPLTPV		Sim / 1
Endereço WebService	Endereço do

webservice

WebService do Cockpit Logístico.	MV_CPLURL		Conforme cliente	Deve ser obrigatoriamente preenchido quando MV_CPLINT == "1"
Regional	Regional enviada para o Cockpit Logístico.	MV_CPLREG		Conforme cliente	Deve ser obrigatoriamente preenchido quando MV_CPLINT == "1"
Embarcador	Código de um Embarcador do Cockpit Logístico. Todos os Produtos integrados do módulo OMS para o Cokpit Logístico serão relacionados a um mesmo Embarcador no Cockpit Logístico, pois no OMS a relação variável de produto x cliente é utilizada (opcionalmente) apenas na importação de Notas Fiscais de Cliente pelo EDI.	MV_CPLEMB		Conforme cliente	Deve ser obrigatoriamente preenchido quando MV_CPLINT == "1"
Categoria de Produto?	Para o Cockpit Logístico categorias de Produto, são agrupamentos relevantes de produtos com características logística semelhantes. Com esse parâmetro pode-se determinar se a categoria dos produtos integrados do OMS para o Cockpit Logístico (1=Grupo Produto) será o código do grupo do produto do OMS ou (2=Padrão Cockpit) se será informada por alteração manual em cada produto no Cockpit Logístico. Com a opção, deve-se cadastrar as Categorias de Produtos no Cockpit Logístico com os mesmos códigos dos Grupos de Produtos do OMS, pois não há Web Serivce de integração para essa tabela.	MV_CPLCAT	1=Grupo Produto; 2=Padrao Cockpit.	2=Padrao Cockpit.
Invólucro Padrão	Código de um Invólucro (~ embalagem) do Cockpit Logístico. Todos os itens de Pedidos de Transporte recebidos do OMS no Cockpit Logístico, serão associados a esse invólucro pois não há uma entidade no OMS que corresponda exata e obrigatoriamente a esse dado do Cockpit Logístico. Recomenda-se informar um invólucro cujas medidas sejam obtidas do item do pedido (essa característica é parametrizada no Cockpit Logístico).	MV_CPLINV		Conforme cliente
Origem dos Dados	Define o nome do ERP que da origem aos dados enviados ao Cockpit Logístico.	MV_CPLIDS		Protheus	Deve ser obrigatoriamente preenchido quando MV_CPLINT == "1"
E-mail do Administrador	E-mail do administrador para as notificações de falha de conexão.	MV_CPLMAL		Conforme cliente
Modo Debug?	Salva as mensagens enviadas e recebidas na pasta do log.	MV_CPLDBG
Caminho da Pasta de Mensagens	Caminho do log de mensagens. Recomendado utilizar o caminho relativo a \system.	MV_CPLLOG		O diretório informado deve seguir o padrão do sistema operacional. Exemplo Windows: \system Exemplo Linux: /system
Liberação automática da viagem?	O uso deste parâmetro ocorre somente para o SIGAOMS. Quando habilitado, ao realizar a geração das NFs de Saída, automaticamente o sistema irá realizar o envio da liberação de viagens no Cockpit Logístico.	MV_CPLLVA		Sim / 1
Tipo Veículo Otimização?	Quando for 1 = Impedir: No vinculo do veículo na carga se o usuário informar um tipo de veículo diferente do que consta na viagem do CPL, não permitimos apresentando um Help. Se for 2 = Alertar: O sistema avisa que o tipo informado é diferente do tipo da viagem no CPL e o usuário define se permite o vinculo ou não.	MV_CPLTVO	1=Impedir;2=Alertar	Alterar / 2
Geração das cargas	Quando for 1 = Automático: Para as viagens vindas do CPL, o SIGAOMS gera a carga automaticamente. Quando for 2 = Manual: Para as viagens deve ser gerada manualmente a carga.	MV_CPLAUT	1=Automático;2=Manual	Manual / 2

Informações

title	Uso de Protocolo de segurança HTTPS

Os parâmetros na tabela abaixo devem ser preenchidos apenas se o cliente for fazer uso do utilizar o protocolo de segurança HTTPS para integração com a NEOLOG, sendo necessário configurar o APPSERVER do Protheus.

Para obter mais informações consulte os links:

http://tdn.totvs.com.br/pages/viewpage.action?pageId=135496188

, http://tdn.totvs.com.br/pages/viewpage.action?pageId=6064865

Título	Descrição	Parâmetro	Tipo	Conteúdo	Opções
Endereço do web service de autenticação	Endereço do web service de autenticação	MV_CPLUAUT	Caractere		Dever ser preenchido pelo usuário
Armazena o token recuperado	Armazena o token recuperado da autenticação com a Neolog	MV_TOKCPL	Caractere		Preenchimento automático pelo sistema
Armazena a data / hora da última recuperação de token	Armazena a data / hora da última recuperação de token	MV_DTTOK	Caractere		Preenchimento automático pelo sistema
Quantidade de horas para considerar que um token expirou	Quantidade de horas para considerar que um token expirou	MV_EXPTOK	Numérico	24	Deve ser preenchido pelo usuário, conteúdo em horas. O token possui validade máxima de 24 horas.
Usuário de autenticação do web service	Usuário de autenticação do web service	MV_USRCPL	Caractere		Deve ser preenchido pelo usuário
Senha de autenticação do web service	Senha de autenticação do web service	MV_PSWCPL	Caractere		Deve ser preenchido pelo usuário

...

Parametrização appServer.ini exemplo de uso para configuração com o protocolo HTTP:

Para que seja possível receber as viagens do Cockpit Logístico , é necessário configurar um WebService no appserver.ini Protheus.

É recomendado criar um webservice WebService com as seguintes configurações (modificando o arquivo appserver.ini):

Bloco de código

language	java
theme	Eclipse
title	appserver.ini
collapse	true

;Serviço webserver HTTP
[HTTP]
ENABLE=1
PATH=<Caminho_Cache_imagens>;C:\TOTVS 11\Prottheus\Protheus_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 11\Prottheus\Protheus_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=TMSXStart ;ponto de inicio obrigatório
ONCONNECT=TMSXConnect ;ponto de inicio obrigatório
TMSPREPAREINOMSPREPAREIN=<empresa>,<filial>;obrigatório

...

Vide tópico Pré-requisitos instalação/implantação/utilização.

Protheus

Vide tópico Pré-requisitos instalação/implantação/utilização.

...

Mensagem de integração dos registros do cadastro de "Tipo de Veículo"

Campo Protheus	Título Campo Protheus	Tag XML	Campo Cockpit Logístico	Observações
MV_CPLREG		regionSourceId	Regional
DUT_TIPVEI	Tipo Veiculo	identifier	Código
DUT_DESCRI	Descricao	name	Nome
DUT_DESCRI	Descricao	description	Descrição
"0"		priority	Prioridade
"0"		similarity	Similaridade

...

Mensagem de integração dos registros do cadastro de "Produto"

Campo Protheus	Título Campo Protheus	Tag XML	Campo Cockpit Logístico	Observações
MV_CPLREG		regionSourceId	Regional
MV_CPLEMB		shipperId	Embarcador
B1_COD	Codigo	identifier	Código
B1_DESC	Descricao	description	Descrição
B1_GRUPO	Grupo	productCategoryId	Categoria
B5_ALTURA	Altura	height	Altura
B5_COMPR	Comprimento	length	Comprimento
B5_LARG	Largura	width	Largura
B1_PESBRU	Peso Bruto	weight	Peso
"1"		shape	Forma	1=Caixa

Mensagem de integração dos registros do cadastro de "Fornecedor"

Campo Protheus	Título Campo Protheus	Tag XML	Campo Cockpit Logístico	Observações
MV_CPLREG		regionSourceId	Regional
"FOR-" + RTRIM(SA2->A2_COD) + "" + RTRIM(SA2>A2_LOJA)	FOR + Codigo + Loja	identifier	Código	Será adicionada a sigla "FOR" para composição do código para identificação que se trata de um fornecedor para uso como uma localide devido aos pedidos de beneficiamento do OMS.
A2_NREDUZ	N Fantasia	name	Nome
A2_NOME	Razão Social	description	Descrição
A2_END	Endereço	addressStreet	Endereço
		addressNumber	N°	Obtido por meio do campo A2_END
A2_COMPLEM	Complemento	addressComplement	Complemento
A2_BAIRRO	Bairro	addressDistrict	Bairro
A2_CEP	CEP	addressZipCode	CEP
A2_MUN	Munícipio	addressCity	Cidade
A2_EST	Estado	addressStateAcronym	UF
A2_PAIS / "BR" ou YA_SIGLA	Pais	addressCountryAcronym	País	Quando o campo A2_PAIS estiver em branco ou igual a 105 atribuido "BR"
"2"		logisticRoleId	Tipo	2=Destino (por orientação da Neolog para gerar menos combinações de rota)

...

Campo Protheus	Título Campo Protheus	Tag XML	Campo Cockpit Logístico	Observações
MV_CPLREG		regionSourceId	Regional
MV_CPLIDS		integrationDataSource	Integração
"1"		orderTypeSourceId	Tipo do Pedido
RTRIM(SC5->C5_FILIAL) + "" + RTRIM(SC5>C5_NUM)	Filial + Numero	identifier		SC5->(RECNO())
RTRIM(SC5->C5_FILIAL) + "" + RTRIM(SC5>C5_NUM)	Filial + Numero	code	Código do Ped. Transp.
"0"		priority	Prioridade
Date()		erpCreationDt	Data Corrente	Data de criação do pedido no Protheus
Date()		pickupStart	Janela Embarque
Date() ou C5_FECENT	Dt. Entrega	deliveryStart	Janela Entrega	Data corrente ou data informada no pedido de venda
Date() ou C6_ENTREG ou C9_DATENT	Entrega ou Data Entrega	deliveryEnd	Janela Entrega
C9_PEDIDO	Pedido	orderId	ID do Pedido de Transporte
RTRIM(SC5->C5_FILIAL)+""+RTRIM(SC5>C5_NUM) + C9_ITEM	Filial + Pedido + Item	sourceId
C9_PRODUTO	Produto	productId	Produto
C9_QTDLIB	Qt Liberada	quantity	Quantidade total de unid.
C9_PRCVEN	Prc Venda	price	Valor Total de unid. De prod.
"FIL-" + RTRIM(SC5->C5_FILIAL)	FIL + Filial	originId	Origem Inicial
"CLI-" + RTRIM(SC5->C5_CLIENT) + "" + RTRIM(SC5>C5_LOJAENT)	CLI + Cli.Entrega + Loja Entrega	destinationId	ID da Localidade de destino do Pedido
C9_QTDLIB	Qt Liberada	quantityInShipmentUnits
B5_ALTURLC	Altur.Armaz.	height		Quando houver relacionamento com o B1_PRODUTO, quando vazio será enviado por default o contéudo = 0.001
B5_LARGLC	Largu.Armaz.	width		Quando vazio por default o contéudo enviado será = 0.001
B5_COMPRLC	Compr.Armaz.	length		Quando vazio por default o contéudo enviado será = 0.001
B1_PESO ou B1_PESBRU	Peso Liquido / Peso Bruto	weight		De acordo com a configuração do parâmetro MV_PESOCAR, verificar o conteúdo do parâmetro por meio da função OsPesoProd e enviar os dados. Quando vazio por default o contéudo enviado será = 0.001
MV_CPLEMB		shipperId	ID do Embarcador
"1"		modal	ID do modal do pedido de transporte	Enviar valor fixo 1 - Rodoviário
C5_TPFRETE	Tipo Frete	incoterm		Sendo o conteúdo C = 1 e F = 0 para o CPL, quando o campo for vazio iremos passar sempre 1.
MV_CPLINV		shipmentUnitWrapperCode	Invólucro de embarque

Mensagem de integração das viagens geradas no CPL para posterior geração das Cargas no SIGAOMS, utilizando a operação publishReleasedTrip:

Campo Prothues	Título Campo Protheus	Tag XML	Campo Cockpit Logístico	Observações
DK0_IDCESTA	Cesta	basketSourceId	ID Cesta
DK0_REGID	Regional	regionSourceId	Identificador Regional
DK0_VIAGID	Viagem CPL	identifier	ID da Viagem
DK0_TRANSP	Transp CPL	carrierId	ID Transportadora da Viagem
DK0_TIPVEI	Tipo Veículo	vehicleId	ID do Tipo de Veículo da Viagem
DK0_DESTIP	Desc Tp Veic	vehicleDescription	Descrição do tipo de veículo da viagem
DK0_PLACA	Placa Veic	truckLicensePlate	Placa do caminhão da viagem
DK0_ESTPLA	UF Placa	truckStateLicensePlate	Estado da placa do caminhão da viagem
DK0_QTDEIX	Nr. Eixos	truckAxlesQuantity	Número de eixos do caminhão

Mensagem dos itens (Pedidos) do CPL - deliveryUnit

Campo Protheus	Título Campo Protheus	Tag XML	Campo Cockpit Logístico	Observações
DK1_UNIDID	ID Uni Trans	identifier
DK1_REGID	Regional	RegionalSourceId	Regional
DK1_VIAGID	Viag. Rot	Viagem	Viagem CPL
DK1_PEDROTPEDROT	Ped. Rot.	orderSourceId	Pedido CPL
DK1_PRODUTO	Produto	productSourceId	Produto
DK1_QTD	Quantidade	quantity	Quantidade
DK1_PRECO	Preço	price	Preço
DK1_DATENT	Dt/Hr Entrg	deliveryDate	Dt/Hr Entrg
DK1_ORIGEM	Origem Int.	integrationSource	ID da origem de dados

...

Configuração dos parâmetros de integração.

Informações

title	Importante!

O passo a passo deste processo está disponível no Documento Técnico Réplica Integração OMS Protheus x Cockpit Logístico Neolog - Passo a Passo.
O acesso a este documento é restrito à equipe WMS / OMS Protheus (SUPPLY.ML.LOG.WMSOMS-Protheus).).

Árvore de páginas

Versões comparadas

Versão antiga 17

Nova versão Atual

Chave

Réplica Integração OMS Protheus x Cockpit Logístico Neolog

Pré-requisitos

Para a Instalação / Implantação / Utilização

Cockpit Logístico

Protheus

Parametrização SIGAOMS

Título

Parametrização appServer.ini exemplo de uso para configuração com o protocolo HTTP:

Protheus

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 17

Nova versão Atual

Chave

Réplica Integração OMS Protheus x Cockpit Logístico Neolog

Pré-requisitos

Para a Instalação / Implantação / Utilização

Cockpit Logístico

Protheus

Parametrização SIGAOMS

Título

Parametrização appServer.ini exemplo de uso para configuração com o protocolo HTTP:

Protheus