Event.Accept
Сохраняет во внешней системе завершённый чек, открытие или закрытие смены REGOS: VCR.
Входные параметры
| Название | Тип данных | Обязательность | Описание |
|---|---|---|---|
| serial_number | string | Обязательный | Серийный номер кассы REGOS: VCR — отправителя |
| cash_register_id | string | Обязательный | Исходная внешняя касса события |
| event | object | Обязательный | Неизменяемое событие |
| event.created_at | string | Обязательный | Время события с часовым смещением |
| event.type | string | Обязательный | receipt, shift_opened или shift_closed |
| event.receipt | object | Для receipt | Чек; поле zreport отсутствует |
| event.zreport | object | Для shift_opened/shift_closed | Смена; поле receipt отсутствует |
Для receipt передайте event.receipt, для событий смены — event.zreport. Чеки различаются полем receipt.operation: sale или refund. Возврат допускается без original_receipt_id.
Пример запроса: открытие смены
{
"jsonrpc": "2.0",
"method": "Event.Accept",
"params": {
"serial_number": "VCR-DEMO-001",
"cash_register_id": "register-001",
"event": {
"created_at": "2026-11-15T09:00:00+05:00",
"type": "shift_opened",
"zreport": {
"id": "shift-demo-001",
"number": 29,
"opened_at": "2026-11-15T09:00:00+05:00",
"opened_by": {
"id": "3",
"name": "Кассир"
}
}
}
},
"id": "request-005"
}
Выходные параметры
| Название | Тип данных | Описание |
|---|---|---|
| status | string | accepted — сохранено впервые; duplicate — ранее уже сохранено |
| document_id | string | Постоянный ID документа во внешней системе, 1–200 символов |
| accepted_at | string | Время первоначального сохранения с часовым смещением |
Оба статуса означают успешное завершение доставки. document_id и accepted_at при повторе относятся к первоначальному документу.
Пример ответа
{
"jsonrpc": "2.0",
"id": "request-005",
"ok": true,
"result": {
"status": "accepted",
"document_id": "external-shift-001",
"accepted_at": "2026-11-15T09:00:01+05:00"
}
}
Идемпотентность и порядок
Документ определяется сочетанием serial_number, event.type и receipt.id либо zreport.id. Повтор с тем же содержимым возвращает duplicate и прежние document_id, accepted_at, в том числе после перезапуска и закрытия смены. Изменение кассы или содержимого возвращает IDEMPOTENCY_CONFLICT. Порядок полей JSON не важен; порядок позиций и оплат является частью содержимого.
Передавайте события одной кассы последовательно: открытие смены, завершённые чеки, закрытие смены. Для открытия и закрытия используется одинаковый zreport.id. Не переходите к следующему событию без подтверждения предыдущего.
Успех означает, что документ сохранён. При потере ответа, таймауте или временной ошибке повторите событие с прежними ID, кассой и содержимым. Новый id запроса может отличаться. Учитывайте retry_after; при постоянной ошибке сначала устраните причину.
Передаются завершённые операции. Метод не выполняет повторное списание, возврат денег в платёжной системе или фискализацию.
Ошибки
UNAUTHORIZED, CASH_REGISTER_NOT_FOUND, INVALID_PARAMS, IDEMPOTENCY_CONFLICT, RETRY_LATER, PERMANENT_ERROR. Формат — ошибки адаптера.