# HubSpot QuickBooks Schnittstelle

*HubSpot → QuickBooks*

**Kurz gesagt:** Eine HubSpot-QuickBooks-Anbindung macht aus einem gewonnenen Deal eine korrekte Rechnung, ohne dass sie jemand abtippt. Die HubSpot-Firma wird zum Debitor in QuickBooks, zugeordnet über eine hinterlegte ID statt über den Firmennamen, aus den Deal-Positionen entstehen Rechnungspositionen mit echten Artikeln, Zahlungszielen und Steuerschlüsseln, und der Zahlungsstatus fließt zurück nach HubSpot, damit der Vertrieb sieht, wer tatsächlich bezahlt hat. Sauber gebaut ist das eine idempotente Pipeline in beide Richtungen und kein nächtlicher Export.

## Was eine HubSpot-QuickBooks-Anbindung wirklich leistet

HubSpot kennt die kaufmännische Wahrheit: welche Firma unterschrieben hat, was sie gekauft hat, zu welchem Preis, zu welchen Konditionen und wer den Account betreut. QuickBooks braucht daraus eine Rechnung: einen Debitor, Positionen mit echten Artikeln oder Leistungen, den passenden Steuerschlüssel, ein Fälligkeitsdatum und eine Belegnummer, die in Ihre Nummernkreise passt.

Zwischen beiden Systemen sitzt heute meist ein Mensch mit zwei Browser-Tabs. Er liest den Deal, tippt die Firma neu, rät, welcher QuickBooks-Artikel zum HubSpot-Produkt gehört, setzt das Zahlungsziel aus dem Gedächtnis und verschickt den Beleg. Kurz darauf fragt der Vertrieb, ob schon bezahlt wurde, und derselbe Mensch schaut wieder nach.

Eine HubSpot-QuickBooks-Anbindung spart beide Wege: Aus gewonnenen Deals werden Rechnungen mit genau der Positionstiefe aus dem Angebot, und der Zahlungsstatus kommt zurück nach HubSpot. Der eigentliche Gewinn ist nicht Tempo, sondern dass Rechnung und Deal jedes Mal zusammenpassen, ohne dass ein Mensch die Zuordnungslogik im Kopf hat.

Eine Einordnung vorweg: Im DACH-Raum begegnet uns QuickBooks vor allem bei Unternehmen mit einer internationalen Einheit, während die deutsche Buchhaltung parallel in DATEV, lexoffice oder sevDesk läuft. Wenn beides zutrifft, muss die Anbindung zusätzlich wissen, welcher Deal in welche Gesellschaft und welche Bücher gehört.

## Welche Daten fließen

| Objekt / Ereignis in HubSpot | Wird in QuickBooks zu | Hinweis |
| --- | --- | --- |
| Firma (im B2C der Kontakt) | Debitor | Zuordnung über hinterlegte ID, nie über den Namen |
| Deal erreicht die vereinbarte Phase | Rechnung | Auslösende Phase wird konfiguriert, nicht fest verdrahtet |
| Angebot veröffentlicht oder unterschrieben | Kostenvoranschlag (Estimate) | Optional, später mit der entstehenden Rechnung verknüpft |
| Deal-Positionen | Rechnungspositionen mit Artikelbezug | Menge, Einzelpreis und Rabatt je Position übernommen |
| Produkt aus der Produktbibliothek / SKU | Artikel (Leistung oder Lagerartikel) | Einmalig gemappt, damit keine Position an einem fehlenden Artikel scheitert |
| Deal-Währung und Umrechnungskurs | Rechnungswährung | Muss zur Währung des Debitors in QuickBooks passen |
| Eigenschaft Zahlungsziel | Konditionen und Fälligkeitsdatum | Sonst erbt jede Rechnung eine Voreinstellung, die niemand gewählt hat |
| Zahlungseingang in QuickBooks | Eigenschaften am Deal in HubSpot | Bezahlt, teilbezahlt, überfällig, Ausgleichsdatum |
| Deal nach Fakturierung wieder geöffnet oder verloren | Stornierte Rechnung oder Gutschrift | Stornieren erhält die Belegkette, Löschen nicht |
| Deal-Owner oder Geschäftsbereich | Klasse, Abteilung oder Vertriebsreferenz | Optional, für Umsatzauswertung je Team oder Gesellschaft |

Auslösende Phase, Artikelzuordnung, Steuerschlüssel und Konditionen stimmen wir einmalig im Scoping ab und hinterlegen sie in der Pipeline. Danach ordnet sie niemand mehr von Hand zu.

## Die Details, an denen einfache Syncs scheitern

Ein nächtlicher Export oder eine Plug-and-play-App bringt Sie fast ans Ziel und lässt den teuren Rest auf Ihrem Schreibtisch liegen:

- **Positionen statt Deal-Betrag.** Der Betrag am HubSpot-Deal ist eine Zahl, die jemand eingetragen hat. Er kann von der Summe der Positionen abweichen und trägt weder Produkt noch Menge noch Steuerinformation. Als eine einzige Erlöszeile gebucht, ist die Umsatzauswertung wertlos und die Steuer oft falsch. Die Rechnung muss aus den Positionen entstehen.
- **Jede Position braucht einen echten QuickBooks-Artikel.** QuickBooks weist eine Position zurück, deren Artikel es nicht kennt. Ein Produkt, das der Vertrieb am Freitagnachmittag in HubSpot anlegt, lässt einen naiven Sync still auflaufen. Die Pipeline muss den Katalog abgleichen und nach vereinbarten Regeln zuordnen oder anlegen.
- **Debitorenzuordnung.** Muster GmbH, Muster GmbH & Co. KG und Muster sind für den Vertrieb ein Kunde und für die Buchhaltung drei. Ein Abgleich über Namen erzeugt Dubletten, die die offene Postenliste zerlegen. Die Zuordnung muss über stabile IDs laufen, auf beiden Seiten gepflegt.
- **Die Währung ist mit dem Debitor festgelegt.** QuickBooks bindet die Währung an den Debitor und lässt danach keine Rechnung in einer anderen Währung zu. Kommt ein Deal in abweichender Währung, muss die Anbindung das bewusst auflösen und nicht auf halbem Weg abbrechen.
- **Steuerlogik hängt am Mandanten.** Ein US-Mandant berechnet die Sales Tax selbst und überschreibt, was Sie senden. Ein britischer oder internationaler Mandant erwartet VAT-Codes und eine ausdrückliche Brutto- oder Netto-Kennzeichnung. Dasselbe HubSpot-Angebot wird je nach Zielbuchhaltung unterschiedlich abgebildet.
- **Rückschreiben erzeugt Schleifen.** Sobald der Zahlungsstatus zurück nach HubSpot fließt, löst dieser Schreibvorgang selbst ein Änderungsereignis aus. Ohne Schleifenschutz sieht die Pipeline ihre eigene Aktualisierung und beginnt, eine zweite Rechnung zu bauen.
- **Rate Limits und Teilfehler.** HubSpot drosselt die Suchschnittstelle deutlich stärker als einfache Objektabfragen, QuickBooks begrenzt Anfragen je Mandant und belohnt Batch-Aufrufe. Wer zwei Jahre Historie nachlädt, muss paginieren, zurückstufen und wieder aufsetzen. Scheitert Datensatz 17 von 40, müssen die anderen 39 genau einmal gebucht sein und die 17 in einer Warteschlange landen, in die jemand tatsächlich schaut.

## Wie wir sie bauen und betreiben

Wir klären die Zuordnung zuerst und geben dafür einen Festpreis ab: Auslöser, Artikellogik und Steuerbehandlung stehen fest, bevor die erste Zeile Code entsteht. Danach behandeln wir das als Pipeline, nicht als Skript. HubSpot-Ereignisse kommen per Webhook an, ergänzt um einen zeitgesteuerten Nachlauf für alles, was ein Webhook verpasst hat. Jedes Ereignis wird validiert, gegen die Debitoren- und Artikelzuordnung aufgelöst, in Ihr abgestimmtes Rechnungsbild überführt und über die QuickBooks-Online-API geschrieben. Zahlungs- und Statusänderungen laufen im selben Durchgang zurück auf die HubSpot-Eigenschaften.

Die Pipeline ist idempotent. Jeder HubSpot-Datensatz trägt eine stabile ID, und wir führen selbst Buch darüber, was bereits übertragen wurde. Ein erneuter Lauf, ein doppelter Webhook oder ein Retry erzeugt daher nie eine zweite Rechnung. Sie läuft auf cloud-nativer, vollständig EU-gehosteter AWS-Infrastruktur, Kunden- und Vertriebsdaten bleiben also in der EU, was AVV und DSGVO sauber hält.

Und dann halten wir sie am Laufen. Monitoring, Alerting und Incident Response liegen vertraglich bei uns, ebenso das Beobachten von Änderungen auf beiden Seiten: geänderte Payloads und Berechtigungen bei HubSpot und die Rotation der QuickBooks-Refresh-Tokens, die unbeaufsichtigte Anbindungen lautlos abreißen lässt. Sie bekommen einen festen Ansprechpartner und ein SLA, keine App, die Sie im Fehlerfall nicht reparieren können.

## Wann sich diese Anbindung lohnt

Wenn Sie im Monat eine Handvoll Deals mit einer kurzen Artikelliste in einem einzigen QuickBooks-Mandanten abschließen, reichen die Marketplace-App oder fünf Minuten Tippen völlig aus - und das sagen wir Ihnen auch.

Sie lohnt sich, sobald der Weg vom Deal zur Rechnung aufhört, einfach zu sein: Teil- und Meilensteinrechnungen, Abos und Verlängerungen, mehrere Gesellschaften oder Mandanten, ein Produktkatalog in Bewegung oder eine Freigabe, bevor etwas beim Kunden landet. Und sie lohnt sich, wenn nicht das Tippen teuer ist, sondern die Fehler: Rechnungen, die nicht zum Angebot passen, Dubletten, die Ihre offene Postenliste zerreißen, und ein Vertrieb, der nicht weiß, welche Kunden überfällig sind.

## Häufig gestellte Fragen

### Reicht nicht die QuickBooks-App aus dem HubSpot Marketplace?

Bei einem einfachen Aufbau reicht sie oft - das sagen wir Ihnen auch. Die fertige App erzeugt aus einem Deal eine Rechnung und meldet den Zahlungsstatus zurück, solange es eine QuickBooks-Firma, eine Währung und eine überschaubare Artikelliste gibt. Dünn wird es bei Teil- und Meilensteinrechnungen, mehreren QuickBooks-Mandanten, eigener Artikel- und Steuerlogik oder wenn die Rechnung an etwas anderem als der Deal-Phase hängen soll. Eine betreute Pipeline bildet Ihre Regeln ab, nicht die der App.

### Was löst die Rechnung aus - Closed Won, ein unterschriebenes Angebot oder etwas anderes?

Das klären wir zuerst, denn ein falscher Auslöser erzeugt Rechnungen für Deals, die noch gar nicht fakturierbar sind. Üblich sind eine festgelegte Pipeline-Phase, ein HubSpot-Angebot im Status unterschrieben oder ein Lieferereignis auf einer eigenen Eigenschaft. Auf Wunsch legen wir in QuickBooks zunächst einen Entwurf an, den jemand freigibt, statt direkt an den Kunden zu versenden.

### Wie verhindern Sie Dubletten im Debitorenstamm?

Wir gleichen nie über den Firmennamen ab. Namen laufen zwischen CRM und Buchhaltung auseinander, gerade bei Rechtsformzusätzen und Marken. Stattdessen führen wir eine stabile Zuordnung zwischen HubSpot-Datensatz-ID und QuickBooks-Debitor-ID, schreiben die QuickBooks-ID auf eine HubSpot-Eigenschaft zurück, damit Ihr Team sie sieht, und legen einen Debitor nur an, wenn es keine Zuordnung gibt. Den bestehenden Stamm gleichen wir einmalig beim Onboarding ab, statt ihn zu verdoppeln.

### Funktioniert das auch mit mehreren QuickBooks-Mandanten oder mehreren Währungen?

Ja, und genau hier hören fertige Connectoren meist auf. Deals lassen sich anhand einer Gesellschaftseigenschaft an unterschiedliche QuickBooks-Mandanten routen, sodass eine UK-Tochter und eine US-Einheit getrennte Bücher behalten. Bei Währungen gilt: QuickBooks legt die Währung mit dem Debitor fest und lässt sie danach nicht mehr wechseln. Wir lösen die Deal-Währung deshalb vorab auf und führen bei Bedarf je Währung einen eigenen Debitor, statt eine Rechnung zu senden, die QuickBooks ablehnt.

### Wer betreibt die Schnittstelle nach dem Go-live?

Wir. Die Pipeline läuft auf cloud-nativer, vollständig EU-gehosteter Infrastruktur, die wir überwachen. HubSpot ändert Webhook-Payloads und App-Berechtigungen, QuickBooks rotiert Refresh-Tokens in festen Abständen und kappt damit unbeaufsichtigte Verbindungen still. Beides zu erkennen und zu beheben liegt vertraglich bei uns und ist nichts, was Ihr Finanzteam bemerkt, wenn ein Monat Rechnungen fehlt. Sie bekommen einen festen Ansprechpartner, Alerting und ein SLA.

## Verwandte Integrationen

- [QuickBooks ↔ Salesforce](https://seamless.engineering/de/integrations/quickbooks-salesforce/): QuickBooks Salesforce Schnittstelle
- [Xero ↔ HubSpot](https://seamless.engineering/de/integrations/xero-hubspot/): Xero HubSpot Schnittstelle
- [Business Central ↔ HubSpot](https://seamless.engineering/de/integrations/business-central-hubspot/): Business Central HubSpot Schnittstelle
- [HubSpot ↔ Intercom](https://seamless.engineering/de/integrations/hubspot-intercom/): HubSpot Intercom Schnittstelle
- [HubSpot ↔ Mailchimp](https://seamless.engineering/de/integrations/hubspot-mailchimp/): HubSpot Mailchimp Schnittstelle
- [HubSpot ↔ Pipedrive](https://seamless.engineering/de/integrations/hubspot-pipedrive/): HubSpot Pipedrive Schnittstelle

## Nach System

- [Alle Schnittstellen für HubSpot](https://seamless.engineering/de/integrations/hubspot/)
- [Alle Schnittstellen für QuickBooks](https://seamless.engineering/de/integrations/quickbooks/)
- [HubSpot API-Changelog](https://seamless.engineering/de/api-changelog/hubspot/): 8 Breaking Changes und 2 Deprecations in den letzten 90 Tagen

## Scoping-Gespräch anfragen

Sie möchten diese Integration umsetzen und dauerhaft betreiben lassen? Sagen Sie uns, welche Systeme verbunden werden sollen und welche Daten fließen müssen. Festpreis-Angebot zur Aufwandsabschätzung innerhalb von 48 Stunden.

- E-Mail: hello@seamless.engineering
- Kontaktformular: https://seamless.engineering/de/#contact