# Järjestelmäsi lukevat ja kirjoittavat suoraan STRYK-järjestelmään.

Canonical: https://staystryk.com/fi/features/api-integrations/
Language: fi

Jokaisella hotellilla on järjestelmiä, joiden pitää jäädä käyttöön: ravintolakassa, oma varausverkkosivu, raportointi. STRYK yhdistää ne dokumentoitujen…

## Dokumentoidut liittymät CSV-viennin sijaan: kassat, varausverkkosivut ja omat järjestelmäsi työskentelevät samoilla varauksilla.

- Partner API hotellille, kategorioille, yksiköille, hinnoille, saatavuudelle ja päivähinnoille
- Varausten luominen, lukeminen, peruuttaminen sekä yhteystietojen ja muistiinpanojen muokkaus
- Vieraiden, maksutilanteen ja laadittujen laskujen lukeminen
- Kassaliittymä huoneeseen kirjattaville erille, avoimen OpenAPI-viitteen kanssa
- Allekirjoitetut webhookit varauksille, vieraille, saatavuudelle, hinnoille ja maksuille
- Avain kullekin hotellille oikeuksineen, voimassaoloineen ja IP-sallittulistoineen

## API ja integraatiot

- Partner API
- Kassaliittymä (POS-API)
- Webhookit
- Avaimet ja oikeudet
- Kehittäjäportaali
- OpenAPI-viite

## Tyypilliset tilanteet

- Oma varausverkkosivu: Sivu kysyy saatavuutta, hintoja ja päivähintoja, pyytää STRYKiä laskemaan tarjouksen ja luo varauksen. Parametrilla ”notifyGuest” STRYK lähettää vieraalle tutun varausvahvistuksen. Varaus alkaa avoimella saldolla; maksu kerätään hotellin maksutavoilla.
- Kassatoimittajat: Hae sisäänkirjautuneet huoneet, tunnista vieras huonenumeron perusteella, kirjaa ja peru erät yksitellen tai enintään 50 kerralla, kunhan niitä ei ole laskutettu. Jos huonenumero ei ole yksiselitteinen, STRYK kysyy tarkennuksen eikä arvaa.
- Raportointi ja omat järjestelmät: IT:si hakee varaukset, vieraat, maksutilanteen ja laaditut laskut pelkällä lukuavaimella. Webhookit ilmoittavat muutokset heti, eikä järjestelmäsi tarvitse kysellä muutaman minuutin välein.

![STRYK Preise: Die Rezeption legt eine Preisregel an, die das Panorama Studio freitags und samstags um 10 % erhöht. Nach dem Speichern zeigt der Preiskalender sofort die neuen Wochenendpreise.](https://staystryk.com/live-scenes/assets/pricing-placeholder.webp)

![STRYK Housekeeping: Ewa Nowak öffnet Zimmer 105, startet die Reinigung, hakt die vier Punkte der Checkliste ab und schließt sie ab. Das Zimmer steht erledigt für die Anreise bereit.](https://staystryk.com/live-scenes/assets/housekeeping-placeholder.webp)

![STRYK Housekeeping: Eine Reinigungskraft öffnet Zimmer 105, hakt die Aufgaben ab und schließt das Zimmer ab. Es steht fertig für die Anreise bereit.](https://staystryk.com/live-scenes/assets/housekeeping-focus-placeholder.webp)

## Mitä hotellinpitäjät kysyvät meiltä ennen vaihtoa.

### Mistä löydän tekniset dokumentit?

STRYK-kehittäjäportaalissa osoitteessa /developers: aloitus, todennus, oikeudet, päätepisteet, webhookit, virheet ja pyyntömäärärajoitukset. Kassaliittymän OpenAPI-viite on siellä saatavilla YAML- ja JSON-muodossa.

### Mitä Partner API osaa?

Lukea hotellin, huonetyyppien, yksiköiden, hintojen, saatavuuden ja päivähintojen tiedot, laskea tarjouksia, lukea, luoda ja peruuttaa varauksia sekä muuttaa yhteystietoja ja muistiinpanoja. Lisäksi lukea vieraita ja muuttaa heidän yhteystietojaan sekä lukea maksutilanteen ja laaditut laskut. Kirjoitusoikeuksilla se asettaa lisäksi yksiköiden siivoustilan ja saatavuuden estot sekä päivähinnat ja kirjaa saapuneet tilisiirrot laskuille.

### Miten saan avaimen?

Hotellin ylläpitäjä luo avaimen STRYKissä kohdassa Kanavat → API ja valitsee oikeudet, esimerkiksi vain saatavuuden ja hintojen lukemisen. Jokainen avain kuuluu täsmälleen yhdelle hotellille.

### Mitä liittymien käyttö maksaa?

Dokumentaatio on kehittäjille ilmainen. Partner API kuuluu hotellin STRYK-perushintaan ilman lisämoduulia. Kassojen liittäminen kuuluu STRYK POS -lisämoduuliin.

### Mitä webhookeja on?

booking.created, booking.updated, booking.cancelled, guest.updated, availability.changed, rate.changed, payment.updated, unit.updated ja webhook.test. Jokainen toimitus on allekirjoitettu HMAC:lla, ja se yritetään automaattisesti uudelleen virheen sattuessa.

### Miten pääsy on suojattu?

Jokainen avain kuuluu täsmälleen yhdelle hotellille, sillä on omat oikeudet, voimassaolo ja halutessa IP-sallittulista. Webhookit on allekirjoitettu HMAC:lla, pyynnöt on rajattu määrällisesti, ja hotelli voi peruuttaa avaimen milloin tahansa.

### Miten maksut toimivat API:n kautta tehdyissä varauksissa?

Maksut kerää hotelli STRYK Paymentsin ja sen määritettyjen maksutapojen kautta; korttitiedot säilyvät siellä. Uusissa API:n kautta luoduissa varauksissa on alussa avoin saldo, jonka hotelli perii maksulinkillä, verkossa tai kortinlukijalla. Maksutilanteen luet API:sta, ja kirjoitusoikeudella se kirjaa saapuneet tilisiirrot laskulle.

### Mitkä kassat sopivat STRYKiin?

Ei. Emme nimitä yhtään yhteyttä ”sertifioiduksi” emmekä yhtään brändiä ”tuetuksi”, ennen kuin valmis yhteys on todistettu. Kysy meiltä järjestelmäsi tilanne.

## Lue lisää

- [STRYK POS: kassakulut huoneelle](https://staystryk.com/fi/features/pos/)
- [Channel Manager](https://staystryk.com/fi/features/channels/)
- [Tietosuoja ja käyttöoikeudet](https://staystryk.com/fi/features/security/)
- [Tietojen siirto](https://staystryk.com/fi/features/data-import/)
