Skip to main content

​
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ísticaValor
Formato.pfx / .p12
Validade1 ano (renovável)
ArmazenamentoArquivo no servidor
ProteçãoSenha definida na emissão
AlgoritmoRSA 2048 bits
PadrãoICP-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:
ACSiteObservação
Certisigncertisign.com.brUma das mais populares
Serproserpro.gov.brAC governamental
Validvalid.comAmpla rede de atendimento
Serasaserasacertificadora.com.brIntegrada ao bureau de crédito
Solutisoluti.com.brCertificaçã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.

​
Veja também

Certificados — Guia Completo

Upload, monitoramento de validade e renovação

SEFAZ

Como funciona a infraestrutura da Fazenda