Zapísanie položiek na hotelový účet hosťa

Umožní pripísať položky na hotelový účet. Pre overenie spojenia je použitá Basic Auth, meno a heslo spojenia je potrebné zadať v administračnej časti systému. Pre produkčné prostredie je potrebné v administrácii povoliť IP adresu pre vzdialený dopyt.

Základná url pre API volania:

https://DOMENA-WEBU/api/bor2/

1. Zoznam dostupnych účtov – openbills

https://DOMENA-WEBU/api/bor2/?type=openbills

GET - povinné parametre:
type=(string)openbills

GET - voliteľné parametre:
rfid=(string) - hodnota sa použije pre vyhľadávanie RFID karty hosťa


Odpoveď je pole vo formáte JSON
idr – id rezervácie
id_room - id izby
room_name – meno izby
peoples - pole s menom a identifikátorom hosťa

[{
   "idr": "2084",
   "id_room": "18",
   "room_name": "304",
   "peoples": {
      "1": { "id": "2773", "name": "Peter", "surname": "Ratatuille" },
      "2": { "id": "2774", "name": "Anna", "surname": "Ratatuille" }
}
}]

2. Pripísanie na účet – billtoroom

https://DOMENA-WEBU/api/bor2/?type=billtoroom

GET - povinné parametre:  type=(string)billtoroom

POST (application/json): 

  • idr – id rezervácie
  • id_room - id izby
  • idp - identifikátor hosťa (nepovinné)
  • items - položky na pripísanie

Popis poľa "items":

  • vat – (int) hladina DPH
  • price_vat – (float) cena jednotky s DPH
  • lot – (int) počet jednotiek
  • name – (string) názov položky

 

{
"idr": "2084",
"id_room": "18",
"idp": "2773",
"items": [
   {"vat": 10, "name": "Francuzska polievka", "lot": 2, "price_vat": 1.1 },
   { ... }
]
}

Odpoveď:

1. Úspešné pripísanie

{"status":"Success"}

2. položky poľa errors sa nepodarilo zapísať

{
"status": "Done with errors",
"errors": [{"vat": 15, "name": "Parená knedľa", "lot": 2, "price_vat": 3.8 }]
}

Chybové hlášky:

  1. {"error":"Bad Config"} – nesprávne nakonfigurované položky pre zápis
  2. {"error":"People not on room"} – izba rezervácie ma iný status ako Hostia na izbe
  3. {"error":"Room not found"} – id izby rezervácie nexistuje
  4. {"error":"Reservation is canceled"} – rezervácia bola zrušená
  5. {"error":"Unspecified error"} – chyba v nastavení hotelového účtu