INTEGRAÇÃO OMS PROTHEUS X COCKPIT LOGÍSTICO NEOLOG
Características do Requisito
Linha de Produto: | Microsiga Protheus® | ||||||||||||||||||||||||||||||||||||||
Segmento: | Supply Chain - Logística | ||||||||||||||||||||||||||||||||||||||
Módulo: | SIGAOMS - Gestão de Distribuição | ||||||||||||||||||||||||||||||||||||||
Rotina: |
| ||||||||||||||||||||||||||||||||||||||
Cadastros Iniciais: | Cadastro de Empresas / Filiais Cadastro de Clientes Cadastro de Produtos Cadastro de Tipo de Veículo | ||||||||||||||||||||||||||||||||||||||
Parâmetro(s): |
| ||||||||||||||||||||||||||||||||||||||
Requisito (ISSUE): | LOGTMS01-512 | ||||||||||||||||||||||||||||||||||||||
País(es): | Todos | ||||||||||||||||||||||||||||||||||||||
Banco(s) de Dados: | Todos | ||||||||||||||||||||||||||||||||||||||
Tabelas Utilizadas: |
| ||||||||||||||||||||||||||||||||||||||
Sistema(s) Operacional(is): | Windows® / Linux® |
Descrição
Integrar o módulo 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). Apenas o envio dos cadastros irão ocorrer de forma assíncrona, o envio dos processos serão síncronos.
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 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 faz a roteirização e o arranjo das cargas com base na demanda de transportes enviados pelo 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.
O escopo desta integração permite o envio dos pedidos de venda liberados (crédito / estoque) no SIGAOMS para a formação das viagens no Cockpit Logístico. E o recebimento dessas viagens geradas no Cockpit Logístico é por meio de um XML no SIGAOMS para a geração das CARGAS.
São utilizados os cadastros abaixo na integração:
- Produto;
- Filial;
- Cliente;
- Tipo de Veículo;
- Fornecedor;
- Transportadora.
Foi disponibilizado apenas um novo cadastro para a integração "Transportadoras". O cadastro de fornecedor foi ajustado permitindo que quando a integração OMS x CPL estiver habilitada, o mesmo seja enviado como uma "Localidade", para o Cockpit Logístico.
Além dos cadastros, foi realizada a integração dos pedidos de venda que utilizam a "Carga". Os pedidos de venda são enviados para o Cockpit Logístico gerando "Pedidos de Transportes", em que para os quais, o Cockpit Logístico irá realizar a análise e geração da viagem.
Após a geração da viagem no Cockpit Logístico ocorre a integração com o SIGAOMS para a geração das Cargas.
PROCEDIMENTO PARA CONFIGURAÇÃO
Parametrização appServer.ini
Para que seja possível receber as viagens do Cockpit Logístico, é necessário configurar um WebService no appserver Protheus. É recomendado criar um webservice com as seguintes configurações (modificando o arquivo appserver.ini):
- Para testar o serviço, basta iniciar um navegador e digitar : http://<ip ou nome>:<porta>/neolog/PublishReleasedTrip.APW?WSDL
- Um WSDL (Descrição do serviço em xml) deve ser exibido no navegador.
Parametrização Cockpit Logístico (NEOLOG)
- Para configurar o envio de viagens do cockpit ao webservice protheus, entre no Cockpit Logístico e acesse:
- Administração > Integração, selecione a pasta 'Fontes de Dados' e clique em 'Inserir'.
2. Digite o Código, Descrição e Código da base. Sugestão: PROTHEUS
3. Seção "Cancelamento de Viagem Liberada"
- No campo 'URL' da seção digite: http://<ip ou nome>:<porta>/neolog/CancelService.APW
- No campo 'Tempo Máximo de Espera por Resposta', coloque 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', coloque 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', coloque o 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', coloque o timeout do serviço. Recomendado 30000.
7. Selecione a opção "Salvar".
Configuração para envio automático de pedidos de venda (Schedule)
Os pedidos de venda gerados no SIGAOMS podem ser enviados automaticamente ao Cockpit Logístico, para isso deve ser configurada a execução automática (Schedule) da rotina Envio de Pedidos de Venda (OMSXCPL6). Está configuração pode ser executada conforme descrito no link: http://tdn.totvs.com/display/framework/Schedule+Protheus.
No arquivo appserver.ini é necessário inserir a configuração abaixo:
CONFIGURAÇÃO DE PARÂMETROS (PROTHEUS)
No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure o(s) parâmetro(s) a seguir:
Itens/Pastas | Descrição |
Nome: | MV_CPLINT |
Tipo: | Caractere |
Título | Integração Cockpit Logístico? |
Opções | 1=Sim;2=Não |
Cont. Por.: | 2 |
Descrição: | Indica se a integração com o cockpit logístico está ativa. |
Itens/Pastas | Descrição |
Nome: | MV_CPLCLI |
Tipo: | Caractere |
Título | Integrar Clientes On line? |
Cont. Por.: | 2 |
Descrição: | Salvar os dados dos clientes criados no Protheus automaticamente no Cockpit Logístico. |
Itens/Pastas | Descrição |
Nome: | MV_CPLFOR |
Tipo: | Caractere |
Título | Integrar Fornecedores On line? |
Cont. Por.: | 2 |
Descrição: | Salvar os dados dos fornecedores criados no Protheus automaticamente no Cockpit Logístico (Localidades). |
Itens/Pastas | Descrição |
Nome: | MV_CPLTRA |
Tipo: | Caractere |
Título | Integrar Transportadora On line? |
Cont. Por.: | 2 |
Descrição: | Salvar os dados das transportadoras criadas no Protheus automaticamente no Cockpit Logístico. |
Itens/Pastas | Descrição |
Nome: | MV_CPLPRO |
Tipo: | Caractere |
Título | Integrar Produtos On Line? |
Cont. Por.: | 2 |
Descrição: | Salvar os dados dos produtos criados no Protheus automaticamente no Cockpit Logístico. |
Itens/Pastas | Descrição |
Nome: | MV_CPLTPV |
Tipo: | Caractere |
Título | Integrar Tipos de Veículos On Line? |
Cont. Por.: | 2 |
Descrição: | Salvar os dados dos tipos de veículos criados no Protheus automaticamente no Cockpit Logístico. |
Itens/Pastas | Descrição |
Nome: | MV_CPLURL |
Tipo: | Caractere |
Título | Endereço WebService |
Cont. Por.: | Conforme cliente |
Descrição: | Endereço do webservice do Cockpit Logístico. |
Itens/Pastas | Descrição |
Nome: | MV_CPLREG |
Tipo: | Caractere |
Título | Regional |
Cont. Por.: | Conforme cliente |
Descrição: | Código da Regional da instalação do Cockpit Logístico que está integrada ao OMS. |
Itens/Pastas | Descrição |
Nome: | MV_CPLEMB |
Tipo: | Caractere |
Título | Embarcador |
Cont. Por.: | Conforme cliente |
Descrição: | Código de um Embarcador do Cockpit Logístico. Todos os Produtos integrados integrados do 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. |
Itens/Pastas | Descrição |
Nome: | MV_CPLCAT |
Título | Categoria de Produto? |
Tipo: | Caractere |
Cont. Por.: | 2=Padrao Cockpit. |
Opções | 1=Grupo Produto. 2=Padrao Cockpit. |
Descrição: | 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) 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. |
Itens/Pastas | Descrição |
Nome: | MV_CPLINV |
Título | Invólucro Padrão |
Tipo: | Caractere |
Cont. Por.: | Conforme cliente |
Descriçã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). |
Itens/Pastas | Descrição |
Nome: | MV_CPLIDS |
Título | Origem dos Dados |
Tipo: | Caractere |
Cont. Por.: | Protheus |
Descrição: | Define o nome do ERP que da origem aos dados enviados ao Cockpit Logístico. |
Itens/Pastas | Descrição |
Nome: | MV_CPLMAL |
Título | E-mail do Administrador |
Tipo: | Caractere |
Cont. Por.: | Conforme cliente |
Descrição: | E-mail do administrador para notificações de falha de conexão. |
Itens/Pastas | Descrição |
Nome: | MV_CPLDBG |
Título | Modo Debug? |
Tipo: | Caractere |
Cont. Por.: | 2 |
Descrição: | Salva as mensagens enviadas e recebidas na pasta do log. |
Itens/Pastas | Descrição |
Nome: | MV_CPLLOG |
Título | Caminho da Pasta de Mensagens |
Tipo: | Caractere |
Cont. Por.: | \system| |
Descrição: | Caminho do log de mensagens. Recomendado utilizar o caminho relativo a \system| |
Itens/Pastas | Descrição |
Nome: | MV_CPLLVA |
Título | Liberação automática da viagem. |
Tipo: | Caractere |
Cont. Por.: | 2 |
Descrição: | O uso deste parâmetro ocorre somente para o SIGAOMS, quando habilitado, ao receber as viagens do Cockpit Logístico automaticamente o sistema irá realizar o envio da liberação de viagens no Cockpit Logístico. |
Itens/Pastas | Descrição |
Nome: | MV_CPLTVO |
Título | Tipo Veículo Otimização? |
Tipo: | Caractere |
Cont. Por.: | 2 |
Opções | 1=Impedir;2=Alertar |
Descrição: | Quando for 1 = Impedir: No vínculo 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. |
Itens/Pastas | Descrição |
Nome: | MV_CPLAUT |
Título | Geração das cargas |
Tipo: | Caractere |
Cont. Por.: | 2 |
Opções | 1=Automático;2=Manual |
Descrição: | 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 gerado manualmente a carga. |
Uso de Protocolo HTTPS
Os parâmetros abaixo devem ser preenchidos apenas se o cliente for fazer uso do protocolo de segurança HTTPS para integração com a NEOLOG.
Sendo necessário configurar o APPSERVER do Protheus seção SSLCONFIGURE
[SSLConfigure]
SSL3=1
TryProtocols=1
Para mais informações consulte: http://tdn.totvs.com.br/pages/viewpage.action?pageId=135496188, http://tdn.totvs.com.br/pages/viewpage.action?pageId=6064865
Itens/Pastas | Descrição |
Nome: | MV_CPLUAUT |
Título: | Endereço do webservice de autenticação |
Tipo: | Caractere |
Cont. Por.: | |
Descrição: | Endereço do webservice de autenticação. |
Itens/Pastas | Descrição |
Nome: | MV_TOKCPL |
Título: | Armazena o token recuperado |
Tipo: | Caractere |
Cont. Por.: | |
Descrição: | Armazena o token recuperado da NEOLOG. |
Itens/Pastas | Descrição |
Nome: | MV_DTTOK |
Título: | Armazena a data / hora da última recuperação de token |
Tipo: | Caractere |
Cont. Por.: | |
Descrição: | Armazena a data / hora da última recuperação de token. |
Itens/Pastas | Descrição |
Nome: | MV_EXPTOK |
Título: | Quantidade de horas para considerar que um token expirou |
Tipo: | Numérico |
Cont. Por.: | 24 |
Descrição: | Quantidade de horas para considerar que um token expirou. |
Itens/Pastas | Descrição |
Nome: | MV_USRCPL |
Título: | Usuário de autenticação do webservice |
Tipo: | Caractere |
Cont. Por.: | |
Descrição: | Usuário de autenticação do webservice. |
Itens/Pastas | Descrição |
Nome: | MV_PSWCPL |
Título: | Senha de autenticação do webservice |
Tipo: | Caractere |
Cont. Por.: | |
Descrição: | Senha de autenticação do webservice. |
CONFIGURAÇÃO DE MENUS
- No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do SIGAOMS, conforme instruções a seguir:
Menu | Atualizações |
Submenu | CockPit Logístico |
Nome da Rotina | Param. Integração |
Programa | OMSXCPL1 |
Módulo | SIGAOMS |
Tipo | Função Protheus |
Menu | Atualizações |
Submenu | CockPit Logístico |
Nome da Rotina | Carga de dados |
Programa | OMSXCPL2 |
Módulo | SIGAOMS |
Tipo | Função Protheus |
Menu | Atualizações |
Submenu | CockPit Logístico |
Nome da Rotina | Envio de Pedidos de Venda |
Programa | OMSXCPL6 |
Módulo | SIGAOMS |
Tipo | Função Protheus |
Menu | Atualizações |
Submenu | CockPit Logístico |
Nome da Rotina | Monitor de Cargas |
Programa | OMSXCPL7 |
Módulo | SIGAOMS |
Tipo | Função Protheus |
Menu | Atualizações |
Submenu | Faturamento |
Nome da Rotina | Mdf-e |
Programa | SPEDMDFE |
Módulo | SIGAOMS |
Tipo | Função Protheus |
PROCEDIMENTO PARA UTILIZAÇÃO
Parametrização e carga de dados inicial
Para realizar a carga inicial, e replicar os cadastros de Empresas/Filiais, Clientes, Produtos, Tipos de Veículos, Fornecedores e Transportadoras para o CockPit Logístico, deve ser realizado o procedimento abaixo:
- Em Gestão de Distribuição (SIGAOMS), acesse Atualizações / Cockpit Logístico / Param Integração (OMSXCPL1).
- Preencha os parâmetros conforme instruções do item "CONFIGURAÇÃO DE PARÂMETROS" deste documento.
- Utilize a opção Ações relacionadas/outras ações para testar a conexão com o WebService.
- Caso apareça a mensagem "Não foi possível conectar no WebService.", copie a URL e cole em algum navegador de internet e verifique se o WebService está acessível.
- Clique em "Confirmar" para gravar os parâmetros.
- Acesse Atualizações / Cockpit Logístico / Carga de Dados (OMSXCPL2).
- Marque os cadastros desejados e clique em processar.
- Se desejar, posicione na lista de cadastros o item e utilize o botão "Filtro", para aplicar um filtro de seleção de registros na tabela.
O filtro padrão do programa só permite que registros da filial em que o usuário está logado seja enviado ao Cockpit Logístico.
No caso de falha de envio por meio da opção "Falhas", é possível realizar uma consulta dos registros que apresentaram alguma falha no envio. - Posicione o cursor sobre o registro de falha que deseja verificar e selecione a opção "Visualizar", o programa irá apresentar o possível erro.
- Após o acerto do cadastro, posicione sobre o registro com falha e selecione a opção "Reenviar".
- Após o processamento, clique em "Sair" para finalizar o programa.
Após a carga inicial, os cadastros de clientes, produtos, tipos de veículos, fornecedor e transportadora, no módulo SIGAOMS devem ser feitos normalmente e desde que a integração esteja ativa, os dados serão replicados automaticamente ao Cockpit Logístico.
Atenção: O cadastro de empresas/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, é necessário executar o passo-a-passo acima a partir do item "e", selecionando o cadastro SM0/Cadastro de Filiais.
Envio de Pedidos de Vendas
Pré-Requisitos:
Possuir pedidos de venda devidamente cadastrados, liberados (credito/estoque) e com a opção "Carga" igual a "utiliza" no SIGAOMS.
Para enviar os pedidos de vendas gerados no módulo SIGAOMS:
- Em Gestão de Distribuição (SIGAOMS), acesse Atualizações / Cockpit Logístico / Envio de Pedidos de Venda (OMSXCPL6).
- Preencha os campos do pergunte apresentado, conforme o desejado para o pré-filtro dos pedidos de venda.
- Após confirmar o pergunte, confira os Pedidos na lista.
Pode-se utilizar a opção filtrar para aprimorar ainda mais a seleção de registros.
Apenas pedidos de venda que utilizam carga são apresentados. - Após isso, marque o(s) pedido(s) desejado(s) na opção ao lado esquerdo ou utilize a opção Ações relacionadas / outras ações / Marcar/Desmarcar Todos, para selecionar os pedidos que serão enviados.
- Por fim, utilize a opção Ações relacionadas/outras ações / Enviar Dados (CPL) - F5, ou utilize a tecla de atalho F5, para confirmar o envio dos pedidos ao Cockpit Logístico.
- Confira no Log do Cockpit Logístico se houve alguma divergência na integração dos registros.
- Os pedidos gerados na integração poderão ser consultados no Cockpit Logístico em Programação / Análise "cesta".
A realização do cancelamento de pedidos enviados para o Cockpit Logístico ocorre por meio do módulo SIGAOMS, por meio das rotinas:
Cancelamento via rotina Preparação dos Documentos de Saída (MATA460A):
- Quando houver o cancelamento de uma liberação do pedido de venda por meio da rotina "Preparação dos Documentos de Saída", opção Ações Relacionadas / "Estor. Docs", na confirmação da exclusão do registro, é realizado o envio do cancelamento ao CockPit Logístico.
Cancelamento via rotina Pedido de Venda (MATA410):
Alteração de um pedido de venda já liberado na rotina "Pedido de Venda" (MATA410):
- Ao confirmar a alteração, o sistema realiza a exclusão do registro liberado, assim é realizado o envio do cancelamento ao CockPit Logístico.
Alteração de pedido de venda já liberado e com nova liberação na própria rotina (MATA410):
- Ao confirmar a alteração com nova liberação, o sistema exclui o registro anterior e recria um novo registro com as informações da alteração. Assim é realizado o envio do cancelamento para o Cockpit Logístico.
Gerar cargas / Liberar Viagens
Pré-Requisitos:
Possuir viagens devidamente cadastradas no Cockpit Logístico.
Uma viagem é elaborada no CPL, a partir de pedidos de transporte. Para a identificação do pedido de transporte no CPL, foi utilizado o mesmo código do pedido de venda do Protheus, para que o usuário possa rastrear quais pedidos irão compor a viagem. As viagens são elaboradas no módulo programação, na rotina análise, disponível no Cockpit Logístico, pela seleção dos pedidos e montagem da carga. Após a elaboração da viagem no Cockpit, está deverá ser liberada para o Protheus, selecionando a viagem e executando o botão Liberar.
Cockpit Logístico:
- No Cockpit Logístico, vá em Programação / Análise.
- Selecione uma viagem pendente de liberação na coluna (S) e clique em 'Liberar'.
Protheus SIGAOMS
- No console do AppServer, deve ser apresentada a mensagem de inicialização do ambiente, indicando que o WebService recebeu a requisição enviada pelo Cockpit Logístico.
- Para verificar se a Viagem gerada no Cockpit Logístico foi criada, acesse em Gestão de Distribuição (SIGAOMS), Atualizações / Cockpit Logístico / Monitor de Cargas (OMSXCPL7).
- Posicione sobre a viagem importada do Cockpit Logístico, qual deseja gerar a carga no módulo SIGAOMS e selecione a opção Ações Relacionadas / Gera Carga.
Assim, o sistema irá gerar automaticamente uma nova carga na rotina de Cargas (OMSA200). - Após a geração da Nota Fiscal de Saída, de acordo com a configuração do parâmetro MV_CPLLVA (Libera viagem automática), será realizado o envio da liberação da viagem ao Cockpit Logístico, caso o parâmetro esteja desabilitado o envio da liberação deverá ocorrer de forma manual, por meio da opção Atualizações / Cockpit Logístico / Monitor de Cargas / Ações relacionadas / Liberar Viagem, permitindo assim a continuidade da viagem operacionalmente.
Mdf-e por Carga
Pré-Requisitos:
Para emitir o Mdf-e por Carga, é necessário que exista um veículo associado a "Carga" e o serviço do TSS configurado.
Foi disponibilizado no menu do módulo SIGAOMS a funcionalidade Mdf-e por Carga (Atualizações / Faturamento / Mdf-e), permitindo a geração e envio dos manifestos das notas fiscais de saída associadas a carga, facilitando a pesquisa e associação das notas fiscais. Com isso, é possível gerar o manifesto eletrônico para todas as notas fiscais da carga pesquisada.
- documento_tecnico
- mp_tmsoms_inov
- protheus
- logistica
- p12
- versao_12_1_17
- logtms01_512
- replica
- integracao_oms_x_cockpit_logistico_neolog
- sigaoms
- gestao_de_distribuicao
- neolog
- mv_cplint
- mv_cplcli
- mv_cplfor
- mv_cpltra
- mv_cplpro
- mv_cpltpv
- mv_cplurl
- mv_cplreg
- mv_cplemb
- mv_cplcat
- mv_cplinv
- mv_cplids
- mv_cplmal
- mv_cpldbg
- mv_cpllog
- mv_cpllva
- mv_cpltvo
- mv_cplaut
- mv_cpluaut
- mv_tokcpl
- mv_dttok
- mv_exptok
- mv_usrcpl
- mv_pswcpl
- omsxcpl1
- omsxcpl2
- omsxcpl6
- omsxcpl7
- spedmdfe
- mdfe_por_carga
- mdfe
- cockpit_logistico