Zum Hauptinhalt springen

BuchhaltungsButler Belegintegration einrichten

Verbinde deinen BuchhaltungsButler-Account mit smarta und lasse deine Belege automatisch abrufen.

Verbinde deinen BuchhaltungsButler-Account mit smarta, damit Belege automatisch abgerufen werden und du weniger manuell hochladen musst.

Die BuchhaltungsButler-Integration ist unser Angebot, deinen Beleg-Upload in smarta zu vereinfachen: Statt Rechnungen manuell hochzuladen, zieht smarta sie automatisch aus deinem BuchhaltungsButler-Account.

🧪 Beta-Version: Die BuchhaltungsButler-Integration ist neu und befindet sich aktuell in der Testphase. Es kann daher vereinzelt noch zu Unregelmäßigkeiten kommen. Wir freuen uns über dein Feedback an kontakt-team@smarta-steuern.de – so hilfst du uns, die Integration weiter zu verbessern.

⚠️ Voraussetzung: Die Integration benötigt den API-Zugang von BuchhaltungsButler. Dieser ist im Tarif Premium enthalten – in den Tarifen Light und Smart kannst du ihn als Add-on „API-Client“ (5,90 € mtl.) hinzubuchen.

Wichtig – die Integration ist eine reine Beleg-Schnittstelle:

  • Importiert werden ausschließlich Belege, die in BuchhaltungsButler als „bezahlt“ markiert sind – Eingangs- und Ausgangsrechnungen.

  • Keine Bank- oder Kontotransaktionen werden übernommen.

  • Keine Zusatzdaten wie Notizen, Kategorien oder Tags werden übertragen.

Zuordnung der Belege: Wir ziehen nur die Belege – die Zuordnung zu deinen Banktransaktionen erfolgt in smarta. Ein automatisches Matching funktioniert nur, wenn der Beleg aus BuchhaltungsButler importiert wurde und die zugehörige Banktransaktion bereits in smarta vorhanden ist.

Ist in BuchhaltungsButler eine Bank angebunden, die in smarta nicht gekoppelt ist, werden deren Belege zwar importiert, sie können aber keiner Banktransaktion zugeordnet werden. Für diese Belege musst du in smarta eine externe Transaktion erstellen, um den Beleg zuzuordnen. Wie du eine Bank in smarta hinzufügst, erfährst du hier.


Schritt 1: API-Zugangsdaten in BuchhaltungsButler anzeigen

  1. Logge dich in deinen BuchhaltungsButler-Account ein.

  2. Klicke oben links neben deinem Firmennamen auf das Zahnrad-Symbol und wähle Einstellungen.

  3. Öffne den Abschnitt Schnittstellen und API-Zugang.

  4. Wähle rechts unter API-Zugang die Option API-Zugang aktivieren.

  5. Klicke auf Ihre API-Zugangsdaten anzeigen – es öffnet sich ein Fenster mit API-Client, API-Secret und API-Key.

  6. Kopiere alle drei Werte – du brauchst sie in Schritt 2.


Schritt 2: Verbindung in deinem smarta Profil herstellen

  1. Öffne dein smarta Profil unter app.smarta.tax/profile.

  2. Gehe zum Bereich Belegimport und klicke bei der BuchhaltungsButler-Kachel auf Verbinden.

  3. Füge die in Schritt 1 kopierten Werte in die Authentifizierungsmaske ein: API Client, API Secret und API Key.

  4. Klicke auf Connect. Fertig! Nach erfolgreicher Verbindung wird dir die Verbindung in deinem Profil als aktiv angezeigt.


Schritt 3: Steuerberater-Zugang für uns einrichten

Damit wir dich bei Fragen zur Integration bestmöglich unterstützen und bei Bedarf Einsicht in deinen BuchhaltungsButler-Account erhalten können, richte bitte zusätzlich einen Steuerberater-Zugang für uns ein. Dieser ist in allen Tarifen kostenlos enthalten.

  1. Klicke oben links auf das Zahnrad-Symbol und wähle Nutzerverwaltung.

  2. Klicke oben rechts auf Nutzer hinzufügen.

  3. Trage im Feld E-Mail die Adresse buchhaltungsbutler@smarta-steuern.de ein.

  4. Wähle als Nutzerrolle die Option Steuerberater:in.

  5. Klicke auf Weiter, um uns einzuladen.

Geschafft! Deine BuchhaltungsButler-Belege werden nun automatisch mit smarta synchronisiert und deinem Steuerberater bereitgestellt.


Häufig gestellte Fragen (FAQ)

Welchen BuchhaltungsButler-Tarif brauche ich für die Integration?

Die Integration funktioniert mit jedem Tarif, benötigt aber den API-Zugang: Im Tarif Premium ist er enthalten, in den Tarifen Light und Smart kannst du ihn als Add-on „API-Client“ (5,90 € mtl.) hinzubuchen.

Werden auch meine Bankumsätze oder Transaktionen importiert?

Nein. Über die Integration werden ausschließlich Belege (Rechnungen, Dokumente) importiert, die als bezahlt markiert sind.

Wie kann ich die Verbindung wieder trennen?

Wenn du die Verbindung trennen möchtest, dann gib uns kurz Bescheid und wir trennen sie für dich.

Für welchen Zeitraum werden meine Belege übernommen?

Neue Verbindungen übernehmen automatisch alle Belege ab dem 1. Januar des laufenden Kalenderjahres.

Du brauchst auch Belege aus einem früheren Jahr, zum Beispiel weil ein älteres Steuerjahr bei uns noch offen ist? Dann kannst du dich einfach bei unserem Support unter kontakt-team@smarta-steuern.de melden – wir finden gemeinsam den besten Weg, die fehlenden Belege zu ergänzen.

Wie oft werden Belege übernommen?

Die Synchronisation der Belege erfolgt automatisch einmal täglich.

Wenn du heute einen Beleg hinzufügst oder änderst, wird dieser in der Regel am nächsten Tag in dein smarta Profil übernommen. Neue sowie aktualisierte Belege werden dabei automatisch erkannt, importiert und – sofern möglich – direkt einer passenden Transaktion zugeordnet.

Sollte eine automatische Zuordnung nicht möglich sein, prüft unser Team den Beleg manuell. Dadurch kann es in einzelnen Fällen zu zeitlichen Verzögerungen kommen.


Du brauchst Unterstützung?

Für unsere Mandant*innen:

Schreib uns jederzeit an kontakt-team@smarta-steuern.de oder buche dir hier ein Beratungsgespräch – wir sind für dich da!

Kein Mandant*in bei smarta? Kein Problem!

Buche dir hier einen Termin für unser umfassendes Gründungspaket oder ein Beratungsgespräch, wenn du nur Fragen zu einzelnen Themen hast.

Weitere Fragen:

Kontaktiere uns per E-Mail, wenn du mehr zu unseren Beratungsleistungen oder anderen Anliegen erfahren möchtest.

Hat dies deine Frage beantwortet?