Item.GetChanges

Возвращает полное состояние каталога выбранной кассы либо изменения после ранее полученного курсора.

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

Название Тип данных Обязательность Описание
serial_number string Обязательный Серийный номер кассы REGOS: VCR, 1–100 символов
cash_register_id string Обязательный Выбранная внешняя касса
cursor string Необязательный Непрозрачный курсор, 1–4096 символов; отсутствие начинает полную загрузку
limit int32 Обязательный Число записей на странице, от 1 до 150

Первый запрос передаётся без cursor. Для продолжения используйте next_cursor предыдущего ответа без изменений. Курсор действует только для исходного подключения и внешней кассы.

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

{
    "jsonrpc": "2.0",
    "method": "Item.GetChanges",
    "params": {
        "serial_number": "VCR-DEMO-001",
        "cash_register_id": "register-001",
        "limit": 150
    },
    "id": "request-003"
}

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

Название Тип данных Описание
mode string full — страница полной загрузки, changes — страница изменений
next_cursor string Курсор следующего запроса или контрольная точка после завершения, 1–4096 символов
has_more boolean Есть ли следующая страница текущего снимка/набора
items array Не более limit записей; external_id уникален в пределах страницы
items[].external_id string Постоянный ID товара, 1–100 символов
items[].deleted boolean Товар удалён или недоступен для новых продаж выбранной кассы
items[].product object Полная карточка товара; обязательна при deleted=false, отсутствует при deleted=true

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

{
    "jsonrpc": "2.0",
    "id": "request-003",
    "ok": true,
    "result": {
        "mode": "full",
        "next_cursor": "opaque-checkpoint-001",
        "has_more": false,
        "items": [
            {
                "external_id": "product-001",
                "deleted": false,
                "product": {
                    "code": "12345",
                    "name": "Демонстрационный весовой товар",
                    "barcode": "4780000000000",
                    "article": "",
                    "price": 1000000,
                    "quantity_kind": "weight",
                    "unit_kkm_code": 5,
                    "unit_name": "кг",
                    "icps": "00000000000000000",
                    "vat_value": 0,
                    "owner_type": 0
                }
            }
        ]
    }
}

ИКПУ и штрихкод примера фиктивные. При загрузке REGOS: VCR проверяет фискальные реквизиты товара.

Последовательность загрузки

  1. Без cursor возвращается первая страница полного каталога с mode: "full".
  2. При has_more: true сразу запросите следующую страницу с next_cursor. Режим загрузки не меняется; страница непустая, курсор отличается от предыдущего.
  3. Сохраняйте новый курсор после успешного применения страницы. При ошибке повторите прежний запрос. В пределах срока действия курсора ответ воспроизводится, товары не дублируются.
  4. При has_more: false текущая загрузка завершена. В следующем цикле передайте сохранённый курсор для получения mode: "changes".
  5. Без изменений возвращаются items: [] и has_more: false; курсор может остаться прежним. При CURSOR_EXPIRED начните полную загрузку без cursor.

Изменения включают новые карточки, цены, фискальные реквизиты и записи deleted: true. Поле product содержит карточку целиком. Один external_id не используется для разных товаров.

Полный каталог содержит все доступные товары выбранной кассы. Отсутствующие в нём прежние товары отключаются только после последней страницы. Изменения во время полной загрузки возвращаются в следующем цикле. История чеков сохраняется.

Ошибки

UNAUTHORIZED, CASH_REGISTER_NOT_FOUND, CURSOR_EXPIRED, INVALID_PARAMS, RETRY_LATER, PERMANENT_ERROR. Формат — ошибки адаптера.