Dokumentation zur Rakuten Shop-API


editProduct

Diese Methode bearbeitet ein Produkt.

Mit dieser URL rufen Sie die API-Methode auf:

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

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.
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 5. 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-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)

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
m² = Quadratmeter
m³ = 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 %
11 = 12 %
12 = 20 %
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 werden aus der Produkt-Beschreibung entfernt.
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

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

Übersicht

Allgemein

Produkte

Bestellungen

Kategorien