Dokumentation zur Rakuten Shop-API


editProduct

Diese Methode bearbeitet ein Produkt.

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_id *

ID des Produkts

Datentyp: Integer
Regeln: Entweder der Parameter product_id oder product_art_no wird benötigt.
product_art_no *

Artikel-Nummer des Produkts

Datentyp: String
Regeln: Entweder der Parameter product_id oder product_art_no wird benötigt.
Maximal 50 Zeichen sind erlaubt.
name

Bezeichnung des Produkts

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

Preis

Datentyp: Float
Regeln: Ist bei einem Produkt mit Varianten ungültig.
price_reduced

Reduzierter Preis

Datentyp: Float
Regeln: Der reduzierte Preis muss niedriger als der Standard-Preis sein.
Ist bei einem Produkt mit Varianten ungültig.
price_reduced_type

Bezug des reduzierten Preises

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

Ist bei einem Produkt mit Varianten ungültig.
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
visible

Sichtbarkeit

Datentyp: Boolean
Regeln: Damit das Produkt sichtbar sein kein, muss es ein Bild besitzen.
available

Verfügbarkeit

Datentyp: Boolean
Regeln: Ist bei einem Produkt mit Varianten ungültig.
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
stock

Bestand

Datentyp: Integer
Regeln: Ist bei einem Produkt mit Varianten ungültig.
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)

Ist bei einem Produkt mit Varianten ungültig.
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

Ist bei einem Produkt mit Varianten ungültig.
baseprice_volume

Referenz-Menge

Datentyp: Float
Regeln: Ist bei einem Produkt mit Varianten ungültig.
tax

Mehrwertsteuer-Satz

Datentyp: Integer
Regeln:
1 = 19 %
2 = 7 %
3 = 0 %
4 = 10,7 %
10 = 10 %
12 = 20 %
13 = 13 %
14 = 2,1 %
15 = 5 %
16 = 5.5 %
homepage

Das Produkt wird auf der Startseite im Shop angezeigt

Datentyp: Boolean
connect

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

Datentyp: Boolean
ean

EAN

Datentyp: String
Regeln: Ist bei einem Produkt mit Varianten ungültig.
isbn

ISBN

Datentyp: String
Regeln: Ist bei einem Produkt mit Varianten ungültig.
mpn

MPN (eindeutige Hersteller-Artikel-Nummer)

Datentyp: String
Regeln: Maximal 30 Zeichen sind erlaubt.
Ist bei einem Produkt mit Varianten ungültig.
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
cross_selling_title

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

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

Interner Kommentar

Datentyp: String
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>
</result>
Element Datentyp Bedeutung
result Container Container mit angeforderten Daten
success Boolean Kennzeichen für einen erfolgreichen Aufruf
1 = erfolgreich
-1 = fehlerhaft


Fehlermeldungen



Code Bedeutung
2205 Die Produkt-ID oder Artikel-Nummer wurde nicht übergeben
2210 Das Produkt konnte nicht gefunden werden
2212 Der Parameter ist bei einem Produkt mit Varianten nicht gültig
2215 Die Artikel-Nummer ist im Produkt-Bestand bereits vorhanden
2220 Der reduzierte Preis ist nicht günstiger als der Standard-Preis
2222 Das Produkt kann wegen fehlenden Bildern nicht sichtbar werden
2231 Die Rakuten-Kategorie konnte nicht gefunden werden
2232 Die Rakuten-Kategorie wurde von Rakuten zugeordnet und kann somit nicht verändert werden
2240 Die ISBN-Nummer ist ungültig
2241 Die EAN-Nummer ist ungültig
2245 Die Versandgruppe 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.