# Business Central HubSpot Schnittstelle

*Business Central → HubSpot*

**Kurz gesagt:** Eine Business-Central-HubSpot-Anbindung hält Ihr Dynamics-365-ERP und Ihr CRM über dieselben Kunden im Einklang. Sie synchronisiert Firmen- und Kontaktstammdaten, überführt gewonnene HubSpot-Deals als Debitoren und Verkaufsaufträge nach Business Central und spielt Rechnungs- und Zahlungsstatus zurück auf HubSpot-Firmen und -Deals, damit Vertrieb und Buchhaltung eine gemeinsame Wahrheit sehen. Richtig gebaut ist das kein nächtlicher CSV-Lauf und kein fragiles Zapier-Konstrukt, sondern eine idempotente, bidirektionale Pipeline mit einer gemeinsamen Zuordnung zwischen HubSpot-IDs und Business-Central-Debitorennummern - nichts wird doppelt angelegt, nichts läuft auseinander.

## Was eine Business-Central-HubSpot-Anbindung wirklich leistet

In Business Central ist das Geld real. Dort liegen die gebuchten Rechnungen, der offene Saldo, die Zahlungsbedingungen, das Kreditlimit und die Debitorennummer, gegen die Ihre Buchhaltung tatsächlich bucht. In HubSpot ist die Beziehung real - die Deals, die Kontakte, die Pipeline, die Gespräche, in denen Vertrieb und Customer Success leben. Beide Systeme beschreiben dieselben Kunden und stimmen fast nie überein.

Eine Business-Central-HubSpot-Anbindung schließt diese Lücke in beide Richtungen. Sie spielt die ERP-Wahrheit - wer Kunde ist, was offen ist, ob die letzte Rechnung bezahlt oder überfällig ist - auf die passende HubSpot-Firma und den passenden Deal, sodass der Vertrieb den Kontostand nicht mehr per E-Mail bei der Buchhaltung erfragt. Und sie macht aus gewonnenem Geschäft in HubSpot strukturierte Datensätze in Business Central - einen Debitor, einen Kontakt, einen Verkaufsauftrag -, sodass die Buchhaltung Deals nicht mehr aus einer Tabelle abtippt. Ein Kunde, eine Identität, automatisch synchron gehalten.

## Welche Daten fließen

| Objekt / Vorgang in Business Central | Wird in HubSpot zu | Hinweis |
| --- | --- | --- |
| Debitor | Firma (Company) | Über Domain / USt-IdNr. gematcht; Nummer und systemId zurückgeschrieben |
| Kontakt | Kontakt, der Firma zugeordnet | HubSpot dedupliziert über die E-Mail; Verknüpfungen CRM-seitig aufgebaut |
| Gebuchte Verkaufsrechnung | Deal-Eigenschaft / Rechnung an der Firma | Betrag, Währung, Fälligkeit, Belegnummer für den Vertrieb sichtbar |
| Offener Saldo (Debitorenposten) | Firmen-Eigenschaft | Gesamt offen und überfällig, per Delta aktualisiert |
| Zahlungsstatus | Deal- / Firmen-Eigenschaft | Bezahlt, offen oder überfällig - Mahnrisiko wird sichtbar |
| Artikel | Produkt im Katalog | Optional; hält HubSpot-Positionen mit ERP-Preisen |

Und in die Gegenrichtung:

| Objekt / Vorgang in HubSpot | Wird in Business Central zu | Hinweis |
| --- | --- | --- |
| Gewonnener Deal | Verkaufsauftrag (und Debitor, falls neu) | Debitor zuerst angelegt, dann referenziert der Auftrag ihn |
| Firma (Company) | Debitor | Nummer aus der BC-Nummernserie, nicht von HubSpot |
| Kontakt | Kontakt, mit dem Debitor verknüpft | Auf die BC-Kontakt-Debitor-Beziehung abgebildet |
| Deal-Positionen | Auftragszeilen | Artikelnummern, Mengen, Einzelpreise, Währung durchgereicht |

Feldzuordnung, führendes System je Feld und die Verknüpfung zwischen beiden ID-Schemata stimmen wir einmalig ab und hinterlegen sie in der Pipeline. Danach gleicht sie niemand mehr von Hand ab.

## Die Details, an denen naive Syncs scheitern

Ein generischer Connector oder ein Zapier-Flow reicht für die Demo und lässt die teuren Sonderfälle im Betrieb liegen:

- **Kein gemeinsamer Schlüssel.** HubSpot denkt in Domains und E-Mails, Business Central in Debitorennummern und systemId-GUIDs. Ohne gepflegte Zuordnung wird die erste Firma, die ihre Domain wechselt, oder der erste Kontakt mit zwei Adressen zum doppelten Debitor im ERP.
- **Die Debitorennummer gehört nicht Ihnen.** Business Central vergibt die Nummer aus einer Nummernserie. Man muss den Datensatz anlegen, die vergebene Nummer zurücklesen und speichern - ein naives Upsert über die Nummer schiebt Werte, die das ERP ablehnt oder stillschweigend ignoriert.
- **Mandantenbezogene, versionierte API.** Die Business-Central-API ist mandantenbezogen innerhalb einer Umgebung (viele Firmen können in einem Tenant liegen) und versioniert (api/v2.0 und höher). Schreibzugriffe brauchen den ETag für optimistische Sperren, sonst überschreibt der Letzte den Rest. Ein Sync, der die Firmen-Dimension ignoriert, schreibt in den falschen Mandanten.
- **Rate-Limits auf beiden Seiten.** Business Central drosselt pro Umgebung mit Grenzen für Anfragen pro Minute und Parallelität sowie einem harten Timeout; HubSpot begrenzt pro Zehn-Sekunden-Fenster und pro Tag. Voll-Syncs reißen beide Grenzen. Batch-Endpunkte, Backoff bei 429 und Delta-Abfragen sind bei echtem Volumen keine Kür.
- **Währung und Steuer.** Business Central führt Belegwährung, Beträge in Hauswährung, USt-Geschäftsbuchungsgruppen und USt-IdNr. HubSpot-Deals sind einwährungsfähig, sofern Sie nicht ein Enterprise-Setup mit Mehrwährung nutzen. Beträge müssen in der richtigen Währung abgebildet und nicht bloß als Zahl kopiert werden.
- **Reihenfolge und Teilfehler.** Ein gewonnener Deal muss den Debitor anlegen, bevor der Auftrag ihn referenzieren kann. HubSpot-Batch-Aufrufe liefern Fehler je Position, während $batch in Business Central transaktional ist - die Pipeline muss abhängige Schreibvorgänge ordnen und eine fehlerhafte Zeile abfangen, ohne den ganzen Auftrag zu verwerfen.
- **Löschungen und DSGVO.** Business Central sendet selten ein sauberes Löschsignal; HubSpot-DSGVO-Löschungen müssen durchschlagen. Die Pipeline muss verschwundene Datensätze bewusst abgleichen und nicht annehmen, dass ein fehlender Datensatz keine Änderung bedeutet.

## Wie wir sie bauen und betreiben

Wir behandeln das als Pipeline, nicht als Bündel von Workflow-Automationen. Änderungen in Business Central werden als Delta abgeholt - gefiltert über das Änderungsdatum oder per Graph-Benachrichtigung -, validiert, in Ihre abgestimmte HubSpot-Zuordnung überführt und über die HubSpot-Batch-API geschrieben. Deal- und Firmenänderungen aus HubSpot fließen genauso zurück und legen Debitoren und Verkaufsaufträge im richtigen Business-Central-Mandanten an.

Die Pipeline ist idempotent. Jeder Datensatz trägt eine stabile Identität in der Zuordnung, sodass ein erneuter Versuch, ein Replay oder ein Wiederholungslauf nie einen zweiten Debitor oder einen doppelten Deal erzeugt. Sie läuft auf cloud-nativer, vollständig EU-gehosteter AWS-Infrastruktur - Kunden- und Finanzdaten verlassen die EU nicht, was AVV und DSGVO sauber hält.

Und dann halten wir sie am Laufen. Monitoring, Alerting, Incident Response und - entscheidend - das Verfolgen von API-Änderungen bei Business Central und HubSpot liegen vertraglich bei uns. Microsoft veröffentlicht Business-Central-API-Updates im Release-Rhythmus, HubSpot kündigt Endpunkte nach eigenem Plan ab; beidem vorauszubleiben ist unsere Aufgabe, nicht ein Feuer, das Ihr Team löscht, wenn keine Deals mehr im ERP ankommen. Sie bekommen einen festen Ansprechpartner, einen Festpreis-Scope und ein SLA.

## Wann sich diese Anbindung lohnt

Wenn Sie eine Handvoll Deals im Monat abschließen und eine Person sie klaglos in Business Central überträgt, brauchen Sie keine Pipeline - und das sagen wir Ihnen auch. Ein HubSpot-Operations-Hub-Sync oder ein manueller Export kann genügen.

Die Anbindung lohnt sich, wenn das Deal-Volumen das Abtippen zum echten Kostenfaktor macht, wenn der Vertrieb Zahlungs- und Saldostand live braucht, um Accounts zu priorisieren und Verlängerungen nachzufassen, wenn doppelte Debitoren im ERP bereits Rechnungsfehler verursachen, oder wenn Sie mehrere Business-Central-Mandanten gegen ein HubSpot-Portal betreiben und die Zuordnungslogik über das hinausgeht, was ein Point-Tool ausdrücken kann. Dann zahlt sich eine betreute, bidirektionale Pipeline durch die Abstimmung aus, die sie überflüssig macht.

## Häufig gestellte Fragen

### In welche Richtung fließen die Daten - von Business Central nach HubSpot oder umgekehrt?

Meist in beide, und die Richtung hängt vom Objekt ab. Stammdaten und die finanzielle Realität (Debitoren, gebuchte Rechnungen, offener Saldo, Zahlungsstatus) fließen von Business Central nach HubSpot, damit der Vertrieb den echten Kontostand sieht. Neugeschäft fließt andersherum: Aus einem gewonnenen HubSpot-Deal werden ein Debitor und ein Verkaufsauftrag in Business Central. Welches System pro Feld führend ist, legen wir vorab fest, damit sich beide Seiten nie um denselben Wert streiten.

### Wie ordnen Sie eine HubSpot-Firma einem Business-Central-Debitor zu, wenn es keinen gemeinsamen Schlüssel gibt?

Genau das ist der Kern des Projekts. HubSpot dedupliziert Firmen über die Domain und Kontakte über die E-Mail-Adresse; Business Central identifiziert Debitoren über eine Nummer aus der Nummernserie und eine interne systemId-GUID. Es gibt keinen gemeinsamen Schlüssel, deshalb pflegen wir eine Zuordnungstabelle, die HubSpot-IDs auf Business-Central-Debitorennummern abbildet - initial aus einem Abgleich befüllt und danach führend gehalten. Neue Datensätze werden über Domain, USt-IdNr. oder Name plus Adresse gematcht, bevor überhaupt ein Duplikat entstehen kann.

### Kann HubSpot die Debitorennummer vergeben oder macht das Business Central?

Das macht Business Central. Debitorennummern stammen aus einer Nummernserie - eine beliebige Nummer aus HubSpot durchzureichen funktioniert nicht. Die Pipeline legt den Debitor in Business Central an, liest die vergebene Nummer und die systemId zurück und schreibt beide auf die HubSpot-Firma, sodass ab diesem Punkt beide Seiten dieselbe Identität referenzieren.

### Hält das die Rate-Limits von Business Central und HubSpot bei unserem Volumen aus?

Ja, weil wir dafür entwerfen und es nicht erst im Betrieb entdecken. Business Central drosselt pro Umgebung (Anfragen pro Minute, Parallelitätsgrenzen und ein hartes Timeout je Anfrage), HubSpot begrenzt Anfragen pro Zehn-Sekunden-Fenster und pro Tag. Wir nutzen die Batch-Endpunkte auf beiden Seiten, warten bei 429 kontrolliert ab und synchronisieren Deltas statt ganzer Tabellen - so bringt auch ein umsatzstarker Monat die Warteschlange nicht zum Stillstand.

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

Wir. Die Pipeline läuft auf cloud-nativer, vollständig EU-gehosteter Infrastruktur, die wir überwachen. Wenn Microsoft eine neue Business-Central-API-Version veröffentlicht oder HubSpot einen Webhook abkündigt, ist das vertraglich unser Problem - keine böse Überraschung, die Ihr RevOps-Team entdeckt, wenn plötzlich keine Deals mehr ankommen. Sie bekommen einen festen Ansprechpartner, Alerting, Incident Response und ein SLA statt eines Workflows, den jemand babysitten muss.

## Verwandte Integrationen

- [NetSuite ↔ HubSpot](https://seamless.engineering/de/integrations/netsuite-hubspot/): NetSuite HubSpot Schnittstelle
- [SAP S/4HANA ↔ HubSpot](https://seamless.engineering/de/integrations/sap-s4hana-hubspot/): SAP S/4HANA 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
- [HubSpot ↔ QuickBooks](https://seamless.engineering/de/integrations/hubspot-quickbooks/): HubSpot QuickBooks Schnittstelle

## Nach System

- [Alle Schnittstellen für Dynamics 365](https://seamless.engineering/de/integrations/dynamics-365/)
- [Alle Schnittstellen für HubSpot](https://seamless.engineering/de/integrations/hubspot/)
- [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