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 проверяет фискальные реквизиты товара.
Последовательность загрузки
- Без
cursorвозвращается первая страница полного каталога сmode: "full". - При
has_more: trueсразу запросите следующую страницу сnext_cursor. Режим загрузки не меняется; страница непустая, курсор отличается от предыдущего. - Сохраняйте новый курсор после успешного применения страницы. При ошибке повторите прежний запрос. В пределах срока действия курсора ответ воспроизводится, товары не дублируются.
- При
has_more: falseтекущая загрузка завершена. В следующем цикле передайте сохранённый курсор для полученияmode: "changes". - Без изменений возвращаются
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. Формат — ошибки адаптера.