Produktdaten exportieren
Fragestellungen:
- wie exportiere ich Produktdaten
Beschreibung:
Das Produktinformationsmanagement (PIM) aus TYRIOS ist darauf ausgelegt, Produktdaten flexibel an unterschiedlichste Drittsysteme weitergeben zu können. Klassiker wie die Produktweitergabe an den Google Merchant-Center oder Facebook werden dabei genauso unterstützt wie die Echtzeit-Weitergabe der Produktdaten an jedes beliebige Dritt-System.
Das PIM bietet grundsätzlich drei unterschiedliche Export-Funktionen.
- das Export-Framework
- die REST-API-Schnittstelle
- das Webhook-Interface für Echtzeit-Aktualisierungen
Das Export-Framework
Das Export-Framework unterstützt den Export in vordefinierte Dateiformate - z.B. in Form des Google Produktfeeds. Auch andere neue Formate können leicht integriert werden, so dass die Produktweitergabe an Dritt-Systeme mit geringem Aufwand möglich ist.
Von Haus aus unterstützt TYRIOS folgende Export-Formate:
- "CSV"
- "Facebook Katalog" (im Google-Feed-Format)
- "Google Products" (Google-Feed Format in XML)
- "Google Local Products" (Google-Feed Format in XML für lokal verfügbare Produkte)
- "Google Local Inventory" (Lagerbestandsexport für Google Local)
- "XML"
Alle Standard-Export-Formate geben nur öffentliche Daten weiter. Die Einkaufspreise werden nicht weitergeben. Dies kann mit individuellen Exporter-Formaten realisiert werden.
Der Export über das Export-Framework kann auf zwei Arten erfolgen:
- Über die Export-Funktion im Kundenbereich > Produktverwaltung > Artikel exportieren
- Über die Konsole:
php index.php -exportProductData -exporter "[Export-Format]" -language [Sprachen-Kürzel] -output [Ausgabedatei] -affiliate [Affiliate-ID]
Sollte der Export regelmäßig erfolgen, so muss ein Cronjob eingerichtet werden. Dieser könnte am Beispiel von Google Products so aussehen:
php index.php -exportProductData -exporter "Google Products" -language de -output ./export/productData.xml -affiliate 1
Durch die Verwendung der Konsole ist sichergestellt, dass kein Export unbeabsichtigt ermöglicht wird. Ein Export über eine URL ist deshalb nicht möglich.
Die REST-API-Schnittstelle
Wie von TYRIOS gewohnt, stehen sämtliche Produkt-Daten (inkl. interner Daten) über den REST-Endpoint zur Verfügung. Entsprechende Benutzerrechte vorausgesetzt können die Produktdaten von folgender URL abgerufen werden:
https://[domain]/service/ProductManagement/products
Die Ausgabe ist paginiert (offset
, length
) und unterstützt die Filterung nach Produktdaten anhand des filter
-Parameters (JSON-Struktur).
Über die REST-API können Produktdaten auch in Echtzeit erstellt, verändert und gelöscht werden.
Der Zugang der REST-API hängt von den Benutzerrechten ab.
Das Webhook-Interface
Ein Dritt-System kann über Webhooks in Echtzeit über Änderungen informiert werden. Dafür muss sich das System an den Ereignissen zum Erstellen, Bearbeiten und Löschen eines Artikels informieren lassen. Mehr Informationen gibt es in der Entwicklungsdokumentation zur Nutzung von Webhooks.
Über die Webhook-Funktion ist es möglich, dass ein Drittsystem stets und in Echtzeit aktuell gehalten wird. Eine manuelle Synchronisierung ist damit nicht mehr notwendig.