> For the complete documentation index, see [llms.txt](https://docs.troqueedevolva.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.troqueedevolva.com.br/configuracoes/transportadoras/integrando-correios.md).

# Integrando Correios

A **logística reversa dos Correios** é uma solução prática para devolução de produtos.\
Com a autorização de postagem, o cliente não precisa imprimir etiquetas: basta levar o pacote a uma agência própria ou franqueada, informar o código e pronto. Medição, pesagem e impressão da etiqueta são feitas pelos Correios.

Como a autorização é emitida via contrato empresarial, não há custo na hora da postagem. O valor do frete é cobrado posteriormente, junto com os envios mensais do contrato.

### 1. Como o cliente recebe o código de autorização

Quando você emitir uma autorização, vamos disponibilizar o **Código de Rastreamento** ao seu cliente. Com ele, o cliente irá em uma das agências dos Correios e informará esse código no guichê. 

O código ficará disponível no histórico da solicitação:

<figure><img src="/files/l0USCYJhfaJqvhhAATQO" alt=""><figcaption><p>Código de rastreamento no histórico da solicitação</p></figcaption></figure>

Além disso, seu cliente receberá um e-mail dos Correios com a etiqueta de postagem para uso em **Lockers**. Nesse caso, será necessário imprimir e colar a etiqueta na embalagem antes da postagem.

<figure><img src="/files/0KOeTt2IpKPEqH66KnMX" alt=""><figcaption><p>E-mail dos Correios com a etiqueta para postagem em Locker</p></figcaption></figure>

### 2. Dados necessários

Existem **duas maneiras** de integrar os Correios na Troque & Devolva.

A primeira é fornecendo o **Código de Acesso às API's**, uma senha geral que dá acesso às API's de forma genérica. Como é uma senha única, talvez seja difícil você conseguir obtê-la. É o modo legado (antigo) de concessão de acesso.

E a segunda forma é através de **Chaves de Acesso**, senhas geradas exclusivamente para uso na Troque & Devolva, muito mais fáceis de configurar, mas **com a ressalva de que expiram em 180 dias**. A cada 6 meses você precisa gerar novas chaves e atualizar no nosso paine

#### 2.1 Dados básicos comuns:

| Dado                                | Descrição                           | Onde conseguir                                                                                           |
| ----------------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Usuário de API**                  | Usuário do portal dos Correios      | [https://cws.correios.com.br/](https://cws.correios.com.br)                                              |
| **Código Administrativo**           | Número do seu código administrativo | [sfe.correios.com.br](https://sfe.correios.com.br) → Você pode consultar o passo a passo completo abaixo |
| **Cartão de Postagem**              | Número do cartão de postagem        | Fornecido pelos Correios                                                                                 |
| **Código do Serviço PAC Reverso**   | Geralmente: `03301`                 | Disponível na consulta do seu Cartão de Postagem                                                         |
| **Código do Serviço SEDEX Reverso** | Geralmente: `03247`                 | Disponível na consulta do seu Cartão de Postagem                                                         |

#### 2.2 Acesso ao site CWS – Gestão de APIs dos Correios

Acesse o site de gestão de APIs dos Correios por meio do seguinte link [**https://cws.correios.com.br**](https://cws.correios.com.br)

Insira seu **usuário** e **senha** cadastrados nos Correios:

<figure><img src="/files/0w39B9TNtj7kzQpH3TKJ" alt=""><figcaption><p><br>Tela de login dos Correios</p></figcaption></figure>

### 3. Gerando as credenciais de integração

#### 3.1 Integrando pela senha padrão - Código de acesso às API's

| Dado                                          | Descrição                     | Onde conseguir                                                                       |
| --------------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------ |
| **Código de Acesso às API\`s (senha de API)** | Gerada no portal dos Correios | <https://cws.correios.com.br/acesso-componentes> → *Gerar código de acesso às API's* |

Além dos dados comuns, você precisará da senha, que ensinamos como gerar abaixo.

#### 3.1.1 Gerando a Senha de API\`s

{% hint style="danger" %} <mark style="color:red;">**Atenção: Esta senha será utilizada em todos os sistemas integrados com os Correios.**</mark>\
\ <mark style="color:red;">Antes de gerar uma nova senha, recomenda-se verificar se é possível obtê-la em outro sistema onde já esteja em uso. Caso você faça a geração de uma nova senha, não se esqueça de atualizar em todos os demais sistemas integrados às API's dos Correios.</mark>
{% endhint %}

Para gerar uma nova senha, insira a senha utilizada no portal **Meus Correios,** a mesma utilizada para acessar o Portal Correios.  Em seguida, clique em **"Regerar Código":**

<figure><img src="/files/NYbkGWBbc6KIcSCKAaiB" alt=""><figcaption><p>Geração de um novo código de acesso às APIs</p></figcaption></figure>

Anote a senha gerada, pois este será seu **novo Código de Acesso às APIs Correios**.

#### 3.2 Integrando pela Chave de Acesso&#x20;

{% hint style="warning" %}
Atenção: **São duas chaves que você vai precisar gerar**.&#x20;
{% endhint %}

| Dado                                       | Descrição                     | Onde conseguir                                                        |
| ------------------------------------------ | ----------------------------- | --------------------------------------------------------------------- |
| **Chave de acesso por Contrato**           | Gerada no portal dos Correios | <https://cws.correios.com.br/acesso-componentes> → *Chaves de Acesso* |
| **Chave de acesso por Cartão de Postagem** | Gerada no portal dos Correios | <https://cws.correios.com.br/acesso-componentes> → *Chaves de Acesso* |

Os Correios não permitem gerar uma única chave com as permissões por contrato e por cartão de postagem que precisamos. Por isso, você terá que gerar duas chaves para inserir em nosso painel.

Acesse o link **Chaves de acesso:**

<img src="/files/XkKGWOkCneH3pC6TicUH" alt="" data-size="original">

Depois clique em **Criar chave de acesso:**

<figure><img src="/files/471IOzsqsLu0NsIBP4oV" alt=""><figcaption></figcaption></figure>

Preencha os dados básicos, como nome, descrição e **insira a validade para 180 dias:**

<figure><img src="/files/2uAymRRzLZByWR4TtGGd" alt=""><figcaption><p>Preenchimento do nome, descrição e validade da chave</p></figcaption></figure>

#### 3.2.1 Chave de acesso por Contrato

Para o contrato, **informe o seu número do contrato** habilite as seguintes APIs:

<figure><img src="/files/MIJ8PiKLFpsXMPKgkP08" alt=""><figcaption><p>APIs habilitadas na chave de acesso por contrato</p></figcaption></figure>

Depois clique em **Criar nova chave**. Copie o código fornecido que você usará para cadastrar dentro do painel.&#x20;

Agora, faça o próximo passo e gere a chave por cartão. Precisamos das duas.

#### 3.2.2 Chave de acesso por Cartão

Para o cartão, **informe o seu número do cartão de postagem** e habilite a seguinte API:

<figure><img src="/files/l7O0UIKOlKdEOWwOmqjk" alt=""><figcaption><p>API habilitada na chave de acesso por cartão de postagem</p></figcaption></figure>

Não esqueça de ativar o **Acesso Total** para que o sistema seja capaz de criar etiquetas no seu contrato.&#x20;

### 4. Como consultar o Código Administrativo

Acesse o site [sfe.correios.com.br](https://sfe.correios.com.br) e faça login com sua conta dos Correios.\
\
Após acessar o painel, vá até a seção **“Contratos”**

<figure><img src="/files/qWa9ucWISSDaWDImYWuc" alt=""><figcaption><p>Seção Contratos no portal SFE dos Correios</p></figcaption></figure>

Clique no campo **“Pesquisar”** para localizar o contrato desejado.

<figure><img src="/files/4l6ORJR8ELr8ojZFErET" alt=""><figcaption><p>Pesquisa do contrato no portal SFE</p></figcaption></figure>

\
Em seguida, clique no ícone de **três pontos (•••)** ao lado do contrato listado.

<figure><img src="/files/RTqHcvyepjdcRipBkN0A" alt=""><figcaption><p>Menu de opções do contrato</p></figcaption></figure>

Isso abrirá a tela de detalhamento do contrato, onde estará disponível o **número do Código Administrativo**.

<figure><img src="/files/jat0bQSuBspPUnkCmUZw" alt=""><figcaption><p>Código administrativo no detalhamento do contrato</p></figcaption></figure>

\
**Verifique o código e confirme se ele está corretamente cadastrado no painel da Troque e Devolva.**

## Integrando os Correios na Troque e Devolva

Dentro do **Painel Troque e Devolva,** clique em **Configurações** -> **Transportadoras**. Depois, clique no botão **Criar Transportadora**.

### 1.Preenchendo o nome e instruções de postagem

Preencha o nome da transportadora **Correios** e as **instruções de postagem.** Na lista de transportadoras, selecione **Correios:**

<figure><img src="/files/6ZRS0r55BuPK87fV3ZvW" alt=""><figcaption><p>Configurando os Correios</p></figcaption></figure>

### 2. Preenchendo as credenciais de integração Correios

Aqui depende de como você escolheu integrar, se será por Código de Acesso ou Chave de acesso (que explicamos acima).

Se você vai integrar por **Código de Acesso às APIs**:

<figure><img src="/files/hy07vuzYQXHsyD6L9AZS" alt=""><figcaption><p>Dados de integração com os Correios</p></figcaption></figure>

Se você vai integrar por **Chaves de Acesso**:

<figure><img src="/files/6WdiJzuBbVJOWZQEu2O5" alt="" width="375"><figcaption><p>Credenciais de integração por chaves de acesso</p></figcaption></figure>

### 3. Configurando os valores padrão

Em seguida, escolha quais os valores padrão para a emissão da etiqueta: método de postagem, modalidade (PAC é o mais barato) e o prazo que o cliente terá para postar nos Correios.

Você pode desabilitar o e-mail automático enviado pelos Correios. Como a Troque & Devolva já notifica o cliente sobre o status da devolução, o e-mail dos Correios acaba sendo redundante. Se preferir uma comunicação mais limpa, basta manter apenas o nosso e-mail ativado.

<figure><img src="/files/aHwnELZ2zQkg3GctmrFJ" alt="" width="563"><figcaption><p>Configuração dos valores padrão da transportadora</p></figcaption></figure>

Depois disso, clique em **Salvar**.&#x20;

### 4. Aguardando a autenticação

O sistema irá verificar as credenciais informadas e exibirá detalhes, caso encontre algum erro.

#### **Em caso de usuário ou senha errada, um aviso como:**

<figure><img src="/files/cSn6S0UuRG0Lu5THNhgv" alt=""><figcaption><p>Aviso de código de acesso incorreto</p></figcaption></figure>

**Componente Logística Reversa:**

<figure><img src="/files/OPwHMJ0tRijTMCKBhLTA" alt=""><figcaption><p>Aviso de ccmponente Logítica Reversa</p></figcaption></figure>

Acesse a seção **"Gestão de acesso a API's"** e verifique se o módulo **250 – Logística Reversa** está disponível.

Caso o módulo não esteja presente, você precisa solicitar a habilitação do módulo **Logística Reversa (250)** ao gestor do seu contrato nos Correios.

\
Se não aparecer nenhum aviso, **os Correios estarão integrados em sua conta.**