Benutzer-Werkzeuge

Webseiten-Werkzeuge


public:faqshopify-tradebye

Shopify Connector für Tradebyte TB.One

Ablauf einer Integration

Vorbedingungen:

  • Der Shopbetreiber hat bereits ein TB.One und Produktdaten darin angelegt.
  • Es gibt einen dedizierten TB.One Kanal für den Shopify Shop (custom channel).
  • Die App funktioniert mit jedem Shopify Plan, wir empfehlen den Plan GrowShopify Preise.

Ablauf:

  1. Haben Sie bereits einen Shopify, teilen Sie uns bitte Ihre MyShopify URL mit, damit wir eine Anfrage auf Shopzugriff stellen können, um die private Shopify App zu konfigurieren. Haben Sie noch keinen Shopify, erstellen wir gerne einen für Sie und übergeben Ihnen den Shop mit bereits eingerichtetem Connector.
  2. In TB.One legen Sie einen API-Benutzer an und teilen uns die API-Zugangsdaten auf einem sicheren Weg mit. https://www.tradebyte.io/how-to/generate-rest-api-credentials-in-tb-one/
  3. Wir richten den Connector ein und importieren die Produkte aus Ihrem TB.One Channel in Ihren Shopify.
  4. Sie überprüfen, ob alle Daten an den gewünschten Stellen in Shopify angezeigt werden. Probleme lösen wir gemeinsam.
  5. Sie erstellen möglichst vielfältige und unterschiedliche Testbestellungen, die wir per connector an TB.One übertragen.
  6. Sie überprüfen, ob die Übermittlung und Verarbeitung der Bestellungen in Tradebyte korrekt funktioniert.
  7. Geänderte Bestellstatus werden von unserem Connector wieder an Ihren Shopify gesendet.
  8. Kontrollieren Sie verschiedene Status in Tests (Versendet, Storniert, Retourniert…)
  9. Wenn alle Tests erfolgreich waren und Sie alle übrigen Arbeiten (Design des Shops, Contentseiten pflegen etc.) erledigt haben, kann Ihr Shop online gehen.
  10. Bei Problemen im Laufenden Betrieb hilft Ihnen unser Support Team kurzfristig.

Installation der App

Es handelt sich um eine offizielle Shopify APP, allerdings ist diese „not listed“, also nicht öffentlich im Shopify Store zu finden. Dies ist so umgesetzt, damit nur Tradebyte Kunden die App buchen.

Um die App zu installieren, loggen Sie sich bitte in Ihren Shopify Store Admin ein. Sobald Sie eingelogt sind, rufen Sie bitte im selben Browser folgende URL auf: https://apps.shopify.com/tradebyte-connector Dort finden Sie den Button zum Installieren der App.

Sobald Sie den Button geklickt haben, werden Sie asuf die Konfigurationsmakse geleitet, wo Sie Ihre TB.One API Zugangsdaten eingeben müssen. Es empfiehlt sich, den Kanal vorher passend einzurichten. Sobald die App installiert ist, startet der Produktsync von Tradebyte zu Shopify.

Bei der Einrichtung zu beachten (Checklist)

  • Sind alle in Shopify genutzten Zahlarten-Identifier in TB.One angelegt? Wenn nicht, in TB.One anlegen.
  • Sollen Produkte (In der Regel bei Bekleidung) in Shopify nach Farben aufgeteilt werden? Wenn ja, die entsprechende Option in der Connector-Konfiguration setzen. Wenn die Option genutzt wird, gibt es ein neues Metafiled variant_siblings am Produkt, welches die anderen Farben verknüpft. Mit folgendem liquid Snippet können die anderen Farben auf der Detailseite angezeigt werden (bitte in in sections/main-product.liquid ergänzen):
<!-- Tradebyte start -->
<div class="related-products-wrapper">
{% assign related_products = product.metafields.custom.variantsiblings.value %}

{% if related_products %}
<legend class="label">Farbe: <span class="cc-color-name">{{ product.selected_or_first_available_variant.metafields.custom.farbbezeichnung | metafield_tag  }}</span></legend>
<ul class="cc-variant-list" style="display:flex; gap:8px;">
	<li>
	  <div class="current-product">
		<div class="current-product-image">
		  <img src="{{ product.images[1] | img_url: 'medium' }}" alt="{{ product.title }}" style="width:75px;" />
		</div>
	  </div>
	</li>
  {% for related_product in related_products %}
	<li>
	  <a href="{{ shop.url | append: '/products/' | append: related_product.handle }}">
		<div class="related-product">
		  <div class="related-product-image">
			<img src="{{ related_product.images[1] | img_url: 'medium' }}" alt="{{ related_product.title }}" style="width:75px;" />
		  </div>
		</div>
	  </a>
	</li>
  {% endfor %}
</ul>
{% endif %}
</div>
<!-- Tradebyte end -->
  • Wird ZEOS genutzt? Bei Nutzung von ZEOS Versand müssen die Locations entsprechend den TB.One-Zeos-Kanälen in Shopify konfiguriert und die Location-IDs in der Connector-Konfiguration angelegt werden.
  • Gibt es bereits Bestellungen im genutzten TB.One-Kanal? Wenn ja, empfiehlt sich die Konfiguration eines Bestellnummern-Präfix in Shopify, um Doppellungen bei den Bestellnummern in TB.One zu vermeiden.
  • Der Connector benötigt eine TB.CAT Version 1.2 bis 1.4. Die Classification-Ausgabe muss aktiviert sein (Beides macht der Tradebyte support).

Konfigurationsmöglichkeiten im Admin Interface

Allgemein

Konfiguration Beschreibung
Kunde ist aktiv? Status des Kunden → aktiv oder inaktiv. Bei der Installation der App in Shopify, wird der Kunde automatisch über einen Webhook im Admin angelegt und ist aktiv. Bei Deinstallation der App wird der Kunde automatisch über einen Webhook inaktiv geschaltet.
Datenführendes System Tradebyte → Datenführendes System ist Tradebyte.
Shopify (Noch nicht vollständig implementiert) → Datenführendes System ist Tradebyte, lediglich für den einmaligen Übertrag der Produkte von Shopify zu Tradebyte vorgesehen.
Registrierungsdatum Datum der Registrierung des Kunden im Admin Interface bzw. Installation der App.
Größe letzter Produktfeed Die Größe des letzten Produkte-Feed (TB.CAT) in Byte. Über den Button Zurücksetzten kann die Feed Größe des letzten Produkte-Feed zurückgesetzt werden, um den Job ausführen zu können, obwohl die aktuelle Feedgröße wesentlich kleiner ist.
Kommentar Textfeld für Kommentare.

Stammdaten

Konfiguration Beschreibung
Firma, Vorname, Nachname, Emailadresse, Webseite, Telefon, Adresse, PLZ und Stadt Die Stammdaten werden von dem Kunden bei der App Konfiguration in Shopify angegeben.

Shopify

Konfiguration Beschreibung
Shopify URL Die Shopify URL des Shops wird bei der App Installation über Webhook übergeben.
Shopify API Pass Das Shopify API Passwort wird bei der App Installation über Webhook übergeben.
Kategorie-Verknüpfungen bei Update von Shopify Artikel aktualisieren Wird ein neues Produkt von Tradebyte in Shopify angelegt, werden die Kategorien immer verknüpft. Ein späterer Abgleich findet aber nur mit dieser aktiven Option statt. Dabei werden in Shopify manuell erstellte Kategoriezuordnungen überschrieben.
Von externen Apps erstellte Shopify Bestellungen NICHT übertragen Wenn diese Option aktiv ist, werden von externen Apps erstellte Shopify Bestellungen nicht zu Tradebyte übertragen. Diese Bestellungen haben meist nicht die korrekten Artikel-IDs und können vom Connector daher nicht zugeordnet werden, außerdem fehlen oft wichtige Daten (z.B. Adressdaten) was zu Problemen bei der Übertragung führen kann.
Shopify Produkte archivieren statt sie zu löschen Wenn ein Produkt nicht mehr im Feed von Tradebyte vorhanden ist, wird dieser normalerweise in Shopify gelöscht. Wenn diese Option aktiv ist, werden die Produkte nicht mehr gelöscht sondern archiviert. Das kann z.B. relevant für die Anzeige der Produkte in der Bestellhistorie des Users in Shopify sein.
Produkt in Shopify nicht löschen Wenn diese Option aktiv ist, werden die Produkte nicht mehr gelöscht und auch nicht archiviert, wenn diese nicht mehr im Feed von Tradebyte enthalten sind.
Metafields in Shopify nicht mehr synchronisieren (löschen) Produkt-Merkmale/Attribute oder Artikel-Merkmale/Attribute werden in Shopify als Metafelder angelegt. Wenn diese Option aktiv ist, werden keine Metafelder mehr in Shopify gelöscht, wenn diese in TB nicht mehr vorhanden sind. Diese Option ist relevant wenn andere Apps Metafelder auf Produkt- bzw. Variantenebene schreiben.
Order Webhook abonnieren Bei aktiver Option werden neue Bestellungen per Webhook an Tradebyte übertragen. Wenn nicht aktiv, werden Bestellungen mit dem Intervall aus dem Job übertragen.
Order Webhook Cooldown Zeit Zeit zwischen den Webhook Ausführungen. Der Order Webhook löst maximal alle x Minuten einen Order Job aus.
Archivierte Bestellungen ignorieren Bei dem Abruf von Shopify Bestellungen werden Bestellungen mit dem Status Archiviert ignoriert und nicht übertragen.
Bilder nicht nach Shopify synchronisieren Dies Option erlaubt es dem Händler seine Produktbilder selbstständig in Shopify pflegen zu können. Betrifft nur das Updaten von Produkten, nicht das Anlegen von Produkten. Bei dem Anlegen werden immer Bilder von Tradebyte übertragen, falls vorhanden.
Shopify Bild Varianten Tagging Diese Option erlaubt es die Bilder von Varianten mit einem Variantenmerkmal zu taggen im Alt-Text in Shopify. Damit können manche Themes nur die Bilder der jeweiligen Variante anzeigen. Aktuell wird das Format #merkmal_wert unterstützt. Also z.B. #farbe_rot. Dafür wäre hier „Farbe“ zu konfigurieren. Wenn ein Artikel das Variantenmerkmal Farbe hat, dann wird der Alt-Text entsprechend gesetzt.

Tradebyte

Konfiguration Beschreibung
Tradebyte Merchant Nr Die Tradebyte Merchant Nr wird durch den Kunden bei der App Konfiguration in Shopify angegeben.
Tradebyte Channel ID Die Tradebyte Channel ID wird durch den Kunden bei der App Konfiguration in Shopify angegeben.
ZEOS: Lieferländer mit verschiedenen Tradebyte Channels verknüpfen Aktiviert die ZEOS Länder-Split Konfiguration. Es können Länder mit den passenden Tradebyte Channel IDs verknüpft werden.
ZEOS: Länder-Split Konfiguration Das Länderkürzel wird hier als 2-Zeichen ISO 3166-1 alpha-2 Country-Code erwartet (z.B. DE für Deutschland). Es können mehrere Länderkürzel angegeben werden - separiert durch ein Komma, aber jedes Land kann nur mit einer Channel-ID verknüpft werden. Eine Bestellung in das konfigurierte Lieferland wird dann in den verknüpften Tradebyte Channel übertragen.
ZEOS: Verhalten bei Bestellungen aus nicht gemappten Ländern Hier kann ausgewählt werden, wie mit Bestellungen aus nicht verknüpften Lieferländern umgegangen werden soll. Folgende Möglichkeiten stehen zur Auswahl:
→ An den Hauptkanal (als Tradebyte Channel ID konfiguriert) übermitteln.
→ Bestellung ignorieren und nicht an Tradebyte übermitteln
Individuelle Preise aus Tradebyte Channels an verschiedene Shopify-Märkte übertragen Über diese Konfiguration können zusätzliche Preise für einen bestimmten Markt in Shopify übertragen werden. Der Default Preis aus dem Hauptkanal wird dabei weiterhin übertragen.
Preis-Split Konfiguration Beide IDs müssen numerisch sein. Die Shopify Markt-ID ist üblicherweise 11-stellig. Die Tradebyte Channel-ID ist üblicherweise 4-stellig. Zudem geht es hier immer um eine 1:1 Beziehung. Dopplungen werden ignoriert.
Mehrere Shopify-Standorte mit Tradebyte Channels verknüpfen (Bestände) Über diese Konfiguration können zusätzliche Bestände für einen bestimmten Markt in Shopify übertragen werden. Der Default Bestand aus dem Hauptkanal wird dabei weiterhin übertragen.
Location-Split Konfiguration Beide IDs müssen numerisch sein. Die Shopify Location-ID ist üblicherweise 11-stellig. Die Tradebyte Channel-ID ist üblicherweise 4-stellig. Zudem geht es hier immer um eine 1:1 Beziehung. Dopplungen werden ignoriert. Wird die als 'Tradebyte Channel ID' konfigurierte ChannelID hier auch zu einer LocationID konfiguriert, so werden Bestände in die hier konfigurierte Location geschrieben. Wenn nicht dann gehen die Bestände in den in Shopify konfigurierten Default-Standort.
Tradebyte Channel Sign Das Tradebyte Channel Kanalkürzel ist in TB.One einsehbar.
Tradebyte API Benutzername Der Tradebyte API Benutzername, dafür müssen Sie in Tradebyte TB.One einen neuen API Benutzer anlegen.
Wie erstelle ich einen REST-API Benutzer in TB.One.
Tradebyte API Passwort Das Tradebyte API Passwort wird ebenfalls bei der Erstellung des REST-API Benutzers angegeben.
Tradebyte Hersteller-Artikelnummer als Metafield in Shopify importieren Wenn aktiv, wird die Hersteller-Artikelnummer jeder Variante aus Tradebyte in ein Metafeld an der Variante in Shopify hinterlegt.
Varianten-Splitting aktivieren Wenn diese Option aktiviert wird, werden Produkte anhand eines Variantenmerkmals in einzelne Hauptartikel (Väter) aufgesplittet. Wenn z.B. Farbe als Variantenmerkmal für die Aufsplittung konfiguriert wird, ist nach dem Import jede Farbe in Shopify ein eigenes Produkt.
ACHTUNG: Das ist keine Option die einfach so umgestellt werden kann. Der Shopify Shop und das Produkt-Mapping müssen geleert werden, bevor ein Import mit neuem Splitting durchgeführt werden kann!
Split Variantenmerkmal Hier wird das Variantenmerkmal konfiguriert, welches gesplittet werden soll z.B. Farbe.
Tradebyte Stage API nutzen Wenn aktiv, wird die Tradebyte Stage-API anstelle der Live-API angesprochen. → (https://reststaging.core.tradebyte.com/)
Produkt Mapping anhand von Tradebyte A_NR generieren SONDERFALL: Für Kunden die Produkte selbst angelegt haben - sprich kein Mapping im Connector existiert - wo aber der Stock im Shopify eingepflegt werden soll. Es wird versucht anhand der TB A_NR den Artikel in Shopify zu finden und dazu wird dann ein Mapping-Eintrag erstellt.
Varianten Gruppierung in variant_siblings Metafield über „gemeinsame Artikelnummer“ Tag SONDERFALL: Aktiviert die Gruppierung von variant_siblings über das TB gemeinsame Artikelnummer Tag
Bullet-Points zur Produktbeschreibung hinzufügen Über diese Option können die Bullet-Points aus TB.One an die Langbeschreibung angehängt, oder vorangestellt werden.

Individuelle Kunden-Konfiguration

Konfiguration Beschreibung
Nur Order-Übertragung Es werden ausschließlich Bestellungen übertragen. Es erfolgt keine Produkt- oder Lagerbestands-Übertragung. (Anpassung der Jobs muss manuell vorgenommen werden)
Nur Bestand-Übertragung Es werden ausschließlich Bestandsupdates durchgeführt. Es erfolgt keine Produkt-Übertragung. (Anpassung der Jobs muss manuell vorgenommen werden)
Nur bezahlte Bestellungen übertragen Bei der Übertragung der Bestellungen werden nur bezahlte Bestellungen übermittelt.
Order-Error Email-Reporting Empfänger Hier können E-Mail-Adressen hinterlegt werden, die im Fehlerfall bei der Bestellübertragung eine E-Mail erhalten sollen. Es können auch mehrere E-Mail Adressen (durch Komma getrennt) angegeben werden.

Trouble Shooting

  • Achtung, beim Tradebyte Vollimport in Richtung Shopify wird nur einmal täglich die Full-XML von TB heruntergeladen. Es macht also keinen Sinn, den Vollimport mehrmals täglich laufen zu lassen. Möchte man das zu Debugzwecken doch tun, muss die bereits heruntergeladene XML mit heutigem Datum manuell per FTP vom Worker gelöscht werden.

Referenzprojekte

Folgende, ausgewählte Shopify Shops setzen den Tradebyte-Connector ein:

public/faqshopify-tradebye.txt · Zuletzt geändert: 2025/07/07 15:12 von kamiarnader