Oi, DEV! 👋
Crie sua conta para acessar mais recursos do portal.

ProblemCertificadoDigitalExceptionCertificado

Certificado digital não localizado ou o mesmo está com falha

Este erro ocorre quando uma operação que exige o uso de certificado digital (como o envio ou consulta de boletos) é realizada sem que um certificado válido esteja corretamente configurado. Isso pode acontecer por aus...

Atualizado em 15 de abr. de 2025, 18:48

Problema

Este erro ocorre quando uma operação que exige o uso de certificado digital (como o envio ou consulta de boletos) é realizada sem que um certificado válido esteja corretamente configurado.
Isso pode acontecer por ausência do certificado, envio incorreto ou falha na leitura do mesmo.

Solução

Verifique se um certificado digital foi corretamente configurado antes de realizar a operação. Assegure-se dos seguintes pontos:

  • O certificado foi realmente enviado junto à requisição?
  • O certificado é compatível com o tipo de operação que está sendo executada (e-CNPJ ou e-CPF, por exemplo)?
  • O certificado não está expirado (verifique a validade no próprio arquivo ou ferramenta de gerenciamento)?
  • O certificado está íntegro e legível (sem erros de formatação, corrupção ou senha incorreta, no caso de .pfx)?
  • Se estiver usando certificado A1 (arquivo), verifique se o caminho e a senha estão corretos.
  • Se estiver usando certificado A3 (cartão/token), verifique se o dispositivo está conectado e reconhecido pela máquina/servidor.
Recomenda-se testar o certificado em ferramentas de validação antes de utilizá-lo na API. Caso esteja utilizando um ambiente de homologação, verifique se o certificado corresponde ao ambiente esperado.