Histórico da Página
Réplica Integração OMS Protheus x Cockpit Logístico Neolog
Aviso | ||
---|---|---|
| ||
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 |
|
Fornecedor |
|
Tipo de Veículo |
|
Cliente |
|
Empresas/Filiais |
|
Produto |
|
Pedidos de Venda |
|
Montagem de Carga |
|
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 | ||
---|---|---|
| ||
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. | |
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 | ||
---|---|---|
| ||
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):
...
Vide tópico Pré-requisitos instalação/implantação/utilização.
Protheus
Vide tópico Pré-requisitos instalação/implantação/utilização.
...