Envio de Mensagens e Ativação Manual de Contingência (NFC-e/EPEC)

1. Descrição do Recurso e Conceito Operacional

Este recurso permite o acionamento manual e remoto do modo de contingência (NFC-e e EPEC) para os terminais de Ponto de Venda (PDV), integrado a um sistema de mensageria em lote via Painel de Controle AtendeSmart.

Em condições normais, o PDV entra em modo de contingência automaticamente em caso de queda de internet, indisponibilidade total da SEFAZ ou queda dos serviços do AtendeSmart. O modelo de operação manual visa mitigar cenários de instabilidade parcial da SEFAZ, onde o web service estadual permanece “online”, porém respondendo com lentidão extrema ou gerando rejeições intermitentes. Nestes casos, o fallback automático do PDV não é acionado. Este módulo permite que a equipe de suporte ou operações force a contingência para garantir a continuidade das vendas físicas, além de disparar comunicados informativos para a tela dos operadores.

2. Fluxo Lógico do Sistema (Back-end & Aplicação Local)

A arquitetura deste recurso funciona no modelo de comando centralizado (Nuvem) para terminais distribuídos (Local):

• Origem do Comando: O gatilho é disparado a partir da retaguarda web (Painel AtendeSmart).
• Tráfego e Sincronização: Os comandos de ativação e as strings de mensagem são enfileirados no servidor e transmitidos para o serviço de escuta dos PDVs locais.
• Regra de Roteamento: O payload (mensagem/comando) é roteado para os nós finais baseando-se no registro de licença do cliente. A chave primária para roteamento em lote é o Estado (UF). Se o parâmetro UF não for enviado na requisição, o back-end fará um broadcast, atingindo todos os CNPJs listados no grid de pesquisa atual do painel.
• Dependência Crítica: Para que o tráfego da instrução chegue ao PDV, é mandatório que haja conectividade de internet no cliente e que o serviço local do AtendeSmart esteja online e comunicando no momento do disparo.

3. Guia de Configuração e Ativação

Siga rigorosamente os passos abaixo no Painel de Controle para acionar o recurso:

Fase A: Filtragem e Seleção de Alvos

1. Acesse o Painel de Controle AtendeSmart.
2. Defina os alvos da ação:
   • Para um cliente específico: Utilize os filtros de busca padrão para isolar o registro.
   • Para múltiplos clientes (Busca Global): Deixe todos os campos de filtro em branco. No campo CNPJ/EMPRESA/BANCO, digite o termo ATENDE. (Nota técnica: Este método realiza um full scan e é consideravelmente mais lento).

Fase B: Mensageria e Ativação

3. No canto inferior da tela, clique no Ícone de Engrenagem para expandir o painel de parâmetros operacionais.

4. (Opcional) No campo de texto habilitado, digite a Mensagem que deverá aparecer na tela do PDV.

5. Selecione a UF (Estado) correspondente. Isso garante que a mensagem só será exibida nos PDVs cuja licença esteja cadastrada para aquele Estado. Se este campo ficar em branco, todos os clientes da lista atual receberão o comando.

6. Clique no botão Cadastrar para consolidar o envio da mensagem.

7. Para forçar a emissão offline, role até o final do painel expandido e clique nas opções Ativar contingencia (para NFC-e padrão) ou Ativar EPEC, conforme a diretriz fiscal necessária para o momento.

4. Resultado Esperado (Critérios de Sucesso na Implantação)

Para atestar que o comando de contingência ou a mensagem foram aplicados com sucesso, o analista deve validar os seguintes comportamentos no PDV local:

• Sinalização Visual: A mensagem parametrizada no painel web deve aparecer imediatamente como um pop-up ou aviso fixo na interface do operador de caixa.
• Status de Emissão: O indicador de status da NFC-e no PDV deve mudar do estado “Normal” para o modo de contingência selecionado (Offline ou EPEC).
• Validação Física: As próximas vendas processadas devem ser impressas contendo o cabeçalho “EMITIDA EM CONTINGÊNCIA”, garantindo que a operação de venda foi concluída sem depender do tempo de resposta da SEFAZ instável.

5. Resolução de Problemas (Troubleshooting)