| Verpflichtende Produktattribute | ||
|---|---|---|
Produktgruppe / Kategorie (Code: category)
|
||
Eindeutige Artikelnummer (Code: Product.SellerProductID)
|
||
Produkttitel / Produktbezeichnung (Code: SHOP.PRODUCT.TITLE)
|
||
Marke (Code: ATT.GLOBAL.Brandname) Die detaillierten Anforderungen zur Anlage neuer Marken finden Sie hier. |
||
| Teilenummer des Herstellers (Code: ATT.GLOBAL.ManufacturerAID) Eindeutige Hersteller-Teilenummer. Diese ist suchrelevant für das Internet und das Matching auf Preissuchmaschinen. Bei Markenprodukten, d.h. Produkte die nicht als No Name klassifiziert sind, ist die Angabe einer Herstellerteilenummer erforderlich. |
||
| Verkaufsmengeneinheit (Code: Product.BaseUnit) Geben Sie die Einheit des Produkts an, in der es verkauft wird. Mögliche Werte sind: Stück: "Ein ganzes", ggfs. aber inkl. Zubehör. Beispiel: Eine Tube Klebstoff, ein Schreibblock, eine Digitalkamera mit Akku und Ladegerät. Ein Stück Klebstoff-Tube kann natürlich nicht in einzelnen Millilitern verkauft werden. Paar: Zwei zusammengehörige Stück gleicher Art. Es ist nicht sinnvoll ein Paar Handschuhe als einzelne Stücke anzubieten. Pack: Mehrere gleiche Stück, die als Ganzes verkauft werden. Beispiel: 10 Textmarker in einer Umverpackung. Set: Verschiedene Produkte, die als Ganzes verkauft werden. Beispiel: Ein Schreibtisch-Set aus Unterlage, Stifteköcher und Ablagekorb in einem Umkarton oder ein Füller und ein Kugelschreiber im Etui. Meter: Das Produkt kann pro Meter bestellt und geliefert werden (wird also abgelängt). Der Preis wird pro Meter angegeben. Beispiel: Kabel. NICHT: Klebeband, das ist in der Regel ein Stück oder ein Pack. Hinweis für Lieferanten: Diese ist unabhängig davon, in welcher Einheit Sie das Produkt bepreisen, lagern oder die Bestellung von uns erhalten möchten. |
||
| Inhalt pro Verkaufseinheit (Code: ATT.GLOBAL.NoCUperOU) Inhalt des verkauften Produktes (numerischer Wert). Ein Stück beinhaltet normalerweise 1 Stück. Ein Paar enthält 2 Stück, ein Pack enthält einen Inhalt größer 1. |
||
| Inhaltsmengeneinheit (Code: ATT.GLOBAL.NoCUperOU__UNIT) Einheit des Inhaltes des verkauften Produkts. Bei einer Packung, welche 10 Einheiten eines Artikels enthält wäre bspw. die Einheit ‘’Stück’’ zu wählen. Weitere Inhaltsmengen sind: g, kg, ml, l, cm, m, m² |
||
| Umsatzsteuerklasse Verkauf (Code: Product.TaxIndicator) Anzuwendender Steuersatz für den Verkauf des Produkts. Im Regelfall kommt die voll Steuer (z.B. in DE 19%) zur Anwendung. Ausnahmen mit reduzierter Steuer können z. B. Bücher oder Lebensmittel sein. |
||
Competence Center
Produktdatenupload
Bei dem Upload der Daten unterscheiden wir zwischen Produkt- und Angebotsdaten. Nachfolgend gehen wir näher auf den Produktfeed ein.
Der Produktfeed muss von den beiden Feeds zuerst in das Backend geladen werden, damit die Angebote nachher den angelegten Produkten zugeordnet werden können.
Die Produktdaten beinhalten eher starre Informationen, welche sich in der Regel kaum ändern, wie z. B. die Produktgruppe, Herstellerteilenummer oder Marke.
Zulässige Formate für den Produktfeed
- .csv (Standard Dateiformat in UTF-8 und für alle Importe geeignet)
- .xlsx
- .xml / BMEcat (BMECat erfordert eine manuelle Konvertierung der Datei)
Dateierstellung
Der Import und die Anlage von Produkten ist zum einen über eine Vorlage, zum anderen auch über einen eigenen Datenexport aus Ihrem PIM System möglich. Grundsätzlich lautet die Empfehlung, einen eigenen Datenexport zu verwenden und diesen einmalig der Conrad Struktur zuzuordnen. Dafür wird der vom Backend zur Verfügung gestellte Konfigurationsassistent verwendet.
Folgend finden Sie eine Aufstellung aller relevanten Attribute für den Produktfeed. Sie finden hier zum einen Infos über verpflichtende Attribute sowie empfohlene Attribute, welche Ihnen hinsichtlich der Sichtbarkeit Ihrer Produkte auf der Plattform helfen.
Übertragungsmöglichkeiten
Es gibt unterschiedliche Wege, die Produkte zu importieren.
FTP Server
Sie können für einen automatisierten Import Ihrer Produkte eine Serververbindung in Ihrem Mirakl Konto pflegen. Gehen Sie dazu auf: "Einstellungen" => " Shop" und dort Registerkarte "Importe"
Folgend eine kleine Checkliste was wir von Ihnen benötigen:
- Protokoll (HTTP, HTTPS, FTP oder SFTP)
- Host / Serveradresse
- Port
- Dateipfad (ohne Host)
- Logindaten (User und Passwort)
Die Produkte können lediglich im Modus "Normal" hochgeladen werden. Bspw. Updates am Produkttitel werden beim Import einer aktualisierten Datei automatisch übernommen.
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: "Preise und Lager" => "Angebotsimporte"
Ü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.
Gängige Fehlermeldungen
Beim Import Ihrer Produkte kann es passieren, dass erste Versuche zur Anlage Ihrer Artikel fehlschlagen. Das kann unterschiedliche Gründe haben. Bitte prüfen Sie daher stets die Produktimporthistorie und entsprechende Einträge auf etwaige Fehlerberichte. Beim Produktimport können sowohl Umwandlungsfehler als auch Integrationsfehler auftauchen.
Sie können diese Fehlerberichte in Ihrem Mirakl Konto unter folgendem Pfad in der Spalte "Aktionen" abrufen:
"Preise und Lager" → "Angebotsimporte" → "Produktimporte überprüfen"
Nähere Infos zu den unterschiedlichen Fehlermeldungen finden Sie in diesem Artikel.