Cart.Get

Возвращает состав и состояние корзины текущей интеграции по локальному или внешнему идентификатору.

Для авторизации передайте Bearer-токен интеграции в HTTP-заголовке. Подробнее — авторизация API.

Входные параметры

Название	Тип данных	Обязательность	Описание
id	string	Один из двух	Значение cart_id из ответа `Cart.Add`, до 100 символов
external_id	string	Один из двух	external_id успешного запроса `Cart.Add`, до 100 символов

Передайте ровно один непустой идентификатор. external_id — ключ, переданный при создании корзины через Cart.Add. Идентификаторы других интеграций недоступны.

По локальному ID: "params":{"id":"0123456789abcdef0123456789abcdef"}.

Пример запроса

Authorization: Bearer <integration-token>
Content-Type: application/json;charset=utf-8

{
    "jsonrpc": "2.0",
    "method": "Cart.Get",
    "params": {
        "external_id": "ORDER-001"
    },
    "id": 2
}

Выходные параметры

Название	Тип данных	Описание
cart_id	string	Локальный ID корзины из Cart.Add
status	string	Состояние корзины: open, process, finished или canceled
receipt_id	string или null	ID завершённого чека; до завершения null
created_at	string	Время создания, местное время кассы, YYYY-MM-DD HH:mm:ss
updated_at	string	Время обновления, местное время кассы, YYYY-MM-DD HH:mm:ss
total	int64	Сумма корзины после скидок в тийинах
items	array	Позиции корзины
items[].item_id	int64	Локальный ID товара для Cart.Add
items[].name	string	Наименование товара
items[].barcode	string	Штрихкод; пустой при отсутствии
items[].icps	string	Код ИКПУ
items[].price	int64	Цена единицы в тийинах
items[].quantity	int64	Количество в тысячных долях единицы; 1000 — одна единица
items[].discount	int64	Скидка на всю позицию в тийинах
items[].amount	int64	Сумма после скидки в тийинах
items[].vat_value	int64	Ставка НДС в сотых долях процента; -1 — без НДС
items[].package_code	string или null	Код упаковки; null при отсутствии
items[].label	string	Маркировка единицы; пустая при отсутствии

Результат содержит cart_id, status, receipt_id, created_at, updated_at, total, items. Денежные суммы — в тийинах; количество — в тысячных долях единицы. Поля каждой позиции: item_id, name, barcode, icps, price, quantity, discount, amount, vat_value, package_code, label.

status	Значение
open	Ожидает оформления; корзину можно отменить
process	Корзина открыта кассиром для оформления; оплата или фискализация ещё не завершена
finished	Фискальный чек завершён; receipt_id содержит ID этого чека
canceled	Корзина отменена

До завершения receipt_id равен null. Для получения завершённого чека передайте это значение в Receipt.Get : "params":{"id":"<receipt_id>"}. Ошибка оплаты не переводит корзину в finished.

Пример ответа

{
    "jsonrpc": "2.0",
    "result": {
        "cart_id": "0123456789abcdef0123456789abcdef",
        "status": "finished",
        "receipt_id": "fedcba9876543210fedcba9876543210",
        "created_at": "2026-11-13 10:00:00",
        "updated_at": "2026-11-13 10:05:00",
        "total": 10000,
        "items": [
            {
                "item_id": 101,
                "name": "Тестовый товар",
                "barcode": "4780000000000",
                "icps": "00000000000000000",
                "price": 10000,
                "quantity": 1000,
                "discount": 0,
                "amount": 10000,
                "vat_value": 0,
                "package_code": null,
                "label": ""
            }
        ]
    },
    "ok": true,
    "id": 2
}

Повторный запрос не создаёт оплату или чек. Ошибки: общие ошибки; 701003 — не указан ровно один корректный идентификатор; 701001 — корзина не найдена или принадлежит другой интеграции.