☰ Меню · Журнал змін
Інше
Журнал змін
Що змінилося в 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відповідають JSON404 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продовжує працювати.