Regras por endpoint
Unidades, limites, campos obrigatórios, autenticação, consumo e códigos HTTP.
Documentação para desenvolvedores
Entenda as respostas e os erros das APIs CepCerto.
Interprete o código HTTP junto com o corpo da resposta e controle a repetição de operações para evitar emissões ou cobranças duplicadas.
Cadastro rápido e acesso pelo painel CepCerto
Referência oficial
30 requisições e exemplosTestar no Postman
Erros HTTP — 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.
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.
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
O que significa o erro HTTP 422?
A solicitação foi rejeitada por dados ou regras de negócio. Confira a mensagem da resposta e corrija a causa antes de tentar novamente.
Devo repetir uma emissão após um timeout?
Confira primeiro se a operação foi criada. Use idempotência e repetição controlada para evitar postagens ou cobranças duplicadas.
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.
