Rechnungsdaten von Firmenkunden (Finanzamt, Steuernummer, Firmenname) und die türkische Identifikationsnummer (TC-Nummer) übertragen Sie ohne externen Server auf zwei Wegen von Shopify an Entegra: mit dem Entegra-Rechnungsmodul der App CompliTR oder mit einer serverlosen Automatisierung in Shopify Flow. Bei beiden Methoden werden die Daten ohne Eingriff in den Checkout erfasst und im von Entegra erwarteten Format in das Feld shipping_address.company geschrieben.
Diese Woche haben uns mehrere Marken dasselbe technische Problem geschildert: Wie bringen wir die Rechnungsdaten von Firmenkunden (Finanzamt, Steuernummer, Firmenname) oder für Privatrechnungen die türkische Identifikationsnummer (TC-Nummer) von Shopify zu Entegra, ohne einen zusätzlichen Server oder eine Middleware dazwischenzuschalten? Dieses Problem betrifft jeden Shop in der Türkei, der über Shopify Firmenrechnungen ausstellt; die Lösung liegt jedoch viel näher, als viele Teams denken. Wir haben das Problem mit zwei serverlosen Methoden vollständig gelöst und beschreiben beide in diesem Artikel mit allen technischen Details.
Problem: Checkout-Sperre in Nicht-Plus-Shops
Um in der Türkei rechtskonforme E-Rechnungen auszustellen, brauchen Integrationssysteme wie Entegra die steuerlichen Identifikationsdaten des Kunden.
Für Privatkunden ist die TC-Nummer erforderlich, für Firmenkunden Steuernummer, Finanzamt und Firmenname. Das Problem liegt in der Architektur von Shopify: In Shops ohne Shopify Plus lässt sich der Checkout (die Zahlungsseite) nicht anpassen. Felder wie „Steuernummer“ oder „TC“ können Sie dem Standard-Checkout nicht hinzufügen. Hinzu kommt, dass Entegra diese Daten in der Regel aus dem Feld „company“ der Bestellung liest. Es sind also zwei Probleme gleichzeitig zu lösen: die Daten zu erfassen, ohne den Checkout anzutasten, und sie im von Entegra erwarteten Format in das Feld „company“ der Bestellung zu schreiben.
Die von Entegra erwarteten Daten und Formate unterscheiden sich je nach Rechnungsart:
Wichtiger Hinweis: Sobald eine Bestellung in Shopify angelegt ist, lässt sich die billing_address (Rechnungsadresse) nicht mehr über die API ändern. Aktualisieren lässt sich nur die shipping_address (Lieferadresse). Deshalb schreiben beide unten beschriebenen Lösungen in das Feld shipping_address.company; die Lesepriorität in Entegra muss entsprechend eingestellt werden.
Es gibt zwei verschiedene Wege, diese Einschränkung zu umgehen.
Lösung 1: CompliTR App (Plug-and-Play-Modul)
CompliTR ist unsere Shopify-App für die besonderen Compliance-Anforderungen in der Türkei (KVKK-Einwilligung, Fernabsatzvertrag, ETBIS). Wir haben sie um ein Modul für Firmen- und Privatrechnungen für Entegra erweitert. Es wird mit einem einzigen Schalter aktiviert; Sie müssen keinen Code schreiben, keinen Flow einrichten und keinen Server mieten.
Wie funktioniert es?
1. Datenerfassung im Warenkorb (ohne den Checkout zu beeinflussen)
Ist das Modul aktiv, erscheint auf der Warenkorbseite und im Warenkorb-Drawer direkt unter der KVKK-Checkbox automatisch ein aufklappbares Feld „Ich möchte eine Firmenrechnung“. Wählt der Kunde es aus, öffnen sich folgende Felder: Firmenname, Finanzamt, Steuernummer.
Diese Daten werden sofort in den Warenkorb-Attributen der Bestellung gespeichert. Der Theme-Code wird nicht von Hand geändert; das Feld wird so eingebunden, dass es in jedem Theme sicher funktioniert.
2. Szenario für Privatkunden (Einzelpersonen)
Bei einer Privatrechnung gibt der Kunde seine TC-Nummer in das Feld für Adressdetails ein; das Modul erfasst diese Angabe.
3. Automatisches Schreiben nach der Bestellung
Sobald die Bestellung erstellt wird (Webhook orders/create), greift das Modul ein, formatiert die gesammelten Daten und schreibt sie in das Feld shipping_address.company der Bestellung:
Firma;Acme A.Ş.;1234567890;Beşiktaş / Şahıs;Ayşe Yılmaz;12345678901. So liest Entegra beim Abrufen der Bestellung die steuerlichen Identifikationsdaten direkt aus dem Feld „company“.
Sicherheitshinweis: Die Bestellung wird nur bei aktivem Modul verändert. Ist das Modul deaktiviert, erscheint im Warenkorb kein Feld, es werden keine Daten erfasst, und die Bestellung bleibt unangetastet.
Vorteile der CompliTR-Lösung
- Keine technische Einrichtung: Ein/Aus-Schalter, in wenigen Minuten einsatzbereit.
- Theme-unabhängig: Die Einbindung in Warenkorb und Drawer funktioniert mit jedem Theme, der Theme-Code bleibt unangetastet.
- KVKK inklusive: Checkbox, Vertrag und Rechnungsablauf in einer einzigen App.
- Kein Wartungsaufwand: Änderungen an der Shopify API fängt Nodus Works auf Seiten der App ab.
Eine Übersicht aller Funktionen finden Sie auf der Seite der CompliTR-App.
Lösung 2: Serverlose Automatisierung mit Shopify Flow
Der zweite Ansatz ist eine serverlose Automatisierung, die vollständig in Shopify Flow läuft. Entegra ist hier nur der Anlass; im Kern steht eine Automatisierungsarchitektur, die ganz ohne externe Server auskommt.
Kern der Architektur
Statt einen externen Server oder eine Middleware zu mieten, haben wir die gesamte Logik in Flow umgesetzt. Wir haben einen Flow eingerichtet, der
- die Daten, die der Kunde in die Adressdetails eingibt (Şahıs;AdıSoyadı;TC oder Firma;FirmaAdı;VergiNo;VergiDairesi),
- in der Adresshierarchie von Flow (erst billing_address, dann shipping_address) sucht und erfasst
- und das Ergebnis in das Feld shipping_address.company schreibt.
Der App-Token liegt in Flow Secrets; API-Anfragen und Code-Ausführung steuert der Flow direkt.
Wichtiger Hinweis: Betten Sie den Token niemals als Klartext (String) in den Flow ein. Flow Secrets speichert den Token verschlüsselt und entschlüsselt ihn automatisch, wenn er im Flow referenziert wird. Dies ist die einzige sichere Methode, die von Shopify empfohlen wird.
Den Flow mit über 20 Schritten haben wir mit einer hybriden Methode aufgebaut
Shopify Flow kann mehrstufige Logik abbilden; Dutzende Schritte einzeln von Hand in der Oberfläche anzulegen, kostet aber viel Zeit. Um den Prozess zu beschleunigen, haben wir KI in den Workflow eingebunden:
1. Prompt-Vorbereitung: Jeden Schritt, den der Flow ausführen sollte, haben wir in einen klaren Prompt umgewandelt. Den Access-Token haben wir in Flow Secret definiert und im Prompt per Referenz aufgerufen.
2. Sidekick-Unterstützung: Wir haben den Prompt an Shopify Sidekick übergeben, so den ersten Entwurf erstellt und ihn als .flow-Datei heruntergeladen.
3. Feinabstimmung mit KI: Die .flow-Datei lässt sich von Hand bearbeiten, ist aber empfindlich; wir haben sie von Claude auf Code-Ebene analysieren und korrigieren lassen.
4. Import: Die bearbeitete Datei haben wir wieder ins System hochgeladen. So konnten wir den Flow mit über 20 Schritten schnell und fehlerfrei in Betrieb nehmen.
Dieser hybride Ansatz (Sidekick-Entwurf + KI-Bearbeitung + Import) verkürzt die Einrichtungszeit eines Flows gegenüber dem rein manuellen Aufbau deutlich.
Vorteile der Flow-Lösung
- Komplett serverlos: Kein externer Server, keine Webhook-Infrastruktur, keine Middleware.
- Bedingte Verzweigung: Lässt sich an jedes Szenario anpassen, etwa „Wenn dieses Feld ausgefüllt ist, schreibe dies hierhin, andernfalls tue das“.
- Sicherheit innerhalb von Shopify: Der Token liegt in Flow Secrets; die Daten verlassen das Shopify-Ökosystem nicht.
- Einmalige Einrichtung: Bei korrekter Einrichtung wartungsfrei.
Wenn Sie die serverlose Automatisierungsarchitektur auf Basis von Shopify Flow an Ihre eigenen Abläufe anpassen möchten: Unser Service für Shopify-Integrationslösungen umfasst auch Einrichtung und Test des Flows.
Welche Lösung sollten Sie wählen?
Die beiden Lösungen unterscheiden sich im Anforderungsprofil: CompliTR erfasst die Daten aktiv beim Kunden im Warenkorb; Flow verarbeitet die Daten, die der Kunde bereits in das Adressfeld eingegeben hat, und leitet sie weiter.
Kurz gesagt: Brauchen Sie eine Oberfläche, um Daten beim Kunden im Warenkorb zu erfassen, und suchen Sie eine schnelle Lösung ohne Wartungsaufwand, wählen Sie CompliTR. Werden die Daten ohnehin ins Adressfeld eingegeben und möchten Sie den Prozess in Ihr eigenes Automatisierungsnetz einbinden, wählen Sie Shopify Flow.
Beide lassen sich auch kombinieren: Sie erfassen die Daten mit CompliTR im Warenkorb und verketten die folgenden operativen Schritte mit Flow.
Das große Ganze: Die sich wandelnde Welt von Shopify Flow
Wichtiger als die Lösung dieses einen Entegra-Problems ist eine Erkenntnis, die bleibt: Für die kleinste Datenübertragung, einen bedingten Schreibvorgang oder einen API-Aufruf einen externen Server zu mieten oder eine eigene Webhook-Infrastruktur aufzubauen, ist nicht mehr die erste Wahl.
Shopify Flow spart diese Kosten, weil Sicherheit und operative Kontrolle direkt in Shopify bleiben. Wenn Sie App-Tokens in Flow Secrets speichern und komplexe Abläufe mit über 20 Schritten aufbauen, ohne das Shopify-Ökosystem zu verlassen, sinkt der Betriebsaufwand fast auf null.
Das ist kein Trend, sondern ein Wandel in der Architektur. Wir bei Nodus Works sehen, dass Shops, die Flow aktiv nutzen, deutlich niedrigere Einrichtungs- und Wartungskosten haben als Shops, die für dieselben Szenarien externe Server aufsetzen. Konkret: Die durchschnittlich 40-80 $ Serverkosten pro Monat für eine einzelne Integration fallen in der Flow-Architektur auf null.
Wenn Sie in Ihrem E-Commerce-Betrieb auf ähnliche Engpässe stoßen, prüfen Sie zuerst, was Shopify selbst kann, bevor Sie in externe Server investieren.
FAQ: Rechnungsübertragung von Shopify an Entegra
Kann ich die Rechnungsadresse (billing_address) in Shopify nachträglich ändern? Nein. Sobald eine Bestellung angelegt ist, lässt sich die billing_address nicht mehr über die API ändern; das ist eine feste Einschränkung der Shopify-Architektur. Aktualisieren lässt sich nur die shipping_address. Deshalb wird die Steuer-ID in das Feld shipping_address.company geschrieben und die Lesepriorität in Entegra entsprechend eingestellt.
Kann ich in einem Nicht-Plus-Shop Felder zum Checkout hinzufügen? Nein. Shopify hat UI-Erweiterungen für die Checkout-Schritte Informationen, Versand und Zahlung nur für den Plus-Plan freigegeben. In Standard-Shops lassen sich diesen Schritten keine neuen Felder hinzufügen. Daten im Warenkorb zu sammeln und diese nach der Bestellung in die Adresse zu schreiben, ist die einzig praktikable Methode; CompliTR richtet diesen Ablauf automatisch ein.
Wie erfassen Sie die TC-Nummer eines Privatkunden? Der Kunde gibt die TC-Nummer in das Feld für Adressdetails ein. Das Modul erfasst diese Angabe, wandelt sie in das Format Şahıs;AdıSoyadı;TC um und schreibt sie in das Feld „company“. Entegra liest dieses Format und startet den E-Rechnungsablauf für Privatkunden.
Ist ein externer Server wirklich nicht erforderlich? Richtig. CompliTR läuft auf der Infrastruktur der App; Sie mieten keinen Server. Flow läuft vollständig innerhalb von Shopify. In beiden Szenarien fallen keine Kosten für externe Infrastruktur an.
Wie werden Geschäftsrechnungen von Shopify an Entegra gesendet? Um Rechnungsdaten von Firmenkunden aus einem Shopify-Shop an Entegra zu übertragen, werden Steuernummer, Finanzamt und Firmenname des Kunden im Format Firma;FirmaAdı;VergiNo;VergiDairesi in das Feld „company“ der Bestellung geschrieben. Da sich der Checkout in Shops ohne Shopify Plus nicht anpassen lässt, werden die Daten im Warenkorb erfasst und beim Anlegen der Bestellung automatisch in das Feld shipping_address.company übertragen.
Wie wird die TC-Nummer in Shopify erfasst? In Shops ohne Shopify Plus können Sie die TC-Nummer nicht über ein zusätzliches Feld im Checkout erfassen. In der Praxis gibt der Kunde die TC-Nummer in das Feld für Adressdetails ein, und eine Automatisierung (CompliTR oder Shopify Flow) schreibt sie im Format Şahıs;AdıSoyadı;TC in das Feld shipping_address.company.
Warum ist die billing_address in Shopify unveränderlich? Shopify sperrt das Feld billing_address, sobald eine Bestellung angelegt ist (immutable). Das gilt auch für die API: Ein Aufruf von PUT /orders/{id} lehnt die Aktualisierung der billing_address ab. Aktualisieren lässt sich nur die shipping_address. Wegen dieser Einschränkung müssen E-Rechnungs-Integrationen in der Türkei über shipping_address.company arbeiten.
Fazit
Mit der richtigen Architektur lässt sich die Übertragung von Firmenrechnungsdaten und TC-Nummern von Shopify an Entegra ohne externen Server lösen. Für eine schnelle, fertige Lösung bietet sich CompliTR an, für bedingte Verzweigungen und die Einbindung in Ihr eigenes Automatisierungsnetz Shopify Flow. Beide lösen dasselbe Problem für unterschiedliche Nutzerprofile; gemeinsam eingesetzt, ergänzen sie sich bei Datenerfassung und operativer Automatisierung.
Stehen Sie vor einem ähnlichen Integrationsproblem, unterstützt Sie unser Service für Shopify-Integrationslösungen sowohl mit fertigen Apps als auch mit serverlosen Lösungen auf Basis von Flow.
.png)
