Anbindung von Shopify

Shopify wird per API angebunden: Es werden keine Excel-Vorlagen benötigt, shopvibes überträgt Produktdaten, Preise und auf Wunsch auch Bestände direkt in Ihren Shop. Angelegt wird ein Partner vom Typ „Shopify API“.

Wie shopvibes Produkte in Shopify zuordnet

Jedes Produkt wird über ein Metafeld identifiziert. Welches Metafeld das ist, legen Sie in den Einstellungen des Shopify-Partners im Feld „Produkt SKU Metafield“ fest (z. B. custom.artikelnummer). Welcher Wert dort hineingeschrieben wird, bestimmt das Mapping des Partners – üblicherweise die Artikelnummer bzw. der Unique Identifier des Produkts.

Bei jeder Übertragung sucht Shopify nach einem Produkt mit diesem Wert:

• Wert im Shop vorhanden → das bestehende Produkt wird aktualisiert.
• Wert im Shop nicht vorhanden → ein neues Produkt wird angelegt.

Dabei spielt es keine Rolle, ob das Produkt ursprünglich von shopvibes angelegt wurde. Auch Produkte, die bereits in Ihrem Shop stehen, werden aktualisiert, sobald das Metafeld den passenden Wert enthält. Sie können also einen bestehenden Shop anbinden, ohne dass alle Artikel neu angelegt werden – pflegen Sie dafür vor der ersten Übertragung den passenden Wert in das Metafeld der vorhandenen Produkte ein.

Doppelte Produkte vermeiden

Ändert sich der Wert des Metafelds, erkennen wir das Produkt nicht wieder und legen es im Zweifelsfall erneut an. Das alte Produkt bleibt mit dem alten Wert im Shop stehen, daneben entsteht ein zweites mit dem neuen Wert. Alle weiteren Aktualisierungen (Texte, Preise, Bestände, Bilder) laufen ab diesem Zeitpunkt nur noch auf das neue Produkt.

Andere Änderungen sind dagegen unkritisch: Titel, Beschreibung, Preise, Bestände oder Bilder dürfen sich jederzeit ändern. Entscheidend ist allein, dass der Wert im UID-Metafeld gleich bleibt.

So vermeiden Sie Duplikate:

• Behandeln Sie den Wert im UID-Metafeld wie eine feste ID: einmal vergeben, danach nicht mehr ändern.
• Vergeben Sie den Wert eines bestehenden Artikels nie neu an einen anderen Artikel, sonst wird das falsche Shopify-Produkt überschrieben.
• Innerhalb von shopvibes lässt sich der Unique Identifier eines Produktes ohnehin nicht ändern. Ein neuer Wert entsteht nur, wenn ein Artikel kopiert und der alte gelöscht wird. Für Shopify ist das ein neues Produkt.
• Wenn Sie in Ihrem Quellsystem Nummernkreise umstellen müssen, melden Sie sich vorab bei uns. Wir können die Zuordnung im Shop dann vor der nächsten Übertragung anpassen, statt hinterher Duplikate aufzuräumen.

Wenn bereits Duplikate entstanden sind

1. Prüfen Sie in Ihrem Shopify-Adminbereich, welches der beiden Produkte den aktuellen Wert im UID-Metafeld trägt. Dieses Produkt wird von shopvibes weiter gepflegt.
2. Archivieren oder löschen Sie das veraltete Produkt in Shopify. Beachten Sie dabei, dass Shop-URL, Bewertungen und interne Verlinkungen am alten Produkt hängen. Richten Sie bei Bedarf eine Weiterleitung auf das neue Produkt ein.
3. Melden Sie sich bei uns, wenn unklar ist, welches Produkt das aktuelle ist oder wenn mehrere Artikel betroffen sind.

Einstellungen des Shopify-Partners

Alle Einstellungen finden Sie in shopvibes unter „Partner“ → Ihr Shopify-Partner → „Einstellungen“, Bereich „Übertragungseinstellungen“.

Einstellung	Bedeutung
Shop URL	Adresse Ihres Shops, z. B. https://ihr-shop.myshopify.com.
API Key	Zugangsschlüssel der Shopify-App, über die shopvibes auf den Shop zugreift.
Produkt SKU Metafield	Metafeld, über das Produkte identifiziert werden (siehe oben), im Format namespace.key.
Inventory Location ID	Shopify-Standort, dessen Bestand gepflegt wird. Wird für die Bestandsübertragung benötigt.
Update Stock	Überträgt die Lagerbestände an den oben gewählten Standort.
Enable Shopify Markets	Überträgt zusätzlich marktspezifische Preise in die Preislisten Ihrer Shopify-Markets-Kataloge.
Transmit Translations	Überträgt die in shopvibes gepflegten Übersetzungen an Shopify.
Ignore Media Files	Überträgt keine Bilder. Sinnvoll, wenn die Bilder im Shop selbst gepflegt werden.
Update Delivery Profiles	Ordnet Varianten dem im Mapping hinterlegten Versandprofil zu (Zuordnung über den Profilnamen in Shopify).
Disable EAN Matching	Ordnet bestehende Varianten nur noch über die Artikelnummer zu, nicht mehr zusätzlich über die EAN. Hilfreich, wenn mehrere Artikel dieselbe EAN haben (z. B. B-Ware).

Bestandsübertragung einrichten

Damit shopvibes Ihre Lagerbestände automatisch überträgt, muss die Option „Update Stock“ aktiviert und eine „Inventory Location ID“ hinterlegt sein. Diese ID stammt aus Ihrem Shopify-Adminbereich und hat nichts mit IDs aus anderen angebundenen Systemen (z. B. Mirakl) zu tun.

1. Shopify-Partner in shopvibes öffnen

   1. Navigieren Sie in shopvibes zu „Partner“.
   2. Klicken Sie in der Partnerliste auf Ihren Shopify-Partner (Partner vom Typ „Shopify API“).

   

2. Einstellungen des Partners aufrufen

   1. Klicken Sie in der linken Navigation des Partners auf „Einstellungen“.

   Im Bereich „Übertragungseinstellungen“ finden Sie u. a. die Felder Shop URL, Produkt SKU Metafield, Inventory Location ID und API Key sowie mehrere Schalter, darunter „Update Stock“.

   

3. Shopify Location ID ermitteln

   1. Melden Sie sich in Ihrem Shopify-Adminbereich an.

   2. Navigieren Sie zu Einstellungen > Standorte (Settings > Locations).

   3. Öffnen Sie den Standort, dessen Bestand an shopvibes übertragen werden soll.

   4. Die Location ID ist die Zahl am Ende der URL der Standort-Detailseite, z. B. bei .../settings/locations/62831378455 ist die Location ID 62831378455.

      • In shopvibes wird nur diese reine Zahl benötigt – nicht das vollständige Shopify-Format gid://shopify/Location/....
      • Diese ID wird ausschließlich in Ihrem Shopify-Adminbereich vergeben. Sie hat keinen Bezug zu IDs aus Mirakl oder anderen Partnersystemen.

4. Location ID eintragen und Bestandsübertragung aktivieren

   1. Tragen Sie die ermittelte Zahl in das Feld „Inventory Location ID“ ein.
   2. Aktivieren Sie den Schalter „Update Stock“.
   3. Klicken Sie auf „Partner aktualisieren“, um die Einstellungen zu speichern.

   

   Sobald gespeichert, überträgt shopvibes die Lagerbestände Ihrer Produkte automatisch an den angegebenen Standort in Shopify.

Metafelder und Daten aus anderen Apps

• shopvibes kann beliebige Metafelder befüllen. Dafür wird im Mapping des Partners eine Zeile im Format metafields.namespace.key angelegt.
• Metafelder anderer Apps (z. B. Bewertungen, SEO, Loyalty) bleiben bei der Übertragung erhalten und werden nicht überschrieben. Auch SEO-Titel und -Beschreibungen sind geschützt.
• Die Sichtbarkeit eines Produkts steuert das Feld „Status“ im Mapping (draft, active, archived). Es wird bei jeder Übertragung mitgeschickt: Steht dort fest draft, werden die Produkte bei jeder Übertragung wieder auf „Entwurf“ gesetzt.

Was beim Delisting passiert

Wenn Sie Produkte für den Shopify-Partner delisten, löscht shopvibes sie nicht aus dem Shop, sondern:

• setzt den Bestand der betroffenen Varianten auf 0 (sofern „Update Stock“ aktiv ist) und verhindert den Verkauf bei Bestand 0,
• archiviert das Produkt, sobald alle seine Varianten delistet sind.

Weitere Hilfestellungen

• Wie kann ich den Unique Identifier eines Produktes ändern?
• Partnerverwaltung
• Bei Fragen stehen wir jederzeit unter success@shop-vibes.de zur Verfügung.