# Upload de certificado digital

> Upload de certificado digital é o envio do arquivo do certificado A1 (geralmente .pfx ou .p12) e de sua senha para um sistema emissor ou API fiscal, que passa a usá-lo para assinar digitalmente os documentos fiscais em nome da empresa. Sem esse passo, não é possível emitir NF-e, NFC-e, CT-e, MDF-e e, em muitos casos, NFS-e.

**Também conhecido como:** Envio de certificado digital, Importação de certificado digital, Cadastro de certificado digital, Upload do certificado A1, Digital certificate upload

**Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U

## Para que serve o upload de certificado digital?

Todo documento fiscal eletrônico precisa ser assinado digitalmente antes de ser enviado à SEFAZ ou à prefeitura. Essa assinatura comprova que o documento foi emitido pela empresa dona do CNPJ e que não foi alterado depois. Quem faz essa assinatura é o certificado digital da empresa.

Quando a emissão é feita por uma API fiscal, o certificado precisa estar disponível no servidor que monta e assina o XML. O upload é justamente o momento em que a empresa entrega esse certificado à plataforma, autorizando-a a assinar documentos em seu nome.

## Como funciona o upload de certificado digital?

Na prática, a empresa envia o arquivo do certificado e informa a senha que o protege. Isso pode ser feito por uma tela de administração, como um painel ou console, ou diretamente pela API. No envio por API, o arquivo costuma ser convertido para texto em Base64 e enviado dentro de uma requisição junto com a senha.

Ao receber o arquivo, o sistema normalmente faz algumas verificações: se a senha abre o certificado, se ele está dentro do prazo de validade e se o CNPJ do certificado corresponde à empresa cadastrada. Se algo estiver errado, o upload é recusado com uma mensagem explicando o problema.

Depois de aceito, o certificado fica vinculado à empresa emissora e passa a ser usado automaticamente em cada emissão, cancelamento, carta de correção e outros eventos fiscais.

## Qual certificado pode ser enviado: A1 ou A3?

Apenas o certificado do tipo A1 pode ser enviado por upload, porque ele é um arquivo comum instalado no computador ou servidor. Isso permite que a plataforma o use de forma automática, sem intervenção humana.

O certificado A3 fica gravado em um dispositivo físico, como token USB ou cartão, e sua chave privada não pode ser copiada para fora dele. Por isso, ele não serve para emissão automatizada em nuvem. Empresas que usam A3 e querem emitir por API geralmente precisam adquirir também um certificado A1.

## O upload de certificado digital é seguro?

O certificado A1 é, na prática, a identidade digital da empresa. Quem tem o arquivo e a senha pode assinar documentos como se fosse ela. Por isso, o upload deve ocorrer sempre por conexão criptografada (HTTPS) e o arquivo deve ser guardado de forma protegida pela plataforma.

Boas práticas incluem armazenar o certificado e a senha criptografados, em cofres de segredos ou serviços de gerenciamento de chaves, restringir quem pode enviar ou substituir certificados e registrar cada troca em trilha de auditoria. Do lado da empresa, o ideal é não circular o arquivo por e-mail ou mensagens e enviá-lo apenas pelos canais oficiais da plataforma.

## O que fazer quando o certificado vence ou é trocado?

O certificado A1 tem validade limitada, normalmente de um ano. Quando ele vence, a emissão para de funcionar e os documentos passam a ser rejeitados. Para evitar isso, é preciso renovar o certificado e fazer um novo upload antes da data de expiração.

Muitas plataformas mostram a data de validade e avisam com antecedência sobre o vencimento. Em ambientes com várias empresas, como ERPs e marketplaces que emitem para muitos CNPJs, acompanhar essas datas em um único painel evita interrupções inesperadas.

## Exemplos de Upload de certificado digital

- Um ERP que atende centenas de clientes oferece uma tela onde cada cliente anexa seu arquivo .pfx e digita a senha; o ERP converte o arquivo para Base64 e o envia pela API do emissor fiscal, vinculando o certificado ao CNPJ correto.
- Uma transportadora renova seu certificado A1 uma semana antes do vencimento e faz o upload do novo arquivo no console do emissor, garantindo que a emissão de CT-e e MDF-e continue sem interrupção.
- Um marketplace tenta cadastrar um vendedor, mas o upload é recusado porque o CNPJ do certificado é da matriz e não da filial cadastrada; o vendedor envia o certificado correto e a emissão é liberada.
- Uma equipe de desenvolvimento faz o upload de um certificado no ambiente de homologação para testar a emissão de NF-e antes de ativar a integração em produção.

## Perguntas frequentes

### Preciso fazer upload do certificado para cada documento emitido?

Não. O upload é feito uma vez por certificado. Depois disso, a plataforma usa o mesmo arquivo em todas as emissões e eventos da empresa até que ele vença ou seja substituído.

### Por que meu upload de certificado foi recusado?

Os motivos mais comuns são senha incorreta, certificado vencido, arquivo corrompido, formato diferente de .pfx ou .p12, ou CNPJ do certificado diferente do CNPJ da empresa cadastrada.

### Toda NFS-e exige upload de certificado digital?

Depende do município e do padrão usado. Muitas prefeituras e o Padrão Nacional da NFS-e exigem assinatura com certificado, mas alguns municípios aceitam outras formas de autenticação, como usuário e senha.

### Posso usar o mesmo certificado em mais de um sistema?

Sim, o certificado A1 pode ser enviado a mais de uma plataforma. Porém, quanto mais lugares guardam o arquivo, maior o risco de vazamento, então convém limitar essa distribuição.

## Termos relacionados

- [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md)
- [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md)
- [Base64 no envio de certificados](https://conota.dev/glossario/base64-no-envio-de-certificados.md)
- [Keystore de certificados digitais](https://conota.dev/glossario/keystore-de-certificados-digitais.md)
- [Gerenciamento de segredos](https://conota.dev/glossario/gerenciamento-de-segredos.md)
- [Gestão de empresas emissoras](https://conota.dev/glossario/gestao-de-empresas-emissoras.md)

---

Fonte: [Upload de certificado digital](https://conota.dev/glossario/upload-de-certificado-digital/) · Atualizado em 2026-10-22
