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. Формат — ошибки адаптера.