INTEGRAÇÃO OMS PROTHEUS X COCKPIT LOGÍSTICO NEOLOG

Características do Requisito

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):

;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
OMSPREPAREIN=<empresa>,<filial>;obrigatório

• 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)

1. 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: 

[OnStart]
jobs=FWSCHDMANAG,FWSCHDQUEUE
RefreshRate=60
[FWSCHDMANAG]
Main=FWSCHDMANAG
Environment=<ambiente>
[FWSCHDQUEUE]
Main=FWSCHDQUEUE
Environment=<ambiente>

CONFIGURAÇÃO DE PARÂMETROS (PROTHEUS)

No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure o(s) parâmetro(s) a seguir:

CONFIGURAÇÃO DE MENUS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do SIGAOMS, conforme instruções a seguir:

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:

1. Em Gestão de Distribuição (SIGAOMS), acesse Atualizações / Cockpit Logístico / Param Integração (OMSXCPL1).
2. Preencha os parâmetros conforme instruções do item "CONFIGURAÇÃO DE PARÂMETROS" deste documento.
3. Utilize a opção Ações relacionadas/outras ações para testar a conexão com o WebService.
4. 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. 
5. Clique em "Confirmar" para gravar os parâmetros.
6. Acesse Atualizações / Cockpit Logístico / Carga de Dados (OMSXCPL2).
7. Marque os cadastros desejados e clique em processar.
8. 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. 
9. 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. 
10. Após o acerto do cadastro, posicione sobre o registro com falha e selecione a opção "Reenviar".
11. 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:

1. Em Gestão de Distribuição (SIGAOMS), acesse Atualizações / Cockpit Logístico / Envio de Pedidos de Venda (OMSXCPL6).
2. Preencha os campos do pergunte apresentado, conforme o desejado para o pré-filtro dos pedidos de venda.
3. 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.
4. 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.
5. 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.
6. Confira no Log do Cockpit Logístico se houve alguma divergência na integração dos registros.
7. Os pedidos gerados na integração poderão ser consultados no Cockpit Logístico em Programação / Análise "cesta".
   

8. 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:

1. No Cockpit Logístico, vá em Programação / Análise.
2. Selecione uma viagem pendente de liberação na coluna (S) e clique em 'Liberar'.

Protheus SIGAOMS

1. 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.
2. 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).
3. 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). 
4. 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.