דלגו לתוכן

הוסף את מנהל הערוצים שלך

מדריך זה מלווה מפתחי מנהל ערוצים ו-PMS בתהליך המלא של אינטגרציה עם Wink — מהקמת החשבונות ועד מיפוי המלאי והרצת מבחן מקצה לקצה ראשון.

API של מנהל הערוצים (אינטגרציות) זמין בשתי סביבות. השתמשו בסביבת staging לכל הפיתוח והאישור; עברו לסביבת production רק בעת ההשקה.

סביבהכתובת בסיסית
Productionhttps://integrations.wink.travel
Staginghttps://staging-integrations.wink.travel

API של מנהל הערוצים פועל לפי תקני פרוטוקול OTA (SOAP/XML) להתאמה למערכות אירוח קיימות. התחילו בסקירת תיעוד נקודות הקצה של השותף:

Channel Manager API — נקודות קצה לשותפים

  1. צור חשבון משתמש ב-Wink

    הירשם ב-staging-app.wink.travel. כל השלבים הבאים משתמשים בסביבת staging — תצטרך לחזור על התהליך המלא ב-production לפני ההשקה.

  2. צור חשבון שותף / מנהל ערוצים

    תחת המשתמש החדש שלך, צור חשבון ובחר בסוג החשבון Affiliate / Channel Manager. זהו החשבון שבו האינטגרציה שלך תתבצע.

  3. רשום אפליקציה וקבל את הטוקן הראשון שלך

    צור אפליקציה וקשר אותה לחשבון מנהל הערוצים מהשלב הקודם. בחר ב-MACHINE_2_MACHINE כסוג הלקוח — זוהי אינטגרציה שרת לשרת ללא הפניה למשתמש קצה. העתק את Client ID ו-Secret Key מיד; מפתח הסוד מוצג פעם אחת בלבד ואינו ניתן לשחזור.

    האפליקציה היא זו שמנפיקה את טוקן ההרשאה שכל קריאה במדריך זה נושאת כ-Authorization: Bearer <access_token>. החלף את האישורים שלך בטוקן באמצעות client_credentials מול https://staging-iam.wink.travel/oauth2/token, ובקש את ההרשאות integrations.read integrations.write. עשה זאת לפני שתמשיך — לא תוכל לאתר מזהי חשבון או לגשת לנקודת קצה של מנהל הערוצים ללא טוקן. ראה Authentication לקבלת התהליך המלא, ה-host של ה-production, וקטלוג ההרשאות המלא.

  4. צור חשבון מלון

    תחת אותו משתמש, צור חשבון שני ובחר בסוג החשבון Hotel. זה נותן לך נכס שניתן להשתמש בו למבחנים ללא מעורבות של מלון אמיתי.

  5. אשר ששני החשבונות מאושרים

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

    • Staging — האישור אוטומטי. שני החשבונות זמינים לשימוש מיד עם יצירתם, ואין צורך בבקשה.
    • Production — האישור ידני. שלח למנהל האינטגרציות של Wink את שמות שני החשבונות והמשתמש שלהם, והמתן לאישור לפני שתמשיך.
  6. קשר בין שני החשבונות

    היכנס לחשבון המלון ונווט ל-Channels → Channel manager. בחר את חשבון מנהל הערוצים שלך מהרשימה — זה מקשר את הנכס לאינטגרציה שלך. אם החשבון שלך לא מופיע ברשימה, הוא עדיין לא אושר; ראה שלב 5.

  7. צור סוג חדר בסיסי ותכנית תעריפים

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

  8. מפה ובדוק

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

כל נתיב ב-Channel Manager API מוגבל לחשבון שלך:

/api/managing-entity/{managingEntityIdentifier}/channel-manager/...

{managingEntityIdentifier} הוא מזהה החשבון (UUID) של חשבון מנהל הערוצים שלך — לא של המלון. שלוף אותו, יחד עם מזהה ומצב נוכחי של כל חשבון אחר שבבעלות המשתמש שלך, מ-Platform API:

Terminal window
curl -s -X GET \
"https://staging-api.wink.travel/api/managing-entity/list" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

התשובה היא מערך של החשבונות שבבעלותך:

[
{
"id": "3f1c8e42-7b90-4d55-a1e2-6c8d09b4f731",
"type": "CHANNEL_MANAGER",
"name": "מנהל הערוצים שלך",
"status": "ACTIVE"
},
{
"id": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69",
"type": "HOTEL",
"name": "נכס הבדיקה שלך",
"urlName": "your-test-property",
"status": "ACTIVE"
}
]
  • ה-id של רשומת מנהל הערוצים הוא ה-{managingEntityIdentifier} שלך.
  • ה-id של רשומת ה-HOTEL הוא ה-{propertyIdentifier} שלך.
  • status הוא המקום שבו תאשר שכל חשבון מאושר — שימושי במיוחד ב-production, שבו האישור ידני. ה-מלון חייב לקרוא ACTIVE לפני שניתן להזמין או לראות אותו ב-Channel Manager API. חשבון ה-מנהל ערוצים שלך ימשיך לקרוא PENDING_APPROVAL עד שתעבור Certification; זה צפוי ואינו חוסם פיתוח.

האישור הוא הדרך שבה אתה מוכיח — וכיצד Wink מאשר — שהאינטגרציה שלך ממפה נכון מלאי, דוחפת תעריפים וזמינות, ומקבלת הזמנות מקצה לקצה. הוא מתוכנן להיות שירות עצמי: אתה מנהל כל שלב מהמערכת שלך, ומגיש חבילת ראיות אחת בסוף. Wink בוחנת את החבילה, ובמקרה של מעבר, מקדמת את חשבון ה-Affiliate / Channel Manager שלך מ-PENDING_APPROVAL ל-ACTIVE.

האישור מתבצע כולו בסביבת staging (https://staging-integrations.wink.travel). אין כאן מגע עם ה-production.

  1. אימות. לקוח OAuth2 שלך יכול לקבל טוקן גישה ולהצליח לקרוא את נקודת הקצה /ping מול חשבון ה-Affiliate / Channel Manager שלך.

  2. מיפוי מלאי. תוכל לרשום את המלון/ים המקושרים לחשבונך, לשלוף את התעריף הראשי (סוג חדר × תכנית תעריפים) שהגדרת, ולזהות נכון את ה-masterRateIdentifier שהמערכת שלך תכוון אליו.

  3. דחיפת תעריף וזמינות. תוכל לעדכן כל אחד משבעת ימי שבוע האישור בנפרד — עם שילוב שונה של סכום, כמות, דגלי סגירה בהגעה / עזיבה, ומגבלות משך שהייה מינימלי/מקסימלי בכל יום — ולקרוא בחזרה את הערכים המדויקים מ-Wink.

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

לפני שתתחיל באישור, השלם את השלבים 1–7 של שלבי האינטגרציה כך שיהיו לך:

  • משתמש Wink ב-staging עם חשבון Affiliate / Channel Manager וחשבון Hotel מקושר אליו (Channels → Channel manager). חשבונות staging מאושרים אוטומטית, כך שאין צורך בבקשה.
  • לפחות סוג חדר אחד ותכנית תעריפים אחת שנוצרו בתוך חשבון המלון. פרסם את המלון כך שיהיה ניתן להזמין ב-https://staging-book.wink.travel/hotel/<your-slug>.
  • אפליקציה רשומה תחת חשבון ה-Affiliate / Channel Manager שלך עם Client ID, Secret Key, והרשאות integrations.read integrations.write (ראה Authentication).
  • ה-managingEntityIdentifier של חשבון ה-Affiliate / Channel Manager שלך ו-propertyIdentifier של חשבון המלון שלך (שניהם UUID — ראה מציאת מזהי החשבון שלך).

קונבנציות בקשות נפוצות

Section titled “קונבנציות בקשות נפוצות”

כל בקשה בסעיף זה משתמשת בכותרות הבאות:

Authorization: Bearer <access_token>
Wink-Version: 2.0
Accept: application/json
  • <access_token> מגיע מהענקת client_credentials מול https://staging-iam.wink.travel/oauth2/token — ראה Authentication.
  • כותרת Wink-Version חובה; השמטתה תגרום לכך שהקריאה לא תנותב ל-API JSON בגרסה 2.
  • Content-Type: application/json מתווסף בבקשות PUT שיש להן גוף.

בכל הדוגמאות למטה, המזהים מתאימים לערכים שאספת ב-דרישות מוקדמות:

Placeholderמשמעות
{managingEntityIdentifier}מזהה חשבון ה-Affiliate / Channel Manager שלך (UUID) — ראה מציאת מזהי החשבון שלך.
{propertyIdentifier}מזהה חשבון המלון (נכס) שקישרת לחשבון מנהל הערוצים.
{masterRateIdentifier}התעריף הראשי (שילוב סוג חדר × תכנית תעריפים) שתאשר מולו.
{bookingIdentifier}מזהה ההזמנה מ-staging שהוחזרה ברשימת ההזמנות.

אשר שהאישורים שלך מפנים לחשבון ה-Affiliate / Channel Manager הצפוי.

Terminal window
curl -s -X GET \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/ping" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

תגובה צפויה:

{
"apiVersion": "2.0",
"name": "שם חשבון מנהל הערוצים שלך",
"status": "PENDING_APPROVAL"
}

תגובה 200 עם name תואם היא סימן לכך שהאימות ופתרון החשבון נכונים. status יקרא PENDING_APPROVAL עד ש-Wink יאשר אותך.

שלוף את רשימת המלונות המקושרים לחשבונך ואשר שנכס הבדיקה שלך נמצא ברשימה.

Terminal window
curl -s -X GET \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/list?page=0&size=25" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

התשובה היא Spring Page של רשומות ChannelManagerProperty. אתר את הרשומה שה-identifier שלה תואם ל-{propertyIdentifier} שלך ורשום את currencyCode שלה — תזדקק לו לפרשנות עדכוני התעריף ב-שלב D.

שלב C — שלוף תעריפים ראשיים

Section titled “שלב C — שלוף תעריפים ראשיים”

שלוף את הנכס יחד עם כל התעריפים הראשיים (שילוב סוג חדר × תכנית תעריפים) שהוא מפרסם. בחר את זה שאתה מתכוון לאשר ורשום את ה-identifier שלו כ-{masterRateIdentifier} שלך.

Terminal window
curl -s -X GET \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/{propertyIdentifier}" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

המעטפה בתגובה היא PropertyWithRoomRateList: בלוק property ועוד מערך rooms של רשומות PropertyRoomRate. כל רשומה מציגה את סוג החדר, תכנית התעריפים, מגבלות תפוסה, התעריף הבסיסי, ומודיפיירים של התעריף שתשמור כאשר תדחוף תעריפים יומיים.

שלב D — טען את שבוע האישור

Section titled “שלב D — טען את שבוע האישור”

טען לוח תעריפים לשבעה ימים המכסה את שבעת ימי הלוח הראשונים של החודש הבא לחודש שבו התחלת את האישור. לדוגמה, אם התחלת ב-21 באוגוסט, כוון ל-1 בספטמבר עד 7 בספטמבר.

תשלח שבע קריאות PUT נפרדות — אחת לכל יום — כאשר startDate == endDate. כל יום נושא שילוב שונה במכוון של סכום, כמות, דגלי סגירה בהגעה / עזיבה, ומגבלות משך שהייה כך שכל שדה ניתן לכתיבה ייבדק לפחות פעם אחת. הערכים במטבע הנכס (שנרשם בשלב B); השמטת currencyCode תגרום לברירת מחדל נכונה.

יוםסכוםכמותclosedOnArrivalclosedOnDepartureminLengthOfStaymaxLengthOfStayמה זה מוכיח
1100.005falsefalse130יום בסיס.
2125.004falsefalse114שינוי סכום + כמות + maxLengthOfStay.
3150.003truefalse130הפיכת closedOnArrival.
4175.002falsetrue27הפיכת closedOnDeparture + חלון LOS מחמיר.
5200.000falsefalse130כמות אזלה.
6225.005falsefalse35חלון LOS מגביל.
7250.001falsefalse130זמינות לחדר האחרון.

גוף הבקשה ליום 1 נראה כך. חזור על כך, תוך התאמת startDate / endDate / ערכים לפי הטבלה, לימים 2 עד 7.

Terminal window
curl -s -X PUT \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/{propertyIdentifier}/master-rate/{masterRateIdentifier}" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"startDate": "2026-09-01",
"endDate": "2026-09-01",
"amount": 100.00,
"master": true,
"closedOnArrival": false,
"closedOnDeparture": false,
"quantity": 5,
"minLengthOfStay": 1,
"maxLengthOfStay": 30
}'

כל קריאת PUT מחזירה 200 עם מערך רשומות PropertyRate מעודכנות לטווח ששלחת (רשומה אחת כאשר startDate == endDate). שמור תגובה זו — היא חלק מראיותיך.

שלב E — קרא בחזרה את שבוע האישור

Section titled “שלב E — קרא בחזרה את שבוע האישור”

שלוף את כל השבוע בקריאה אחת ואשר שכל ערכי היום המאוחסנים תואמים לשורה ששלחת בשלב D — כולל דגלי הבוליאן וחלון משך השהייה.

Terminal window
curl -s -X GET \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/{propertyIdentifier}/master-rate/{masterRateIdentifier}?startDate=2026-09-01&endDate=2026-09-07" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

התשובה היא PropertyRoomRateWithRateList. מערך rates שלה חייב להכיל שבע רשומות, אחת לכל יום, כל אחת עם amount, quantity, closedOnArrival, closedOnDeparture, minLengthOfStay, ו-maxLengthOfStay שנטענו. אי התאמה בכל שדה פירושה שהקריאה המתאימה ב-PUT בשלב D לא הצליחה — תקן וודא שוב לפני שתמשיך.

שלב F — בצע הזמנה ניסיונית

Section titled “שלב F — בצע הזמנה ניסיונית”

פתח את הכתובת הבאה בדפדפן, החלף את <your-slug> ב-slug של חשבון המלון שפרסמת בדרישות המוקדמות:

https://staging-book.wink.travel/hotel/<your-slug>

בחר תאריכי הגעה ועזיבה שנמצאים כולו בתוך שבוע האישור שלך, בחר את שילוב סוג החדר + תכנית התעריפים שאישרת, והשלם את ההזמנה. ב-staging משתמשים בנתיב תשלום ניסיוני — לא מחויב כרטיס חי.

כאשר דף האישור מוצג, רשום את קוד ההזמנה (בפורמט WNKxxxxx) שמוצג לאורח.

שלוף את כל ההזמנות שנוצרו לנכס הבדיקה שלך בתוך חלון זמן הכולל את זמן ההזמנה.

Terminal window
curl -s -X GET \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/{propertyIdentifier}/booking/list?startDate=2026-09-01T00:00:00&endDate=2026-09-08T00:00:00" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

מצא את הרשומה שה-bookingCode שלה תואם לקוד שרשמת בשלב F. רשום את ה-bookingIdentifier. לאחר מכן שלוף את ההזמנה היחידה הזו:

Terminal window
curl -s -X GET \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/{propertyIdentifier}/booking/{bookingIdentifier}" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

התשובה היא PropertyBooking. יבא אותה לממשק ה-PMS / מנהל הערוצים שלך ואשר שכל אחד מהפריטים הבאים מוצג כראוי למפעיל:

  • bookingCode, bookingIdentifier, createdDate
  • אורח: firstName, lastName, email
  • totalAmount + currencyCode (הסכום נטו שהמלון מקבל על כל החדרים)
  • paymentMethodType, paymentMethodStatus, salesChannelName
  • כל רשומה ב-roomStays: guestRoomName, ratePlanName, adults, children, startDate, endDate, ו-amount לכל חדר

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

שלב H — בטל את ההזמנה ואמת

Section titled “שלב H — בטל את ההזמנה ואמת”

בקש מצוות Wink לבטל את הזמנת האישור עבורך (או בטל אותה בעצמך מתוך ה-Extranet של חשבון המלון אם יש לך הרשאה). לאחר מכן שלוף שוב את אותה הזמנה עם הקריאה משלב G.

אשר שהתשובה מציגה כעת:

  • cancelled: true
  • חותמת זמן cancelDate מאוכלסת
  • paymentMethodStatus המשקף את מחזור החיים של הביטול (CANCELLED, PARTIALLY_REFUNDED, או FULLY_REFUNDED בהתאם למדיניות ההחזר)

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

שלב I — הגש את חבילת הראיות שלך

Section titled “שלב I — הגש את חבילת הראיות שלך”

ארוז את הדברים הבאים בארכיון יחיד (.zip) בשם wink-cert-<your-channel-manager-name>-<yyyy-mm-dd>.zip:

  1. תמלול API. עבור כל בקשה שביצעת בשלבים A עד H, תעד את בקשת ה-HTTP המלאה (שיטה, URL, כותרות בקשה עם ערך Authorization מוסתר, וגוף JSON בקריאות PUT) ואת תגובת ה-HTTP המלאה (קוד סטטוס, כותרות תגובה, וגוף JSON). סדר את התמלול כך שכל זוג בקשה/תגובה יהיה מתויג בבירור עם השלב אליו הוא שייך (step-a-ping.json, step-d-day-3-put.json, step-g-list-bookings.json וכו’). קבצי .http טקסטואליים או יצוא .har יחיד הם פורמטים מקובלים.

  2. צילום מסך UI: הזמנה פעילה. צילום המסך משלב G המציג את הזמנת האישור בממשק ה-PMS / מנהל הערוצים שלך, עם פרטי האורח, התאריכים, סוג החדר, תכנית התעריפים, והסכום הכולל קריאים בבירור.

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

  4. סיכום האישור. קובץ README.md קצר בתוך הארכיון שמפרט:

    • שם וגרסת מנהל הערוצים / PMS שלך.
    • ה-managingEntityIdentifier, propertyIdentifier, masterRateIdentifier, ו-bookingIdentifier שבהם השתמשת.
    • ה-slug של המלון ב-staging (ה-<your-slug> ב-https://staging-book.wink.travel/hotel/<your-slug>).
    • טווח התאריכים של שבוע האישור (יום 1 → יום 7 בפורמט ISO-8601).
    • שם ודוא”ל של המהנדס שביצע את האישור.

שלח את הארכיון לנציג האינטגרציות של Wink. Wink תבחן, תעקוב אחרי כל אי התאמה, ובמקרה של מעבר — תשנה את סטטוס חשבון ה-Affiliate / Channel Manager שלך מ-PENDING_APPROVAL ל-ACTIVE. האינטגרציה שלך תהיה זכאית לאונבורדינג ב-production.

ניתן להירשם לאירועי webhook של מנהל הערוצים לקבלת התראות בזמן אמת:

  • channel-manager.update.rate — התקבל עדכון תעריף.
  • channel-manager.update.availability — התקבל עדכון זמינות.
  • channel-manager.update — עדכון כללי של מנהל הערוצים.

ראה את קטלוג אירועי ה-Webhook לפרטים.