Hostware integráció - Új funkciók (2026-03)
HostWare költés és pont frissítés (szinkronizáció) — Adminisztrátori kézikönyv
1. Bevezetés
A HostWare költés és pont frissítés (szinkronizáció) funkció lehetővé teszi, hogy a vendégek tényleges költési adatai (szállásdíj, étterem, wellness, minibar stb.) automatikusan bekerüljenek a loyalty rendszerbe.
Mi változik?
- Költéseknél és pontoknál pontosabb visszajelzést ad a rendszer az automatikus HostWare szinkronizálásról
- Az admin manuálisan is lekérheti a HostWare adatokat egyedi rekordokhoz
- A napi feldolgozás alatt a szerkesztés korlátozva van (0:00-9:00)
2. Adatfolyam áttekintése
Időrendi sorrend (egy foglalás életciklusa)
Vendég bejelentkezés (check-in)
│
▼
Tartózkodás (szállás, étterem, wellness, minibar, stb.)
│
▼
Vendég kijelentkezés (check-out / departure)
│
▼
HostWare elküldi a bevételi adatokat éjfél után (minden nap 0:00-6:00)
│
▼
═══════════════════════════════════════════════════════════════════════════
NAPI FELDOLGOZÁS (automatikus)
═══════════════════════════════════════════════════════════════════════════
07:15 / 07:45 Adatok normalizálása
08:30 Költések frissítése HostWare-ből
08:45 Pontok frissítése HostWare-ből
09:00 Feldolgozás vége — költések és pontok szerkeszthetőek
═══════════════════════════════════════════════════════════════════════════
│
▼
Az eredmény látható a loyalty profilban
Fontos: 09:00-ig korlátozott szerkesztés
Ha a rendszer észleli, hogy egy rekordhoz elérhető HostWare adat (de még nem dolgozta fel), a rekord szerkesztése 09:00-ig blokkolva van. Ez azért szükséges, mert a napi feldolgozás (08:30 / 08:45) felülírná a manuális módosításokat.
09:00 után a blokkolás automatikusan feloldódik.
3. HostWare státuszok
Minden költés és pont rekord rendelkezik egy HostWare státusszal, amely jelzi a szinkronizáció állapotát.
| Táblában | Státusz | Jelentés |
|---|---|---|
| — | Kihagyva | Régi rekord, nem kerül feldolgozásra |
| ![HW] Feldolgozásra vár | Feldolgozásra vár | Új rekord, a napi cron még nem dolgozta fel |
| ![HW] Adat elérhető | Adat elérhető | HostWare adat megtalálva, a cron hamarosan feldolgozza |
| ![HW] Szinkronizálva + dátum | Szinkronizálva | A napi feldolgozás sikeresen frissítette |
| ![HW] Kézzel szinkronizálva + dátum | Kézzel szinkronizálva | Az admin manuálisan frissítette |
| ![HW] Szinkronizálás sikertelen | Sikertelen | A feldolgozás hibába ütközött |
Megjegyzés: A HostWare ikon és státusz csak foglaláshoz kapcsolt rekordoknál jelenik meg. Foglalás nélküli rekordoknál (pl. manuálisan hozzáadott költés) az oszlop üres. A szinkronizálás dátuma csak a "Szinkronizálva" és "Kézzel szinkronizálva" státuszoknál látható.
4. Költés és pont lista
4.1 Oszlopok
A régi Lezárt oszlop már Manuálisként szerepel. A HostWare státusz pedig kapott saját oszlopot.
- Manuális (👆): Jelzi, ha a rekord manuális módban van (az admin manuálisan rögzítette az értéket, a cron nem módosítja)
- HostWare: A HostWare szinkronizáció állapotát mutatja (ikon + státusz + dátum)
4.2 Kontextus menü
Minden foglaláshoz kapcsolt rekordnál megjelenik a "Frissítés HostWare-ből" menüpont a hárompontos menüben.
Megjegyzés: Ha a rekordhoz nincs foglalás rendelve (pl. manuálisan hozzáadott költés), a gomb nem jelenik meg.
5. Manuális HostWare frissítés
5.1 Mikor használjam?
- Ha nem akar várni a napi automatikus feldolgozásra (09:00)
- Ha egy régi rekordot szeretne utólag szinkronizálni
- Ha a napi feldolgozás sikertelen volt és újra szeretné próbálni
5.2 Költés frissítése
- Nyissa meg a vendég loyalty profiljának Költések fülét
- Kattintson a kívánt költés hárompontos menüjére → "Frissítés HostWare-ből"
- A megjelenő ablakban láthatja:
- A HostWare adat állapotát (zöld = kész, kék = hiányos, sárga = nincs adat)
- Az aktuális és az új értékek összehasonlítását (összeg, éjszakák)
- Ha az adatok készek, kattintson a "Frissítés HostWare-ből" gombra
- A rekord frissül, manuális módba kerül, és "Kézzel szinkronizálva" státuszt kap
5.3 Pont frissítése
- Nyissa meg a vendég loyalty profiljának Pont tranzakciók fülét
- Kattintson a kívánt pont hárompontos menüjére → "Frissítés HostWare-ből"
- A megjelenő ablakban láthatja:
- A foglalás HostWare szerinti összegét (pl. "Foglalás összege HostWare adatok szerint: 103 120 HUF (2 éj)")
- Az aktuális és az újrakalkulált pontok összehasonlítását
- Erősítse meg a frissítést
5.4 09:00 előtti blokkolás
Ha a HostWare adat elérhető, de a napi feldolgozás még nem futott le (09:00 előtt), a manuális frissítés gomb le van tiltva.
6. Foglalás hozzárendelés HostWare adattal
Amikor egy foglalást hozzárendel egy loyalty felhasználóhoz (távozás után), a rendszer automatikusan:
- Ellenőrzi a HostWare bevételi adatokat a foglaláshoz
- Ha elérhető: A költés és a pontok a HostWare összeg alapján kerülnek rögzítésre, a rekord manuális módba kerül
- Ha nem elérhető: A foglalási ár alapján kerülnek rögzítésre — a napi feldolgozás később frissíti, ha HostWare adat érkezik
Megjegyzés: A hozzárendelés során nincs külön visszajelzés arról, hogy melyik forrásból származik az összeg. Ez nem probléma, mert a napi cron mindenképpen frissíti a rekordokat a HostWare adatok alapján, amint azok elérhetővé válnak.
7. Szerkesztés és manuális mód
7.1 Szerkesztési szabályok
| Státusz | Szerkeszthető? | Megjegyzés |
|---|---|---|
| Kihagyva (-1) | Igen | Régi rekord, nincs korlátozás (egy "-" jel jelenik meg a HostWare oszlopban) |
| Feldolgozásra vár (0) | Lásd lent* | A szerkesztő megnyitásakor a rendszer ellenőrzi a HW adatokat |
| Adat elérhető (1) | 09:00 után igen | 09:00-ig a mentés gomb le van tiltva |
| Szinkronizálás sikertelen (2) | 09:00 után igen | A cron újra próbálja, 09:00-ig blokkolva |
| Szinkronizálva (3) | Igen | - |
| Kézzel szinkronizálva (4) | Igen | Az automata feldolgozó kihagyja (mint a manuális módban lévő rekordokat) |
| Bármely + manuális mód (👆) | Igen (adminból), nem (automata feldolgozó) | Az automata feldolgozó nem módosítja, de admin igen |
* "Feldolgozásra vár" rekord szerkesztése:
Amikor a szerkesztő ablakot megnyitja egy "Feldolgozásra vár" státuszú, foglaláshoz kapcsolt rekordra, a rendszer automatikusan ellenőrzi, hogy elérhető-e HostWare adat a foglaláshoz:
- Ha van HW adat: A státusz azonnal "Adat elérhető"-re vált, figyelmeztetés jelenik meg, és 09:00 előtt a mentés gomb le van tiltva
- Ha nincs HW adat: A szerkesztés normálisan működik, nincs korlátozás
7.2 Manuális mód (👆)
A manuális mód azt jelenti, hogy semmilyen automatikus feldolgozás nem módosítja a rekordot. Az admin azonban továbbra is szerkesztheti.
Manuális módba kétféleképpen lehet állítani:
- A szerkesztő ablakban a jelölőnégyzet bekapcsolásával
- A manuális HW frissítés automatikusan manuális módba állítja a rekordot
7.3 HW figyelmeztetés a szerkesztő ablakban
Ha egy rekordhoz elérhető HostWare adat (státusz = "Adat elérhető") és nincs manuális módban, a szerkesztő ablakban figyelmeztetés jelenik meg.
8. Napló
A költés és pont naplóban a HostWare szinkronizáció is megjelenik:
- A "HostWare státusz" mező értéke a szinkronizáció állapotát
- A "HostWare frissítve" mező mutatja a szinkronizáció időpontját
Szerkesztés esetén balra a korábbi állapot, jobbra az új állapot látható.
9. Meglévő (régi) rekordok kezelése
A funkció bevezetésekor azok a költés és pont rekordok kapnak "Kihagyva" státuszt, amelyekhez tartozó foglalás távozási dátuma a bevezetés napján vagy az előtt van. Ez azt jelenti:
- A napi automatikus feldolgozás nem nyúl hozzájuk — a régi adatok változatlanok maradnak
- A HostWare oszlopban egy
-jel jelenik meg (foglaláshoz kapcsolt rekordoknál) - Az admin szabadon szerkesztheti őket, nincs korlátozás
- A "Frissítés HostWare-ből" gomb elérhető — ha az admin szeretné utólag szinkronizálni egy régi rekordot a HostWare adatokkal, megteheti
A bevezetés után távozó vendégek foglalásaihoz tartozó rekordok már "Feldolgozásra vár" státusszal jönnek létre, és automatikusan feldolgozásra kerülnek.
Összefoglalva: A régi rekordokkal nem kell semmit csinálni. Ha szükséges, egyenként frissíthetők a "Frissítés HostWare-ből" funkcióval.
10. Gyakori kérdések
K: Miért nem jelenik meg a "Frissítés HostWare-ből" gomb?
- A rekordhoz nincs foglalás rendelve
- A Loyalty -> Beállítások -> HostWare beállításokban nincs bekapcsolva a pontok/költések frissítése. Ez hotelenként külön van beállítva.
K: Miért nem tudok menteni a szerkesztő ablakban?
- A rekord "Adat elérhető" státuszban van és 09:00 előtt van. Várja meg a napi feldolgozás végét.
K: A manuális frissítés után a cron felülírja az adatokat?
- Nem. A "Kézzel szinkronizálva" státuszú rekordokat a cron kihagyja, ugyanúgy mint a manuális módban lévő rekordokat.
K: Mi történik, ha a HostWare adat még nem teljes?
- A manuális frissítés ablakban kék infó jelzi, hogy az adatok hiányosak. A frissítés gomb le van tiltva ilyenkor.
K: Lehet-e egy korábban szinkronizált rekordot újra frissíteni?
- Igen. A "Frissítés HostWare-ből" gomb elérhető minden foglaláshoz kapcsolt rekordnál, függetlenül a státusztól.
