Diese Methode gibt Produkte des Händlers aus.
Mit dieser URL rufen Sie die API-Methode auf:
http://webservice.rakuten.de/merchants/products/getProducts
Für diese Methode ist eine Authentifizierung mit Leserechten erforderlich.
Empfohlen wird der Aufruf über HTTP-GET.
Die mit * gekennzeichneten Parameter müssen übergeben werden.
Authentifizierungs-Schlüssel
| Datentyp: | String |
Filter: Such-Text
| Datentyp: | String |
| Regeln: | Zu einem Such-Text muss ein entsprechendes Such-Feld angegeben sein. Maximal 100 Zeichen sind erlaubt. |
Filter: Such-Feld
| Datentyp: | String | ||||||||||||||||||
| Regeln: |
Zu einem Such-Feld muss ein entsprechender Such-Text angegeben sein. |
Filter: Sichtbarkeit
| Datentyp: | Boolean |
Filter: Verfügbarkeit
| Datentyp: | Boolean |
Filter: Das Produkt ist für kostenpflichtige Connect!-Module deaktiviert
| Datentyp: | Boolean |
Filter: Das Produkt wird auf der Startseite im Shop angezeigt
| Datentyp: | Boolean |
Filter: Das Produkt besitzt Varianten
| Datentyp: | Boolean |
Sortierung
| Datentyp: | String | ||||||||||||||||||
| Regeln: |
|
||||||||||||||||||
| Standard: | product_id_asc Wenn eine Shop-Kategorie im Parameter "search_field" angeben ist, so wird die hinterlegte Sortierung dieser Shop-Kategorie verwendet. |
Anzahl der Produkte pro Seite
| Datentyp: | Integer |
| Standard: | 20 |
| Regeln: | Maximal 100 Produkte pro Seite sind erlaubt. Wird ein Wert über 100 angegeben, so wird der Standard-Wert verwendet. |
Aktuelle Seite
| Datentyp: | Integer |
| Standard: | 1 |
Beispiel im XML-Format (Ein Produkt ohne und ein Produkt mit Varianten).
<?xml version="1.0" encoding="utf-8"?>
<result>
<success>1</success>
<products>
<paging>
<total>2</total>
<page>1</page>
<pages>1</pages>
<per_page>20</per_page>
</paging>
<product>
<product_id>1</product_id>
<product_art_no>ART-99</product_art_no>
<name>Musterprodukt</name>
<producer>Musterhersteller</producer>
<price>2.99</price>
<price_reduced>1.99</price_reduced>
<price_reduced_type>UVP</price_reduced_type>
<shipping_group>1</shipping_group>
<tax>1</tax>
<baseprice_unit>ml</baseprice_unit>
<baseprice_volume>0.750</baseprice_volume>
<min_order_qty>2</min_order_qty>
<staggering>2,4,6</staggering>
<stock_policy>1</stock_policy>
<stock>100</stock>
<delivery>3</delivery>
<visible>1</visible>
<available>1</available>
<homepage>0</homepage>
<connect>1</connect>
<isbn>123456789</isbn>
<ean>123456789</ean>
<mpn>123456789</mpn>
<description>Sofort kaufen!</description>
<inci>Inhaltsangabe</inci>
<comment>Mein bestes Produkt</comment>
<cross_selling_title>Diese Produkte sind auch super!</cross_selling_title>
<created>2010-01-01 20:15:00</created>
<url_portal>http://www.rakuten.de/p/mein-produkt-123456</url_portal>
<url_shop>http://www.domain.de/p/123456/mein-produkt</url_shop>
<has_variants>0</has_variants>
<images>
<image>
<image_id>1</image_id>
<src>URL zum Bild</src>
<default>1</default>
<comment>Musterprodukt im Freien</comment>
<image>
<images>
</product>
<product>
<product_id>2</product_id>
<product_art_no>ART-88</product_art_no>
<name>Musterprodukt 2</name>
<producer>Musterhersteller</producer>
<shipping_group>1</shipping_group>
<tax>1</tax>
<min_order_qty>1</min_order_qty>
<staggering>9,18,27</staggering>
<stock_policy>0</stock_policy>
<visible>1</visible>
<homepage>0</homepage>
<connect>1</connect>
<description>Tolles Produkt!</description>
<inci>Inhaltsangabe</inci>
<comment>Verkauft sich gut</comment>
<cross_selling_title>Diese Produkte sind auch super!</cross_selling_title>
<created>2010-01-01 20:15:00</created>
<url_portal>http://www.rakuten.de/p/mein-produkt-123456</url_portal>
<url_shop>http://www.domain.de/p/123456/mein-produkt</url_shop>
<has_variants>1</has_variants>
<images>
<image>
<image_id>2</image_id>
<src>URL zum Bild</src>
<default>1</default>
<comment>Musterprodukt im Wohnzimmer</comment>
<image>
<images>
<variants>
<label>Farben</label>
<variant>
<variant_id>5</variant_id>
<variant_art_no>VART-88</variant_art_no>
<name>Blau</name>
<price>1.99</price>
<price_reduced>0.99</price_reduced>
<price_reduced_type>VK</price_reduced_type>
<baseprice_unit>ml</baseprice_unit>
<baseprice_volume>0.750</baseprice_volume>
<stock>20</stock>
<delivery>3</delivery>
<available>1</available>
<isbn>123456789</isbn>
<ean>123456789</ean>
<mpn>123456789</mpn>
<variant>
<variants>
</product>
</products>
</result>
| Element | Datentyp | Bedeutung | |||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| result | Container | Container mit Angeforderten Daten | |||||||||||||||||||||||||||||||||
| success | Boolean | Kennzeichen für einen erfolgreichen Aufruf
|
|||||||||||||||||||||||||||||||||
| products | Container | Container mit Produkten Beinhaltet keine Daten, wenn keine Produkte gefunden wurden! |
|||||||||||||||||||||||||||||||||
| paging | Container | Container mit Daten zum Paging | |||||||||||||||||||||||||||||||||
| total | Integer | Anzahl aller Produkte | |||||||||||||||||||||||||||||||||
| page | Integer | Aktuelle Seite | |||||||||||||||||||||||||||||||||
| pages | Integer | Anzahl aller Seiten | |||||||||||||||||||||||||||||||||
| per_page | Integer | Anzahl der Produkte pro Seite | |||||||||||||||||||||||||||||||||
| product | Container | Container mit Produktdaten | |||||||||||||||||||||||||||||||||
| product_id | Integer | ID des Produkts | |||||||||||||||||||||||||||||||||
| product_art_no | String | Artikel-Nummer | |||||||||||||||||||||||||||||||||
| name | String | Bezeichnung des Produkts | |||||||||||||||||||||||||||||||||
| producer | String | Hersteller | |||||||||||||||||||||||||||||||||
| price | Float | Preis Ist bei einem Produkt mit Varianten nicht vorhanden! |
|||||||||||||||||||||||||||||||||
| price_reduced | Float | Reduzierter Preis Ist bei einem Produkt mit Varianten nicht vorhanden! |
|||||||||||||||||||||||||||||||||
| price_reduced_type | Float | Bezug reduzierter Preis
Ist bei einem Produkt mit Varianten nicht vorhanden! |
|||||||||||||||||||||||||||||||||
| shipping_group | Integer | Versandgruppe | |||||||||||||||||||||||||||||||||
| tax | Integer | Mehrwertsteuer
|
|||||||||||||||||||||||||||||||||
| baseprice_unit | String | Einheit der Referenz-Menge
Ist bei einem Produkt mit Varianten nicht vorhanden! |
|||||||||||||||||||||||||||||||||
| baseprice_volume | Float | Referenz-Menge Ist bei einem Produkt mit Varianten nicht vorhanden! |
|||||||||||||||||||||||||||||||||
| min_order_qty | Integer | Mindestbestellmenge | |||||||||||||||||||||||||||||||||
| staggering | String | Staffelung Das Format der Staffelung ist 2,4,6,8. |
|||||||||||||||||||||||||||||||||
| stock_policy | Boolean | Bestandsverwaltung | |||||||||||||||||||||||||||||||||
| stock | Integer | Bestand Ist bei einem Produkt mit Varianten nicht vorhanden! |
|||||||||||||||||||||||||||||||||
| delivery | Integer | Lieferzeit
Ist bei einem Produkt mit Varianten nicht vorhanden! |
|||||||||||||||||||||||||||||||||
| visible | Boolean | Sichtbarkeit Ist bei einem Produkt mit Varianten nicht vorhanden! |
|||||||||||||||||||||||||||||||||
| available | Boolean | Verfügbarkeit | |||||||||||||||||||||||||||||||||
| homepage | Boolean | Wird auf der Startseite im Shop angezeigt | |||||||||||||||||||||||||||||||||
| connect | Boolean | Für kostenpflichtige Connect!-Module deaktiviert | |||||||||||||||||||||||||||||||||
| isbn | String | ISBN Ist bei einem Produkt mit Varianten nicht vorhanden! |
|||||||||||||||||||||||||||||||||
| ean | String | EAN Ist bei einem Produkt mit Varianten nicht vorhanden! |
|||||||||||||||||||||||||||||||||
| mpn | String | MPN (eindeutige Artikel-Nummer des Herstellers) Ist bei einem Produkt mit Varianten nicht vorhanden! |
|||||||||||||||||||||||||||||||||
| description | String | Produktbeschreibung | |||||||||||||||||||||||||||||||||
| inci | String | Inhaltsangaben | |||||||||||||||||||||||||||||||||
| comment | String | Kommentar | |||||||||||||||||||||||||||||||||
| cross_selling_title | String | Titel des Cross-Sellings | |||||||||||||||||||||||||||||||||
| created | Date | Erstellungs-Datum | |||||||||||||||||||||||||||||||||
| url_portal | URL | URL zum Produkt auf dem Rakuten-Portal Ist vorhanden, wenn das Produkt auf dem Portal sichtbar ist! |
|||||||||||||||||||||||||||||||||
| url_shop | URL | URL zum Produkt im Shop Ist vorhanden, wenn das Produkt im Shop sichtbar ist! |
|||||||||||||||||||||||||||||||||
| has_variants | Boolena | Kennzeichen für ein Produkt mit Varianten | |||||||||||||||||||||||||||||||||
| images | Container | Container mit Bildern Beinhaltet keine Daten, wenn keine Bilder gefunden wurden! |
|||||||||||||||||||||||||||||||||
| image | Container | Container mit Daten zu einem Bild | |||||||||||||||||||||||||||||||||
| image_id | Integer | ID | |||||||||||||||||||||||||||||||||
| src | URL | URL | |||||||||||||||||||||||||||||||||
| default | Boolean | Kennzeichen für das Produkt-Haupt-Bild | |||||||||||||||||||||||||||||||||
| comment | String | Kommentar | |||||||||||||||||||||||||||||||||
| variants | Container | Container mit Varianten Beinhaltet keine Daten, wenn keine Varianten gefunden wurden! |
|||||||||||||||||||||||||||||||||
| label | String | Über-Bezeichnung der Varianten (z.B. Farben) | |||||||||||||||||||||||||||||||||
| variant | Container | Container mit Daten zu einer Variante | |||||||||||||||||||||||||||||||||
| variant_id | Integer | ID der Variante | |||||||||||||||||||||||||||||||||
| variant_art_no | String | Artikel-Nummer | |||||||||||||||||||||||||||||||||
| name | String | Bezeichnung (z.B. Blau) | |||||||||||||||||||||||||||||||||
| price | Float | Preis | |||||||||||||||||||||||||||||||||
| price_reduced | Float | Reduzierter Preis | |||||||||||||||||||||||||||||||||
| price_reduced_type | String | Bezug des reduzierten Preises
|
|||||||||||||||||||||||||||||||||
| baseprice_unit | String | Einheit der Referenz-Menge
|
|||||||||||||||||||||||||||||||||
| baseprice_volume | Float | Referenz-Menge | |||||||||||||||||||||||||||||||||
| stock | Integer | Bestand | |||||||||||||||||||||||||||||||||
| delivery | Integer | Lieferzeit
|
|||||||||||||||||||||||||||||||||
| available | Bool | Verfügbarkeit | |||||||||||||||||||||||||||||||||
| isbn | String | ISBN | |||||||||||||||||||||||||||||||||
| ean | String | EAN | |||||||||||||||||||||||||||||||||
| mpn | String | MPN (eindeutige Artikel-Nummer des Herstellers) |
| Code | Bedeutung |
|---|---|
| 1605 | Das Such-Feld konnte nicht gefunden werden |
| 1606 | Die Sortierung konnte nicht gefunden werden |
| 1610 | Das Such-Feld zur Suche konnte nicht gefunden werden |
| 1611 | Die Suche zum Such-Feld konnte nicht gefunden werden |