Diese Woche haben wir von mehreren Marken denselben technischen Engpass gehört: Wie übertragen wir die Unternehmensrechnungsinformationen des Kunden (Finanzamt, Steuernummer, Firmenname) oder die türkische Personalausweisnummer für Einzelrechnungen von Shopify an Entegra, ohne einen zusätzlichen Server oder eine Middleware dazwischenzuschalten? Als Nodus Works haben wir beobachtet, dass dieses Problem einen Großteil der Marken betrifft, die Shopify in der Türkei nutzen; die Lösung jedoch viel näher liegt, als viele Teams denken. Wir haben das Problem mit zwei separaten serverlosen Methoden von Anfang bis Ende gelöst und beschreiben beide mit ihren technischen Details in diesem Artikel.
Problem: Checkout-Sperre in Nicht-Plus-Shops
In der Türkei erfordert die Ausstellung rechtskonformer E-Rechnungen, dass Integrationssysteme wie Entegra die Steueridentität des Kunden besitzen.
Für Privatkunden ist die türkische Personalausweisnummer erforderlich; für Firmenkunden werden Steuernummer, Finanzamt und Firmenname benötigt. Das Problem liegt in der Architektur von Shopify: In Shops ohne Shopify Plus kann der Checkout-Bildschirm (Zahlung) nicht angepasst werden. Es ist nicht möglich, Felder wie „Steuernummer“ oder „TC“ zum Standard-Zahlungsablauf hinzuzufügen. Darüber hinaus liest Entegra diese Informationen in der Regel aus dem Feld „company“ der Bestellung. Daher müssen zwei Probleme gleichzeitig gelöst werden: diese Daten zu erfassen, ohne den Checkout zu beeinflussen, und die erfassten Daten 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: Nachdem eine Bestellung in Shopify erstellt wurde, kann die billing_address (Rechnungsadresse) nicht über die API geändert werden. Nur die shipping_address (Lieferadresse) kann aktualisiert werden. Daher erfolgt bei beiden unten genannten Lösungen der Schreibvorgang in das Feld shipping_address.company; Entegra muss seine Lesepriorität entsprechend anpassen.
Es gibt zwei verschiedene Wege, diese Einschränkung zu umgehen.
Lösung 1: CompliTR App (Plug-and-Play-Modul)
CompliTR ist unsere Shopify-App, die spezifische türkische Compliance-Anforderungen (KVKK-Zustimmung, Fernabsatzvertrag, ETBİS) löst. Wir haben ihr das Modul für Unternehmens-/Privatrechnungen für Entegra hinzugefügt. Es wird mit einem einzigen Schalter aktiviert; es ist kein Code schreiben, kein Flow einrichten oder Server mieten erforderlich.
Wie funktioniert es?
1. Datenerfassung im Warenkorb (ohne den Checkout zu beeinflussen)
Wenn das Modul aktiv ist, erscheint auf der Warenkorbseite und im Warenkorb-Drawer automatisch ein aufklappbares Feld „Ich möchte eine Firmenrechnung“ direkt unter dem KVKK-Zustimmungsfeld. Wenn der Kunde es auswählt, öffnen sich folgende Felder: Firmenname, Finanzamt, Steuernummer.
Diese Daten werden sofort in den Warenkorb-Attributen der Bestellung gespeichert. Der Theme-Code wird nicht manuell geändert; er wird so injiziert, dass er in jedem Theme sicher funktioniert.
2. Szenario für Privatkunden (Einzelpersonen)
Bei einer Einzelrechnung gibt der Kunde seine türkische Personalausweisnummer in das Adressdetailfeld ein; das Modul erfasst diese Daten.
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;12345678901So liest Entegra beim Abrufen der Bestellung die Steueridentität direkt aus dem Feld „company“ aus.
Sicherheitshinweis: Die Manipulation funktioniert nur, wenn das Modul aktiv ist. Wenn das Modul deaktiviert ist, wird weder ein Feld im Warenkorb angezeigt, noch werden Daten gesammelt, noch wird die Bestellung beeinflusst.
Vorteile der CompliTR-Lösung
- Keine technische Einrichtung: Ein/Aus-Schalter, in wenigen Minuten einsatzbereit.
- Theme-unabhängig: Die Warenkorb-/Drawer-Injektion funktioniert mit jedem Theme, der Theme-Code wird nicht beschädigt.
- Integriert mit KVKK: Checkbox, Vertrags- und Rechnungsfluss in einer einzigen Anwendung.
- Kein Wartungsaufwand: Änderungen an der Shopify API werden auf App-Seite von Nodus Works verwaltet.
Alle Funktionen der CompliTR-Anwendung apps.nodusworks.com/uygulamalar/complitr können Sie unter der Adresse einsehen.
Lösung 2: Serverlose Automatisierung mit Shopify Flow
Der zweite Ansatz ist eine vollständig auf Shopify Flow basierende serverlose Automatisierung. Entegra ist hier nur das auslösende Szenario; die eigentliche Struktur präsentiert eine Automatisierungsarchitektur, die die Abhängigkeit von externen Servern vollständig eliminiert.
Kern der Architektur
Anstatt einen externen Server oder Middleware zu mieten, haben wir die gesamte Logik innerhalb von Flow gelöst:
- Die Daten, die der Kunde in die Adressdetails eingibt (Privatperson;NameNachname;TC oder Firma;Firmenname;Steuernummer;Finanzamt),
- die Adresshierarchie innerhalb von Flow (billing_address und anschließend shipping_address) durchsucht und erfasst,
- und das Ergebnis in das Feld shipping_address.company schreibt.
Wir haben einen Flow eingerichtet. Der App-Token wird in Flow Secrets gespeichert; API-Anfragen und Code-Ausführung werden direkt vom Flow verwaltet.
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.
Wir haben den über 20-schrittigen Flow mit einer hybriden Methode eingerichtet
Shopify Flow kann mehrstufige Logik aufbauen; jedoch ist das manuelle Einrichten von Dutzenden von Schritten einzeln über die Benutzeroberfläche ein erheblicher Zeitverlust. Um den Prozess zu beschleunigen, haben wir künstliche Intelligenz in den Workflow integriert:
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 und den ersten Entwurf erstellt und als .flow-Datei heruntergeladen.
3. Feinabstimmung mit KI: Die .flow-Datei, die anfällig für manuelle Eingriffe und sensibel ist, haben wir auf Code-Ebene von Claude analysieren und korrigieren lassen.
4. Import: Wir haben die bearbeitete Datei wieder in das System hochgeladen. So konnten wir den über 20-schrittigen Flow fehlerfrei und schnell in Betrieb nehmen.
Als Nodus Works haben wir beobachtet, dass dieser hybride Ansatz (Sidekick-Entwurf + KI-Bearbeitung + Import) die Einrichtungszeit des Flows im Vergleich zur rein manuellen Einrichtung um etwa das Dreifache verkürzt.
Vorteile der Flow-Lösung
- Komplett serverlos: Kein externer Server, keine Webhook-Infrastruktur oder Middleware.
- Bedingte Verzweigung: Anpassbar an jedes Szenario, z.B. „Wenn dieses Feld ausgefüllt ist, schreibe dies hierhin, andernfalls tue das.“
- Sicherheit innerhalb von Shopify: Bei Token Flow Secrets verlassen Daten das Shopify-Ökosystem nicht.
- Einmalige Einrichtung: Bei korrekter Einrichtung wartungsfrei.
Wenn Sie die Shopify Flow-basierte serverlose Automatisierungsarchitektur an Ihre eigenen Abläufe anpassen möchten Unser Service für Shopify-Integrationslösungen umfasst auch den Flow-Einrichtungs- und Testprozess.
Welche Lösung sollten Sie wählen?
Der Punkt, an dem sich die beiden Lösungen unterscheiden, ist das Anforderungsprofil: CompliTR sammelt aktiv Daten vom Kunden im Warenkorb; Flow verarbeitet und leitet die Daten weiter, die der Kunde bereits in das Adressfeld eingegeben hat.
Kurze Empfehlung: Wenn Sie eine Schnittstelle zur Datenerfassung vom Kunden im Warenkorb benötigen und eine wartungsfreie, schnelle Lösung wünschen, dann CompliTR. Wenn die Daten bereits im Adressfeld eingegeben werden und Sie den Prozess in Ihr eigenes Automatisierungsnetzwerk einbinden möchten, dann Shopify Flow.
Beide funktionieren auch zusammen: Sie können Daten mit CompliTR im Warenkorb sammeln und die nachfolgenden operativen Schritte dann mit Flow verketten.
Das große Ganze: Die sich wandelnde Welt von Shopify Flow
Eine viel nachhaltigere Erkenntnis, als nur ein spezifisches Entegra-Problem zu lösen, ist folgende: Das Mieten eines Remote-Servers oder das Einrichten einer benutzerdefinierten Webhook-Infrastruktur für die kleinste Datenübertragung, bedingte Schreibvorgänge oder API-Auslösung ist nicht länger die erste Option.
Shopify Flow eliminiert diese Kosten, indem es Sicherheit und operative Kontrolle direkt innerhalb von Shopify hält. Durch die Speicherung von App-Tokens in Flow Secrets und die Einrichtung komplexer Abläufe mit über 20 Schritten, ohne das Shopify-Ökosystem zu verlassen, sinkt der Betriebsaufwand auf nahezu Null.
Dies ist kein Trend, sondern eine architektonische Verschiebung. Wir bei Nodus Works haben beobachtet, dass Shops, die Flow aktiv nutzen, sowohl die Einrichtungs- als auch die Wartungskosten im Vergleich zu Shops, die für dieselben Szenarien externe Server einrichten, erheblich senken. Um eine Zahl zu nennen: Die durchschnittlichen monatlichen Serverkosten von 40-80 $ für eine einzelne Integration sinken in der Flow-Architektur auf Null.
Wenn Sie in Ihren E-Commerce-Operationen ähnliche Engpässe erleben, bewerten Sie die eigenen Fähigkeiten von Shopify, 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. Nach der Erstellung einer Bestellung kann die billing_address nicht über die API geändert werden; dies ist eine feste Einschränkung in der Shopify-Architektur. Nur die shipping_address kann aktualisiert werden. Daher wird die Steuer-ID in das Feld shipping_address.company geschrieben und die Lesepriorität von Entegra entsprechend angepasst.
Kann ich in einem Nicht-Plus-Shop Felder zum Checkout hinzufügen? Nein. Shopify hat Checkout Extensibility nur für den Plus-Plan freigegeben. In Standard-Shops kann die Checkout-Benutzeroberfläche nicht angepasst werden. 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 Daten, wandelt sie in das Format Person;NameNachname;TC um und schreibt sie in das Feld 'company'. Entegra liest dieses Format und startet den E-Rechnungsfluss für Privatkunden.
Ist ein externer Server wirklich nicht erforderlich? Ja. CompliTR läuft auf der Anwendungsplattform; Sie mieten keinen Server. Flow hingegen läuft vollständig innerhalb von Shopify. In beiden Szenarien sind die Kosten für externe Infrastruktur null.
Wie werden Geschäftsrechnungen von Shopify an Entegra gesendet? Um Geschäftsrechnungsdaten von einem Shopify-Shop an Entegra zu übertragen, werden die Informationen des Kunden wie Steuernummer, Finanzamt und Firmenname im Format Firma;Firmenname;Steuernummer;Finanzamt in das 'company'-Feld der Bestellung geschrieben. Da in Shops ohne Shopify Plus der Checkout nicht angepasst werden kann, werden die Daten im Warenkorb gesammelt und bei der Bestellung automatisch in das Feld shipping_address.company übertragen.
Wie wird die TC-Nummer in Shopify erfasst? In Shops ohne Shopify Plus kann die TC-Nummer nicht durch Hinzufügen eines zusätzlichen Feldes zum Checkout erfasst werden. Die praktische Methode besteht darin, dass der Kunde die TC-Nummer in das Feld für Adressdetails eingibt und diese Daten über eine Automatisierung (CompliTR oder Shopify Flow) im Format Person;NameNachname;TC in das Feld shipping_address.company geschrieben werden.
Warum ist die Shopify billing_address unveränderlich? Shopify sperrt das Feld billing_address nach der Erstellung einer Bestellung als unveränderlich (immutable). Dies gilt auch über die API; ein PUT /orders/{id}-Aufruf lehnt die Aktualisierung der billing_address ab. Nur die shipping_address kann aktualisiert werden. Diese architektonische Einschränkung macht es in E-Rechnungs-Integrationen in der Türkei erforderlich, über shipping_address.company zu arbeiten.
Fazit
Die Übertragung von Geschäftsrechnungen und TC-Nummern von Shopify an Entegra wird mit der richtigen Architektur ohne externen Server gelöst. Für eine schnelle und fertige Lösung bietet sich CompliTR an; für bedingte Verzweigungen und die Integration in das eigene Automatisierungsnetzwerk Shopify Flow. Beide lösen dasselbe Problem für unterschiedliche Benutzerprofile und ergänzen sich bei gemeinsamer Nutzung in den Schritten der Datenerfassung und operativen Automatisierung.
Wenn Sie einen ähnlichen Integrationsengpass haben, können Sie von unserem Service für Shopify-Integrationslösungen Unterstützung sowohl für fertige Anwendungen als auch für Flow-basierte serverlose Lösungen erhalten.
