Fretes e cotações
Calcule opções de entrega para seu checkout.
O que você pode construir
Apresente preço e prazo de entrega na página de produto, no carrinho ou em um fluxo de atendimento por agente. A plataforma usa o CEP de origem e os serviços habilitados na loja para consultar as opções disponíveis.
Produto relacionado: Meu Frete.
Como acessar
| Interface | Operação | Credencial |
|---|---|---|
| API REST | POST /v1/rates | Chave pública pk_… ou secreta mk_… |
| Meu Ecommerce MCP | get_shipping_rates | OAuth ou chave secreta da loja |
| Meu Ecommerce MCP | diagnose_quote_issue | OAuth ou chave secreta da loja |
A cotação REST pode ser consumida pelo navegador com a chave pública. Para agentes, use a conexão única do MCP.
Antes de começar
No dashboard, configure a loja, o CEP de origem e os serviços de envio. Confira o acesso da conta e as condições disponíveis para sua integração.
Unidades e formatos
| Campo | Unidade ou formato |
|---|---|
destinationCep | CEP brasileiro de 8 dígitos; pontuação e espaços são normalizados |
unitPriceBRL | Reais por unidade, como número decimal |
weightKg | Quilogramas por unidade |
dimensionsCm | Centímetros por unidade: length, width e height |
deliveryDays | Prazo retornado em dias úteis |
Uma resposta 200 pode conter rates: []. Trate esse cenário como ausência de cotação, sem apresentar frete grátis por padrão. Examine reason e actionUrl, quando retornados.
Embalagem no plano Avançado
No plano Avançado, a cotação escolhe entre as caixas cadastradas na loja. O sistema estima as dimensões de cada produto e encaixa os itens em três dimensões. Entre as caixas que comportam o pedido, usa a que sai mais barata nos Correios. Nos demais planos, a cotação usa a primeira caixa cadastrada e divide o pedido por peso.
Para melhorar a cotação no plano Avançado:
- Envie
productIde, quando houver,variantIdousku. A estimativa de dimensões fica guardada por produto e variante e é reaproveitada nas próximas cotações. - Envie
dimensionsCmquando conhecer as medidas. Elas são usadas diretamente, sem estimativa, apenas naquela cotação.