https://dev.cepcerto.com
Documentação para desenvolvedores
APIs de frete, CEP, postagem e rastreio.
Integre sua loja, ERP ou plataforma com endpoints documentados, limites claros, exemplos de resposta e uma coleção Postman pronta para uso.
Cadastro rápido e acesso pelo painel CepCerto
Referência oficial
29 requisições e exemplosAbrir documentação no Postman
Documentação completa das APIs CepCerto
Escolha uma família para consultar autenticação, endpoints, unidades, limites e efeitos de cada operação. Os blocos fechados mantêm a página compacta sem esconder o conteúdo dos buscadores.
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.
Autenticação e ambientes
As três credenciais têm finalidades diferentes e não são intercambiáveis. Nunca publique tokens em código-fonte, exemplos ou repositórios.
| Credencial | Finalidade | Envio |
|---|---|---|
postage_token | Cotação operacional, saldo, PIX, postagem, cancelamento, rastreio, logradouro e comprovante. | JSON ou Authorization: Bearer, conforme o endpoint. |
consumption_key | APIs pagas de CEP e frete Correios. | Último segmento das URLs /ws/.... |
widget_public_key | Cotador instalado em sites. | Header X-CepCerto-Public-Key e JSON. |
https://cepcerto.comOs tokens ficam disponíveis na Área Restrita, no módulo Integração. A chave pública é administrada em Frete no seu site.
API de cotação, postagem e operação
Família autenticada pelo token de postagem. Peso é informado em quilogramas e dimensões em centímetros.
| Método | Endpoint | Finalidade e efeito |
|---|---|---|
| POST | /api-cotacao-frete/ | Cota Correios, Jadlog e Loggi. Consome franquia diária de cotação. |
| POST | /api-consulta-logradouro/ | Busca por UF, cidade e logradouro; bairro opcional; limite de 1 a 50 por página. |
| POST | /api-saldo/ | Consulta somente leitura do saldo da carteira. |
| POST | /api-credito/ | Cria PIX de R$ 5,00 a R$ 5.000,00. O saldo entra após confirmação do pagamento. |
| POST | /api-postagem-frete/ | Emite etiqueta e pode debitar saldo. Tipos: PAC, SEDEX, Jadlog Package, Jadlog .COM e Loggi. |
| POST | /api-cancela-postagem/ | Cancela objeto pertencente ao cliente quando o estado permite e solicita estorno aplicável. |
| POST | /api-rastreio/ | Consulta somente leitura de objeto pertencente à conta. |
| POST | /api-comprovante-correios/ | Comprovante de objeto Correios entregue; JSON/Base64 ou arquivo; limite de 30/minuto. |
Múltiplos volumes
São aceitos de 1 a 50 tipos de volume e quantidade de 1 a 999 por tipo. Cada volume obedece aos limites acima. Valores são multiplicados e somados por serviço; o prazo final é o maior encontrado.
Emissão
Use request_id único para idempotência e não repita o envio. Logística reversa está disponível somente para PAC e SEDEX. A declaração exige produtos com descrição, quantidade e valor.
APIs pagas de CEP e frete Correios
Rotas GET autenticadas pela chave no último segmento. CEPs usam somente 8 dígitos e peso é informado em gramas.
| Família | JSON / XML | Consumo |
|---|---|---|
| CEP | /ws/json/... · /ws/xml/... | 1 |
| Frete resumido | /ws/json-frete/... · /ws/xml-frete/... | 2 |
| Frete opcional | /ws/json-frete-opcional/... · /ws/xml-frete-opcional/... | 2 |
| Cilindro resumido | /ws/json-frete-cilindro/... · /ws/xml-frete-cilindro/... | 2 |
| Cilindro opcional | /ws/json-frete-opcional-cilindro/... · /ws/xml-frete-opcional-cilindro/... | 2 |
| Serviço específico | /ws/json-frete-servico/... · /ws/xml-frete-servico/... | 1 |
| Cilindro por serviço | /ws/json-frete-servico-cilindro/... · /ws/xml-frete-servico-cilindro/... | 1 |
Códigos públicos: PAC 04510 e SEDEX 04014. Nas rotas opcionais, valor declarado é obrigatório entre R$ 0 e R$ 50.000,00; mão própria e aviso de recebimento aceitam somente 0 ou 1.
Cilindro: diâmetro de 10 a 91 cm e comprimento de 13 a 100 cm. A rota resumida JSON normaliza valores abaixo dos mínimos operacionais para os mínimos dos Correios.
Frete no seu site (Widget)
O SDK incorpora o cotador em páginas HTML, lojas virtuais e sistemas. A chave pública deve estar ativa e o domínio ou IPv4 de origem precisa estar autorizado no painel.
<script src="https://cepcerto.com/widget_frete/"
data-public-key="SUA_CHAVE_PUBLICA"></script>| Método | Endpoint | Finalidade |
|---|---|---|
| POST | /widget_frete/api/acesso | Valida chave, origem, configuração e consumo. |
| POST | /widget_frete/api/cotacao | Calcula as opções configuradas na conta. |
| GET | /widget_frete/ | Carrega o SDK JavaScript. |
| GET | /widget_frete/estilo.css | Carrega os estilos oficiais. |
As regras de pacote são as mesmas da cotação operacional: até 30 kg, lados até 100 cm, soma até 200 cm e valor declarado de R$ 50,00 a R$ 35.000,00. Contas premium podem autorizar até 10 domínios ou IPs.
Respostas, erros e boas práticas
| HTTP | Significado |
|---|---|
200 | Operação aceita ou concluída. |
400 | JSON ou requisição inválida. |
401 | Credencial, domínio ou origem não autorizada. |
404 | Recurso não encontrado. |
405 | Método HTTP não permitido. |
422 | Campo ou regra de negócio inválida. |
429 | Limite ou franquia excedida. |
500/503 | Indisponibilidade interna ou do fornecedor. |
- Use HTTPS e mantenha tokens somente no servidor.
- Implemente timeout, registro de erros e repetição controlada.
- Não repita emissão ou PIX sem conferir o resultado anterior.
- Valide HTTP e o corpo JSON/XML; resposta documentada não significa sucesso funcional.
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.
Tudo o que você precisa saber
Qual credencial devo usar?
Use o token de postagem para cotação operacional, saldo, PIX, emissão, cancelamento, rastreio e comprovantes; use a chave de consulta nas APIs /ws; e use a chave pública apenas no widget de frete.
Existe ambiente de desenvolvimento?
Sim. Valide URLs e formatos em dev.cepcerto.com antes de usar produção. PIX, emissão e cancelamento podem alterar dados e devem ser executados apenas com autorização.
Onde encontro os tokens?
Entre na Área Restrita e abra Integração. A chave pública do widget fica no módulo Frete no seu site.
A documentação também está no Postman?
Sim. A coleção oficial inclui 29 requisições, exemplos de sucesso, environments e testes de contrato e sucesso funcional.
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.
