Xero HubSpot Schnittstelle

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.