# Xero HubSpot Schnittstelle

*Xero → HubSpot*

**Kurz gesagt:** Eine Xero-HubSpot-Anbindung sorgt dafür, dass Vertrieb und Buchhaltung denselben Kunden sehen: Aus gewonnenen HubSpot-Deals werden Debitoren und Ausgangsrechnungen in Xero, und Rechnungsstatus, offener Betrag, Fälligkeit und Zahlungseingänge fließen zurück auf Unternehmen und Deal in HubSpot. Richtig gemacht ist das kein nächtlicher Export, sondern eine idempotente Pipeline, die über eine gespeicherte Xero-ContactID zuordnet statt über Firmennamen, Steuerschlüssel herleitet statt kopiert und unter Xeros Limit von rund 60 Aufrufen pro Minute bleibt.

## Was eine Xero-HubSpot-Anbindung wirklich leistet

In HubSpot lebt die Kundenbeziehung: das Unternehmen, die Ansprechpartner, die Pipeline, das Angebot und der Moment, in dem ein Deal auf gewonnen gesetzt wird. In Xero wird daraus Geld: ein Debitor, eine Ausgangsrechnung, ein Zahlungseingang, eine Gutschrift, ein offener Posten in der Fälligkeitsliste.

Zwischen beiden Systemen sitzt fast immer ein Mensch. Jemand liest den gewonnenen Deal, öffnet Xero, tippt die Firma erneut ein, wählt die Konten, setzt den Steuerschlüssel und stellt die Rechnung. Und später beantwortet jemand anderes die Frage, die der Vertrieb ständig stellt: Hat der Kunde eigentlich bezahlt? In HubSpot sieht das niemand, also wird die Buchhaltung gefragt - oder einmal im Monat eine Liste der offenen Posten in eine Tabelle kopiert.

Eine Xero-HubSpot-Anbindung nimmt beide Hälften weg. Gewonnene Deals werden ohne Abtippen zu korrekt kontierten Rechnungen in Xero, und Rechnungsstatus, offener Betrag, Fälligkeit und Zahlungseingänge laufen zurück auf den HubSpot-Datensatz. Der Vertrieb sieht den Zahlungsstand, ohne jemals Zugriff auf Ihr Rechnungswesen zu bekommen.

## Welche Daten fließen

| Objekt / Vorgang in Xero | Wird in HubSpot zu | Hinweis |
| --- | --- | --- |
| Kontakt (Debitor) | Unternehmen | Zuordnung über gespeicherte ContactID, nicht über den Namen - Xero erzwingt eindeutige Kontaktnamen |
| Ansprechpartner am Xero-Kontakt | Kontakt, dem Unternehmen zugeordnet | HubSpot schlüsselt über die E-Mail-Adresse, Xero nicht |
| Ausgangsrechnung (ACCREC) | Rechnungsobjekt oder Deal-Properties | Rechnungsnummer, Betrag, Fälligkeit, Währung und Status am Datensatz sichtbar |
| Statuswechsel der Rechnung | Property an Deal oder Unternehmen | DRAFT, SUBMITTED, AUTHORISED, PAID, VOIDED bleiben aktuell |
| Zahlungseingang / offener Betrag | Property an Deal oder Unternehmen | Steuert bezahlt, teilbezahlt und überfällig - ohne Xero-Zugang |
| Gutschrift | Property-Update plus Notiz am Deal | Mindert den erfassten Betrag und dokumentiert den Grund |
| Überfälliger Saldo | Property am Unternehmen | Kann einen HubSpot-Workflow auslösen, etwa Outreach stoppen oder den Owner informieren |

In der Gegenrichtung werden aus HubSpot-**Unternehmen** und -**Kontakten** Xero-**Kontakte**, aus gewonnenen **Deals** **Ausgangsrechnungen** und aus HubSpot-**Line Items** Rechnungspositionen mit ItemCode, AccountCode und TaxType. Die Artikelnummern aus der HubSpot-Produktbibliothek werden einmalig auf Xero-Artikel und Erlöskonten abgebildet, zusammen mit den Kostenstellen, auf die Sie auswerten. Danach ordnet das niemand mehr von Hand zu.

## Die Details, an denen einfache Syncs scheitern

Ein Marketplace-Connector oder ein Zapier-Szenario liefert Ihnen einen Kontaktabgleich und lässt die teuren Teile auf Ihrem Schreibtisch liegen:

- **Dublettenprüfung.** Xero verlangt je Organisation einen eindeutigen Kontaktnamen und weist einen zweiten Kontakt mit demselben Namen schlicht ab. HubSpot hält problemlos zwei gleichnamige Unternehmen unter verschiedenen Domains. Ohne systemübergreifend gespeicherte ID und ein vereinbartes Matching-Kriterium erzeugen Sie entweder Dubletten oder laufen beim Schreiben auf einen Fehler.
- **Steuerschlüssel sind keine Steuersätze.** Xero arbeitet mit organisations- und länderspezifischen TaxType-Codes. Welcher richtig ist, hängt von Sitzland und umsatzsteuerlicher Registrierung des Kunden ab, nicht von einem Prozentwert aus HubSpot. HubSpot-Positionen kennen überhaupt kein Steuerkonzept, also muss die Pipeline den Schlüssel herleiten.
- **Brutto oder netto.** Eine Xero-Rechnung ist Exclusive, Inclusive oder NoTax. Werden Bruttobeträge als Nettopositionen übergeben, ist jede Rechnung um die Umsatzsteuer falsch. Xero rechnet die Steuer je Position zudem selbst nach, sodass die Summe still von der Deal-Summe abweicht.
- **Rabatte und Rundung.** HubSpot bildet den Deal-Betrag aus Positionen und Rabatten nach eigener Logik, Xero rechnet prozentuale Rabatte je Position und rundet je Position. Die Abbildung muss die gewollte Endsumme reproduzieren, statt eine Zahl passend zu machen.
- **API-Limits.** Xero erlaubt je Organisation rund 60 Aufrufe pro Minute und 5.000 pro Tag bei niedriger Parallelität. HubSpot begrenzt in Zehn-Sekunden-Fenstern mit tariflich unterschiedlichen Tageskontingenten, die Search-API noch strenger. Eine Massenänderung auf einer der beiden Seiten läuft ins Limit, wenn die Pipeline nicht bündelt, drosselt und kontrolliert nachfasst.
- **Delta statt Vollabgleich.** Jede Nacht alle Kontakte und Rechnungen zu lesen, verbrennt Ihr komplettes Xero-Tageskontingent für nichts. Die Pipeline liest nur Veränderungen - über den Header If-Modified-Since bei Xero und die inkrementelle Suche über hs_lastmodifieddate bei HubSpot.
- **Reihenfolge und Teilfehler.** Eine Rechnung kann nicht gebucht werden, bevor der Debitor existiert. Und ein Stapel Rechnungen muss so übergeben werden, dass Validierungsfehler je Datensatz zurückkommen, statt den gesamten Stapel scheitern zu lassen - jeder fehlgeschlagene Datensatz wird einzeln erneut versucht.
- **Wieder geöffnete Deals.** Ein gewonnener Deal lässt sich zurückstufen. Eine freigegebene Rechnung in Xero lässt sich nicht zurücknehmen, sie braucht eine Gutschrift. Die Pipeline muss diesen Unterschied kennen und darf Belege niemals stillschweigend löschen.

## Wie wir sie bauen und betreiben

Wir behandeln das als Pipeline, nicht als geplanten Export. Änderungen werden zeitgesteuert und per Webhook aus HubSpot und Xero gelesen, validiert, in die mit Ihnen und Ihrer Buchhaltung abgestimmte Zuordnung überführt und mit korrekter Kontaktverknüpfung, Kontierung, Steuerschlüssel und Währung ins jeweils andere System geschrieben.

Die Pipeline ist idempotent: Jeder Deal, jede Rechnung und jeder Zahlungseingang trägt eine stabile Kennung sowie die aufgelöste systemübergreifende ID. Ein erneuter Lauf, ein wiederholt zugestellter Webhook oder ein Retry erzeugt deshalb nie eine zweite Rechnung. Xero-Webhooks melden ohnehin nur, dass sich ein Kontakt oder eine Rechnung geändert hat, nicht was - die Pipeline holt den Stand daher ab und gleicht ab, statt der Benachrichtigung zu vertrauen. Betrieben wird das auf cloud-nativer, vollständig EU-gehosteter AWS-Infrastruktur: Kunden-, Deal- und Rechnungsdaten 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 Xero-Endpunkten und -Limits, der Rotation von OAuth-Refresh-Tokens sowie von Property- und Pipeline-Änderungen in HubSpot liegen vertraglich bei uns. Die Übergabe vom Vertrieb an die Buchhaltung hängt nicht mehr daran, dass jemand daran denkt.

## Wann sich diese Anbindung lohnt

Wenn Sie eine Handvoll Rechnungen im Monat stellen und jemand sie in zehn Minuten in Xero abtippt, reichen die Marketplace-App oder schlicht Handarbeit völlig aus - und wir sagen Ihnen das auch. Die Anbindung lohnt sich, wenn das Rechnungsvolumen steigt, wenn Artikelstamm und Erlöskonten eine echte Kontierung je Position brauchen, wenn der Vertrieb die Buchhaltung ständig nach dem Zahlungsstand fragt, wenn Sie in mehreren Währungen fakturieren, oder wenn sich in Xero bereits Dubletten angesammelt haben. Ab diesem Punkt kostet eine betreute Pipeline weniger als die Abstimmung und Nacharbeit, die sie ersetzt.

## Häufig gestellte Fragen

### Gibt es für Xero nicht längst eine App im HubSpot-Marketplace?

Die gibt es, und für ein kleines Team mit wenigen unkomplizierten Rechnungen im Monat reicht sie oft aus. Sie gleicht Kontakte ab und zeigt Rechnungen am Deal an - die Zuordnungslogik dahinter ist aber fest vorgegeben. Ihr Artikelstamm, Ihre Erlöskonten, Ihre Kostenstellen und Ihre steuerliche Behandlung sind es nicht. Sobald Rechnungspositionen sauber kontiert werden müssen oder der Zahlungsstatus HubSpot-Workflows auslösen soll, füllen Sie die Lücke wieder von Hand.

### Wie ordnen Sie ein HubSpot-Unternehmen einem Xero-Kontakt zu, ohne Dubletten zu erzeugen?

Genau daran scheitern die meisten Setups still und leise. Xero verlangt je Organisation einen eindeutigen Kontaktnamen und behandelt die E-Mail-Adresse nicht als Schlüssel; HubSpot dedupliziert Unternehmen über die Domain und Kontakte über die E-Mail-Adresse. Zwei Datensätze, die für einen Menschen identisch aussehen, sind für beide Systeme verschieden. Wir legen vorab ein Matching-Kriterium fest - USt-IdNr., Domain oder eine Debitorennummer im Feld ContactNumber - und speichern die ermittelte Xero-ContactID am HubSpot-Unternehmen. Jeder spätere Abgleich läuft dann über eine stabile ID statt über Namensraten.

### Legen Sie Rechnungen in Xero als Entwurf oder direkt als freigegeben an?

So, wie Ihre Buchhaltung es verantworten will. Ein Entwurf bleibt änderbar und lässt sich folgenlos verwerfen - das passt, wenn jemand vor dem Versand prüft. Eine freigegebene Rechnung ist ein verbindlicher Beleg und lässt sich nur noch per Gutschrift korrigieren - das passt bei hohem Volumen ohne Einzelprüfung. In den ersten Wochen starten wir üblicherweise mit Entwürfen, gleichen Summen und Kontierung mit Ihrer Buchhaltung ab und stellen erst dann auf Freigabe um.

### Wie gehen Sie mit Fremdwährung und Steuersätzen um?

Getrennt, weil beide Systeme damit unterschiedlich umgehen. HubSpot führt einen Deal in seiner Belegwährung und rechnet für Auswertungen mit einem von Ihnen gepflegten Kurs in die Unternehmenswährung um; Xero setzt beim Ausstellen der Rechnung seinen eigenen tagesaktuellen Kurs an, und Mehrwährungsfähigkeit gibt es dort erst ab den höheren Tarifen. Wir stellen in der Belegwährung, und der Kurs bleibt in der Hoheit von Xero, damit Ihr Rechnungswesen führend bleibt. Der Steuerschlüssel wird hergeleitet, nicht übernommen: Er ergibt sich aus Sitzland und Umsatzsteuerstatus des Kunden, denn HubSpot-Positionen kennen kein Steuerkonzept.

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

Wir. Die Pipeline läuft auf cloud-nativer, vollständig EU-gehosteter Infrastruktur, die wir überwachen. Ändert Xero einen Endpunkt oder seine Limits, läuft ein Refresh-Token aus, oder benennt HubSpot eine Property oder Pipeline um, ist das vertraglich unser Problem - und nicht etwas, das Ihr Vertrieb daran merkt, dass am Deal keine Rechnungen mehr auftauchen. Sie bekommen einen festen Ansprechpartner, Alerting, Incident Response und einen AVV, der Ihre DSGVO-Pflichten sauber hält.

## Verwandte Integrationen

- [HubSpot ↔ QuickBooks](https://seamless.engineering/de/integrations/hubspot-quickbooks/): HubSpot QuickBooks Schnittstelle
- [Business Central ↔ HubSpot](https://seamless.engineering/de/integrations/business-central-hubspot/): Business Central HubSpot Schnittstelle
- [GoCardless ↔ Xero](https://seamless.engineering/de/integrations/gocardless-xero/): GoCardless Xero 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 Xero](https://seamless.engineering/de/integrations/xero/)
- [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