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


---

# 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/rastreamento/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.