Suporte: seg. a sex., das 9h às 18h

API Correios

Atualizado em 05/10/2026

Os Correios lançaram uma nova API REST para cálculo de preços e prazos de envio. A versão anterior foi descontinuada, então a migração para o novo sistema é obrigatória.

Com a nova API, sua loja calcula frete e consulta CEP direto com os Correios, com mais precisão e estabilidade.

Pré-requisitos

  • Contrato ativo com os Correios.
  • Credenciais de acesso ao sistema Meus Correios (login e senha).
  • Credenciais da API, solicitadas ao gerente responsável pelo seu contrato.

Visão geral da integração

  1. Confirme que as credenciais da API estão ativas.
  2. Gere as chaves de acesso no portal dos Correios.
  3. Informe os dados no painel da loja e ative a API.

Como gerar as chaves de acesso

São duas chaves, geradas separadamente: uma para Preços e Prazos, outra para Pré-Postagem.

Atenção: as duas chaves precisam ser geradas em processos separados. Tentar gerar as duas de uma vez exibe uma mensagem de erro.

Chave de Preços e Prazos

  1. Acesse o portal https://cws.correios.com.br e clique em Chaves de acesso.
  2. Em identificação, informe B! - Preços e Prazos.
  3. Em descrição, informe integracao@braavo.com.br.
  4. Defina a expiração para 180 dias (ao expirar, refaça o processo).
  5. Preencha o número do contrato.
  6. Habilite todas as opções como Acesso total.
  7. Clique em Criar nova chave.

Chave de Pré-Postagem

  1. Acesse o portal https://cws.correios.com.br e clique em Chaves de acesso.
  2. Em identificação, informe B! - Pré Postagem.
  3. Em descrição, informe integracao@braavo.com.br.
  4. Defina a expiração para 180 dias (ao expirar, refaça o processo).
  5. Preencha o número do cartão de postagem.
  6. Habilite todas as opções como Acesso total.
  7. Clique em Gravar.

Configuração na loja

No painel, vá em Fretes > Serviços, clique em Ajustes e, no grupo Geral, em Configurar na linha dos Correios. Na seção Chave de acesso, preencha:

  1. Cartão de postagem, com os zeros à esquerda.
  2. Contrato e DR (Diretoria Regional).
  3. Chave de acesso de Preços e Prazos.
  4. Chave de acesso de Pré-postagens.

Em seguida, ligue Usar o contrato da loja na API REST, no topo da tela, revise a Taxa do seguro na seção Valor declarado e seguro (em branco, vale 2%) e clique em Gravar.

Atenção: com uma chave de acesso preenchida, a tela exige também o cartão de postagem, o contrato e a DR, e não liga a API REST sem uma forma de autenticação. Por segurança, as chaves nunca voltam para a tela: depois de gravadas, o campo aparece vazio, com a confirmação "Chave gravada". Deixar o campo em branco ao gravar mantém a chave atual.

A seção Código de acesso (obsoleto) guarda a forma antiga de autenticação, com o Usuário e o Código de acesso da API. Com uma chave de acesso preenchida, a loja usa a chave, então essa seção só importa para quem ainda não gerou as chaves.

O teste ao gravar

Ao gravar com a API ligada, a tela testa a conexão com os Correios na hora e mostra o resultado no aviso do topo:

  • Dados gravados, com "Preços e Prazos - Conectado" e "Pré Postagens - Conectado" (ou, no código de acesso, "API REST conectada" com o contrato e a DR) — está tudo certo, e o selo da visão geral passa a Contrato conectado.
  • Aviso amarelo, com uma das duas como "Não conectado" — a API fica ligada, mas a parte que falhou não funciona: sem Preços e Prazos, a cotação e a consulta do rastreio falham; sem Pré Postagens, a postagem e o reverso falham. Confira a chave indicada e grave de novo.
  • Dados gravados, mas a API REST foi desligada — os Correios recusaram as credenciais. A tela grava os dados e desliga a API, para a loja não ficar sem frete.

Bom saber: com a API REST desligada, a loja continua cotando pelos Correios, mas pela tarifa de balcão. A postagem, o reverso e a verificação automática da data de entrega dos Correios ficam indisponíveis, porque dependem do contrato da loja. O selo da visão geral mostra Sem contrato até a conexão dar certo.

Se algo der errado: revise os dados informados ou entre em contato com o gerente do seu contrato nos Correios.

Artigos relacionados