Wenn deine Gäste in der Duve-App eine Zimmerreinigung anfordern oder auslassen, erscheinen die gewählten Tage an ihrer Buchung in Sweeply, und das Zimmer landet am richtigen Tag im Housekeeping-Plan. An der Rezeption muss niemand etwas eintippen. In diesem Artikel erfahren Hotel-Admins, wie sie Duve mit Sweeply verbinden.
Bevor du loslegst
Du brauchst die Admin-Rolle in Sweeply.
Integrationen sind nicht im Basic-Plan enthalten.
Jemand mit der Rolle Duve Manager muss die Webhooks in Duve einrichten. Nur ein Duve Manager kann Webhooks bearbeiten.
In Duve brauchst du ein eigenes Produkt, das Gäste bestellen, um eine Reinigung anzufordern, und – falls du das anbietest – eines, um eine Reinigung auszulassen. Notiere dir die ID jedes Produkts: Du findest sie auf der Einstellungsseite des jeweiligen Produkts in Duve.
Schritt 1: Den Duve-Schlüssel in Sweeply erstellen
Öffne Settings und wähle Integrations.
Suche Duve unter Add an integration, wähle Set up und dann Connect.
Lies How it connects und wähle dann Create key.
Wähle unter Your new Duve API key die Option Copy und bewahre den Schlüssel für Schritt 3 sicher auf. Der Schlüssel wird nur einmal angezeigt.
Mit dem Schlüssel lassen sich nur Reinigungswünsche von Gästen erfassen. Er kann nichts anderes in Sweeply lesen oder ändern.
Schritt 2: Sweeply mitteilen, welche Duve-Produkte Reinigungswünsche sind
Gib unter Duve product IDs die IDs im Feld Products that request a cleaning ein, eine pro Zeile.
Wenn du ein Produkt zum Auslassen einer Reinigung anbietest, gib seine ID im Feld Products that skip a cleaning ein.
Warte, bis Saved erscheint.
Sweeply nimmt nur Bestellungen für diese Produkte an. Solange du keins hinzugefügt hast, wird jede Bestellung abgelehnt. Ein Produkt kann nicht gleichzeitig eine Reinigung anfordern und auslassen.
Schritt 3: Die Webhooks in Duve einrichten
Die Checkliste Set up the webhooks in Duve in Sweeply zeigt alles, was du kopieren musst.
Erstelle in Duve einen Webhook für das Anlegen einer Bestellung für das Produkt, das eine Reinigung anfordert. Nutze die URL Requests a cleaning aus dem Bereich Endpoint URL.
Füge den Header hinzu. Duve hat getrennte Felder für Header-Name und -Wert: Kopiere Name und Value jeweils in ihr eigenes Feld.
Wähle unter Data Points die Optionen External ID, PMS External ID, Order details und Product Details. Wähle alles andere ab: Duve setzt standardmäßig Häkchen bei den Gastdaten, und Sweeply nutzt keine davon.
Grenze unter Order Type mit Add Condition den Auslöser auf dein Reinigungsprodukt ein. Ohne diese Bedingung würde zum Beispiel eine Frühstücks- oder Spa-Bestellung als Reinigungswunsch erfasst.
Erstelle einen zweiten Webhook für Order Cancelled / Order Denied mit derselben Bedingung, demselben Header und derselben URL, damit ein Gast einen Tag wieder zurücknehmen kann.
Wenn du ein Produkt zum Auslassen einer Reinigung anbietest, erstelle für dieses Produkt dieselben zwei Webhooks mit der URL Skips a cleaning.
Schritt 4: Prüfen, ob es funktioniert
Gib in Duve eine Testbestellung für einen Gast auf, der gerade bei dir wohnt.
Sieh in Sweeply unter Duve bei Last order received nach. Dort sollte stehen, dass die Bestellung empfangen und an der Reservierung des Gastes erfasst wurde.
Öffne die Buchung des Gastes: Das gewählte Datum ist dort eingetragen, und das Zimmer erscheint im Housekeeping-Plan für diesen Tag.
Steht bei Last order received, dass eine Bestellung nicht verwendet wurde, siehst du dort auch, was du ändern musst – zum Beispiel einen Datenpunkt, den du in Duve aktivieren, oder eine Produkt-ID, die du hinzufügen musst.
Den Schlüssel ändern
Wähle Rotate key, um einen neuen Schlüssel zu erstellen. Dein aktueller Schlüssel funktioniert weiter, während ein Duve Manager den neuen in alle Sweeply-Webhooks in Duve einfügt. Sobald Last order received den neuen Schlüssel zeigt, wähle beim alten Revoke. Webhooks, die noch einen widerrufenen Schlüssel senden, funktionieren sofort nicht mehr.
Gut zu wissen
Jede Bestellung fügt einen Tag hinzu. Ein Gast, der drei Tage bestellt, bekommt drei Tage an seiner Buchung.
Wird eine Bestellung in Duve storniert, wird nur dieser Tag entfernt.
Wird dieselbe Bestellung zweimal gesendet, wird sie nur einmal erfasst.
Das Datum muss eine Nacht des Aufenthalts sein, und die Buchung muss ein Zimmer haben.
Eine Buchung kann nicht gleichzeitig angeforderte und ausgelassene Reinigungstage haben.
Fragen
Eine Bestellung ist nicht angekommen. Was prüfe ich? Sieh zuerst bei Last order received nach: Dort steht, warum eine Bestellung nicht verwendet wurde. Zeigt es nichts an, prüfe in Duve, ob der Webhook den aktuellen Schlüssel und die richtige URL nutzt. Wende dich dann mit deinem Hotelnamen und der Reservierungsnummer der Bestellung an den Sweeply-Support.