Skip to content

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.

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
Produksjonhttps://integrations.wink.travel
Staginghttps://staging-integrations.wink.travel

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

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

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

  3. 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 å bruke client_credentials grant mot https://staging-iam.wink.travel/oauth2/token, og be om integrations.read integrations.write scopes. 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.

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

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

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

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

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:

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"

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"
}
]
  • id for channel manager-posten er din {managingEntityIdentifier}.
  • id for HOTEL-posten er din {propertyIdentifier}.
  • status er hvor du bekrefter at hver konto er godkjent — mest nyttig i produksjon, hvor godkjenning er manuell. Hotellet må ha status ACTIVE før det kan bookes eller vises i Channel Manager API. Din channel manager-konto vil fortsatt vise PENDING_APPROVAL inntil du har bestått Sertifisering; dette er forventet og blokkerer ikke utvikling.

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.

  1. Autentisering. Din OAuth2-klient kan hente et access token og kalle /ping-endepunktet mot din Affiliate / Channel Manager-konto med suksess.

  2. Inventarkartlegging. Du kan liste hotellet/hotellene koblet til kontoen din, hente masterprisen (romtype × prisplan) du har konfigurert, og korrekt identifisere masterRateIdentifier som systemet ditt vil målrette mot.

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

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

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.write scopes (se Authentication).
  • managingEntityIdentifier for din Affiliate / Channel Manager-konto og propertyIdentifier for din Hotell-konto (begge er UUID-er — se Finne dine kontoidentifikatorer).

Hver forespørsel i denne seksjonen bruker disse headerne:

Authorization: Bearer <access_token>
Wink-Version: 2.0
Accept: application/json
  • <access_token> kommer fra client_credentials grant mot https://staging-iam.wink.travel/oauth2/token — se Authentication.
  • Wink-Version header er påkrevd; uten den vil ikke kallene rutes til v2 JSON API.
  • Content-Type: application/json legges til på PUT-forespørsler som har en body.

Gjennom eksemplene nedenfor, tilsvarer plassholderne verdiene du samlet i Forutsetninger:

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

Bekreft at legitimasjonen din peker til den Affiliate / Channel Manager-kontoen du forventer.

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"

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.

Hent den paginerte listen over hoteller koblet til kontoen din og bekreft at testeiendommen din er til stede.

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"

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.

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

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"

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.

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.

DagBeløpKvantitetclosedOnArrivalclosedOnDepartureminLengthOfStaymaxLengthOfStayHva det beviser
1100,005falsefalse130Baseline-dag.
2125,004falsefalse114Beløp + kvantitet + maxLengthOfStay endring.
3150,003truefalse130closedOnArrival endring.
4175,002falsetrue27closedOnDeparture endring + strammere LOS-vindu.
5200,000falsefalse130Utsolgt kvantitet.
6225,005falsefalse35Restriktivt LOS-vindu.
7250,001falsefalse130Siste-rom-tilgjengelighet.

Forespørselsbody for Dag 1 ser slik ut. Gjenta, juster startDate / endDate / verdier per rad, for Dag 2 til 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
}'

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.

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"

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.

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

Hent alle reservasjoner opprettet for din testeiendom innenfor et tidsvindu som dekker booking-tidsstempelet.

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"

Finn posten hvor bookingCode matcher koden du noterte i Trinn F. Noter dens bookingIdentifier. Hent deretter den enkelte reservasjonen:

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"

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-rom amount

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 cancelDate tidsstempel
  • En paymentMethodStatus som reflekterer kanselleringslivssyklusen (CANCELLED, PARTIALLY_REFUNDED, eller FULLY_REFUNDED avhengig 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.

Pakk følgende i ett arkiv (.zip) med navn wink-cert-<your-channel-manager-name>-<yyyy-mm-dd>.zip:

  1. 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 for PUT-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.

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

  3. UI-skjermbilde: kansellert reservasjon. Skjermbildet fra Trinn H som viser samme reservasjon i ditt UI etter kansellering, med kansellert status og tidsstempel tydelig lesbar.

  4. Sertifiseringsoppsummering. En kort README.md i arkivet som lister:

    • Navn og versjon på din channel manager / PMS.
    • managingEntityIdentifier, propertyIdentifier, masterRateIdentifier og bookingIdentifier du brukte.
    • Staging-hotellens slug (det <your-slug> i https://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.

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.