# SAP S/4HANA HubSpot Schnittstelle

*SAP S/4HANA → HubSpot*

**Kurz gesagt:** Eine SAP-S/4HANA-HubSpot-Anbindung hält ERP und CRM auf demselben Stand zu Kunden und Aufträgen. Sie ordnet SAP-Geschäftspartner den HubSpot-Unternehmen zu, überträgt gewonnene HubSpot-Deals als Kundenaufträge über die OData-Vertriebs-APIs nach S/4HANA und spielt Auftrags-, Liefer- und Fakturastatus zurück auf den Deal, damit der Vertrieb sieht, was die Buchhaltung sieht. Richtig gemacht ist das kein nächtlicher CSV-Abzug, sondern eine idempotente, bidirektionale Pipeline, die Vertriebsbereichslogik, Geschäftspartnerrollen, Währung und HubSpot-Rate-Limits beachtet - damit niemand einen Auftrag abtippt oder zwei Systeme von Hand abgleicht.

## Was eine SAP-S/4HANA-HubSpot-Anbindung wirklich leistet

Ihre Vertriebsteams arbeiten in HubSpot: Kontakte, Unternehmen, Deals, Pipeline, Forecast. Ihr führendes System ist SAP S/4HANA: der Geschäftspartner-Stamm, der Kundenauftrag, die Lieferung, der Fakturabeleg, der offene Posten auf dem Debitorenkonto. Beide Systeme beschreiben dieselben Kunden und dieselben Geschäfte - und ohne Anbindung laufen sie binnen Wochen auseinander.

Eine SAP-S/4HANA-HubSpot-Anbindung hält sie deckungsgleich. Sie ordnet HubSpot-Unternehmen den SAP-Geschäftspartnern zu, macht aus gewonnenen Deals echte Kundenaufträge in S/4HANA und spielt Auftrags-, Liefer- und Rechnungsstatus zurück auf den Deal - sodass der Vertrieb sieht, dass der Auftrag ausgeliefert und die Rechnung bezahlt ist, ohne SAP GUI zu öffnen oder in der Buchhaltung nachzufragen. Ziel ist eine einzige, belastbare Antwort auf die Frage "Was hat dieser Kunde bestellt und wo steht es", die beide Seiten teilen.

## Welche Daten fließen

| Objekt / Vorgang in SAP S/4HANA | Wird in HubSpot zu | Hinweis |
| --- | --- | --- |
| Geschäftspartner (Kundenrolle) | Unternehmensdatensatz | Zugeordnet oder angelegt; USt-IdNr / Kundennummer als stabiler Schlüssel |
| Ansprechpartner des Geschäftspartners | Kontakt, dem Unternehmen zugeordnet | In HubSpot per E-Mail dedupliziert |
| Kundenauftrag (VBAK/VBAP) | Deal + Positionen oder Custom Object | Auftragsnummer und Wert zurück auf den Ursprungs-Deal geschrieben |
| Liefer- / Warenausgangsstatus | Deal-Eigenschaft oder Timeline-Ereignis | Vertrieb sieht die Erfüllung ohne SAP-Zugang |
| Fakturabeleg / Rechnung | Deal-Eigenschaft, Ticket oder Custom Object | Rechnungsnummer, Betrag, Fälligkeit, Zahlstatus |
| Kredit- / Sperrstatus | Deal-Eigenschaft oder Ticket-Kennzeichen | Warnt den Vertrieb, bevor er eine gesperrte Lieferung zusagt |

Die Richtung läuft beidseitig: HubSpot-Deals und -Unternehmen fließen als Kundenaufträge und Geschäftspartner nach S/4HANA, während SAP-Auftrags- und Finanzstatus zurück auf den Deal fließen. Das genaue Objekt-Mapping, die Rollen und welche Seite je Feld führend ist, legen wir einmalig fest und hinterlegen es in der Pipeline.

## Die Details, an denen einfache Synchronisationen scheitern

Ein generischer Konnektor oder ein nächtlicher Export erledigt die leichten 80 % und lässt die teuren 20 % auf Ihrem Schreibtisch liegen:

- **Keine gemeinsame Identität.** SAP nummeriert einen Geschäftspartner, HubSpot ein Unternehmen. Nichts verknüpft beide, bis Sie den Schlüssel festlegen - USt-IdNr, eine bestehende Kundennummer oder normalisierter Name plus Land. Ist die Deduplizierung falsch, entsteht derselbe Kunde doppelt auf einer der beiden Seiten.
- **Geschäftspartnerrollen.** Ein Partner in S/4HANA ist erst dann Kunde, wenn er die richtige Rolle (Auftraggeber, z. B. FLCU00/FLCU01) im richtigen Vertriebsbereich trägt. Überträgt man ein HubSpot-Unternehmen als nackten Geschäftspartner, entsteht ein Datensatz, gegen den sich gar kein Auftrag erfassen lässt.
- **Der Vertriebsbereich fehlt in HubSpot.** Ein Kundenauftrag braucht Verkaufsorganisation, Vertriebsweg und Sparte. HubSpot kennt das nicht, also muss die Pipeline den Vertriebsbereich aus dem Deal, dem Owner oder dem Unternehmen ableiten - deterministisch, jedes Mal.
- **Währung und Dezimalstellen.** SAP führt eine Belegwährung und eine Hauswährung; HubSpot-Deal-Beträge sind einwährig, sofern Sie nicht Multi-Currency nutzen. Beträge müssen korrekt umgerechnet werden, und die interne Dezimalbehandlung von SAP für bestimmte Währungen muss beachtet werden, sonst liegen Summen um Zehnerpotenzen daneben.
- **Delta statt Vollabgleich.** Jeden Geschäftspartner und jeden Auftrag nächtlich neu zu lesen, reißt Rate-Limits und bewegt Daten, die niemand geändert hat. Wir nutzen SAP-Delta-Tokens und HubSpot-Last-Modified-Filter, sodass nur echte Änderungen übertragen werden.
- **Teilfehler und Idempotenz.** Überträgt man eine Reihe von Deals und einer scheitert an einem fehlenden Kreditlimit oder einem gesperrten Partner, müssen die übrigen Aufträge trotzdem gebucht werden - und ein Webhook-Retry darf denselben Kundenauftrag nie zweimal anlegen. Die HubSpot-Deal-ID als externe Referenz des Auftrags macht die Anlage idempotent.

## Wie wir sie bauen und betreiben

Wir behandeln das als bidirektionale Pipeline, nicht als Stapelverarbeitung. Änderungen werden über HubSpot-Webhooks und SAP-Delta-Reads erfasst, gegen die Objektschemata validiert, durch Ihr abgestimmtes Mapping überführt und über die OData-APIs von S/4HANA sowie die v3-API von HubSpot geschrieben - gebündelt und rate-limit-bewusst auf beiden Seiten.

Die Pipeline ist idempotent: Jeder Deal und jeder Auftrag trägt eine stabile Kennung, sodass ein erneuter Lauf nie einen doppelten Kundenauftrag oder Geschäftspartner erzeugt. Sie läuft auf cloud-nativer, vollständig EU-gehosteter Infrastruktur - Kunden- und Auftragsdaten 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 Beobachten von OData-Abkündigungen bei SAP und Schemaänderungen bei HubSpot liegen vertraglich bei uns. Sie bekommen einen festen Ansprechpartner und ein SLA, keinen Middleware-Mandanten, den Ihr Team pflegen muss.

## Wann sich diese Anbindung lohnt

Wenn nur eine Handvoll Aufträge im Monat zwischen beiden Systemen wandert und eine Person sie in fünf Minuten abtippt, ist ein manueller Schritt völlig in Ordnung - und wir sagen Ihnen das auch. Die Anbindung lohnt sich, wenn das Deal-Volumen das Abtippen selbst zur Aufgabe macht, wenn der Vertrieb Liefertermine zusagt, die die Buchhaltung gesperrt hat, wenn sich doppelte Kunden häufen, weil zwei Teams sie unabhängig anlegen, oder wenn Forecast und Auftragsbestand still und leise nicht mehr übereinstimmen. Dann zahlt sich eine betreute Pipeline durch den Abstimmungsaufwand aus, den sie beseitigt.

## Häufig gestellte Fragen

### Binden Sie S/4HANA Cloud Public Edition, Private Cloud oder On-Premise an?

Alle drei. Bei SAP S/4HANA Cloud Public Edition nutzen wir die freigegebenen OData-APIs über Kommunikationsszenarien - für Geschäftspartner, Kundenauftrag und Fakturabeleg. Bei S/4HANA On-Premise oder Private Cloud Edition greifen wir auf die OData-Services des SAP Gateway zu, und wo keine freigegebene API existiert, weichen wir auf einen freigegebenen BAPI oder einen eigenen CDS-basierten Service aus. Die konkreten Endpunkte und den technischen Kommunikationsbenutzer stimmen wir vorab mit Ihrem Basis-Team ab.

### Wie ordnen Sie ein HubSpot-Unternehmen dem richtigen SAP-Geschäftspartner zu?

Es gibt von Haus aus keinen gemeinsamen Schlüssel, deshalb legen wir die Zuordnungslogik vorab fest. Der stärkste Schlüssel ist die USt-IdNr oder eine Kundennummer, die Sie bereits am HubSpot-Unternehmen führen; ersatzweise gleichen wir über normalisierten Firmennamen plus Land und Adresse ab. In HubSpot neu angelegte Kunden können als SAP-Geschäftspartner mit der korrekten Kundenrolle angelegt oder zur Prüfung zurückgehalten werden - je nachdem, wie viel Kontrolle Ihr Stammdatenteam behalten möchte.

### Kann ein gewonnener Deal als Kundenauftrag nach S/4HANA übertragen werden?

Ja, und das ist der häufigste Grund für die Anbindung. Erreicht ein Deal die vereinbarte Phase, legen wir über die OData-API einen Kundenauftrag in S/4HANA an - Auftraggeber, Vertriebsbereich, Materialnummern, Preisfindung und Zahlungsbedingungen leiten wir aus dem Deal, seinen Positionen und Ihren Mapping-Regeln ab. Die HubSpot-Deal-ID wird als Ihre Referenz am Auftrag hinterlegt, sodass die Verknüpfung stabil und die Anlage bei einem erneuten Versuch idempotent bleibt.

### Wie vermeiden Sie, dass die Rate-Limits von SAP oder HubSpot überschritten werden?

Die v3-API von HubSpot begrenzt Spitzen- und Tagesvolumen je nach Abo-Stufe, und das SAP Gateway hat eine eigene Durchsatzgrenze. Wir bündeln Lese- und Schreibzugriffe ($batch auf SAP-Seite, Batch- und Search-Endpunkte auf HubSpot-Seite), nutzen Delta-Tokens und Last-Modified-Filter, sodass nur Geändertes bewegt wird, und drosseln bei 429-Antworten, statt weiter draufzuhalten. Sie erleben keine gedrosselte Synchronisation, weil die Pipeline unter beiden Grenzen bleibt.

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

Wir. Die Pipeline läuft auf cloud-nativer, vollständig EU-gehosteter Infrastruktur, die wir überwachen. Stellt SAP einen OData-Service ab oder ändert HubSpot ein Objektschema, ist das vertraglich unser Problem - keine böse Überraschung, die Ihr Revenue-Operations-Team entdeckt, wenn keine Aufträge mehr fließen. Sie bekommen einen festen Ansprechpartner, Alerting, Incident Response und ein SLA statt eines Middleware-Mandanten, den jemand hüten muss.

## Verwandte Integrationen

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