Integração com os Correios
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.
