Stökkva að meginefni

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.

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

UmhverfiGrunnslóð
Framleiðslahttps://integrations.wink.travel
Staginghttps://staging-integrations.wink.travel

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

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

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

  3. 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_credentials grantinu gegn https://staging-iam.wink.travel/oauth2/token, með beiðni um integrations.read integrations.write heimildir. 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.

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

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

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

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

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:

Útstöðvargluggi
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"
}
]
  • id fyrir channel manager færsluna er þitt {managingEntityIdentifier}.
  • id fyrir HOTEL færsluna er þitt {propertyIdentifier}.
  • status staðfestir að reikningurinn sé samþykktur — mest gagnlegt í framleiðslu þar sem samþykki er handvirkt. Hótelið þarf að vera ACTIVE áður en hægt er að bóka eða sjá það í Channel Manager API. Þinn channel manager reikningur les áfram PENDING_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.

  1. Auðkenning. OAuth2 viðskiptavinur þinn getur fengið aðgangstákna og kallað með góðum árangri á /ping endapunktinn fyrir Affiliate / Channel Manager reikninginn þinn.

  2. Kortlagning birgða. Þú getur listað hótelin tengd reikningnum þínum, sótt aðalverð (herbergi × verðáætlun) sem þú stilltir og rétt auðkennt masterRateIdentifier sem kerfið þitt mun beina að.

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

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

Áð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).
  • managingEntityIdentifier fyrir Affiliate / Channel Manager reikninginn þinn og propertyIdentifier fyrir Hótelreikninginn þinn (bæði UUID — sjá Finna reikningsauðkenni þín).

Allar beiðnir í þessum kafla nota eftirfarandi hausar:

Authorization: Bearer <access_token>
Wink-Version: 2.0
Accept: application/json
  • <access_token> fæst með client_credentials grantinu gegn https://staging-iam.wink.travel/oauth2/token — sjá Auðkenning.
  • Hausinn Wink-Version er nauðsynlegur; ef hann er ekki með mun ekki vísa á v2 JSON API.
  • Content-Type: application/json er bætt við í PUT beiðnum með líkama.

Í öllum dæmum hér að neðan samsvara staðgenglar gildum sem þú safnaðir í Forsendum:

StaðgengillMerking
{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.

Staðfestu að auðkenni þín vísi á Affiliate / Channel Manager reikninginn sem þú býst við.

Útstöðvargluggi
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.

Sækja síuskráð lista yfir hótel tengd reikningnum þínum og staðfesta að prófunareignin þín sé til staðar.

Útstöðvargluggi
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.

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

Útstöðvargluggi
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.

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.

DagurUpphæðMagnclosedOnArrivalclosedOnDepartureminLengthOfStaymaxLengthOfStayHvað það sanna
1100.005falsefalse130Grunnur dagur.
2125.004falsefalse114Upphæð + magn + breyting á maxLengthOfStay.
3150.003truefalse130Breyting á closedOnArrival.
4175.002falsetrue27Breyting á closedOnDeparture + þrengri dvölartími.
5200.000falsefalse130Uppseld magn.
6225.005falsefalse35Takmarkaður dvölartími.
7250.001falsefalse130Síð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.

Útstöðvargluggi
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.

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.

Útstöðvargluggi
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.

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.

Sækja allar bókanir gerðar fyrir prófunareignina þína innan tímabils sem nær yfir bókunartímann.

Útstöðvargluggi
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:

Útstöðvargluggi
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, og amount fyrir 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.

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 í cancelDate tímastimpil
  • paymentMethodStatus sem endurspeglar ógildingarferlið (CANCELLED, PARTIALLY_REFUNDED, eða FULLY_REFUNDED eftir 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ð.

Pakkaðu eftirfarandi í eina skráarsafn (.zip) með nafni wink-cert-<your-channel-manager-name>-<yyyy-mm-dd>.zip:

  1. API afrit. Fyrir hverja beiðni sem þú sendir í Skrefum A til H, náðu í fulla HTTP beiðni (aðferð, URL, hausar með Authorization gildinu falduðu, og JSON líkama fyrir PUT kö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 .http eða eitt .har útflutningsskjal eru bæði viðunandi.

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

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

  4. Yfirlit vottunar. Stutt README.md inni í skjalasafninu sem listar:

    • Nafn og útgáfu channel manager / PMS.
    • managingEntityIdentifier, propertyIdentifier, masterRateIdentifier, og bookingIdentifier sem þú 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.

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