Melhoria no processo de integração do WMS Logix x Protheus
Características do Requisito
Linha de Produto: | Logix |
Segmento: | Distribuição & Logística |
Módulo: | WMS |
Rotina: | WMS6628 - Inclusão Integração Documento de Entrada WMS6629 - Exclusão Integração Documento de Entrada WMS6156 - Regularização Fiscal WMS0745 - Emissão Documentos WMS9745 - Emissão Documentos WMS6429 - Exclusão Pedido de Venda WMS6361 - Cancelamento Processo Fiscal sem Nota WMS6333 - Consulta de Documentos WMS80000 - Monitor de Integração WMS |
Requisito (ISSUE): | PCREQ-6193 |
Banco(s) de Dados: | Informix, Oracle, SQL Server |
Tabelas utilizadas: | wms_docto_integracao_mestre wms_docto_integracao_processo wms_log_processamento_job wms_docum_saida_detalhe_retn wms_docum_saida |
Sistema(s) operacional(is): | Windows, Linux |
Versões/Release: | 10.2 / 11.0 |
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:
Itens/Pastas | Descrição |
Nome: | wms_aplic_externo_backoffice |
Tipo: | Caracter |
Cont. Por.: | Aplicativo externo utilizado para integração com backoffice |
Descrição: | Informe o nome do aplicativo externo cadastrado na rotina EAI10000 com o qual o WMS Logix estará utilizando para a integração com o ERP Protheus. |
Itens/Pastas | Descrição |
Nome: | wms_limite_tentativas_integra |
Tipo: | Numérico |
Cont. Por.: | Número limite de tentativas de integração |
Descrição: | Número máximo de tentativas de integração que cada mensagem poderá ter, para processamento via JOB. Observação: Para processamentos manuais não há limite de tentativas. |
Itens/Pastas | Descrição |
Nome: | wms_timeout_integracao_monitor |
Tipo: | Numérico |
Cont. Por.: | Número de segundos para timeout nas integrações pelo monitor |
Descrição: | Número de segundos a ser considerado nas integrações processadas a partir do monitor da integração (WMS80000). OBS: Caso não seja informado será considerado o tempo padrão (120 segundos). |
CONFIGURAÇÃO DE MENUS
Cadastrar a rotina WMS80000 no menu do Logix conforme abaixo:
Sistema | “315” (WMS) |
Nível 1 | “7” (Gerenciamento Operacional) |
Nível 2 | “8” |
Nível 3 | - |
Sequência | 1 |
Processo | wms80000 |
Tipo Processo | 2 |
Transação | WMS80000 |
Descrição | Monitor integrações WMS |
Procedimento para Utilização
Documentos de Entrada
- 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.
- Será apresentada uma tela com as notas fiscais com integração pendente. Selecione a nota a ser integrada e acione Confirmar.
- 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.
- 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
- Depois do registro da nota fiscal de regularização via EDI ou manualmente), acesse a rotina WMS6156 e consultar a nota fiscal.
- 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.
- 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.
- 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.
- 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.
- 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
- Acessar a rotina WMS0745 ou WMS9745, informar os parâmetros para buscar os documentos a serem processados.
- Selecionar os documentos desejados e clicar em Confirmar. Em seguida clicar em Processar para iniciar o processamento das informações.
- 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.
- 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
- Acesse a rotina WMS80000, acione o botão Pesquisar para buscar as informações a serem apresentadas no monitor.
- 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. - 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). - Para filtrar determinado processo de documento de entrada ou regularização fiscal informe o filtro no campo Aviso recebimento.
- 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.
- Para filtrar pela situação da integração informe no filtro do campo Situação integração:
"P" - Para pendentes
"F" - Para finalizados
- Para filtrar pelo tipo de mensagem informe no filtro do campo Tipo mensagem:
- 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.
- 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.
- 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". - 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.
- 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.
- No grid de processamentos serão exibidas todas as tentativas de processamento de integração, em ordem decrescente (a última tentativa será exibida primeiro).
- Ainda no grid de processamentos, ao clicar com o botão direito estarão disponíveis algumas opções especiais:
- 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.
- Visualizar mensagem erro: Irá exibir a mensagem de erro completa retornada pelo aplicativo de destino.
- Exportar XML envio: Permitirá exportar para um arquivo o XML que foi enviado para o aplicativo de destino.
- Exportar XML resposta: Permitirá exportar para um arquivo o XML de resposta que foi retornado pelo aplicativo de destino.
- 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).