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
- Confirme que as credenciais da API estão ativas.
- Gere as chaves de acesso no portal dos Correios.
- 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
- Acesse o portal https://cws.correios.com.br e clique em Chaves de acesso.
- Em identificação, informe B! - Preços e Prazos.
- Em descrição, informe integracao@braavo.com.br.
- Defina a expiração para 180 dias (ao expirar, refaça o processo).
- Preencha o número do contrato.
- Habilite todas as opções como Acesso total.
- Clique em Criar nova chave.

Chave de Pré-Postagem
- Acesse o portal https://cws.correios.com.br e clique em Chaves de acesso.
- Em identificação, informe B! - Pré Postagem.
- Em descrição, informe integracao@braavo.com.br.
- Defina a expiração para 180 dias (ao expirar, refaça o processo).
- Preencha o número do cartão de postagem.
- Habilite todas as opções como Acesso total.
- 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:
- Cartão de postagem, com os zeros à esquerda.
- Contrato e DR (Diretoria Regional).
- Chave de acesso de Preços e Prazos.
- 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.
