Capacidades
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 |
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 |
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.