Połącz Holded POS

Co to robi

Połącz swoje konto Holded, a Twój program lojalnościowy będzie działał bezpośrednio na kasie Holded. Gdy Twój personel zarejestruje opłaconą sprzedaż z przypisanym klientem, Passtastic automatycznie to wychwytuje — bez osobnego urządzenia do naliczania. Aby przyznać nagrodę, Twój personel nadal potwierdza ją szybkim skanem w aplikacji Passtastic Scanner, tak samo jak przy każdej innej kasie.

Które karty mogą zbierać ze sprzedaży Holded

• Karty punktów i poziomów zbierają zgodnie z Twoimi regułami punktów — reguła naliczania przypisana do karty decyduje, ile warta jest sprzedaż. Jeśli karta nie ma jeszcze przypisanej reguły naliczania, nie będzie zbierać, dopóki jej nie skonfigurujesz.
• Karty pieczątek zbierają 1 pieczątkę za każdą opłaconą sprzedaż — reguła nie jest potrzebna.
• Kupony, pakiety (przedpłacone pieczątki / przedpłacone punkty) i członkostwa nie mogą zbierać ze sprzedaży Holded. Te typy kart nie mają sposobu naliczania z transakcji POS, więc nie pojawią się na liście kart, które możesz włączyć.

Zanim zaczniesz

• Dostęp do konta Holded z uprawnieniem do tworzenia poświadczeń API.
• Co najmniej jedną opublikowaną kartę lojalnościową w Passtastic, która może zbierać (kartę punktów, poziomów lub pieczątek). Jeśli jeszcze jej nie masz, utwórz ją najpierw z Programs → Create New Program (Programy → Utwórz nowy program).
• Bezpłatną aplikację Passtastic Scanner na telefonie lub tablecie — nadal będzie Ci potrzebna do realizacji nagród.

Krok 1 — Uzyskaj swój klucz API Holded

1. W Holded otwórz Settings (Ustawienia).

2. Przejdź do Developers (Deweloperzy).

3. Otwórz Credentials (Poświadczenia).

4. Kliknij New API Token (Nowy token API).

5. Wybierz dokładnie te uprawnienia:

• Sales: Read (Sprzedaż: Odczyt)
• Contacts: Read (Kontakty: Odczyt)
• Developers: Full (Deweloperzy: Pełny dostęp)

Krok 2 — Połącz Holded z Passtastic

1. W panelu Passtastic otwórz Settings (Ustawienia), a następnie Integrations (Integracje) w sekcji Business (Firma).

2. Znajdź Holded POS.

3. Wklej skopiowany klucz API i kliknij Connect Holded (Połącz Holded).

Krok 3 — Wybierz, które karty zbierają

Po połączeniu zobaczysz Your loyalty cards (Twoje karty lojalnościowe) — każdą kartę punktów, poziomów i pieczątek na Twoim koncie. Włącz kartę, aby zacząć zbierać ze sprzedaży Holded.

• Dla kart punktów i poziomów upewnij się, że przypisana jest reguła naliczania — karty zbierają dopiero, gdy skonfigurujesz dla nich regułę punktów. Jeśli żadna nie jest jeszcze przypisana, użyj Set up your points rules (Skonfiguruj swoje reguły punktów) na tej samej stronie.
• Karty pieczątek nie potrzebują reguły — wystarczy je włączyć; zbierają 1 pieczątkę za każdą opłaconą sprzedaż.

Strona połączenia pokazuje N z M kart zbiera, dzięki czemu od razu widzisz, ile Twoich zdolnych do zbierania kart jest włączonych.

Jeden nawyk, który ma znaczenie: przypisz klienta do sprzedaży

Punkty i pieczątki naliczają się tylko wtedy, gdy Twój personel przypisze klienta do transakcji w Holded — tak samo jak przy dodawaniu klienta do dowolnej sprzedaży. Jeśli sprzedaż zostanie zarejestrowana bez przypisanego klienta, nic nie zostanie naliczone automatycznie.

To jednak niekoniecznie stracona okazja: sprzedaż zarejestrowana bez klienta może zostać mu przypisana później tego samego dnia, jeśli transakcja zostanie zaktualizowana o klienta przed zamknięciem dnia. Po upływie tego czasu sprzedaży nie da się już dopasować.

Jak Twój personel realizuje nagrodę

Holded nie pokazuje statusu nagrody klienta na kasie, więc realizacja nadal korzysta z szybkiego skanu, tak samo jak w każdym programie lojalnościowym Passtastic:

1. Gdy klient mówi, że jego nagroda jest gotowa, Twój personel otwiera aplikację Passtastic Scanner i skanuje kartę wallet klienta. To potwierdza, że nagroda jest prawdziwa i gotowa.

2. Twój personel stosuje nagrodę przy kasie tak jak zwykle (rabat, darmowy produkt itp.).

To jedyne miejsce, gdzie nadal używasz skanera — naliczanie jest automatyczne ze sprzedaży Holded.

Rozwiązywanie problemów

Mój klucz API nie został zaakceptowany. Upewnij się, że utworzyłeś prawdziwy token API Holded (nie hasło logowania ani inny rodzaj klucza) i że skopiowałeś cały ciąg znaków. Utwórz nowy token w Holded → Settings → Developers → Credentials (Ustawienia → Deweloperzy → Poświadczenia) i wklej go ponownie.

Błąd „Add the Sales: Read / Developers: Full scope". Tokenowi brakuje jednego z trzech wymaganych uprawnień. Wróć do Holded, utwórz nowy token API i wybierz wszystkie trzy: Sales: Read (Sprzedaż: Odczyt), Contacts: Read (Kontakty: Odczyt), Developers: Full (Deweloperzy: Pełny dostęp) — a następnie wklej ten nowy token.

„Couldn't register the sales webhook in Holded." Holded pozwala na tylko jeden webhook sprzedaży na konto. Jeśli inne narzędzie jest już zarejestrowane do odbierania powiadomień o sprzedaży z Holded, Holded odrzuci drugie. Rozłącz lub przekonfiguruj webhook tego narzędzia w Holded, a następnie spróbuj połączyć Passtastic ponownie.

Moje połączenie wymaga nowego klucza po tym, jak zregenerowałem go w Holded. Zregenerowanie lub cofnięcie klucza w Holded unieważnia ten, którego używa Passtastic, więc połączenie przestaje działać, dopóki nie połączysz się ponownie. Utwórz nowy token API w Holded (te same uprawnienia co powyżej) i wklej go na stronie integracji Holded, aby połączyć się ponownie — ustawienia Twoich kart zostają zachowane.

Sprzedaż nie dopasowuje się do właściwego klienta. Sprawdź, czy uprawnienie Contacts: Read (Kontakty: Odczyt) jest nadal włączone na Twoim kluczu API — bez niego Passtastic nie może dopasować sprzedaży do Twoich klientów. Jeśli go brakuje, dodaj je do istniejącego tokena lub utwórz nowy z wszystkimi trzema uprawnieniami.

Aby prowadzić lojalność bez POS lub połączyć inne narzędzia, zobacz Systemy POS i integracje.