> 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/rastreamento/transportadoras/integrando-correios.md).

# Integrando Correios

## Dados necessários

| 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 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*                     |
| **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                                                                                 |

## Passo a passo para geração de Senha de API

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

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

Desça mais a tela e ensira os [dados necessários](#dados-necessarios):&#x20;

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

### 3. 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.**