Pular para o conteúdo principal

Certificados Digitais

Todo documento fiscal precisa ser assinado com certificado e-CNPJ tipo A1.

TipoFormatoSuporte
A1Arquivo .pfx/.p12✅ Suportado
A3Token/Smartcard❌ Não suportado

Upload

curl -X POST https://api.engineapi.com.br/companies/{issuerId}/certificate \
-H "Authorization: Bearer SEU_TOKEN" \
-F "certificate=@/caminho/certificado.pfx" \
-F "password=senhaDoCertificado"
aviso

A senha é criptografada (AES-256) e nunca é retornada pela API.

Validade

Certificados A1 têm validade de 1 ano. Alertas via webhook:

  • 30 dias antes: certificate.expiring_soon
  • 7 dias antes: certificate.expiring_critical
  • Expirado: certificate.expired

Atualizando

Faça upload novamente — o anterior é substituído automaticamente.