Regras por endpoint
Unidades, limites, campos obrigatórios, autenticação, consumo e códigos HTTP.
Documentação para desenvolvedores
Integre o cálculo de frete ao seu sistema.
Consulte preços e prazos em uma chamada autenticada e compare as opções disponíveis para os volumes da sua encomenda.
Cadastro rápido e acesso pelo painel CepCerto
Referência oficial
30 requisições e exemplosTestar no Postman
Cálculo de frete — 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.
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 — Correios, Jadlog e Loggi
Consulte preços e prazos com POST /api-cotacao-frete/, usando o token de postagem. A consulta consome a franquia diária de cotação.
Informe o peso em quilogramas e as dimensões em centímetros. Os exemplos abaixo detalham os limites para um ou vários volumes.
Assista ao tutorial de cálculo de frete
Ver todos os vídeos sobre cálculo de frete
Exemplos de cotação
POST01 - Cotar frete (volume único)
{{base_url}}/api-cotacao-frete/
Usa o token de postagem do cliente, diferente da chave dos planos de consumo. Nunca publique o token.
Regras da encomenda: peso em kg, maior que 0 e até 30 kg; altura, largura e comprimento em cm, maiores que 0 e até 100 cm cada; a soma das três dimensões não pode ultrapassar 200 cm; valor declarado entre R$ 50,00 e R$ 35.000,00. CEPs devem conter 8 dígitos.
Cota Correios, Jadlog e Loggi. A execução consome a franquia diária da API de cotação.
Regras da encomenda: peso em kg, maior que 0 e até 30 kg; altura, largura e comprimento em cm, maiores que 0 e até 100 cm cada; a soma das três dimensões não pode ultrapassar 200 cm; valor declarado entre R$ 50,00 e R$ 35.000,00. CEPs devem conter 8 dígitos.
Cota Correios, Jadlog e Loggi. A execução consome a franquia diária da API de cotação.
Headers
| Nome | Valor |
|---|---|
Content-Type | application/json |
Corpo JSON
{
"token_cliente_postagem": "{{postage_token}}",
"cep_remetente": "{{cep_origem}}",
"cep_destinatario": "{{cep_destino}}",
"peso": "{{peso}}",
"altura": "{{altura}}",
"largura": "{{largura}}",
"comprimento": "{{comprimento}}",
"valor_encomenda": "{{valor_encomenda}}"
}Exemplo de sucesso · HTTP 200
{
"status": "sucesso",
"frete": {
"valor_pac": "18,90",
"valor_pac_balcao": "24,30",
"prazo_pac": "até 6 dias",
"valor_sedex": "29,70",
"valor_sedex_balcao": "36,10",
"prazo_sedex": "até 2 dias",
"valor_jadlog_package": "17,50",
"prazo_jadlog_package": "até 4 dias",
"valor_loggi": "19,20",
"prazo_loggi": "até 3 dias"
}
}POST02 - Cotar frete (múltiplos volumes)
{{base_url}}/api-cotacao-frete/
Usa o token de postagem do cliente, diferente da chave dos planos de consumo. Nunca publique o token.
Regras da encomenda: peso em kg, maior que 0 e até 30 kg; altura, largura e comprimento em cm, maiores que 0 e até 100 cm cada; a soma das três dimensões não pode ultrapassar 200 cm; valor declarado entre R$ 50,00 e R$ 35.000,00. CEPs devem conter 8 dígitos.
Múltiplos volumes: de 1 a 50 tipos de volume; quantidade de cada tipo entre 1 e 999. Cada volume obedece individualmente aos mesmos limites de peso e dimensões. Os valores são multiplicados pela quantidade e somados por serviço; o prazo final é o maior prazo encontrado para o serviço.
Cota Correios, Jadlog e Loggi e consome a franquia diária da API de cotação.
Regras da encomenda: peso em kg, maior que 0 e até 30 kg; altura, largura e comprimento em cm, maiores que 0 e até 100 cm cada; a soma das três dimensões não pode ultrapassar 200 cm; valor declarado entre R$ 50,00 e R$ 35.000,00. CEPs devem conter 8 dígitos.
Múltiplos volumes: de 1 a 50 tipos de volume; quantidade de cada tipo entre 1 e 999. Cada volume obedece individualmente aos mesmos limites de peso e dimensões. Os valores são multiplicados pela quantidade e somados por serviço; o prazo final é o maior prazo encontrado para o serviço.
Cota Correios, Jadlog e Loggi e consome a franquia diária da API de cotação.
Headers
| Nome | Valor |
|---|---|
Content-Type | application/json |
Corpo JSON
{
"token_cliente_postagem": "{{postage_token}}",
"cep_remetente": "{{cep_origem}}",
"cep_destinatario": "{{cep_destino}}",
"valor_encomenda": "150.00",
"volumes": [
{
"peso": "0.5",
"altura": "10",
"largura": "15",
"comprimento": "20",
"quantidade": 2
},
{
"peso": "1",
"altura": "20",
"largura": "20",
"comprimento": "30",
"quantidade": 1
}
]
}Exemplo de sucesso · HTTP 200
{
"status": "sucesso",
"frete": {
"valor_pac": "56,70",
"prazo_pac": "até 6 dias",
"valor_sedex": "89,10",
"prazo_sedex": "até 2 dias"
}
}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.
Tudo o que você precisa saber
Qual unidade de peso a API de cotação utiliza?
A API operacional de cotação recebe peso em quilogramas e dimensões em centímetros. Essa unidade é diferente do peso em gramas das APIs de frete balcão.
Posso consultar vários volumes?
Sim. A cotação aceita de 1 a 50 tipos de volume, com quantidade de 1 a 999 por tipo, respeitando os limites de peso e dimensões por volume.
Comece agora
Criar minha conta grátis
Economize tempo e organize seus envios com o CepCerto.
Compare fretes, gere etiquetas e acompanhe suas encomendas em uma única plataforma.
