# Reservierungssystem (Hürlimann Informatik)

## Allgemein

Mit dem Reservierungssystem von Hürlimann Informatik können Räumlichkeiten und Geräte verwaltet und von Kunden online reserviert werden. Die Web-Applikation wird mit Full-Service angeboten: Dienstleistungen wie Wartung und Support sind im Preis inbegriffen. Durch die entsprechende Integration können die Kunden über die Zahlungslösung von Payrexx bezahlen.

### Links

* Webseite von [Hürlimann Informatik](https://www.hi-ag.ch/)
* Informationen über das [Reservationssystem](https://www.hi-ag.ch/reservationssystem)

### Funktionen

* ✅ Gleichzeitiges Anzeigen von Kalendern mehrerer Objekte
* ✅ Serienreservierungen (täglich, wöchentlich oder jährlich)
* ✅ Echtzeit-Übertragung von Reservierungen in den Kalender
* ✅ Reservierungen als registrierter Benutzer oder als Gast
* ✅ Bezahlung über die Zahlungslösung von Payrexx

{% hint style="info" %}
Bitte beachte, dass die Integration nur in den Preisplänen Standard und Premium verfügbar ist. [Weitere Informationen](https://payrexx.com/de-ch/preise)
{% endhint %}

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2Fq29YOR1Q5I8GyVXKbYxw%2Fimage.png?alt=media&#x26;token=d873b253-8dd0-4ded-87ef-ebb3650173e8" alt=""><figcaption><p>Screenshots aus dem Reservierungssystem von Hürlimann Informatik</p></figcaption></figure></div>

## Integration

In den nächsten Kapiteln erfährst Du, wie Du die Zahlungslösung von Payrexx ins Reservierungssystem von Hürlimann Informatik integrierst.

### Konfiguration von Payrexx

{% hint style="info" %}
Bitte beachte, dass Du bei Payrexx [eingeloggt](https://login.payrexx.com/de) sein musst, bevor Du beginnst. Falls Du noch kein Konto hast, [registriere](https://signup.payrexx.com/de/email-validation/) Dich bitte bei Payrexx.
{% endhint %}

#### Erstellen eines API-Schlüssels

* Navigiere im Hauptmenü Deiner Händler-Administration zu **API und Integrationen**.
* Scrolle hinunter zu "API-Integration hinzufügen" und klicke auf "API-Schlüssel hinzufügen":

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FLuGgWYbJWxQiDQzvAcwj%2Fimage.png?alt=media&#x26;token=1bd4a4f8-3ad8-4ddb-b7eb-ef3ad88c15f2" alt=""><figcaption><p>Hinzufügen eines API-Schlüssels in Payrexx</p></figcaption></figure></div>

* Gib der Integration einen beliebigen Namen, zum Beispiel "Reservationssystem".
* Klicke auf "Hinzufügen":

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FG1XkxqLOvtqlvFVXyLHR%2Fimage.png?alt=media&#x26;token=bb8ae06e-9b8c-4b0f-927c-3290464dad0d" alt="" width="563"><figcaption><p>Erstellen eines API-Schlüssels in Payrexx</p></figcaption></figure></div>

#### Hinzufügen eines Webhooks

* Navigiere im Hauptmenü Deiner Händleradministration zu **Webhooks**.
* Klicke auf "Webhook hinzufügen".
* Konfiguriere den Webhook anhand des folgenden Beispiels:

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2F64g8R5X6shXb1KQMbpH0%2Fimage.png?alt=media&#x26;token=f51cfa0d-483c-442a-98c2-7337df4180ad" alt="" width="563"><figcaption><p>Konfiguration des Webhooks in Payrexx</p></figcaption></figure></div>

1. **Name:** Vergib einen beliebigen Namen, beispielsweise "Reservationssystem".
2. **Webhook URL:** Trage die Webhook-URL ein, die Du im Reservationssystem unter **Bezahlwesen > Bezahlanbieter > Webhooks** findest.
3. **Ereignisse:** Aktiviere alle vier Checkboxen.
4. **Inhaltstyp und Version:** Wähle als Inhaltstyp "JSON" und als Webhook-Version "2021-10-12".

Schliesse die Konfiguation ab, indem Du auf "Hinzufügen" klickst.

#### Technischen Kontakt eintragen

* Navigiere im Hauptmenü Deiner Händleradministration zu **Webhooks**.
* Erfasse auf der rechten Seite des Fensters anhand des folgenden Beispiels einen technischen Kontakt:

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FcjLPrnCCtnmqvtDnxl2s%2Fimage.png?alt=media&#x26;token=3796271c-1d76-4a7d-8a8b-7511a290564d" alt="" width="216"><figcaption><p>Erfassung des technischen Kontakts</p></figcaption></figure></div>

1. **Name:** Verwende als Namen "HiAG Web Admin".
2. **E-Mail:** Trage die E-Mail-Adresse ein, die Du im Reservationssystem unter **Bezahlwesen > Bezahlanbieter > Technischer Kontakt** findest.

### Konfiguration des Reservationssystems

{% hint style="info" %}
Bevor Du mit der Konfiguration beginnen kannst, musst Du bei Hürlimann Informatik das Zusatzmodul "Online-Zahlungen" bestellen. Kontaktiere hierfür einen [Verkaufsberater](https://www.hi-ag.ch/reservationssystem).
{% endhint %}

Nach der Aktivierung des Moduls kannst Du mit dessen Konfiguration fortfahren.

* Logge Dich ins Reservationssystem ein.
* Navigiere zu **Bezahlwesen > Bezahlanbieter** und folge den Schritten in der untenstehenden Anleitung.

#### Schritt 2: Anbieter

* Wähle als Anbieter Payrexx aus und klicke auf "Weiter".

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FcCnyqgdI4s28hRjVohoK%2Fimage.png?alt=media&#x26;token=86c90f61-fd8e-499c-b58b-70b5425ad168" alt=""><figcaption><p>Auswahl von Payrexx als Bezahlanbieter im Reservationssystem</p></figcaption></figure></div>

#### Schritt 3: Instanz

* Erfasse den Namen Deiner Payrexx-Instanz und klicke auf "Weiter".

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FbCWk9iGbKrkkrbqwVPbP%2Fimage.png?alt=media&#x26;token=1320ffff-67a2-457e-8de5-ce3f335b6164" alt=""><figcaption><p>Erfassen der Instanz aus Payrexx im entsprechenden Feld</p></figcaption></figure></div>

* Den Instanznamen findest Du in Deinem Payrexx-Konto unter **Einstellungen > Allgemein**, unterhalb von "Domain". Als Instanz gilt die Zeichenfolge zwischen https\:// und payrexx.com. Im folgenden Beispiel lautet der Instanzname "demo".

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2F0l9QzbcOioXBPxoAhznd%2Fimage.png?alt=media&#x26;token=f54c4cdb-0b2d-42ce-a30e-ca5406a45161" alt="" width="293"><figcaption><p>Anzeige des Instanznamens in Payrexx</p></figcaption></figure></div>

#### Schritt 4: API-Schlüssel

* Erfasse den Wert des in Payrexx erstellten API-Schlüssels und klicke auf "Weiter".

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FBupnisA4vlDGpVQ4tySV%2Fimage.png?alt=media&#x26;token=044fac4b-00c3-4b57-9423-42c99475ebf2" alt=""><figcaption><p>Erfassen des API-Schlüsels aus Payrexx im entsprechenden Feld</p></figcaption></figure></div>

* Du findest den API-Schlüssel in Deinem Payrexx-Konto unter **API und Integrationen**, wo Du ihn in die Zwischenablage kopieren kannst:

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FNmSmRS3gTQxsI9VEXPGs%2Fimage.png?alt=media&#x26;token=6359fc1e-2db3-4d90-9eb8-e2422e24366c" alt=""><figcaption><p>Kopieren des API-Schlüssels in die Zwischenablage</p></figcaption></figure></div>

#### Schritt 7: Abschluss

* Klicke auf "Konfiguration speichern":

<figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FoLTYwNwPOIBMlHdhTNtu%2Fimage.png?alt=media&#x26;token=94a57d86-e74a-4fa6-bea4-2dd24fc6b87a" alt=""><figcaption><p>Abschluss der Konfiguration im Reservierungssystem von Hürlimann Informatik</p></figcaption></figure>

{% hint style="success" %}
Die Integration von Payrexx ins Reservierungsystem von Hürlimann Informatik ist abgeschlossen.
{% endhint %}