Legg til din Channel Manager
Denne guiden leder channel manager- og PMS-utviklere gjennom hele prosessen med å integrere med Wink — fra å opprette kontoer til å kartlegge inventar og kjøre din første ende-til-ende-test.
Miljøer
Section titled “Miljøer”Channel Manager (Integrations) API er tilgjengelig i to miljøer. Bruk staging for all utvikling og sertifisering; bytt til produksjon først ved go-live.
| Miljø | Base-URL |
|---|---|
| Produksjon | https://integrations.wink.travel |
| Staging | https://staging-integrations.wink.travel |
API-referanse
Section titled “API-referanse”Channel Manager API følger OTA-protokollstandarder (SOAP/XML) for kompatibilitet med eksisterende hotellsystemer. Start med å gjennomgå partner-endepunkt-dokumentasjonen:
Channel Manager API — Partner-endepunkter
Integrasjonstrinn
Section titled “Integrasjonstrinn”-
Opprett en Wink-brukerkonto
Registrer deg på staging-app.wink.travel. Alle trinn nedenfor bruker staging — du vil gjenta hele prosessen i produksjon før go-live.
-
Opprett din Affiliate / Channel Manager-konto
Under din nye bruker, opprett en konto og velg kontotypen Affiliate / Channel Manager. Dette er kontoen integrasjonen din vil autentisere som.
-
Registrer en applikasjon og lag ditt første token
Opprett en Application og knytt den til channel manager-kontoen fra trinn 2. Velg MACHINE_2_MACHINE som klienttype — dette er en server-til-server-integrasjon uten sluttbruker å omdirigere. Kopier Client ID og Secret Key umiddelbart; secret key vises kun én gang og kan ikke hentes igjen.
Applikasjonen er det som lager bearer-tokenet som alle kall i denne guiden bærer som
Authorization: Bearer <access_token>. Bytt dine legitimasjoner mot et token ved å brukeclient_credentialsgrant mothttps://staging-iam.wink.travel/oauth2/token, og be omintegrations.read integrations.writescopes. Gjør dette før du går videre — du kan ikke slå opp kontoinformasjon eller nå noen Channel Manager-endepunkter uten token. Se Authentication for full flyt, produksjonshost og komplett scope-katalog. -
Opprett en Hotell-konto
Under samme bruker, opprett en andre konto og velg kontotypen Hotel. Dette gir deg en eiendom du kan bruke til testing uten å involvere et ekte hotell.
-
Bekreft at begge kontoene er godkjent
Ingen av kontoene kan brukes før de er godkjent: en ikke-godkjent channel manager-konto vises ikke i noen hotells channel manager-liste, og et ikke-godkjent hotell returneres ikke av API-et.
- Staging — godkjenning er automatisk. Begge kontoene kan brukes så snart du oppretter dem, og det er ingenting å be om.
- Produksjon — godkjenning er manuell. Send navnene på begge kontoene og brukeren de ligger under til din Wink-integrasjonskontakt, og vent på bekreftelse før du fortsetter.
-
Koble de to kontoene
Logg inn på Hotell-kontoen og naviger til Channels → Channel manager. Velg din channel manager-konto fra listen — dette kobler eiendommen til integrasjonen din. Hvis kontoen din ikke er i listen, er den ikke godkjent ennå; se trinn 5.
-
Opprett en grunnleggende romtype og prisplan
Inne i Hotell-kontoen, opprett minst én romtype og én prisplan. Disse kreves før integrasjonen din kan sende priser og tilgjengelighet eller hente reservasjoner.
-
Kartlegg og test
I ditt eget system, kartlegg romtype- og prisplan-identifikatorene som returneres av API-et. Send en prisoppdatering og en tilgjengelighetsoppdatering, lag deretter en testreservasjon og verifiser at booking-hentingsendepunktet returnerer den korrekt.
Finne dine kontoidentifikatorer
Section titled “Finne dine kontoidentifikatorer”Hver Channel Manager API-sti er avgrenset til din egen konto:
/api/managing-entity/{managingEntityIdentifier}/channel-manager/...{managingEntityIdentifier} er konto-ID-en (en UUID) til din channel manager-konto — ikke
hotellets. Hent den, sammen med ID og nåværende status for alle andre kontoer brukeren din
eier, fra 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"Responsen er en liste over kontoene du eier:
[ { "id": "3f1c8e42-7b90-4d55-a1e2-6c8d09b4f731", "type": "CHANNEL_MANAGER", "name": "Din Channel Manager", "status": "ACTIVE" }, { "id": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "type": "HOTEL", "name": "Din Testeiendom", "urlName": "your-test-property", "status": "ACTIVE" }]idfor channel manager-posten er din{managingEntityIdentifier}.idforHOTEL-posten er din{propertyIdentifier}.statuser hvor du bekrefter at hver konto er godkjent — mest nyttig i produksjon, hvor godkjenning er manuell. Hotellet må ha statusACTIVEfør det kan bookes eller vises i Channel Manager API. Din channel manager-konto vil fortsatt visePENDING_APPROVALinntil du har bestått Sertifisering; dette er forventet og blokkerer ikke utvikling.
Sertifisering
Section titled “Sertifisering”Sertifisering er hvordan du beviser — og hvordan Wink bekrefter — at integrasjonen din korrekt kartlegger inventar, sender priser og tilgjengelighet, og mottar reservasjoner ende-til-ende. Den er designet for å være selvbetjent: du styrer hvert trinn fra ditt eget system, og du leverer en enkelt bevispakke til slutt. Wink vurderer pakken og, ved bestått, oppgraderer din Affiliate / Channel Manager-konto fra PENDING_APPROVAL til ACTIVE.
Sertifiseringen kjøres helt mot staging-miljøet
(https://staging-integrations.wink.travel). Ingenting i denne seksjonen berører produksjon.
Hva du skal bevise
Section titled “Hva du skal bevise”-
Autentisering. Din OAuth2-klient kan hente et access token og kalle
/ping-endepunktet mot din Affiliate / Channel Manager-konto med suksess. -
Inventarkartlegging. Du kan liste hotellet/hotellene koblet til kontoen din, hente masterprisen (romtype × prisplan) du har konfigurert, og korrekt identifisere
masterRateIdentifiersom systemet ditt vil målrette mot. -
Pris- og tilgjengelighetsoppdatering. Du kan oppdatere alle syv dagene i en sertifiseringsuke uavhengig — en ulik kombinasjon av beløp, kvantitet, close-on-arrival / close-on-departure flagg, og min/maks oppholdslengde for hver dag — og lese de eksakte verdiene tilbake fra Wink.
-
Booking-henting. Du kan hente en ekte staging-reservasjon gjort mot din testeiendom, vise den i ditt eget PMS/CM-grensesnitt med korrekt romopphold, gjest og totalbeløp, og deretter reflektere en kansellering når Wink markerer reservasjonen som kansellert.
Forutsetninger
Section titled “Forutsetninger”Før du begynner sertifiseringen, fullfør trinn 1–7 i Integrasjonstrinn slik at du har:
- En Wink-bruker på staging med en Affiliate / Channel Manager-konto og en Hotel-konto koblet til den (Channels → Channel manager). Staging-kontoer godkjennes automatisk, så det er ingenting å be om her.
- Minst én romtype og én prisplan opprettet inne i Hotell-kontoen. Publiser hotellet slik at det kan bookes på
https://staging-book.wink.travel/hotel/<your-slug>. - En registrert applikasjon under din Affiliate / Channel Manager-konto med en Client ID,
Secret Key, og
integrations.read integrations.writescopes (se Authentication). managingEntityIdentifierfor din Affiliate / Channel Manager-konto ogpropertyIdentifierfor din Hotell-konto (begge er UUID-er — se Finne dine kontoidentifikatorer).
Vanlige forespørselskonvensjoner
Section titled “Vanlige forespørselskonvensjoner”Hver forespørsel i denne seksjonen bruker disse headerne:
Authorization: Bearer <access_token>Wink-Version: 2.0Accept: application/json<access_token>kommer fraclient_credentialsgrant mothttps://staging-iam.wink.travel/oauth2/token— se Authentication.Wink-Versionheader er påkrevd; uten den vil ikke kallene rutes til v2 JSON API.Content-Type: application/jsonlegges til påPUT-forespørsler som har en body.
Gjennom eksemplene nedenfor, tilsvarer plassholderne verdiene du samlet i Forutsetninger:
| Plassholder | Betydning |
|---|---|
{managingEntityIdentifier} | Din Affiliate / Channel Manager-konto-ID (UUID) — se Finne dine kontoidentifikatorer. |
{propertyIdentifier} | Hotellkontoens (eiendommens) ID du koblet til CM-kontoen. |
{masterRateIdentifier} | Masterprisen (romtype × prisplan) du skal sertifisere mot. |
{bookingIdentifier} | Staging-reservasjons-ID returnert av bookingliste-kallet. |
Trinn A — Ping
Section titled “Trinn A — Ping”Bekreft at legitimasjonen din peker til den Affiliate / Channel Manager-kontoen du forventer.
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"Forventet respons:
{ "apiVersion": "2.0", "name": "Navnet på din Channel Manager-konto", "status": "PENDING_APPROVAL"}En 200-respons med et samsvarende name er signalet på at autentisering og kontoløsning
er korrekt. status vil vise PENDING_APPROVAL inntil Wink sertifiserer deg.
Trinn B — List eiendommer
Section titled “Trinn B — List eiendommer”Hent den paginerte listen over hoteller koblet til kontoen din og bekreft at testeiendommen din er til stede.
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"Responsen er en Spring Page av ChannelManagerProperty-poster. Finn posten hvor
identifier matcher din {propertyIdentifier} og noter dens currencyCode — du vil trenge den
for tolkningen av prisoppdateringene i Trinn D.
Trinn C — Hent masterpriser
Section titled “Trinn C — Hent masterpriser”Hent eiendommen sammen med alle masterpriser (romtype × prisplan-kombinasjoner) den
publiserer. Velg den du har tenkt å sertifisere mot og noter dens identifier som din
{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"Responsen er en PropertyWithRoomRateList: en property-blokk pluss en rooms-array av
PropertyRoomRate-poster. Hver post viser romtype, prisplan, belegggrenser, basispris og prisjusteringer
du vil bevare når du sender daglige priser.
Trinn D — Last sertifiseringsuken
Section titled “Trinn D — Last sertifiseringsuken”Last en syvdagers pris-kalender som dekker de første syv kalenderdagene i måneden etter måneden du starter sertifiseringen. For eksempel, hvis du starter sertifisering 21. august, målrett 1. til 7. september.
Du vil sende syv separate PUT-kall — ett per dag — hvor startDate == endDate. Hver dag
har en bevisst ulik kombinasjon av beløp, kvantitet, restriksjonsflagg og oppholdslengdegrenser
slik at hvert skrivbart felt testes minst én gang. Verdier er i eiendommens valuta (notert i Trinn B);
utelat currencyCode og det vil settes riktig som standard.
| Dag | Beløp | Kvantitet | closedOnArrival | closedOnDeparture | minLengthOfStay | maxLengthOfStay | Hva det beviser |
|---|---|---|---|---|---|---|---|
| 1 | 100,00 | 5 | false | false | 1 | 30 | Baseline-dag. |
| 2 | 125,00 | 4 | false | false | 1 | 14 | Beløp + kvantitet + maxLengthOfStay endring. |
| 3 | 150,00 | 3 | true | false | 1 | 30 | closedOnArrival endring. |
| 4 | 175,00 | 2 | false | true | 2 | 7 | closedOnDeparture endring + strammere LOS-vindu. |
| 5 | 200,00 | 0 | false | false | 1 | 30 | Utsolgt kvantitet. |
| 6 | 225,00 | 5 | false | false | 3 | 5 | Restriktivt LOS-vindu. |
| 7 | 250,00 | 1 | false | false | 1 | 30 | Siste-rom-tilgjengelighet. |
Forespørselsbody for Dag 1 ser slik ut. Gjenta, juster startDate / endDate / verdier per
rad, for Dag 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 svarer med 200 og en liste over oppdaterte PropertyRate-poster for det angitte intervallet
(én post når startDate == endDate). Ta vare på det svaret — det vil være en del av bevisene dine.
Trinn E — Les tilbake sertifiseringsuken
Section titled “Trinn E — Les tilbake sertifiseringsuken”Hent hele uken i ett kall og bekreft at hver dags lagrede verdier samsvarer med raden du sendte i Trinn D — inkludert boolske flagg og oppholdslengde-vindu.
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"Responsen er en PropertyRoomRateWithRateList. Dens rates-array må inneholde syv poster,
én per dag, hver med amount, quantity, closedOnArrival, closedOnDeparture,
minLengthOfStay og maxLengthOfStay du lastet opp. En avvik på noe felt betyr at tilsvarende
PUT i Trinn D ikke ble lagret som forventet — rett opp og verifiser på nytt før du går videre.
Trinn F — Lag en testreservasjon
Section titled “Trinn F — Lag en testreservasjon”Åpne følgende URL i en nettleser, erstatt <your-slug> med sluggen til Hotell-kontoen du
publiserte i Forutsetninger:
https://staging-book.wink.travel/hotel/<your-slug>Velg ankomst- og avreisedato som faller helt innenfor sertifiseringsuken, velg romtype + prisplankombinasjonen du sertifiserte, og fullfør reservasjonen. Staging bruker en test betalingsløsning — ingen ekte kort belastes.
Når bekreftelsessiden vises, noter bookingkoden (format WNKxxxxx) som vises til gjesten.
Trinn G — Hent reservasjonen
Section titled “Trinn G — Hent reservasjonen”Hent alle reservasjoner opprettet for din testeiendom innenfor et tidsvindu som dekker booking-tidsstempelet.
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"Finn posten hvor bookingCode matcher koden du noterte i Trinn F. Noter dens
bookingIdentifier. Hent deretter den enkelte reservasjonen:
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"Responsen er en PropertyBooking. Importer den til ditt eget PMS / channel manager-grensesnitt og bekreft
at alle følgende vises korrekt for en operatør:
bookingCode,bookingIdentifier,createdDate- Gjest:
firstName,lastName,email totalAmount+currencyCode(netto beløp hotellet mottar for alle rom)paymentMethodType,paymentMethodStatus,salesChannelName- Hver post i
roomStays:guestRoomName,ratePlanName,adults,children,startDate,endDate, og per-romamount
Ta et skjermbilde av reservasjonen slik den vises i ditt eget grensesnitt — det skjermbildet er ett av de nødvendige bevisene.
Trinn H — Kanseller reservasjonen og verifiser
Section titled “Trinn H — Kanseller reservasjonen og verifiser”Be Wink-teamet om å kansellere sertifiseringsreservasjonen på dine vegne (eller kanseller den selv fra Hotellets Extranet hvis du har den tillatelsen). Hent deretter samme reservasjon på nytt med kallet fra Trinn G.
Bekreft at responsen nå viser:
cancelled: true- En utfylt
cancelDatetidsstempel - En
paymentMethodStatussom reflekterer kanselleringslivssyklusen (CANCELLED,PARTIALLY_REFUNDED, ellerFULLY_REFUNDEDavhengig av refusjonspolicy)
Importer den oppdaterte reservasjonen til ditt eget grensesnitt og bekreft at kanselleringen er synlig for operatøren — status, kansellert-tidsstempel og eventuelle refusjonsindikatorer som UI-et ditt støtter. Ta et andre skjermbilde av den kansellerte reservasjonen i ditt UI. Dette er det siste beviset.
Trinn I — Send inn bevispakken din
Section titled “Trinn I — Send inn bevispakken din”Pakk følgende i ett arkiv (.zip) med navn
wink-cert-<your-channel-manager-name>-<yyyy-mm-dd>.zip:
-
API-transkripsjon. For hver forespørsel du sendte i Trinn A til H, ta vare på hele HTTP-forespørselen (metode, URL, forespørselsheadere med
Authorization-verdien sensurert, og JSON-body forPUT-kall) og hele HTTP-responsen (statuskode, responsheadere og JSON-body). Strukturér transkripsjonen slik at hver forespørsel/response-par tydelig merkes med hvilket trinn det tilhører (step-a-ping.json,step-d-day-3-put.json,step-g-list-bookings.json, osv.). Ren tekst.http-filer eller en enkelt.har-eksport er begge akseptable formater. -
UI-skjermbilde: aktiv reservasjon. Skjermbildet fra Trinn G som viser sertifiseringsreservasjonen gjengitt i ditt eget PMS / channel manager UI, med gjest, datoer, romtype, prisplan og total tydelig lesbar.
-
UI-skjermbilde: kansellert reservasjon. Skjermbildet fra Trinn H som viser samme reservasjon i ditt UI etter kansellering, med kansellert status og tidsstempel tydelig lesbar.
-
Sertifiseringsoppsummering. En kort
README.mdi arkivet som lister:- Navn og versjon på din channel manager / PMS.
managingEntityIdentifier,propertyIdentifier,masterRateIdentifierogbookingIdentifierdu brukte.- Staging-hotellens slug (det
<your-slug>ihttps://staging-book.wink.travel/hotel/<your-slug>). - Dato-intervallet for sertifiseringsuken (Dag 1 → Dag 7 i ISO-8601).
- Navn og e-post til ingeniøren som kjørte sertifiseringen.
Send arkivet til din Wink-integrasjonskontakt. Wink vil gjennomgå, følge opp eventuelle
avvik, og — ved bestått — endre status på din Affiliate / Channel Manager-konto fra
PENDING_APPROVAL til ACTIVE. Integrasjonen din blir da kvalifisert for produksjonsoppsett.
Webhook-varsler
Section titled “Webhook-varsler”Du kan abonnere på channel manager webhook-hendelser for å motta sanntidsvarsler:
channel-manager.update.rate— Prisoppdatering mottatt.channel-manager.update.availability— Tilgjengelighetsoppdatering mottatt.channel-manager.update— Generell channel manager-oppdatering.
Se Webhook Events Catalog for detaljer.
Videre lesning
Section titled “Videre lesning”- Channel Manager API — Full API-endepunkt-dokumentasjon.
- Channel manager — Administrasjon av prisleverandører i Extranet.
- Webhook Events Catalog — Alle abonnerbare hendelser.
- Build on Wink — Plattformoversikt for utviklere.
