Instalar e vincular o certificado A1

Etapa 4 de 11 do processo Implantar a empresa. Anterior: Cadastrar inscrições estadual, municipal e de substituto em outra UF. Próxima: Configurar ambiente, séries e numeração.

Mostra onde se cadastra o certificado digital A1 (arquivo, senha, tipo) e como vinculá-lo à empresa. O ambiente de captura não tem certificado real: o vídeo abre o formulário sem carregar arquivo e vincula o certificado de teste do template.

Visão geral: Preparar a empresa para operações fiscais brasileiras

Limites deste cenário

Sem certificado real no ambiente de captura: não carrega arquivo, não grava senha e não assina documento. O certificado vinculado é o de teste do template, de outro CNPJ, usado só para ilustrar o vínculo. Certificado A3 (token ou cartão) não é tratado aqui. O aviso de vencimento é o parâmetro Alerta de Certificado Expirado (padrão 30 dias); o vídeo só aponta o campo e não demonstra o aviso disparando. Na consulta de DF-e o certificado precisa ser o do ator da consulta (pessoa jurídica da empresa ou pessoa física autorizada). Certificado em nuvem e provedor de assinatura (PAA) não são suportados e o fornecedor consultado não os indica para emissão em massa (ver Emitir com certificado em nuvem ou por provedor PAA). A rejeição 291 e a orientação sobre o ator da consulta vêm da central da TecnoSpeed (https://atendimento.tecnospeed.com.br/hc/pt-br/articles/360014106654 e https://blog.tecnospeed.com.br/certificado-digital-na-nuvem): conferir no Manual de Orientação do Contribuinte vigente.

Importante

Certificado de teste: este ambiente não usa certificado real.

Vídeo

Duração: 2 min 13 s. Sem áudio: a narração está nas legendas, na faixa de baixo do vídeo.

Antes de começar

Exemplo usado neste cenário

A empresa fictícia Loja Modelo Ltda recebe, no campo NFe da aba Certificados, o certificado A1 de teste que acompanha a base de demonstração. No uso real, o administrador cadastra o arquivo do próprio certificado em Fiscal -> Configuração -> Outros -> Certificado, e depois o escolhe na empresa.

Como os valores são calculados:

  • O certificado A1 é um arquivo (padrão PKCS#12, extensão .pfx ou .p12) protegido por senha, com validade de 1 ano (ICP-Brasil). Um A1 emitido em 10/03/2026 vence em 10/03/2027.

  • O campo É Válido (is_valid) depende da data: o certificado de teste do template é gerado na instalação da base, com validade de 1 ano, e deixa de ser válido depois disso. Por isso o cenário confere a existência do vencimento, não o valor de is_valid.

  • O Odoo lê do próprio arquivo o emissor, o titular, o CNPJ e as datas de início e vencimento; o certificado é válido enquanto a data de vencimento for maior ou igual à data atual.

  • O CNPJ-base (8 primeiros dígitos) do certificado deve ser o do emitente; senão a SEFAZ rejeita a nota (rejeição 213, MOC NF-e).

Passo a passo

  1. Abra o aplicativo Fiscal e, em Configuração -> Outros, clique em Certificado.

  2. Clique no certificado de teste NF-e e confira a data de vencimento e o campo É Válido? marcado.

  3. Clique em Novo para ver o formulário de um certificado.

  4. Aponte o Tipo de certificado e o Subtipo A1.

  5. Aponte o botão de envio do arquivo e a Senha: aqui nada é carregado.

  6. Clique em Descartar: o vídeo não grava nenhum certificado real.

  7. Em Definições, pesquise Certificado Expirado e aponte o aviso de vencimento, 30 dias antes.

  8. Em Usuários e Empresas, clique em Empresas.

  9. Clique na empresa Loja Modelo Ltda.

  10. Abra a aba Fiscal.

  11. Dentro dela, abra a aba Certificados.

  12. Em NFe, escolha o certificado de teste.

  13. Salve a empresa pelo ícone de nuvem ao lado do nome.

  14. Reabra as abas Fiscal e Certificados: o certificado NFe está vinculado.

Resultado esperado

Empresa salva com o certificado A1 vinculado no campo NFe. Aqui o certificado é de teste e serve só para mostrar o vínculo: não serve para assinar nem transmitir. Só com um certificado real, válido e do mesmo CNPJ raiz da empresa, o mesmo caminho habilita a assinatura e o envio das notas.

Se houver erro

  • Ao salvar o certificado aparece erro de senha ou de arquivo. A senha não abre o arquivo ou o arquivo não é um A1 em formato PKCS#12. Confira a senha com a autoridade certificadora e use o arquivo .pfx ou .p12 original.

  • A SEFAZ rejeita a nota com a rejeição 213. O CNPJ-base do certificado é diferente do CNPJ-base do emitente. Vincule à empresa o certificado emitido para o mesmo CNPJ-base dela.

  • O certificado aparece como não válido. A data de vencimento já passou. Renove o certificado com a autoridade certificadora e cadastre o arquivo novo.

  • A SEFAZ rejeita a nota com a rejeição 291 (certificado de assinatura vencido). O certificado A1 da empresa passou da data de vencimento e ninguém renovou a tempo. Renove e cadastre o arquivo novo, e ajuste o aviso de vencimento em Definições para ter mais antecedência.

Módulos usados

Também usa: l10n_br_fiscal_certificate. Os valores do exemplo foram conferidos automaticamente na execução gravada; a conferência não substitui a validação do contador da sua empresa.