Dodajte svoj Channel Manager
Ta vodič vodi razvijalce channel managerjev in PMS-ov skozi celoten proces integracije z Wink — od ustvarjanja računov do preslikave inventarja in izvajanja prvega celovitega testa.
Okolja
Section titled “Okolja”Channel Manager (Integrations) API je na voljo v dveh okoljih. Za ves razvoj in certificiranje uporabljajte staging; na produkcijo preklopite šele ob zagonu v živo.
| Okolje | Osnovni URL |
|---|---|
| Produkcija | https://integrations.wink.travel |
| Staging | https://staging-integrations.wink.travel |
API referenca
Section titled “API referenca”Channel Manager API sledi standardom OTA protokola (SOAP/XML) za združljivost z obstoječimi gostinskimi sistemi. Začnite z ogledom dokumentacije partner endpointov:
Channel Manager API — Partner endpointi
Koraki integracije
Section titled “Koraki integracije”-
Ustvarite Wink uporabniški račun
Registrirajte se na staging-app.wink.travel. Vsi spodnji koraki uporabljajo staging — celoten postopek boste ponovili tudi na produkciji pred zagonom v živo.
-
Ustvarite svoj Affiliate / Channel Manager račun
Pod novim uporabnikom ustvarite račun in izberite vrsto računa Affiliate / Channel Manager. To je račun, s katerim se bo vaša integracija avtenticirala.
-
Registrirajte aplikacijo in ustvarite prvi žeton
Ustvarite aplikacijo in jo povežite z channel manager računom iz koraka 2. Izberite MACHINE_2_MACHINE kot tip odjemalca — gre za integracijo strežnik-strežnik brez preusmerjanja končnega uporabnika. Takoj si zabeležite Client ID in Secret Key; skrivni ključ je prikazan samo enkrat in ga ni mogoče ponovno pridobiti.
Aplikacija ustvarja nosilni žeton, ki ga vsak klic v tem vodiču nosi kot
Authorization: Bearer <access_token>. Zamenjajte svoje poverilnice za žeton z uporaboclient_credentialsgrant-a nahttps://staging-iam.wink.travel/oauth2/token, zahtevajte obsegeintegrations.read integrations.write. To naredite pred nadaljevanjem — brez žetona ne morete poizvedovati identifikatorjev računov ali dostopati do kateregakoli Channel Manager endpointa. Oglejte si Avtentikacijo za celoten potek, produkcijski gostitelj in celoten katalog obsegov. -
Ustvarite Hotel račun
Pod istim uporabnikom ustvarite drugi račun in izberite vrsto računa Hotel. Tako dobite nepremičnino, ki jo lahko uporabite za testiranje brez vključevanja pravega hotela.
-
Potrdite, da sta oba računa odobrena
Noben račun ni uporaben, dokler ni odobren: neodobren channel manager račun se ne prikaže na seznamu channel managerjev nobenega hotela, neodobren hotel pa ni vrnjen preko API-ja.
- Staging — odobritev je samodejna. Oba računa sta uporabna takoj po ustvarjanju in ni potrebno ničesar zahtevati.
- Produkcija — odobritev je ročna. Pošljite Wink kontaktu za integracije imeni obeh računov in uporabnika, pod katerim sta, nato počakajte na potrditev pred nadaljevanjem.
-
Povežite oba računa
Prijavite se v Hotel račun in pojdite na Channels → Channel manager. Izberite svoj channel manager račun s seznama — s tem povežete nepremičnino z vašo integracijo. Če vaš račun ni na seznamu, še ni odobren; glejte korak 5.
-
Ustvarite osnovno vrsto sobe in cenik
V Hotel računu ustvarite vsaj eno vrsto sobe in en cenik. To je potrebno, preden lahko vaša integracija potiska cene in razpoložljivost ali vleče rezervacije.
-
Preslikajte in testirajte
V svojem sistemu preslikajte identifikatorje vrste sobe in cenika, ki jih vrne API. Potisnite posodobitev cene in razpoložljivosti, nato izvedite testno rezervacijo in preverite, da jo endpoint za pridobivanje rezervacij pravilno vrne.
Iskanje identifikatorjev vaših računov
Section titled “Iskanje identifikatorjev vaših računov”Vsaka pot Channel Manager API-ja je omejena na vaš lasten račun:
/api/managing-entity/{managingEntityIdentifier}/channel-manager/...{managingEntityIdentifier} je ID računa (UUID) vašega channel manager računa — ne hotela. Pridobite ga skupaj z ID-jem in trenutnim statusom vseh drugih računov, ki jih ima vaš uporabnik, preko Platform API-ja:
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"Odgovor je seznam računov, ki jih imate:
[ { "id": "3f1c8e42-7b90-4d55-a1e2-6c8d09b4f731", "type": "CHANNEL_MANAGER", "name": "Vaš Channel Manager", "status": "ACTIVE" }, { "id": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "type": "HOTEL", "name": "Vaša testna nepremičnina", "urlName": "your-test-property", "status": "ACTIVE" }]idvnosa channel managerja je vaš{managingEntityIdentifier}.idvnosaHOTELje vaš{propertyIdentifier}.statuspotrjuje, da je vsak račun odobren — najbolj uporabno na produkciji, kjer je odobritev ročna. Hotel mora imeti statusACTIVE, preden je mogoče rezervirati ali ga vidi Channel Manager API. Vaš channel manager račun bo imel statusPENDING_APPROVALdokler ne opravite certifikacije; to je pričakovano in ne ovira razvoja.
Certifikacija
Section titled “Certifikacija”Certifikacija dokazuje — in Wink potrjuje — da vaša integracija pravilno preslika inventar, potiska cene in razpoložljivost ter prejema rezervacije od začetka do konca. Namenjena je samostojni uporabi: vsak korak izvedete iz svojega sistema in na koncu predložite en paket dokazov. Wink pregleda paket in ob uspehu spremeni status vašega Affiliate / Channel Manager računa iz PENDING_APPROVAL v ACTIVE.
Certifikacija poteka izključno v staging okolju (https://staging-integrations.wink.travel). Ta razdelek ne posega v produkcijo.
Kaj boste dokazali
Section titled “Kaj boste dokazali”-
Avtentikacija. Vaš OAuth2 odjemalec lahko pridobi dostopni žeton in uspešno pokliče
/pingendpoint za vaš Affiliate / Channel Manager račun. -
Preslikava inventarja. Lahko izpišete hotel(e), povezane z vašim računom, pridobite glavno ceno (kombinacija vrste sobe × cenika), ki ste jo konfigurirali, in pravilno identificirate
masterRateIdentifier, na katerega bo ciljal vaš sistem. -
Potisk cen in razpoložljivosti. Lahko neodvisno posodobite vseh sedem dni certifikacijskega tedna — z različnimi kombinacijami zneska, količine, zastavic zaprtja ob prihodu / odhodu ter minimalne/maksimalne dolžine bivanja za vsak dan — in nato preberete natančne vrednosti nazaj iz Winka.
-
Pridobivanje rezervacij. Lahko pridobite pravo staging rezervacijo, narejeno za vašo testno nepremičnino, jo prikažete v svojem PMS/CM uporabniškem vmesniku z ustrezno sobo, gostom in skupnim zneskom, nato pa odražate preklic, ko Wink označi rezervacijo kot preklicano.
Predpogoji
Section titled “Predpogoji”Pred začetkom certifikacije dokončajte korake 1–7 iz Korakov integracije, tako da imate:
- Wink uporabnika na stagingu z Affiliate / Channel Manager računom in Hotel računom, ki je povezan z njim (Channels → Channel manager). Staging računi so samodejno odobreni, zato ni potrebno ničesar zahtevati.
- Vsaj eno vrsto sobe in en cenik ustvarjena v Hotel računu. Objavite hotel, da je rezervabilen na
https://staging-book.wink.travel/hotel/<your-slug>. - Registrirano aplikacijo pod vašim Affiliate / Channel Manager računom z Client ID, Secret Key in obsegi
integrations.read integrations.write(glejte Avtentikacijo). managingEntityIdentifiervašega Affiliate / Channel Manager računa inpropertyIdentifiervašega Hotel računa (oba sta UUID-ja — glejte Iskanje identifikatorjev vaših računov).
Pogoste konvencije zahtevkov
Section titled “Pogoste konvencije zahtevkov”Vsak zahtevek v tem razdelku uporablja naslednje glave:
Authorization: Bearer <access_token>Wink-Version: 2.0Accept: application/json<access_token>pridobite zclient_credentialsgrantom nahttps://staging-iam.wink.travel/oauth2/token— glejte Avtentikacijo.- Glava
Wink-Versionje obvezna; brez nje ne bo usmerjeno na v2 JSON API. Content-Type: application/jsonse doda priPUTzahtevkih, ki vsebujejo telo.
V spodnjih primerih nadomestki ustrezajo vrednostim, ki ste jih zbrali v Predpogojih:
| Nadomestek | Pomen |
|---|---|
{managingEntityIdentifier} | ID vašega Affiliate / Channel Manager računa (UUID) — glejte Iskanje identifikatorjev vaših računov. |
{propertyIdentifier} | ID Hotel računa (nepremičnine), ki ste ga povezali z CM računom. |
{masterRateIdentifier} | Glavna cena (kombinacija vrste sobe × cenika), ki jo boste certificirali. |
{bookingIdentifier} | ID staging rezervacije, ki jo vrne klic seznama rezervacij. |
Korak A — Ping
Section titled “Korak A — Ping”Potrdite, da vaše poverilnice pripadajo pričakovanemu Affiliate / Channel Manager računu.
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"Pričakovan odgovor:
{ "apiVersion": "2.0", "name": "Ime vašega Channel Manager računa", "status": "PENDING_APPROVAL"}Odgovor 200 z ustreznim name pomeni, da sta avtentikacija in razrešitev računa pravilna. status bo bral PENDING_APPROVAL dokler vas Wink ne certificira.
Korak B — Seznam nepremičnin
Section titled “Korak B — Seznam nepremičnin”Pridobite paginiran seznam hotelov, povezanih z vašim računom, in potrdite, da je vaša testna nepremičnina prisotna.
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"Odgovor je Spring Page z vnosi ChannelManagerProperty. Poiščite vnos, katerega identifier ustreza vašemu {propertyIdentifier} in zabeležite njegov currencyCode — potrebovali ga boste za interpretacijo posodobitev cen v Koraku D.
Korak C — Pridobitev glavnih cen
Section titled “Korak C — Pridobitev glavnih cen”Pridobite nepremičnino skupaj z vsemi glavnimi cenami (kombinacije vrste sobe × cenika), ki jih objavlja. Izberite tisto, proti kateri boste certificirali, in zabeležite njen identifier kot vaš {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"Odgovor je ovojnica PropertyWithRoomRateList: blok property in polje rooms z vnosi PropertyRoomRate. Vsak vnos prikazuje vrsto sobe, cenik, omejitve zasedenosti, osnovno ceno in modifikatorje cen, ki jih boste ohranili pri potiskanju dnevnih cen.
Korak D — Naložite certifikacijski teden
Section titled “Korak D — Naložite certifikacijski teden”Naložite sedemdnevni cenovni koledar, ki pokriva prvih sedem koledarskih dni meseca po mesecu, v katerem začnete certifikacijo. Na primer, če začnete certifikacijo 21. avgusta, ciljate na 1. do 7. september.
Poslali boste sedem ločenih PUT klicev — enega na dan — kjer velja startDate == endDate. Vsak dan ima namensko drugačno kombinacijo zneska, količine, zastavic zaprtja ob prihodu / odhodu ter omejitev minimalne/maksimalne dolžine bivanja, da se vsako polje, ki ga je mogoče zapisati, vsaj enkrat preizkusi. Vrednosti so v valuti nepremičnine (zabeleženi v Koraku B); če izpustite currencyCode, bo privzeto pravilno.
| Dan | Znesek | Količina | closedOnArrival | closedOnDeparture | minLengthOfStay | maxLengthOfStay | Kaj dokazuje |
|---|---|---|---|---|---|---|---|
| 1 | 100,00 | 5 | false | false | 1 | 30 | Osnovni dan. |
| 2 | 125,00 | 4 | false | false | 1 | 14 | Sprememba zneska + količine + maxLengthOfStay. |
| 3 | 150,00 | 3 | true | false | 1 | 30 | Obrat closedOnArrival. |
| 4 | 175,00 | 2 | false | true | 2 | 7 | Obrat closedOnDeparture + ožji LOS interval. |
| 5 | 200,00 | 0 | false | false | 1 | 30 | Razprodana količina. |
| 6 | 225,00 | 5 | false | false | 3 | 5 | Strogi LOS interval. |
| 7 | 250,00 | 1 | false | false | 1 | 30 | Razpoložljivost zadnje sobe. |
Telo zahtevka za Dan 1 izgleda takole. Ponovite, prilagajajte startDate / endDate / vrednosti po vrsticah za dneve 2 do 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 }'Vsak PUT odgovori z 200 in poljem posodobljenih PropertyRate vnosov za poslani razpon (en vnos, ko je startDate == endDate). Ta odgovor shranite — bo del vaših dokazov.
Korak E — Preberite nazaj certifikacijski teden
Section titled “Korak E — Preberite nazaj certifikacijski teden”Pridobite celoten teden v enem klicu in potrdite, da se vrednosti za vsak dan ujemajo z vrstico, ki ste jo poslali v Koraku D — vključno z logičnimi zastavicami in LOS intervalom.
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"Odgovor je PropertyRoomRateWithRateList. Njegovo polje rates mora vsebovati sedem vnosov, po enega na dan, vsak z amount, quantity, closedOnArrival, closedOnDeparture, minLengthOfStay in maxLengthOfStay, ki ste jih naložili. Vsaka neskladnost pomeni, da ustrezni PUT iz Koraka D ni bil pravilno izveden — popravite in ponovno preverite pred nadaljevanjem.
Korak F — Naredite testno rezervacijo
Section titled “Korak F — Naredite testno rezervacijo”Odprite naslednji URL v brskalniku, pri čemer <your-slug> zamenjajte z imenom sluga Hotel računa, ki ste ga objavili v Predpogojih:
https://staging-book.wink.travel/hotel/<your-slug>Izberite datum prihoda in odhoda, ki je v celoti znotraj certifikacijskega tedna, izberite kombinacijo vrste sobe + cenika, ki ste jo certificirali, in dokončajte rezervacijo. Staging uporablja testno plačilno pot — nobena kartica ni dejansko zaračunana.
Ko se prikaže potrditvena stran, zabeležite kodo rezervacije (format WNKxxxxx), ki je prikazana gostu.
Korak G — Pridobite rezervacijo
Section titled “Korak G — Pridobite rezervacijo”Pridobite vse rezervacije, ustvarjene za vašo testno nepremičnino v časovnem oknu, ki zajema čas rezervacije.
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"Poiščite vnos, katerega bookingCode ustreza kodi, ki ste jo zabeležili v Koraku F. Zabeležite njegov bookingIdentifier. Nato pridobite to posamezno rezervacijo:
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"Odgovor je PropertyBooking. Uvozite ga v svoj PMS / channel-manager UI in potrdite, da se operaterju pravilno prikažejo vsi naslednji podatki:
bookingCode,bookingIdentifier,createdDate- Gost:
firstName,lastName,email totalAmount+currencyCode(neto znesek, ki ga hotel prejme za vse sobe)paymentMethodType,paymentMethodStatus,salesChannelName- Vsak vnos v
roomStays:guestRoomName,ratePlanName,adults,children,startDate,endDatein znesek na sobo
Posnemite zaslon rezervacije, kot se prikaže v vašem UI — ta posnetek je eden izmed zahtevanih dokaznih artefaktov.
Korak H — Prekličite rezervacijo in preverite
Section titled “Korak H — Prekličite rezervacijo in preverite”Prosite ekipo Wink, naj prekliče certifikacijsko rezervacijo v vašem imenu (ali jo prekličite sami iz Extraneta Hotel računa, če imate dovoljenje). Nato ponovno pridobite isto rezervacijo z klicem iz Koraka G.
Potrdite, da odgovor zdaj prikazuje:
cancelled: true- Izpolnjen časovni žig
cancelDate paymentMethodStatus, ki odraža življenjski cikel preklica (CANCELLED,PARTIALLY_REFUNDEDaliFULLY_REFUNDEDglede na politiko vračila)
Uvozite posodobljeno rezervacijo v svoj UI in potrdite, da je preklic viden operaterju — status, čas preklica in morebitni indikator vračila, ki ga vaš UI podpira. Posnemite drugi zaslon preklicane rezervacije v vašem UI. To je zadnji dokazni artefakt.
Korak I — Predložite paket dokazov
Section titled “Korak I — Predložite paket dokazov”Zberite naslednje v en sam arhiv (.zip) z imenom
wink-cert-<your-channel-manager-name>-<yyyy-mm-dd>.zip:
-
API transkript. Za vsak zahtevek, ki ste ga poslali v Korakih A do H, zajemite celoten HTTP zahtevek (metoda, URL, glave zahtevka z zamegljeno vrednostjo
Authorizationin JSON telo zaPUTklice) ter celoten HTTP odgovor (statusna koda, glave odgovora in JSON telo). Transkript strukturirajte tako, da je vsak par zahtevek/odgovor jasno označen s pripadajočim korakom (step-a-ping.json,step-d-day-3-put.json,step-g-list-bookings.jsonitd.). Sprejemljivi formati so navadne.httpdatoteke ali en sam.harizvoz. -
Posnetek zaslona UI: aktivna rezervacija. Posnetek zaslona iz Koraka G, ki prikazuje certifikacijsko rezervacijo v vašem PMS / channel-manager UI, z jasno berljivimi podatki o gostu, datumih, vrsti sobe, ceniku in skupnem znesku.
-
Posnetek zaslona UI: preklicana rezervacija. Posnetek zaslona iz Koraka H, ki prikazuje isto rezervacijo v vašem UI po preklicu, z jasno berljivim statusom preklica in časovnim žigom.
-
Povzetek certifikacije. Kratek
README.mdznotraj arhiva, ki vsebuje:- Ime in verzijo vašega channel managerja / PMS-a.
- Uporabljene
managingEntityIdentifier,propertyIdentifier,masterRateIdentifierinbookingIdentifier. - Slug staging hotela (tisti
<your-slug>vhttps://staging-book.wink.travel/hotel/<your-slug>). - Datum razpona certifikacijskega tedna (Dan 1 → Dan 7 v ISO-8601).
- Ime in e-pošta inženirja, ki je izvedel certifikacijo.
Pošljite arhiv svojemu Wink kontaktu za integracije. Wink bo pregledal, se odzval na morebitne neskladnosti in — ob uspehu — spremenil status vašega Affiliate / Channel Manager računa iz PENDING_APPROVAL v ACTIVE. Vaša integracija bo nato upravičena do produkcijskega vključevanja.
Obvestila Webhook
Section titled “Obvestila Webhook”Naročite se lahko na webhook dogodke channel managerja za prejemanje obvestil v realnem času:
channel-manager.update.rate— prejeta posodobitev cene.channel-manager.update.availability— prejeta posodobitev razpoložljivosti.channel-manager.update— splošna posodobitev channel managerja.
Podrobnosti najdete v Katalogu webhook dogodkov.
Nadaljnje branje
Section titled “Nadaljnje branje”- Channel Manager API — Celotna dokumentacija API endpointov.
- Channel manager — Upravljanje ponudnikov cen v Extranetu.
- Katalog webhook dogodkov — Vsi dogodki, na katere se lahko naročite.
- Build on Wink — Pregled platforme za razvijalce.
