DT_PCREQ-6193_Melhoria_Integração_Logix_x_Protheus

Melhoria no processo de integração do WMS Logix x Protheus

Características do Requisito

Descrição

Implementadas melhorias na integração dos processos entre o WMS Logix e o ERP Protheus, agilizando a análise dos problemas ocorridos, possibilitando o reprocessamento automático da integração em caso de erros e liberação para continuidade dos processos no WMS mesmo se a integração não for realizada com sucesso, obrigando que estejam devidamente integrados somente no final do fluxo.

Desenvolvido o programa Monitor de Integração WMS (WMS80000), para monitorar e realizar a integração dos documentos com o Protheus.

Procedimento para Implantação

Para a utilização desta funcionalidade é necessário que o Logix esteja atualizado no mínimo com o Update 04-2015 (12.1.6).

Se esta for versão atual utilizada, será necessário realizar a aplicação dos seguintes pacotes de atualizações (Patches, Conversores de tabelas e Conversores de parâmetros):

• Requisito (PCREQ-6193);
• Chamado TRZAT2 (Framework Logix);
• Chamado TSAASR (Framework Logix);
• Chamado TSAXIK (Framework Logix).

Observações:

• Aplicar os pacotes dos chamados acima na ordem em que foram listados.
• Se a versão atual utilizada for o Update 05-2015 (12.1.7) ou superior não há necessidade de aplicação dos pacotes acima.

Procedimento para Configuração

CONFIGURAÇÃO PARA PROCESSAMENTO JOB

Para executar a rotina de integração via JOB é necessário realizar o cadastro da rotina no programa JOB0003 (Agendador de Tarefas Logix), informando nos campos:

• Programa: Informar WMS80000 (Monitor Integração WMS).
• Empresa: Informar o código da empresa na qual deve ser realizado o processamento (parâmetro obrigatório).
• Usuário: Informar o login do usuário que deve ser utilizado para o processamento (parâmetro obrigatório).

CONFIGURAÇÃO PARA ENVIO DE EMAIL

Quando for realizado processamento via JOB e o número de tentativas de processamento de um documento chegar ao limite determinado no parâmetro "wms_limite_tentativas_integra" o sistema irá disparar um e-mail para o usuário responsável.

Para que o envio de e-mails possa ser realizado, é necessário realizar as devidas configurações no servidor, conforme descritos no TDN http://tdn.totvs.com/pages/releaseview.action?pageId=65209789.

CONFIGURAÇÃO DE PARÂMETROS

Na rotina de manutenção de parâmetros do Logix (LOG00086), acesse Logix WMS -> Logix WMS -> Integração com Outros Sistemas e configure os seguintes parâmetros:

CONFIGURAÇÃO DE MENUS

Cadastrar a rotina WMS80000 no menu do Logix conforme abaixo:

Procedimento para Utilização

Documentos de Entrada

1. Depois do registro da nota fiscal de recebimento (via EDI ou manualmente), acesse a rotina WMS6628, informe os parâmetros acione o botão em Processar.
2. Será apresentada uma tela com as notas fiscais com integração pendente. Selecione a nota a ser integrada e acione Confirmar.
3. A rotina realizar a integração, caso ocorra algum problema, será exibida uma tela apresentando o erro ocorrido. Neste caso a nota fiscal continuará sendo apresentada nesta rotina, até que a sua integração seja realizada corretamente.
4. Para analisar o resultado do processamento (seja com sucesso ou não) acesse o programa Monitor da Integração (WMS80000), descrito mais abaixo.

Regularização Fiscal

1. Depois do registro da nota fiscal de regularização via EDI ou manualmente), acesse a rotina WMS6156 e consultar a nota fiscal.
2. Efetue a preparação das informações para a regularização fiscal utilizando as opções Preparar manual, Preparar Auto ou Preparar Todos. Depois acione Regularizar para efetuar o processamento.
3. Depois de executar os procedimentos de regularização fiscal no WMS Logix a rotina tentará realizar a integração. Caso ocorra algum problema será exibida uma tela apresentando o erro ocorrido, contudo mesmo em caso de erro a regularização fiscal será efetivada, ficando apenas pendente a integração do documento. Desta forma será possível utilizar o estoque que foi regularizado para atender a uma separação, sendo necessário que o documento esteja regularizado somente antes do processo final de expedição.
4. Em caso de inconsistência na integração da regularização, para que seja possível executá-la será necessário acessar o monitor, na aba Regularização fiscal, localizar a nota fiscal em questão e acionar a opção de processamento. Veja mais detalhes no tópico Monitor da Integração, descrito mais abaixo.
5. Ao cancelar a regularização fiscal de uma nota que não tenha sido integrada, o sistema irá apenas reverter a regularização no WMS, sem realizar qualquer tipo de integração com o backoffice.
6. Para analisar o resultado dos processamentos das regularizações (seja com sucesso ou não), acesse o tópico Monitor da Integração, descrito mais abaixo.
   
   
   

Documentos de Saída

1. Acessar a rotina WMS0745 ou WMS9745, informar os parâmetros para buscar os documentos a serem processados.
2. Selecionar os documentos desejados e clicar em Confirmar. Em seguida clicar em Processar para iniciar o processamento das informações.
3. Após efetuar a geração dos documentos a rotina tentará realizar a integração, caso ocorra algum problema será aberta uma tela apresentando o erro ocorrido. Caso ocorra algum problema será aberta uma tela apresentando o erro ocorrido, contudo mesmo em caso de erro o processamento será efetivado, ficando apenas pendente a integração do documento. Desta forma será possível executar os procedimentos seguintes da expedição, sendo necessário que o documento esteja integrado somente antes da liberação do veículo na portaria.
4. Para analisar o resultado dos processamentos das regularizações (seja com sucesso ou não) vá para o tópico Monitor da Integração, descrito mais abaixo.

Monitor da Integração

1. Acesse a rotina WMS80000, acione o botão Pesquisar para buscar as informações a serem apresentadas no monitor.
   1. Para filtrar pelo tipo de mensagem informe no filtro do campo Tipo mensagem:
      "E" - Para documentos de entrada;
      "R" - Para regularização fiscal;
      "S" - Para documentos de saída.
   2. Para filtrar pelo tipo de processo informe no filtro do campo Tipo processo:
      "U" - Para upsert (inclusão/alteração);
      "D" - Para delete (exclusão).
   3. Para filtrar determinado processo de documento de entrada ou regularização fiscal informe o filtro no campo Aviso recebimento.
   4. Para filtrar determinado processo de documento de saída informe o filtro no campo Solicitação de carga ou Transação documento saída, conforme o tipo de documento de saída a ser pesquisado.
   5. Para filtrar pela situação da integração informe no filtro do campo Situação integração:
      "P" - Para pendentes
      "F" - Para finalizados
2. Depois de realizar uma pesquisa é possível atualizar as informações na tela sem que seja necessário informar novamente os parâmetros. Para isso utilize o botão Atualizar, e será realizada uma nova pesquisa utilizando os mesmos filtros informados anteriormente.
3. Utilize o botão Processar para realizar o processo de integração de vários documentos ao mesmo tempo. Nesta opção é possível selecionar os tipos de documento a serem processados: documentos de entrada, regularização fiscal e documentos de saída.
4. Por meio do botão Testar Conexão é possível saber se o serviço do aplicativo de destino da integração está ou não ativo.
   Observação: Nesta verificação é considerado o aplicativo externo informado no parâmetro "wms_aplic_externo_backoffice".
5. No botão Histórico são exibidas as tentativas de processamento via JOB, indicando se foi realizada ou não com sucesso. É importante ressaltar que a situação do processamento indicada nesta tela refere-se à disponibilidade do serviço do aplicativo de destino no momento da execução e não ao resultado do processamento das integrações dos documentos.
6. Para os registros que estão pendentes de integração é possível realizar o processamento acionando o botão direito sobre a linha no grid dos documentos e selecionando a opção Processar integração. Depois realizar este processamento a tela será atualizada automaticamente com o resultado do processamento.
7. No grid de processamentos serão exibidas todas as tentativas de processamento de integração, em ordem decrescente (a última tentativa será exibida primeiro).
8. Ainda no grid de processamentos, ao clicar com o botão direito estarão disponíveis algumas opções especiais:
   1. Visualizar conteúdo retornado: Irá exibir o conteúdo que foi retornado pelo aplicativo de destino. Por exemplo, na integração de documentos de saída será exibido nesta opção o número do pedido de venda gerado no backoffice.
   2. Visualizar mensagem erro: Irá exibir a mensagem de erro completa retornada pelo aplicativo de destino.
   3. Exportar XML envio: Permitirá exportar para um arquivo o XML que foi enviado para o aplicativo de destino.
   4. Exportar XML resposta: Permitirá exportar para um arquivo o XML de resposta que foi retornado pelo aplicativo de destino.
9. Quando configurado para realizar a integração via processamento JOB, a rotina tentará realizar a integração de todos os documentos que estejam pendentes, desde que o número de tentativas já executadas seja menor do que o número informado no parâmetro "wms_limite_tentativas_integra". Quando for realizada uma tentativa de integração via JOB, se ocorrer erro e o número de tentativas chegar ao limite determinado o sistema irá enviar um email de alerta para o e-mail configurado no cadastro da tarefa do JOB (rotina JOB0003).