Certificado Digital A1
O que é, como obter, como funciona e por que o certificado A1 é obrigatório para emissão fiscal.
Certificado Digital A1
O certificado digital é a assinatura eletrônica da sua empresa. Sem ele, nenhum documento fiscal pode ser transmitido à SEFAZ — é o equivalente digital ao CNPJ físico com reconhecimento de firma.
Tipo A1 — Arquivo
Armazenado como arquivo .pfx ou .p12. Funciona em qualquer servidor. Suportado pela Engine API.
Tipo A3 — Token físico
Armazenado em token USB ou smartcard. Requer hardware dedicado. Não suportado.
Características
| Característica | Valor |
|---------------|-------|
| Formato | .pfx / .p12 |
| Validade | 1 ano (renovável) |
| Armazenamento | Arquivo no servidor |
| Proteção | Senha definida na emissão |
| Algoritmo | RSA 2048 bits |
| Padrão | ICP-Brasil |
Como Funciona na Emissão
Seu pedido de NFe (JSON)
↓
Engine API
├── Converte para XML SEFAZ
├── Assina com seu certificado A1 (RSA SHA-256)
├── Transmite via HTTPS para o webservice SEFAZ
└── Recebe autorização ou rejeição
↓
Você recebe o resultado (JSON) + webhook
O certificado é usado apenas para assinatura dos documentos. A Engine API não usa seu certificado para nenhuma outra finalidade.
Onde Obter
Compre um certificado e-CNPJ tipo A1 em uma Autoridade Certificadora (AC) credenciada pela ICP-Brasil:
| AC | Site | Observação | |----|------|-----------| | Certisign | certisign.com.br | Uma das mais populares | | Serpro | serpro.gov.br | AC governamental | | Valid | valid.com | Ampla rede de atendimento | | Serasa | serasacertificadora.com.br | Integrada ao bureau de crédito | | Soluti | soluti.com.br | Certificação 100% digital |
Certifique-se de pedir o certificado para e-CNPJ, não para CPF (e-CPF). A SEFAZ exige que o certificado seja emitido para o CNPJ emissor.
Upload via API
curl -X POST https://api.engineapi.com.br/companies/ISSUER_ID/certificate \
-H "Authorization: Bearer SEU_TOKEN" \
-F "certificate=@/caminho/certificado.pfx" \
-F "password=senhaDoCertificado"
O certificado é armazenado criptografado com AES-256. A senha nunca é retornada pela API após o upload.
Certificado para Testes (Homologação)
Em homologação, você pode usar:
- Seu certificado real — funciona normalmente no SEFAZ de teste
- Certificado expirado — o SEFAZ de homologação aceita
- Certificado de teste — emitido por qualquer AC, mesmo sem comprar
Você não precisa comprar um certificado novo só para testar. Use um certificado expirado ou de teste em homologação.