Alle AppsMarketplace App

DATEV – HubSpot Sync

Rechnungsinformationen, Kundenstammdaten und PDF-Belege aus HubSpot direkt an DATEV übertragen – für eine reibungslose Zusammenarbeit mit Ihrer Steuerberatung.

Aktuell nur auf Anfrage erhältlich

Die DATEV-App ist noch nicht öffentlich im HubSpot Marketplace verfügbar. Schreiben Sie uns, wenn Sie die App nutzen möchten – wir richten den Zugang gemeinsam mit Ihnen ein.

Zugang anfragen

Übersicht

Mit der DATEV-App übertragen Sie Rechnungsinformationen, Kundenstammdaten und zugehörige PDF-Belege aus HubSpot an DATEV. Die Daten werden für unterschiedliche Zwecke bereitgestellt:

  • Kundenstammdaten: Verknüpfte HubSpot-Unternehmen und -Kontakte werden als Debitoren für die Buchhaltung aufbereitet. Ein Debitor ist ein Kunde, dem Sie eine Rechnung stellen. Die Zuordnung geschieht über die Pflichteigenschaft „Konto“.
  • Buchungsdaten: Aus den Belegpositionen entstehen Buchungszeilen im DATEV-Format.
  • Belegbilder: Verfügbare PDF-Belege werden an DATEV übertragen und mit den Buchungsdaten verknüpft. In den App-Einstellungen legen Sie fest, ob Angebote oder Rechnungen als Quelle dienen.

Sie legen einmal fest, welche HubSpot-Informationen in welche DATEV-Felder übernommen werden. Anschließend übertragen Sie die Daten manuell oder nach einem Zeitplan.

Die App überträgt Daten von HubSpot in einen über die Einstellungen definierten Ordner im DATEV Rechnungswesen. Eine erfolgreiche Übertragung bedeutet, dass die Daten dort bereitgestellt bzw. vom jeweiligen Import verarbeitet wurden. Die fachliche Prüfung und Weiterverarbeitung erfolgt anschließend in Ihrem Buchhaltungsprozess.

Voraussetzungen

  • Ein HubSpot-Konto mit installierter App und Zugriff auf deren Einstellungen.
  • Zugriff auf die HubSpot-Rechnungen bzw. Angebote, Positionen und Kundendaten, die Sie übertragen möchten.
  • Einen eingerichteten DATEV-Rechnungswesenbestand sowie die erforderlichen DATEV-Datenservices und Zugriffsrechte.
  • Eine DATEV-Anmeldemöglichkeit für die Person, die die Verbindung freigibt.
  • Ihre DATEV-Beraternummer, Mandantennummer und den Beginn des Wirtschaftsjahres.
  • Eine mit Ihrer Buchhaltung oder Steuerberatung abgestimmte Zuordnung der Konten und weiteren Buchungsfelder.

Für die Belegablage muss der Bestand in DATEV Unternehmen online eingerichtet sein. Hinweise dazu finden Sie in der DATEV-Anleitung zur Einrichtung des Buchungsdatenservice.

Prüfen Sie außerdem, ob die benötigten Eigenschaften in HubSpot ausgefüllt und die Unternehmen mit den Belegen verknüpft sind. Für Belegbilder muss ein HubSpot-Angebot oder eine HubSpot-Rechnung verwendet werden.

Einrichtung

Öffnen Sie in HubSpot die Einstellungen der verbundenen App und wechseln Sie zum Tab Allgemeine Einstellungen.

1. DATEV-Stammdaten eintragen

EinstellungBedeutung
BeraternummerDATEV-Beraternummer Ihrer Steuerberatung.
MandantennummerNummer Ihres Unternehmens innerhalb des DATEV-Bestands.
WirtschaftsjahresbeginnErster Tag des Wirtschaftsjahres im Format JJJJMMTT, z. B. 20260101 für den 1. Januar 2026.

Die drei Pflichtangaben bestimmen den DATEV-Bestand und das Wirtschaftsjahr. Speichern Sie Ihre Einstellungen.

2. Datenquelle auswählen

Unter Primäre Datenquelle wählen Sie „Invoices“ (HubSpot-Rechnungen) oder „Quote“ (HubSpot-Angebote).

3. Verbindung herstellen

  1. Klicken Sie auf Mit DATEV verbinden.
  2. Öffnen Sie den angezeigten Autorisierungslink, falls sich die Anmeldung nicht direkt öffnet.
  3. Melden Sie sich bei DATEV an und bestätigen Sie die angeforderten Zugriffe.
  4. Kehren Sie zu HubSpot zurück und klicken Sie auf Status aktualisieren.

Im Bereich DATEV-Verbindung sehen Sie Verbindungsstatus, Datenbestand, Gültigkeit der Zugangsberechtigung („Token gültig bis“) und die autorisierende Person. Einen technischen Schlüssel müssen Sie nicht eingeben.

Über Verbindung trennen lösen Sie die Verbindung – bereits übertragene Daten bleiben erhalten. Der Link DATEV Verbundene Anwendungen führt zur Verwaltung der bei DATEV erteilten App-Zugriffe.

4. Belegablage festlegen

EinstellungBedeutungStandard
DATEV-OrdnerOberste Ablageebene.HubSpot
DATEV-UnterordnerZweite Ablageebene.Ausgang

Beide Namen dürfen höchstens 30 Zeichen enthalten; leere Felder verwenden den Standardwert. Die dritte Ebene, das Monatsregister, wird aus dem Belegdatum (ersatzweise dem Erstellungsdatum) ermittelt, z. B. HubSpot → Ausgang → 2026-09.

Neue Ablagenamen gelten für zukünftige Uploads; vorhandene Belege werden nicht verschoben.

Debitoren konfigurieren

Im Tab Debitoren & Header legen Sie fest, welche Kundendaten an DATEV übergeben werden.

  1. Öffnen Sie das gewünschte DATEV-Feld über Bearbeiten.
  2. Wählen Sie die passende HubSpot-Eigenschaft oder einen festen Wert.
  3. Speichern Sie die Zuordnung.
  4. Wiederholen Sie dies für alle benötigten Felder, insbesondere die markierten Pflichtfelder.

Typische Zuordnungen sind Debitorennummer, Unternehmensname und Anschrift. Verwenden Sie eine mit Ihrer Buchhaltung abgestimmte Debitorennummer – eine HubSpot-Datensatznummer ist nicht automatisch eine geeignete DATEV-Kontonummer. Die App benötigt die Verknüpfung zwischen Beleg und Unternehmen, um die Stammdaten zuzuordnen.

„1/1 vollständig“ bedeutet, dass das Pflichtfeld konfiguriert ist. „Gemappt: 12/254“ zählt alle eingerichteten Zuordnungen inkl. optionaler Felder – Sie müssen nicht alle 254 Felder aktivieren. Ob die Werte bei jedem Kunden vorhanden und gültig sind, zeigt erst die Datenprüfung.

Der Bereich Header enthält zusätzliche Angaben für die DATEV-Datei. Technische Pflichtwerte werden automatisch erzeugt; weitere Headerfelder konfigurieren Sie nur bei Bedarf.

Buchungsstapel konfigurieren

Ein Buchungsstapel fasst Buchungszeilen zur Verarbeitung in DATEV zusammen. Im Tab Buchungsstapel & Header prüfen Sie insbesondere die Zuordnungen für:

  • Betrag und Währung
  • Konto und Gegenkonto
  • Soll-/Haben-Kennzeichen
  • Belegdatum und Belegnummer
  • Buchungstext und ggf. benötigte Steuerangaben

„7/7 vollständig“ bestätigt die Einrichtung der Pflichtfelder – nicht aber, dass alle Belege vollständige oder fachlich passende Werte enthalten. Benötigen Sie je nach Beleg unterschiedliche Konten, nutzen Sie Regeln.

Belegpositionen können zu mehreren Buchungszeilen führen; die Zahl der Buchungszeilen muss daher nicht der Zahl der Rechnungen entsprechen.

Mapping verstehen

Ein Mapping ist eine Zuordnung: Welche Information aus HubSpot soll in welches DATEV-Feld übernommen werden?

BeispielZuordnung
UnternehmensnameDer Name des verknüpften HubSpot-Unternehmens wird in das DATEV-Namensfeld übernommen.
BelegnummerDie Rechnungsnummer wird dem DATEV-Feld für die Belegnummer zugeordnet.
WährungEin fester Wert wie EUR, sofern alle betreffenden Belege diese Währung haben.
BuchungstextEine geeignete Beschreibung aus HubSpot wird als Buchungstext übernommen.

Sie wählen zwischen HubSpot-Eigenschaft / fester Wert und Regeln. Als Quelle stehen je nach Feld Unternehmen, Kontakte, Deals, Rechnungen, Angebote oder Positionen zur Verfügung.

Eine gespeicherte Zuordnung bedeutet nicht, dass jeder Beleg einen passenden Wert enthält. Verwenden Sie vor der ersten Übertragung Nur prüfen. Deaktivieren Sie nur Felder, die Sie nicht benötigen.

Regeln für DATEV-Felder erstellen

Mit Regeln bestimmen Sie einen Feldwert abhängig von den HubSpot-Daten – ganz ohne Programmierung.

  1. Öffnen Sie beim gewünschten DATEV-Feld Bearbeiten.
  2. Wählen Sie unter Wert bestimmen durch die Option Regeln.
  3. Legen Sie unter WENN die Bedingung fest: Datenquelle, Eigenschaft, Vergleich und Vergleichswert.
  4. Legen Sie unter DANN das Ergebnis fest – fester Wert oder Wert einer HubSpot-Eigenschaft.
  5. Ergänzen Sie bei Bedarf weitere Bedingungen oder Regeln.
  6. Tragen Sie unter SONST den Ersatzwert („Fallback“) ein.
  7. Speichern Sie die Zuordnung.

UND = alle Bedingungen müssen erfüllt sein, ODER = mindestens eine. Regeln werden von oben nach unten ausgewertet; die erste passende liefert das Ergebnis – ordnen Sie speziellere Regeln daher zuerst an.

Beispiel: Bei Leistungsart „Beratung“ wird als Buchungstext „Beratungsleistung“ eingetragen, sonst der Standardtext. Oder: Ist „Amount billed“ größer 0, liefert die Regel „H“, andernfalls „S“. Welche Konten und Zuordnungen fachlich richtig sind, stimmen Sie mit Ihrer Buchhaltung ab.

Datenübertragung

Vor der ersten Übertragung prüfen

Wählen Sie einen überschaubaren Zeitraum und klicken Sie auf Nur prüfen. Die App prüft die HubSpot-Daten, ohne etwas an DATEV zu übertragen. Beheben Sie gemeldete Fehler und wiederholen Sie die Prüfung. Ein erfolgreicher Prüflauf ersetzt nicht die fachliche Kontrolle.

Manuell übertragen

  1. Öffnen Sie Allgemeine Einstellungen.
  2. Kontrollieren Sie Datenquelle, DATEV-Verbindung und Pflichtfelder.
  3. Wählen Sie Zeitraum Start und Zeitraum Ende.
  4. Speichern Sie Ihre Einstellungen.
  5. Klicken Sie auf Datenübertragung starten.
  6. Prüfen Sie die Ergebnisanzeige und anschließend die Daten in DATEV.

Der manuelle Zeitraum bezieht sich auf das Erstellungsdatum in HubSpot, nicht auf das Rechnungsdatum; Start- und Endtag sind eingeschlossen.

Automatisch übertragen

  1. Aktivieren Sie Automatischen DATEV-Sync aktivieren.
  2. Wählen Sie Starttag und Startuhrzeit für den ersten Lauf.
  3. Legen Sie den Wiederholungsabstand in Tagen und Stunden fest (für 24 Stunden: 1 Tag und 0 Stunden).
  4. Speichern Sie die Einstellungen.

Der erste Start wird nach deutscher Ortszeit geplant. Bei Rechnungen berücksichtigt die automatische Auswahl auch Änderungen in HubSpot; Angebote werden nach Erstellungsdatum ausgewählt. Änderungen an bereits übertragenen Rechnungen sind keine automatische Korrektur oder Stornierung einer DATEV-Buchung.

Ergebnisse verstehen

AnzeigeBedeutung und nächster Schritt
Übertragung läuftDie App verarbeitet den Auftrag. Warten Sie auf das Ergebnis.
Erfolgreich abgeschlossenPrüfen Sie die gemeldeten Mengen und das Ergebnis in DATEV.
Hinweise vorhandenLesen Sie die Hinweise – z. B. kann ein PDF fehlen oder eine Position übersprungen worden sein.
Fehler oder unklarer StandFolgen Sie dem beschriebenen nächsten Schritt. Prüfen Sie zuerst, was bereits übertragen wurde.

Eine Rechnung kann mehrere Positionen und damit mehrere Buchungszeilen enthalten. Fehlt ein PDF, wird die Buchung ohne Belegverknüpfung übertragen. Positionen mit Betrag null werden übersprungen.

Ein erneuter Status-Check startet keinen neuen Import. Starten Sie bei unklarem Ergebnis nicht vorsorglich eine weitere Übertragung desselben Zeitraums – ein Teil der Daten kann bereits bei DATEV angekommen sein.

Technischer Hintergrund

Im Vordergrund stehen der DATEV Buchungsdatenservice und die digitale Belegübertragung. Eigene Programmierungen sind nicht nötig.

SchnittstelleVerständlich erklärt
accounting:documentsÜberträgt digitale Belege über das DATEV-Rechenzentrum – für PDF-Belege und deren Ablage in Belege online.
accounting:extf-filesÜberträgt Stamm- und Bewegungsdaten im DATEV-Format – Debitorenstammdaten und Buchungsstapel für DATEV Rechnungswesen.
accounting:clientsFragt verfügbare Rechnungswesen-Datenservices ab, um vor einer Übertragung die Zugriffsrechte auf einen Bestand zu prüfen.

Der DATEV Buchungsdatenservice umfasst Buchungs- und Stammdaten sowie Belegbilder. Belege online ist Bestandteil von DATEV Unternehmen online. Der DATEV Belegbilderservice Rechnungswesen beschreibt die Übernahme digitalisierter Belege nach DATEV Unternehmen online.

Hilfe & Fehlerbehebung

„Einstellungen konnten nicht geladen werden“

Laden Sie die App-Einstellungen erneut. Tragen Sie Ihre Einrichtung nicht vorsorglich neu ein – die gespeicherten Werte konnten nur gerade nicht abgerufen werden.

DATEV-Status „nicht verfügbar“

Klicken Sie auf Status aktualisieren. Ein nicht abrufbarer Status bedeutet nicht automatisch, dass die Verbindung getrennt wurde.

DATEV-Verbindung „getrennt“ oder abgelaufen

Verbinden Sie erneut über Mit DATEV verbinden und kontrollieren Sie den angezeigten Datenbestand.

Pflichtangabe fehlt oder hat ein ungültiges Format

Lesen Sie, welchen Datensatz und welches Feld die Meldung nennt, korrigieren Sie die HubSpot-Eigenschaft oder die Zuordnung und führen Sie erneut Nur prüfen aus.

Keine passenden Daten gefunden

Kontrollieren Sie Datenquelle, Zeitraum und Belegstatus. Bei manueller Übertragung zählt das Erstellungsdatum; nur offene oder bezahlte Rechnungen werden ausgewählt.

Ein PDF fehlt oder wurde abgelehnt

Prüfen Sie, ob der Beleg als zugängliche PDF-Datei vorliegt. Beachten Sie den bestätigten Übertragungsstand, bevor Sie den Auftrag erneut starten.

Übertragung nur teilweise abgeschlossen

Die Meldung zeigt, welche Schritte bestätigt sind. Prüfen Sie diese in DATEV und nutzen Sie zunächst die Statusprüfung.

Daten übertragen, aber nicht in der Buchhaltung sichtbar

Unterscheiden Sie zwischen der Belegablage in Belege online und dem Abruf der Buchungs- bzw. Stammdaten im DATEV-Rechnungswesen. Kontrollieren Sie Bestand und Verarbeitungsschritt.

Sie benötigen Unterstützung?

Schreiben Sie an apps@adunera.com. Nennen Sie bitte Ihre HubSpot-Portal-ID, den Zeitpunkt des Problems, die betroffene Rechnung bzw. den Auftrag und den Wortlaut der Fehlermeldung – falls vorhanden auch die Auftragskennung und die „Technischen Details für den Support“. Senden Sie keine Passwörter oder Zugangsschlüssel.