Integração de Frete com os Correios via API

A plataforma possui integração nativa com os Correios. Neste artigo, você verá o passo a passo para configurar essa integração e habilitar o cálculo de frete dos Correios na sua loja. 

Passo 1: Gerando as Credenciais no Portal "Meu Correios"

Antes de iniciar a configuração na plataforma, você precisa gerar um código de acesso específico para APIs dentro do sistema dos Correios.

1. Acesse o Sistema: Clique para acessar o sistema CWS (WebServices dos Correios).

2. Faça Login: No canto superior direito, clique em Entrar. Utilize suas credenciais do "IdCorreios" ou "MeuCorreios" (Pessoa Jurídica/Correios Empresa). Se ainda não tiver cadastro, clique em "Cadastrar" e siga as instruções na tela.

3. Acesse a Gestão de APIs: No menu lateral esquerdo, selecione a opção Gestão de acesso a API's.

4. Regere o Código de Acesso: Na tela "Regerar código de acesso às APIs", preencha os campos solicitados:

• Usuário: Preenchido automaticamente com seu login.

• Senha: Digite a mesma senha que utilizou para entrar no portal.

5. Gere o Código: Clique no botão Regerar código.

6. Salve a Informação: Um código longo de acesso será exibido. Copie e guarde-o em um local seguro. Ele será a sua "Senha de Acesso às APIs" na plataforma.

Nota Importante: Este procedimento não altera a senha que você usa para logar nos portais dos Correios; ele apenas cria uma chave de comunicação para sistemas. Aguarde cerca de 10 minutos após a geração antes de prosseguir, garantindo que os Correios sincronizem o novo código.

Se tiver qualquer dificuldade na criação do cadastro ou da senha para as APIs, solicite ajuda pelo e-mail comercioeletronico@correios.com.br.

Passo 2: Configurando a Integração na Plataforma Wake

Com as credenciais comerciais validadas pelos Correios, acesse o painel administrativo da plataforma para habilitar o serviço.

1. Navegue até o menu: Fretes >> Correios >> aba Correios API.

2. Preencha os seguintes campos obrigatórios:

• Usuário do Portal Meu Correios: O seu login de acesso ao portal dos Correios.

• Senha de Acesso às APIs: O código gerado no final do Passo 1.

• Cartão de Postagem: O número do seu cartão de postagem do contrato comercial com os Correios (inclua os dois zeros iniciais se aplicável).

3. Clique no botão Gerar Token:

Atenção: O token de comunicação expira a cada 24 horas e é renovado automaticamente em segundo plano pela plataforma, mantendo a integração ativa caso todos os dados fornecidos permaneçam válidos.
 

Para garantir que o token seja gerado corretamente e a integração ativada com sucesso, é imprescindível que todos os campos sejam preenchidos corretamente. Certifique-se de fornecer todas as informações necessárias para gerar o token e ativar a integração de forma eficaz. 
 

Passo 3: Configurações Adicionais de Envio

Configure as regras de negócio para o cálculo de frete da sua loja.

1. Dimensões Máximas e Mínimas de Embalagem

O sistema respeita os limites operacionais dos Correios descritos na tabela abaixo:

A soma resultante do comprimento + largura + altura não deve superar 200 cm.

A soma resultante do comprimento + o dobro do diâmetro não pode ser menor que 28 cm.
 

2. Serviços Opcionais

Ative os serviços adicionais que serão somados aos contratos de envio quando solicitados:

• Aviso de Recebimento (AR): Fornece comprovação física assinada por quem recebeu a encomenda, garantindo validade jurídica.

• Valor Declarado: Garante direito à indenização comercial em caso de extravio ou avaria, proporcional ao valor preenchido na nota fiscal/conteúdo.

• Incluir serviço de Mão Própria: Serviço que garante a entrega exclusivamente às pessoas indicadas pelo REMETENTE, podendo haver, para cada encomenda, até três indicações. 

Observação importante: A integração via API não contempla o serviço adicional de "Mão Própria".
 

3. Outras Configurações - Ajustes de Prazos e Valores

• Prazo Mínimo Para Despacho da Encomenda: Defina o prazo mínimo (em dias) do despacho da encomenda.

• Acréscimo de Dias no Prazo de Envio: Dias extras somados preventivamente ao prazo oficial retornado pelos Correios (útil para margens de segurança).

• Porcentagem sobre os Serviços: Margem de segurança financeira em porcentagem (%) que será somada ao custo do frete calculado pelos Correios.
   

4. Serviços dos Correios

• Serviços dos Correios: Lista onde você pesquisa, visualiza e ativa as modalidades de envio do seu contrato (ex: SEDEX, PAC).
   

5. Centro Distribuição

• Centro de Distribuição: Selecione e vincule quais CDs utilizam esta modalidade de frete com os Correios para despacho.
   

Passo 4: Finalização e Auditoria

Após validar todas as informações e faixas de operação, clique no botão Salvar na parte inferior da tela.

Caso precise analisar mudanças futuras, use o menu Histórico de Alterações na mesma página para verificar o registro (log) de quem alterou e quais configurações foram salvas.

💡 Dica de Contingência (Tabela Reserva): Para garantir que sua loja não fique sem opções de entrega em caso de eventuais instabilidades temporárias na API dos Correios, recomendamos fortemente a configuração de uma tabela de segurança. Para entender a importância e conferir o passo a passo completo dessa implementação, acesse o nosso guia sobre Configurando sua Tabela de Frete Contingência para Correios.