Synchronisierung per CSV: vollständige Spezifikation

Für die Synchronisierung zwischen den Kunden und Portal Hero verwenden wir ein System von CSV-Dateien. Die wichtigste CSV-Datei ist die der Artikel (oder Artikel-Feed), in der alle Artikel aufgelistet sind, die in den verschiedenen Portalen veröffentlicht werden. In dieser Datei befinden sich die Artikel mit ihren Merkmalen.

Funktionsweise der Synchronisierung

Die Art, jeden Artikel zu identifizieren, erfolgt über das Feld id, auf das wir uns als eindeutige Kennung stützen, um zu entscheiden, ob ein Artikel aktualisiert wird oder nicht mehr existiert. Wenn ein Artikel zum ersten Mal im Artikel-Feed erscheint, wird er in alle vom Kunden ausgewählten Portale hochgeladen. Wenn ein Artikel nicht mehr im Feed vorhanden ist, wird er als verkauft markiert, und wenn sich ein beliebiges Datum des Artikels ändert, wird er ebenfalls in den Portalen aktualisiert. Weitere Details zur Synchronisierung selbst finden Sie hier.

Das allgemeine Format dieser CSV-Dateien ist folgendes:

• Durch Kommas getrennte Felder
• Die Kopfzeile muss vorhanden sein, um die Felder identifizieren zu können
• Durch doppelte Anführungszeichen begrenzte Felder (bei Bedarf oder immer)
• Dateikodierung UTF-8

Dateiaustausch

Wir haben zwei Möglichkeiten, uns die Datei zu übermitteln:

• SFTP
  Wir verfügen über einen SFTP, um die Dateien auszutauschen und den sicheren Informationsaustausch zu erleichtern. Die Zugangsdaten zum SFTP (Benutzer und Passwort) werden während des Onboarding-Prozesses bereitgestellt.
  Die übrigen gemeinsamen Verbindungsdaten sind folgende:
  • Host: sftp.portalhero.pro
  • Port: 2222
  
  Zudem ist der SFTP abgesichert und auf Netzwerkebene beschränkt, und wir benötigen eine oder mehrere IPs, um sie zu unserer Liste der zugelassenen Zugriffs-IPs hinzuzufügen.
  Innerhalb des SFTP gibt es einen erstellten Ordner namens upload, in den die Dateien geschrieben werden: Für die Artikeldatei lautet der Dateiname: item_feed.csv
• url
  Der Artikel-Feed kann auch über eine öffentliche URL gesendet werden, von der der Portal-Hero-Prozess ihn bei jeder täglichen Ausführung herunterlädt.
  Die URL muss vom Kunden während des Onboarding-Prozesses angegeben werden. Falls weitere Sicherheitsmaßnahmen erforderlich sind, können Sie uns beliebige Header übermitteln, die wir der Anfrage hinzufügen.

Format der CSV-Dateien

Auflistung der Felder, Detailtypen und Beispiele der Artikel-CSV-Datei:

* Für Auto-Artikel müssen die folgenden Attribute im Feld 'attributes' als serialisierte JSON-Zeichenkette bereitgestellt werden:

Bezüglich des Feldes status, das sich auf den Zustand der Artikel bezieht, sind die Optionen folgende:

["new", "as_good_as_new", "good", "fair", "has_given_it_all"]

Attribute des Autos

Die Attribute des Autos sind eine Reihe von Merkmalen, die ein Auto beschreiben. Sie werden im Feed und zur Veröffentlichung in den Marktplätzen verwendet.

Beispiel (python):

car_attrs = {
    "version": "1.6 TDI Toyota",
    "year": "2018",
    "horse_power": 100,
    "mileage": 12000,
    "engine": "gasoil",
    "gearbox": "manual"
}

attributes = json.dumps(car_attrs)

Attribute des Motorrads

Um Motorräder zu integrieren, muss der Artikel die spezifischen Fahrzeuginformationen enthalten. Die technischen Daten werden als JSON serialisiert im Feld 'attributes' gesendet, während Marke und Modell in den Feldern 'brand' und 'model' der CSV übermittelt werden.

Das Feld 'external_category' muss einen der Werte '2', 'Motos', 'Motorbikes' annehmen, damit der Artikel als Motorrad verarbeitet wird. Diese Integration erfordert, dass der Motorrad-ERP-Service in Ihrem Konto aktiv ist.

Die Werte von 'brand' und 'model' müssen exakt mit denen unserer Motorrad-Taxonomie übereinstimmen. Um die gültigen Werte abzufragen, verfügen wir über zwei öffentliche Endpunkte (erfordern Authentifizierung und den aktiven Motorrad-ERP-Service):

• GET /motorbike_brands — gibt die vollständige Liste der verfügbaren Marken mit ihrer 'uid' und 'value' zurück.
• GET /motorbike_models?brand_id={uid} — gibt die der über 'brand_id' angegebenen Marke zugeordneten Modelle zurück.

Beachten Sie, dass der Titel des Artikels automatisch aus Marke, Modell, Version (falls angegeben) und Baujahr generiert wird, sodass der Wert des Feldes 'title' bei Motorrädern überschrieben wird.

Beispiel (python):

motorbike_attrs = {
    "year": 2020,
    "version": "modelo actual",
    "km": 5420,
    "horse_power": 47,
    "engine_capacity_cc": 400,
    "fuel_type": "gasoline",
    "license_plate": "1234 ABC"
}

attributes = json.dumps(motorbike_attrs)