Підключіть Holded POS

Що це робить

Підключіть свій акаунт Holded, і ваша програма лояльності почне нараховувати прямо на касі Holded. Коли ваш персонал реєструє оплачений продаж із прив'язаним клієнтом, Passtastic автоматично зараховує його — без окремого пристрою для нарахування. Щоб надати нагороду, ваш персонал і далі підтверджує її швидким скануванням у застосунку Passtastic Scanner, так само як і на будь-якій іншій касі.

Які картки можуть нараховувати за продажами Holded

• Картки балів та рівнів нараховують згідно з вашими правилами нарахування балів — правило, прив'язане до картки, визначає, скільки коштує продаж. Якщо до картки ще не прив'язано правило нарахування, вона не нараховуватиме, доки ви не налаштуєте його.
• Картки штампів нараховують 1 штамп за оплачений продаж — правило не потрібне.
• Картки, що починаються з вітального купона, теж нараховують, з першого продажу, як картка зі штампами, з балами чи з рівнями, якою вони стають. У Holded немає нагород на касі, тож персонал видає вітальний подарунок через застосунок Passtastic Scanner, як і зараз.
• Інші купони, пакети (передоплачені штампи / передоплачені бали) та членства не можуть нараховувати за продажами Holded. Ці типи не мають способу нараховувати з транзакції POS, тому вони не з'являться у списку карток, які можна увімкнути.

Перш ніж почати

• Доступ до вашого акаунта Holded із дозволом на створення API-облікових даних.
• Принаймні одну опубліковану картку лояльності в Passtastic, яка може нараховувати (картка балів, рівнів або штампів). Якщо у вас ще немає такої, спершу створіть її через Programs → Create New Program (Програми → Створити програму).
• Безкоштовний застосунок Passtastic Scanner на телефоні чи планшеті — він і далі знадобиться для реалізації нагород.

Крок 1 — Отримайте ваш API-ключ Holded

1. У Holded відкрийте Налаштування.

2. Перейдіть до Developers (Розробники).

3. Відкрийте Credentials (Облікові дані).

4. Натисніть New API Token (Новий API-токен).

5. Оберіть саме ці області доступу:

• Sales: Read
• Contacts: Read + Write
• Developers: Full

Крок 2 — Підключіть Holded до Passtastic

1. У панелі керування Passtastic відкрийте Налаштування, потім Інтеграції у розділі Бізнес.

2. Знайдіть Holded POS.

3. Вставте скопійований API-ключ і натисніть Підключити Holded.

Крок 3 — Оберіть, які картки нараховують

Після підключення ви побачите Ваші картки лояльності — усі картки балів, рівнів та штампів у вашому акаунті. Увімкніть картку, щоб почати нараховувати за продажами Holded.

• Для карток балів та рівнів переконайтеся, що прив'язано правило нарахування — картки нараховують лише після того, як для них налаштовано правило балів. Якщо його ще не прив'язано, скористайтеся посиланням Налаштувати ваші правила нарахування балів на цій самій сторінці.
• Картки штампів не потребують правила — достатньо увімкнути картку; вона нараховує 1 штамп за оплачений продаж.

На сторінці підключення показано N з M карток нараховують, тож ви одразу бачите, скільки з ваших здатних нараховувати карток увімкнено.

Крок 4 — Учасники автоматично з'являються у ваших контактах Holded

Ваші учасники з'являються в Holded самі. Коли хтось приєднується, Passtastic додає його до ваших контактів Holded (ім'я, електронна пошта, телефон), тож на касі ваша команда шукає один раз і додає його до чека. Учасників, які приєдналися ще до підключення Holded, ми додаємо протягом наступних днів, до 200 на день, щоб велика програма не витратила ваш ліміт API Holded за один раз. Якщо в Holded уже є хтось із такою самою електронною поштою чи телефоном, ми прив'язуємося до цього контакту, а не створюємо другий.

Ви можете вимкнути це будь-коли за допомогою Автоматично додавати учасників до моїх контактів Holded на сторінці Holded у Passtastic. Уже створені контакти залишаються в Holded, а видалення учасника в Passtastic ніколи не видаляє його контакт у Holded.

*Деталі:* контакти зберігаються як клієнти, позначені тегом passtastic і мають довідковий код PT-…; синхронізація використовує близько двох викликів на учасника з щомісячного ліміту API вашого плану Holded.

Найважливіша звичка: прив'язуйте клієнта до продажу

Бали й штампи нараховуються лише тоді, коли ваш персонал прив'язує клієнта до чека в Holded — так само, як додавання клієнта до будь-якого продажу. Якщо продаж пробито без прив'язаного клієнта, нічого не нараховується автоматично.

Утім, це не обов'язково втрачено: продаж, зроблений без клієнта, усе ще можна зарахувати йому пізніше того самого дня, якщо чек оновити з клієнтом до закриття дня. Після цього вікна зіставити продаж уже не можна.

Як ваш персонал реалізує нагороду

Holded не показує статус нагороди клієнта на касі, тому реалізація й далі використовує швидке сканування, так само як у будь-якій програмі лояльності Passtastic:

1. Коли клієнт каже, що його нагорода готова, ваш персонал відкриває застосунок Passtastic Scanner та сканує wallet-картку клієнта. Це підтверджує, що нагорода справжня та готова.

2. Ваш персонал застосовує нагороду при оплаті, як зазвичай (знижку, безкоштовний товар тощо).

Це єдине місце, де ви досі використовуєте сканер — нарахування у Holded відбувається автоматично.

Повернення

Коли ви оформлюєте повернення через касу Holded, Holded створює коригувальний чек з від'ємною сумою, пов'язаний з початковим продажем. Passtastic застосовує ваше правило балів до повернутої суми і знімає стільки ж балів, тож часткове повернення забирає лише частину балів. Картка ніколи не опускається нижче нуля: якщо клієнт уже використав бали, вона зупиняється на 0. Скасування або видалення чека також знімає його бали. Картки з печатками втрачають печатку лише тоді, коли чек скасовано або видалено, а не при поверненні. Ви можете вимкнути це за допомогою Знімати бали при поверненнях на сторінці Holded у Passtastic.

Усунення несправностей

Нічого не нараховується, а сторінка показує «Підключено · не нараховує». Жодну картку не увімкнено. Увімкніть перемикач картки в розділі Ваші картки лояльності. Якщо тим часом надійшов продаж, сторінка показує дату цього продажу: він нічого не нарахував, і це не додається пізніше.

Мій API-ключ не прийнято. Переконайтеся, що ви створили справжній API-токен Holded (а не пароль для входу чи інший тип ключа) і що скопіювали весь рядок повністю. Створіть новий токен у Holded → Settings → Developers → Credentials і вставте його знову.

Помилка «Add the Sales: Read / Developers: Full scope». У токена бракує однієї з трьох потрібних областей доступу. Поверніться до Holded, створіть новий API-токен і оберіть усі три: Sales: Read, Contacts: Read + Write, Developers: Full — потім вставте цей.

«Couldn't register the sales webhook in Holded». Holded дозволяє лише один вебхук продажів на акаунт. Якщо інший інструмент уже зареєстрований для отримання сповіщень про продажі Holded, Holded відхилить другий. Відключіть або перенастройте вебхук іншого інструменту в Holded, а потім спробуйте підключити Passtastic знову.

Моєму підключенню потрібен новий ключ після того, як я перегенерував(-ла) ключ у Holded. Перегенерація або відкликання ключа в Holded робить недійсним той, яким користується Passtastic, тож підключення перестає працювати, доки ви не перепідключитеся. Створіть новий API-токен у Holded (з тими самими областями доступу, що й вище) і вставте його на сторінці інтеграції Holded, щоб перепідключитися — налаштування ваших карток збережуться.

«Ваш ключ Holded не може створювати контакти». У вашого API-токена немає області доступу Contacts: Write, тож Passtastic може прив'язувати наявні контакти, але не може створювати нові. Створіть новий API-токен у Holded з Sales: Read, Contacts: Read + Write та Developers: Full, натисніть Вставити новий ключ на банері та вставте його. Тим часом нарахування й далі працює завдяки зіставленню за електронною поштою та телефоном.

Продаж не зіставляється з правильним клієнтом. Перевірте, чи досі увімкнено область доступу Contacts: Read у вашому API-ключі — без неї Passtastic не може зіставляти продажі з вашими клієнтами. Якщо її бракує, додайте її до наявного токена або створіть новий з усіма трьома областями доступу.

Щоб вести лояльність без POS або підключити інші інструменти, перегляньте POS-системи та інтеграції.