☰ Меню · История изменений
Ещё

История изменений

Изменения в API, сначала новые.

22 ноября 2026

  • cashier в POST /v1/transactions, POST /v1/checks/calculate и POST /v1/holds: строка или {id, name}, кто пробил чек. Сохраняется с чеком и холдом, возвращается в cashier и используется сигналами кассиров у владельца. Никогда не меняет кэшбэк и не входит в проверку идемпотентности.

17 ноября 2026

  • Правило «за один визит гость либо копит, либо тратит»: чек со списанием не начисляет кэшбэк, а ответы POST /v1/checks/calculate и POST /v1/transactions содержат earn_blocked: "redeemed". Без правила этого поля нет.

16 ноября 2026

  • Точки: владелец привязывает к точкам коды касс и коды магазинов. Отправляйте store_id с чеками, расчётами и холдами, когда register_id нет или он не привязан к точке; в ответах есть location с matched_by. См. как передавать точку и кассу.
  • Правила точек: свой процент, начисление выключено, оплата кэшбэком запрещена или ограничена на точке. Чек или холд с кэшбэком там, где это запрещено, отклоняется с 400 redeem_not_allowed_here, а расчёт отвечает redeem_blocked_reason. Исключения для товаров и категорий на точке: GET /v1/catalog/location-rules.
  • Категория по названию: заведения с подробным порядком правил принимают в line_items[].category и название категории, и её код. Название никогда не создаёт новую категорию; побеждает самое точное правило.
  • Товары по акции: line_items[].promo: true; владелец решает, начисляют ли такие строки кэшбэк и можно ли оплатить их кэшбэком.
  • Типы скидок: discount_type на чеке и на строках; владелец задаёт для каждого типа, начисляет ли он кэшбэк и можно ли платить кэшбэком, иначе 400 discount_redeem_not_allowed.
  • Кэшбэк как оплата или как скидка: в режиме скидки у каждой строки есть redeem_allocated; режим в settings.redeem_accounting.
  • Офлайн: GET /v1/account возвращает в settings поля timeout_seconds, offline_redeem и offline_max_hours. См. Когда касса без связи.
  • Подарки: POST /v1/checks/calculate отвечает gifts.pending и gifts.unlocks, POST /v1/transactions отвечает gifts.unlocked; отметить выдачу подарка: POST /v1/members/{member}/gifts/{gift_id}/give. События gift.unlocked и gift.given.

5 ноября 2026

  • В каждой транзакции и в POST /v1/checks/calculate есть line_items с тем, что начислила каждая позиция: amount, cashback_earned, earn_percent, redeemable, quantity_refunded.
  • Возвраты по позициям: POST /v1/transactions/{external_id}/refunds принимает line_items с артикулом и количеством; кэшбэк следует за тем, что каждая позиция реально начислила.
  • Префикс номера карты: владелец задаёт его в правилах для касс, новые карты начинаются с него; settings.card_prefix в GET /v1/account.
  • Правила на товар: владелец переопределяет категорию на одном товаре, навсегда или между датами; GET /v1/catalog/products возвращает их в rules.
  • Кэшбэк может уйти в минус: возврат или отмена снимают кэшбэк, который гость уже потратил, cashback.balance становится отрицательным, а следующий чек сначала гасит долг.
  • Кабинет: поздравления с днём рождения на языке карты, события и ДР без картинки (текст поверх оформления карты), уровни по штампам, которые меняются в момент набора штампов.
  • Кабинет: автокампании (купил товар, перестал покупать, расписание по сегменту) с журналом отправок; когорты покупателей с LTV; сегменты по купленным товарам и по балансу кэшбэка.
  • Возврат позиций: POST /v1/transactions/{external_id}/returns принимает возвращённые line_items и двигает кэшбэк по тому, что начислила каждая позиция; тот же движок, что у возврата с позициями, отдельным эндпоинтом.

24 октября 2026

  • Заказы с собой: type: pickup с location, pickup_at, guest и day_number.
  • У каждого заказа есть payment и history. GET /v1/orders принимает ?type= и ?location=.
  • Блюдо с обязательным выбором, добавленное без него, отклоняется с needs_options ещё до вас.

9 октября 2026

  • Отменённый или полностью возвращённый чек больше не считается визитом и тратой, поэтому возвраты не поднимают уровень кэшбэка гостя.
  • Неизвестные пути внутри /v1 отвечают JSON 404 endpoint_not_found вместо страницы сайта; сам GET /v1 описывает API.
  • Ошибки валидации говорят, что именно отправить, например что amount это целое число в минимальных единицах.

7 октября 2026

  • Правила заведения для касс: списание через резерв, номера чеков по кассам, лимит для поздних чеков, лимиты кэшбэка на чек и в день, обязательный скан карты, ручные корректировки. У каждого ключа могут быть свои значения. GET /v1/account возвращает правила в settings.
  • Резервы: POST /v1/holds, подтверждение через hold_id, снятие, автоматическое истечение.
  • POST /v1/checks/calculate показывает, что сделает чек, ничего не записывая.
  • Частичные возвраты: POST /v1/transactions/{external_id}/refunds.
  • Каталог: выгрузка товаров по артикулу. Для каждой категории владелец решает, начисляет ли она кэшбэк, можно ли оплатить её кэшбэком и какой у неё свой процент.
  • В объекте участника появились levels, next_level, held и available кэшбэка.
  • У каждого чека, скана и расчёта есть display с готовым текстом для кассира и чека.
  • Новые права members:adjust, catalog:read, catalog:write; новые события transaction.refunded, balance.adjusted.

6 октября 2026

  • API v1 по адресу /api/v1 для программ любого типа: кэшбэк, штампы, скидки за визиты, VIP-уровни.
  • Участники: регистрация со своим номером карты, поиск по карте, штрихкоду, телефону или id, история, выдача наград.
  • Формат штрихкода карты для каждой программы: QR или Code 128 с номером карты либо QR с серийным номером.
  • Транзакции с line_items, отмена чеков, списание кэшбэка с учётом лимитов программы.
  • Киоски и сканеры: POST /v1/scans, POST /v1/visits, право devices:write.
  • API меню с вашими артикулами в external_id, массовая синхронизация цен и стоп-листа.
  • Заказы со столов из QR-меню со статусами для POS.
  • Вебхуки с подписью и повторными доставками, Idempotency-Key, пагинация по курсору, права ключей.
  • Прежний POS API по адресу /api/pos/v1 продолжает работать.
Вопросы по интеграции: api@loyaltyfy.io. Отвечаем в течение одного рабочего дня.