Connect to Hoteliga

Hoteliga is a hotel property management system (PMS) by Epsilon Net. With the link:

• guests who are staying, and those arriving today, come to In-house guests every few minutes,
• every room charge from the till goes to the guest's reservation in Hoteliga as an extra charge.

Before you start

• The Hotel PMS link add-on (see Link with the hotel PMS).
• A Hoteliga API licence: Hoteliga allows 100 API calls a day for free and 1,500 with a paid API licence, shared by all of the hotel's apps. Each sync uses 2–3 calls: every 15 minutes that is about 100–290 a day, plus about one per charge. So you need the API licence. Ask Hoteliga for it.
• A Hoteliga user just for the POS, not your own. That way you can see what the POS did and switch it off whenever you like.
• Only the owner can open the Hoteliga page.

Step by step

1. Hotel → Hoteliga. Fill in the Hoteliga domain (the name of the hotel's Hoteliga account), Username and Password. The password is stored encrypted and never shown again.
2. Press Save, then Test connection. You see "Connected to Hoteliga: … rooms, … extra charges".
3. Book charges as: pick the Hoteliga extra charge the POS charges go to (e.g. Restaurant or Bar). If it is missing, create it in Hoteliga first and press Test connection again.
4. Rooms: next to each of your rooms pick the Hoteliga room. Match by name links them by itself when the names fit ("Room 7" with "07"). Hoteliga rooms with no match are listed below.
5. Automatic sync: every 5, 10, 15 (default), 30 or 60 minutes. The more often, the more API calls.
6. Press Save.
7. Under Hotel & PMS set PMS link to Hoteliga connection and save. Until then the Hoteliga page shows a warning and nothing is sent.
8. Press Sync now and check the guests under In-house guests.

The page shows the Last sync and how many Hoteliga API calls are left today. When fewer than 50 are left, the automatic sync stops for that day so that enough remain for the charges.

What appears in Hoteliga

On the guest's reservation, under extra charges, one line per room charge:

• extra charge: the one you picked in step 3,
• date: the day of the payment, quantity 1, price: the amount charged,
• notes: "IKAROS POS · store · #order number · [IKAROS-P…]". When IKAROS POS issues the receipt, the notes also say "Receipt … ΜΑΡΚ … (already issued)", so the reception does not issue a second one.

[IKAROS-P…] is the charge's code. If a send is repeated, the POS finds it and does not book the charge twice. Don't delete it from the notes.

On the till side, under Room charges, the PMS column says In the PMS and, when you hover over it, the charge's code in Hoteliga.

Something's wrong

• "Hoteliga did not accept the login": wrong domain, username or password, or the user is switched off in Hoteliga. Type them again and press Test connection.
• "Hoteliga could not be reached" or an answer 429: Hoteliga does not answer or the day's calls ran out. Charges are sent again by themselves later.
• No guests come in: check that Hoteliga is selected under Hotel & PMS, that the rooms are matched and that the guest is checked in at Hoteliga. Press Sync now.
• "Choose under which Hoteliga extra charge…": step 3 is missing.
• "This stay is not a Hoteliga reservation": the guest was added by hand or by CSV. Only charges to guests who came from Hoteliga go to Hoteliga.
• "Waiting for the receipt to be issued": the charge waits for the receipt's ΜΑΡΚ and goes as soon as it is issued.

Everything else (send again, key in by hand, refunds): A room charge did not reach the PMS.