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. Apaleo meldet Reservierungs- und Folio-Änderungen in Echtzeit über Webhooks an LIKE MAGIC. LIKE MAGIC überwacht, ob diese Meldungen weiterhin eintreffen, und unser Team wird benachrichtigt, wenn sie ausbleiben. Wir stellen dann die Verbindung wieder her und synchronisieren die betroffenen Reservierungen erneut. Dein Team muss dafür nichts einrichten. Erscheint eine neue, geänderte oder stornierte Reservierung aus Apaleo nicht in LIKE MAGIC, fordere über eine Support Anfrage eine Prüfung der Verbindung an.

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?