☰ Меню · Журнал змін
Інше

Журнал змін

Що змінилося в 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. Відповідаємо протягом одного робочого дня.