Получение корзины клиента

Возвращает текущий состав корзины клиента. Товары из наборов и выбранные подарки попадают в items отдельными позициями наравне с обычными товарами. Позиции с товарами, снятыми с публикации, в выдачу не попадают. Если корзина пуста или ее у клиента еще не было, свойство items пусто, а суммы равны 0.

Request

GET

https://api.kit.yandex.net/v1/customers/{customer_id}/cart

Responses

200 OK

Корзина клиента.

Body

application/json

{
  "items": [
    {
      "product_variant_id": "00000000-0000-0000-0000-000000000001",
      "name": "Футболка, размер M",
      "quantity": 2,
      "price": "1200.00",
      "final_price": "1100.00",
      "total_price": "2400.00",
      "total_final_price": "2200.00"
    }
  ],
  "total_price": "2400.00",
  "total_final_price": "2200.00",
  "updated_at": "2024-05-20T12:30:00Z"
}

Name	Description
items	Type: CartItem[] Позиции корзины. Example `[ { "product_variant_id": "00000000-0000-0000-0000-000000000001", "name": "Футболка, размер M", "quantity": 2, "price": "1200.00", "final_price": "1100.00", "total_price": "2400.00", "total_final_price": "2200.00" } ]`
total_final_price	Type: string<decimal> Итоговая стоимость корзины после скидок на товары и наборы. Скидка по промокоду корзины в нее не входит — в отличие от `Order.total_final_price`. Example: `2200.00`
total_price	Type: string<decimal> Общая стоимость корзины до скидок. Example: `2400.00`
updated_at	Type: string<date-time> Дата и время последнего изменения корзины. Отсутствует, если корзины у клиента еще не было. Example: `2024-05-20T12:30:00Z`

CartItem

Позиция в корзине клиента.

Name	Description
final_price	Type: string<decimal> Цена товара за единицу после скидок на товар и наборы. Скидка по промокоду корзины в нее не входит — в отличие от `OrderItem.final_price`. Example: `1100.00`
name	Type: string Название товара. Example: `Футболка, размер M`
price	Type: string<decimal> Цена товара за единицу до скидок. Example: `1200.00`
product_variant_id	Type: string<uuid> Идентификатор товара. Не является уникальным ключом позиции. Один товар попадает в несколько позиций, если он: является частью набора; добавлен с разными дополнительными услугами; выбран подарком. Количества по таким позициям нужно суммировать. Example: `00000000-0000-0000-0000-000000000001`
quantity	Type: integer Количество товара, которое клиент положил в корзину. Может превышать остаток на складе. Приводится к доступному значению, когда клиент открывает корзину или оформляет заказ.
total_final_price	Type: string<decimal> Итоговая стоимость позиции — `final_price`, умноженная на `quantity`. Example: `2200.00`
total_price	Type: string<decimal> Стоимость позиции до скидок — `price`, умноженная на `quantity`. Example: `2400.00`

Example

{
  "product_variant_id": "00000000-0000-0000-0000-000000000001",
  "name": "Футболка, размер M",
  "quantity": 2,
  "price": "1200.00",
  "final_price": "1100.00",
  "total_price": "2400.00",
  "total_final_price": "2200.00"
}

400 Bad Request

Некорректный запрос.

Body

application/json

{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name	Description
code	Type: string Example: `VALIDATION_ERROR`
message	Type: string Example: `Invalid input`
trace_id	Type: string Уникальный идентификатор запроса для отладки. Example: `00000000000000000000000000000000`

401 Unauthorized

Не авторизован.

Body

application/json

{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name	Description
code	Type: string Example: `VALIDATION_ERROR`
message	Type: string Example: `Invalid input`
trace_id	Type: string Уникальный идентификатор запроса для отладки. Example: `00000000000000000000000000000000`

404 Not Found

Ресурс не найден.

Body

application/json

{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name	Description
code	Type: string Example: `VALIDATION_ERROR`
message	Type: string Example: `Invalid input`
trace_id	Type: string Уникальный идентификатор запроса для отладки. Example: `00000000000000000000000000000000`

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json

{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name	Description
code	Type: string Example: `VALIDATION_ERROR`
message	Type: string Example: `Invalid input`
trace_id	Type: string Уникальный идентификатор запроса для отладки. Example: `00000000000000000000000000000000`

Была ли статья полезна?

Обновление клиента

Список ресурсов