Tovább a tartalomhoz

Add hozzá a Channel Managert

Ez az útmutató végigvezeti a channel manager és PMS fejlesztőket a Wink platformmal való teljes integrációs folyamaton — a fiókok létrehozásától az inventory leképezésén át az első end-to-end teszt lefuttatásáig.

A Channel Manager (Integrations) API két környezetben érhető el. Fejlesztéshez és tanúsításhoz mindig a staging környezetet használd; az éles környezetre csak a go-live előtt válts.

KörnyezetAlap URL
Éleshttps://integrations.wink.travel
Staginghttps://staging-integrations.wink.travel

A Channel Manager API az OTA protokoll szabványokat követi (SOAP/XML), hogy kompatibilis legyen a meglévő vendéglátóipari rendszerekkel. Kezdd a partner végpont dokumentációjának áttekintésével:

Channel Manager API — Partner végpontok

  1. Hozz létre egy Wink felhasználói fiókot

    Regisztrálj a staging-app.wink.travel oldalon. Az alábbi lépések mind a staging környezetet használják — az éles környezetben a go-live előtt megismétled a teljes folyamatot.

  2. Hozd létre az Affiliate / Channel Manager fiókodat

    Az új felhasználód alatt hozz létre egy fiókot, és válaszd az Affiliate / Channel Manager fióktípust. Ez lesz az a fiók, amellyel az integrációd hitelesít.

  3. Regisztrálj egy alkalmazást és hozz létre egy első tokent

    Hozz létre egy Alkalmazást, és kösd hozzá a 2. lépésben létrehozott channel manager fiókhoz. Válaszd a MACHINE_2_MACHINE kliens típust — ez egy szerver-szerver integráció, nincs végfelhasználó átirányítás. Másold ki azonnal a Client ID és Secret Key értékeket; a titkos kulcs csak egyszer jelenik meg, később nem kérhető le újra.

    Az alkalmazás hozza létre a bearer tokent, amelyet minden hívásnál az Authorization: Bearer <access_token> fejlécben kell használni. Cseréld le a hitelesítő adatokat tokenre a client_credentials grant segítségével a https://staging-iam.wink.travel/oauth2/token címen, kérve az integrations.read integrations.write scope-okat. Ezt tedd meg mielőtt tovább lépsz — token nélkül nem tudsz lekérdezni fiókazonosítókat vagy elérni bármilyen Channel Manager végpontot. Lásd Hitelesítés a teljes folyamathoz, az éles hostot és a teljes scope katalógust.

  4. Hozz létre egy Hotel fiókot

    Ugyanazon felhasználó alatt hozz létre egy második fiókot, és válaszd a Hotel fióktípust. Ez egy olyan szálláshelyet ad, amelyet tesztelésre használhatsz anélkül, hogy valódi szállodát érintenél.

  5. Erősítsd meg, hogy mindkét fiók jóváhagyott

    Egyik fiók sem használható, amíg nincs jóváhagyva: egy jóváhagyatlan channel manager fiók nem jelenik meg egyetlen szálloda channel manager listájában sem, és egy jóváhagyatlan szálloda nem jelenik meg az API válaszában.

    • Staging — a jóváhagyás automatikus. Mindkét fiók azonnal használható, amint létrehozod őket, nincs szükség külön kérésre.
    • Éles — a jóváhagyás manuális. Küldd el a Wink integrációs kapcsolattartódnak mindkét fiók nevét és a hozzájuk tartozó felhasználót, majd várd meg a megerősítést a folytatás előtt.
  6. Kapcsold össze a két fiókot

    Jelentkezz be a Hotel fiókba, és navigálj a Csatornák → Channel manager menüpontra. Válaszd ki a channel manager fiókodat a listából — ez összekapcsolja az ingatlant az integrációddal. Ha a fiókod nem szerepel a listában, még nincs jóváhagyva; lásd az 5. lépést.

  7. Hozz létre egy alap szobatípust és árképzési tervet

    A Hotel fiókban hozz létre legalább egy szobatípust és egy árképzési tervet. Ezek szükségesek ahhoz, hogy az integrációd árakat és elérhetőséget tudjon küldeni, illetve foglalásokat tudjon lekérni.

  8. Leképezés és tesztelés

    Saját rendszeredben leképezd az API által visszaadott szobatípus és árképzési terv azonosítókat. Küldj egy árfrissítést és egy elérhetőség frissítést, majd készíts egy teszt foglalást, és ellenőrizd, hogy a foglalás lekérő végpont helyesen adja vissza azt.

Minden Channel Manager API útvonal a saját fiókodhoz van kötve:

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

A {managingEntityIdentifier} a channel manager fiókod azonosítója (UUID) — nem a szállodáé. Szerezd be ezt, valamint a felhasználód által birtokolt többi fiók azonosítóját és aktuális státuszát a Platform API-ból:

Terminál
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"

A válasz egy tömb a birtokolt fiókokról:

[
{
"id": "3f1c8e42-7b90-4d55-a1e2-6c8d09b4f731",
"type": "CHANNEL_MANAGER",
"name": "A Channel Managered neve",
"status": "ACTIVE"
},
{
"id": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69",
"type": "HOTEL",
"name": "A teszt szálláshelyed",
"urlName": "a-teszt-szallashelyed",
"status": "ACTIVE"
}
]
  • A channel manager bejegyzés id értéke a {managingEntityIdentifier}.
  • A HOTEL bejegyzés id értéke a {propertyIdentifier}.
  • A status mutatja, hogy a fiók jóváhagyott-e — ez különösen fontos az éles környezetben, ahol a jóváhagyás manuális. A szálloda csak akkor foglalható vagy jelenik meg az API-ban, ha ACTIVE státuszú. A channel manager fiók PENDING_APPROVAL státuszt mutat a Tanúsítás elvégzéséig; ez normális és nem akadályozza a fejlesztést.

A tanúsítás bizonyítja — és Wink is megerősíti —, hogy az integrációd helyesen leképezi az inventoryt, küldi az árakat és elérhetőséget, valamint fogadja a foglalásokat end-to-end. Ez egy önkiszolgáló folyamat: minden lépést a saját rendszeredből vezérelsz, és a végén egyetlen bizonyítékcsomagot nyújtasz be. Wink átnézi a csomagot, és ha megfeleltél, az Affiliate / Channel Manager fiókodat PENDING_APPROVAL státuszról ACTIVE státuszra állítja.

A tanúsítás teljes egészében a staging környezetben zajlik (https://staging-integrations.wink.travel). Ez a szakasz nem érinti az éles környezetet.

  1. Hitelesítés. Az OAuth2 kliensed képes hozzáférési tokent szerezni, és sikeresen hívja a /ping végpontot az Affiliate / Channel Manager fiókod alatt.

  2. Inventory leképezés. Ki tudod listázni a fiókodhoz kapcsolt szállodákat, lekérni a konfigurált master árat (szobatípus × árképzési terv), és helyesen azonosítani a masterRateIdentifier értéket, amelyet a rendszered célozni fog.

  3. Ár és elérhetőség küldése. Képes vagy a tanúsítási hét mind a hét napját külön-külön frissíteni — eltérő összegek, mennyiségek, érkezéskor/távozáskor zárás jelzők, valamint minimum/maximum tartózkodási idő korlátozások kombinációjával —, majd a Wink-től visszaolvasni a pontos értékeket.

  4. Foglalás lekérése. Le tudsz kérni egy valós staging foglalást a teszt szálláshelyedre, meg tudod jeleníteni a saját PMS/CM felületedben a helyes szobatartózkodással, vendéggel és összeggel, majd vissza tudod tükrözni a foglalás törlését, amikor Wink azt töröltként jelöli.

A tanúsítás megkezdése előtt végezd el az Integráció lépései 1–7 pontjait, hogy rendelkezz:

  • Egy Wink felhasználóval a staging környezetben, amelyhez tartozik egy Affiliate / Channel Manager és egy Hotel fiók (Csatornák → Channel manager). A staging fiókok automatikusan jóváhagyottak, így nincs szükség külön kérésre.
  • Legalább egy szobatípus és egy árképzési terv létrehozva a Hotel fiókban. Tedd közzé a szállodát, hogy foglalható legyen a https://staging-book.wink.travel/hotel/<a-te-slugod> címen.
  • Egy regisztrált alkalmazás az Affiliate / Channel Manager fiókod alatt, amely rendelkezik Client ID, Secret Key értékekkel és az integrations.read integrations.write scope-okkal (lásd Hitelesítés).
  • Az Affiliate / Channel Manager fiókod managingEntityIdentifier és a Hotel fiókod propertyIdentifier (mindkettő UUID — lásd Fiókazonosítók megtalálása).

Ebben a szakaszban minden kérés a következő fejléceket használja:

Authorization: Bearer <access_token>
Wink-Version: 2.0
Accept: application/json
  • A <access_token> a client_credentials grantból származik a https://staging-iam.wink.travel/oauth2/token címen — lásd Hitelesítés.
  • A Wink-Version fejléc kötelező; enélkül nem a v2 JSON API-hoz irányít.
  • A Content-Type: application/json fejléc hozzáadódik a PUT kérésekhez, amelyek törzset tartalmaznak.

Az alábbi példákban a helyőrzők az Előfeltételek szakaszban összegyűjtött értékekre utalnak:

HelyőrzőJelentés
{managingEntityIdentifier}Az Affiliate / Channel Manager fiókod azonosítója (UUID) — lásd Fiókazonosítók megtalálása.
{propertyIdentifier}A Hotel fiók (ingatlan) azonosítója, amelyet összekapcsoltál a CM fiókkal.
{masterRateIdentifier}A master ár (szobatípus × árképzési terv), amelyet tanúsítani fogsz.
{bookingIdentifier}A staging foglalás azonosítója, amelyet a foglalás lista hívás adott vissza.

Ellenőrizd, hogy a hitelesítő adataid az elvárt Affiliate / Channel Manager fiókra mutatnak.

Terminál
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"

Várt válasz:

{
"apiVersion": "2.0",
"name": "A Channel Manager fiókod neve",
"status": "PENDING_APPROVAL"
}

Egy 200 válasz a megfelelő name értékkel jelzi, hogy a hitelesítés és a fiókazonosítás helyes. A status PENDING_APPROVAL lesz, amíg Wink nem tanúsít.

Lekérdezd a fiókodhoz kapcsolt szállodák lapozott listáját, és ellenőrizd, hogy a teszt szálláshelyed szerepel benne.

Terminál
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"

A válasz egy Spring Page típusú ChannelManagerProperty bejegyzésekből álló lista. Keresd meg azt a bejegyzést, amelynek identifier értéke megegyezik a {propertyIdentifier}-rel, és jegyezd fel a currencyCode értékét — erre szükséged lesz az árfrissítések értelmezéséhez a D lépésben.

Lekérdezd az ingatlant és az összes master árat (szobatípus × árképzési terv kombinációt), amelyet közzétesz. Válaszd ki azt, amelyet tanúsítani szeretnél, és jegyezd fel az identifier értékét, ez lesz a {masterRateIdentifier}.

Terminál
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"

A válasz egy PropertyWithRoomRateList objektum: egy property blokk és egy rooms tömb PropertyRoomRate bejegyzésekkel. Minden bejegyzés tartalmazza a szobatípust, árképzési tervet, foglaltsági korlátokat, alapárat és azokat az ár módosítókat, amelyeket meg kell őrizned a napi árak küldésekor.

D lépés — Tanúsítási hét betöltése

Szekció neve “D lépés — Tanúsítási hét betöltése”

Tölts be egy hét napos ár naptárt, amely a tanúsítás megkezdését követő hónap első hét napját fedi le. Például, ha augusztus 21-én kezded a tanúsítást, célozd meg szeptember 1-től szeptember 7-ig.

Hét különálló PUT hívást küldesz — egyet naponta — ahol startDate == endDate. Minden nap más-más kombinációban tartalmaz összeget, mennyiséget, érkezéskor/távozáskor zárás jelzőket, valamint minimum/maximum tartózkodási idő korlátokat, hogy minden írható mező legalább egyszer tesztelve legyen. Az értékek az ingatlan pénznemében vannak (a B lépésben feljegyzett); ha kihagyod a currencyCode-ot, az alapértelmezett helyesen beállítódik.

NapÖsszegMennyiségclosedOnArrivalclosedOnDepartureminLengthOfStaymaxLengthOfStayMit bizonyít
1100.005falsefalse130Alapnap.
2125.004falsefalse114Összeg + mennyiség + maxLengthOfStay változás.
3150.003truefalse130closedOnArrival váltás.
4175.002falsetrue27closedOnDeparture váltás + szűkebb tartózkodási idő.
5200.000falsefalse130Kifogyott mennyiség.
6225.005falsefalse35Korlátozó tartózkodási idő.
7250.001falsefalse130Utolsó szoba elérhetőség.

Az 1. nap kérés törzse így néz ki. Ismételd meg a többi napra, módosítva a startDate / endDate / értékeket a táblázat szerint.

Terminál
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
}'

Minden PUT kérés 200 választ ad a frissített PropertyRate bejegyzések tömbjével a megadott időszakra (egy bejegyzés, ha startDate == endDate). Ezt a választ mentsd el — a bizonyítékcsomagod része lesz.

E lépés — Tanúsítási hét visszaolvasása

Szekció neve “E lépés — Tanúsítási hét visszaolvasása”

Egyetlen hívással kérd le az egész hetet, és ellenőrizd, hogy minden nap tárolt értékei megegyeznek a D lépésben küldött sorral — beleértve a logikai jelzőket és a tartózkodási idő korlátokat is.

Terminál
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"

A válasz egy PropertyRoomRateWithRateList. A rates tömbnek hét bejegyzést kell tartalmaznia, naponta egyet, mindegyik a megfelelő amount, quantity, closedOnArrival, closedOnDeparture, minLengthOfStay és maxLengthOfStay értékekkel. Ha bármelyik mező nem egyezik, a D lépésben küldött PUT nem sikerült megfelelően — javítsd és ellenőrizd újra, mielőtt tovább lépsz.

F lépés — Teszt foglalás készítése

Szekció neve “F lépés — Teszt foglalás készítése”

Nyisd meg a következő URL-t böngészőben, a <your-slug> helyére írd be a Prerequisites szakaszban publikált Hotel fiók slugját:

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

Válassz érkezési és távozási dátumot, amelyek teljes egészében a tanúsítási héten belül vannak, válaszd ki a tanúsított szobatípus + árképzési terv kombinációt, és fejezd be a foglalást. A staging környezet teszt fizetési útvonalat használ — nem terhel valódi kártyát.

Amikor megjelenik a visszaigazoló oldal, jegyezd fel a vendégnek megjelenő foglalási kódot (formátum: WNKxxxxx).

Lekérdezd az összes foglalást a teszt szálláshelyedre egy olyan időablakban, amely lefedi a foglalás időbélyegét.

Terminál
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"

Keresd meg azt a bejegyzést, amelynek bookingCode értéke megegyezik a F lépésben feljegyzett kóddal. Jegyezd fel a bookingIdentifier értékét. Ezután kérd le azt az egy foglalást:

Terminál
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"

A válasz egy PropertyBooking. Importáld be a saját PMS / channel manager felületedbe, és ellenőrizd, hogy az alábbi adatok helyesen jelennek meg az operátor számára:

  • bookingCode, bookingIdentifier, createdDate
  • Vendég: firstName, lastName, email
  • totalAmount + currencyCode (a szálloda által az összes szobára kapott nettó összeg)
  • paymentMethodType, paymentMethodStatus, salesChannelName
  • Minden bejegyzés a roomStays tömbben: guestRoomName, ratePlanName, adults, children, startDate, endDate, és szobánként az amount

Készíts képernyőképet a foglalásról, ahogy a saját felületedben megjelenik — ez az egyik szükséges bizonyíték.

H lépés — Foglalás törlése és ellenőrzése

Szekció neve “H lépés — Foglalás törlése és ellenőrzése”

Kérd meg a Wink csapatot, hogy töröljék a tanúsítási foglalást a nevedben (vagy ha van jogosultságod, töröld magad a Hotel fiók Extranetjéből). Ezután kérd le újra ugyanazt a foglalást a G lépésben használt hívással.

Ellenőrizd, hogy a válasz most tartalmazza:

  • cancelled: true
  • Kitöltött cancelDate időbélyegzőt
  • Egy paymentMethodStatus értéket, amely tükrözi a törlés állapotát (CANCELLED, PARTIALLY_REFUNDED vagy FULLY_REFUNDED a visszatérítési szabályzat szerint)

Importáld be az frissített foglalást a saját felületedre, és ellenőrizd, hogy a törlés látható az operátor számára — státusz, törlés időbélyegző és bármilyen visszatérítési jelző, amelyet a UI támogat. Készíts egy második képernyőképet a törölt foglalásról a felületedben. Ez a végső bizonyíték.

I lépés — Bizonyítékcsomag benyújtása

Szekció neve “I lépés — Bizonyítékcsomag benyújtása”

Csomagold be az alábbiakat egyetlen archívumba (.zip), amelynek neve legyen wink-cert-<a-channel-manager-neved>-<yyyy-mm-dd>.zip:

  1. API átirat. Minden A–H lépésben kiadott kérésről készíts teljes HTTP átiratot (módszer, URL, kérés fejlécek az Authorization érték eltakarásával, és a PUT kérések JSON törzse), valamint a teljes HTTP választ (állapotkód, válasz fejlécek és JSON törzs). Strukturáld az átiratot úgy, hogy minden kérés/válasz pár egyértelműen meg legyen jelölve a lépéssel (step-a-ping.json, step-d-day-3-put.json, step-g-list-bookings.json stb.). Elfogadott formátumok a sima szöveges .http fájlok vagy egyetlen .har export.

  2. UI képernyőkép: aktív foglalás. A G lépésben készült képernyőkép, amely a tanúsítási foglalást mutatja a saját PMS / channel manager UI-ban, jól olvasható vendég, dátumok, szobatípus, árképzési terv és összeg adatokkal.

  3. UI képernyőkép: törölt foglalás. A H lépésben készült képernyőkép, amely ugyanazt a foglalást mutatja a UI-ban törlés után, jól olvasható törölt státusszal és időbélyeggel.

  4. Tanúsítási összefoglaló. Egy rövid README.md a csomagban, amely tartalmazza:

    • A channel manager / PMS neved és verziószámod.
    • A használt managingEntityIdentifier, propertyIdentifier, masterRateIdentifier és bookingIdentifier értékeket.
    • A staging szálloda slugját (a <your-slug> a https://staging-book.wink.travel/hotel/<your-slug> URL-ben).
    • A tanúsítási hét dátumtartományát (1. nap → 7. nap ISO-8601 formátumban).
    • A tanúsítást végző mérnök nevét és email címét.

Küldd el az archívumot a Wink integrációs kapcsolattartódnak. Wink átnézi, egyeztet az esetleges eltérésekről, és ha megfeleltél, az Affiliate / Channel Manager fiókod státuszát PENDING_APPROVAL-ról ACTIVE-re állítja. Ezután az integrációd jogosult az éles környezetbe való beléptetésre.

Feliratkozhatsz channel manager webhook eseményekre, hogy valós idejű értesítéseket kapj:

  • channel-manager.update.rate — Árfrissítés érkezett.
  • channel-manager.update.availability — Elérhetőség frissítés érkezett.
  • channel-manager.update — Általános channel manager frissítés.

Részletekért lásd a Webhook Események Katalógusát.