Skip to content

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.

Channel Manager (Integrations) API yra prieinama dviejose aplinkose. Naudokite staging aplinką visam vystymui ir sertifikavimui; pereikite prie produkcijos tik paleidimo metu.

AplinkaPagrindinis URL
Produkcijahttps://integrations.wink.travel
Staginghttps://staging-integrations.wink.travel

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

  1. Sukurkite Wink vartotojo paskyrą

    Užsiregistruokite adresu staging-app.wink.travel. Visi žemiau pateikti žingsniai atliekami staging aplinkoje — pilną procesą pakartosite produkcijoje prieš paleidimą.

  2. 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.

  3. 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ą naudodami client_credentials grantą adresu https://staging-iam.wink.travel/oauth2/token, prašydami integrations.read integrations.write teisių. 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.

  4. 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.

  5. 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.
  6. 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į.

  7. 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.

  8. 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.

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:

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"

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 id yra jūsų {managingEntityIdentifier}.
  • HOTEL įrašo id yra jūsų {propertyIdentifier}.
  • status leidžia patikrinti, ar paskyra patvirtinta — ypač svarbu produkcijoje, kur patvirtinimas vyksta rankiniu būdu. Viešbutis turi būti ACTIVE, kad būtų galima užsakyti ar matyti per Channel Manager API. Jūsų kanalų valdytojo paskyra rodys PENDING_APPROVAL iki tol, kol praeisite Sertifikavimą; tai normalu ir netrukdo vystymui.

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.

  1. Autentifikacija. Jūsų OAuth2 klientas gali gauti prieigos tokeną ir sėkmingai iškviesti /ping galinį tašką savo Affiliate / Channel Manager paskyrai.

  2. 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.

  3. 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.

  4. 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š 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).
  • managingEntityIdentifier savo Affiliate / Channel Manager paskyrai ir propertyIdentifier viešbučio paskyrai (abu UUID — žr. Kaip rasti savo paskyros identifikatorius).

Visos šio skyriaus užklausos naudoja šiuos antraštes:

Authorization: Bearer <access_token>
Wink-Version: 2.0
Accept: application/json
  • <access_token> gaunamas per client_credentials grantą adresu https://staging-iam.wink.travel/oauth2/token — žr. Authentication.
  • Antraštė Wink-Version yra privaloma; jos praleidimas neleidžia nukreipti į v2 JSON API.
  • Content-Type: application/json pridedama prie PUT užklausų su kūnu.

Toliau pateiktuose pavyzdžiuose vietos laikikliai atitinka reikšmes, kurias surinkote Prieš pradedant:

Vietos laikiklisReikš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.

Patikrinkite, ar jūsų kredencialai atitinka tikėtiną Affiliate / Channel Manager paskyrą.

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"

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.

Gaukite puslapiuotą viešbučių, susietų su jūsų paskyra, sąrašą ir patikrinkite, ar jūsų testinis turtas yra sąraše.

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"

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}.

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"

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.

DienaKainaKiekisclosedOnArrivalclosedOnDepartureminLengthOfStaymaxLengthOfStayKą įrodo
1100.005falsefalse130Bazinė diena.
2125.004falsefalse114Kainos + kiekio + maxLengthOfStay pokytis.
3150.003truefalse130closedOnArrival pakeitimas.
4175.002falsetrue27closedOnDeparture pakeitimas + siauresnis viešnagės langas.
5200.000falsefalse130Išparduotas kiekis.
6225.005falsefalse35Ribotas viešnagės langas.
7250.001falsefalse130Paskutinio kambario prieinamumas.

Žingsnio 1 dienos užklausos pavyzdys atrodo taip. Kartokite, keisdami startDate / endDate / reikšmes pagal lentelę dienoms 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
}'

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ą.

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"

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.

Gaukite visus užsakymus, sukurtus jūsų testiniam turtui per laikotarpį, apimantį užsakymo laiką.

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"

Suraskite įrašą, kurio bookingCode atitinka jūsų užrašytą kodą Žingsnyje F. Užsirašykite jo bookingIdentifier. Tada gaukite tą vieną užsakymą:

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"

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, endDate ir kambario amount

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 cancelDate laiko žymuo
  • paymentMethodStatus, atspindintis atšaukimo būseną (CANCELLED, PARTIALLY_REFUNDED arba FULLY_REFUNDED pagal 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:

  1. API transkriptas. Kiekvienam užklausos žingsniui nuo A iki H užfiksuokite pilną HTTP užklausą (metodą, URL, užklausos antraštes su redaguotu Authorization lauku ir JSON kūną PUT kvietimams) 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.json ir pan.). Priimtini paprasto teksto .http failai arba vienas .har eksportas.

  2. 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.

  3. 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.

  4. Sertifikavimo santrauka. Trumpas README.md faile archyve, kuriame nurodyta:

    • Jūsų kanalų valdytojo / PMS pavadinimas ir versija.
    • Naudoti managingEntityIdentifier, propertyIdentifier, masterRateIdentifier ir bookingIdentifier.
    • 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.

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.