Como configurar o contrato dos Correios (Novo Dashboard)


 

O que essa integração faz por você

Habilite o cálculo de frete dos Correios na sua loja, usando o seu próprio contrato firmado diretamente com os Correios.


 

📦 Frete calculado com seu contrato
O valor do frete passa a ser calculado com as condições do seu contrato com os Correios.

🔑 Integração via API
A chave de acesso obtida no CWS Correios conecta seu contrato diretamente à plataforma.

🔗 Base para SEDEX e PAC
Depois de configurado, o contrato serve de base para configurar os módulos de SEDEX e PAC.
 



 

Antes de começar (pré-requisitos)

Contrato ativo com os Correios, formalizado em uma agência ou pelo site oficial dos Correios.

Acesso ao portal Correios Empresas.

Acesso ao portal CWS Correios.


 



 

1. Obtendo os dados no Correios Empresas

Ao final desta seção, você terá em mãos o cartão de postagem com os dados do seu contrato.



 

1. Acesse o site Correios Empresas.

2. Faça login com os dados do seu contrato.

3. Localize e baixe o cartão de postagem, que é aberto em uma nova guia ou baixado no seu computador.

 

 

 



 

⚠️ Atenção: o campo Diretoria do painel Irroba corresponde ao campo SUP.EST do seu cartão de postagem dos Correios.



 

✅ Resultado esperado: você tem em mãos o cartão de postagem com os dados do contrato, incluindo o campo SUP.EST.



 

2. Obtendo a chave de API no CWS Correios

Ao final desta seção, você terá o usuário e a chave de API necessários para o painel Irroba.



 

1. Acesse o site CWS Correios.

2. Clique em Entrar e preencha os dados de acesso.

3. Anote o usuário exibido nesta página — ele é o usuário que você vai inserir no painel Irroba.

4. Copie a chave da API, com cerca de 40 caracteres alfanuméricos.


 

 

 

⚠️ Atenção: confira se a chave copiada tem cerca de 40 caracteres alfanuméricos antes de colá-la no painel Irroba — uma chave incompleta impede o cálculo do frete.



 

✅ Resultado esperado: você tem em mãos o usuário exibido no CWS Correios e a chave da API, prontos para o painel Irroba.



 

3. Preenchendo os dados no painel Irroba

Ao final desta seção, o contrato dos Correios estará configurado e pronto para o cálculo de frete.



 

1. No painel Irroba, acesse a tela de configuração do contrato dos Correios.

2. Preencha os campos com os dados obtidos nas seções anteriores.

  • Diretoria: corresponde ao campo SUP.EST do cartão de postagem, obtido no Correios Empresas.
  • Correios API — usuário: usuário exibido na página de login do CWS Correios.
  • Correios API — senha/chave: chave da API obtida no CWS Correios, com cerca de 40 caracteres alfanuméricos.

 

3. Clique em Salvar para aplicar as configurações do contrato.

 



 

✅ Resultado esperado:   após salvar, o cálculo de frete dos Correios (PAC/SEDEX) passa a considerar as condições do seu contrato.

 

 



 

4. Configurando o SEDEX e o PAC

Com o contrato salvo, o próximo passo é configurar os módulos de transporte SEDEX e PAC.


 

📘 Configurando o PAC e SEDEX

A configuração específica dos módulos de transporte SEDEX e PAC tem um artigo próprio, com o passo a passo detalhado de cada modalidade.

Ver o passo a passo da Configurando o PAC e SEDEX →



 

5. Erros comuns e soluções

O cálculo de frete dos Correios não funciona após salvar.

Causa provável: a chave da API pode estar incompleta ou expirada, ou o contrato ainda pode estar em análise pelos Correios.

Como resolver: confira se a chave da API tem cerca de 40 caracteres e se o contrato já foi aprovado pelos Correios; se necessário, gere a chave novamente no CWS Correios.



 

6. Perguntas frequentes (FAQ)

O usuário do campo "Correios API" vem do Correios Empresas ou do CWS Correios?

 


 

Não encontrou o que precisava?

Abrir chamado com o suporte Irroba


 

João Pedro Cerqueira

Ajuda Irroba

Última atualização:

Esse artigo foi útil?

Usuários que acharam isso útil: 0 de 0

Tem mais dúvidas?

Envie uma solicitação