Pridėkite savo kanalų valdytoją
Šis vadovas padeda kanalų valdytojų ir PMS kūrėjams pereiti visą integracijos su Wink procesą — nuo paskyrų kūrimo iki inventoriaus susiejimo ir pirmojo pilno testavimo.
Aplinkos
Section titled “Aplinkos”Channel Manager (Integrations) API yra prieinama dviejose aplinkose. Naudokite staging aplinką visam vystymui ir sertifikavimui; pereikite prie produkcijos tik paleidimo metu.
| Aplinka | Pagrindinis URL |
|---|---|
| Produkcija | https://integrations.wink.travel |
| Staging | https://staging-integrations.wink.travel |
API nuoroda
Section titled “API nuoroda”Channel Manager API laikosi OTA protokolo standartų (SOAP/XML), kad būtų suderinama su esamomis svetingumo sistemomis. Pradėkite nuo partnerių galinių taškų dokumentacijos peržiūros:
Channel Manager API — Partnerių galiniai taškai
Integracijos žingsniai
Section titled “Integracijos žingsniai”-
Sukurkite Wink vartotojo paskyrą
Užsiregistruokite adresu staging-app.wink.travel. Visi žemiau pateikti žingsniai atliekami staging aplinkoje — pilną procesą pakartosite produkcijoje prieš paleidimą.
-
Sukurkite savo filialo / kanalų valdytojo paskyrą
Naujo vartotojo paskyroje sukurkite paskyrą ir pasirinkite Affiliate / Channel Manager paskyros tipą. Ši paskyra bus naudojama jūsų integracijos autentifikacijai.
-
Užregistruokite programą ir gaukite pirmąjį tokeną
Sukurkite Programą ir susiekite ją su kanalų valdytojo paskyra iš 2 žingsnio. Pasirinkite MACHINE_2_MACHINE kaip kliento tipą — tai serverio-serverio integracija be galutinio vartotojo nukreipimo. Nedelsdami nukopijuokite Client ID ir Secret Key; slapto rakto rodymas vyksta tik vieną kartą ir jo negalima atgauti.
Programa generuoja bearer tokeną, kurį kiekvienas šio vadovo kvietimas perduoda kaip
Authorization: Bearer <access_token>. Pasikeiskite savo kredencialus į tokeną naudodamiclient_credentialsgrantą adresuhttps://staging-iam.wink.travel/oauth2/token, prašydamiintegrations.read integrations.writeteisių. Atlikite tai prieš tęsdami — be tokeno negalėsite gauti paskyros identifikatorių ar pasiekti Channel Manager galinių taškų. Žr. Authentication pilnam procesui, produkcijos hostui ir teisų katalogui. -
Sukurkite viešbučio paskyrą
Toje pačioje vartotojo paskyroje sukurkite antrą paskyrą ir pasirinkite Hotel paskyros tipą. Tai suteikia jums nekilnojamą turtą testavimui be tikro viešbučio įtraukimo.
-
Patvirtinkite abi paskyras
Nei viena paskyra negali būti naudojama, kol nėra patvirtinta: nepatvirtinta kanalų valdytojo paskyra nebus matoma jokio viešbučio kanalų valdytojų sąraše, o nepatvirtintas viešbutis nebus grąžinamas per API.
- Staging — patvirtinimas automatinis. Abi paskyros yra naudojamos iš karto po sukūrimo, nereikia prašyti patvirtinimo.
- Produkcija — patvirtinimas rankinis. Atsiųskite Wink integracijų kontaktui abiejų paskyrų pavadinimus ir vartotoją, po to laukite patvirtinimo prieš tęsdami.
-
Sujunkite abi paskyras
Prisijunkite prie viešbučio paskyros ir eikite į Channels → Channel manager. Pasirinkite savo kanalų valdytojo paskyrą iš sąrašo — tai susies turtą su jūsų integracija. Jei paskyros nėra sąraše, ji dar nepatvirtinta; žr. 5 žingsnį.
-
Sukurkite pagrindinį kambario tipą ir kainų planą
Viešbučio paskyroje sukurkite bent vieną kambario tipą ir vieną kainų planą. Tai būtina, kad integracija galėtų siųsti kainas ir prieinamumą arba gauti užsakymus.
-
Susiekite ir testuokite
Savo sistemoje susiekite kambario tipo ir kainų plano identifikatorius, kuriuos grąžina API. Siųskite kainų ir prieinamumo atnaujinimus, atlikite testinį užsakymą ir patikrinkite, ar užsakymo gavimo galinis taškas jį teisingai grąžina.
Kaip rasti savo paskyros identifikatorius
Section titled “Kaip rasti savo paskyros identifikatorius”Kiekvienas Channel Manager API kelias yra susietas su jūsų paskyra:
/api/managing-entity/{managingEntityIdentifier}/channel-manager/...{managingEntityIdentifier} yra jūsų kanalų valdytojo paskyros ID (UUID) — ne viešbučio. Gaukite jį kartu su kitų jūsų vartotojo paskyrų ID ir dabartine būsena iš 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"Atsakymas yra masyvas su jūsų paskyromis:
[ { "id": "3f1c8e42-7b90-4d55-a1e2-6c8d09b4f731", "type": "CHANNEL_MANAGER", "name": "Jūsų Kanalų Valdytojas", "status": "ACTIVE" }, { "id": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "type": "HOTEL", "name": "Jūsų Testo Turtas", "urlName": "jusu-testo-turtas", "status": "ACTIVE" }]- Kanalų valdytojo įrašo
idyra jūsų{managingEntityIdentifier}. HOTELįrašoidyra jūsų{propertyIdentifier}.statusleidžia patikrinti, ar paskyra patvirtinta — ypač svarbu produkcijoje, kur patvirtinimas vyksta rankiniu būdu. Viešbutis turi būtiACTIVE, kad būtų galima užsakyti ar matyti per Channel Manager API. Jūsų kanalų valdytojo paskyra rodysPENDING_APPROVALiki tol, kol praeisite Sertifikavimą; tai normalu ir netrukdo vystymui.
Sertifikavimas
Section titled “Sertifikavimas”Sertifikavimas įrodo — ir Wink patvirtina — kad jūsų integracija teisingai susieja inventorių, siunčia kainas ir prieinamumą bei gauna užsakymus pilnu ciklu. Tai savitarninė procedūra: jūs valdote kiekvieną žingsnį savo sistemoje ir pateikiate vieną įrodymų paketą pabaigoje. Wink peržiūri paketą ir, jei viskas gerai, pakeičia jūsų Affiliate / Channel Manager paskyros statusą iš PENDING_APPROVAL į ACTIVE.
Sertifikavimas vyksta tik staging aplinkoje
(https://staging-integrations.wink.travel). Šiame skyriuje niekas nesusiję su produkcija.
Ką įrodysite
Section titled “Ką įrodysite”-
Autentifikacija. Jūsų OAuth2 klientas gali gauti prieigos tokeną ir sėkmingai iškviesti
/pinggalinį tašką savo Affiliate / Channel Manager paskyrai. -
Inventoriaus susiejimas. Galite išvardinti viešbučius, susietus su jūsų paskyra, gauti pagrindinę kainą (kambario tipas × kainų planas), kurią sukonfigūravote, ir teisingai identifikuoti
masterRateIdentifier, į kurį nukreips jūsų sistema. -
Kainų ir prieinamumo siuntimas. Galite atnaujinti visų septynių sertifikavimo savaitės dienų duomenis atskirai — skirtingas kainos, kiekio, uždarymo atvykimo/išvykimo metu žymėjimų ir minimalios/maksimalios viešnagės trukmės derinys kiekvienai dienai — ir perskaityti tikslias reikšmes iš Wink.
-
Užsakymų gavimas. Galite gauti tikrą staging užsakymą, atliktą jūsų testiniam turtui, parodyti jį savo PMS/CM sąsajoje su teisingu kambario laikotarpiu, svečiu ir suma, o po to atspindėti atšaukimą, kai Wink pažymi užsakymą kaip atšauktą.
Prieš pradedant
Section titled “Prieš pradedant”Prieš pradėdami sertifikavimą, atlikite 1–7 žingsnius iš Integracijos žingsnių, kad turėtumėte:
- Wink vartotoją staging aplinkoje su Affiliate / Channel Manager paskyra ir su ja susieta Hotel paskyra (Channels → Channel manager). Staging paskyros patvirtinamos automatiškai, todėl nereikia prašyti.
- Bent vieną kambario tipą ir vieną kainų planą sukurtą viešbučio paskyroje. Viešbutį paskelbkite, kad jis būtų užsakomas adresu
https://staging-book.wink.travel/hotel/<jusu-slug>. - Užregistruotą programą savo Affiliate / Channel Manager paskyroje su Client ID, Secret Key ir teisėmis
integrations.read integrations.write(žr. Authentication). managingEntityIdentifiersavo Affiliate / Channel Manager paskyrai irpropertyIdentifierviešbučio paskyrai (abu UUID — žr. Kaip rasti savo paskyros identifikatorius).
Dažniausios užklausų konvencijos
Section titled “Dažniausios užklausų konvencijos”Visos šio skyriaus užklausos naudoja šiuos antraštes:
Authorization: Bearer <access_token>Wink-Version: 2.0Accept: application/json<access_token>gaunamas perclient_credentialsgrantą adresuhttps://staging-iam.wink.travel/oauth2/token— žr. Authentication.- Antraštė
Wink-Versionyra privaloma; jos praleidimas neleidžia nukreipti į v2 JSON API. Content-Type: application/jsonpridedama priePUTužklausų su kūnu.
Toliau pateiktuose pavyzdžiuose vietos laikikliai atitinka reikšmes, kurias surinkote Prieš pradedant:
| Vietos laikiklis | Reikšmė |
|---|---|
{managingEntityIdentifier} | Jūsų Affiliate / Channel Manager paskyros ID (UUID) — žr. Kaip rasti savo paskyros identifikatorius. |
{propertyIdentifier} | Viešbučio paskyros (turto) ID, susieta su CM paskyra. |
{masterRateIdentifier} | Pagrindinė kaina (kambario tipas × kainų planas), kurią sertifikuosite. |
{bookingIdentifier} | Staging užsakymo ID, gautas iš užsakymų sąrašo kvietimo. |
Žingsnis A — Ping
Section titled “Žingsnis A — Ping”Patikrinkite, ar jūsų kredencialai atitinka tikėtiną Affiliate / Channel Manager paskyrą.
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"Tikėtinas atsakymas:
{ "apiVersion": "2.0", "name": "Jūsų Kanalų Valdytojo Paskyros Pavadinimas", "status": "PENDING_APPROVAL"}200 atsakymas su atitinkančiu name rodo, kad autentifikacija ir paskyros nustatymas yra teisingi. status rodys PENDING_APPROVAL iki Wink sertifikavimo.
Žingsnis B — Viešbučių sąrašas
Section titled “Žingsnis B — Viešbučių sąrašas”Gaukite puslapiuotą viešbučių, susietų su jūsų paskyra, sąrašą ir patikrinkite, ar jūsų testinis turtas yra sąraše.
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"Atsakymas yra Spring Page su ChannelManagerProperty įrašais. Suraskite įrašą, kurio identifier atitinka jūsų {propertyIdentifier}, ir užsirašykite jo currencyCode — jo reikės kainų atnaujinimų interpretavimui Žingsnyje D.
Žingsnis C — Gaukite pagrindines kainas
Section titled “Žingsnis C — Gaukite pagrindines kainas”Gaukite turtą kartu su visomis pagrindinėmis kainomis (kambario tipas × kainų planas), kurias jis skelbia. Pasirinkite tą, kurią ketinate sertifikuoti, ir užsirašykite jos identifier kaip savo {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"Atsakymas yra PropertyWithRoomRateList: property blokas ir rooms masyvas su PropertyRoomRate įrašais. Kiekvienas įrašas rodo kambario tipą, kainų planą, užimtumo ribas, bazinę kainą ir kainų modifikatorius, kuriuos išsaugosite siųsdami dienos kainas.
Žingsnis D — Užpildykite sertifikavimo savaitę
Section titled “Žingsnis D — Užpildykite sertifikavimo savaitę”Užpildykite septynių dienų kainų kalendorių, apimantį pirmąsias septynias kalendorines dienas po mėnesio, kuriame pradedate sertifikavimą. Pavyzdžiui, jei pradedate 2026 m. rugpjūčio 21 d., taikykite nuo 2026 m. rugsėjo 1 d. iki rugsėjo 7 d.
Siųsite septynis atskirus PUT kvietimus — po vieną kiekvienai dienai, kur startDate == endDate. Kiekviena diena turi skirtingą kainos, kiekio, uždarymo atvykimo/išvykimo metu žymėjimų ir minimalios/maksimalios viešnagės trukmės derinį, kad būtų išbandyti visi rašomi laukai. Reikšmės yra turto valiuta (užfiksuota Žingsnyje B); praleiskite currencyCode, ir jis bus nustatytas teisingai.
| Diena | Kaina | Kiekis | closedOnArrival | closedOnDeparture | minLengthOfStay | maxLengthOfStay | Ką įrodo |
|---|---|---|---|---|---|---|---|
| 1 | 100.00 | 5 | false | false | 1 | 30 | Bazinė diena. |
| 2 | 125.00 | 4 | false | false | 1 | 14 | Kainos + kiekio + maxLengthOfStay pokytis. |
| 3 | 150.00 | 3 | true | false | 1 | 30 | closedOnArrival pakeitimas. |
| 4 | 175.00 | 2 | false | true | 2 | 7 | closedOnDeparture pakeitimas + siauresnis viešnagės langas. |
| 5 | 200.00 | 0 | false | false | 1 | 30 | Išparduotas kiekis. |
| 6 | 225.00 | 5 | false | false | 3 | 5 | Ribotas viešnagės langas. |
| 7 | 250.00 | 1 | false | false | 1 | 30 | Paskutinio kambario prieinamumas. |
Žingsnio 1 dienos užklausos pavyzdys atrodo taip. Kartokite, keisdami startDate / endDate / reikšmes pagal lentelę dienoms 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 }'Kiekvienas PUT atsako 200 su atnaujintų PropertyRate įrašų masyvu už nurodytą intervalą (vienas įrašas, kai startDate == endDate). Išsaugokite šį atsakymą — jis bus jūsų įrodymų dalis.
Žingsnis E — Perskaitykite sertifikavimo savaitę
Section titled “Žingsnis E — Perskaitykite sertifikavimo savaitę”Gaukite visą savaitę vienu kvietimu ir patikrinkite, ar kiekvienos dienos saugomos reikšmės atitinka tas, kurias siuntėte Žingsnyje D — įskaitant loginės reikšmes ir viešnagės langą.
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"Atsakymas yra PropertyRoomRateWithRateList. Jo rates masyve turi būti septyni įrašai, po vieną kiekvienai dienai, su amount, quantity, closedOnArrival, closedOnDeparture, minLengthOfStay ir maxLengthOfStay, kuriuos įkėlėte. Bet koks neatitikimas reiškia, kad atitinkamas PUT Žingsnyje D nebuvo įvykdytas teisingai — ištaisykite ir patikrinkite dar kartą prieš tęsdami.
Žingsnis F — Atlikite testinį užsakymą
Section titled “Žingsnis F — Atlikite testinį užsakymą”Atidarykite šį URL naršyklėje, pakeisdami <your-slug> į viešbučio paskyros slugą, kurį paskelbėte Prieš pradedant:
https://staging-book.wink.travel/hotel/<your-slug>Pasirinkite atvykimo ir išvykimo datas, kurios visiškai patenka į sertifikavimo savaitę, pasirinkite sertifikuotą kambario tipą + kainų planą ir užbaikite užsakymą. Staging naudoja testinį mokėjimo kelią — kortelė nėra apmokestinama.
Kai pasirodys patvirtinimo puslapis, užsirašykite užsakymo kodą (formatu WNKxxxxx), parodytą svečiui.
Žingsnis G — Gaukite užsakymą
Section titled “Žingsnis G — Gaukite užsakymą”Gaukite visus užsakymus, sukurtus jūsų testiniam turtui per laikotarpį, apimantį užsakymo laiką.
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"Suraskite įrašą, kurio bookingCode atitinka jūsų užrašytą kodą Žingsnyje F. Užsirašykite jo bookingIdentifier. Tada gaukite tą vieną užsakymą:
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"Atsakymas yra PropertyBooking. Importuokite jį į savo PMS / kanalų valdytojo sąsają ir patikrinkite, ar operatoriui teisingai rodomi šie duomenys:
bookingCode,bookingIdentifier,createdDate- Svečio duomenys:
firstName,lastName,email totalAmount+currencyCode(grynoji suma, kurią viešbutis gauna už visus kambarius)paymentMethodType,paymentMethodStatus,salesChannelName- Kiekvienas įrašas
roomStays:guestRoomName,ratePlanName,adults,children,startDate,endDateir kambarioamount
Padarykite ekrano kopiją, kaip užsakymas atrodo jūsų sąsajoje — ši ekrano kopija yra viena iš reikalingų įrodymų.
Žingsnis H — Atšaukite užsakymą ir patikrinkite
Section titled “Žingsnis H — Atšaukite užsakymą ir patikrinkite”Paprašykite Wink komandos atšaukti sertifikavimo užsakymą jūsų vardu (arba atšaukite patys viešbučio paskyros Extranet, jei turite teisę). Tada dar kartą gaukite tą patį užsakymą su Žingsnio G kvietimu.
Patikrinkite, ar atsakyme dabar yra:
cancelled: true- Užpildytas
cancelDatelaiko žymuo paymentMethodStatus, atspindintis atšaukimo būseną (CANCELLED,PARTIALLY_REFUNDEDarbaFULLY_REFUNDEDpagal grąžinimo politiką)
Importuokite atnaujintą užsakymą į savo sąsają ir patikrinkite, ar operatoriui matomas atšaukimas — būsena, atšaukimo laiko žymuo ir bet koks jūsų UI palaikomas grąžinimo indikatorius. Padarykite antrą ekrano kopiją su atšauktu užsakymu. Tai paskutinis įrodymų artefaktas.
Žingsnis I — Pateikite savo įrodymų paketą
Section titled “Žingsnis I — Pateikite savo įrodymų paketą”Supakuokite šiuos failus į vieną archyvą (.zip), pavadintą
wink-cert-<jusu-kanalu-valdytojo-pavadinimas>-<yyyy-mm-dd>.zip:
-
API transkriptas. Kiekvienam užklausos žingsniui nuo A iki H užfiksuokite pilną HTTP užklausą (metodą, URL, užklausos antraštes su redaguotu
Authorizationlauku ir JSON kūnąPUTkvietimams) ir pilną HTTP atsakymą (statuso kodą, atsakymo antraštes ir JSON kūną). Struktūruokite transkriptą taip, kad kiekvienas užklausos/atsakymo pora būtų aiškiai pažymėta priklausomai nuo žingsnio (step-a-ping.json,step-d-day-3-put.json,step-g-list-bookings.jsonir pan.). Priimtini paprasto teksto.httpfailai arba vienas.hareksportas. -
UI ekrano kopija: aktyvus užsakymas. Ekrano kopija iš Žingsnio G, kurioje matomas sertifikavimo užsakymas jūsų PMS / kanalų valdytojo UI, aiškiai matomi svečias, datos, kambario tipas, kainų planas ir suma.
-
UI ekrano kopija: atšauktas užsakymas. Ekrano kopija iš Žingsnio H, kurioje matomas tas pats užsakymas jūsų UI po atšaukimo, aiškiai matoma atšaukimo būsena ir laiko žymuo.
-
Sertifikavimo santrauka. Trumpas
README.mdfaile archyve, kuriame nurodyta:- Jūsų kanalų valdytojo / PMS pavadinimas ir versija.
- Naudoti
managingEntityIdentifier,propertyIdentifier,masterRateIdentifierirbookingIdentifier. - Staging viešbučio slugas (tas
<your-slug>https://staging-book.wink.travel/hotel/<your-slug>URL). - Sertifikavimo savaitės datos intervalas (Diena 1 → Diena 7 ISO-8601 formatu).
- Inžinieriaus vardas ir el. paštas, kuris vykdė sertifikavimą.
Išsiųskite archyvą savo Wink integracijų kontaktui. Wink peržiūrės, susisieks dėl neatitikimų ir — jei viskas gerai — pakeis jūsų Affiliate / Channel Manager paskyros statusą iš PENDING_APPROVAL į ACTIVE. Tada jūsų integracija bus tinkama produkcijos paleidimui.
Webhook pranešimai
Section titled “Webhook pranešimai”Galite užsiprenumeruoti kanalų valdytojo webhook įvykius, kad gautumėte realaus laiko pranešimus:
channel-manager.update.rate— gautas kainos atnaujinimas.channel-manager.update.availability— gautas prieinamumo atnaujinimas.channel-manager.update— bendras kanalų valdytojo atnaujinimas.
Daugiau informacijos žr. Webhook Events Catalog.
Tolimesnė literatūra
Section titled “Tolimesnė literatūra”- Channel Manager API — Pilna API galinių taškų dokumentacija.
- Channel manager — Kainų tiekėjų valdymas Extranet aplinkoje.
- Webhook Events Catalog — Visi prenumeruojami įvykiai.
- Build on Wink — Platformos apžvalga kūrėjams.
