Instalação e configuração do Certificado Digital A1 no ERP WEB
Instale o Certificado Digital A1 no Windows e configure-o no ERP WEB, nas rotinas fiscais e demais módulos.
Visão geral
Este manual orienta a instalação de um certificado digital do tipo A1 no computador e sua posterior configuração no ERP WEB. O processo é necessário sempre que um certificado for instalado pela primeira vez, renovado ou substituído, e envolve três frentes: a instalação do arquivo do certificado no Windows, a configuração do certificado nas rotinas fiscais (NF-e, NFC-e, CT-e, NFS-e, MDF-e) e a configuração para os demais módulos do sistema. Quando a empresa utiliza emissão de boletos via API bancária com o mesmo certificado da filial, é necessário também atualizar o certificado na carteira bancária correspondente.
Pré-requisitos
- Possuir o arquivo instalador do certificado digital A1 disponível no computador (extensão .pfx).
- Ter acesso ao sistema ERP WEB.
- Possuir permissão de acesso às rotinas envolvidas (Tabelas Auxiliares, Financeiro).
- Ter em mãos a senha do certificado digital.
- Procedimento indicado para supervisores de cada setor ou profissionais de Tecnologia da Informação (TI).
Quando utilizar
Utilize este procedimento ao instalar um certificado digital A1 novo, ao renovar ou substituir um certificado já existente, ou ao precisar vincular o certificado às rotinas fiscais e demais módulos do ERP WEB.
⚠ Atenção — Boletos via API bancária
Antes de trocar ou renovar o certificado digital, valide se a empresa utiliza emissão de boletos via API bancária, pois a troca pode impactar diretamente esses serviços. Esta validação é importante principalmente para clientes que utilizam:
- Emissão de boletos via API bancária;
- Integrações bancárias automatizadas;
- Carteiras bancárias configuradas com certificado digital igual ao da filial na emissão de notas fiscais.
Impacto da troca do certificado, após a renovação ou substituição:
- A emissão de boletos pode parar de funcionar;
- A API bancária pode rejeitar autenticação;
- O banco pode exigir atualização do certificado vinculado à carteira.
Ajustes necessários após a troca, caso o banco utilize o mesmo certificado da emissão de notas para comunicação dos serviços:
- Atualizar o caminho do certificado na carteira bancária;
- Importar o novo certificado novamente;
- Reconfigurar a autenticação da API bancária;
- Validar a comunicação com o banco após a troca.
(Os passos práticos desses ajustes estão detalhados na Etapa 5 deste manual.)
Como funciona
O certificado precisa primeiro ser instalado no repositório de certificados do Windows. Em seguida, ele é vinculado ao ERP WEB de duas formas diferentes, dependendo do uso:
- Rotinas fiscais (NF-e, NFC-e, CT-e, NFS-e, MDF-e): o vínculo é feito pelo Thumbprint (impressão digital) do certificado, informado no campo Certificado default da filial.
- Demais módulos do sistema: o vínculo é feito pelo caminho do arquivo do certificado (.pfx) e sua senha, informados na aba Configurações da filial.
Quando a carteira bancária usa o mesmo certificado da filial para comunicação de API, o caminho do certificado também precisa ser atualizado diretamente na credencial de acesso da API daquela carteira.
Passo a passo
Etapa 1 — Remoção de certificados anteriores (quando houver substituição)
⚠ Atenção
Este processo deve ser realizado apenas para certificados que serão substituídos.
Verificar certificados antigos
Antes de instalar o novo certificado, verifique se existe um certificado antigo instalado no computador que será substituído. Certificados antigos ativos devem ser removidos previamente para evitar conflitos na instalação ou utilização.
Abrir as Opções da Internet
No computador onde será instalado o novo certificado, acesse o menu de pesquisa do Windows (campo localizado na barra inferior da tela). Digite Opções da Internet ou Propriedades da Internet e clique sobre a opção exibida. Na janela aberta, localize a aba Conteúdo (posicionada na parte superior da tela) e clique sobre ela. Dentro dela, localize o botão Certificados (geralmente na região central da janela) e clique para abrir a lista de certificados instalados no computador.
Remover o certificado antigo
Na janela exibida, localize a aba Pessoal (normalmente a primeira aba da lista) e, caso não esteja selecionada, clique sobre ela. Nessa aba são exibidos todos os certificados digitais instalados no computador. Identifique o certificado a ser substituído e clique uma vez sobre ele para selecioná-lo. Localize o botão Remover (parte central da janela) e clique sobre ele. Será exibida uma janela de confirmação: clique em Sim para confirmar a remoção. Após a remoção, clique no botão Fechar (canto inferior direito da janela de certificados) e, em seguida, no botão Cancelar (canto inferior direito da janela de Propriedades da Internet) para encerrá-la.
Etapa 2 — Instalação do certificado digital A1
Iniciar o assistente de importação
Localize o arquivo do certificado digital no computador (normalmente com extensão .pfx) e dê um duplo clique sobre ele para iniciar o assistente de importação. Na primeira tela do assistente, localize a opção Local do Repositório, selecione Usuário Atual e clique no botão Avançar (canto inferior direito). Na tela seguinte, o campo Nome do arquivo já estará preenchido automaticamente; clique em Avançar.
Informar a senha e as opções de importação
Na tela Proteção de chave privada, localize o campo Senha (posicionado no centro da tela) e digite a senha do certificado digital. Ainda nesta tela, na seção Opções de Importação, marque as seguintes opções: Marcar esta chave como exportável (permite realizar backup do certificado futuramente) e Incluir todas as propriedades estendidas. Após preencher e marcar as opções, clique em Avançar.
Concluir a importação
Na tela Repositório de Certificados, selecione a opção Selecionar automaticamente o repositório de certificados conforme o tipo de certificado e clique em Avançar. Na tela final (Conclusão do Assistente), revise as informações apresentadas e clique no botão Concluir (canto inferior direito). Será exibida uma mensagem informando que a importação obteve êxito; clique em OK para finalizar.
Etapa 3 — Configuração do certificado nas rotinas fiscais do ERP WEB
⚠ Atenção
O procedimento descrito nesta etapa é válido somente para versões anteriores à 2026.3 do ERP WEB. A partir da versão 2026.3, a configuração do certificado digital passou por alterações e deve ser realizada seguindo um procedimento diferente deste manual. Antes de prosseguir, confirme a versão do seu ERP WEB.
Acessar o portal e a versão V.1
Abra o navegador utilizado pela empresa e acesse o endereço do portal ERP WEB. Na tela inicial, localize o botão ACESSAR V.1 (normalmente em destaque na página principal) e clique sobre ele. Uma nova página será aberta contendo os módulos do sistema.
Acessar o cadastro da filial
Na parte inferior da página, localize a área onde ficam os módulos do ERP WEB e procure pelo módulo Tabelas Auxiliares (normalmente no lado direito da listagem de módulos). Clique sobre ele. Dentro do módulo, localize a aba Cadastros Auxiliares e, dentro dela, a opção Filial; clique sobre ela. O sistema exibirá uma tela com todas as filiais cadastradas. Localize a filial correspondente ao certificado instalado, clique sobre ela, localize o botão Edição (normalmente no canto superior esquerdo da tela) e clique sobre ele. A tela de edição da filial será aberta.
Abrir a aba fiscal correspondente
A configuração do certificado deve ser feita nas abas fiscais necessárias: NF-e (Nota Fiscal Eletrônica), NFC-e (Nota Fiscal de Consumidor Eletrônica), CT-e (Conhecimento de Transporte Eletrônico), NFS-e (Nota Fiscal de Serviço) e MDF-e (Manifesto Eletrônico de Documento Fiscal); cada aba representa um serviço fiscal específico do ERP WEB. Na lateral esquerda da tela, localize e clique na aba fiscal correspondente ao serviço utilizado pela empresa e ao certificado instalado. Após abrir a aba, localize o campo Certificado default — este campo será utilizado para informar o Thumbprint do certificado digital.
Localizar o Thumbprint do certificado no Windows
No Windows, utilize a barra de pesquisa e digite Gerenciar certificados de usuário ou certmgr.msc; clique sobre a opção encontrada. Na lateral esquerda da janela, localize a pasta Pessoal, dê duplo clique sobre ela e depois clique em Certificados. Na área central serão exibidos os certificados instalados; localize o certificado correspondente à empresa ou filial e dê duplo clique sobre ele. Na janela do certificado, localize a aba Detalhes (normalmente na parte superior da janela, próxima das abas Geral e Caminho de Certificação) e clique sobre ela. Na lista de propriedades, utilize a barra de rolagem vertical e procure pela opção Impressão Digital; clique sobre ela. O código exibido na parte inferior da janela é o Thumbprint do certificado digital. Selecione e copie todo o conteúdo exibido.
Informar o Thumbprint na aba fiscal
Retorne ao ERP WEB, na filial com a edição aberta. No campo Certificado default, cole o código copiado no passo anterior.
Salvar
Localize o botão Salvar (normalmente no canto superior esquerdo da tela) e clique sobre ele. Após salvar, o certificado estará configurado corretamente para utilização nas rotinas fiscais.
Etapa 4 — Configuração do certificado para os demais módulos do sistema
Disponibilizar o certificado no servidor
No servidor onde o ERP WEB está instalado, abra o Explorador de Arquivos do Windows e acesse o disco principal do sistema operacional (normalmente C:\). Verifique se existe uma pasta chamada Certificados. Caso não exista, clique com o botão direito em uma área vazia, selecione Novo e depois Pasta, informando o nome Certificados. Copie o arquivo do certificado para dentro dessa pasta (C:\Certificados). Após mover o arquivo, copie o caminho completo do certificado (exemplo: C:\Certificados\nome_certificado.pfx).
Acessar novamente a edição da filial
No ERP WEB, acesse novamente o módulo Tabelas Auxiliares, a aba Cadastros Auxiliares, clique em Filial, selecione a filial desejada e clique em Edição.
Abrir a aba Configurações
Na lateral esquerda, localize a aba Configurações e clique sobre ela. Dentro dela, localize a seção Certificado digital, onde existirão os campos Arquivo e Senha.
Informar o arquivo e a senha
No campo Arquivo, informe o caminho completo do certificado copiado no Passo 13 (exemplo: C:\Certificados\nome_certificado.pfx).
⚠ Importante
O arquivo deve possuir obrigatoriamente a extensão .pfx no final do nome do arquivo.
No campo Senha, digite a senha correspondente ao certificado digital informado.
Salvar
Localize o botão Salvar (normalmente no canto superior esquerdo da tela) e clique sobre ele. Com isso, o certificado estará configurado corretamente para utilização nos demais módulos do ERP WEB.
Etapa 5 — Atualização do certificado na carteira bancária (somente quando aplicável)
Realize esta etapa nos seguintes cenários: emissão de boletos via API bancária; integrações bancárias automatizadas; ou carteiras bancárias configuradas com certificado digital igual ao da filial na emissão de notas fiscais. Caso o banco utilize o mesmo certificado digital configurado na filial para comunicação desses serviços, siga os passos abaixo.
Acessar o módulo Financeiro
Na parte inferior da página do ERP WEB, localize os módulos do sistema e procure pelo módulo Financeiro. Clique sobre o módulo.
Localizar a rotina Carteira
No canto esquerdo da página, localize a aba Cadastros e clique sobre a rotina Carteira.
Localizar a carteira utilizada
Identifique a carteira utilizada pelos serviços de: emissão de boletos via API bancária; integrações bancárias automatizadas; ou carteiras bancárias com certificado digital igual ao da filial alterada. Verifique se a carteira utiliza o mesmo certificado configurado na filial. Após localizá-la, clique sobre ela, localize o botão Edição e clique sobre ele.
Conferir a filial e abrir as credenciais de API
Na edição da carteira, verifique o campo Filial e confirme se ele corresponde ao certificado alterado. Em seguida, localize a aba Credenciais de Acesso de API e clique sobre ela para abri-la.
Identificar e editar a credencial
Localize a credencial utilizada pelo certificado digital, clique sobre ela e clique no botão Editar Credencial. Na tela de edição, localize os campos Certificado (armazena o Thumbprint do certificado digital utilizado pela credencial) e Caminho Certificado (usado pelo sistema para localizar o certificado no momento da autenticação da API).
⚠ Atenção
O caminho informado deve permanecer acessível para todos os computadores e serviços que utilizarão o certificado.
Para alterar o certificado, localize o botão Selecione ao lado do campo Certificado e clique sobre ele.
Informar o novo certificado e importar
Na tela Opção de Importação, no campo Arquivo, informe o caminho compartilhado do certificado digital (exemplo: \\192.168.1.25\Certificados\CERTIFICADO_DIGITAL.pfx).
⚠ Importante
A pasta onde o certificado está armazenado deve estar compartilhada na rede, e o computador que utilizará o certificado deve possuir acesso ao caminho informado.
No campo Senha, informe a senha do certificado digital. Após preencher os campos, localize o botão Importar e clique sobre ele.
Validar a importação
Caso os dados estejam corretos, será exibida a mensagem Certificado carregado com sucesso. Clique em OK.
Salvar as alterações
Ao retornar para a tela Editar Registro – Credenciais de Acesso API, clique no botão Salvar e Fechar. Em seguida, ao retornar para a tela da carteira, clique no botão Salvar. Repita este procedimento em todas as carteiras que utilizarem o certificado digital atualizado na filial.
Conteúdo Relacionado
- → Manual Relacionado: Instalação e vínculo do certificado A1 nas rotinas fiscais
📌 Observações
- Antes de trocar ou renovar o certificado digital, valide se a empresa utiliza emissão de boletos via API bancária — a troca pode interromper a emissão de boletos e levar a API bancária a rejeitar a autenticação, podendo o banco exigir atualização do certificado vinculado à carteira.
- Marcar a chave como exportável durante a importação permite realizar backup do certificado futuramente.
- O Thumbprint é usado para as rotinas fiscais (campo Certificado default); o caminho de arquivo e a senha são usados para os demais módulos e para a carteira bancária (campos Arquivo/Senha e Certificado/Caminho Certificado) — são duas formas distintas de vínculo do mesmo certificado.
- No campo Certificado da credencial de API, o valor armazenado é o Thumbprint; no campo Caminho Certificado, é o local do arquivo usado pelo sistema na autenticação.
- A pasta com o certificado compartilhado na rede deve permanecer acessível a todos os computadores e serviços que dependem dele.
- Nem todas as carteiras usam o certificado; nesses casos, é necessário gerar um novo certificado.
⚠ Atenção — Aviso de Escopo
As instruções acima são baseadas na documentação de produto fornecida. Situações não previstas neste manual devem ser abertas como novo chamado em: atak.movidesk.com