ONIX Daten in Shopify integrieren

[Julia37]

Einer unserer Kooperationspartner möchte regelmäßig ONIX Daten (XML Format) zur Verfügung stellen, um den Bücherkatalog und Bestand im Shop immer aktuell zu halten. Ist die Integration über eine App oder ähnliches möglich? 

[Gabe]

Hey @Julia37 

Danke für die Frage und wie ich sehe, bekommt ihr euren Bücherkatalog und Bestand in der form von Onix Daten (Online Information eXchange) von eurem Lieferanten/Verlag in regelmäßigen Zeitabständen zugesendet, um den Bücherkatalog im Shopify Shop zu aktualisieren.

ONIX ist ein XML-basiertes Format, das in der Buchbranche entwickelt wurde, um Metadaten über Bücher und andere Medienprodukte auszutauschen. Es wird hauptsächlich zwischen Verlagen, Händlern, Bibliotheken und anderen beteiligten Parteien verwendet.

Es gibt die Standard Apps wie Matrixify, StockSync, und EZ-Exporter/Importer. Diese Apps erlauben es deinen Bestand automatisch oder manuell aus CSV-, Excel-, JSON- oder XML-Feeds in regelmäßigen Intervalle zu updaten. Aktualisiere deinen Bestand automatisch von einem FTP/SFTP-Server oder einer Website-URL (z. B. einem freigegebenen Link von Google Sheets oder Dropbox oder einem REST-API-Endpunkt). Du richtest mit ein paar Klicks mehrere Lieferanten-Feeds/Bestandsfeeds ein, die Apps unterstützen auch mehrere Standorte mit automatischen stündlichen oder täglichen Synchronisierungen des Bestands.

ONIX SERVER und die Shopify CSV

ABER ob die Apps mit ONIX XML Daten arbeiten wage ich fast zu bezweifeln, denn das ist ein sehr spezialisierter Format der der Verlag und Bücher Industrie, wie gesagt, vorbehalten ist.

Um die Shopify Produktdaten Struktur kennenzulernen, kannst du folgendes machen: gehe in deinen Produktstamm in Shopify und exportiere ein Testprodukt als Plain/Einfache CSV. Öffne die csv Datei in einer Tabellen App, vorzugshalber Google Sheets und siehe dir die Spalten an und wie sie strukturiert sind (siehe unsere Doku dazu hier). So müsste die Datei deines Verlags strukturiert sein um letztendlich einen Bestand Update in Shopify zu realisieren. Da der ONIX-Standard umfangreich ist und viele unterschiedliche Datenpunkte und Metadaten abdeckt, kann ein typisches ONIX-Dokument kann wie folgt aussehen, was zu bezweifeln wäre, ob es mit Shopify kompatibel ist:

<ONIXMessage release="3.0" xmlns="http://ns.editeur.org/onix/3.0/reference">
 <Header>
   <Sender>
     <SenderName>Verlagsname</SenderName>
     ...
   </Sender>
   <SentDateTime>2022-05-20T12:00:00Z</SentDateTime>
   ...
 </Header>
 <Product>
   <RecordReference>1234567890</RecordReference>
   <NotificationType>03</NotificationType>
   <ProductIdentifier>
     <ProductIDType>15</ProductIDType>
     <IDValue>9781234567890</IDValue>
   </ProductIdentifier>
   <DescriptiveDetail>
     <ProductForm>BK</ProductForm>
     <TitleDetail>
       <TitleType>01</TitleType>
       <TitleElement>
         <TitleText>Titel des Buches</TitleText>
       </TitleElement>
     </TitleDetail>
     ...
   </DescriptiveDetail>
   <CollateralDetail>
     <TextContent>
       <TextType>01</TextType>
       <ContentAudience>00</ContentAudience>
       <Text>Buchbeschreibung hier...</Text>
     </TextContent>
     ...
   </CollateralDetail>
   ...
 </Product>
 ...
</ONIXMessage>

Zunächst sollte man sich mit der genauen Struktur des ONIX-Datenfeeds vertraut machen, um zu verstehen, welche Informationen bereitgestellt werden und wie diese im Shopify-Shop verwendet werden können. Einige wichtige Aspekte einer typischen Struktur:

• Header: Enthält Informationen über den Sender und wann die Nachricht gesendet wurde.
• Product: Ein Abschnitt, der Informationen über ein bestimmtes Produkt (z. B. ein Buch) enthält. Es können mehrere Produktabschnitte in einer ONIX-Nachricht vorhanden sein.
• DescriptiveDetail: Enthält beschreibende Informationen über das Produkt, wie z. B. den Titel, den Autor und die physischen Eigenschaften.
• CollateralDetail: Kann zusätzliche Informationen wie Buchbeschreibungen, Coverbilder und Autoreninformationen enthalten.

Der ONIX-Standard kann aber verschiedene Versionen und Profile haben, die von unterschiedlichen Verlage in der Buchbranche genutzt werden. Die ONIX-Dokumentation und die Spezifikationen eures Partners müsste man somit überprüfen, um sicherzustellen, dass alle notwendigen Daten korrekt in Shopify verarbeitet werden können.

Eine eigene App bauen - ist jetzt etwas einfacher geworden

Du kannst vielleicht eine eigene benutzerdefinierte App von unseren Shopify Experten bauen lassen, als Konvertierungstool da Shopify keine native Unterstützung für das ONIX-Format bietet. Vielleicht ein Skript entwickeln, das ONIX-Daten in ein für Shopify verständliches Format umwandelt, beispielsweise über ein Python- oder JavaScript-Script, das die XML-Datei einliest und diese in eine CSV-Datei umwandelt, die Shopify importieren kann.

Shopify bietet eine API (Anwendungsprogrammierschnittstelle) an, mit der man Produkte programmatisch hinzufügen, aktualisieren oder löschen können. Anstatt die Daten manuell zu importieren, könnte man die API nutzen, um den Prozess zu automatisieren. Gehe in deinen Admin in den Bereich "Apps und Vertriebskanäle" und ganz unten klicke auf "App erstellen":

Lege eine neue App in Apps Dashboard an. Du erhältst dann einen API-Schlüssel und Secret Key, die für den Zugriff auf die Shopify Storefront- und Admin-APIs benötigt werden.

Verwende eine XML-Bibliothek, um ONIX-Dateien zu lesen und zu analysieren. Zum Beispiel, wenn du Python verwendest, kannst du xml.etree.ElementTree oder lxml verwenden. 

• Extrahiere alle relevanten Daten aus dem ONIX-Format (z. B. Buchtitel, ISBN, Beschreibung, Coverbild-URL).
• Konvertiere diese Daten in das von Shopify erwartete Produktformat. Das kann als JSON-Datenstruktur für die Shopify API oder als CSV für den manuellen Import vorbereitet werden.
• Verwende die von Shopify bereitgestellte API, um Produkte zum Shop hinzuzufügen oder zu aktualisieren.

---
Hast du weitere Fragen zum Shop? Gebe einfach ein Suchbegriff oben in der Suchleiste der Community Landingpage ein, denn das Thema haben wir sehr wahrscheinlich schon besprochen. Oder lass wissen, wenn du weitere Fragen dazu hast oder zum Shop und Business und gerne können wir das hier weiter besprechen! Halte bitte Ausschau in deiner E-Mail auf Notifications zu Antworten auf deine Fragen in der Community.