Certificados A1 — DFe DF02¶
Gestão dos certificados digitais A1 (arquivos
.pfx/.p12) usados para autenticar a comunicação dodfe-servicecom a SEFAZ. Cada empresa precisa ter o seu certificado válido para que a Sincronização SEFAZ consiga baixar documentos.
DF02 versus a tela geral de Certificados
Esta tela é dedicada ao DFe — mostra empresa por empresa, com foco no status do certificado usado pela sincronização. Para gerenciar certificados de outras finalidades (emissão de NF-e, etc.) use a tela geral do módulo Fiscal.
Pré-requisitos¶
- Estar logado como Master (upload e exclusão são restritos)
- Ter o arquivo
.pfxou.p12do certificado A1 e a senha definida no momento da emissão - A empresa precisa estar cadastrada em Empresas
Passo a passo¶
1. Acessar a tela¶
No menu lateral, clique em DFe → Certificados.
2. Ler os cartões resumo¶
No topo, quatro cartões mostram um panorama da frota de certificados:
| Cartão | Significado |
|---|---|
| No Prazo (verde) | Certificados válidos por mais de 60 dias |
| Expirando (amarelo) | Vencem em 30 a 60 dias — providencie renovação |
| Vencido (vermelho) | Já passou da validade — comunicação com SEFAZ falha |
| Sem Certificado (cinza) | Empresa cadastrada sem certificado anexado |
3. Ler a tabela de empresas¶
| Coluna | Descrição |
|---|---|
| Empresa | Razão social + CNPJ |
| Status | No Prazo / Expirando / Vencido / Não Cadastrado |
| Validade | Data de vencimento (DD/MM/AAAA) |
| Dias Restantes | Barra de progresso colorida (verde > 60d, amarelo > 30d, vermelho ≤ 30d) |
| Sync | Se a sincronização DFe está ativa nessa empresa |
4. Fazer upload de um certificado¶
Clique em Upload Certificado (topo da tela) ou no ícone de upload da linha da empresa.
Tela de upload¶
- Empresa — selecione no dropdown (já vem preenchida se você clicou da linha)
- Arquivo PFX — arraste o
.pfxou.p12para a área tracejada, ou clique para abrir o seletor - Senha do Certificado — digite a senha definida quando o certificado foi emitido
- Clique em Enviar Certificado
Como o certificado é armazenado
O arquivo PFX e a senha ficam criptografados no banco (AES-256 + DPAPI). Apenas o dfe-service consegue decifrar em tempo de execução para falar com a SEFAZ.
5. Substituir certificado¶
Faça upload de um novo para a mesma empresa — o anterior é substituído automaticamente. Não precisa excluir antes.
6. Excluir certificado¶
Clique no ícone de lixeira na linha da empresa. O sistema pede confirmação. Após excluir, a sincronização daquela empresa deixa de funcionar até um novo upload.
Renovação anual¶
Certificados A1 valem 1 ano. Recomendações:
- Configure alerta interno 60 dias antes do vencimento
- Compre o novo certificado antes do anterior vencer (evita parar a sincronização)
- Faça o upload do novo certificado assim que receber — substitui sem downtime
Erros comuns¶
Senha incorreta
O sistema valida a senha no momento do upload abrindo o PFX. Se a senha não bater, o upload é rejeitado com erro.
Arquivo não é PFX
Apenas extensões .pfx e .p12 são aceitas. Certificados A3 (cartão/token) não funcionam aqui — o DFe exige A1 (arquivo).
Certificado vencido
Empresas com certificado vencido aparecem no card vermelho. A sincronização recebe erro de SSL da SEFAZ até o certificado ser renovado.
Empresa não tem CNPJ cadastrado
O upload exige que a empresa tenha CNPJ preenchido em Configurações → Empresa, porque o certificado é validado contra esse CNPJ.