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:

http://webservice.rakuten.de/merchants/products/addProductVariant

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 30 Zeichen sind erlaubt.
variant_art_no

Artikel-Nummer der Variante

Datentyp: String
Regeln: Maximal 30 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
m² = Quadratmeter
m³ = Kubikmeter
baseprice_volume

Referenz-Menge

Datentyp: Float
stock

Bestand

Datentyp: Integer
delivery

Lieferzeit

Datentyp: Integer
Regeln:
0 = Sofort lieferbar (Lieferzeit 1-4 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 länger als 3 Monate)
Standard: 0
available

Verfügbarkeit

Datentyp: Boolean
Standard: 1

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

Übersicht

Allgemein

Produkte

Bestellungen

Kategorien