API κρατήσεων ξενοδοχείων και πτήσεων: ένα ταξίδι, δύο κρατήσεις

Το ticket γράφει: "προσθήκη ξενοδοχείων στη ροή πτήσεων, ένα checkout, ένα σύνολο". Είναι λογικό αίτημα από έναν product manager και ακούγεται σαν δουλειά μιας μέρας, αφού έχετε ήδη αναζήτηση πτήσεων και ήδη σελίδα πληρωμής. Τρεις εβδομάδες μετά, η ομάδα διαφωνεί για το τι πρέπει να γίνει όταν η αεροπορική επιβεβαιώνει και το ξενοδοχείο όχι. Ένα API κρατήσεων ξενοδοχείων και πτήσεων δεν είναι μία ενοποίηση με δύο είδη αποτελέσματος. Είναι δύο ενοποιήσεις που μοιράζονται ένα καλάθι.
Όσο νωρίτερα το παραδεχτεί ο κώδικας, τόσο λιγότερος θα ξαναγραφτεί. Ακολουθεί το κομμάτι που οι οδηγοί ενοποίησης παραλείπουν: σε τι διαφέρουν τα δύο μισά, ποιο δεσμεύετε πρώτο και τι πρέπει να είναι ένα ταξίδι στο μοντέλο δεδομένων σας.
Τα δύο μισά δεν συμπεριφέρονται ίδια
Και τα δύο επιστρέφουν ως JSON με μια τιμή και έναν κωδικό αναφοράς, οπότε στο δίκτυο μοιάζουν. Δεν μοιάζουν σε όσα σας υπόσχονται όταν έχετε πια τον κωδικό.
| Ερώτηση | Πτήση | Ξενοδοχείο |
|---|---|---|
| Τι κρατάτε μετά την κράτηση | Μια κράτηση (PNR) που δεν είναι ακόμη εισιτήριο | Μια επιβεβαίωση που συνήθως είναι ήδη αυτό που πουλήσατε |
| Πόσο ισχύει η τιμή | Μέχρι να επανατιμολογηθεί ο ναύλος στην κράτηση, και μπορεί να διαφέρει από την αναζήτηση | Μέχρι να λήξει η τιμή, και μια τιμή μπορεί να αλλάξει ανάμεσα στη διαθεσιμότητα και την κράτηση |
| Τι την επιβεβαιώνει | Η έκδοση εισιτηρίου, συχνά με προθεσμία | Η επιβεβαίωση του προμηθευτή, άλλοτε άμεση, άλλοτε σε εκκρεμότητα |
| Πώς αναιρείται | Void αν προλάβετε νωρίς, αλλιώς επιστροφή χρημάτων βάσει κανόνων ναύλου, συχνά με ποινή | Ακύρωση βάσει της πολιτικής της ίδιας της τιμής, σε πολλές τιμές δωρεάν μέχρι μια προθεσμία |
| Τι αλλάζει το ποσό αργά | Ναύλος, φόροι, μερικές φορές το νόμισμα του ναύλου | Φόροι και τέλη πληρωτέα στο κατάλυμα, η βάση διατροφής, το δωμάτιο που τελικά δίνεται |
Μπορεί να διαφωνείτε με μια γραμμή, αφού οι προμηθευτές διαφέρουν, όχι όμως με το σχήμα: το ένα μισό έχει βήμα έκδοσης και το άλλο παράθυρο ακύρωσης, και δεν συμπίπτουν χρονικά. Την πλευρά της πτήσης την καλύψαμε στο ενοποίηση API κρατήσεων πτήσεων και το πρόβλημα του αργού προμηθευτή στην πλευρά του ξενοδοχείου στο σχεδιασμός client για API διαθεσιμότητας ξενοδοχείων. Αυτό το κείμενο ξεκινά εκεί που εκείνα τελειώνουν: στη σύνδεση.
Ποιο κλείνετε πρώτο;
Κανείς δεν σας λέει ότι αυτό είναι απόφαση σχεδιασμού, και είναι εκείνη που ορίζει το κόστος μιας αποτυχίας.
Ας πούμε ότι ένας πελάτης αγοράζει πτήση και ξενοδοχείο για τις ίδιες ημερομηνίες. Στέλνετε τη μία κράτηση και μετά την άλλη. Τρία πράγματα μπορούν να συμβούν: πετυχαίνουν και οι δύο, ή αποτυγχάνει η μία, ή αποτυγχάνει η μία αφού η άλλη έχει ήδη πετύχει. Το πρώτο είναι μια καλή μέρα. Τα άλλα δύο ορίζουν την ουρά υποστήριξής σας.
Αν εκδώσετε πρώτα την πτήση και μετά το ξενοδοχείο αρνηθεί, έχετε πελάτη με θέση για μια πόλη και χωρίς δωμάτιο, ήδη χρεωμένο, και επιστροφή χρημάτων σε εισιτήριο με ποινή. Αν κλείσετε πρώτα το ξενοδοχείο και μετά αποτύχει η πτήση, κρατάτε ένα δωμάτιο που συχνά ακυρώνεται δωρεάν, οπότε η διόρθωση είναι φθηνή. Υπάρχει και ο αντίστροφος κίνδυνος, αφού μια μη επιστρέψιμη τιμή ξενοδοχείου είναι το χειρότερο πράγμα για να κρατάτε, οπότε διαβάστε τους όρους ακύρωσης της τιμής πριν την αφήσετε να πάει πρώτη.
Είναι εμπειρικός κανόνας, όχι νόμος, και το ζητούμενο είναι να διαλέξετε τη σειρά συνειδητά. Δεσμεύστε το μισό που αναιρείται ευκολότερα πριν από το δυσκολότερο, ελέγξτε την τιμή και των δύο ακριβώς πριν δεσμευτεί οποιοδήποτε και γράψτε τι κάνετε σε καθένα από τα τρία αποτελέσματα. Οι reviewers σπάνια ρωτούν. Οι πελάτες πάντα το μαθαίνουν.
Ένα ταξίδι, δύο κρατήσεις
Το σχήμα που αντέχει είναι μια εγγραφή ταξιδιού που κατέχει δύο κρατήσεις, καθεμία με δικό της κωδικό, δική της κατάσταση και δικούς της όρους. Ο πελάτης βλέπει ένα σύνολο. Η βάση σας βλέπει δύο γραμμές, και το σύνολο είναι άθροισμα που υπολογίζετε, όχι κάτι που υπάρχει στον προμηθευτή.
Κρατήστε τις δύο καταστάσεις χωριστά. Το "επιβεβαιωμένο" για το ξενοδοχείο και το "εκδομένο" για την πτήση δεν είναι η ίδια κατάσταση, και μια μοναδική στήλη κατάστασης που τις ισοπεδώνει θα γράψει κάποια στιγμή "κρατήθηκε" πάνω σε ένα μισοκρατημένο ταξίδι.
Κρατήστε χωριστά και τα δύο σύνολα όρων αλλαγής, και δείξτε τα. Ένα εμφανιζόμενο σύνολο κρύβει ότι η αλλαγή ημερομηνιών είναι δωρεάν στο ένα μισό και κοστίζει στο άλλο. Αν το front-end σας δείχνει το "αλλαγή ημερομηνιών" ως ένα κουμπί, αποφασίστε τι κάνει όταν μόνο το ένα μισό μπορεί να μετακινηθεί, πριν το ανακαλύψει ένας πελάτης για λογαριασμό σας. Το ίδιο ισχύει για το markup: αν το βάζετε ανά υπηρεσία, όπως οι περισσότεροι πωλητές, το σύνολο του ταξιδιού είναι δύο markup, και μια επιστροφή στο ένα μισό πρέπει να ξέρει ποιο markup επιστρέφει. Τα χρήματα είναι το σημείο όπου ένα συνδυασμένο ταξίδι ακριβαίνει, γιατί οι γραμμές εκκαθαρίζονται σε διαφορετικά χρονοδιαγράμματα, και η επιστροφή μιας πτήσης δεν φτάνει όταν φτάνει η ακύρωση του ξενοδοχείου.
Πού βρίσκεται αυτή η πλατφόρμα
Ευθέως: η πλατφόρμα εκθέτει API πτήσεων και ξενοδοχείων, και η πρόσβαση ξεκινά με μια συζήτηση, όχι με κλειδί αυτοεξυπηρέτησης. Οι υπηρεσίες ενεργοποιούνται ανά tenant, οπότε ένας tenant που πουλά ξενοδοχεία και όχι εκδρομές δεν κουβαλά την επιφάνεια των εκδρομών. Τίποτα εδώ δεν υπόσχεται μία κλήση που κλείνει ατομικά και τα δύο μισά, και δεν πρέπει να σχεδιάσετε σαν να το υπόσχεται. Χειριστείτε τα ως τις δύο κρατήσεις που είναι, κάτω από ένα ταξίδι που σας ανήκει.
Αν θέλετε να δείτε τις πραγματικές κλήσεις και τους όρους πριν χτίσετε πάνω τους, ξεκινήστε από τη σελίδα των travel API και φέρτε τη σειρά με την οποία σκοπεύετε να κλείνετε. Αν ακόμη αποφασίζετε τι σας δίνει η δωρεάν πρόσβαση, το δωρεάν API κρατήσεων ξενοδοχείων εξηγεί τα είδη του δωρεάν.
Τι κοστίζει το λάθος
Η ακριβή εκδοχή είναι η αθόρυβη. Ένας πελάτης έχει εισιτήριο για μια πόλη και το δωμάτιο έχει χαθεί, και το πρώτο που μαθαίνετε είναι ένα μήνυμα τη νύχτα, από ένα αεροδρόμιο. Φθηνότερα αλλά υπαρκτά: ένα checkout που δείχνει ένα καθησυχαστικό σύνολο και μετά, ύστερα από έλεγχο τιμής, ένα δεύτερο ποσό που ο πελάτης δεν δέχτηκε· μια επιστροφή που επιστρέφει την πτήση και ξεχνά το ξενοδοχείο· και μια κατάσταση που λέει "κρατήθηκε" ενώ ο προμηθευτής λέει άλλο.
Τίποτα από αυτά δεν θέλει έξυπνη λύση. Θέλει το ταξίδι να είναι πραγματικό αντικείμενο, η σειρά να είναι απόφαση που κάποιος έγραψε, και τον επανέλεγχο και των δύο τιμών την τελευταία στιγμή πριν δεσμευτεί οποιαδήποτε. Χτίστε το μία φορά και το checkout μπορεί να φαίνεται τόσο απλό όσο ζήτησε το ticket.