Agente Fênix: certificado A3 (token) e impressora térmica

O certificado A1 é um arquivo e o sistema o guarda com segurança no servidor. Já o certificado A3 (token USB ou cartão) tem uma regra de ouro: a chave nunca sai do dispositivo. Por isso o sistema, que roda na internet, não consegue usá-lo sozinho. Para isso existe o Agente Fênix: um programa pequeno que você instala no computador onde o token está ligado. Ele assina as notas e fala com a SEFAZ usando o token, e devolve o resultado ao sistema. A chave e o PIN ficam só no seu computador.

O mesmo programa também imprime direto na impressora térmica (sem janela de impressão) e abre a gaveta de dinheiro. Quem usa certificado A1 e não precisa dessas duas coisas não precisa instalá-lo.

• Windows 10 ou 11 (64 bits) no computador do caixa.
• Para A3: o driver do token do fabricante instalado, e o certificado aparecendo no Windows (Pesquisar › Gerenciar certificados de usuário › Pessoal).
• Para impressora: o driver da térmica instalado normalmente.
• A permissão Agente Fênix (administradores têm).

1. Abra Configurações › Integrações › Agente Fênix e clique em Baixar o instalador.
2. Extraia o ZIP inteiro em uma pasta e execute Instalar.cmd. Não precisa ser administrador.
3. O programa abre ao lado do relógio do Windows e passa a iniciar junto com o computador.

1. No sistema, em Para qual máquina?, escolha o caixa do PDV onde o agente vai ficar (os caixas vêm do cadastro em PDV › Caixas e Terminais; o nome e a empresa já vêm de lá). Para uma máquina que não é caixa, por exemplo só para o certificado A3 na NF-e, escolha Outra máquina e dê um nome.
2. Clique em Gerar código. O código fica na tela até você fechá-lo, e dá para copiar com um clique (vale 15 minutos e só pode ser usado uma vez).
3. No programa, informe o endereço do sistema (ex.: meusistema.com.br) e o código. Em testes na própria máquina, 127.0.0.1:8000 funciona sem https.
4. Pronto: na lista aparece Online, com os certificados e as impressoras que a máquina tem. A impressão de cada caixa vai para o agente dele.

1. Vá em Fiscal › Configuração da NF-e. Em Certificado digital, o bloco "Certificado A3 pelo Agente Fênix" lista os certificados encontrados.
2. Clique em Usar este certificado. O sistema guarda só o certificado público e a impressão digital dele.
3. A partir daí, emitir, cancelar, corrigir e inutilizar funcionam como sempre. O Windows pede o PIN do token na máquina do caixa quando uma nota é assinada.

O computador com o token precisa estar ligado, com o programa aberto e o token conectado na hora de emitir. Se não estiver, o sistema avisa "Nenhum Agente Fênix está online" e nada é emitido pela metade.

Em Agente Fênix, clique em Testar (confere a comunicação) ou Imprimir teste (imprime uma página de teste na impressora escolhida).

• A chave do certificado e o PIN nunca vão para o sistema.
• O agente só usa certificados da própria máquina e só acessa endereços do governo (.gov.br) com eles.
• O token do agente fica protegido pelo Windows. Se a máquina for perdida ou trocada, clique em Revogar: o agente deixa de funcionar na hora.

• Não aparece certificado: instale o driver do token, conecte-o e reabra o programa.
• "O Agente Fênix não respondeu a tempo": o programa está fechado, a máquina sem internet, ou o PIN não foi digitado a tempo.
• Código inválido ou expirado: gere um novo em Novo código.
• Atualizar o programa: baixe o novo instalador e execute Instalar.cmd de novo (o pareamento é mantido).