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.
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.
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.
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.
4. Configurando o SEDEX e o PAC
Com o contrato salvo, o próximo passo é configurar os módulos de transporte SEDEX e PAC.
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
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)