הוסף את מנהל הערוצים שלך
מדריך זה מלווה מפתחי מנהל ערוצים ו-PMS בתהליך המלא של אינטגרציה עם Wink — מהקמת החשבונות ועד מיפוי המלאי והרצת מבחן מקצה לקצה ראשון.
סביבות
Section titled “סביבות”API של מנהל הערוצים (אינטגרציות) זמין בשתי סביבות. השתמשו בסביבת staging לכל הפיתוח והאישור; עברו לסביבת production רק בעת ההשקה.
| סביבה | כתובת בסיסית |
|---|---|
| Production | https://integrations.wink.travel |
| Staging | https://staging-integrations.wink.travel |
הפניה ל-API
Section titled “הפניה ל-API”API של מנהל הערוצים פועל לפי תקני פרוטוקול OTA (SOAP/XML) להתאמה למערכות אירוח קיימות. התחילו בסקירת תיעוד נקודות הקצה של השותף:
Channel Manager API — נקודות קצה לשותפים
שלבי האינטגרציה
Section titled “שלבי האינטגרציה”-
צור חשבון משתמש ב-Wink
הירשם ב-staging-app.wink.travel. כל השלבים הבאים משתמשים בסביבת staging — תצטרך לחזור על התהליך המלא ב-production לפני ההשקה.
-
צור חשבון שותף / מנהל ערוצים
תחת המשתמש החדש שלך, צור חשבון ובחר בסוג החשבון Affiliate / Channel Manager. זהו החשבון שבו האינטגרציה שלך תתבצע.
-
רשום אפליקציה וקבל את הטוקן הראשון שלך
צור אפליקציה וקשר אותה לחשבון מנהל הערוצים מהשלב הקודם. בחר ב-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, וקטלוג ההרשאות המלא. -
צור חשבון מלון
תחת אותו משתמש, צור חשבון שני ובחר בסוג החשבון Hotel. זה נותן לך נכס שניתן להשתמש בו למבחנים ללא מעורבות של מלון אמיתי.
-
אשר ששני החשבונות מאושרים
אף חשבון לא ניתן לשימוש עד שהוא מאושר: חשבון מנהל ערוצים לא מאושר לא יופיע ברשימת מנהלי הערוצים של אף מלון, ומלון לא מאושר לא יוחזר על ידי ה-API.
- Staging — האישור אוטומטי. שני החשבונות זמינים לשימוש מיד עם יצירתם, ואין צורך בבקשה.
- Production — האישור ידני. שלח למנהל האינטגרציות של Wink את שמות שני החשבונות והמשתמש שלהם, והמתן לאישור לפני שתמשיך.
-
קשר בין שני החשבונות
היכנס לחשבון המלון ונווט ל-Channels → Channel manager. בחר את חשבון מנהל הערוצים שלך מהרשימה — זה מקשר את הנכס לאינטגרציה שלך. אם החשבון שלך לא מופיע ברשימה, הוא עדיין לא אושר; ראה שלב 5.
-
צור סוג חדר בסיסי ותכנית תעריפים
בתוך חשבון המלון, צור לפחות סוג חדר אחד ותכנית תעריפים אחת. אלו דרושים לפני שהאינטגרציה שלך תוכל לדחוף תעריפים וזמינות או למשוך הזמנות.
-
מפה ובדוק
במערכת שלך, מפה את מזהי סוג החדר ותכנית התעריפים שה-API מחזיר. דחוף עדכון תעריף ועדכון זמינות, ואז בצע הזמנה ניסיונית ואמת שהנקודה למשיכת הזמנות מחזירה אותה כראוי.
מציאת מזהי החשבון שלך
Section titled “מציאת מזהי החשבון שלך”כל נתיב ב-Channel Manager API מוגבל לחשבון שלך:
/api/managing-entity/{managingEntityIdentifier}/channel-manager/...{managingEntityIdentifier} הוא מזהה החשבון (UUID) של חשבון מנהל הערוצים שלך — לא של המלון. שלוף אותו, יחד עם מזהה ומצב נוכחי של כל חשבון אחר שבבעלות המשתמש שלך, מ-Platform API:
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.
מה תוכל להוכיח
Section titled “מה תוכל להוכיח”-
אימות. לקוח OAuth2 שלך יכול לקבל טוקן גישה ולהצליח לקרוא את נקודת הקצה
/pingמול חשבון ה-Affiliate / Channel Manager שלך. -
מיפוי מלאי. תוכל לרשום את המלון/ים המקושרים לחשבונך, לשלוף את התעריף הראשי (סוג חדר × תכנית תעריפים) שהגדרת, ולזהות נכון את ה-
masterRateIdentifierשהמערכת שלך תכוון אליו. -
דחיפת תעריף וזמינות. תוכל לעדכן כל אחד משבעת ימי שבוע האישור בנפרד — עם שילוב שונה של סכום, כמות, דגלי סגירה בהגעה / עזיבה, ומגבלות משך שהייה מינימלי/מקסימלי בכל יום — ולקרוא בחזרה את הערכים המדויקים מ-Wink.
-
משיכת הזמנה. תוכל לשלוף הזמנה אמיתית מ-staging שנעשתה נגד נכס הבדיקה שלך, להציג אותה בממשק PMS/CM שלך עם פרטי החדר, האורח והסכום הכולל הנכונים, ואז לשקף ביטול ברגע ש-Wink מסמן את ההזמנה כמבוטלת.
דרישות מוקדמות
Section titled “דרישות מוקדמות”לפני שתתחיל באישור, השלם את השלבים 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.0Accept: 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 שהוחזרה ברשימת ההזמנות. |
שלב A — Ping
Section titled “שלב A — Ping”אשר שהאישורים שלך מפנים לחשבון ה-Affiliate / Channel Manager הצפוי.
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 יאשר אותך.
שלב B — רשום נכסים
Section titled “שלב B — רשום נכסים”שלוף את רשימת המלונות המקושרים לחשבונך ואשר שנכס הבדיקה שלך נמצא ברשימה.
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} שלך.
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 תגרום לברירת מחדל נכונה.
| יום | סכום | כמות | closedOnArrival | closedOnDeparture | minLengthOfStay | maxLengthOfStay | מה זה מוכיח |
|---|---|---|---|---|---|---|---|
| 1 | 100.00 | 5 | false | false | 1 | 30 | יום בסיס. |
| 2 | 125.00 | 4 | false | false | 1 | 14 | שינוי סכום + כמות + maxLengthOfStay. |
| 3 | 150.00 | 3 | true | false | 1 | 30 | הפיכת closedOnArrival. |
| 4 | 175.00 | 2 | false | true | 2 | 7 | הפיכת closedOnDeparture + חלון LOS מחמיר. |
| 5 | 200.00 | 0 | false | false | 1 | 30 | כמות אזלה. |
| 6 | 225.00 | 5 | false | false | 3 | 5 | חלון LOS מגביל. |
| 7 | 250.00 | 1 | false | false | 1 | 30 | זמינות לחדר האחרון. |
גוף הבקשה ליום 1 נראה כך. חזור על כך, תוך התאמת startDate / endDate / ערכים לפי הטבלה, לימים 2 עד 7.
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 — כולל דגלי הבוליאן וחלון משך השהייה.
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) שמוצג לאורח.
שלב G — משוך את ההזמנה
Section titled “שלב G — משוך את ההזמנה”שלוף את כל ההזמנות שנוצרו לנכס הבדיקה שלך בתוך חלון זמן הכולל את זמן ההזמנה.
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. לאחר מכן שלוף את ההזמנה היחידה הזו:
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:
-
תמלול 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יחיד הם פורמטים מקובלים. -
צילום מסך UI: הזמנה פעילה. צילום המסך משלב G המציג את הזמנת האישור בממשק ה-PMS / מנהל הערוצים שלך, עם פרטי האורח, התאריכים, סוג החדר, תכנית התעריפים, והסכום הכולל קריאים בבירור.
-
צילום מסך UI: הזמנה מבוטלת. צילום המסך משלב H המציג את אותה הזמנה בממשק שלך לאחר הביטול, עם הסטטוס המבוטל וחותמת הזמן קריאים בבירור.
-
סיכום האישור. קובץ
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
Section titled “התראות Webhook”ניתן להירשם לאירועי webhook של מנהל הערוצים לקבלת התראות בזמן אמת:
channel-manager.update.rate— התקבל עדכון תעריף.channel-manager.update.availability— התקבל עדכון זמינות.channel-manager.update— עדכון כללי של מנהל הערוצים.
ראה את קטלוג אירועי ה-Webhook לפרטים.
קריאה נוספת
Section titled “קריאה נוספת”- Channel Manager API — תיעוד מלא של נקודות הקצה.
- Channel manager — ניהול ספקי תעריפים ב-Extranet.
- Webhook Events Catalog — כל האירועים שניתן להירשם אליהם.
- Build on Wink — סקירת הפלטפורמה למפתחים.
