fbpx

Příklad napojení

Příklady napojení

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:

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.


Slot Online Bandarsloto casino88 Slot Gacor Situs Slot88 Terpercaya Situs Slot Deposit Dana Slot Gacor Gampang Maxwin Slot777 Deposit Pulsa Tanpa Potongan Slot123 Slot303 Slot Gacor Server Thailand Megawin