Propojení na restaurační software
Na níže uvedeném příkladu si ukážeme základní a pravděpodobně i nejčastější příklad použití API a to propojení na restaurační software a zasílání položek z restaurace na účet pokoje v Previu.
Technicky se jedná o následujicí dva XML POST požadavky na naše API:
- https://xml.apidocs.previo.cz/#5eeb79f1-a2bd-409c-b067-a72330a643d8
- https://xml.apidocs.previo.cz/#fe66a7e3-0fd3-4121-bfde-097c9e65a486
Základní informace o API je možné získat zde:
Obecně komunikace funguje tak, že si zavoláte metodu searchReservations s parametrem term, kde nastavíte from na dnešní datum a to na zítřejší datum. Pokud chcete pouze rezervace ubytovaných hostů, nastavte parametr cosId na 3 (pouze rezervace ve stavu ubytován). Tím získáte seznam rezervací a hostů ubytovaných dnes. Pokud filtrujete rezervace i mimo stav ubytován, pozor na rezervace, kdy host v daný den odjíždí a přijíždí nový, tam je nutné kontrolovat, že rezervace už není ve stavu ukončeno, abyste nenatěžovali na účet hosta, který už odjel.
Poté si host v restauraci vybere jaká rezervace je jeho – resp. řekne Vám své jméno (element guest -> first_name + last_name) případně číslo pokoje (element object -> name), personál vybere tu správnou rezervaci a posílá účet z restaurace na hotelový účet. Zároveň je vhodné, aby mohl číšník natížit položky na účet rezervace nebo zvolit přímo konkrétního hosta v rezervaci, který položky konzumuje (pouze volitelně).
Následně voláte funkci addAccountItem, s parametrem comId (identifikátor rezervace, který jste získali předchozím voláním metody searchReservations). Pokud číšník vybral i konkrétního hosta posíláte navíc jeho identifikátor (gueId). Tím přidáte položku/y na hotelový účet nebo na účet konkrétního hosta.
Určitě byste měli ve funkci addAccountItem zvolit i rastr služby pomocí elementu segId (3- gastro, 1 – bar, 12 – restaurace). Kompletní seznam rastrů je k dispozici zde.
Většina systému, které jsou na nás napojené dovolují zvolit jestli se bude útrata přenášet dohromady nebo zvlášť:
- Útrata v restauraci (25.6.2015 15:45) – 1ks – 15% DPH – 200 Kč
Případně vč. čísla účtenky:
- Útrata v restauraci – 13456789 (25.6.2015 15:45) – 1ks – 15% DPH – 200 Kč
Nebo po položkách:
- Pivo Bernard – 2ks – 10% DPH – 70 Kč
- Husa s knedlíkem a se zelím – 1ks – 10% – 150 Kč
Parametr statuses můžete změnit, pokud bude hotel chtít natěžovat i na rezervace, které nejsou ve stavu „Ubytován“. Seznam dostupných stavů je v API k dispozici zde.
Ukázkové požadavky na metody searchReservations a addAccountItem naleznete přímo v api dokumentaci.