O que é preço de balcão dos Correios?

É o preço oficial cobrado diretamente pelos Correios por uma postagem, sem desconto contratual e sem desconto CepCerto.

A API calcula PAC e SEDEX?

Sim. O CepCerto consulta diretamente os servidores dos Correios e retorna o preço oficial de balcão e o prazo informado para PAC e SEDEX.

A mesma resposta mostra o preço CepCerto com desconto?

Sim. Quando disponível, a resposta apresenta o preço CepCerto e a economia em relação ao preço oficial de balcão.

A resposta pode ser JSON ou XML?

Sim. Use /ws/json-frete/ para JSON ou /ws/xml-frete/ para XML, mantendo os mesmos parâmetros.

Qual unidade devo usar para o peso?

Em novas integrações, informe sempre o peso em gramas. Por exemplo, envie 1000 para representar 1 kg.

API Frete Correios: Balcão e Desconto CepCerto

Métodos aceitos:GETPOST

Endpoints da API

JSON

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

XML

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

Parâmetros

Parâmetro	Regra
`cep_origem`	CEP com 8 dígitos. O hífen é aceito.
`cep_destino`	CEP com 8 dígitos. O hífen é aceito.
`peso_gramas`	Maior que zero e no máximo 30.000 gramas. Envie `1000` para 1 kg.
`altura_cm`	Maior que zero e no máximo 100 cm.
`largura_cm`	Maior que zero e no máximo 100 cm.
`comprimento_cm`	Maior que zero e no máximo 100 cm.
Soma das dimensões	`altura_cm + largura_cm + comprimento_cm` não pode ultrapassar 200 cm.
`sua_chave`	Chave de consumo disponível na Área Restrita.

GET com retorno JSON

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

{
  "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"
}

Quando o Mini Envios é apresentado?

Os campos valorminienvios_cepcerto e prazominienvios_cepcerto são opcionais e aparecem somente quando o serviço estiver disponível para a rota e o pacote atender a todas as regras:

peso de até 300 gramas;
altura de até 4 cm, largura de até 16 cm e comprimento de até 24 cm;
valor declarado de até R$ 100,00;
sem Aviso de Recebimento (AR) e sem Mão Própria;
origem e destino não podem estar na mesma cidade.

Importante: Mini Envios é uma modalidade contratual oferecida somente pelo CepCerto. Por isso, não existe campo de preço de balcão para esse serviço.

POST com retorno JSON

curl --request POST 'https://cepcerto.com/ws/json-frete/' \
  --header 'Content-Type: application/json' \
  --data '{
    "cep_origem": "01527050",
    "cep_destino": "11440001",
    "peso_gramas": 1000,
    "altura_cm": 20,
    "largura_cm": 20,
    "comprimento_cm": 20,
    "sua_chave": "SUA_CHAVE"
  }'

GET com retorno XML

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

<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>

POST com retorno XML

Envie o mesmo corpo JSON do exemplo POST para https://cepcerto.com/ws/xml-frete/. A resposta será entregue em XML.

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

O que é o preço de balcão dos Correios?