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.
• Karty zaczynające się od kuponu powitalnego też zbierają, od pierwszej sprzedaży, jako karta na pieczątki, karta punktowa lub karta poziomów, w którą się zamieniają. Holded nie ma nagród przy kasie, więc personel wydaje prezent powitalny aplikacją Passtastic Scanner, tak jak dotychczas.
• Pozostałe 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 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 + Write (Kontakty: Odczyt i zapis)
• Developers: Full (Deweloperzy: Pełny dostęp)

Krok 2 — Połącz Holded z Passtastic

1. W panelu Passtastic otwórz Ustawienia, a następnie Integracje w sekcji Firma.

2. Znajdź Holded POS.

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

Krok 3 — Wybierz, które karty zbierają

Po połączeniu zobaczysz 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 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.

Krok 4 — Członkowie automatycznie pojawiają się w Twoich kontaktach Holded

Twoi klienci sami pojawiają się w Holded. Gdy ktoś dołącza, Passtastic dodaje go do Twoich kontaktów Holded (imię i nazwisko, e-mail, telefon), dzięki czemu przy kasie Twój zespół wyszukuje go raz i dodaje do paragonu. Członkowie, którzy dołączyli przed połączeniem, są uzupełniani przez kolejne dni, do 200 dziennie, żeby duży program nie zużył całego limitu API Holded naraz. Jeśli Holded ma już kogoś z tym samym e-mailem lub telefonem, łączymy się z tym kontaktem zamiast tworzyć drugi.

Możesz wyłączyć tę opcję w dowolnym momencie za pomocą Automatycznie dodawaj członków do moich kontaktów Holded na stronie Holded w Passtastic. Już utworzone kontakty pozostają w Holded, a usunięcie członka w Passtastic nigdy nie usuwa jego kontaktu w Holded.

*Szczegóły:* kontakty są zapisywane jako klienci, oznaczone tagiem passtastic i mają kod referencyjny PT-…; synchronizacja wykorzystuje około dwóch wywołań na członka z miesięcznego limitu API Twojego planu Holded.

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.

Zwroty

Gdy robisz zwrot z kasy Holded, Holded tworzy paragon korygujący z ujemną kwotą, powiązany z pierwotną sprzedażą. Passtastic stosuje Twoją regułę punktów do zwróconej kwoty i odejmuje tyle punktów, więc zwrot częściowy zabiera tylko część punktów. Karta nigdy nie schodzi poniżej zera: jeśli klient już wykorzystał punkty, zatrzymuje się na 0. Anulowanie lub usunięcie paragonu również odejmuje jego punkty. Karty na pieczątki tracą pieczątkę tylko wtedy, gdy paragon zostanie anulowany lub usunięty, a nie przy zwrocie. Możesz to wyłączyć opcją Odejmuj punkty przy zwrotach na stronie Holded w Passtastic.

Rozwiązywanie problemów

Nic nie nalicza, a strona pokazuje Połączono · nie zbiera. Żadna karta nie jest włączona. Włącz kartę w sekcji Twoje karty lojalnościowe. Jeśli w międzyczasie doszło do sprzedaży, strona pokazuje datę tej sprzedaży: nic nie naliczyła i nie zostanie doliczona później.

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 + Write (Kontakty: Odczyt i zapis), 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.

„Twój klucz Holded nie może tworzyć kontaktów." Twój token API nie ma uprawnienia Contacts: Write (Kontakty: Zapis), więc Passtastic może łączyć istniejące kontakty, ale nie może tworzyć nowych. Utwórz nowy token API w Holded z uprawnieniami Sales: Read (Sprzedaż: Odczyt), Contacts: Read + Write (Kontakty: Odczyt i zapis) i Developers: Full (Deweloperzy: Pełny dostęp), kliknij Wklej nowy klucz na banerze i wklej go. W międzyczasie naliczanie nadal działa dzięki dopasowywaniu po e-mailu i telefonie.

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.