Shopify API 2026-07: taxSettings auf dem Customer-Objekt jetzt per GraphQL abrufbar

Das Problem: Die USt-IdNr. war vorhanden, aber die API lieferte sie nicht

Wer schon einmal eine steuerliche oder buchhalterische Integration auf Shopify aufgebaut hat, kennt die Frustration: Der Kunde gibt seine Umsatzsteuer-Identifikationsnummer beim Checkout ein, Shopify erfasst und validiert sie – doch beim Abgleich dieser Information mit einem ERP oder einem externen Buchhaltungssystem ist das Feld über die Standard-API schlicht nicht erreichbar.

Bis jetzt. Mit Version 2026-07 der Admin GraphQL API führt Shopify eine strukturelle Änderung ein, die genau dieses Problem löst.

Was sich in der API-Version 2026-07 ändert

Das Feld taxSettings am Customer-Objekt wird öffentlich zugänglich. Bisher war es notwendig, auf manuelle Workarounds, geschützte Endpunkte oder individuelle Lösungen zurückzugreifen, um steuerliche Informationen zu einem Kunden abzurufen – was die Komplexität von Integrationen deutlich erhöhte.

Ab Version 2026-07 kann mit den aktiven Berechtigungen read_customers oder read_taxes eine Standard-GraphQL-Abfrage ausgeführt werden, die das Feld taxId direkt zurückgibt. Dieses liefert:

• Einen String mit der USt-IdNr. oder Steuernummer, sofern der Kunde den Wert beim Checkout angegeben hat
• null, wenn das Feld nicht ausgefüllt wurde

Keine zusätzliche Konfiguration, kein gesonderter Genehmigungsprozess: Es genügt, die Ziel-API-Version zu aktualisieren und die aktiven Scopes zu prüfen.

Umfang der Änderung: ausschließlich Lesezugriff

Um falsche Erwartungen bei der Integrationsplanung zu vermeiden, sollten die Grenzen dieser Neuerung von Anfang an klar sein.

Die Änderung betrifft ausschließlich den Lesezugriff. Das Schreiben oder Aktualisieren der taxId über diese öffentliche API ist nicht möglich.

Darüber hinaus ist das Feld taxIdValidation, das den Validierungsstatus der Steuernummer enthält, nicht im öffentlichen Zugriff enthalten. Um den Validierungsstatus im Detail abzurufen, muss der Zugriff auf geschützte Kundendaten über das separate Genehmigungsverfahren von Shopify beantragt werden. Dieser Prozess ist eigenständig und sollte frühzeitig eingeplant werden, falls die eigene Integration ihn benötigt.

Konkrete Anwendungsfälle für Entwickler und Händler

Diese Änderung eröffnet relevante Praxisszenarien, insbesondere für alle, die im europäischen Markt tätig sind oder Geschäftskunden außerhalb der strukturierten B2B-Funktionen von Shopify betreuen.

Synchronisierung mit ERP- und Buchhaltungssystemen

Einer der unmittelbarsten Anwendungsfälle ist die automatische Übertragung der USt-IdNr. in Systeme wie SAP, Microsoft Dynamics, Lexware oder andere ERP-Lösungen, die für die Erstellung konformer Rechnungen eine Steuernummer des Kunden benötigen. Bisher musste dieser Wert manuell oder über Umwege beschafft werden. Mit dem API-Zugriff auf taxSettings lässt sich der gesamte Ablauf vollständig automatisieren.

Steuerliche Compliance-Logiken

Für den Verkauf innerhalb Europas hängt die korrekte Handhabung der innergemeinschaftlichen Umsatzsteuer von der Verfügbarkeit und Gültigkeit der USt-IdNr. des Kunden ab. Der programmatische Zugriff auf dieses Feld ermöglicht es:

• Dynamische Preis- und Steuerregeln aufzubauen
• Das Vorhandensein des Wertes vor der Ausstellung steuerlicher Dokumente zu prüfen
• Compliance-Kontrollen direkt in den Auftragsablauf zu integrieren

Angleichung an Shopify B2B

Für Kunden, die die nativen B2B-Funktionen von Shopify nutzen, ist das Feld taxSettings am CompanyLocation-Objekt bereits seit API-Version 2025-01 verfügbar. Die neue Zugänglichkeit am Customer-Objekt in Version 2026-07 stellt eine wichtige Angleichung dar und bringt dieselbe Zugriffsebene auch für Geschäftskunden, die in Shopify nicht als Company strukturiert sind.

So aktualisieren Sie Ihre Integration

Wer steuerliche Integrationen oder ERP-Anbindungen auf Shopify Plus entwickelt oder wartet, sollte folgende Schritte einplanen:

• Ziel-API-Version auf 2026-07 aktualisieren – im App-Manifest oder in den direkten API-Aufrufen
• Aktive Scopes prüfen: Sicherstellen, dass read_customers oder read_taxes in den angeforderten Berechtigungen der App enthalten sind
• Den null-Fall behandeln: Eine Logik implementieren, die Kunden ohne Steuernummer korrekt verarbeitet, da das Feld in diesem Fall null zurückgibt
• Geschützten Zugriff frühzeitig planen, falls die Integration auch das Feld taxIdValidation benötigt: Das Genehmigungsverfahren von Shopify erfordert Zeit und Dokumentation

Eine vollständige Übersicht der verfügbaren Entwicklungsoptionen und Konditionen finden Sie auf unserer Seite für Shopify-Entwicklerpläne.

Fazit

Der öffentliche Zugriff auf taxSettings in der Admin GraphQL API Version 2026-07 ist eine technisch begrenzte, aber praktisch bedeutsame Änderung für alle, die steuerliche Integrationen auf Shopify aufbauen. Sie beseitigt ein konkretes Hindernis, das Entwicklungsteams bislang zu manuellen Lösungen oder fragilen Workarounds zwang, und gleicht den Zugriff auf steuerliche Kundendaten im Consumer-Bereich an den Standard an, der für strukturierte B2B-Kunden bereits besteht. Die Migration rechtzeitig einzuplanen ist die richtige Entscheidung.