Bættu við Channel Manager reikningnum þínum
Þessi leiðarvísir leiðir þróunaraðila Channel Manager og PMS í gegnum alla ferlið við að tengjast Wink — frá því að stofna reikninga þína til að kortleggja birgðir og keyra fyrsta end-to-end prófið þitt.
Umhverfi
Kafli sem heitir „Umhverfi“Channel Manager (Integrations) API er aðgengilegt í tveimur umhverfum. Notaðu staging fyrir alla þróun og vottaferli; skiptu svo yfir í framleiðslu aðeins þegar farið er í loftið.
| Umhverfi | Grunnslóð |
|---|---|
| Framleiðsla | https://integrations.wink.travel |
| Staging | https://staging-integrations.wink.travel |
API tilvísun
Kafli sem heitir „API tilvísun“Channel Manager API fylgir OTA samskiptareglum (SOAP/XML) til samhæfis við núverandi hótelkerfi. Byrjaðu á að skoða skjöl fyrir samstarfsaðila endapunkta:
Channel Manager API — Endapunktar samstarfsaðila
Skref í samþættingu
Kafli sem heitir „Skref í samþættingu“-
Búðu til Wink notendareikning
Skráðu þig á staging-app.wink.travel. Öll skref hér að neðan nota staging — þú munt endurtaka ferlið í framleiðslu áður en farið er í loftið.
-
Búðu til Affiliate / Channel Manager reikning
Undir nýja notandanum þínum, stofnaðu reikning og veldu tegund reikningsins Affiliate / Channel Manager. Þetta er reikningurinn sem samþættingin þín mun auðkenna sig með.
-
Skráðu umsókn og fáðu fyrsta aðgangstáknið
Búðu til Umsókn og tengdu hana við channel manager reikninginn úr skrefi 2. Veldu MACHINE_2_MACHINE sem viðskiptavinategund — þetta er þjónustuframkvæmd milli netþjóna án endanlegs notanda til að beina. Afritaðu Client ID og Secret Key strax; leynilykillinn er sýndur aðeins einu sinni og er ekki hægt að nálgast aftur.
Umsóknin framleiðir aðgangstáknið sem hver símtal í þessari leiðarvísun ber sem
Authorization: Bearer <access_token>. Skiptu um auðkenni fyrir eitt meðclient_credentialsgrantinu gegnhttps://staging-iam.wink.travel/oauth2/token, með beiðni umintegrations.read integrations.writeheimildir. Gerðu þetta áður en þú heldur áfram — þú getur ekki leitað að reikningsauðkennum né náð í neinn Channel Manager endapunkt án tákns. Sjá Auðkenning fyrir fulla ferlið, framleiðsluhýsinn og heildarskrá yfir heimildir. -
Búðu til Hótelreikning
Undir sama notanda, stofnaðu annan reikning og veldu tegund reikningsins Hotel. Þetta gefur þér eign sem þú getur notað til prófana án þess að tengja raunverulegt hótel.
-
Staðfestu að báðir reikningar séu samþykktir
Enginn reikningur er nothæfur fyrr en hann hefur verið samþykktur: ósamþykktur channel manager reikningur birtist ekki í neinni lista hótelsins yfir channel manager reikninga, og ósamþykkt hótel er ekki skilað af API.
- Staging — samþykki er sjálfvirkt. Báðir reikningar eru nothæfir um leið og þeir eru stofnaðir og ekkert þarf að óska eftir.
- Framleiðsla — samþykki er handvirkt. Sendu Wink tengiliðnum þínum fyrir samþættingar nöfn beggja reikninga og notandans sem þeir eru undir, og bíddu eftir staðfestingu áður en þú heldur áfram.
-
Tengdu reikningana tvo
Skráðu þig inn á Hótelreikninginn og farðu í Channels → Channel manager. Veldu channel manager reikninginn þinn úr listanum — þetta tengir eignina við samþættinguna þína. Ef reikningurinn þinn er ekki í listanum hefur hann ekki verið samþykktur enn; sjá skref 5.
-
Búðu til grunnherbergi og verðáætlun
Inni í Hótelreikningnum, búðu til að minnsta kosti eina herbergistegund og eina verðáætlun. Þetta er nauðsynlegt áður en samþættingin þín getur ýtt verðbreytingum og framboði eða sótt bókanir.
-
Kortleggðu og prófaðu
Í þínu eigin kerfi, kortleggðu auðkenni herbergistegundar og verðáætlunar sem API skilar. Ýttu á verðuppfærslu og framboðsuppfærslu, gerðu svo prófbókun og staðfestu að bókunarendapunkturinn skili henni rétt.
Finna reikningsauðkenni þín
Kafli sem heitir „Finna reikningsauðkenni þín“Hver Channel Manager API slóð er bundin við þinn eigin reikning:
/api/managing-entity/{managingEntityIdentifier}/channel-manager/...{managingEntityIdentifier} er reikningsauðkenni (UUID) channel manager reikningsins þíns — ekki
hótelsins. Sækja það, ásamt auðkenni og núverandi stöðu allra annarra reikninga sem notandinn þinn
á, úr 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"Svar er fylki reikninga sem þú átt:
[ { "id": "3f1c8e42-7b90-4d55-a1e2-6c8d09b4f731", "type": "CHANNEL_MANAGER", "name": "Channel Manager reikningurinn þinn", "status": "ACTIVE" }, { "id": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "type": "HOTEL", "name": "Prófunareignin þín", "urlName": "your-test-property", "status": "ACTIVE" }]idfyrir channel manager færsluna er þitt{managingEntityIdentifier}.idfyrirHOTELfærsluna er þitt{propertyIdentifier}.statusstaðfestir að reikningurinn sé samþykktur — mest gagnlegt í framleiðslu þar sem samþykki er handvirkt. Hótelið þarf að veraACTIVEáður en hægt er að bóka eða sjá það í Channel Manager API. Þinn channel manager reikningur les áframPENDING_APPROVALþar til þú hefur staðfest Vottun; það er eðlilegt og hindrar ekki þróun.
Vottun sýnir fram á — og Wink staðfestir — að samþættingin þín kortleggur birgðir rétt, ýtir verð- og framboðsbreytingum og tekur við bókunum end-to-end. Hún er hönnuð til að vera sjálfsafgreiðslulausn: þú keyrir hvert skref úr þínu eigin kerfi og sendir inn eina sönnunarpakka í lokin. Wink fer yfir pakkann og, ef hann er samþykktur, breytir stöðu Affiliate / Channel Manager reikningsins þíns úr PENDING_APPROVAL í ACTIVE.
Vottun fer alfarið fram í staging umhverfinu
(https://staging-integrations.wink.travel). Ekkert í þessum kafla snertir framleiðslu.
Hvað þú munt sanna
Kafli sem heitir „Hvað þú munt sanna“-
Auðkenning. OAuth2 viðskiptavinur þinn getur fengið aðgangstákna og kallað með góðum árangri á
/pingendapunktinn fyrir Affiliate / Channel Manager reikninginn þinn. -
Kortlagning birgða. Þú getur listað hótelin tengd reikningnum þínum, sótt aðalverð (herbergi × verðáætlun) sem þú stilltir og rétt auðkennt
masterRateIdentifiersem kerfið þitt mun beina að. -
Ýta á verð- og framboðsbreytingar. Þú getur uppfært alla sjö daga vottunarviku sjálfstætt — með mismunandi samsetningu af upphæð, magni, lokun við komu / brottför og lágmarks / hámarks dvöl á hverjum degi — og lesið nákvæmlega sömu gildi aftur frá Wink.
-
Sækja bókun. Þú getur sótt raunverulega staging bókun sem gerð var á prófunareign þinni, sýnt hana í þínu eigin PMS/CM viðmóti með réttum herbergisdvöl, gesti og heildarupphæð, og síðan endurspeglað ógildingu þegar Wink merkir bókunina ógilda.
Forsendur
Kafli sem heitir „Forsendur“Áður en þú byrjar vottun, ljúktu skrefum 1–7 í Skrefum samþættingar svo þú hafir:
- Wink notanda í staging með Affiliate / Channel Manager reikning og Hotel reikning tengdan honum (Channels → Channel manager). Staging reikningar eru samþykktir sjálfkrafa, svo ekkert þarf að óska eftir hér.
- Að minnsta kosti eina herbergistegund og eina verðáætlun búna til inni í Hótelreikningnum.
Birta hótelið svo það sé hægt að bóka á
https://staging-book.wink.travel/hotel/<your-slug>. - Skráða umsókn undir Affiliate / Channel Manager reikningnum þínum með Client ID,
Secret Key, og heimildirnar
integrations.read integrations.write(sjá Auðkenning). managingEntityIdentifierfyrir Affiliate / Channel Manager reikninginn þinn ogpropertyIdentifierfyrir Hótelreikninginn þinn (bæði UUID — sjá Finna reikningsauðkenni þín).
Algengar beiðnireglur
Kafli sem heitir „Algengar beiðnireglur“Allar beiðnir í þessum kafla nota eftirfarandi hausar:
Authorization: Bearer <access_token>Wink-Version: 2.0Accept: application/json<access_token>fæst meðclient_credentialsgrantinu gegnhttps://staging-iam.wink.travel/oauth2/token— sjá Auðkenning.- Hausinn
Wink-Versioner nauðsynlegur; ef hann er ekki með mun ekki vísa á v2 JSON API. Content-Type: application/jsoner bætt við íPUTbeiðnum með líkama.
Í öllum dæmum hér að neðan samsvara staðgenglar gildum sem þú safnaðir í Forsendum:
| Staðgengill | Merking |
|---|---|
{managingEntityIdentifier} | Reikningsauðkenni Affiliate / Channel Manager reikningsins þíns (UUID) — sjá Finna reikningsauðkenni þín. |
{propertyIdentifier} | Reikningsauðkenni Hótelsins (eignar) sem þú tengdir við CM reikninginn. |
{masterRateIdentifier} | Aðalverð (herbergi × verðáætlun) sem þú ætlar að votta gegn. |
{bookingIdentifier} | Staging bókunarauðkenni sem skilað er af bókunarlista köllun. |
Skref A — Ping
Kafli sem heitir „Skref A — Ping“Staðfestu að auðkenni þín vísi á Affiliate / Channel Manager reikninginn sem þú býst við.
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ænt svar:
{ "apiVersion": "2.0", "name": "Nafn Channel Manager reikningsins þíns", "status": "PENDING_APPROVAL"}Svar með 200 og rétt name merkir að auðkenning og reikningslausn eru rétt. status mun lesa PENDING_APPROVAL þar til Wink votta þig.
Skref B — Listi yfir eignir
Kafli sem heitir „Skref B — Listi yfir eignir“Sækja síuskráð lista yfir hótel tengd reikningnum þínum og staðfesta að prófunareignin þín sé til staðar.
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"Svar er Spring Page af ChannelManagerProperty færslum. Finndu færsluna þar sem
identifier passar við þitt {propertyIdentifier} og skráðu currencyCode — þú þarft það
til að túlka verðuppfærslur í Skrefi D.
Skref C — Sækja aðalverð
Kafli sem heitir „Skref C — Sækja aðalverð“Sækja eignina ásamt öllum aðalverðum (herbergi × verðáætlun samsetningum) sem hún birtir. Veldu þann sem þú ætlar að votta gegn og skráðu identifier hans sem þitt {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"Svarpakki er PropertyWithRoomRateList: property hluti ásamt rooms fylki af
PropertyRoomRate færslum. Hver færsla sýnir herbergistegund, verðáætlun, hámarksfjölda gesta,
grunnverð og verðbreytur sem þú munt varðveita þegar þú ýtir daglegum verðbreytingum.
Skref D — Hlaða vottunarviku
Kafli sem heitir „Skref D — Hlaða vottunarviku“Hlaða sjö daga verðdagatali sem nær yfir fyrstu sjö dagana í mánuðinum eftir þann mánuð sem þú byrjar vottun. Til dæmis, ef þú byrjar vottun 21. ágúst, miða við 1. til 7. september.
Þú sendir sjö sérhæfðar PUT beiðnir — eina fyrir hvern dag — þar sem startDate == endDate. Hver dagur hefur mismunandi samsetningu af upphæð, magni, lokun við komu / brottför og lágmarks / hámarks dvöl svo að hver skrifanlegur reitur sé prófaður að minnsta kosti einu sinni. Gildi eru í gjaldmiðli eignarinnar (skráð í Skrefi B); slepptu currencyCode og það stillist sjálfkrafa rétt.
| Dagur | Upphæð | Magn | closedOnArrival | closedOnDeparture | minLengthOfStay | maxLengthOfStay | Hvað það sanna |
|---|---|---|---|---|---|---|---|
| 1 | 100.00 | 5 | false | false | 1 | 30 | Grunnur dagur. |
| 2 | 125.00 | 4 | false | false | 1 | 14 | Upphæð + magn + breyting á maxLengthOfStay. |
| 3 | 150.00 | 3 | true | false | 1 | 30 | Breyting á closedOnArrival. |
| 4 | 175.00 | 2 | false | true | 2 | 7 | Breyting á closedOnDeparture + þrengri dvölartími. |
| 5 | 200.00 | 0 | false | false | 1 | 30 | Uppseld magn. |
| 6 | 225.00 | 5 | false | false | 3 | 5 | Takmarkaður dvölartími. |
| 7 | 250.00 | 1 | false | false | 1 | 30 | Síðasta herbergi í boði. |
Beiðnarlíkaminn fyrir Dag 1 lítur svona út. Endurtaktu með því að stilla startDate / endDate / gildi samkvæmt töflunni fyrir daga 2 til 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 }'Hver PUT svarar með 200 og fylki af uppfærðum PropertyRate færslum fyrir þann dag (eina færslu þegar startDate == endDate). Geymdu svarið — það verður hluti af sönnunargögnum þínum.
Skref E — Lesa vottunarvikuna aftur
Kafli sem heitir „Skref E — Lesa vottunarvikuna aftur“Sækja alla vikuna í einni köllun og staðfesta að gildi hvers dags passi við þau sem þú sendir í Skrefi D — þar með talið boolean fánana og dvölartímamörk.
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"Svar er PropertyRoomRateWithRateList. rates fylkið þarf að innihalda sjö færslur, eina fyrir hvern dag, með amount, quantity, closedOnArrival, closedOnDeparture, minLengthOfStay og maxLengthOfStay eins og þú hlaðaðir inn. Ef eitthvað passar ekki þýðir það að samsvarandi PUT í Skrefi D hafi ekki skilað sér rétt — lagaðu það og staðfestu aftur áður en þú heldur áfram.
Skref F — Gerðu prófbókun
Kafli sem heitir „Skref F — Gerðu prófbókun“Opnaðu eftirfarandi slóð í vafra, með því að skipta út <your-slug> fyrir slug Hótelreikningsins sem þú birtir í Forsendum:
https://staging-book.wink.travel/hotel/<your-slug>Veldu komu- og brottfarardagsetningu sem fellur algjörlega innan vottunarvikunnar, veldu herbergistegund + verðáætlun sem þú vottaðir og ljúktu bókuninni. Staging notar prófunargreiðsluleið — engin raunveruleg kort eru rukkuð.
Þegar staðfestingarsíðan birtist, skráðu bókunarkóðann (í formi WNKxxxxx) sem sýndur er gestinum.
Skref G — Sækja bókunina
Kafli sem heitir „Skref G — Sækja bókunina“Sækja allar bókanir gerðar fyrir prófunareignina þína innan tímabils sem nær yfir bókunartímann.
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"Finndu færsluna þar sem bookingCode passar við kóðann sem þú skráðir í Skrefi F. Skráðu bookingIdentifier hennar. Sækja svo þá einstöku bókun:
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"Svar er PropertyBooking. Flyttu það inn í þitt eigið PMS / channel-manager viðmót og staðfestu að eftirfarandi birtist rétt fyrir rekstraraðila:
bookingCode,bookingIdentifier,createdDate- Gestur:
firstName,lastName,email totalAmount+currencyCode(nettu upphæðin sem hótelið fær fyrir öll herbergi)paymentMethodType,paymentMethodStatus,salesChannelName- Hver færsla í
roomStays:guestRoomName,ratePlanName,adults,children,startDate,endDate, ogamountfyrir hvert herbergi
Taktu skjáskot af bókuninni eins og hún birtist í þínu viðmóti — það skjáskot er eitt af nauðsynlegum sönnunargögnum.
Skref H — Hætta við bókun og staðfesta
Kafli sem heitir „Skref H — Hætta við bókun og staðfesta“Biddu Wink teymið um að hætta við vottunar bókunina fyrir þig (eða hættu við sjálfur úr Extranet Hótelreikningsins ef þú hefur leyfi til þess). Sækja svo sömu bókun aftur með kölluninni úr Skrefi G.
Staðfestu að svarið sýni nú:
cancelled: true- Fylla í
cancelDatetímastimpil paymentMethodStatussem endurspeglar ógildingarferlið (CANCELLED,PARTIALLY_REFUNDED, eðaFULLY_REFUNDEDeftir endurgreiðslustefnu)
Flyttu uppfærðu bókunina inn í þitt eigið viðmót og staðfestu að ógildingin sjáist rekstraraðila — staða, tími ógildingar og endurgreiðsluvísir sem viðmótið þitt styður. Taktu annað skjáskot af ógildaðri bókun í þínu viðmóti. Þetta er loka sönnunargagnið.
Skref I — Sendu inn sönnunarpakkann þinn
Kafli sem heitir „Skref I — Sendu inn sönnunarpakkann þinn“Pakkaðu eftirfarandi í eina skráarsafn (.zip) með nafni
wink-cert-<your-channel-manager-name>-<yyyy-mm-dd>.zip:
-
API afrit. Fyrir hverja beiðni sem þú sendir í Skrefum A til H, náðu í fulla HTTP beiðni (aðferð, URL, hausar með
Authorizationgildinu falduðu, og JSON líkama fyrirPUTköll) og fulla HTTP svörun (stöðukóði, hausar og JSON líkama). Skipuleggðu afritið þannig að hver beiðni/svörun pör séu greinilega merkt með skrefi sem þau tilheyra (step-a-ping.json,step-d-day-3-put.json,step-g-list-bookings.json, o.s.frv.). Venjuleg textaskjöl.httpeða eitt.harútflutningsskjal eru bæði viðunandi. -
Skjáskot úr viðmóti: virk bókun. Skjáskot úr Skrefi G sem sýnir vottunar bókunina birtast í þínu eigin PMS / channel-manager viðmóti, með gesti, dagsetningar, herbergistegund, verðáætlun og heildarupphæð skýrt læsileg.
-
Skjáskot úr viðmóti: ógild bókun. Skjáskot úr Skrefi H sem sýnir sömu bókun í þínu viðmóti eftir ógildingu, með ógilda stöðu og tímastimpil skýrt læsileg.
-
Yfirlit vottunar. Stutt
README.mdinni í skjalasafninu sem listar:- Nafn og útgáfu channel manager / PMS.
managingEntityIdentifier,propertyIdentifier,masterRateIdentifier, ogbookingIdentifiersem þú notaðir.- Slug hótelsins í staging (það
<your-slug>íhttps://staging-book.wink.travel/hotel/<your-slug>). - Dagsetningabil vottunarvikunnar (Dagur 1 → Dagur 7 í ISO-8601).
- Nafn og netfang verkfræðingsins sem framkvæmdi vottunina.
Sendu skjalasafnið til Wink tengiliðs þíns fyrir samþættingar. Wink mun fara yfir það, fylgja eftir ef einhverjar ósamræður koma upp, og — ef samþykkt — breyta stöðu Affiliate / Channel Manager reikningsins úr
PENDING_APPROVAL í ACTIVE. Samþættingin þín verður þá gjaldgeng til framleiðslu.
Webhook tilkynningar
Kafli sem heitir „Webhook tilkynningar“Þú getur gerst áskrifandi að webhook atburðum channel manager til að fá tilkynningar í rauntíma:
channel-manager.update.rate— Verðuppfærsla móttekin.channel-manager.update.availability— Framboðsuppfærsla móttekin.channel-manager.update— Almenn uppfærsla channel manager.
Sjá Webhook Events Catalog fyrir nánari upplýsingar.
Frekari lesning
Kafli sem heitir „Frekari lesning“- Channel Manager API — Full skjöl fyrir API endapunkta.
- Channel manager — Stjórnun verðveitenda í Extranet.
- Webhook Events Catalog — Allir áskrifandi atburðir.
- Build on Wink — Yfirlit yfir pallinn fyrir þróunaraðila.
