Dokumentation zur Rakuten Shop-API


addProductVariant

Diese Methode fügt eine neue Variante zu einem 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_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.
variant_art_no

Artikel-Nummer der Variante

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

Über-Bezeichnung der Varianten (z.B. Farben)

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

Bezeichnung der Variante (z.B. Blau)

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

Preis

Datentyp: Float
isbn

ISBN

Datentyp: String
ean

EAN

Datentyp: String
mpn

MPN (eindeutige Hersteller-Artikel-Nummer)

Datentyp: String
Regeln: Maximal 30 Zeichen sind erlaubt.
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
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
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
available

Verfügbarkeit

Datentyp: Boolean
Standard: 1
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
sort

Position in der Sortierung der Variante

Datentyp: Integer

Antwort

Beispiel im XML-Format.

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


Fehlermeldungen



Code Bedeutung
1205 Die Produkt-ID oder Artikel-Nummer wurde nicht übergeben
1210 Das Produkt konnte nicht gefunden werden
1212 Die Varianten-Bezeichnung wurde nicht übergeben
1215 Die Varianten-Artikel-Nummer ist im Produkt-Bestand bereits vorhanden
1220 Der reduzierte Preis ist nicht günstiger als der Standard-Preis
1225 Die ISBN-Nummer ist ungültig
1230 Die EAN-Nummer ist ungültig
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.