Envio e etiquetas

API dos Correios: guia para lojistas Shopify

Por Fernando Simisatualizado em 7 min de leitura

API dos Correios: guia para lojistas Shopify

TL;DR: A API dos Correios permite a um sistema consultar preço, prazo e CEP, registrar a pré-postagem e acompanhar o rastreio sem passar pelo site. O acesso fica no portal CWS, com o usuário do contrato e uma senha da API gerada lá. Quem não programa usa essas APIs por meio de um aplicativo, como o meu frete.

Você ouviu que dá para ligar a loja direto na API dos Correios e ficou na dúvida se vale contratar um desenvolvedor ou se existe um caminho mais simples. A resposta depende do tamanho da sua operação e de quanto você quer manter de código. Este guia explica o que a API faz, como conseguir o acesso com o seu contrato e quando faz sentido programar ou usar um aplicativo pronto.

O que é a API dos Correios e o que ela faz?

API é a porta de entrada que os Correios oferecem para outros sistemas conversarem com os deles. Em vez de alguém digitar CEP e peso no site, o sistema da loja manda os dados e recebe a resposta na hora. Os serviços ficam reunidos no CWS, o portal de APIs dos Correios, que lista, entre outros, a calculadora de preço, a estimativa de prazo de entrega e a consulta de CEP.

Serviço O que resolve na loja
Preço Mostrar o valor do frete de cada modalidade para o CEP do cliente
Prazo Mostrar em quantos dias úteis o pedido chega
CEP Validar e completar o endereço do cliente
Pré-postagem Registrar o envio e gerar a etiqueta com código de rastreio antes de ir à agência
Rastreamento Consultar os eventos do pacote pelo código

Com contrato, a consulta de preço usa as condições do seu contrato, e não as de quem envia sem ele.

Quem pode usar a API dos Correios?

O acesso às APIs está ligado ao contrato com os Correios. Para conectar uma loja, você vai precisar de três dados, segundo o passo a passo da central de ajuda do meu frete.

  1. Senha da API, gerada no CWS, em Gestão de acesso a API's, depois de entrar com o usuário e a senha do Meu Correios. Os Correios mostram uma senha de 40 caracteres, com letras e números.
  2. Usuário, que aparece na mesma tela do CWS e geralmente é o próprio CNPJ do contrato.
  3. Número do cartão de postagem, que fica no portal Correios Empresas, em Cartões de Postagens.

Cuidado ao gerar a senha da API. Se o botão mostrar Regerar código, você já tem uma senha ativa, e gerar outra desativa na hora todas as integrações que usam a antiga. A senha da API também não é o token, e é ela que o meu frete pede.

Se você ainda não tem contrato, o guia preciso de contrato com os Correios? mostra quando vale a pena, e o post sobre MEI com contrato responde se o seu CNPJ pode contratar.

Integração própria ou aplicativo, qual escolher?

Ligar a loja direto na API é possível, mas o trabalho não termina quando o primeiro frete aparece no checkout.

Critério Integração própria Aplicativo pronto
Quem faz Um desenvolvedor, com conhecimento da API e da Shopify Você, preenchendo o painel
Manutenção Por sua conta sempre que os Correios mudarem regras ou serviços Feita pelo aplicativo
Peso cubado e caixas Você precisa programar a escolha da caixa e a conta de cada pedido Já resolvido no cálculo
Checkout da Shopify Você precisa integrar o cálculo ao checkout Frete aparece no carrinho, no checkout e na página do produto
Etiquetas Você programa a pré-postagem e a impressão Emissão pelo painel, pedido a pedido
Faz sentido quando A operação tem regras muito próprias e time técnico A loja quer frete certo sem manter código

A parte que mais costuma dar trabalho é a embalagem. A API responde o preço de um pacote com peso e medidas definidos, mas decidir em que caixa vão os itens de um pedido é tarefa de quem integra. O guia de peso cubado na Shopify mostra por que essa escolha muda o valor.

Como o meu frete usa a API dos Correios?

O meu frete conecta lojas Shopify e Wix às APIs dos Correios sem código, e transforma as consultas em recursos prontos.

  • Cálculo em tempo real de PAC, SEDEX, SEDEX 10, SEDEX 12, Mini Envios, Impresso Normal e Módico, no carrinho, no checkout e na página do produto.
  • Contrato do lojista no cálculo, com os três dados acima. Sem contrato próprio, o aplicativo calcula o frete do mesmo jeito.
  • Caixas e IA, com o cadastro das caixas da loja, uma IA que estima as medidas dos produtos e o cálculo com mais de uma caixa quando os itens não cabem em uma só.
  • Etiquetas pela pré-postagem, para quem tem contrato próprio, sem custo por etiqueta, com a DC-e em PDF separado e o código de rastreio vinculado ao pedido.

O meu frete trabalha só com os Correios e não faz envio internacional, logística reversa nem emissão de nota fiscal.

O que a API não resolve sozinha?

Mesmo com a integração pronta, algumas decisões continuam sendo da loja.

  • Peso e medidas corretos em cada produto, porque a resposta da API é tão boa quanto os dados enviados.
  • Tempo de separação, que precisa ser somado ao prazo dos Correios. No meu frete, isso é feito com os dias extras de processamento.
  • Regras comerciais, como frete grátis por região, que o meu frete configura no painel, ou frete fixo por estado, que é recurso da própria Shopify.

O guia completo do frete dos Correios na Shopify mostra todas as etapas em ordem.

Leia também

Perguntas frequentes

O que é a API dos Correios?

É o conjunto de serviços que permite a outros sistemas consultar preço, prazo e CEP, registrar a pré-postagem e acompanhar o rastreio nos Correios. Os serviços ficam reunidos no portal CWS.

Como gerar a senha da API dos Correios?

Entre no CWS com o usuário e a senha do Meu Correios, abra Gestão de acesso a API's, digite a senha do Meu Correios e clique em Gerar código. A senha da API tem 40 caracteres e é usada junto com o usuário e o número do cartão de postagem.

Preciso de contrato para usar a API dos Correios?

O acesso às APIs com as condições do seu contrato depende do contrato com os Correios. Sem contrato, o meu frete calcula o frete do mesmo jeito, mas a emissão de etiquetas exige contrato próprio.

Preciso de um programador para integrar a API na Shopify?

Não, se você usar um aplicativo. O meu frete faz a integração com os Correios sem código, e você só informa os dados do contrato no painel.

A API dos Correios calcula o peso cubado?

A API calcula o preço do pacote que recebe, com o peso e as medidas informados. Escolher a caixa de cada pedido fica com quem integra, e o meu frete faz isso com a IA de caixas.

Deixe a API dos Correios trabalhar sem escrever uma linha de código. Instale o meu frete e conecte o seu contrato para calcular o frete e emitir etiquetas na Shopify ou na Wix.

CompartilharWhatsAppLinkedIn