Regras por endpoint
Unidades, limites, campos obrigatórios, autenticação, consumo e códigos HTTP.
Documentação para desenvolvedores
Instale o widget de frete no seu site.
Adicione o cotador à sua página com uma chave pública e autorize as origens que poderão consultar fretes.
Cadastro rápido e acesso pelo painel CepCerto
Referência oficial
30 requisições e exemplosTestar no Postman
Widget — 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.
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.
Requisições completas do widget
POST01 - Validar acesso e carregar configuração
{{base_url}}/widget_frete/api/acesso
Endpoint utilizado pelo SDK. A chave pública vem de widget_public_key no environment. A chave deve estar ativa e o host de Origin deve estar cadastrado no painel.
Headers
| Nome | Valor |
|---|---|
X-CepCerto-Public-Key | {{widget_public_key}} |
Origin | {{widget_origin}} |
Content-Type | application/json |
Corpo JSON
{
"public_key": "{{widget_public_key}}"
}Exemplo de sucesso · HTTP 200
{
"status": "sucesso",
"cliente": {
"id_clie": 123,
"nome_cliente": "CLIENTE EXEMPLO"
},
"modo": "conta",
"configuracao": {
"titulo": "Calcule seu frete",
"servicos": "pac-desconto,sedex-desconto,loggi"
},
"consumo": {
"restante": 499
}
}POST02 - Cotar pelo widget
{{base_url}}/widget_frete/api/cotacao
Os parâmetros vêm do environment selecionado. Cota conforme os serviços e campos configurados na conta. O domínio/IP precisa estar autorizado. 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.
Headers
| Nome | Valor |
|---|---|
X-CepCerto-Public-Key | {{widget_public_key}} |
Origin | {{widget_origin}} |
Content-Type | application/json |
Corpo JSON
{
"public_key": "{{widget_public_key}}",
"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",
"modo": "conta",
"cliente": {
"id_clie": 123,
"nome_cliente": "CLIENTE EXEMPLO"
},
"enderecos": {
"origem": {
"cep": "01527050",
"localidade": "São Paulo",
"uf": "SP"
},
"destino": {
"cep": "11440001",
"localidade": "Guarujá",
"uf": "SP"
}
},
"cotacoes": [
{
"transportadora": "Correios",
"servico": "PAC CepCerto com desconto",
"valor": "18,90",
"prazo": "até 6 dias"
}
],
"consumo": {
"restante": 498
}
}GET03 - SDK JavaScript
{{base_url}}/widget_frete/
Retorna o SDK JavaScript. Instalação: <script src="https://cepcerto.com/widget_frete/" data-public-key="SUA_CHAVE"></script>.
GET04 - CSS do widget
{{base_url}}/widget_frete/estilo.css
Folha de estilos carregada automaticamente pelo SDK.
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
Preciso divulgar meu token de postagem no site?
Não. O widget utiliza uma chave pública própria. Tokens de postagem devem permanecer protegidos no servidor.
Por que devo autorizar meu domínio?
A autorização permite restringir as origens que utilizam sua chave pública e consomem consultas. Configure o domínio ou IPv4 no painel.
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.
