Acompanhamento de Faturamento Assíncrono WMS

A funcionalidade Acompanhamento de Faturamento Assíncrono é uma tela de monitoramento em tempo real do status das notas fiscais que estão sendo processadas em segundo plano. Ela centraliza as requisições geradas por processos como a Execução da Ordem de Serviço de Carregamento WMS (@Mobile) e a Devolução de Estoque de Trocas, garantindo que o usuário tenha visibilidade sobre possíveis falhas (erros) ou lentidões (timeouts) na fila de processamento do Faturamento Assíncrono (automático).

Seu principal objetivo é dar visibilidade e autonomia às operações sobre a fila de Notas Fiscais em processamento (automático) de Faturamento Assíncrono, auxiliando na tomada de decisões e ajudando a evitar gargalos na expedição e carregamento.

---

1. Permissões Necessárias

Para acessar a funcionalidade, o usuário deve possuir a seguinte permissão habilitada em seu grupo de usuários:

• 4431 – Acompanhamento de Faturamento Assíncrono: Consultar

1.1 Permissões Adicionais

Para utilizar o recurso de exclusão de registros com status Erro ou Time out, o usuário também precisará da permissão abaixo:

• 4432 – Acompanhamento de Faturamento Assíncrono: Excluir

---

2. Acesso à Funcionalidade

O acesso à funcionalidade Acompanhamento de Faturamento Assíncrono pode ser realizado através do caminho Home > WMS > Faturamento > Acompanhamento de Faturamento Assíncrono, ou pela funcionalidade Busca Rápida informando o código do menu (menukey) 2290.

2.1 Usuário Sem Acesso

Caso um usuário sem a permissão necessária (4431 – Acompanhamento de Faturamento Assíncrono: Consultar) acesse o caminho Home > WMS > Faturamento > Acompanhamento de Faturamento Assíncrono, a funcionalidade não estará disponível.

Se esse usuário tentar acessar a funcionalidade através da Busca Rápida informando o código do menu (menukey) 2290, o sistema exibirá em tela uma mensagem de restrição de acesso.

2.2 Usuário Com Acesso

Caso um usuário com a permissão necessária (4431 – Acompanhamento de Faturamento Assíncrono: Consultar) acesse o caminho Home > WMS > Faturamento > Acompanhamento de Faturamento Assíncrono, a funcionalidade estará disponível.

Se esse usuário tentar acessar a funcionalidade através da Busca Rápida informando o código do menu (menukey) 2290, o acesso será validado e a tela da funcionalidade será exibida com sucesso.

---

3. Utilizando os Filtros de Busca

Ao acessar a tela da funcionalidade, utilize os filtros disponíveis para refinar a sua busca.

• Loja: Selecione a Loja ou CD de origem da operação de Faturamento Assíncrono (automático) em andamento.
  • O sistema listará apenas as Lojas ou CDs às quais você tem acesso.
  • Caso o filtro não seja preenchido, o sistema buscará requisições de todas as Lojas ou CDs às quais você tem acesso.

• Origem da Solicitação: Selecione o processo de origem da operação de Faturamento Assíncrono (automático) em andamento.
  • As opções disponíveis são: Execução de Carregamento WMS, Devolução de Estoque de Trocas e Outros.
  • Caso o filtro não seja preenchido, o sistema buscará requisições de todas as Origens disponíveis.

• Usuário Solicitante: Selecione o operador específico que originou a operação de Faturamento Assíncrono (automático) em andamento.
  • Caso o filtro Loja não esteja preenchido, não será listado nenhum usuário.
  • Caso o filtro Loja esteja preenchido, serão listados todos os usuários com requisições em andamento vinculados àquela Loja.
  • Caso o filtro não seja preenchido, o sistema buscará requisições de todos os Usuários disponíveis.

• Status: Selecione o estado atual da requisição que deseja acompanhar.
  • O filtro vem selecionado por padrão com a opção Todos.
  • As demais opções disponíveis são: Aguardando, Faturando e Erro.

---

4. Grade de Resultados

Ao clicar no botão Buscar com os filtros desejados aplicados (ou sem filtros para ver toda a fila ativa), o sistema exibirá os resultados na grade inferior. A grade exibirá estritamente processos que exigem atenção (status Erro ou Time out) ou estão em andamento (status Aguardando, Faturando e Processada).

4.1 Colunas da Grade

• Nº Nota Fiscal: Exibe o número da Nota Fiscal gerada. Enquanto a nota fiscal ainda não tiver sido processada, esta coluna permanecerá vazia. Caso o processo seja concluído com sucesso (mesmo após um Time out), este número se torna um link clicável que redireciona o usuário para a visualização da Nota Fiscal.

• Loja Origem: Exibe a Loja ou CD que originou a requisição de processamento do Faturamento Assíncrono.

• Origem Solicitação: Indica qual processo originou a requisição de processamento do Faturamento Assíncrono.

• Usuário Solicitante: Indica qual usuário iniciou a requisição de processamento do Faturamento Assíncrono.

• Data e Hora Solicitação: Indica o momento exato em que a requisição de processamento do Faturamento Assíncrono entrou na fila.

• Status Requisição: Exibe o status atual (Aguardando, Faturando, Processada, Erro ou Time out) do processamento da requisição de Faturamento Assíncrono.
  • Ao posicionar o mouse sobre um status de Erro ou Time out, o sistema exibe uma mensagem (tooltip) detalhando o motivo exato da falha ou lentidão no processamento.

• Ações: Exibe o botão de Remover (ícone de lixeira), para requisições de Faturamento Assíncrono com status Erro ou Time out e serve para limpar da tela registros que já não precisam mais ser acompanhados.
  • O botão de exclusão só estará disponível para usuários com a permissão 4432 – Acompanhamento de Faturamento Assíncrono: Excluir ativa.

---

5. Possíveis Dúvidas (FAQ)

1. Por que a minha requisição sumiu da tela de Acompanhamento Faturamento Assíncrono?
   • O sistema ocultará automaticamente e em tempo real todas as requisições de Faturamentos Assíncronos que forem Concluídas com sucesso. A tela de acompanhamento focará estritamente na fila ativa.
   • Caso a requisição tenha entrado em status de Erro ou Time out e um usuário com a devida permissão excluir esse registro, a mesma também sumirá da tela de acompanhamento.
   • Um terceiro motivo que pode fazer com que a requisição suma da tela de acompanhamento, é a rotina de limpeza (expurgo) automática de registros com Erro ou Time out com mais de 24 horas na fila.
2. O que significa o status Time out?
   • Se uma Nota Fiscal ficar travada processando (status Faturando) por mais de 15 minutos, o sistema alterará seu status para Time out e pulará automaticamente para processar a próxima requisição da fila. A nota fiscal com status Time out continuará sendo processada em segundo plano e, se finalizada com sucesso, o sistema exibirá o link dessa Nota Fiscal na tela de acompanhamento.
3. O que acontece quando excluo uma requisição (com status Erro ou Time out)?
   • A exclusão é apenas lógica e visual. A Nota Fiscal e o registro no banco de dados não são apagados. O botão serve apenas para o usuário limpar sua própria tela de acompanhamento, removendo erros que já foram tratados.
4. Preciso limpar todos os registros com status Erro ou Time out manualmente da tela?
   • Não. Para evitar poluição visual, o sistema possui uma rotina automática que limpa da grade (exclusão lógica) qualquer registro com status de Erro ou Time out que permaneça lá por mais de 24 horas.