Skip to content

Dodajte Vaš Channel Manager

Ovaj vodič vodi developere channel managera i PMS-a kroz ceo proces integracije sa Wink-om — od kreiranja naloga do mapiranja inventara i pokretanja prvog end-to-end testa.

Channel Manager (Integrations) API je dostupan u dva okruženja. Koristite staging za sav razvoj i sertifikaciju; pređite na produkciju samo prilikom puštanja u rad.

OkruženjeOsnovni URL
Produkcijahttps://integrations.wink.travel
Staginghttps://staging-integrations.wink.travel

Channel Manager API prati OTA protokol standarde (SOAP/XML) radi kompatibilnosti sa postojećim hotelskim sistemima. Počnite pregledom dokumentacije partner endpointa:

Channel Manager API — Partner endpointi

  1. Kreirajte Wink korisnički nalog

    Registrujte se na staging-app.wink.travel. Svi koraci u nastavku koriste staging — ceo proces ćete ponoviti i u produkciji pre puštanja u rad.

  2. Kreirajte Affiliate / Channel Manager nalog

    Pod novim korisnikom kreirajte nalog i izaberite tip naloga Affiliate / Channel Manager. Ovo je nalog pod kojim će se vaša integracija autentifikovati.

  3. Registrujte aplikaciju i kreirajte prvi token

    Kreirajte Aplikaciju i povežite je sa channel manager nalogom iz koraka 2. Izaberite MACHINE_2_MACHINE kao tip klijenta — ovo je server-to-server integracija bez krajnjeg korisnika za preusmeravanje. Odmah kopirajte Client ID i Secret Key; tajni ključ se prikazuje samo jednom i ne može se ponovo dohvatiti.

    Aplikacija kreira bearer token koji svaki poziv u ovom vodiču nosi kao Authorization: Bearer <access_token>. Zamenite svoje kredencijale za token koristeći client_credentials grant na https://staging-iam.wink.travel/oauth2/token, tražeći scope-ove integrations.read integrations.write. Uradite ovo pre nego što nastavite — ne možete dohvatiti identifikatore naloga niti pristupiti bilo kom Channel Manager endpointu bez tokena. Pogledajte Authentication za ceo tok, produkcioni host i kompletan katalog scope-ova.

  4. Kreirajte Hotel nalog

    Pod istim korisnikom kreirajte drugi nalog i izaberite tip naloga Hotel. Ovo vam daje objekat koji možete koristiti za testiranje bez uključivanja pravog hotela.

  5. Potvrdite da su oba naloga odobrena

    Nijedan nalog ne može se koristiti dok nije odobren: neodobren channel manager nalog se ne pojavljuje na listi channel managera hotela, a neodobren hotel nije dostupan preko API-ja.

    • Staging — odobrenje je automatsko. Oba naloga su upotrebljiva odmah po kreiranju i nije potrebno ništa tražiti.
    • Produkcija — odobrenje je ručno. Pošaljite Wink kontaktu za integracije imena oba naloga i korisnika pod kojim su kreirani, pa sačekajte potvrdu pre nastavka.
  6. Povežite oba naloga

    Prijavite se na Hotel nalog i idite na Channels → Channel manager. Izaberite vaš channel manager nalog sa liste — ovo povezuje objekat sa vašom integracijom. Ako vaš nalog nije na listi, još nije odobren; pogledajte korak 5.

  7. Kreirajte osnovnu vrstu sobe i plan cena

    U okviru Hotel naloga kreirajte bar jednu vrstu sobe i jedan plan cena. Ovo je neophodno pre nego što vaša integracija može da šalje cene i dostupnost ili povlači rezervacije.

  8. Mapirajte i testirajte

    U svom sistemu mapirajte identifikatore vrste sobe i plana cena koje vraća API. Pošaljite ažuriranje cena i dostupnosti, zatim napravite test rezervaciju i proverite da li endpoint za dohvat rezervacija ispravno vraća podatke.

Pronalaženje identifikatora vašeg naloga

Section titled “Pronalaženje identifikatora vašeg naloga”

Svaki Channel Manager API put je ograničen na vaš nalog:

/api/managing-entity/{managingEntityIdentifier}/channel-manager/...

{managingEntityIdentifier} je ID naloga (UUID) vašeg channel manager naloga — ne hotela. Dohvatite ga, zajedno sa ID-jem i trenutnim statusom svih ostalih naloga koje poseduje vaš korisnik, iz Platform API-ja:

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"

Odgovor je niz naloga koje posedujete:

[
{
"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š Test Objekat",
"urlName": "your-test-property",
"status": "ACTIVE"
}
]
  • id unosa channel managera je vaš {managingEntityIdentifier}.
  • id unosa HOTEL je vaš {propertyIdentifier}.
  • status je mesto gde potvrđujete da je svaki nalog odobren — najkorisnije u produkciji, gde je odobrenje ručno. Hotel mora imati status ACTIVE pre nego što može biti rezervisan ili vidljiv Channel Manager API-ju. Vaš channel manager nalog će i dalje imati status PENDING_APPROVAL dok ne prođete Sertifikaciju; to je očekivano i ne blokira razvoj.

Sertifikacija je način da dokažete — i da Wink potvrdi — da vaša integracija ispravno mapira inventar, šalje cene i dostupnost i prima rezervacije end-to-end. Dizajnirana je da bude samouslužna: svaki korak pokrećete iz svog sistema i na kraju dostavljate jedan paket dokaza. Wink pregleda paket i, ako je uspešan, menja status vašeg Affiliate / Channel Manager naloga sa PENDING_APPROVAL na ACTIVE.

Sertifikacija se u potpunosti izvodi u staging okruženju (https://staging-integrations.wink.travel). Ništa u ovom delu ne dira produkciju.

  1. Autentifikacija. Vaš OAuth2 klijent može da dobije access token i uspešno pozove /ping endpoint za vaš Affiliate / Channel Manager nalog.

  2. Mapiranje inventara. Možete da izlistate hotel(e) povezane sa vašim nalogom, dohvatite master cenu (kombinaciju vrste sobe i plana cena) koju ste konfigurisali i ispravno identifikujete masterRateIdentifier na koji će vaš sistem ciljati.

  3. Slanje cena i dostupnosti. Možete nezavisno ažurirati svih sedam dana sertifikacione nedelje — različite kombinacije iznosa, količine, zastavica zatvaranja na dolazak / odlazak i minimalne/maksimalne dužine boravka za svaki dan — i pročitati tačne vrednosti nazad iz Winka.

  4. Povlačenje rezervacije. Možete dohvatiti pravu staging rezervaciju napravljenu za vaš test objekat, prikazati je u svom PMS/CM UI sa tačnim podacima o boravku, gostu i ukupnoj sumi, zatim odraziti otkazivanje kada Wink označi rezervaciju kao otkazanu.

Pre nego što započnete sertifikaciju, završite korake 1–7 iz Koraka integracije tako da imate:

  • Wink korisnika na stagingu sa Affiliate / Channel Manager nalogom i Hotel nalogom povezanima (Channels → Channel manager). Staging nalozi se odobravaju automatski, tako da nema potrebe za zahtevima.
  • Bar jednu vrstu sobe i jedan plan cena kreirane u okviru Hotel naloga. Objavite hotel da bude rezervabilan na https://staging-book.wink.travel/hotel/<your-slug>.
  • Registrovanu aplikaciju pod vašim Affiliate / Channel Manager nalogom sa Client ID, Secret Key i scope-ovima integrations.read integrations.write (pogledajte Authentication).
  • managingEntityIdentifier vašeg Affiliate / Channel Manager naloga i propertyIdentifier vašeg Hotel naloga (oba su UUID — pogledajte Pronalaženje identifikatora vašeg naloga).

Svaki zahtev u ovom delu koristi sledeće zaglavlja:

Authorization: Bearer <access_token>
Wink-Version: 2.0
Accept: application/json
  • <access_token> dolazi iz client_credentials granta na https://staging-iam.wink.travel/oauth2/token — pogledajte Authentication.
  • Zaglavlje Wink-Version je obavezno; izostavljanje neće usmeriti zahtev na v2 JSON API.
  • Content-Type: application/json se dodaje na PUT zahtevima koji nose telo.

U primerima ispod, zamenite placeholder-e vrednostima koje ste prikupili u Preduslovima:

PlaceholderZnačenje
{managingEntityIdentifier}ID vašeg Affiliate / Channel Manager naloga (UUID) — pogledajte Pronalaženje identifikatora vašeg naloga.
{propertyIdentifier}ID Hotel naloga (objekta) koji ste povezali sa CM nalogom.
{masterRateIdentifier}Master cena (kombinacija vrste sobe i plana cena) koju ćete sertifikovati.
{bookingIdentifier}ID staging rezervacije vraćen pozivom liste rezervacija.

Potvrdite da vaše kredencijale rešavaju na očekivani Affiliate / Channel Manager nalog.

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"

Očekivani odgovor:

{
"apiVersion": "2.0",
"name": "Ime Vašeg Channel Manager Naloga",
"status": "PENDING_APPROVAL"
}

Odgovor 200 sa odgovarajućim name signalizira da su autentifikacija i rešavanje naloga ispravni. status će biti PENDING_APPROVAL dok vas Wink ne sertifikuje.

Dohvatite paginiranu listu hotela povezanih sa vašim nalogom i potvrdite da je vaš test objekat prisutan.

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"

Odgovor je Spring Page sa ChannelManagerProperty unosima. Pronađite unos čiji identifier odgovara vašem {propertyIdentifier} i zabeležite njegov currencyCode — biće vam potreban za tumačenje ažuriranja cena u Koraku D.

Dohvatite objekat zajedno sa svim master cenama (kombinacijama vrste sobe i plana cena) koje objavljuje. Izaberite onu za koju ćete raditi sertifikaciju i zabeležite njen identifier kao vaš {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"

Odgovor je omotač PropertyWithRoomRateList: blok property plus niz rooms sa PropertyRoomRate unosima. Svaki unos prikazuje vrstu sobe, plan cena, limite popunjenosti, osnovnu cenu i modifikatore cena koje ćete sačuvati prilikom slanja dnevnih cena.

Korak D — Učitajte sertifikacionu nedelju

Section titled “Korak D — Učitajte sertifikacionu nedelju”

Učitajte sedmodnevni kalendar cena koji pokriva prvih sedam kalendarskih dana meseca nakon meseca u kojem započinjete sertifikaciju. Na primer, ako počnete sertifikaciju 21. avgusta, ciljajte od 1. do 7. septembra.

Poslaćete sedam zasebnih PUT poziva — po jedan za svaki dan — gde je startDate == endDate. Svaki dan nosi namerno različitu kombinaciju iznosa, količine, zastavica zatvaranja na dolazak / odlazak i ograničenja dužine boravka tako da se svaki zapis može testirati bar jednom. Vrednosti su u valuti objekta (zabeleženoj u Koraku B); izostavite currencyCode i podrazumevano će biti ispravno.

DanIznosKoličinaclosedOnArrivalclosedOnDepartureminLengthOfStaymaxLengthOfStayŠta dokazuje
1100.005falsefalse130Osnovni dan.
2125.004falsefalse114Promena iznosa + količine + maxLengthOfStay.
3150.003truefalse130Promena closedOnArrival.
4175.002falsetrue27Promena closedOnDeparture + uži period boravka.
5200.000falsefalse130Količina rasprodata.
6225.005falsefalse35Restriktivni period boravka.
7250.001falsefalse130Dostupnost poslednje sobe.

Telo zahteva za Dan 1 izgleda ovako. Ponavljajte, prilagođavajući startDate / endDate / vrednosti po redu, za Dane 2 do 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
}'

Svaki PUT vraća 200 sa nizom ažuriranih PropertyRate unosa za poslati opseg (jedan unos kada je startDate == endDate). Sačuvajte taj odgovor — biće deo vašeg dokaza.

Korak E — Pročitajte nazad sertifikacionu nedelju

Section titled “Korak E — Pročitajte nazad sertifikacionu nedelju”

Dohvatite celu nedelju jednim pozivom i potvrdite da se vrednosti za svaki dan poklapaju sa onima koje ste poslali u Koraku D — uključujući boolean zastavice i period dužine boravka.

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"

Odgovor je PropertyRoomRateWithRateList. Njegov niz rates mora sadržati sedam unosa, po jedan za svaki dan, svaki sa amount, quantity, closedOnArrival, closedOnDeparture, minLengthOfStay i maxLengthOfStay koje ste učitali. Svaka neusaglašenost znači da odgovarajući PUT iz Koraka D nije uspeo — ispravite i ponovo proverite pre nastavka.

Otvorite sledeći URL u pregledaču, zamenjujući <your-slug> slugom Hotel naloga koji ste objavili u Preduslovima:

https://staging-book.wink.travel/hotel/<your-slug>

Izaberite datum dolaska i odlaska koji su u potpunosti unutar sertifikacione nedelje, izaberite kombinaciju vrste sobe i plana cena koju ste sertifikovali i završite rezervaciju. Staging koristi test put plaćanja — nema stvarnog terećenja kartice.

Kada se prikaže stranica sa potvrdom, zabeležite kod rezervacije (format WNKxxxxx) prikazan gostu.

Dohvatite sve rezervacije napravljene za vaš test objekat u periodu koji obuhvata vreme rezervacije.

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"

Pronađite unos čiji bookingCode odgovara kodu koji ste zabeležili u Koraku F. Zabeležite njegov bookingIdentifier. Zatim dohvatite tu pojedinačnu rezervaciju:

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"

Odgovor je PropertyBooking. Uvezite ga u svoj PMS / channel-manager UI i potvrdite da se svaki od sledećih podataka ispravno prikazuje operateru:

  • bookingCode, bookingIdentifier, createdDate
  • Gost: firstName, lastName, email
  • totalAmount + currencyCode (neto iznos koji hotel prima za sve sobe)
  • paymentMethodType, paymentMethodStatus, salesChannelName
  • Svaki unos u roomStays: guestRoomName, ratePlanName, adults, children, startDate, endDate i po sobi amount

Napravite snimak ekrana rezervacije kako se prikazuje u vašem UI — taj snimak je jedan od potrebnih dokaza.

Korak H — Otkažite rezervaciju i potvrdite

Section titled “Korak H — Otkažite rezervaciju i potvrdite”

Zamolite Wink tim da otkaže sertifikacionu rezervaciju u vaše ime (ili je otkažite sami iz Extraneta Hotel naloga ako imate tu dozvolu). Zatim ponovo dohvatite istu rezervaciju pozivom iz Koraka G.

Potvrdite da odgovor sada prikazuje:

  • cancelled: true
  • Popunjen cancelDate timestamp
  • paymentMethodStatus koji odražava status otkazivanja (CANCELLED, PARTIALLY_REFUNDED ili FULLY_REFUNDED u zavisnosti od politike povraćaja)

Uvezite ažuriranu rezervaciju u svoj UI i potvrdite da je otkazivanje vidljivo operateru — status, vreme otkazivanja i bilo koji indikator povraćaja koji vaš UI podržava. Napravite drugi snimak ekrana otkazane rezervacije u vašem UI. Ovo je završni dokaz.

Spakujte sledeće u jedan arhivski fajl (.zip) nazvan wink-cert-<your-channel-manager-name>-<yyyy-mm-dd>.zip:

  1. API transkript. Za svaki zahtev koji ste poslali u Koracima A do H, zabeležite kompletan HTTP zahtev (metod, URL, zaglavlja sa Authorization vrednošću izostavljenom i JSON telo za PUT pozive) i kompletan HTTP odgovor (status kod, zaglavlja i JSON telo). Organizujte transkript tako da svaki par zahtev/odgovor bude jasno označen korakom kojem pripada (step-a-ping.json, step-d-day-3-put.json, step-g-list-bookings.json itd.). Prihvatljivi su plain-text .http fajlovi ili jedan .har eksport.

  2. Snimak ekrana UI: aktivna rezervacija. Snimak iz Koraka G koji prikazuje sertifikacionu rezervaciju u vašem PMS / channel-manager UI, sa jasno vidljivim gostom, datumima, vrstom sobe, planom cena i ukupnim iznosom.

  3. Snimak ekrana UI: otkazana rezervacija. Snimak iz Koraka H koji prikazuje istu rezervaciju u vašem UI nakon otkazivanja, sa jasno vidljivim statusom otkazivanja i vremenom.

  4. Sertifikacioni rezime. Kratki README.md unutar arhive koji navodi:

    • Ime i verziju vašeg channel managera / PMS-a.
    • managingEntityIdentifier, propertyIdentifier, masterRateIdentifier i bookingIdentifier koje ste koristili.
    • Staging slug hotela (deo <your-slug> u https://staging-book.wink.travel/hotel/<your-slug>).
    • Datumsku nedelju sertifikacije (Dan 1 → Dan 7 u ISO-8601 formatu).
    • Ime i email inženjera koji je izvršio sertifikaciju.

Pošaljite arhivu svom Wink kontaktu za integracije. Wink će pregledati, pratiti eventualne neslaganja i — ako je uspešno — promeniti status vašeg Affiliate / Channel Manager naloga sa PENDING_APPROVAL na ACTIVE. Vaša integracija tada može da započne produkcionu integraciju.

Možete se pretplatiti na webhook događaje channel managera da biste primali obaveštenja u realnom vremenu:

  • channel-manager.update.rate — Primljeno ažuriranje cene.
  • channel-manager.update.availability — Primljeno ažuriranje dostupnosti.
  • channel-manager.update — Opšte ažuriranje channel managera.

Pogledajte Webhook Events Catalog za detalje.