Receipt.Find
Ищет исходную продажу по ID или поисковой строке для заполнения возврата.
Метод доступен, если Connector.GetInfo возвращает receipt_lookup: true.
Входные параметры
| Название | Тип данных | Обязательность | Описание |
|---|---|---|---|
| serial_number | string | Обязательный | Серийный номер REGOS: VCR, выполняющей поиск, 1–100 символов |
| cash_register_id | string | Обязательный | ID текущей внешней кассы, 1–100 символов |
| id | string | Вместо query | Постоянный ID исходного чека REGOS: VCR, 1–100 символов |
| query | string | Вместо id | Код или номер чека, 1–2048 символов; способы поиска определяет адаптер |
Передайте ровно один параметр: id или query. Поиск включает доступные продажи других касс того же подключения. При поиске по id возвращается только чек с указанным ID.
Пример запроса
{
"jsonrpc": "2.0",
"method": "Receipt.Find",
"params": {
"serial_number": "VCR-DEMO-001",
"cash_register_id": "register-001",
"id": "receipt-demo-001"
},
"id": "request-004"
}
Выходные параметры
| Название | Тип данных | Описание |
|---|---|---|
| items | array | Чеки продажи: до одного по id, до 30 по query; ID не повторяются |
Возвращаются продажи с operation: "sale". Состав, цены и оплаты соответствуют исходному чеку, даже если товары изменены или удалены из каталога.
Если чек не найден или его данные недоступны адаптеру, items пуст. Если найдено более 30 чеков или ответ превышает 4 МиБ, возвращается QUERY_TOO_BROAD: уточните запрос.
Пример ответа при отсутствии чека
{
"jsonrpc": "2.0",
"result": {
"items": []
},
"ok": true,
"id": "request-004"
}
Поиск не изменяет документы и не проверяет уже выполненные возвраты. Пустой результат, отсутствие поддержки метода или связи не запрещают ручное заполнение возврата; проверки самого чека и оплаты сохраняются.
Ошибки
UNAUTHORIZED, CASH_REGISTER_NOT_FOUND, NOT_SUPPORTED, QUERY_TOO_BROAD, INVALID_PARAMS, RETRY_LATER, PERMANENT_ERROR. Описание и формат — ошибки адаптера.