Dokumentation zur Rakuten Shop-API


editProductVariant

Diese Methode bearbeitet eine Variante.

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

ID der Variante

Datentyp: Integer
Regeln: Entweder der Parameter variant_id oder variant_art_no wird benötigt.
variant_art_no *

Artikel-Nummer der Variante

Datentyp: String
Regeln: Entweder der Parameter variant_id oder variant_art_no wird benötigt.
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
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
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)
available

Verfügbarkeit

Datentyp: Boolean
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
ean

EAN

Datentyp: String
isbn

ISBN

Datentyp: String
mpn

MPN (eindeutige Hersteller-Artikel-Nummer)

Datentyp: String
Regeln: Maximal 30 Zeichen sind erlaubt.
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>
</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
2305 Die Varianten-ID oder Varianten-Artikel-Nummer wurde nicht übergeben
2310 Die Variante konnte nicht gefunden werden
2315 Die Varianten-Artikel-Nummer ist im Produkt-Bestand bereits vorhanden
2320 Der reduzierte Preis ist nicht günstiger als der Standard-Preis
2325 Die ISBN-Nummer ist ungültig
2330 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.