Die Shopify-Nebim-Integration ist eine Systemintegration, bei der Produktkatalog-, Lager-, Bestell-, Rechnungs- und Kundendaten bidirektional zwischen Nebim, dem am weitesten verbreiteten Einzelhandels-ERP in der Türkei, und einem Shopify-Shop synchronisiert werden. Nebim wird häufig von türkischen Unternehmen eingesetzt, insbesondere in den Bereichen Textil, Bekleidung und Omnichannel-Einzelhandel; die Integration mit Shopify ermöglicht es diesen Unternehmen, ihre E-Commerce-Operationen über das ERP-Zentrum zu verwalten. Dieser Leitfaden behandelt die Integrationsarchitektur, den Datenfluss, Middleware-Optionen und die spezifischen türkischen E-Rechnungs-/E-Archivierungsprozesse auf technischer Ebene.
Was ist Nebim und warum wird es mit Shopify integriert?
Nebim ist ein ERP-System, das von Nebim Bilgisayar Hizmetleri mit Sitz in Istanbul entwickelt wurde und in der Türkei, insbesondere in der Mode- und Einzelhandelsbranche, weit verbreitet ist. Es vereint Module für Bestandsverwaltung, Einkauf, Filialverwaltung (POS), CRM, E-Rechnungen und Marktplatzintegration auf einer einzigen Plattform.
Der Bedarf an einer Shopify-Integration ergibt sich typischerweise aus folgenden Szenarien: Das Unternehmen nutzt bereits Nebim und eröffnet einen Shopify-Shop; oder der bestehende Shopify-Shop wächst, manuelle Dateneingabe wird unhaltbar und der Bedarf an einem ERP entsteht. In beiden Fällen sind Bestandsinkonsistenzen, Bestellverzögerungen und Buchhaltungsfehler unvermeidlich, wenn keine Datenbrücke zwischen den beiden Systemen eingerichtet wird.
Die Hauptprobleme, die die Integration löst:
- Wenn der Lagerbestand eines auf Shopify verkauften Produkts nicht in Nebim reduziert wird, wird dasselbe Produkt auch im physischen Geschäft verkauft; dies führt zu Doppelverkäufen und Retourenkrisen.
- Die manuelle Eingabe von Bestelldaten von Shopify in Nebim verursacht bei einem täglichen Bestellvolumen von 50-100 Bestellungen einen Arbeitsaufwand von 2-3 Stunden.
- Für die Ausstellung von E-Rechnungen müssen die Bestelldaten an Nebim übermittelt werden; eine manuelle Übertragung verzögert nicht nur, sondern erhöht auch das Fehlerrisiko.
- Wer Marktplätze wie Trendyol und Hepsiburada über das eigene Integrationsmodul von Nebim verwaltet, möchte auch Shopify in diese zentrale Struktur einbinden.
Technische Architektur der Shopify-Nebim-Integration
Shopify und Nebim sind nicht direkt miteinander verbunden; dazwischen arbeitet eine Middleware (Zwischenschicht) . Diese Middleware kommuniziert mit den APIs beider Systeme, transformiert Daten und verwaltet die Synchronisation.
Grundlegendes Architekturschema:
Shopify Admin API (REST/GraphQL)
↕
Middleware / Integrationsschicht
↕
Nebim API (REST oder SOAP)
Die wichtigsten auf Shopify-Seite verwendeten API-Endpunkte:
- GET /products.json — Produktkatalog abrufen
- POST /inventory_levels/set.json — Lagerbestand aktualisieren
- GET /orders.json — neue Bestellungen abfragen
- Webhook: orders/create, orders/updated — Echtzeit-Bestellbenachrichtigung
Die Integration auf Nebim-Seite erfolgt über die von Nebim angebotenen ERP-API-Dienste. Die API-Infrastruktur von Nebim kann im REST- oder SOAP-Format Dienste bereitstellen; die aktuelle Nebim-Version und der Lizenztyp bestimmen, welche Endpunkte verfügbar sind. Daher sollten Sie vor Beginn der Integration die aktiven API-Module und Versionshinweise von Ihrem Nebim-Berater einholen.
Middleware-Optionen: Standard vs. Eigenentwicklung
Als Nodus Works haben wir beobachtet, dass das häufigste Problem bei Shopify + Nebim-Projekten in der Türkei darin besteht, dass fertige SaaS-Middleware nur verzögert mit aktualisierten API-Versionen von Nebim kompatibel ist. Bei größeren Versions-Updates von Nebim (z. B. 7.x → 8.x) ändern sich einige Endpunktformate; die Integration bricht stillschweigend, bevor die Middleware aktualisiert wird, und der Fehler wird erst bemerkt, wenn Bestandsinkonsistenzen auftreten. Aus diesem Grund bevorzugen wir die Entwicklung einer kundenspezifischen Middleware, insbesondere bei über 500 SKUs und einem täglichen Bestellvolumen von über 100.
Synchronisierte Daten und Flussrichtungen
Bei der Shopify-Nebim-Integration ist es entscheidend, genau zu definieren, welche Daten in welche Richtung fließen, sowohl für das architektonische Design als auch für die Fehlerbehebung.
Kritische Entscheidung bei der Bestandssynchronisation: Echtzeit (Webhook-basiert) oder periodisch (Polling)?
Da die Echtzeit-Synchronisation durch einen Webhook ausgelöst wird, spiegelt sich eine Bestandsänderung sofort in Shopify wider. Allerdings muss auf Nebim-Seite Webhook-Unterstützung vorhanden sein; ist dies bei älteren Nebim-Versionen nicht der Fall, ist das regelmäßige Abfragen von Nebim durch die Middleware (Polling) die einzige Option. Ein Polling-Intervall von 15 Minuten ist ausreichend für ein tägliches Bestellvolumen von bis zu 200-300 Bestellungen; bei höherem Volumen oder während Flash-Sales kann das Risiko von Bestandsdiskrepanzen entstehen.
Wichtiger Hinweis: Bei einer Bestandsstruktur mit mehreren Standorten (Zentrallager + Filiallager) muss die Logik der Bestandsstandorte von Shopify mit der Lagerstruktur von Nebim abgeglichen werden. Wird nur der Gesamtbestand übertragen, ohne diesen Abgleich vorzunehmen, kann Shopify nicht wissen, von welchem Lager aus versendet werden soll, und es kommt zu Fulfillment-Fehlern.
Produktkatalog-Synchronisation: Zu beachtende Punkte
Die Produktübertragung von Nebim zu Shopify ist der komplexeste und fehleranfälligste Schritt. Das Produktdatenmodell von Nebim und das Produktmodell von Shopify stimmen nicht exakt überein.
Variantenabgleich: In Nebim werden Größen- und Farbkombinationen als separate SKUs geführt. In Shopify hingegen werden sie als Varianten unter einem einzigen Produkt gelistet. Die Middleware muss die separaten SKUs von Nebim in die product_id + variant_id-Struktur von Shopify umwandeln. Eine Mapping-Tabelle, die die Größen-/Farbkombinationen bei dieser Umwandlung korrekt zuordnet, ist zwingend erforderlich.
Bilder: Nebim speichert Produktbilder als Dateipfadreferenzen; Shopify benötigt jedoch die CDN-URL des Bildes. Für die Bildübertragung werden entweder die Bilddateien aus Nebim in die Files API von Shopify hochgeladen oder es wird eine URL-Referenz über ein externes CDN verwendet.
Produktbeschreibungen und SEO-Felder: Die Produktbeschreibungsfelder von Nebim sind in der Regel logistikorientiert (z. B. Materialcode, Lieferantencode). Für die SEO-Beschreibung und den Meta-Titel in Shopify werden entweder zusätzliche Felder in Nebim hinzugefügt oder eine manuelle Anreicherung auf Shopify-Seite vorgenommen. Unser bevorzugter Ansatz bei Nodus Works: Die grundlegenden Produktdaten kommen aus Nebim, die SEO-Optimierung erfolgt im Shopify Admin und diese Felder werden nicht durch die Integration überschrieben.
Tipp: Überprüfen Sie die Qualität der Produktdaten in Nebim, bevor die Integration beginnt. Fehlende Barcodes, inkonsistente Kategoriecodes oder leere Produktbeschreibungen werden in die Integration übernommen und verursachen dieselben Probleme in Shopify. Die Datenbereinigung ist Teil der Integrations-Einrichtung, nicht danach.
E-Rechnung und E-Archiv-Integration
In der Türkei machen die E-Rechnungs- und E-Archiv-Pflichten der GİB die Shopify-Nebim-Integration nicht nur operativ, sondern auch rechtlich zwingend. Nebim kann E-Rechnungen über einen von GİB zugelassenen E-Rechnungs-Integrator ausstellen; dieser Prozess kann ausgelöst werden, wenn eine Shopify-Bestellung an Nebim übertragen wird.
Ablauf des Prozesses:
- Zahlung in Shopify abgeschlossen → Webhook ausgelöst
- Middleware wandelt Bestelldaten in das Nebim-Format um: Kundenname, Steuernummer (bei B2B-Bestellungen), Produktliste, Preis, Mehrwertsteuer
- Nebim erfasst die Bestellung im System
- Das E-Rechnungsmodul von Nebim verbindet sich mit dem von GİB zugelassenen E-Rechnungs-Integrator und stellt die Rechnung aus
- E-Rechnungs-PDF und UBL-TR XML werden automatisch an den Kunden übermittelt
Kritischer zusätzlicher Schritt für B2B-Kunden: Ein spezielles Feld zur Erfassung der Steueridentifikationsnummer (VKN) im Shopify-Checkout ist obligatorisch. Das Standard-Checkout von Shopify verfügt nicht über dieses Feld; es wird über Checkout Extensibility (Plus) oder eine spezielle App hinzugefügt. Wir bei Nodus Works haben beobachtet, dass etwa 60 % der Shopify-Shops, die B2B-Bestellungen erhalten, dieses Feld im Checkout nicht hinzufügen und bei jeder Bestellung separat mit dem Kunden kommunizieren, um die VKN zu erhalten. Dies beeinträchtigt sowohl das Kundenerlebnis als auch verzögert die Rechnungsstellung.
Marktplatz-Integration: Omnichannel-Management über Nebim
Das Marktplatz-Integrationsmodul von Nebim kann direkte Verbindungen zu Plattformen wie Trendyol, Hepsiburada, n11 und Amazon herstellen. In dieser Struktur wird Shopify ebenfalls als an Nebim angebundener Vertriebskanal hinzugefügt, und die Bestands-, Bestell- und Rechnungsverwaltung aller Kanäle erfolgt zentral.
Der Vorteil der Omnichannel-Struktur: Wenn der Lagerbestand bei einer Trendyol-Bestellung sinkt, spiegelt sich diese Änderung in Nebim wider, und der Shopify-Bestand wird ebenfalls über Nebim aktualisiert. Lagerbestandsüberschneidungen zwischen den Kanälen werden eliminiert.
Achtung: Wer die Marktplatzintegration über Shopify und nicht über Nebim einrichtet (z. B. mit den Trendyol-Integrations-Apps von Shopify), stößt auf ein Problem mit doppelten Quellen. Wenn Shopify und Nebim gleichzeitig versuchen, Trendyol-Bestellungen unabhängig voneinander abzurufen, kommt es zu Konflikten bei den Bestands- und Bestelldaten. Daher muss die Architektur klar festgelegt werden: Ist Nebim das Master-System oder Shopify?
Wir bei Nodus Works haben beobachtet, dass bei der Mehrheit der Omnichannel-Händler in der Türkei Nebim das natürliche Master-System ist und die tatsächlichen Bestandsdaten dort geführt werden. In dieser Struktur wird Shopify als Verkaufskanal vor Nebim positioniert; alle Geschäftsregeln werden in Nebim ausgeführt.
Integrations-Einrichtungsprozess: 4 Phasen
Phase 1: Analyse und Datenmapping (1-2 Wochen)
- Nebim Versions- und Lizenzprüfung: Welche API-Module sind aktiv?
- Analyse des Produktdatenmodells: Wie viele SKUs, wie viele Varianten, welche benutzerdefinierten Felder?
- Lagerstruktur: Einzellager oder Mehrfachlager?
- Bestellfluss: Erfolgt die Speditionsintegration über Nebim oder über Shopify?
- Ist E-Rechnung obligatorisch? Gibt es B2B-Bestellungen?
Phase 2: Middleware-Entwicklung oder -Konfiguration (2-4 Wochen)
Wenn eine fertige Middleware gewählt wurde: API-Schlüssel werden konfiguriert, Feldzuordnungen (Field Mapping) definiert, Datenfluss in der Testumgebung validiert.
Wenn eine kundenspezifische Entwicklung gewählt wurde: API-Integrationsschicht, Fehlerverwaltung und Wiederholungsmechanismus (Retry), Protokollierungssystem werden eingerichtet.
Phase 3: Test und Datenvalidierung (1-2 Wochen)
- Produktdatentransfertest: Wurden 50-100 Produkte aus Nebim korrekt nach Shopify übertragen?
- Bestandssynchronisationstest: Wird Shopify aktualisiert, wenn sich der Bestand in Nebim ändert?
- Bestellzyklustest: Testbestellung in Shopify → Wird sie in Nebim empfangen? → Wird eine E-Rechnung ausgestellt?
- Lasttest: Systemverhalten bei gleichzeitigem Eingang von 50 Bestellungen
Phase 4: Go-Live und Überwachung (1 Woche)
- Stufenweiser Go-Live: Zuerst Test mit Live-Traffic bei geringem Volumen
- Tägliche Protokollprüfung für die ersten 30 Tage
- Bestandsabweichungsbericht: Nebim- und Shopify-Bestandswerte werden täglich verglichen
- Fehlerbenachrichtigung: Sofortiger Alarm bei kritischen Fehlern (Bestellung konnte nicht übertragen werden, Bestand konnte nicht aktualisiert werden)
Häufige Fehler und deren Lösungen
1. Inkompatibilität der Produkt-ID
Der Produktcode in Nebim und die product_id in Shopify können unterschiedliche Formate haben. Die Middleware muss diese Zuordnung in ihrer eigenen Datenbank speichern. Wenn die Zuordnung unterbrochen wird, weil ein Produkt gelöscht und neu erstellt wurde, werden Bestandsaktualisierungen dem falschen Produkt zugewiesen.
2. Bestandsrücksetzungsfehler
Wenn die Middleware nach einem Verbindungsabbruch neu startet, kann die „anfängliche Bestandssynchronisierung“ alle Shopify-Bestände auf Null setzen. Ein separater Schutzmechanismus für das „Senden von Nullbestand“ ist im Wiederholungsmechanismus unerlässlich.
3. Verzögerungen bei der Preisaktualisierung
Wenn in Nebim ein Saisonendrabatt angewendet wird, kann es Stunden dauern, bis die Preise in Shopify widergespiegelt werden. Durch hochfrequente periodische Synchronisierung oder Webhooks auf Nebim-Seite wird diese Verzögerung minimiert.
4. Doppelte Auftragserstellung
Dieselbe Shopify-Bestellung kann aufgrund eines Netzwerk-Timeouts zweimal an Nebim gesendet werden. Die Verwendung der Bestellnummer als Idempotenzschlüssel bei jeder Integrationsanfrage verhindert diesen Fehler.
FAQ
Wie werden Shopify und Nebim integriert?
Es gibt keine direkte Verbindung; eine Middleware arbeitet dazwischen. Die Middleware kommuniziert mit den Shopify Admin APIs und Nebim APIs, um Produkt-, Bestands-, Bestell- und Rechnungsdaten bidirektional zu synchronisieren. Fertige SaaS-Middleware oder kundenspezifische Entwicklungslösungen sind verfügbar; die Wahl hängt vom Bestellvolumen und dem Anpassungsbedarf ab.
Wie lange dauert die Shopify-Nebim-Integration?
Mit fertiger Middleware dauert es 2-4 Wochen, mit kundenspezifischer Entwicklung 6-10 Wochen. Die kritischsten Faktoren, die die Dauer beeinflussen, sind: die Nebim-Version und der API-Zugangsstatus, die Komplexität des Produktkatalogs sowie die Anforderungen an die E-Rechnungs- und Marktplatzintegration.
Wird der Bestand von Nebim in Echtzeit an Shopify aktualisiert?
Dies hängt von der Webhook-Unterstützung von Nebim ab. Wird dies unterstützt, spiegelt sich eine Bestandsänderung innerhalb von Sekunden in Shopify wider. Wird dies nicht unterstützt, führt die Middleware eine periodische Abfrage (Polling) durch; die Aktualisierung erfolgt dann in Intervallen von 5-15 Minuten. Während Flash-Sales ist eine Echtzeit-Synchronisierung unerlässlich.
Werden Bestellungen in Shopify automatisch in E-Rechnungen umgewandelt?
Ja, bei einer korrekt konfigurierten Integration wird die Shopify-Bestellung an Nebim übertragen, und das E-Rechnungsmodul von Nebim erstellt die Rechnung automatisch über den GİB-Integrator. Bei B2B-Bestellungen müssen die VKN-Informationen des Kunden im Shopify-Checkout erfasst werden.
Ich nutze Nebim und Trendyol gleichzeitig, wie integriere ich Shopify?
Positionieren Sie Nebim als Master-System. Trendyol und Shopify fungieren als zwei separate, an Nebim angebundene Vertriebskanäle. Die Bestands- und Auftragsverwaltung erfolgt über Nebim. Verwenden Sie keine separate Trendyol-Integrationsanwendung für Shopify, da widersprüchliche Datenquellen zu Bestandsinkonsistenzen führen.
In welchen Nebim-Versionen funktioniert die Shopify-Nebim-Integration?
Die Integration ist in Versionen anwendbar, in denen das API-Modul von Nebim aktiv ist. Nebim 7.x und höher bieten in der Regel REST-API-Unterstützung; ältere Versionen verwenden SOAP-Dienste. Bevor Sie mit dem Projekt beginnen, fordern Sie die aktiven API-Endpunkte und die Versionsdokumentation von Ihrem Nebim-Berater an.
Wie funktioniert die Nebim-Bestandssynchronisierung in Shopify?
Die Middleware fragt die Bestands-API von Nebim ab und sendet Änderungen an den inventory_levels/set.json-Endpunkt von Shopify. Für Echtzeit wird ein Webhook-basierter Trigger verwendet; falls kein Webhook vorhanden ist, kommt periodisches Polling zum Einsatz. In einer Multi-Standort-Struktur muss jedes Nebim-Lager dem entsprechenden Bestandsstandort in Shopify zugeordnet werden.
Welche API-Endpunkte sind für die Shopify-Nebim-Integration erforderlich?
Auf Shopify-Seite: Endpunkte für products, variants, inventory_levels, orders, refunds. Auf Nebim-Seite: Dienste für Produktlistung, Bestandsabfrage/-aktualisierung, Auftragserstellung und E-Rechnungs-Auslösung. Die benötigten Endpunkte variieren je nach Nebim-Lizenzpaket und -Version.
Welche Daten sind für die Auftragsübertragung von Shopify an Nebim erforderlich?
Bestellnummer, Bestelldatum, Kundeninformationen (Name, Adresse, E-Mail), Produkt-SKUs und -Mengen, Preis- und Mehrwertsteuerinformationen, Lieferadresse und gewählte Versandmethode. Bei B2B-Bestellungen ist die Umsatzsteuer-Identifikationsnummer des Kunden obligatorisch.
Fazit
Wird die Shopify-Nebim-Integration nicht mit der richtigen Architektur eingerichtet, birgt sie das Risiko kritischer operativer Probleme wie Bestandsdiskrepanzen, doppelter Bestellungen und Rechnungsverzögerungen. Bei korrekter Implementierung reduziert sie den manuellen Arbeitsaufwand pro Bestellung auf nahezu null und ermöglicht die Verwaltung des Omnichannel-Vertriebs über ein zentrales ERP-System.
Kontaktieren Sie Nodus Works, um Ihre Nebim + Shopify-Integration zu konzipieren, Fehler in Ihrer bestehenden Integration zu beheben oder die Middleware-Architektur neu zu strukturieren. Lassen Sie uns gemeinsam die API-Infrastruktur von Nebim und die Integrationsanforderungen von Shopify vor Ort bewerten, um die richtige technische Entscheidung zu treffen.
