Povezivanje sa Apaleom
Korak po korak: aplikacija u Apaleu, dozvole, povezivanje i sve što Kleenee i Apaleo razmenjuju.
Za koga je: Vlasnici i menadžeriApaleo je PMS u oblaku koji Kleenee podržava u oba smera. Kada povežete objekat, sobe i boravci dolaze iz Apalea, a stanje sobe, minibar i štete idu nazad u Apaleo. Ovaj vodič pokazuje kako se veza pravi i šta tačno radi. Opšte o PMS vezama pročitajte u Povezivanje PMS-a.
Šta se razmenjuje
| Iz Apalea u Kleenee | Iz Kleenee-a u Apaleo |
|---|---|
| Sobe: naziv, tip sobe i kapacitet | Stanje sobe: čista, prljava, čeka kontrolu |
| Boravci: datumi, vreme dolaska i odlaska, otkazivanja, premeštanja | Minibar na račun gosta (ako ga uključite) |
| Broj gostiju: samo broj odraslih i dece | Šteta od gosta na račun gosta (kada je pošaljete) |
| Prijava i odjava gosta | Storno knjižene stavke |
| Stanje sobe koje recepcija promeni u Apaleu | Napomene na boravku: izgubljeno i nađeno, kvarovi (ako ih uključite) |
| Usluge uz boravak: ljubimac, dodatni krevet, krevetac, dodatno čišćenje | Odjava, kasna odjava, raniji dolazak, produženje i promena sobe sa recepcije (ako ih uključite) |
| Vremenska zona objekta |
Imena, kontakti i ostali podaci gostiju se nikad ne preuzimaju.
Pre početka
- U Apaleu vam treba korisnik sa ulogom administratora naloga (Account Admin). Samo on može da napravi aplikaciju.
- Treba vam šifra objekta u Apaleu, na primer BER. Vidi se u Apaleu pored naziva objekta.
- U Kleenee-u vezu pravi menadžer ili vlasnik, na stranici Integracije.
1. Napravite aplikaciju u Apaleu
- Prijavite se u Apaleo i otvorite nivo naloga (ne pojedinačni objekat).
- Otvorite Apps, pa Connected apps, i izaberite Add a new app, pa Add custom app.
- Popunite formu:
- Client code: na primer KLEENEE (slova, brojevi i donja crta).
- Client name: na primer Kleenee.
- Personally identifiable information: izaberite Omit all. Kleenee ne koristi podatke gostiju, pa ih ne treba ni da dobije. Ovo se kasnije ne može promeniti.
- Client access: izaberite Scope client, da biste mogli da označite dozvole iz tabele ispod.
- Scopes: označite dozvole iz sledećeg koraka.
- Secrets: dodajte jednu tajnu, na primer sa opisom Kleenee.
- Sačuvajte. Apaleo prikazuje Client ID i Client secret. Kopirajte oba pre nego što zatvorite prozor.
2. Dozvole
| Dozvola | Čemu služi | Potrebna |
|---|---|---|
units.read | Sobe, tip sobe i stanje sobe iz Apalea | Uvek |
reservations.read | Boravci, broj gostiju, prijava, odjava i usluge | Uvek |
operations.change-room-state | Kleenee javlja Apaleu da je soba čista, prljava ili čeka kontrolu | Uvek |
| Webhook API | Promene iz Apalea stižu odmah, a ne na svakih nekoliko minuta | Preporučeno |
folios.read | Kleenee pronalazi otvoren račun gosta | Za naplatu |
charges.create | Minibar i šteta se knjiže na račun gosta | Za naplatu |
allowances.post | Storno knjižene stavke | Za naplatu |
reservations.manage | Recepcija u Apaleu i napomene na boravku | Za recepciju i napomene |
Umesto poslednje tri možete dati i folios.manage, koja ih sve obuhvata. Dozvole kasnije možete menjati u istoj aplikaciji, bez novog povezivanja u Kleenee-u. Koje dozvole trebaju za ono što ste uključili, Kleenee pokazuje na stranici Integracije, u delu Dozvole za aplikaciju u Apaleu.
3. Povežite objekat u Kleenee-u
- Otvorite Integracije i pronađite objekat.
- Za Sistem izaberite Apaleo.
- Unesite Šifra objekta u PMS-u (na primer BER), Client ID i Client secret.
- Pritisnite Sačuvaj.
Ako objekat u Kleenee-u već ima sobe, Kleenee pre čuvanja traži potvrdu: sve postojeće sobe se zamenjuju sobama iz Apalea. Stare sobe ostaju u istoriji, a njihovi nezavršeni zadaci se otkazuju. Posle toga se sobe ne dodaju i ne preimenuju ručno; sprat i stanje sobe i dalje menjate u Kleenee-u.
Odmah po čuvanju Kleenee preuzima sobe i boravke i prijavljuje objekat za trenutne promene iz Apalea. Ključevi se čuvaju zaštićeno i niko ih ne može ponovo videti, ni u Kleenee-u. Kada kasnije menjate podešavanja, ostavite polja za ključeve prazna da ih zadržite.
Kako radi svakog dana
- Čišćenja prate boravke. Svaki boravak iz Apalea dobija čišćenje posle odlaska. Kasni odlazak upisan u Apaleu pomera rok čišćenja, a rani dolazak traži da soba bude očišćena do dolaska.
- Odjava u Apaleu. Kada recepcija odjavi gosta, soba u Kleenee-u postaje Prljavo i čišćenje je odmah na redu. Ako je gost otišao pre planiranog dana, boravak se završava danas.
- Prijava u Apaleu. Soba se vodi kao zauzeta umesto kao dolazak.
- Stanje sobe ide u Apaleo. Kada soba postane Čisto ili Provereno, Apaleo dobija Clean; Čeka kontrolu postaje CleanToBeInspected, a Prljavo Dirty. Statusi Čisti se i Van upotrebe se ne šalju.
- Stanje sobe dolazi iz Apalea. Kada recepcija u Apaleu promeni stanje sobe, menja se i u Kleenee-u. Izuzetak je soba koja se upravo čisti ili je van funkcije, i promena iz Kleenee-a koja još nije poslata.
- Broj gostiju i tip sobe vide se na kartici sobe u rasporedu. Promene objekta i tipova soba u Apaleu stižu odmah.
- Istorija promena. Ono što je stiglo iz Apalea u istoriji se vidi kao PMS (sinhronizacija).
Usluge uz boravak
Usluge koje gost rezerviše u Apaleu Kleenee vidi uz boravak. Na stranici Integracije, u delu Usluge iz PMS-a, za svaku uslugu izaberite šta znači:
| Značenje | Šta Kleenee radi |
|---|---|
| Ljubimac | Soba dobija oznaku ljubimca dok je gost u njoj. |
| Dodatni krevet | Zahtev sa rokom do dolaska, dan ranije ili na dan dolaska. |
| Krevetac | Zahtev sa rokom do dolaska, dan ranije ili na dan dolaska. |
| Dodatno čišćenje | Zadatak čišćenja na svaki dan za koji je usluga rezervisana. |
| Prikaži u rasporedu | Usluga se ispisuje na kartici sobe u rasporedu. |
| Zanemari | Ništa. |
Kleenee prvi put sam pogađa značenje po nazivu usluge; promenite ga ako ne odgovara. Zahtevi i dodatna čišćenja traže paket koji ih ima. Cene usluga se ne preuzimaju.
Naplata na račun gosta
U delu Naplata na račun gosta birate:
- Knjiži minibar na račun gosta: minibar koji osoblje upiše ide na otvoren račun gosta u Apaleu za nekoliko minuta. Podrazumevano je isključeno.
- PDV za štetu: koji PDV ima šteta na računu.
PDV za svaki artikal minibara birate na stranici Zalihe, u polju PDV na računu gosta. Štetu šaljete sami: na stranici Kvarovi, kod štete čiji je boravak iz Apalea, upišite naziv koji gost vidi na računu i pritisnite Naplati preko PMS-a. Kada je šteta knjižena, naplata prelazi u Prijavljeno platformi.
Poslednje stavke vidite u istom delu. Storniraj skida knjiženu stavku sa računa (šteta tada prelazi u Otpisano), a Ne šalji zaustavlja stavku koja još nije poslata. Svaka stavka se šalje sa ključem koji sprečava da se knjiži dvaput. Minibar i štete traže paket koji ih ima.
Recepcija i napomene u Apaleu
U delu Recepcija u PMS-u birate šta Kleenee radi u Apaleu. Svako podešavanje je posebno i podrazumevano isključeno, a za sva treba dozvola reservations.manage.
| Podešavanje | Šta Kleenee radi u Apaleu |
|---|---|
| Napomene na boravku: izgubljeno i nađeno, kvarovi u sobi sa gostom | Upisuje kratak red u internu napomenu rezervacije, na primer „Kleenee: pronađen predmet u sobi 101: crni punjač. Čuva se: recepcija.“ Kada se predmet vrati ili se kvar popravi, red se menja. |
| Gost se odjavio | Kada recepcija pritisne Gost se odjavio, gost se odjavljuje i u Apaleu. Ako je otišao ranije, boravak se prvo skraćuje na danas. |
| Kasna odjava i raniji dolazak | Kasna odjava menja vreme odlaska gosta koji danas odlazi, a Raniji dolazak vreme dolaska gosta koji danas stiže. |
| Produženje boravka | Boravak dobija novi dan odlaska. Nove noći dobijaju cenovni plan poslednje noći i cenu iz Apalea. |
| Promena sobe | Boravak se od danas nastavlja u novoj sobi. |
- Pronađeni predmet ide na boravak poslednjeg gosta u sobi: onog koji je u njoj ili koji je poslednji otišao. Kvar ide na boravak gosta koji ostaje u sobi, a šteta od gosta na boravak za koji je vezana.
- Kleenee menja samo svoje redove napomene, koji počinju sa „Kleenee:“. Ostatak napomene ostaje kako jeste, a Kleenee ga ne čuva.
- Promene sa recepcije idu u Apaleo odmah. Ako ih Apaleo odbije, na primer jer nema slobodne sobe ili gost u Apaleu nije prijavljen, promena u Kleenee-u ostaje, a recepcija vidi poruku i unosi promenu u Apaleo ručno.
- Poslednje radnje i greške vidite u istom delu. Pokušaj ponovo šalje radnju ponovo, a Ne šalji je zaustavlja.
Kada nešto ne radi
Greška se vidi kod veze na stranici Integracije, a za stavke naplate i radnje recepcije pored svake stavke.
| Poruka | Šta znači | Šta uraditi |
|---|---|---|
Apaleo property code missing | Šifra objekta nije uneta ili nije ispravna | Upišite šifru objekta iz Apalea, na primer BER |
HTTP 401 | Client ID ili Client secret nisu ispravni | Proverite ključeve ili dodajte novu tajnu u Apaleu i unesite je |
HTTP 403 | Aplikaciji fali dozvola | Dodajte dozvolu iz tabele iznad |
HTTP 422 | Apaleo je odbio promenu | Poruka posle broja kaže zašto, na primer da je račun zatvoren |
Apaleo has no open guest folio for this stay | Račun gosta je već zatvoren | Naplatite na recepciji; stavka u Kleenee-u ostaje nenaplaćena |
the PMS lists no rooms for this property | Apaleo nije vratio nijednu sobu | Proverite šifru objekta i dozvolu units.read |
the guest is not checked in in Apaleo | Gost u Apaleu nije prijavljen, pa ne može ni da se odjavi | Prijavite ga i odjavite u Apaleu |
Ako pri čuvanju vidite poruku da Apaleo nije prihvatio prijavu za trenutne promene, veza radi, ali promene iz Apalea stižu na svakih nekoliko minuta. Dodajte aplikaciji dozvolu za webhookove i ponovo sačuvajte vezu.
Pauza i uklanjanje
Pritisnite Sinhronizuj odmah da odmah preuzmete sobe i boravke. Pauziraj privremeno zaustavlja vezu. Ukloni briše vezu i odjavljuje objekat iz Apalea; sobe i boravci ostaju u Kleenee-u, a sobe ponovo menjate sami.