# 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 guiche. 

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

<figure><img src="/files/l0USCYJhfaJqvhhAATQO" alt=""><figcaption></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></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 dificil 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 & Devovla, muito mais fácil de configurar mas **com o a ressalva de que expiram em 180 dias**. A Cada 6 meses você precisa gerar novas chaves e atualizar no nosos painel.

### 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 Corrieos</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>Gerando um novo Código de acesso às API's (senha de API) Correios</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></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></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 proximo passo e gere a chave por cartão. Precisamos das duas.

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

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

<figure><img src="/files/l7O0UIKOlKdEOWwOmqjk" alt=""><figcaption></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></figcaption></figure>

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

<figure><img src="/files/4l6ORJR8ELr8ojZFErET" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/RTqHcvyepjdcRipBkN0A" alt=""><figcaption></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></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

Prencha 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></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></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></figcaption></figure>

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


---

# Agent Instructions: 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:

```
GET https://docs.troqueedevolva.com.br/configuracoes/transportadoras/integrando-correios.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.