Zum Hauptinhalt springen

Apaleo (Verbindung einrichten)

Um LIKE MAGIC mit dem PMS Apaleo zu verbinden, wird eine sogenannte Custom App benötigt. Diese Anleitung zeigt dir Schritt für Schritt, wie du diese Verbindung korrekt einrichtest.

hinweis

Reservierungen synchron halten: automatischer Pull-Fallback. Apaleo meldet Reservierungs- und Folio-Änderungen normalerweise in Echtzeit über Webhooks (Push) an LIKE MAGIC. Sind diese Webhook-Benachrichtigungen verzögert oder unterbrochen, wechselt LIKE MAGIC automatisch dazu, die Änderungen in einem kurzen Abfrageintervall direkt von Apaleo abzuholen (Pull), und schaltet zurück auf Webhooks, sobald die Zustellung wieder funktioniert. Dieser Fallback ist standardmässig aktiv und läuft im Hintergrund. Dein Team muss nichts umschalten, und bei einer Webhook-Störung von Apaleo ist keine Aktion nötig. Reservierungen und Folios bleiben in beiden Fällen synchron.

1. Voraussetzungen​

  • Du benötigst Account Admin-Rechte in deinem Apaleo Konto.
  • Stelle sicher, dass du dich auf Account-Ebene befindest.

2. Anleitung​

a) Custom App hinzufügen​

  1. Navigiere im Hauptmenü zu Apps > Connected Apps
  2. Klicke auf Add a new app
  3. Wähle Add custom app

Die Seite Connected apps in Apaleo mit dem Link Add a new app

Der Bereich Apps in der Apaleo-Navigation, aufgeklappt mit Connected apps

Das Dropdown Context der neuen App, gesetzt auf Account

b) Custom App konfigurieren​

Fülle die Felder wie folgt aus:

FeldWert
Client codeLIKEMAGIC
Client nameLIKEMAGIC
Personally identifiable informationRetrieve
Secret descriptionLIKE MAGIC PMS Connection

Das Formular der Custom App mit Client code und Client name auf LIKEMAGIC, Personally identifiable information auf Retrieve samt den zurückgegebenen Gastfeldern als JSON, und einem Secret mit der Beschreibung LIKE MAGIC PMS Connection

c) Scopes der Schnittstelle definieren​

Core API

Aktiviere alle Scopes mit Ausnahme von:

  • folios.payment-with-charges (bitte deaktivieren)

Die Scope-Liste der Core API mit allen Scopes angehakt ausser dem hervorgehobenen folios.payment-with-charges

Neu seit Februar 2026

Seit dieser Apaleo-Community-Ankündigung zur Abkündigung der Felder paymentAccount und accountOwner sind zusätzlich diese Core-API-Scopes erforderlich:

  • Core API > payment-accounts.manage
  • Core API > payment-accounts.read

Die beiden payment-accounts-Scopes, ausgewählt in der Scope-Liste der Core API

Aktiviere für die folgenden APIs alle Scopes:

  • Payment API
  • Distribution API
  • Identity API
  • Fiscalization API
  • Profile API

Die Scope-Übersicht je API: Core API mit 46 von 47, Payment, Distribution, Identity, Integration, Fiscalization und Profile vollständig aktiviert, MCP server mit keinem

d) Zugangsdaten übermitteln​

  1. Klicke auf Save
  2. Anschliessend werden dir zwei Schlüssel angezeigt:
  • ClientId
  • ClientSecret

Das Popup mit den erzeugten Schlüsseln ClientId und ClientSecret

warnung

Wichtig: Bitte sende uns diese Zugangsdaten aus Sicherheitsgründen nicht per E-Mail, sondern ausschliesslich über einen sicheren Einweg-Link, zum Beispiel onetime.secret.

Was this article helpful?