Dokumentation zur Rakuten Shop-API


addProduct

Diese Methode fügt ein neues Produkt hinzu.

Mit dieser URL rufen Sie die API-Methode auf:

Authentifizierung

Für diese Methode ist eine Authentifizierung mit Schreibrechten erforderlich.
Empfohlen wird der Aufruf über HTTP-POST.

Parameter

Die mit * gekennzeichneten Parameter müssen übergeben werden.

key *

Authentifizierungs-Schlüssel

Datentyp: String
product_art_no

Artikel-Nummer des Produkts

Datentyp: String
Regeln: Maximal 50 Zeichen sind erlaubt.
name *

Bezeichnung des Produkts

Datentyp: String
Regeln: Maximal 100 Zeichen sind erlaubt.
price *

Preis

Datentyp: Float
price_reduced

Reduzierter Preis

Datentyp: Float
Regeln: Der reduzierte Preis muss niedriger als der Standard-Preis sein.
price_reduced_type

Bezug des reduzierten Preises

Datentyp: String
Regeln:
UVP = Originalpreis ist unverbindliche Preisempfehlung
VK = Originalpreis ist alter Verkaufspreis
Standard: VK
shipping_group

Versandgruppen-Nummer

Datentyp: Integer
Regeln: Mögliche Werte von 1 bis 20. Je nachdem wie viele Versandgruppen der Händler angelegt hat.
Standard: 1
available

Verfügbarkeit

Datentyp: Boolean
Standard: 1
producer

Hersteller

Datentyp: String
Regeln: Maximal 30 Zeichen sind erlaubt.
stock_policy

Bestandsverwaltung (setzt das Produkt bei Bestand "0" auf nicht verfügbar)

Datentyp: Boolen
Standard: 0
stock

Bestand

Datentyp: Integer
delivery

Lieferzeit

Datentyp: Integer
Regeln:
0 = Sofort lieferbar (Lieferzeit 1-3 Werktage)
3 = versandfertig in 3 Werktagen (Lieferzeit 4-6 Werktage)
5 = versandfertig in 5 Werktagen (Lieferzeit 6-8 Werktage)
7 = versandfertig in 7 Werktagen (Lieferzeit 8-10 Werktage)
10 = versandfertig in 10 Werktagen (Lieferzeit 10-15 Werktage)
15 = versandfertig in 15 Werktagen (Lieferzeit 15-20 Werktage)
20 = versandfertig in 20 Werktagen (Lieferzeit 20-30 Werktage)
30 = versandfertig in 30 Werktagen (Lieferzeit 30-40 Werktage)
40 = versandfertig in 40 Werktagen (Lieferzeit 40-50 Werktage)
50 = versandfertig in 50 Werktagen (Lieferzeit 50-60 Werktage)
60 = versandfertig in 60 Werktagen (Lieferzeit 60-100 Werktage)
Standard: 0
min_order_qty

Mindestbestellmenge

Datentyp: Integer
staggering

Staffelung

Datentyp: String
Regeln: Das Format der Staffelung ist z.B. 2,4,6,8.
baseprice_unit

Einheit der Referenz-Menge

Datentyp: String
Regeln:
ml = Milliliter
l = Liter
g = Gramm
kg = Kilogramm
cm = Zentimeter
m = Meter
= Quadratmeter
= Kubikmeter
baseprice_volume

Referenz-Menge

Datentyp: Float
tax

Mehrwertsteuer

Datentyp: Integer
Regeln:
1 = 19 %
2 = 7 %
3 = 0 %
4 = 10,7 %
10 = 10 %
12 = 20 %
13 = 13 %
Standard: 1
homepage

Das Produkt wird auf der Startseite im Shop angezeigt

Datentyp: Boolean
Standard: 0
connect

Das Produkt ist für kostenpflichtige Connect!-Module deaktiviert

Datentyp: Boolean
Standard: 0
ean

EAN

Datentyp: String
isbn

ISBN

Datentyp: String
mpn

MPN (eindeutige Hersteller-Artikel-Nummer)

Datentyp: String
Regeln: Maximal 30 Zeichen sind erlaubt.
inci

Inhaltsangaben

Datentyp: String
description *

Beschreibung

Datentyp: String
Regeln: HTML-Tags sind zum Teil erlaubt. Welche HTML-Tags erlaubt sind und welche nicht, sehen sie hier
comment

Interner Kommentar

Datentyp: String
cross_selling_title

Titel des Cross-Sellings (z.B. Diese Produkte könnten Ihnen auch gefallen)

Datentyp: String
Regeln: Maximal 100 Zeichen sind erlaubt.
shop_category_id

ID einer Shop-Kategorie

Datentyp: Integer
rakuten_category_id

ID einer Rakuten-Portal-Kategorie

Datentyp: Integer
energy_product_group

Produktgruppe

Datentyp: Integer
Regeln:
1 = Haushaltsgeschirrspülmodelle (Von A+++ bis D)
2 = Haushaltskühlgerätemodelle (Von A+++ bis D)
3 = Haushaltswaschmaschinenmodelle (Von A+++ bis D)
4 = Fernsehgeräte (Von A++ bis E)
5 = Haushaltswäschetrocknermodelle (Von A+++ bis D)
6 = Lampen und Leuchten (Von A++ bis E)
7 = Luftkonditioniermodelle (Von A bis G)
8 = Staubsauger (Von A bis G)
9 = Backöfen (Von A+++ bis D)
10 = Dunstabzugshauben (Von A bis G)
11 = Warmwasserbereiter (Von A bis G)
12 = Warmwasserspeicher (Von A bis G)
13 = Raumheizgeräte (Von A+++ bis D oder F)
14 = Kombiheizgeräte (Von A+++ bis D oder F)
15 = Verbundanlagen aus Warmwasserbereitern und Solareinrichtungen (Von A+++ bis D oder F)
16 = Verbundanlagen aus Warmwasserspeicher und Solareinrichtungen (Von A+ bis G)
17 = Verbundanlagen aus Raumheizgeräten, Temperaturreglern und Solareinrichtungen (Von A+++ bis D oder F)
18 = Verbundanlagen aus Kombiheizgeräten, Temperaturreglern und Solareinrichtungen (Von A+++ bis D oder F)
energy_class_from

Energieeffizienzklasse ab

Datentyp: Integer
Regeln:
1 = A+++
2 = A++
3 = A+
4 = A
5 = B
6 = C
7 = D
8 = E
9 = F
10 = G
energy_class_to

Energieeffizienzklasse bis

Datentyp: Integer
Regeln:
1 = A+++
2 = A++
3 = A+
4 = A
5 = B
6 = C
7 = D
8 = E
9 = F
10 = G
Nur bei Produktgruppe Lampen und Leuchten nötig.
energy_class_label

URL des Energieeffizienzklassenlabels

Datentyp: URL

Antwort

Beispiel im XML-Format.

<?xml version="1.0" encoding="utf-8"?>
<result>
   <success>1</success>
   <product_id>1</product_id>
</result>
Element Datentyp Bedeutung
result Container Container mit angeforderten Daten
success Boolean Kennzeichen für einen erfolgreichen Aufruf
1 = erfolgreich
-1 = fehlerhaft
product_id Integer ID des Produkts


Fehlermeldungen



Code Bedeutung
1005 Die Artikel-Nummer ist im Produkt-Bestand bereits vorhanden
1010 Die ISBN-Nummer ist ungültig
1011 Die EAN-Nummer ist ungültig
1015 Die Versandgruppe konnte nicht gefunden werden
1020 Der reduzierte Preis ist nicht günstiger als der Standard-Preis
1030 Die Rakuten-Kategorie konnte nicht gefunden werden
1031 Die Shop-Kategorie konnte nicht gefunden werden
5001 Überprüfen Sie bitte Ihre Eingaben zur Energieeffizienzklasse.
5002 Die Eingabe der Produktgruppe ist nicht korrekt.
5003 Bitte fügen Sie ein Label ein.
5004 Diese Produktgruppe benötigt zwei Energieeffizienzklassen. Es fehlt ein Wert des Parameters energy_class_to.
5005 Diese Produktgruppe darf nur eine Energieeffizienzklasse enthalten. Es wurden jedoch zwei Werte gefunden.
5006 Energieeffizienzklasse fehlerhaft. Bitte überprüfen Sie ihre Eingabe des Parameters energy_class_to.
5007 Die Angaben der Energieeffizienzklassen sind fehlerhaft. Bitte geben Sie die niedrigere zuerst an.
5008 Dieses Format wird nicht unterstützt. Bitte verwenden Sie .gif, .jpg oder .png
5009 Das Produkt hat Varianten. Bitte setzen sie die Werte der Klassen sowie das Label in den Varianten.
5010 Die Produktgruppe fehlt. Sie können keine Energieeffizienzklassen angeben.
5011 Bitte fügen Sie die Angaben der Energieeffizienzklassen hinzu.
5012 Die Angabe der Energieeffizienzklasse fehlt.