A plataforma de frete mais barata do Brasil!
Documentação para desenvolvedores

Consulte CEP e frete balcão em JSON ou XML.

Use sua chave de consumo para consultar endereços e preços de balcão dos Correios, respeitando as unidades e o consumo de cada rota.

Cadastro rápido e acesso pelo painel CepCerto
Referência oficial

CEP e frete balcão — referência técnica

Escolha o assunto para consultar credenciais, parâmetros e exemplos de requisição. Para conhecer os serviços antes de integrar, veja a apresentação das APIs.

30 requisições e exemplosTestar no Postman

Teste primeiro em desenvolvimento. Gerar PIX cria uma cobrança; emitir postagem pode debitar saldo e contratar frete; cancelar postagem altera a operação e pode solicitar estorno.

API Cálculo de Frete — Balcão e Desconto CepCerto

Preço de balcão é o preço oficial cobrado diretamente pelos Correios. Na mesma resposta, a API apresenta o preço CepCerto com desconto e a economia disponível para PAC e SEDEX. Quando elegível, apresenta também Mini Envios, disponível somente pelo CepCerto.

Correios — PAC e SEDEX

Como usar

Retorna o valor cobrado diretamente pelos Correios, sem desconto CepCerto.

GET

Ver a página exclusiva desta API

Endpoint JSON

https://cepcerto.com/ws/json-frete/cep_origem/cep_destino/peso_gramas/altura_cm/largura_cm/comprimento_cm/sua_chave

Endpoint XML

https://cepcerto.com/ws/xml-frete/cep_origem/cep_destino/peso_gramas/altura_cm/largura_cm/comprimento_cm/sua_chave
ParâmetroComo enviar
cep_origemCEP com 8 dígitos. O hífen é aceito e removido automaticamente.
cep_destinoCEP com 8 dígitos. O hífen é aceito e removido automaticamente.
peso_gramasPeso maior que zero e no máximo 30.000 gramas. Exemplo: envie 1000 para 1 kg.
altura_cmAltura maior que zero e no máximo 100 cm.
largura_cmLargura maior que zero e no máximo 100 cm.
comprimento_cmComprimento maior que zero e no máximo 100 cm.
Soma das dimensõesaltura_cm + largura_cm + comprimento_cm não pode ultrapassar 200 cm.
sua_chaveChave de consumo disponível na Área Restrita.

Compatibilidade: integrações antigas que enviam peso sem unidade entre 0,1 e 30 continuam sendo interpretadas em quilogramas. Para novas integrações, envie sempre o peso em gramas.

Exemplo JSON

GET https://cepcerto.com/ws/json-frete/01527050/11440001/300/4/16/24/SUA_CHAVE

Retorno JSON

{
  "ceporigem": "01527050",
  "cepdestino": "11440001",
  "peso_gramas": 300,
  "altura_cm": 4,
  "largura_cm": 16,
  "comprimento_cm": 24,
  "valorpac": "25,80",
  "valorpac_desconto_cepcerto": "21,34",
  "economiapac_cepcerto": "4,46",
  "prazopac": "6",
  "valorsedex": "27,60",
  "valorsedex_desconto_cepcerto": "25,80",
  "economiasedex_cepcerto": "1,80",
  "prazosedex": "2",
  "valorminienvios_cepcerto": "14,90",
  "prazominienvios_cepcerto": "7 dias"
}

Regras do Mini Envios

Mini Envios é oferecido somente pelo CepCerto e não possui preço de balcão. Seus campos de valor e prazo aparecem apenas quando estiver disponível para a rota e o pacote tiver até 300 g, altura até 4 cm, largura até 16 cm, comprimento até 24 cm, valor declarado até R$ 100,00, sem AR, sem Mão Própria e com destino em outra cidade.

Exemplo XML

GET https://cepcerto.com/ws/xml-frete/01527050/11440001/300/4/16/24/SUA_CHAVE

Retorno XML

<xml>
  <ceporigem>01527050</ceporigem>
  <cepdestino>11440001</cepdestino>
  <peso_gramas>300</peso_gramas>
  <altura_cm>4</altura_cm>
  <largura_cm>16</largura_cm>
  <comprimento_cm>24</comprimento_cm>
  <valorpac>25,80</valorpac>
  <valorpac_desconto_cepcerto>21,34</valorpac_desconto_cepcerto>
  <economiapac_cepcerto>4,46</economiapac_cepcerto>
  <prazopac>6</prazopac>
  <valorsedex>27,60</valorsedex>
  <valorsedex_desconto_cepcerto>25,80</valorsedex_desconto_cepcerto>
  <economiasedex_cepcerto>1,80</economiasedex_cepcerto>
  <prazosedex>2</prazosedex>
  <valorminienvios_cepcerto>14,90</valorminienvios_cepcerto>
  <prazominienvios_cepcerto>7 dias</prazominienvios_cepcerto>
</xml>
Consumo: 2 consultas, uma para PAC e outra para SEDEX.

Regras por endpoint

Unidades, limites, campos obrigatórios, autenticação, consumo e códigos HTTP.

Teste antes de publicar

Use o ambiente de desenvolvimento e valide respostas antes de operar em produção.

Coleção Postman

Importe requisições, exemplos e environments oficiais para começar rapidamente.

Dúvidas frequentes

Tudo o que você precisa saber

Qual unidade de peso devo enviar no frete balcão?

Em novas integrações das rotas /ws, informe o peso em gramas. Por exemplo, 1000 representa 1 kg.

As respostas podem ser XML?

Sim. A documentação apresenta os formatos JSON e XML e os parâmetros de cada rota.

Comece agora

Economize tempo e organize seus envios com o CepCerto.

Compare fretes, gere etiquetas e acompanhe suas encomendas em uma única plataforma.

Criar minha conta grátis
CepCerto contato pelo WhatsApp