Monitor logística
O monitor de integração de logística tem como objetivo centralizar todas as etapas do processo de integração desde o início ao fim.
Ele permite o acompanhamento de todas as etapas da integração de um documento (entrada ou saída). Com o monitor é possível identificar as falhas de integração, acompanhar detalhadamente as etapas de um processo específico, verificar conteúdos exportados tanto por parte do Gestão de Armazenagem | WMS Senior e WMS Alcis, como por parte do Gestão Empresarial | ERP.
Além disso, oferece diversas possibilidades de filtros, geral ou específico, permitindo ao usuário, identificar o documento com facilidade, pesquisar por parte de um conteúdo, além de outras possibilidades.
Nota
- Caso o menu não esteja visível, é necessário adicioná-lo manualmente a partir de Tecnologia > Customização > Aplicativos > Gestão Empresarial | ERP > Ações > Adicionar URL e adicionar a seguinte url: https://platform.senior.com.br/erp-int-mnl/erp_isl/int_monitorlogistica/config.json. Em seguida, clicar em Gerar menu e atualizar a página;
- Para que o Monitor Logística seja apresentado no menu da XPlatform, é fundamental que o papel do usuário tenha acesso ao menu. E, quando houver alguma configuração do menu em si ou atualização dos itens de menu, ele seja regerado. Para isso, basta acessar Tecnologia > Customização > Aplicativos, selecionar o menu e clicar em Gerar menu.
Totalizadores de integração
Essa seção acompanha e apresenta os totalizadores da integração, levando em consideração os últimos 7 dias.
- Em separação: apresenta um totalizador de pré-fatura/nota fiscal de saída que aguardam separação no WMS;
- Em fat.: apresenta um totalizador de pré-fatura/nota fiscal de saída que aguardam faturamento no ERP;
- Faturado: mostra o total de pré-fatura/nota fiscal de saída que já foram faturadas no ERP e encaminhadas ao WMS;
- Em integração: total de registros pendentes de integração com o WMS, compondo-se de todos os tipos de documentos;
- Erro ERP: total de registros com erro no ERP, compondo-se de todos os tipos de documentos;
- Erro WMS: todos os registros com erro no WMS, compondo-se de todos os tipos de documentos.
Para visualizar a quantidade de erros com filtro de data, recomenda-se o uso do agendamento notificationSender, conforme a documentação de Agendamentos.
Filtros
Os campos de filtros no cabeçalho da tela são usados para localizar um determinado registro e consultar sua situação.
- Inclusão inicial: data de início para filtrar pela data de inclusão do registro
- Inclusão final: data de fim para filtrar pela data de inclusão do registro
- Processo de recebimento e separação:
- Ordem de recebimento: nota fiscal de entrada, nota fiscal de devolução e nota fiscal de importação
- Ordem de separação: pré-fatura, nota fiscal de saída
- Cadastro de produto: cadastro de produtos que possui ligação com depósito que integram com o Gestão de Armazenagem | WMS Senior e/ou WMS Alcis
- Cadastro de cliente
- Cadastro de fornecedor
- Cadastro de transportadora
- Movimento de estoque: movimentos manuais de estoque gerados pelo WMS Alcis
- Transferência depósito de entrada: transferência entre depósitos quando o depósito de destino é integrado com WMS Alcis, gerando assim uma ordem de recebimento no WMS Alcis
- Transferência depósito de saída : transferência entre depósitos quando o depósito de origem é integrado com WMS Alcis, gerando uma ordem de separação WMS Alcis
- Situação ERP: efetua o filtro para consulta de todos os documentos que estão com a situação ERP escolhida
- Situação WMS: efetua o filtro para consulta de todos os documentos que estão com a situação WMS escolhida.
- Último processamento – Inicial: data hora inicial do último processamento
- Último processamento – Final: data e hora final do último processamento
- ID Integração: ID único da integração
- Chave documento: chave do documento no ERP
- Chave documento WMS: chave do documento no WMS Alcis
- Conteúdo ERP: conteúdo dos dados obtidos do ERP (JSON)
- Conteúdo WMS: conteúdo dos dados obtidos do Gestão de Armazenagem | WMS Senior e WMS Alcis (JSON)
Conectividade G5
Verifica se o serviço erp-service está ativo. Utilize a tela Serviços on-premise, disponível em Gestão Empresarial | ERP > Integração > Monitor, para consultar a situação dos quatro serviços essenciais para que a integração funcione.
Componentes
O botão Componentes apresenta todos os serviços que são utilizados pela integração do Tenant.
Pendências
Processo
Descreve o tipo de processo do registro integrado, ou seja, o tipo do documento. Pode ser uma pré-fatura, nota fiscal de saída, nota fiscal de entrada, transferência de entrada entre depósitos, transferência de saída entre depósitos, nota fiscal de devolução e nota fiscal de importação, cadastros de clientes, fornecedores, transportadoras, cadastro de produtos e movimentos de estoque manual oriundo do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis.
Chave DOC
Chave do documento no Gestão Empresarial | ERP.
Situação ERP
Descritivo da última operação realizada na integração:
- "Aguardando Exportação": documento recebido pelo Integrador aguardando exportação dos dados no Gestão Empresarial | ERP;
- "Em exportação": montagem dos dados no Gestão Empresarial | ERP em andamento;
- "Exportado": documento e dados recebidos pelo Integrador;
- "Reenviar": documento reenviado no Gestão Empresarial | ERP;
- "Cancelado": documento cancelado no Gestão Empresarial | ERP;
- "Concluído": pode ter dois momentos: quando integrou o documento no Gestão de Armazenagem | WMS Senior e quando o retorno foi processado e finalizado no Gestão Empresarial | ERP;
- "Reaberto": documento reaberto no Gestão Empresarial | ERP;
- "Erro": falhas do sistema ou de comunicação do Gestão Empresarial | ERP;
- "Aguardando faturamento": documento aguardando para ser faturado no Gestão Empresarial | ERP;
- "Aguardando processamento": documento aguardando para ser processado no Gestão Empresarial | ERP;
- " Fat. aguard. exportação": documento recebido pelo integrador aguardando exportação dos dados de faturamento no Gestão Empresarial | ERP;
- "Faturamento em exportação": montagem dos dados do faturamento no Gestão Empresarial | ERP em andamento;
- "Faturamento exportado": documento de faturamento e dados recebidos pelo Integrador;
- " Faturamento concluído": documento de faturamento enviado ao Gestão de Armazenagem | WMS Senior e/ou WMS Alcis e finalizado no Gestão Empresarial | ERP;
- "Canc. aguard. exportação": documento recebido pelo integrador aguardando exportação dos dados de cancelamento no Gestão Empresarial | ERP;
- "Cancelamento exportado": documento de cancelamento e dados recebidos pelo Integrador;
- "Cancelamento concluído": documento de cancelamento enviado ao Gestão de Armazenagem | WMS Senior e/ou WMS Alcis e finalizado no Gestão Empresarial | ERP;
- "Cancelamento negado": documento de cancelamento enviado ao Gestão de Armazenagem | WMS Senior e/ou WMS Alcis e finalizado no Gestão Empresarial | ERP;
- "Refatura. aguard. exportação": documento recebido pelo Integrador aguardando exportação dos dados de refaturamento no Gestão Empresarial | ERP;
- "Refaturamento exportado": documento de refaturamento e dados recebidos pelo Integrador;
- " Refaturamento concluído": documento de refaturamento enviado ao Gestão de Armazenagem | WMS Senior e/ou WMS Alcis e finalizado no Gestão Empresarial | ERP;
- "Excluído": indica que o registro foi excluído no Gestão Empresarial | ERP.
Situação WMS
Descritivo do último status do processo realizado na integração.
- "Aguardando exportação": documento recebido pelo integrador aguardando processamento para envio ao Gestão de Armazenagem | WMS Senior e/ou WMS Alcis;
- "Em exportação": montagem dos dados de/para do Gestão Empresarial | ERP para o Gestão de Armazenagem | WMS Senior e/ou WMS Alcis;
- "Exportado - não confirmado": enviou o documento mas ainda falta resposta do protocolo de integração do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis;
- " Exportado - confirmado": exportado e integrado o documento no Gestão de Armazenagem | WMS Senior e/ou WMS Alcis;
- " Aguardando importação": documento recebido do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis aguardando exportação dos dados do WMS;
- "Em importação": montagem dos dados no Gestão de Armazenagem | WMS Senior e/ou WMS Alcis para envio ao Gestão Empresarial | ERP;
- "Importado": documento e dados recebidos pelo Integrador;
- "Reenviar": documento reenviado no Gestão de Armazenagem | WMS Senior e/ou WMS Alcis para o Gestão Empresarial | ERP;
- " Cancelado": documento cancelado ou excluído no Gestão de Armazenagem | WMS Senior e/ou WMS Alcis;
- "Concluído": pode ter dois momentos: quando integrou o documento com sucesso no Gestão de Armazenagem | WMS Senior e/ou WMS Alcis e quando o faturamento ou refaturamento for integrado no WMS;
- "Cancelamento negado": documento de cancelamento enviado ao Gestão de Armazenagem | WMS Senior e/ou WMS Alcis, porém o cancelamento foi negado;
- " Exportado agendado": exportado e agendado o documento para ser processado no Gestão de Armazenagem | WMS Senior e/ou WMS Alcis (Jobs);
- "Aguard. formação onda": situação do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis indicando que o documento está aguardando formação de onda;
- "Aguardando separação": situação do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis indicando que o documento está aguardando separação;
- "Separação iniciada": situação do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis indicando que o documento iniciou a separação;
- "Aguard. resolução quebra": situação do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis indicando que o documento está aguardando resolução de quebra;
- "Separação concluída": situação do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis indicando que o documento finalizou a separação;
- " Packing iniciado": situação do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis indicando que o documento iniciou o packing;
- "Packing concluído": situação do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis indicando que o documento finalizou o packing;
- " Enviado p/ faturamento": situação do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis indicando que o documento está aguardando o faturamento no Gestão Empresarial | ERP;
- " Coleta iniciada": situação do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis indicando que o documento iniciou a coleta;
- "Expedido": situação do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis indicando que o documento está expedido;
- "Digitado/Importado": situação do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis indicando que o documento de separação foi integrado;
- "Planejamento Concluído": o planejamento do documento já foi finalizado dentro do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis;
- "Reservado": itens do documento reservado em estoque no Gestão de Armazenagem | WMS Senior e/ou WMS Alcis;
- "Em Conferência": iniciou-se a conferência dos itens de um documento no Gestão de Armazenagem | WMS Senior e/ou WMS Alcis;
- "Conferido": os itens do documento já foram conferidos no Gestão de Armazenagem | WMS Senior e/ou WMS Alcis;
- "Erro": falhas seja de sistema ou de comunicação do Gestão de Armazenagem | WMS Senior e/ou WMS Alcis;
- "Não integrado": o registro está pendente de integração com o Gestão de Armazenagem | WMS Senior e/ou WMS Alcis.
Chave DOC WMS
Chave do documento no Gestão de Armazenagem | WMS Senior e/ou WMS Alcis.
Essa informação é preenchida quando a XPlatform recebe do WMS uma confirmação/retorno da integração do tipo de documento integrado. Nem todos os documentos integrados tem um retorno, assim como existe diferença entre os tipos de integração e o momento em que o campo Chave DOC WMS é preenchido.
- O processo de Cadastros de Produto nunca terá o campo Chave DOC WMS preenchido, pois essa é uma integração apenas no fluxo Gestão Empresarial | ERP para WMS, não havendo um retorno do WMS de algum tipo de registro efetuado (existe somente o OK da integração, mas sem nenhum retorno de numeração/chave de registro para a XPlatform);
- Por conta dessa característica de inexistência de Chave DOC WMS, não há um vínculo entre as diversas tentativas de exportação de um cadastro de Produto no Monitor Logística. Assim, se ocorrer algum erro na exportação de um Produto, ao ser reexportado pelo Gestão Empresarial | ERP, um novo registro de integração será gerado no Monitor Logística. O registro anterior com erro não será substituído ou atualizado automaticamente pelo processo de integração; ele poderá ser ignorado e será limpo/eliminado do Monitor Logística conforme o processo do agendamento ProcessarLimpezaRegistros.
- O processo de Apontamento de Produção terá a Chave DOC WMS definida já quando a Situação WMS estiver como Concluída, pois no retorno da integração com WMS já existe um número de documento gerado pelo WMS para esse processo;
- O processo de Pré-Fatura tem a definição da Chave DOC WMS somente após ter havido o processamento do documento, como por exemplo, iniciando o processo de separação. Enquanto a Situação WMS estiver como Digitado/Importado, o campo Chave DOC WMS não exibirá nenhuma informação;
- O processo de Nota Fiscal de Entrada tem a definição da Chave DOC WMS quando ocorrer o retorno da conferência da Nota Fiscal no WMS, ou seja, com a Situação WMS igual a Concluído. Enquanto o processo da Nota Fiscal de Entrada estiver em execução dentro do WMS, o status no Monitor será de Em Conferência e o campo Chave DOC WMS não estará preenchido.
Incluído
Data de inclusão do registro.
Último processamento
Data do último processamento do registro.
ID integração
ID único da integração.
Conteúdo ERP
Conteúdo dos dados obtidos do ERP (JSON). Pode ser visualizado o conteúdo original e convertido.
Status integração ERP
Descritivo da última operação realizada.
Conteúdo WMS
Conteúdo dos dados obtidos do WMS (JSON). Pode ser visualizado o conteúdo original e convertido.
Status integração WMS
Descritivo da última operação realizada.
Ações
Permite realizar o reenvio de etapas da integração, Gestão de Armazenagem | WMS Senior e/ou WMS Alcis e Gestão Empresarial | ERP, sincronizando as situações ERP ou WMS, quando necessário.
Se no monitor for exibido qualquer tipo de erro de integração, é possível que, após realizar os ajustes necessários, sejam reenviados os movimentos contendo a correção através das opções disponíveis para cada tipo de documento.
Para cada tipo de documento, o botão Ações disponibiliza a ação Reenviar registro, pertinente as etapas de integração correspondente.
- Reenviar registro: ação que reenvia o registro com base no seu estágio de integração. O sistema identifica seu tipo de documento e para qual sistema o mesmo deve ser reenviado;
- Reabrir Documento no ERP: ação para reabrir uma pré-fatura no ERP, que somente deve ser executada em determinados processos e por pessoas autorizadas. Em casos onde a pré-fatura é fechada no ERP e posteriormente ocorre algum erro ao integrar com o WMS por falta ou inconsistência de informação, esse documento fica bloqueado para alteração do ERP. Ao executar a ação, ela efetuará a reabertura da pré-fatura no ERP.
Importante
- A execução desnecessária na ação de reabrir o documento, interfere no fluxo de integração;
- A recomendação é criar um novo papel que por padrão é permitido somente aos administradores e posteriormente, adicionar os usuários que poderão executar esta ação.
O agendamento notificationSender tem como objetivo gerar notificações no padrão da Plataforma Senior X, enviando alertas aos usuários atribuídos aos papéis definidos no agendamento.
Importante
- Por padrão, a notificação é direcionada aos usuários vinculados ao papel Logística. Se esse papel não estiver configurado no Tenant, ou se não houver usuários associados a ele, o agendamento será executado normalmente, sem erros, mas nenhuma notificação será enviada. Para definir outros papéis que receberão a notificação, utilize o parâmetro destinationRoles no JSON do agendamento, conforme as configurações do seu Tenant.
- A notificação padrão não será enviada por e-mail. Ela ficará disponível apenas como uma notificação na Plataforma Senior X.
Os parâmetros personalizáveis do agendamento estão detalhados no próprio cadastro do agendamento.
Considere que o agendamento notificationSender segue um conceito diferente do que é exibido no quadro de Totalizadores de integração no Monitor Logística e inclui o total de registros referentes à data de execução, levando em consideração o parâmetro day definido no JSON da execução, se configurado.
- Se o agendamento for executado em 18/09/2024 às 08:42, sem o parâmetro day, serão considerados apenas os registros atualizados em 18/09/2024 a partir das 00:00. Registros atualizados antes dessa data, como em 17/09/2024 às 22:52, não serão incluídos no resumo nem na notificação.
- Se o agendamento estiver configurado com o parâmetro day com valor 5 e for executado em 18/09/2024 às 08:42, serão considerados os registros atualizados desde 14/09/2024 a partir das 00:00. Registros atualizados antes dessa data, como em 13/09/2024 às 22:52, não serão incluídos no resumo nem na notificação.
A seguir, veja imagens que exemplificam a notificação enviada para a Plataforma Senior X pelo agendamento.
A notificação incluirá os seguintes dados:
- Total de erros de integração com o ERP: considera registros com status de Erro ou Erro HTTP no ERP.
- Total de erros de integração com o WMS: considera registros com status de Erro ou Erro HTTP no WMS.
- Total de registros pendentes de integração com o WMS: considera registros com status de WMS Aguardando Exportação, Em Exportação e Exportado. E ainda Não Confirmado e Não Integrador.
A notificação não considera registros pendentes de integração com o ERP.
Limpeza de registros de integração
O processo de limpeza dos registros no Monitor Logística é realizado através do agendamento da plataforma ProcessarLimpezaRegistros.
Esse agendamento eliminará os registros com data da última alteração conforme os critérios descritos abaixo:
- Documentos (como Ordem de Separação, Recebimento, entre outros): registros com data da última alteração superior a 60 dias a partir da execução do agendamento.
- Cadastros (Produto, Cliente, Fornecedor, Transportadora): registros com data da última alteração superior a 15 dias a partir da execução do agendamento.
O agendamento do processo ProcessarLimpezaRegistros na plataforma deve ser realizado conforme as instruções disponíveis neste link para a documentação.
Atenção
Registros eliminados pelo processo de limpeza do Monitor Logística não podem ser recuperados. Por isso, é fundamental que os processos de integração sejam monitorados e que todas as ações necessárias para a conclusão da integração sejam realizadas antes dos prazos de limpeza mencionados anteriormente. Após a exclusão dos registros, não há como recuperá-los, e não existem medidas corretivas possíveis.