Ga naar inhoud

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.

De Channel Manager (Integrations) API is beschikbaar in twee omgevingen. Gebruik staging voor alle ontwikkeling en certificering; schakel pas over naar productie bij livegang.

OmgevingBasis-URL
Productiehttps://integrations.wink.travel
Staginghttps://staging-integrations.wink.travel

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

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

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

  3. 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 de client_credentials grant tegen https://staging-iam.wink.travel/oauth2/token, met de scopes integrations.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.

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

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

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

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

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:

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"

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 id van de channel manager-entry is uw {managingEntityIdentifier}.
  • De id van de HOTEL-entry is uw {propertyIdentifier}.
  • status is waar u bevestigt dat elk account is goedgekeurd — vooral nuttig in productie, waar goedkeuring handmatig is. Het hotel moet ACTIVE lezen voordat het boekbaar is of zichtbaar voor de Channel Manager API. Uw channel manager-account blijft PENDING_APPROVAL lezen totdat u Certificering doorloopt; dat is verwacht en blokkeert de ontwikkeling niet.

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.

  1. Authenticatie. Uw OAuth2-client kan een access token verkrijgen en succesvol de /ping endpoint aanroepen tegen uw Affiliate / Channel Manager-account.

  2. Inventaris mapping. U kunt de aan uw account gekoppelde hotels opvragen, het master tarief (kamertype × tariefplan) ophalen dat u heeft geconfigureerd, en correct het masterRateIdentifier identificeren waarop uw systeem zich richt.

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

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

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 managingEntityIdentifier van uw Affiliate / Channel Manager-account en de propertyIdentifier van uw Hotel-account (beide UUID’s — zie Uw account-ID’s vinden).

Elke aanvraag in deze sectie gebruikt deze headers:

Authorization: Bearer <access_token>
Wink-Version: 2.0
Accept: application/json
  • <access_token> komt van de client_credentials grant tegen https://staging-iam.wink.travel/oauth2/token — zie Authenticatie.
  • De Wink-Version header is verplicht; zonder deze wordt niet naar de v2 JSON API gerouteerd.
  • Content-Type: application/json wordt toegevoegd bij PUT-verzoeken met een body.

In de voorbeelden hieronder corresponderen de placeholders met de waarden die u verzamelde in Vereisten:

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

Bevestig dat uw inloggegevens verwijzen naar het Affiliate / Channel Manager-account dat u verwacht.

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"

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.

Haal de gepagineerde lijst op van hotels die aan uw account gekoppeld zijn en bevestig dat uw testaccommodatie aanwezig is.

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"

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.

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

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"

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.

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.

DagBedragHoeveelheidclosedOnArrivalclosedOnDepartureminLengthOfStaymaxLengthOfStayWat het bewijst
1100,005falsefalse130Baseline dag.
2125,004falsefalse114Bedrag + hoeveelheid + maxLengthOfStay wijziging.
3150,003truefalse130closedOnArrival omkering.
4175,002falsetrue27closedOnDeparture omkering + strakkere verblijfsduur.
5200,000falsefalse130Uitverkocht hoeveelheid.
6225,005falsefalse35Restrictieve verblijfsduur.
7250,001falsefalse130Laatste 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.

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

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.

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"

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.

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.

Haal elke boeking op die voor uw testaccommodatie is gemaakt binnen een tijdsvenster dat de boekingstijd omvat.

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"

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:

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"

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

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 cancelDate timestamp
  • Een paymentMethodStatus die de annuleringsstatus weergeeft (CANCELLED, PARTIALLY_REFUNDED, of FULLY_REFUNDED afhankelijk 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.

Verpak het volgende in één archiefbestand (.zip) met de naam wink-cert-<uw-channel-manager-naam>-<jjjj-mm-dd>.zip:

  1. 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 voor PUT calls) 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 .http bestanden of een enkele .har export zijn beide acceptabele formaten.

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

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

  4. Certificeringssamenvatting. Een korte README.md in het archief met:

    • De naam en versie van uw channel manager / PMS.
    • De managingEntityIdentifier, propertyIdentifier, masterRateIdentifier en bookingIdentifier die u gebruikte.
    • De staging hotel slug (de <your-slug> in https://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.

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.