Integrando Correios

A Troque e Devolva emite a autorização de postagem integrada aos 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:

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.

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/
Código Administrativo	Número do seu código administrativo	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

Insira seu usuário e senha cadastrados nos Correios:

Tela de login dos Corrieos

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

Atenção: Esta senha será utilizada em todos os sistemas integrados com os Correios. 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.

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":

Gerando um novo Código de acesso às API's (senha de API) Correios

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

3.2 Integrando pela Chave de Acesso

Atenção: São duas chaves que você vai precisar gerar.

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:

Depois clique em Criar chave de acesso:

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

3.2.1 Chave de acesso por Contrato

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

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

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:

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

4. Como consultar o Código Administrativo

Acesse o site sfe.correios.com.br e faça login com sua conta dos Correios. Após acessar o painel, vá até a seção “Contratos”

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

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

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

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:

Configurando os Correios

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:

Dados de integração com os Correios

Se você vai integrar por Chaves de Acesso:

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.

Depois disso, clique em Salvar.

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:

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