Dokumentation zur Rakuten Shop-API


addProduct

Diese Methode fügt ein neues 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_art_no

Artikel-Nummer des Produkts

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

Bezeichnung des Produkts

Datentyp: String
Regeln: Maximal 100 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
Standard: VK
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
available

Verfügbarkeit

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

Referenz-Menge

Datentyp: Float
tax

Mehrwertsteuer

Datentyp: Integer
Regeln:
1 = 19 %
2 = 7 %
3 = 0 %
4 = 10,7 %
10 = 10 %
11 = 12 %
12 = 20 %
Standard: 1
homepage

Das Produkt wird auf der Startseite im Shop angezeigt

Datentyp: Boolean
Standard: 0
connect

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

Datentyp: Boolean
Standard: 0
ean

EAN

Datentyp: String
isbn

ISBN

Datentyp: String
mpn

MPN (eindeutige Hersteller-Artikel-Nummer)

Datentyp: String
Regeln: Maximal 30 Zeichen sind erlaubt.
inci

Inhaltsangaben

Datentyp: String
description *

Beschreibung

Datentyp: String
Regeln: HTML-Tags werden aus der Produkt-Beschreibung entfernt.
comment

Interner Kommentar

Datentyp: String
cross_selling_title

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

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

ID einer Shop-Kategorie

Datentyp: Integer
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>
   <product_id>1</product_id>
</result>
Element Datentyp Bedeutung
result Container Container mit Angeforderten Daten
success Boolean Kennzeichen für einen erfolgreichen Aufruf
1 = erfolgreich
-1 = fehlerhaft
product_id Integer ID des Produkts


Fehlermeldungen



Code Bedeutung
1005 Die Artikel-Nummer ist im Produkt-Bestand bereits vorhanden
1010 Die ISBN-Nummer ist ungültig
1011 Die EAN-Nummer ist ungültig
1015 Die Versandgruppe konnte nicht gefunden werden
1020 Der reduzierte Preis ist nicht günstiger als der Standard-Preis
1030 Die Rakuten-Kategorie konnte nicht gefunden werden
1031 Die Shop-Kategorie konnte nicht gefunden werden