---
title: "Calcular frete de um carrinho"
method: GET
path: "/{alias}/public/shipping/quotation/cart"
tags: ["Logística - Frete Público"]
---

# Calcular frete de um carrinho

`GET /{alias}/public/shipping/quotation/cart`

## Request

- Base URL: `https://api.dooki.com.br/v2`
- URL: `https://api.dooki.com.br/v2/{alias}/public/shipping/quotation/cart`
- Auth: none required

Calcula o custo de frete de forma pública utilizando o token do carrinho e o CEP de destino

## Path parameters

- `alias` string, required

## Query parameters

- `cart_token` string, required
- `zipcode` string, required

## Response `200`

Cálculo do frete realizado com sucesso

- object
  - `data` object: Cotação de frete calculada para os itens do carrinho e o CEP de destino informados.
    - `id` integer: ID da opção de frete cotada, gravado como `shipment_service_id` no carrinho e no pedido quando a opção é selecionada.
    - `service_id` integer: ID do serviço de frete (modalidade de envio) que gerou a cotação.
    - `service_name` string: Nome interno do serviço de frete cotado.
    - `service_display_name` string: Nome do serviço de frete exibido ao cliente no checkout.
    - `service_type_id` integer: ID do tipo de serviço de frete, que agrupa as modalidades de uma mesma transportadora.
    - `service_type_name` string: Nome do tipo de serviço de frete, correspondente à transportadora responsável pela entrega.
    - `price` number, float: Valor do frete cobrado do cliente nesta opção, em reais; fica `0` quando o frete é grátis.
    - `delivery_time` integer: Prazo de entrega estimado da opção, em dias úteis.
    - `quote_id` integer: ID da cotação no gateway de frete, gravado como `shipment_quote_id` no pedido e enviado à transportadora na criação do envio.
    - `gateway` string: Alias do gateway de frete que retornou a cotação.
    - `same_day_delivery` boolean: Indica se a opção entrega no mesmo dia da compra.
    - `same_day_delivery_until_at` string: Horário limite para o pedido entrar na entrega no mesmo dia.
    - `zipcode` string: CEP de destino usado no cálculo do frete, com 8 dígitos e sem máscara.
    - `street` string, nullable: Logradouro do endereço de destino, quando a consulta do CEP retorna o dado.
    - `neighborhood` string, nullable: Bairro do endereço de destino, quando a consulta do CEP retorna o dado.
    - `city` string: Cidade do endereço de destino.
    - `uf` string: Sigla da unidade federativa do endereço de destino.
    - `source` string: Origem dos dados do CEP: `database` para o cache da Yampi, `frenet` ou `viacep` para consulta no provedor externo.
    - `city_id` integer: ID da cidade de destino no cadastro de cidades da Yampi.
    - `formated_delivery_time` string: Prazo de entrega já formatado para exibição no checkout.
    - `formated_price` string: Valor do frete já formatado para exibição no checkout, ou `Grátis` quando não há cobrança.
    - `free_shipment` boolean: Indica se a opção ficou gratuita por uma regra de frete grátis da loja, definida por valor mínimo, UF e serviço de frete.
    - `real_price` number, float: Valor do frete calculado pela transportadora, antes das regras da loja que alteram o valor cobrado.

## Other responses

- `400`: Requisição inválida
- `422`: Parâmetros obrigatórios não fornecidos
- `424`: Serviço de frete temporariamente indisponível
- `429`: Limite de requisições excedido

## Changes

- **2026-11-03** `bbafb577e11c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/yampi/apis/yampi-api/changes/:alias/public/shipping/quotation/cart/get.md)

---

[API](https://skmtc.dev/yampi/apis/yampi-api.md) - [All operations](https://skmtc.dev/yampi/apis/yampi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yampi/apis/yampi-api/revisions/74739ec8876f?raw)