Angebotsdatenupload

Katalogverwaltung

Bei dem Upload der Daten unterscheiden wir zwischen Produkt- und Angebotsdaten. Nachfolgend gehen wir näher auf den Angebotsfeed ein.

Bitte beachten Sie:
Ohne vorher Produkte angelegt zu haben, können Sie keine Angebote hochladen und zuordnen!
Siehe:  Produktdatenupload

Die Angebotsdaten beinhalten eher dynamische, sich ändernde Daten wie zum Beispiel Preis, verfügbare Menge oder Versandzeiten.

Zulässige Formate für den Angebotsfeed

  • .csv (Standard Dateiformat und für alle Importe geeignet)
  • .xlsx
  • .xml

Dateierstellung

Der Import und das Hinzufügen von Angeboten ist ausschließlich über eine vorgegebene Struktur möglich. Hierzu stellt Mirakl eine Vorlage als Download zur Verfügung. Zu finden unter “Preis und Lager” -> “Angebotsimporte” -> rechte Seite unter “Dateivorlagen“. Diese Struktur kann übernommen oder in den eigenen Datenexport integriert werden.

Folgend finden Sie eine Aufstellung aller relevanten Attribute für den Angebotsfeed.

Liste der verpflichtenden Angebotsattribute
 
Angebots-SKU (Code: sku)
Diese kann in der Regel gleich Ihrer eindeutigen Artikelnummer (Seller Produkt ID) sein.
Wird nach erfolgreicher Anlage der Angebote in Ihrer Angebotsliste im Mirakl Portal angezeigt.
Produkt-ID (Code: product-id)
Dieser Wert muss gleich der eindeutigen Artikelnummer sein.  Also die Seller Produkt ID wie auch beim Produktupload schon angegeben. Über diese Angabe erfolgt die Zuordnung des anzulegenden Angebots zu dem bereits angelegten Produkt.
Produkt-ID-Typ (Code: product-id-type)
Der Produkt-ID-Typ definiert die Zuordnung von Angebot zu Produkt anhand des festgelegten Merkmals. Auf der Conrad Plattform ist der eindeutige Zuordnungsfaktor die eindeutige Artikelnummer, welche dem System über den Wert ‘’SHOP_SKU’’ zu erkennen gegeben wird. Für den Produkt-ID-Typ soll also standardmäßig der Wert ‘’SHOP_SKU’’ für jedes zu übermittelnde Angebot angegeben werden.
Angebotspreis (Code: price)
Der Brutto-Verkaufspreis Ihres Angebots ist der voreingestellte erwartete Wert.
(bei Bedarf kann in mirakl auch auf Netto Preise umgestellt werden: Nettopreis-Upload )
Angebotsmenge (Code: quantity)
Der aktuell verfügbare Bestand des jeweiligen Angebots. Der Wert muss eine ganze, positive Zahl sein und sollte über 0 liegen, damit das Angebot online angezeigt werden kann. Sollte der Bestand bei 0 liegen, wird das Angebot automatisch deaktiviert.
Status des Angebots (Code: state)
Fester Wert, hier bitte immer den folgenden Wert abhängig vom Dateiformat angeben.
Excel-Datei (xlsx): ‘’Neu’’
CSV-Datei (csv): ‘’11’’
Bitte bei refurbished Produkten den weiteren Hinweisen hier folgen.
Logistikklasse (Code: logistic-class)
Über die Logistikklasse werden die jeweiligen Versandkosten zu dem Angebot angezeigt. 
Wichtig: Definieren Sie Ihre Logistikklassen vorher in Ihrem Mirakl-Konto unter
‘’Mein Konto’’ -> ‘’Einstellungen’’ -> ‘’Versandkonfiguration’’.
Hier können bis zu 8 verschiedene Versandklassen definiert bzw. konfiguriert werden. Die jeweiligen Werte werden wie folgt in der zu übermittelnden Angebotsdatei eingetragen. Auch hier ist wieder auf das Dateiformat zu achten.

Logistikklasse Value
logistic-class Value (xlsx)
Klein & Medium 1
Klein & Medium 2
Klein & Medium 3
Sperrgut
Palette
Weitere Logistikklasse 1
Weitere Logistikklasse
Kostenfreier Versand
Logistikklasse Value
Logistikklasse Value
Small & Medium 1
Small & Medium 2
Small & Medium 3
Bulk Shipment
Pallet Shipment
Extra Logistic Class 1
Extra Logistic Class 2
Free shipping
Logistikklasse ID
logistic-class ID (csv)
SM1
SM2
SM3
bulk
pallet
extra1
extra2
free

(Hinweis: Extra Logistic Class 1 und 2 sind nur in Deutschland aktiviert)



Versandvorlaufzeit (Code: leadtime-to-ship)
Die Versandvorlaufzeit gibt die Zeit wieder, welche benötigt wird, bis das Paket an den Versanddienstleister übergeben wird. Dieser Wert überschreibt alle mirakl Voreinstellungen dazu.
Bleibt der Wert leer, wird von einem Versand am gleichen Tag ausgegangen bzw.  es greift Ihr selbst eingesteller Wert aus den mirakl Versandoptionen für alle Artikel.

Im Conrad Shop werden zusätzlich zu der angegebenen Versandvorlaufzeit immer 1-2 Tage Postweg hinzugerechnet. 

Reverse Charge (Code: reversecharge)
Das Reverse-Charge-Verfahren dreht die Umsatzsteuerschuldnerschaft bei Lieferungen um: Nicht der leistende Unternehmer führt die Umsatzsteuer an das Finanzamt ab, sondern der Kunde. Voraussetzung für die Anwendung des Reverse-Charge-Verfahrens ist, dass es sich auch beim Kunden um den Inhaber einer USt.-Identnummer handelt. Hier bitte pro Angebot den Wert ‘’false’’ oder ‘’true’’ angeben, je nachdem ob diese Regelung zutrifft oder nicht.
Lagerort (1-5) (Code: warehouse)
Gibt den Lagerort wieder, aus dem das jeweilige Angebot versendet wird. 
Wichtig: Prüfen Sie bitte Ihre Konfiguration im Mirakl Shop Konto unter
‘’Mein Konto’’ -> ‘’Einstellungen’’ -> "Lager"
In der zu übertragenden Angebotsdatei wird ein Wert von 1 bis 5 eingetragen je nach Konfiguration der hinterlegten Lagerstandorte.
Hersteller-ID (Code: producer-id[DE-WEEE])
Hier muss für relevante Angebote eine WEEE-Nummer von Ihnen hinterlegt werden. Dies kann entweder Ihre eigene Nummer sein oder die des Erstinverkehrbringers.  
Mehr Details dazu hier im Competence Center unter: ElektroG / WEEE

 

Weitere nutzbare Felder für Angebotsdaten sind in der mirakl Doku hier zu finden:  


"Offer file field description" 

 




Bitte beachten Sie, dass je nach Format der Datei Inhalte ggf. angepasst werden müssen.
Infos dazu und welche Werte Sie je nach Format verwenden müssen, finden Sie in dem oben aufklappbaren Liste der verpflichtenden Angebotsattribute.
 

In den beiden folgenden Beispielen bitte auf die angegebenen Werte unter ‘’logistic-class’’ und ‘’state’’ achten.

Für einen konsistent einwandfreien Angebotsupload empfiehlt es sich, die Attributcodes anstelle der Attributlabels zu verwenden. Für einen .csv- oder .xml-Upload werden bspw. nur die Attributcodes akzeptiert (einhergehend mit nur einer Kopfzeile).

 

Hier ein Beispielauszug aus der Angebots-Vorlage als CSV Datei:



Grundsätzlich kann natürlich auch das Template im .xlsx- Format verwendet werden. Hier kann optional auch die zweite Kopfzeile mit den Attributlabels stehen bleiben. 

Hier ein Beispielauszug aus dem Angebots-Vorlage als Excel-Datei:


Eine ausfühliche Erklärung zu allen weiteren möglichen Attributen beim Angebot finden Sie sehr gut erläutert in mirakl hier unter Excel-Vorlage Angebote
Wählen Sie ihre Sprache und klicken dann auf Vorlage erstellen und Download

Gut ist immer auch das Feld "Beschreibung des Angebots"  mit dem Titel des Produktes nochmal zu befüllen.
Dieser wird dadurch dann auch Lieferschein und Rechnung für den Kunden ausgedruckt.

Übertragungsmöglichkeiten

Es gibt unterschiedliche Wege, die Angebote zu importieren:

Per FTP-Server

Sie können für einen automatisierten Import Ihrer Angebote eine Serververbindung in Ihrem Mirakl Konto pflegen. Gehen Sie dazu auf  "Einstellungen" => "Shop" Registerkarte "Importe"


Folgend eine kleine Checkliste was wir von Ihnen benötigen:

  • Protokoll (nur noch HTTPS oder SFTP)
  • Host / Serveradresse
  • Port
  • Dateipfad (ohne Host)
  • Logindaten (User und Passwort)

Die Angebote können neben dem Modus ‘’Normal’’ auch via FTP-Server im Modus ‘’Löschen & Ersetzen’’ hochgeladen werden. 

Per API-Schnittstelle

Es gibt jeweils einen Endpunkt zur Übermittlung der Produkte, der Angebote sowie für einen separaten Preisimport.

  • Produktupload -> Endpunkt P41
  • Angebotsupload -> Endpunkt OF01 (Modus ‘’Normal’’ und ‘’Löschen & Ersetzen’’)
  • Preisupload -> Endpunkt PRI01 (nur im Modus ‘’Löschen & Ersetzen’’)

 

Manueller Import

Alle Uploads für Produkte, Angebote und auch Preise können ebenfalls manuell über die Importmaske im Mirakl Portal erfolgen. Gehen Sie dazu auf "Preis und Lager" -> "Angebotsimporte"
Wählen Sie ihre Datei als Quelle aus:   

Über die Tabs: Angebotsimporte überprüfen und Produktimporte überprüfen können Sie ihre Importe überprüfen und etwaige Fehlerberichte abrufen. Diese können Sie wiederum zur Korrektur vorhandener Fehler heranziehen.

Fehler beim Angebotsimport

Ähnlich dem Produktimport kann es nachgelagert auch beim Angebotsimport zu Fehlern in der Verarbeitung kommen. Bitte prüfen Sie daher auch in regelmäßigen Abständen die Angebotsimporte auf etwaige Fehler.

Sie können den Fehlerbericht in Ihrem Mirakl-Konto unter folgendem Pfad in der Spalte "Fehler" abrufen:

"Preis und Lager" → "Angebotsimporte" → "Angebotsimporte überprüfen"


Folgend finden Sie eine Übersicht der gängigsten Fehlermeldungen und wie Sie diese beheben können:

The product does not exist.

Beschreibung:

Ein anzulegendes Angebot kann nicht hinzugefügt werden.
Dafür kann es unterschiedliche Gründe geben. Die Zuordnung erfolgt anhand eines festgelegten Produkt-ID-Typs
"SHOP_SKU". Die direkte Zuordnung von Produkt zu Angebot erfolgt immer über die beiden Attribute "Product.SellerProductID" und "product-id".

Lösung:

Kontrollieren Sie die "product-id" und korrigieren diese gegebenenfalls.
Prüfen Sie alternativ den Produktimport dahingehend, ob die Produkte korrekt importiert wurden und das Angebot hinzugefügt werden kann.
 -> Prüfen Sie den Produktimport auf eventuelle Fehler.
Prüfen Sie ebenfalls die Schreibweise der Attribute auf Richtigkeit und korrigieren Sie diese gegebenenfalls.

No existing offer to update.

Beschreibung:

Der Wert sku passt zu keinem bereits bestehenden Angebot.

Lösung:

Prüfen Sie die Schreibweise der Attribute in der Kopfzeile auf Richtigkeit. Passt die Schreibweise der Attribute in der Kopfzeile zu den Vorgaben (bspw. Produkt-ID anstelle von "product-id")?
Für ein reines Angebotsupdate sollte der Importmodus "Normal" verwendet werden. 
(Importmodus ''UPDATE'' funtioniert nicht für Angebote, welche noch nicht existent sind.)

The field 'sku' is duplicated in the source file.

Beschreibung:

Mehrere Angebote in der Datei haben die selbe Angebots-SKU (sku).
Diese Referenz muss für jedes Angebot eindeutig sein.

Lösung:

Entfernen Sie doppelte Angebots-SKUs aus der Spalte "sku".

The state of the product is unknown.

Beschreibung:

Für das Attribut "state" wurde keiner oder ein ungültiger Wert angegeben.
Es dürfen nur Werte aus einer vorgegebenen Werteliste (entsprechend des Dateiformats) verwendet werden.

Lösung:

Prüfen Sie, ob das Attribut vorhanden ist und entsprechend befüllt wurde.

The field 'price' is mandatory.

Beschreibung:

Das Attribut "price" ist nicht in der Angebotsdatei vorhanden.
Es muss für jedes Angebot ein Angebotspreis (brutto) übergeben werden.

Lösung:

Tragen Sie den Angebotspreis ein.

The logistic family is unknown.

Beschreibung:

Die angegebene Logistikklasse existiert nicht.
Es dürfen nur Werte aus einer vorgegebenen Werteliste (entsprechend des Dateiformats) verwendet werden.

Lösung:

Prüfen Sie, ob das Attribut vorhanden ist und entsprechend befüllt wurde.

The product linked to the new offer is different from the product linked to the existing offer.

Beschreibung:

Ein Angebot wurde gelöscht. Ein Versuch das Angebot direkt im Anschluss mit der gleichen Angebots-SKU wieder
anzulegen schlägt fehl. Die selbe Angebots-SKU kann erst nach einem Tag wieder verwendet werden.

Lösung:

Warten Sie die Frist von 1 Tag ab und legen Sie das Angebot mit der gleichen Angebots SKU wieder an.
Alternativ können Sie eine andere Angebots SKU verwenden.

The field 'leadtime-to-ship' has an invalid value. Must be a positive integer and not exceed the limit defined by the operator.

Beschreibung:

Die Versandvorlaufzeit (leadtime-to-ship) ist im falschen Format.
Nachkommastellen oder negative Werte sind nicht erlaubt.

Lösung:

Die Versandvorlaufzeit (leadtime-to-ship) muss eine positive ganze Zahl sein.

The field 'discount_price' has an invalid range.

Beschreibung:

Die Angabe der Staffelpreise ''discount-ranges" hat ein falsches Format.

Lösung:

Die Angabe der Staffelpreise ''discount-ranges" muss nach einem vorgegebenen Format erfolgen.
Bsp.: 2|1.50,5|1.35,10|1.10
Der Preis der ersten Staffel muss kleiner als der Angebotspreis (price) sein.

Rechtlich relevante Probleme finden Sie in Ihren Dashboards im Seller Portal aufgelistet. Überprüfen Sie dort regelmäßig um Fehler zu beheben.

 

Weitere Themen