Voeg uw Channel Manager toe
Deze gids begeleidt channel manager- en PMS-ontwikkelaars door het volledige integratieproces met Wink — van het aanmaken van uw accounts tot het in kaart brengen van de inventaris en het uitvoeren van uw eerste end-to-end test.
Omgevingen
Section titled “Omgevingen”De Channel Manager (Integrations) API is beschikbaar in twee omgevingen. Gebruik staging voor alle ontwikkeling en certificering; schakel pas over naar productie bij livegang.
| Omgeving | Basis-URL |
|---|---|
| Productie | https://integrations.wink.travel |
| Staging | https://staging-integrations.wink.travel |
API-referentie
Section titled “API-referentie”De Channel Manager API volgt OTA-protocolstandaarden (SOAP/XML) voor compatibiliteit met bestaande hospitality-systemen. Begin met het bekijken van de partner endpoint-documentatie:
Channel Manager API — Partner endpoints
Integratiestappen
Section titled “Integratiestappen”-
Maak een Wink-gebruikersaccount aan
Meld u aan op staging-app.wink.travel. Alle onderstaande stappen gebruiken staging — u herhaalt het volledige proces in productie vóór livegang.
-
Maak uw Affiliate / Channel Manager-account aan
Maak onder uw nieuwe gebruiker een account aan en selecteer het accounttype Affiliate / Channel Manager. Dit is het account waarmee uw integratie zich zal authenticeren.
-
Registreer een applicatie en genereer uw eerste token
Maak een Applicatie aan en koppel deze aan het channel manager-account uit stap 2. Kies MACHINE_2_MACHINE als clienttype — dit is een server-naar-server integratie zonder eindgebruiker om te redirecten. Kopieer direct de Client ID en Secret Key; de geheime sleutel wordt slechts één keer getoond en kan niet opnieuw worden opgevraagd.
De applicatie genereert het bearer token dat elke oproep in deze gids draagt als
Authorization: Bearer <access_token>. Wissel uw inloggegevens in voor een token via declient_credentialsgrant tegenhttps://staging-iam.wink.travel/oauth2/token, met de scopesintegrations.read integrations.write. Doe dit voordat u verdergaat — zonder token kunt u geen account-ID’s opzoeken of een Channel Manager endpoint bereiken. Zie Authenticatie voor de volledige flow, de productiehost en de complete scopecatalogus. -
Maak een Hotel-account aan
Maak onder dezelfde gebruiker een tweede account aan en selecteer het accounttype Hotel. Dit geeft u een accommodatie die u kunt gebruiken voor testen zonder een echt hotel te betrekken.
-
Bevestig dat beide accounts zijn goedgekeurd
Geen van beide accounts kan worden gebruikt voordat ze zijn goedgekeurd: een niet-goedgekeurd channel manager-account verschijnt niet in de channel manager-lijst van een hotel, en een niet-goedgekeurd hotel wordt niet door de API teruggegeven.
- Staging — goedkeuring is automatisch. Beide accounts zijn direct bruikbaar na aanmaak, er hoeft niets aangevraagd te worden.
- Productie — goedkeuring is handmatig. Stuur uw Wink-integratiecontact de namen van beide accounts en de gebruiker waaronder ze vallen, en wacht op bevestiging voordat u verdergaat.
-
Verbind de twee accounts
Log in op het Hotel-account en ga naar Kanalen → Channel manager. Selecteer uw channel manager-account uit de lijst — hiermee koppelt u de accommodatie aan uw integratie. Als uw account niet in de lijst staat, is het nog niet goedgekeurd; zie stap 5.
-
Maak een basis kamertype en tariefplan aan
Maak binnen het Hotel-account minimaal één kamertype en één tariefplan aan. Deze zijn vereist voordat uw integratie tarieven en beschikbaarheid kan pushen of boekingen kan ophalen.
-
Map en test
Map in uw eigen systeem de kamertype- en tariefplan-ID’s die door de API worden teruggegeven. Push een tariefupdate en een beschikbaarheidsupdate, maak vervolgens een testboeking en controleer of het endpoint voor het ophalen van boekingen deze correct teruggeeft.
Uw account-ID’s vinden
Section titled “Uw account-ID’s vinden”Elk Channel Manager API-pad is gescopeerd op uw eigen account:
/api/managing-entity/{managingEntityIdentifier}/channel-manager/...{managingEntityIdentifier} is de account-ID (een UUID) van uw channel manager-account — niet van het hotel. Haal deze op, samen met de ID en huidige status van elk ander account dat uw gebruiker bezit, via de 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"De respons is een array van de accounts die u bezit:
[ { "id": "3f1c8e42-7b90-4d55-a1e2-6c8d09b4f731", "type": "CHANNEL_MANAGER", "name": "Uw Channel Manager", "status": "ACTIVE" }, { "id": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "type": "HOTEL", "name": "Uw Testaccommodatie", "urlName": "your-test-property", "status": "ACTIVE" }]- De
idvan de channel manager-entry is uw{managingEntityIdentifier}. - De
idvan deHOTEL-entry is uw{propertyIdentifier}. statusis waar u bevestigt dat elk account is goedgekeurd — vooral nuttig in productie, waar goedkeuring handmatig is. Het hotel moetACTIVElezen voordat het boekbaar is of zichtbaar voor de Channel Manager API. Uw channel manager-account blijftPENDING_APPROVALlezen totdat u Certificering doorloopt; dat is verwacht en blokkeert de ontwikkeling niet.
Certificering
Section titled “Certificering”Certificering is hoe u bewijst — en hoe Wink bevestigt — dat uw integratie correct inventaris in kaart brengt, tarieven en beschikbaarheid pusht, en boekingen end-to-end ontvangt. Het is ontworpen als selfservice: u voert elke stap uit vanuit uw eigen systeem en levert aan het einde een enkel bewijspakket in. Wink beoordeelt het pakket en zet, bij goedkeuring, uw Affiliate / Channel Manager-account om van PENDING_APPROVAL naar ACTIVE.
Certificering vindt volledig plaats in de staging-omgeving
(https://staging-integrations.wink.travel). Niets in deze sectie raakt productie.
Wat u zult bewijzen
Section titled “Wat u zult bewijzen”-
Authenticatie. Uw OAuth2-client kan een access token verkrijgen en succesvol de
/pingendpoint aanroepen tegen uw Affiliate / Channel Manager-account. -
Inventaris mapping. U kunt de aan uw account gekoppelde hotels opvragen, het master tarief (kamertype × tariefplan) ophalen dat u heeft geconfigureerd, en correct het
masterRateIdentifieridentificeren waarop uw systeem zich richt. -
Tarief- & beschikbaarheidspush. U kunt alle zeven dagen van een certificeringsweek onafhankelijk bijwerken — met verschillende combinaties van bedrag, hoeveelheid, close-on-arrival / close-on-departure vlaggen, en min/max verblijfsduur per dag — en de exacte waarden teruglezen van Wink.
-
Boeking ophalen. U kunt een echte staging-boeking ophalen die is gemaakt voor uw testaccommodatie, deze tonen in uw eigen PMS/CM UI met de juiste kamerreservering, gast en totaalbedrag, en vervolgens een annulering weergeven zodra Wink de boeking als geannuleerd markeert.
Vereisten
Section titled “Vereisten”Voordat u begint met certificeren, voltooit u stappen 1–7 van Integratiestappen zodat u:
- Een Wink-gebruiker op staging heeft met een Affiliate / Channel Manager-account en een Hotel-account die eraan gekoppeld is (Kanalen → Channel manager). Staging-accounts worden automatisch goedgekeurd, dus hier hoeft niets aangevraagd te worden.
- Minimaal één kamertype en één tariefplan heeft aangemaakt binnen het Hotel-account. Publiceer het
hotel zodat het boekbaar is op
https://staging-book.wink.travel/hotel/<your-slug>. - Een geregistreerde applicatie heeft onder uw Affiliate / Channel Manager-account met een Client ID,
Secret Key, en de scopes
integrations.read integrations.write(zie Authenticatie). - De
managingEntityIdentifiervan uw Affiliate / Channel Manager-account en depropertyIdentifiervan uw Hotel-account (beide UUID’s — zie Uw account-ID’s vinden).
Algemene verzoekconventies
Section titled “Algemene verzoekconventies”Elke aanvraag in deze sectie gebruikt deze headers:
Authorization: Bearer <access_token>Wink-Version: 2.0Accept: application/json<access_token>komt van declient_credentialsgrant tegenhttps://staging-iam.wink.travel/oauth2/token— zie Authenticatie.- De
Wink-Versionheader is verplicht; zonder deze wordt niet naar de v2 JSON API gerouteerd. Content-Type: application/jsonwordt toegevoegd bijPUT-verzoeken met een body.
In de voorbeelden hieronder corresponderen de placeholders met de waarden die u verzamelde in Vereisten:
| Placeholder | Betekenis |
|---|---|
{managingEntityIdentifier} | Uw Affiliate / Channel Manager-account-ID (UUID) — zie Uw account-ID’s vinden. |
{propertyIdentifier} | De Hotel-account (accommodatie) ID die u aan het CM-account koppelde. |
{masterRateIdentifier} | Het master tarief (kamertype × tariefplan) waarop u certificeert. |
{bookingIdentifier} | De staging-boeking-ID die terugkomt uit de boekingenlijst-oproep. |
Stap A — Ping
Section titled “Stap A — Ping”Bevestig dat uw inloggegevens verwijzen naar het Affiliate / Channel Manager-account dat u verwacht.
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"Verwachte respons:
{ "apiVersion": "2.0", "name": "Naam van uw Channel Manager-account", "status": "PENDING_APPROVAL"}Een 200-respons met een overeenkomende name is het signaal dat authenticatie en accountresolutie
correct zijn. status zal PENDING_APPROVAL lezen totdat Wink u certificeert.
Stap B — Lijst accommodaties
Section titled “Stap B — Lijst accommodaties”Haal de gepagineerde lijst op van hotels die aan uw account gekoppeld zijn en bevestig dat uw testaccommodatie aanwezig is.
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"De respons is een Spring Page van ChannelManagerProperty-items. Zoek de entry waarvan de
identifier overeenkomt met uw {propertyIdentifier} en noteer de currencyCode — die heeft u nodig
voor de interpretatie van de tariefupdates in Stap D.
Stap C — Haal master tarieven op
Section titled “Stap C — Haal master tarieven op”Haal de accommodatie op samen met elk master tarief (kamertype × tariefplan combinatie) dat het
publiceert. Kies degene waarop u wilt certificeren en noteer de identifier als uw
{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"De respons is PropertyWithRoomRateList: een property-blok plus een rooms-array van
PropertyRoomRate-items. Elk item toont het kamertype, tariefplan, bezettingslimieten, basistarief,
en de tariefmodifiers die u behoudt bij het pushen van dagtarieven.
Stap D — Laad de certificeringsweek
Section titled “Stap D — Laad de certificeringsweek”Laad een zevendaagse tariefkalender die de eerste zeven kalenderdagen van de maand na de maand waarin u begint met certificeren omvat. Bijvoorbeeld, als u start op 21 augustus, richt u op 1 september tot en met 7 september.
U verstuurt zeven aparte PUT-calls — één per dag — waarbij startDate == endDate. Elke dag
heeft een bewust verschillende combinatie van bedrag, hoeveelheid, restrictievlaggen en verblijfsduur-
limieten zodat elk schrijfbaar veld minstens één keer wordt getest. Waarden zijn in de valuta van de accommodatie
(geregistreerd in Stap B); laat currencyCode weg en het wordt correct standaard ingesteld.
| Dag | Bedrag | Hoeveelheid | closedOnArrival | closedOnDeparture | minLengthOfStay | maxLengthOfStay | Wat het bewijst |
|---|---|---|---|---|---|---|---|
| 1 | 100,00 | 5 | false | false | 1 | 30 | Baseline dag. |
| 2 | 125,00 | 4 | false | false | 1 | 14 | Bedrag + hoeveelheid + maxLengthOfStay wijziging. |
| 3 | 150,00 | 3 | true | false | 1 | 30 | closedOnArrival omkering. |
| 4 | 175,00 | 2 | false | true | 2 | 7 | closedOnDeparture omkering + strakkere verblijfsduur. |
| 5 | 200,00 | 0 | false | false | 1 | 30 | Uitverkocht hoeveelheid. |
| 6 | 225,00 | 5 | false | false | 3 | 5 | Restrictieve verblijfsduur. |
| 7 | 250,00 | 1 | false | false | 1 | 30 | Laatste kamer beschikbaar. |
De request body voor Dag 1 ziet er zo uit. Herhaal, pas startDate / endDate / waarden aan per
rij, voor Dag 2 tot en met 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 }'Elke PUT reageert met 200 en een array van bijgewerkte PropertyRate-items voor het bereik dat u stuurde
(één item wanneer startDate == endDate). Bewaar die respons — die maakt deel uit van uw bewijs.
Stap E — Lees de certificeringsweek terug
Section titled “Stap E — Lees de certificeringsweek terug”Haal de hele week in één call op en bevestig dat de opgeslagen waarden per dag overeenkomen met de rij die u in Stap D stuurde — inclusief de booleaanse vlaggen en de verblijfsduur.
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"De respons is een PropertyRoomRateWithRateList. De rates-array moet zeven items bevatten,
één per dag, elk met de amount, quantity, closedOnArrival, closedOnDeparture,
minLengthOfStay en maxLengthOfStay die u laadde. Een mismatch op een veld betekent dat de
overeenkomstige PUT in Stap D niet correct is verwerkt — corrigeer dit en verifieer opnieuw voordat u verdergaat.
Stap F — Maak een testboeking
Section titled “Stap F — Maak een testboeking”Open de volgende URL in een browser, vervang <your-slug> door de slug van het Hotel-account dat u
publiceerde in Vereisten:
https://staging-book.wink.travel/hotel/<your-slug>Selecteer een aankomst- en vertrekdatum die volledig binnen uw certificeringsweek vallen, kies de kamertype + tariefplan combinatie die u certificeerde, en voltooi de boeking. Staging gebruikt een test- betalingspad — er wordt geen live kaart belast.
Zodra de bevestigingspagina wordt weergegeven, noteer de boekingscode (formaat WNKxxxxx) die aan de
gast wordt getoond.
Stap G — Haal de boeking op
Section titled “Stap G — Haal de boeking op”Haal elke boeking op die voor uw testaccommodatie is gemaakt binnen een tijdsvenster dat de boekingstijd omvat.
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"Zoek de entry waarvan de bookingCode overeenkomt met de code die u in Stap F noteerde. Noteer de
bookingIdentifier. Haal vervolgens die enkele boeking op:
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"De respons is een PropertyBooking. Importeer deze in uw eigen PMS / channel-manager UI en bevestig
dat elk van de volgende correct wordt weergegeven aan een operator:
bookingCode,bookingIdentifier,createdDate- Gast:
firstName,lastName,email totalAmount+currencyCode(het netto bedrag dat het hotel ontvangt over alle kamers)paymentMethodType,paymentMethodStatus,salesChannelName- Elke entry in
roomStays:guestRoomName,ratePlanName,adults,children,startDate,endDate, en per kameramount
Maak een screenshot van de boeking zoals die in uw eigen UI verschijnt — die screenshot is één van de vereiste bewijsstukken.
Stap H — Annuleer de boeking en verifieer
Section titled “Stap H — Annuleer de boeking en verifieer”Vraag het Wink-team om de certificeringsboeking namens u te annuleren (of annuleer deze zelf vanuit het Extranet van het Hotel-account als u die permissie heeft). Haal daarna dezelfde boeking opnieuw op met de call uit Stap G.
Bevestig dat de respons nu toont:
cancelled: true- Een ingevulde
cancelDatetimestamp - Een
paymentMethodStatusdie de annuleringsstatus weergeeft (CANCELLED,PARTIALLY_REFUNDED, ofFULLY_REFUNDEDafhankelijk van het restitutiebeleid)
Importeer die bijgewerkte boeking in uw eigen UI en bevestig dat de annulering zichtbaar is voor de operator — status, annuleringsdatum en eventuele restitutie-indicator die uw UI ondersteunt. Maak een tweede screenshot van de geannuleerde boeking in uw UI. Dit is het laatste bewijsstuk.
Stap I — Dien uw bewijspakket in
Section titled “Stap I — Dien uw bewijspakket in”Verpak het volgende in één archiefbestand (.zip) met de naam
wink-cert-<uw-channel-manager-naam>-<jjjj-mm-dd>.zip:
-
API-transcriptie. Voor elke aanvraag die u deed in Stappen A tot en met H, leg het volledige HTTP-verzoek vast (methode, URL, request headers met de
Authorization-waarde geanonimiseerd, en de JSON-body voorPUTcalls) en de volledige HTTP-respons (statuscode, response headers en de JSON-body). Structureer de transcriptie zodat elk verzoek/antwoord-paar duidelijk gelabeld is met de stap waartoe het behoort (step-a-ping.json,step-d-day-3-put.json,step-g-list-bookings.json, enzovoort). Plain-text.httpbestanden of een enkele.harexport zijn beide acceptabele formaten. -
UI-screenshot: actieve boeking. De screenshot uit Stap G die de certificeringsboeking toont in uw eigen PMS / channel-manager UI, met gast, data, kamertype, tariefplan en totaalbedrag duidelijk leesbaar.
-
UI-screenshot: geannuleerde boeking. De screenshot uit Stap H die dezelfde boeking toont in uw UI na annulering, met de geannuleerde status en timestamp duidelijk leesbaar.
-
Certificeringssamenvatting. Een korte
README.mdin het archief met:- De naam en versie van uw channel manager / PMS.
- De
managingEntityIdentifier,propertyIdentifier,masterRateIdentifierenbookingIdentifierdie u gebruikte. - De staging hotel slug (de
<your-slug>inhttps://staging-book.wink.travel/hotel/<your-slug>). - De datumbereik van de certificeringsweek (Dag 1 → Dag 7 in ISO-8601).
- De naam en e-mail van de engineer die de certificering uitvoerde.
Stuur het archief naar uw Wink-integratiecontact. Wink beoordeelt het, volgt eventuele
afwijkingen op en zet — bij goedkeuring — de status van uw Affiliate / Channel Manager-account om van
PENDING_APPROVAL naar ACTIVE. Uw integratie komt dan in aanmerking voor productie-onboarding.
Webhookmeldingen
Section titled “Webhookmeldingen”U kunt zich abonneren op channel manager webhook-events om realtime meldingen te ontvangen:
channel-manager.update.rate— Tariefupdate ontvangen.channel-manager.update.availability— Beschikbaarheidsupdate ontvangen.channel-manager.update— Algemene channel manager update.
Zie de Webhook Events Catalog voor details.
Verder lezen
Section titled “Verder lezen”- Channel Manager API — Volledige API endpoint-documentatie.
- Channel manager — Beheer van tariefaanbieders in het Extranet.
- Webhook Events Catalog — Alle abonneerbare events.
- Build on Wink — Platformoverzicht voor ontwikkelaars.
