Wie verbinde ich bnbills mit Smoobu?

bnbills ist ein Partnerdienst für Gastgeber, die in Deutschland vermieten. Der Dienst erstellt für jede Buchung eine rechtskonforme Rechnung, kümmert sich um die Kurtaxe und überträgt die Ergebnisse an deine Buchhaltungssoftware. Die Verbindung richtest du in bnbills ein, nicht in Smoobu: Du kopierst einen API-Schlüssel aus dem Marktplatz von Smoobu und fügst ihn in deinem bnbills-Konto ein. Der Smoobu-Support hat keinen Einblick in dein bnbills-Konto. Fragen zu allem, was in bnbills passiert, richtest du deshalb an bnbills.

Bevor du beginnst

Das alles brauchst du, bevor du die Verbindung herstellst:

Zwei-Faktor-Authentifizierung in Smoobu aktiviert. bnbills setzt sie voraus. Klicke oben rechts auf dein Profil-Icon, öffne Account verwalten und aktiviere unter Einstellungen die Zwei-Faktor-Authentifizierung (2FA).
Ein bnbills-Konto. Du legst es auf der Website von bnbills an, nicht in Smoobu.
Deine Unterkünfte in Smoobu eingerichtet. Sobald die Verbindung steht, liest bnbills deine Buchungen und Unterkünfte aus Smoobu.

Was bnbills kostet

bnbills ist ein kostenpflichtiger Dienst mit eigenem Abonnement, getrennt von deinem Smoobu-Tarif. Die aktuellen Preise findest du auf der Website von bnbills.

Schritte

Öffne in Smoobu den Marktplatz und gehe auf Accounting & Legal. Klicke bei bnbills auf Mehr erfahren und dann auf Verbinden. Kopiere den API-Schlüssel, den Smoobu dir anzeigt.
Melde dich bei bnbills an. Gehe zu Anbindungen und wähle Quellplattform: Hinzufügen.
Wähle Smoobu aus der Liste der Plattformen, füge deinen API-Schlüssel ein und folge der geführten Einrichtung in bnbills.
Für Buchungen aus der Zeit vor der Verbindung (z. B. aus dem letzten Steuerjahr) kannst du ebenfalls Rechnungen erstellen. Gehe dazu in bnbills zu Buchungen und nutze Rückwirkender Import. Dieser Schritt ist optional.
Gehe zurück in Smoobu zu Gästeerlebnis > Kommunikation und öffne die Nachrichtenvorlage, die deine Gäste vor der Anreise erhalten. Klicke auf Nachrichten und dann auf das Feld Nachrichten-Platzhalter. Wähle im Abschnitt für Integrationen [bnbillsCheckinUrl] und speichere die Vorlage.

Der bnbills-Platzhalter

Nutze [bnbillsCheckinUrl] in deinen Gästenachrichten. Er gibt dem Gast einen Link zum Online-Formular von bnbills. Dort trägt der Gast seine Check-in-Daten und die Rechnungsdaten seiner Firma für eine formelle Rechnung ein und bezahlt die Kurtaxe.

Füge ihn in die Nachricht ein, die deine Gäste vor der Anreise erhalten. So können sie ihre Rechnungsdaten vorab übermitteln und die Kurtaxe vorher begleichen.

So prüfst du, ob es geklappt hat

In bnbills ist Smoobu als verbundene Quellplattform aufgeführt, und deine Unterkünfte und Buchungen erscheinen dort.
Öffne in Smoobu eine Buchung mit bevorstehender Anreise und sieh dir die Vorschau der Vorlage an, die [bnbillsCheckinUrl] enthält. Der Platzhalter wird zu einem Link zum Formular von bnbills.
Einen Tag nach dem Check-out des Gastes, oder sobald der Gast das bnbills-Formular ausgefüllt hat, erstellt bnbills die Rechnung für diese Buchung. Eine neue Buchung hat noch keine Rechnung. Das ist normal.

Häufige Probleme

bnbills lehnt den API-Schlüssel ab oder meldet eine ungültige API-Adresse

bnbills verweigert die Verbindung und zeigt einen Fehler wie „API-Adresse ungültig“. Prüfe diese drei Punkte der Reihe nach:

Die Zwei-Faktor-Authentifizierung ist in Smoobu aktiviert (Account verwalten, dann Zwei-Faktor-Authentifizierung (2FA) unter Einstellungen). Aktiviere sie und versuche die Verbindung erneut.
Der eingefügte Schlüssel stammt von der Seite bnbills im Marktplatz von Smoobu und wurde nach dem Klick auf Verbinden kopiert. Ein Schlüssel aus einer anderen Integration funktioniert nicht.
Der Schlüssel wurde ohne Leerzeichen davor oder danach eingefügt.

Wenn bnbills den Schlüssel weiterhin ablehnt, wende dich an den Support von bnbills. Die Verbindung wird in bnbills erstellt, und der Smoobu-Support kann nicht sehen, was bei bnbills angekommen ist.

Für eine neue Buchung wurde keine Rechnung erstellt

Prüfe zuerst den Zeitpunkt. bnbills erstellt eine Rechnung einen Tag nach dem Check-out, oder sobald der Gast das bnbills-Formular ausgefüllt hat, nicht beim Eingang der Buchung. Ist beides noch nicht passiert, ist die Rechnung noch nicht fällig.

Liegt der Check-out mehr als einen Tag zurück und gibt es trotzdem keine Rechnung, braucht die Verbindung vielleicht eine erste Buchung, bevor sie Buchungen aus Smoobu zuverlässig empfängt. Lege in Smoobu eine kleine Testbuchung an. Erscheint die Testbuchung in bnbills, funktioniert die Verbindung. Die Testbuchung kannst du danach stornieren.

Gäste erhalten den Check-in-Link nicht

Der Link kommt aus dem Platzhalter [bnbillsCheckinUrl]. Öffne die Vorlage, die deine Gäste vor der Anreise erhalten, und prüfe, ob der Platzhalter im Nachrichtentext steht. Eine Vorlage ohne diesen Platzhalter versendet keinen Link.

Du brauchst Hilfe bei etwas in bnbills

Rechnungen, die Einstellungen zur Kurtaxe, das Online-Formular und dein bnbills-Abonnement verwaltet bnbills. Wende dich dafür an den Support von bnbills. An den Smoobu-Support wendest du dich nur für die Smoobu-Seite: die Zwei-Faktor-Authentifizierung, den API-Schlüssel und die Platzhalter in deinen Nachrichtenvorlagen.

Kommst du nicht weiter?

Wenn diese Schritte das Problem nicht gelöst haben, kontaktiere das Smoobu-Team: Öffne das Menü Hilfe, um ein Ticket zu eröffnen oder einen Telefontermin zu buchen, oder nutze die Chat-Blase unten rechts. Für die schnellste Antwort gib bitte an:

Deine Smoobu User ID (im Profil-Icon-Menü oben rechts).
Den Namen oder die ID der Unterkunft, wenn es um eine bestimmte Unterkunft geht.
Die Buchungs-ID, wenn es um eine bestimmte Buchung geht (Buchungen, dann Mehr anzeigen).
Den Namen des Portals, wenn es um Portal-Sync geht (Booking.com, Airbnb, Vrbo und so weiter).
Eine kurze Schritt-für-Schritt-Beschreibung: was du getan hast, was du erwartet hast und was passiert ist.
Screenshots oder eine kurze Bildschirmaufnahme des Problems.

Beiträge in diesem Abschnitt