Eine Conrad API einrichten

Conrad, ein Familienunternehmen seit fast 100 Jahren, beliefert Kunden in ganz Europa mit innovativer und zuverlässiger Technik. Mit einem Angebot von über 1,5 Millionen Produkten führender Hersteller beliefert Conrad Industriekunden, Fachleute, Bildungseinrichtungen, Makler und Privatpersonen.

Dieser Leitfaden führt Sie durch die Schritte zur Einrichtung einer API zwischen Channable und Conrad.

Inhaltsverzeichnis

1. Vorbereitung
2. Eine neue Verbindung erstellen
3. Die API erstellen
4. Produktangebote erstellen
5. Produktangebote an Conrad senden
6. Produktangebote auf Fehler prüfen

Vorbereitung

Um eine reibungslose Einrichtung zu gewährleisten und Probleme zu vermeiden, lesen und befolgen Sie bitte diese wichtigen Hinweise:

• Konto einrichten: Um Ihre Produkte auf Conrad zu verkaufen, benötigen Sie ein professionelles Verkäuferkonto. Folgen Sie den Richtlinien zur Kontoerstellung hier.
• Unterstützte Länder: Derzeit sind die folgenden Länder verfügbar: Deutschland, Italien, Frankreich, Niederlande, Österreich und Tschechien.
• Mehrere Conrad APIs: Jedes Store-Konto entspricht 1 Verkaufskanal. Wenn Sie in mehreren Ländern verkaufen möchten, müssen Sie:
  
  1. Ein neues Store-Konto eröffnen.
  2. Eine neue Conrad-API in Channable erstellen, um eine Verbindung zu diesem Store-Konto herzustellen.

Nachdem Sie alle Vorbereitungspunkte abgeschlossen und überprüft haben, können Sie mit dem ersten Schritt beginnen.

Schritt 1: Eine neue Verbindung erstellen

Um eine neue Conrad-Verbindung zu erstellen, gehen Sie wie folgt vor:

1. Navigieren Sie zunächst zur API-Seite in Ihrem Projekt und klicken Sie auf die Schaltfläche „+ neue API hinzufügen“.
2. Wählen Sie auf der nächsten Seite „+Verbindung hinzufügen“. Diese Aktion leitet Sie auf die Seite mit den Verbindungen Ihres Unternehmens weiter.
3. Suchen Sie nach der „Conrad“-Verbindung, indem Sie sich durch die Seiten klicken. Wenn Sie die „Conrad“-Verbindung gefunden haben, geben Sie eine Bezeichnung für diese neue Verbindung ein.
4. Klicken Sie auf „Connect with Conrad“. Sie werden für den nächsten Schritt zu Conrad weitergeleitet. Nach der Weiterleitung melden Sie sich mit den Mirakl/Conrad-Anmeldedaten an.
5.  

Nach erfolgreicher Anmeldung ist die Verbindung zu Conrad hergestellt und kann genutzt werden! Sie werden zum API-Setup zurückgebracht.

Schritt 2: Die API erstellen

Sobald Sie zurück sind, müssen Sie Ihre neue Verbindung mit Conrad auswählen und mit der Einrichtung Ihrer API fortfahren.

1. API-Einstellungen konfigurieren:
   
   • Geben Sie Ihrer API einen Namen
   • Wählen Sie die eindeutige ID für jeden Artikel (wir empfehlen das Feld „id“).
   • Wählen Sie die Sprache für Ihre API
2. API erstellen: Klicken Sie auf „Weiter“, um die neue Conrad-API zu erstellen.

Schritt 3: Produktangebote erstellen

Um Ihre API einzurichten, folgen Sie bitte den unten aufgeführten Schritten. Klicken Sie auf jeden Schritt, um die detaillierten Anweisungen anzuzeigen, die Sie durch den gesamten Prozess führen.

1. Kategorisierung

2. Regeln

3. Schritt "Aufbau"

Der Schritt "Aufbau" in Channable ermöglicht es Ihnen, alle notwendigen Attribute für Ihre Artikel zu konfigurieren, um sicherzustellen, dass Ihre Produktdaten mit den Anforderungen des Marktplatzes übereinstimmen. Dieser Schritt ist entscheidend für erfolgreiche Produktlistings und die Vermeidung von Fehlermeldungen.

3.1 Überblick

1. Gehen Sie zum Aufbau-Schritt: Gehen Sie zunächst zur zentralen Benutzeroberfläche des Aufbau-Schrittes. Hier werden Sie alle Produktattribute verwalten und zuordnen.
2. Identifizieren Sie obligatorische und optionale Felder: Obligatorische Felder sind pink markiert und zeigen an, dass sie für die Auflistung Ihrer Produkte zwingend erforderlich sind. Optionale Felder sind orange markiert und können je nach Bedarf ausgefüllt werden.

3.2 Gemeinsame Attribute

1. Füllen Sie die geminsamen Attribute aus: Geben Sie allgemeine Informationen ein, die für alle Produkte gelten, z. B. EAN, Preise und Titel. Dieser Schritt gewährleistet die Einheitlichkeit der grundlegenden Produktinformationen in Ihren Angeboten.
   • Benutzen Sie statische oder dynamische Werte:
     • Statische Werte: Geben Sie Werte ein, die konstant bleiben, wie Markennamen oder Hersteller.
     • Dynamische Werte: Verwenden Sie Felder, die automatisch auf der Grundlage verknüpfter Daten aktualisiert werden, ideal für Variablen wie Lagerbestände oder Preis.

Nachdem Sie die gewünschten Werte für die gemeinsamen Attribute eingegeben haben, fahren Sie, wie unten beschrieben, mit den kategoriespezifischen Attributen fort.

3.3 Attribute pro Kategorie

1. Wählen Sie eine Produktkategorie: Wählen Sie die entsprechende Kategorie für Ihr Produkt, z. B. Kleidung oder Möbel.
2. Kategoriespezifische Attribute: Geben Sie Attribute ein, die für die ausgewählte Kategorie spezifisch sind, z. B. die Größe für Kleidung oder die Abmessungen für Möbel. Dieser Schritt hilft bei der Feinabstimmung Ihrer Angebote entsprechend den Anforderungen der Kategorie. Auch hier können Sie statische oder dynamische Werte verwenden.

Klicken Sie hier, um mehr über den Schritt "Aufbau" zu erfahren.

4. Schritt "Qualität"

Der Schritt "Qualität" liefert sofortige Rückmeldung über die Einrichtungsqualität und weist auf obligatorische und optionale Fehler hin, um sicherzustellen, dass Ihre Produktdaten den Standards der Marktplätze entsprechen.

Aktionen

• Artikel anzeigen: Sehen Sie sich die Produkte mit dem spezifischen Problem an.
• Im Aufbau-Schritt anzeigen: Leitet Sie zum Schritt "Aufbau" weiter, wo Sie ein Feld zuordnen können, um die fehlenden Informationen hinzuzufügen.
• Kategorien anlegen: Leitet Sie zum Schritt "Kategorien", wo Sie die fehlende Kategorie anlegen können.
• Quelle: Diese Option ist nur für das ID-Feld verfügbar und leitet Sie zum Schritt "Einstellungen" weiter.

Klicken Sie hier, um mehr über den Schritt "Qualität" zu erfahren.

5. Schritt "Vorschau"

Der Schritt "Vorschau" zeigt die zugeordneten Attribute für mehrere Artikel und Detailansichten für einzelne Artikel an und weist auf Fehler hin, bevor der Export auf den Marktplatz erfolgt.

Features

• Such- & Filterleiste: Suchen Sie nach bestimmten Produkten oder filtern Sie nach Fehlermeldung/Kategorie.
• Artikelübersicht: Zeigt alle zu exportierenden Artikel an; es kann gefiltert werden, um nur Artikel mit Fehlern anzuzeigen.
• Detaillierte Produktvorschau: Zeigt fehlende Informationen und dynamische Aktionen zur Fehlerbehebung an.

Checkliste zur Fertigstellung von Attributen

• Überprüfen Sie die gemeinsamen Attribute: Stellen Sie sicher, dass alle obligatorischen gemeinsamen Attribute korrekt ausgefüllt sind.
• Überprüfen Sie die kategoriespezifischen Attribute: Stellen Sie sicher, dass alle obligatorischen kategoriespezifischen Attribute korrekt ausgefüllt sind.
• Suchen Sie nach Fehlern: Suchen Sie nach rot markierten Feldern und korrigieren Sie diese.

Klicken Sie hier, um mehr über den Schritt "Vorschau" zu erfahren.

6. Schritt "Resultat"

Zusätzliche Anforderungen für Conrad

Die folgenden Informationen sind spezifisch für Conrad. Wir erläutern pro Registerkarte, worauf Sie achten sollten.

Item Registerkarte

• Vorlaufzeit für den Versand: Die Versandvorlaufzeit gibt die Zeit an, die benötigt wird, bis das Paket an den Versanddienstleister übergeben wird. Dieser Wert überschreibt alle Standardeinstellungen von Mirakl. Bleibt der Wert leer, wird von Conrad angenommen, dass der Versand am selben Tag erfolgt. Im Conrad Shop werden 1-2 Tage zur angegebenen Versandvorlaufzeit addiert.

• Versandklasse: Die Logistikklassen bestimmen die jeweiligen Versandkosten für Ihre Sendungen.

  Sie können bis zu acht verschiedene Versandklassen konfigurieren. Die richtigen Werte müssen im Attribut „Versandklasse“ im Schritt „Aufbau“ eingegeben werden. Nachfolgend finden Sie die möglichen Werte, die auch als festgelegte Werte angezeigt werden, wenn Sie mit dem Mauszeiger auf das Symbol (?) neben dem Attribut „Versandklasse“ fahren.

  Versandklasse	Versandklassen-ID	Beschreibung
  Klein & Mittel 1	SM1	10 kg und weniger
  Klein & Mittel 2	SM2	Mehr als 10 kg bis 15 kg
  Klein & Mittel 3	SM3	Mehr als 15 kg bis 31.5 kg
  Massensendung	bulk	Von 31,5 kg bis 40 kg
  Pallettenversand	pallet	Mehr als 40 kg bis 500 kg
  Extra Logistik 1	extra1	Besonderer Preis für Extra Logistik 1
  Extra Logistik 2	extra2	Besonderer Preis für Extra Logistik 2
  Kostenloser Versand	free	Kostenloser Versand
  Fulfillment Klein & Mittel 1	FSM1	Fulfillment 10 kg und weniger
  Fulfillment Klein & Mittel 2	FSM2	Fulfillment mehr als 10 kg bis 15 kg
  Fulfillment Klein & Mittel 3	FSM3	Fulfillment mehr als 15 kg bis 31.5 kg
  Fulfillment Sperrgut	fbulk	Sperrige Güter über 31,5 kg bis 40 kg
  Fulfillment-Pallette	fpallet	Palette über 40 kg bis 500 kg
  Fulfillment Zusätzlich 1	fextra1	Fulfillment Zusätzlich 1
  Fulfillment Zusätzlich 2	fextra2	Fulfillment Zusätzlich 2
  Fulfillment Kostenloser Versand	fulfree	Fulfillment Kostenloser Versand (keine Versandkosten erlaubt)
  OCI-Sortiment	oci	OCI-Sortiment (versandkostenfrei)

  Hinweis: Extra Logistik Klasse 1 und 2 sind nur in Deutschland aktiviert

• Umkehrung der Steuerschuldnerschaft: Durch die Umkehrung der Steuerschuldnerschaft wird die Verantwortung für die Umsatzsteuer für die Lieferungen umgekehrt: Nicht das liefernde Unternehmen führt die Umsatzsteuer an das Finanzamt ab, sondern der Kunde. Voraussetzung für die Anwendung der Umkehrung der Steuerschuldnerschaft ist, dass der Kunde auch Inhaber einer Umsatzsteuer-Identifikationsnummer ist.
  Bitte geben Sie für jedes Angebot den Wert „false“ oder „true“ an, je nachdem, ob diese Regelung gilt oder nicht.
• Lager ID: Gibt den Lagerort an, von dem aus der jeweilige Artikel gesendet wird.
  Je nach Konfiguration der gespeicherten Lagerorte wird ein Wert von 1 bis 5 eingegeben. Das Attribut „Lager ID“ ist für eine bestimmte Zahl gedacht, Sie können bis zu 5 Lagerorte in Ihrem Conrad-Konto angeben. Dieses Attribut entscheidet dann über die Auswahl der Kennung 1-5, aus welchem Lager der Artikel letztendlich stammt
• Maßeinheiten: Das Attribut „Maßeinheiten“ gibt die Einheit an, die zur Berechnung des Preises pro Einheit eines Produkts verwendet wird. Dies gewährleistet, dass die Verbraucher die Kosten leicht vergleichen können. Für Produkte, die nach Gewicht, Volumen, Länge oder Fläche verkauft werden, sollten Sie die Einheitspreise in gängigen Einheiten wie Kilogramm (KG), Liter (L), Meter (M) oder Quadratmeter (M2) angeben. Stellen Sie sicher, dass das Attribut „Maßeinheiten“ in Channable genau ausgefüllt ist, um diese Standards widerzuspiegeln.
• Menge: In Channable gibt dieses Attribut „Menge“ die Mengenangabe für das zu verkaufende Produkt an. Wenn Sie z.B. ein 4er-Pack Steckdosen verkaufen, geben Sie als Menge „4“ ein.

  So kann Conrad sowohl den Preis pro Einheit als auch den Gesamtpreis für den 4er-Pack anzeigen. Sie können dies für verschiedene Produkte erreichen, indem Sie:

  1. Ein Projektfeld erstellen.

  2. Dieses Feld in einer Regel verwenden und mit einem Wert füllen.

  3. Dann dieses Feld im Attribut „Menge“ auswählen.

• Urheberrechtsabgabe: In Frankreich ist die Urheberrechtsabgabe eine gesetzliche Verpflichtung zur Entschädigung von Urhebern und Rechteinhabern für Privatkopien, die mit Leermedien wie CDs, DVDs, externen Festplatten und USB-Sticks angefertigt werden. Diese Abgabe ist im Verkaufspreis dieser Medien enthalten und wird dann über die Verwertungsgesellschaften an die Urheber und Rechteinhaber verteilt. Die Verkäufer müssen den Betrag der „Copie-Privée“-Abgabe in Euro für jeden zutreffenden Artikel dieser Kategorie angeben.
• Öko-Beiträge: Frankreich hat eine Gesetzgebung zur Öko-Beteiligung eingeführt. Wenn Ihr Unternehmen in Frankreich tätig ist, müssen Sie Ihre Angebote auf dem Marktplatz mit Öko-Beiträgen versehen. In diesem Artikel, finden Sie eine Liste der verfügbaren EPR-Kategorien.

Wenn Sie sich an diese Hinweise halten, können Sie sicherstellen, dass Ihre Conrad-Einträge korrekt und entsprechend den Anforderungen des Unternehmens eingerichtet sind.

Schritt 4: Produktangebote an Conrad senden

Sie haben es fast geschafft: Ihre Produktangebote sind bereit zum Versenden. Wenn Sie Ihr Projekt noch nicht aktiviert haben, gehen Sie zu Ihren Projekteinstellungen auf der linken Seite des Bildschirms und klicken Sie auf „Projekt aktivieren“.

Gehen Sie anschließend zurück zur API-Übersicht und gehen Sie zu [Ihre Conrad-API] > Einstellungen, wo Sie die API durch Klicken auf „API aktivieren“ aktivieren.

Sobald Sie die API aktiviert haben, navigieren Sie zurück zur API-Übersicht und klicken Sie auf die blaue Schaltfläche „Aktualisieren“, um Ihre Produktangebote an Conrad zu senden.

Schritt 5: Produktangebote auf Fehler prüfen

Um Fehler zu überprüfen, navigieren Sie zur Resultatseite der API > Registerkarte „Fehler“, wo Sie sehen können, welche Produktangebote Fehler aufweisen. Wenn Sie auf den jeweiligen Fehler klicken, werden weitere Informationen zur Fehlerursache angezeigt. Weitere Informationen über die Bedeutung der Fehler finden Sie in diesem Artikel. Darüber hinaus finden Sie viele Informationen im Conrad-Hilfecenter.