Principal Integrações Integração com os Correios

Integração com os Correios

Última atualização em Mar 23, 2026

1. Integrando com os Correios

Os Correios oferecem integração via Correios Web Services (CWS), uma plataforma de APIs REST que permite conectar a Secret Solutions diretamente aos sistemas dos Correios para consultar CEP, cotar frete, rastrear objetos, criar pré-postagens, gerar etiquetas e muito mais — tudo de forma automatizada e sem acesso manual ao site dos Correios.

Antes de começar — Pré-requisitos

Para utilizar o CWS você precisará de:

  • Cadastro ativo no portal Meu Correios (meucorreios.correios.com.br)

  • Contrato ativo de prestação de serviços com os Correios — o acesso às APIs restritas está vinculado ao contrato/cartão de postagem

  • Código de acesso gerado dentro do CWS (explicado abaixo)

⚠️ Atenção: Sem um contrato ativo com os Correios, apenas as APIs públicas estarão disponíveis. As APIs de pré-postagem, preço, prazo e rastreamento exigem contrato.

Passo a Passo — Configurando o acesso ao CWS

1. Criando seu cadastro no Meu Correios

  1. Acesse meucorreios.correios.com.br.

  2. Clique em Cadastrar e siga as instruções para criar seu perfil de pessoa jurídica.

  3. Após o cadastro, vincule seu contrato com os Correios ao perfil para liberar as APIs restritas.

2. Acessando o Correios Web Services (CWS)

  1. Acesse o ambiente de homologação em cwshom.correios.com.br para testes, ou o ambiente de produção em cws.correios.com.br para uso real.

  2. Clique em Entrar e informe o usuário e senha cadastrados no Meu Correios.

  3. Após o login, você terá acesso ao painel principal do CWS.

3. Gerando o Código de Acesso

O Código de Acesso é a senha que autoriza a geração do Token para consumo das APIs.

  1. No painel do CWS, clique no ícone de menu (☰) no canto superior esquerdo.

  2. Acesse Gestão de Acesso a APIs.

  3. Informe a senha do Meu Correios.

  4. Clique em Gerar código de acesso.

  5. Copie e guarde o código gerado — ele será usado como senha na geração do Token.

💡 Dica: Caso já possua um código, o sistema solicitará confirmação antes de gerar um novo. Ao gerar um novo código, o anterior é invalidado imediatamente.

4. Gerando o Token de Acesso

O Token é a chave criptografada que autoriza todas as requisições às APIs dos Correios. Ele tem validade de 24 horas e pode ser usado em múltiplas APIs durante esse período.

  1. No painel do CWS, clique em Credenciais.

  2. Escolha o tipo de autorização conforme sua necessidade:

    • Por Usuário/Código de Acesso — acessa todas as APIs liberadas para o usuário.

    • Por Contrato — acessa todas as APIs vinculadas ao número do contrato informado.

    • Por Cartão de Postagem — acessa todas as APIs vinculadas ao cartão de postagem informado.

  3. Preencha o código de acesso gerado no passo anterior.

  4. Clique em Gerar Token.

  5. Copie o token gerado — ele será inserido no cabeçalho de todas as requisições no formato Bearer {token}.

Passo a Passo — Conectando os Correios à Secret Solutions

  1. Acesse a Central de Integrações da Secret Solutions clicando no ícone de tomada no canto superior direito da tela de aplicativos.

  2. No menu de categorias, clique em Transportadoras.

  3. Localize e clique sobre o card dos Correios.

  4. Preencha o campo Token com a chave gerada no CWS na etapa anterior.

  5. Clique em Salvar e depois em Testar para validar a conexão.

  6. Quando a integração estiver ativa, o status Conectado será exibido na tela.

O que é possível fazer após a integração

Com os Correios conectados à Secret Solutions, as seguintes operações passam a funcionar automaticamente:

Consulta de CEP Validação e preenchimento automático de endereços a partir do CEP do destinatário, reduzindo erros de digitação no checkout.

Cotação de Frete (Preço e Prazo) Consulta em tempo real das opções de frete disponíveis para o CEP de destino, levando em conta peso, dimensões e serviços adicionais contratados (ex: Aviso de Recebimento, Mão Própria).

Pré-Postagem Criação eletrônica dos objetos postais com todos os dados necessários — remetente, destinatário, serviço contratado e dados do pacote — antes de levar o pedido à agência dos Correios. A validação ocorre campo a campo, garantindo assertividade no processo de postagem.

Geração de Etiqueta Após a criação da pré-postagem, a etiqueta de endereçamento no padrão Correios é gerada automaticamente e pode ser impressa diretamente pela plataforma.

Rastreamento de Objetos Consulta do status de qualquer objeto postal usando o código de rastreio. Os principais status atualizados automaticamente são: Objeto Postado, Em Trânsito, Saiu para Entrega, Entregue, Tentativa de Entrega, Devolvido ao Remetente e Objeto Extraviado.

Subdelegando acesso para a Secret Solutions

Caso prefira não fornecer diretamente suas credenciais do Meu Correios, os Correios oferecem o recurso de Subdelegação de Acesso — que permite gerar uma Chave de Acesso exclusiva para a Secret Solutions, sem expor sua senha principal.

  1. No CWS, acesse o menu Chaves de Acesso ou entre em cws.correios.com.br/chaves-acesso.

  2. Clique em Criar Nova Chave.

  3. Preencha o Nome de Identificação, a Descrição e o tempo de Expiração da chave.

  4. Selecione as APIs que deseja liberar (por idCorreios, por Contrato ou por Cartão de Postagem).

  5. Clique em Criar Nova Chave para gerar a chave.

  6. Copie a chave gerada e insira-a no campo de autenticação da Secret Solutions.

⚠️ Atenção: Nunca compartilhe sua chave de acesso com terceiros não autorizados. Para revogar uma chave comprometida, acesse a lista de Chaves de Acesso no CWS e clique no ícone de lixeira ao lado da chave desejada.

💡 Dicas de Boas Práticas

Renove o Token antes de expirar. O Token tem validade de 24 horas. Para evitar interrupções na sincronização, configure a renovação automática antes do vencimento.

Use a autorização por Cartão de Postagem sempre que possível. Ela restringe o acesso apenas às APIs do cartão informado, reduzindo o risco em caso de vazamento das credenciais.

Homologação antes de produção. Sempre teste a integração no ambiente de homologação (cwshom.correios.com.br) antes de ativar em produção. Os dados de homologação não afetam sua conta real nos Correios.

Preencha todos os dados da pré-postagem. Os campos são validados individualmente pelos Correios. Dados incompletos ou incorretos resultam em erro na criação do objeto, evitando surpresas no balcão da agência.