Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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

Aviso
titleDOCUMENTO 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 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
titleAtençã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:

...

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_CPLTVO1=Impedir;2=AlertarAlterar / 2
Geração das cargasQuando 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_CPLAUT1=Automático;2=ManualManual / 2
Informações
titleUso 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çãoParâmetroTipoConteúdoOpções
Endereço do web service de autenticaçãoEndereço do web service de autenticaçãoMV_CPLUAUTCaractere
Dever ser preenchido pelo usuário
Armazena o token recuperadoArmazena o token recuperado da autenticação com a NeologMV_TOKCPLCaractere
Preenchimento automático pelo sistema
Armazena a data / hora da última recuperação de tokenArmazena a data / hora da última recuperação de tokenMV_DTTOKCaractere
Preenchimento automático pelo sistema
Quantidade de horas para considerar que um token expirouQuantidade de horas para considerar que um token expirouMV_EXPTOKNumérico24

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 serviceUsuário de autenticação do web serviceMV_USRCPLCaractere
Deve ser preenchido pelo usuário
Senha de autenticação do web serviceSenha de autenticação do web serviceMV_PSWCPLCaractere
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):

...

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

Protheus

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

...