Hotel availabilities - Galaxy Hotel integration

Εισαγωγή

Ο οδηγός αυτός σχεδιάστηκε για να σας κατευθύνει βήμα-βήμα ως προς τις κινήσεις που πρέπει να κάνετε για τη σωστή διασύνδεση με το σύστημα της Hotel Availabilities .

 

ΒΗΜΑΤΑ

Η όλη διαδικασία συνοψίζεται στα παρακάτω βήματα:

Επιλέξτε “Internet Apps” από τις ρυθμίσεις “Hospitality”

Ρυθμίσεις Hotels

Στην οθόνη “Ρυθμίσεις 4Hotels”, επιλέξτε, από τη λίστα ξενοδοχείων, το επιθυμητό (στο οποίο θα έχουν ισχύ οι ρυθμίσεις) και θέστε την ένδειξη “Ενεργό”.

  • Πατήστε στη σελίδα “Ρυθμίσεις Hotel Availabilities
  • Συμπληρώστε κατάλληλα το πεδίο Hotel Availabilities URL. Χρησιμοποιείστε το https://api.hotelavailabilities.com/v1.0
  • Μεταβείτε στην υποσελίδα “Στοιχεία εισόδου” και ενημερώστε με τα διαπιστευτήρια - login credentials (API Key, Property ID - Σε περιπτώσεις multiproperty συμπληρώστε και το πεδίο Hotel code)

Graphical user interface, text, application</p>
<p>Description automatically generated

 

Αν προϋπάρχει σύνδεση WebHotelier στο MyGalaxy θα χρειαστεί πρωτίστως να την απενεργοποιήσετε στο περιβαλλον του MyGalaxy/4Hotels ώστε η ιστοσελίδα να μην αντλεί δεδομένα κρατήσεων από την WebHotelier. Στη συνέχεια, θα πρέπει να επικοινωνήσετε με την υποστήριξη της WebHotelier προκειμένου να απενεργοποιήσουν τη διαδικασία push των κρατήσεων προς το MyGalaxy/4Hotels.

Graphical user interface, text, application</p>
<p>Description automatically generated

D:\MyDocs\Galaxy\icons\attention.png Αν υπάρχει σύνδεση με το MyGalaxy/4Hotels, επειδή αυτή προϋποθέτει αποκλειστική συσχέτιση των guest, κρατήσεων, δωματίων με το κάθε ξενοδοχείο, εκτελείται έλεγχος που απαγορεύει την αλλαγή ξενοδοχείου σε αυτές τις οντότητες όπως και τη χρήση guest από διαφορετικό ξενοδοχείο σε μια κράτηση.

Για να ΜΗΝ διενεργείται αυτός έλεγχος ενσωματώθηκε το πεδίο “Απενεργοποίηση συγχρονισμού” (disable sync) στις ρυθμίσεις για το MyGalaxy/4Hotels.

Αν ενεργοποιηθεί, γίνουν σχετικές δια-ξενοδοχειακές αλλαγές και στη συνέχεια απενεργοποιηθεί, τότε ξεκινώντας εκ νέου τον MyGalaxy/4Hotels συγχρονισμό υπάρχει κίνδυνος να αλλοιωθούν τα δεδομένα .

σημείωση ΣΗΜΕΙΩΣΗ

Αν για μια κράτηση που έχει προέλθει από τη Hotel Availabilities και έχει αλλάξει ξενοδοχείο, έρθει ενημέρωση από τη Hotel Availabilities, η εξ ορισμού συμπεριφορά είναι : να εντοπιστεί η κράτηση στο άλλο ξενοδοχείο και να ενημερωθεί με τα Hotel Availabilities settings του ξενοδοχείου που διενεργεί το συγχρονισμό.

Η εν λόγω συμπεριφορά μπορεί να αλλάξει με τη χρήση του custom parameter (LimitHotAvailToSyncHotel) όπου δεν θα γίνει εύρεση της κράτησης στο άλλο ξενοδοχείο αλλά θα δημιουργηθεί νέα κράτηση στο αρχικό ξενοδοχείο .

Στη συνέχεια,

  • Επιλέξτε “Αποθήκευση” των επιλογών σας.

 

Λήψη δεδομένων Hotel Availabilities

Για τη λήψη των δεδομένων, που αντιστοιχούν στο ξενοδοχείο σας, από το σύστημα της Hotel Availabilities, πατήστε στις “Ενέργειες” και εκτελέστε “Hotel Availabilities” και από εκεί “Λήψη Rates”.

Graphical user interface, text, application</p>
<p>Description automatically generated

Αντιστοιχίσεις

Επιλέξτε τη σελίδα “Αντιστοιχίσεις” και προχωρήστε στις αντιστοιχίσεις για meal plan, επιβαρύνσεις, χρεώσιμος τύπος δωματίου και pax type.

Graphical user interface, text, application</p>
<p>Description automatically generated

Table</p>
<p>Description automatically generated

Στον πίνακα με τα correlations για τα rate types, κάθε HotelAvailabilities rate type μπορεί να χρησιμοποιηθεί μόνο μια φορά. Αν ο χρήστης συγχρονίζει μόνο κρατήσεις από το HotelAvailabilities προς το Galaxy Hotel, τότε μπορεί να χρησιμοποιήσει το ίδιο Hotel rate type πάνω από μία φορές (DBL στην εικόνα).

Ωστόσο, αν ο χρήστης συγχρονίζει και Availabilities, θα πρέπει κάθε τιμή στην κολόνα “Τύπος pax ξενοδοχείου” να είναι μοναδική.

Table</p>
<p>Description automatically generated with medium confidence

Προσοχή: πρέπει να οριστεί το NA στα meal plans

Table</p>
<p>Description automatically generated

Για τις κρατήσεις που τα δεδομένα περιέχουν την πληροφορία “πηγή”, το σύστημα θα συνδέσει το Hotel Availabilities source id με νέο χρεώστη αν το source id δεν βρεθεί στη βάση και θα τον επαναχρησιμοποιήσει αν το ίδιο source id προκύψει εκ νέου σε νέα κράτηση. 

Ο συγκεκριμένος debtor συνδέεται by default στο πεδίο “πηγή” της κράτησης. Ο χειριστής μπορεί να επιλέξει αντί του source να γίνεται σύνδεση στο πεδίο booker της κράτησης επιλέγοντας το σχετικό πεδίο “Πηγή ως χρεώστης” στις ρυθμίσεις .

Graphical user interface, text, application, email</p>
<p>Description automatically generated

 

Χρήση χρεώστη

Για όσες κρατήσεις έρχονται από το σύστημα Hotel Availabilities χρησιμοποιείται ο ανοιχτός τιμοκατάλογος (τύπου Pax Analysis).

Ωστόσο, στη σελίδα “Χρήση Χρεώστη” μπορείτε να δηλώσετε ότι κάθε κράτηση που έχει συγκεκριμένο χρεώστη/πηγή αποθηκεύεται στο “Galaxy με συγκεκριμένο τιμοκατάλογο”. Η κολόνα “Χρήση” προσδιορίζει αν ο συγκεκριμένος “Χρήστης” θα εισαχθεί στο πεδίο “Χρεώστης” ή στο πεδίο “Πηγή” της κράτησης.

Graphical user interface, application</p>
<p>Description automatically generated

Συγχρονισμός κρατήσεων

Για το συγχρονισμό κρατήσεων καλέστε “Ενέργειες” και πατήστε την επιλογή “Συγχρονισμός (Μη αυτόματα)”.

Το σύστημα θα εμφανίσει σχετικό μήνυμα για την πραγματοποίηση ασύγχρονης κλήσης συγχρονισμού.

Graphical user interface, application</p>
<p>Description automatically generated

Hotel Availabilities Synchronization Logs

Καλέστε Web sync logs (ενσωματωμένο στο μενού Ιστός του Hospitality) και δείτε τα logs από τη διαδικασία συγχρονισμού

Στο αριστερό τμήμα της οθόνης απεικονίζονται τα json calls που έρχονται από το σύστημα της Hotel Availabilities και περιλαμβάνουν όλες τις κρατήσεις.

Στο δεξί τμήμα, κάθε γραμμή είναι και μια κράτηση (μήνυμα που καταγράφηκε, αριθμός κράτησης).

Η κολόνα “Sync” δείχνει αν η κράτηση έχει συγχρονιστεί με επιτυχία.

Αν για οποιαδήποτε αιτία η εισαγωγή της κράτησης στο “Galaxy” αποτύχει, καταγράφεται στο αρχείο σφαλμάτων η αιτία που οδήγησε στην απόρριψή της. Στην περίπτωση αυτή μπορείτε είτε να επέμβετε στο json της κράτησης είτε να διορθώσετε τα λανθασμένα σημεία στο Galaxy π.χ. κάποια αντιστοίχιση .

Σε περίπτωση αλλαγής στο αρχείο json, πατήστε “ΟΚ” και “Αποθήκευση”.

Αφού γίνουν οι απαραίτητες διορθώσεις, επιλέξτε από τις “Ενέργειες συγχρονισμού”|Επανασυγχρονισμός κράτησης για τον εκ νέου συγχρονισμό της συγκεκριμένης κράτησης.

Availabilities Synchronization

Για το συγχρονισμό διαθεσιμότητας από το Galaxy Hotel προς το σύστημα της Hotel Availabilities καλέστε Hospitality | Ιστός | Διαθεσιμότητα Internet

Ο συγχρονισμός διαθεσιμότητας γίνεται ανα χρεώσιμο τύπο δωματίου, πράγμα που σημαίνει ότι πρέπει να ενεργοποιηθεί  το custom param AvailabilityPerRateRoomType με τιμή “1”.

Αν στη συγκεκριμένη εγκατασταση προϋπάρχουν δεδομένα availability καταχωρισμένα ανά τύπο δωματίου (συγχρονισμός MyGalaxy/4Hotels) θα πρέπει να διαγραφούν πριν την ενεργοποιηση του AvailabilityPerRateRoomType.  

Επιλέγοντας “Internet Availability” ανοίγει η φόρμα HTAvailabilityPerRateRoomF (per rate room type).

Για να δημιουργήσετε μια νέα διαθεσιμότητα για κάποιο rate type,

  • Mεταβείτε στο πλάνο και επιλέξτε τα κελιά που αντιστοιχούν στις επιθυμητές ημερομηνίες
  • Πατήστε enter και πληκτρολογήστε τον αριθμό διαθεσιμότητας

Πατήστε “αποθήκευση” για να αποθηκεύσετε τις νέες διαθεσιμότητες.

Για να συγχρονίσετε τα δεδομένα σας στην HotelAvailabilities, πατήστε το πλήκτρο “Synchronize”. Eκτελείται η διαδικασία upload των αλλαγών της διαθεσιμότητας προς τη “HotelAvailabilities”.

Μόλις έρθει μια κράτηση από HotelAvailabilities για κάποιο rate type, τότε η διαθεσιμότητα μειώνεται. Για παράδειγμα αν ορίσετε μια διαθεσιμότητα “10” για κάποιο χρεώσιμο τύπo (rate type) X από ημ/νία Α έως Β, τότε αν έρθουν “2” κρατήσεις από HotelAvailabilities μέσα στις συγκεκριμένες ημερομηνίες η διαθεσιμότητα θα γίνει “8”.

Αν για τις ημερομηνίες αυτές ορίσετε εκ νέου διαθεσιμότητα “20”, τότε μετά την αποθήκευση, μπορεί να εκτελεστεί διαδικασία επανυπολογισμού και να υπολογιστεί εκ νέου η διαθεσιμότητα με βάση τις υπάρχουσες κρατήσεις που έχουν προέλθει από HotelAvailabilities για το συγκεκριμένο “Rate type”. Δηλαδή για τις ημερομηνίες των κρατήσεων θα προκύψει αποτέλεσμα 18.

Για να συγχρονίσετε τις διαθεσιμότητες, επιλέξτε το πλήκτρο ενεργειών “Συγχρονισμός”.

Graphical user interface, application</p>
<p>Description automatically generated

Σε περίπτωση που το σύστημα εντοπίσει την ύπαρξη παραμετροποίησης WebHotelier ταυτόχρονα με HotelAvailabilities, θα εμφανίσει την παρακάτω ερώτηση σχετικά με το ποιο κύκλωμα θα πρέπει να ενημερωθεί.

Για να ενημερώσετε την HotelAvailabilities πατήστε “Όχι”

Αν μετά το συγχρονισμό Availability, μεταφερθείτε στην οθόνη Sync logs, θα παρατηρήσετε ότι πλέον στο call type “Availability” εμφανίζονται τρείς (3) νέες κολόνες:

  • Update ID
  • Ref ID

και

  • Rate type

Αν η κλήση (json call), που γίνεται για το συγχρονισμό στο σύστημα της HotelAvailabilities, είναι σωστή, το σύστημα της HotelAvailabilities προσθέτει στη λίστα εργασιών που πρέπει να εκτελέσει το αίτημα για update και επιστρέφει στο σύστημά σας τις τιμές UpdateID και Ref ID, τις οποίες πρέπει να χρησιμοποιήσετε σε επόμενη κλήση (γίνεται αυτόματα) πρός το σύστημα της HotelAvailabilities, για να σας απαντήσει αν η ενημέρωση διαθεσιμότητας ήταν επιτυχής ή όχι. 

Το Σύστημα θα απαντήσει είτε με μήνυμα λάθους ή με ενημερωτικό μήνυμα – η ενημέρωση ολοκληρώθηκε με επιτυχία ("status": "success"). 

Οι τιμές που μπορεί να λάβει η τιμή status είναι :

  • success
  • fail
  • pending

Αν η απάντηση είναι success, οι τιμές στις κολόνες UpdateID και Ref ID θα γίνονται null. Οπότε, σε κάθε διαδικασία update, αν ο αλγόριθμός σας βρίσκει τιμές στις κολόνες UpdateID και Ref ID, τότε μπορείτε να επιχειρήσετε εκ νέου call στο Σύστημα της HotelAvailabilities προκειμένου να επιβεβαιώσετε αν η ενημέρωση ήταν επιτυχής . 

Αντίθετα, αν η αρχική κλήση που κάνατε για το συγχρονισμό στο Σύστημα της HotelAvailabilities είναι λάθος, τότε το μήνυμα λάθους αποθηκεύεται στην κολόνα json reply και οι  τιμές UpdateID και Ref ID παραμένουν κενές.

Σε αυτή την περίπτωση αν το Σύστημα προσπαθήσει να εκτελέσει sync ή resync Availability ο αλγόριθμος θα στείλει εκ νέου προς την Hotel Availabilities την κλήση που βρίσκεται στο πεδίο json call.

Scheduled Sync

Στις ενέργειες χρονοπρογραμματισμού, εκτελείται μέσω σχετικής ενέργειας “Synchronize Hotel Availabilities with Galaxy” αυτόματα συγχρονισμός για κρατήσεις και διαθεσιμότητα (όχι για τιμές).

Graphical user interface, text, application</p>
<p>Description automatically generated

Table</p>
<p>Description automatically generated

Graphical user interface, application, Word</p>
<p>Description automatically generated

Graphical user interface, application</p>
<p>Description automatically generated

D:\MyDocs\Galaxy\icons\attention.pngTo API της HotelAvailabilities αναφέρει, ότι έχουν όριο τα 60 requests ανά λεπτό, οπότε σε καμία περίπτωση να ΜΗΝ σεταριστεί schedule sync λιγότερο, από ανά 5 λεπτά (Please note that our API has rate limits. We accept up to 60 requests per minute).