> For the complete documentation index, see [llms.txt](https://docs.londrisoft.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.londrisoft.com.br/unique/trilhas/markdown/esocial/como-corrigir-erro-de-certificado-digital-no-esocial.md).

# Como corrigir erro de certificado digital no eSocial

Corrija falhas do certificado digital ao transmitir eventos do eSocial pelo Unique.

## Como corrigir erro de certificado digital no eSocial

Use este roteiro quando o **certificado digital** impedir o envio de eventos ao eSocial pelo Unique. Ele também ajuda quando o certificado foi renovado ou quando o sistema não reconhece um certificado A3.

### Objetivo

Restabelecer o acesso ao certificado digital correto e concluir a transmissão ao eSocial.

### Contexto

Siga este roteiro quando ocorrer uma destas situações:

* A empresa renovou ou substituiu o certificado digital.
* O Unique tenta usar um certificado anterior.
* Um certificado A3, em token ou cartão, funciona no e-CAC, mas não no Unique.
* O envio retorna falha de comunicação, como `403 Forbidden`.

Siga as verificações na ordem indicada. A reassociação resolve a maior parte dos casos.

{% hint style="warning" %}
Antes de excluir arquivos, faça uma cópia em outra pasta. Assim, você poderá restaurá-los se necessário.
{% endhint %}

### Passo a passo para reassociar o certificado digital

1. Feche o Unique em todas as estações.
2. Acesse a pasta de instalação do Unique. Geralmente, ela fica no servidor ou na estação usada pelo sistema.
3. Abra a pasta **Dados** e selecione a pasta do código da empresa.

<figure><img src="https://1430854409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62AD5ySkOmU2eaGvTaoQ%2Fuploads%2FLogNvaWfGe7J6gzIIBvs%2Fimage.png?alt=media&amp;token=85fee3ea-a8aa-4d4e-9c75-13b691843bc2" alt=""><figcaption></figcaption></figure>

1. Abra a pasta **certificado**.
2. Faça uma cópia dos arquivos `certificado` e `senha` em outra pasta.
3. Exclua os arquivos `certificado` e `senha` da pasta original.
4. Abra o Unique e selecione novamente o certificado digital da empresa.

Siga o roteiro de seleção em [Como selecionar o certificado digital no Unique](/unique/trilhas/markdown/esocial/como-selecionar-o-certificado-digital-no-unique.md).

### Verifique o certificado A3 e os componentes do eSocial

Faça esta verificação somente se o erro persistir. Ela é mais comum com certificado A3.

Os componentes do certificado ficam, normalmente, em `...\Unique\Atualiza\dll\esocial\`:

* `Londrisoft_certificado.dll`
* `Londrisoft_esocial.dll`

Esses componentes usam .NET com COM Interop. Registre-os com **RegAsm**. Não use `regsvr32`.

1. Abra o **Prompt de Comando** como administrador na máquina do Unique.
2. Confirme se o Unique usa arquitetura de **32 bits** ou **64 bits**.
3. Execute o RegAsm correspondente para cada arquivo.

**Para 32 bits:**

```
C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe /codebase "C:\caminho\completo\Londrisoft_certificado.dll"
C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe /codebase "C:\caminho\completo\Londrisoft_esocial.dll"
```

**Para 64 bits:** substitua `Framework` por `Framework64` nos comandos.

4. Confirme a compatibilidade entre o driver do token e a arquitetura do Unique.
5. Reinstale o driver compatível, se necessário.

Um token pode funcionar no navegador e ainda falhar no Unique. Isso ocorre quando o driver não acessa a chave privada na arquitetura usada pelo sistema.

### Verificações adicionais do certificado digital

Se o erro continuar, confira estes itens:

* **Permissão da chave privada:** abra `certmgr.msc`. No certificado, selecione **Gerenciar Chaves Privadas**. Confirme a permissão do usuário que executa o Unique.
* **Cadeia de certificação:** confirme a instalação das autoridades certificadoras intermediária e raiz em **Autoridades de Certificação Raiz Confiáveis**.
* **TLS 1.2:** confirme que a estação permite conexões TLS 1.2 para os serviços do eSocial.
* **Proxy ou firewall:** verifique regras que possam bloquear a conexão HTTPS ou remover o certificado do cliente.
* **Visualizador de Eventos:** em **Logs do Windows → Aplicativo**, procure erros de `mscoree` ou `System.Runtime.InteropServices` no horário da falha.

### Validação do envio ao eSocial

Tente transmitir um evento do eSocial após concluir as verificações.

Considere o processo concluído quando o Unique reconhecer o certificado correto e o evento for enviado sem falha de certificado ou comunicação.

### Quando encaminhar ao time técnico

Encaminhe o chamado após concluir as etapas deste artigo. Informe:

* Código e nome da empresa afetada.
* Tipo do certificado, A1 ou A3.
* Fabricante do token, quando aplicável.
* Mensagem completa do erro e captura de tela.
* Arquitetura do Unique, 32 ou 64 bits.
* Resultado da reassociação e do registro dos componentes.

### FAQ

<details>

<summary>Quando devo reassociar o certificado digital?</summary>

Reassocie o certificado quando a empresa o renovar ou substituir. Faça também quando o Unique selecionar um certificado anterior.

</details>

<details>

<summary>Por que o certificado A3 funciona no e-CAC, mas não no Unique?</summary>

O driver do token pode não ser compatível com a arquitetura do Unique. Confirme se o driver oferece versão de 32 ou 64 bits compatível.

</details>

<details>

<summary>O que significa o erro 403 Forbidden no envio?</summary>

O erro pode indicar falha de acesso ao certificado ou bloqueio na comunicação. Reassocie o certificado e revise os componentes, o TLS 1.2 e a rede.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.londrisoft.com.br/unique/trilhas/markdown/esocial/como-corrigir-erro-de-certificado-digital-no-esocial.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
