דילוג לתוכן
בלוג

API להזמנת מלונות וטיסות: טיול אחד, שתי הזמנות

מערכת Tekravel
נכתב בסיוע בינה מלאכותית

בכרטיס כתוב "להוסיף מלונות לזרימת הטיסות, קופה אחת, סכום אחד". זו בקשה סבירה ממנהל מוצר, והיא נשמעת כמו עבודה של יום, כי כבר יש לכם חיפוש טיסות וכבר יש לכם דף תשלום. שלושה שבועות אחר כך הצוות מתווכח מה אמור לקרות כשחברת התעופה אישרה והמלון לא. API להזמנת מלונות וטיסות אינו אינטגרציה אחת עם שני סוגי תוצאות. הוא שתי אינטגרציות שחולקות סל.

ככל שהקוד מודה בזה מוקדם יותר, כך פחות ממנו נכתב מחדש. להלן החלק שמדריכי האינטגרציה מדלגים עליו: במה שני החצאים שונים, איזה מהם לבצע קודם, ומה צריך להיות טיול במודל הנתונים שלכם.

שני החצאים אינם מתנהגים אותו דבר

שניהם חוזרים כ-JSON עם מחיר ומספר אסמכתה, ולכן נראים דומים על הקו. הם אינם דומים במה שהם מבטיחים לכם אחרי שיש בידיכם האסמכתה.

שאלהטיסהמלון
מה מחזיקים אחרי ההזמנהשריון (PNR) שעדיין אינו כרטיסאישור שבדרך כלל כבר הוא מה שמכרתם
כמה זמן המחיר תקףעד שהתעריף מתומחר מחדש בהזמנה, ויכול להיות שונה מהחיפושעד שהתעריף פג, והוא יכול להשתנות בין בדיקת הזמינות להזמנה
מה מאשרהנפקת כרטיס, לרוב מול מגבלת זמןאישור הספק, לפעמים מיידי ולפעמים ממתין
איך מבטליםvoid אם נתפס מוקדם, אחרת החזר לפי כללי התעריף, לעתים עם קנסביטול לפי מדיניות התעריף עצמו, וברבים מהתעריפים חינם עד מועד חיתוך
מה משנה את הסכום מאוחרתעריף, מסים, לפעמים מטבע התעריףמסים ועמלות שמשולמים במקום, בסיס הארוחות, החדר שהוקצה בפועל

אפשר לחלוק על שורה, כי הספקים שונים, אבל לא על צורתה: לחצי אחד יש שלב הנפקה ולשני חלון ביטול, והם אינם מסתדרים בזמן. את צד הטיסה של הרצף סקרנו באינטגרציית API להזמנת טיסות ואת בעיית הספק האיטי בצד המלון בתכנון לקוח API לזמינות מלונות. הכתבה הזו מתחילה היכן שהן נגמרות, בחיבור.

איזה מהם מזמינים קודם?

איש לא אומר לכם שזו החלטת תכנון, והיא זו שקובעת כמה תעלה תקלה.

נניח שלקוח קונה טיסה ומלון לאותם תאריכים. אתם שולחים הזמנה אחת ואחר כך את השנייה. שלושה דברים יכולים לקרות: שתיהן מצליחות, אחת נכשלת, או אחת נכשלת אחרי שהשנייה הצליחה. הראשון הוא יום טוב. שני האחרים קובעים את תור התמיכה שלכם.

אם מנפיקים קודם כרטיס טיסה והמלון מסרב אחר כך, יש לכם לקוח עם מושב לעיר ובלי חדר, שכבר חויב, והחזר על כרטיס שיש עליו קנס. אם מזמינים קודם את המלון והטיסה נכשלת אחר כך, אתם מחזיקים חדר שלעתים קרובות אפשר לבטל בחינם, ולכן התיקון זול. גם הסיכון ההפוך אמיתי, כי תעריף מלון שאי אפשר לבטל הוא הדבר הגרוע ביותר להחזיק, ולכן קראו את תנאי הביטול של התעריף לפני שאתם נותנים לו לצאת ראשון.

זה כלל אצבע ולא חוק, והעיקר שתבחרו את הסדר במכוון. בצעו קודם את החצי שקל יותר לבטל, לפני החצי הקשה יותר, בדקו את המחיר בשניהם רגע לפני שאחד מהם מתחייב, וכתבו מה עושים בכל אחת משלוש התוצאות. סוקרים כמעט לא שואלים. לקוחות תמיד מגלים.

טיול אחד, שתי הזמנות

המבנה שמחזיק הוא רשומת טיול שמחזיקה שתי הזמנות, לכל אחת אסמכתה, סטטוס ותנאים משלה. הלקוח רואה סכום אחד. מסד הנתונים שלכם רואה שתי שורות, והסכום הוא חיבור שאתם מחשבים, לא דבר שקיים אצל הספק.

שמרו על שני הסטטוסים בנפרד. "מאושר" למלון ו"הונפק" לטיסה אינם אותו מצב, ועמודת סטטוס אחת שמשטיחה אותם תכתוב במוקדם או במאוחר "הוזמן" על טיול שהוזמן חצי.

שמרו בנפרד גם את תנאי השינוי, והציגו אותם. סכום מוצג מסתיר שהזזת תאריכים היא עריכה חינם בחצי אחד ועמלה בשני. אם בצד הלקוח "שנה תאריכים" מוצג ככפתור אחד, החליטו מה הוא עושה כשרק חצי אחד יכול לזוז, לפני שלקוח יגלה זאת במקומכם. כך גם עם התוספת שלכם: אם אתם מוסיפים אותה לפי שירות, כמו רוב המוכרים, סכום הטיול הוא שתי תוספות, וההחזר על חצי אחד צריך לדעת איזו תוספת הוא מחזיר. כסף הוא המקום שבו טיול משולב נעשה יקר, כי השורות מסתיימות בלוחות זמנים שונים, וההחזר על הטיסה לא מגיע כשביטול המלון מגיע.

איפה הפלטפורמה ממוקמת

בפשטות: הפלטפורמה חושפת API לטיסות ולמלונות, והגישה מתחילה בשיחה ולא במפתח בשירות עצמי. השירותים מופעלים לכל דייר בנפרד, ולכן דייר שמוכר מלונות ולא סיורים אינו נושא את משטח הסיורים. אין כאן הבטחה לקריאה אחת שמזמינה את שני החצאים באופן אטומי, ואין לתכנן כאילו יש. התייחסו אליהם כאל שתי ההזמנות שהם, תחת טיול שאתם הבעלים שלו.

אם אתם רוצים לראות את הקריאות והתנאים בפועל לפני שבונים סביבם, התחילו מעמוד ה-API לנסיעות והביאו את הסדר שבו אתם מתכוונים להזמין. אם אתם עדיין מחליטים מה מקבלים בגישה חינמית, API חינמי להזמנת מלונות מפרט את סוגי החינם.

מה עולה טעות

הגרסה היקרה היא השקטה. לקוח קיבל כרטיס לעיר והחדר נעלם, והידיעה הראשונה שלכם היא הודעה בלילה, משדה תעופה. זול יותר אך עדיין אמיתי: קופה שמציגה סכום מרגיע אחד ואחרי בדיקת מחיר מספר שני שהלקוח לא הסכים לו; החזר שמחזיר את הטיסה ושוכח את המלון; וסטטוס שאומר "הוזמן" בזמן שהספק אומר אחרת.

שום דבר מזה לא דורש תיקון ממולח. זה דורש שהטיול יהיה אובייקט אמיתי, שהסדר יהיה החלטה שמישהו רשם, ושני המחירים ייבדקו מחדש ברגע האחרון לפני שאחד מהם מתחייב. בנו זאת פעם אחת והקופה תוכל להיראות פשוטה כפי שהכרטיס ביקש.

מערכת Tekravel

דסק טכנולוגיות תיירות

דסק טכנולוגיות התיירות של Tekravel כותב לאנשי הענף: בעלי סוכנויות, קונסולידטורים והמפתחים שמחברים אליהם מערכות. כל כתבה נבדקת מול הפלטפורמה שהיא מתארת לפני הפרסום.