Spezifische Artikeldaten für Amazon

Navigation:  WebService Calls > Options for Growth > fetchItems > Plattformspezifische Daten >

Spezifische Artikeldaten für Amazon

 Previous pageReturn to chapter overviewNext page

Texte ein-/ausblenden

Beschreibung

Bei diesem Eintrag handelt es sich um den neuen Aufbau der Daten für die Amazon Listing API. Der bisherige Aufbau ist hier dokumentiert.

 

Die XML-Struktur welche die spezifischen Artikeldaten für die Verkaufsplattform Amazon enthält ist als Kindelement in das Element specific_item_data in den Response-Daten von fetchItems eingebettet.

Sie besitzt folgende Struktur:

Beispiel Response

Code

<amazon_listing_item_data>

   <account_specific_data>

      <account_specific>

         <account_id>73706</account_id>

         <product_type>JUMP_ROPE</product_type>

         <listing_mode>LISTING</listing_mode>

         <asin>B001AB23CD</asin>

         <restock_date>2025-02-21</restock_date>

         <fulfillment_latency>3</fulfillment_latency>

         <endless_stock>false</endless_stock>

         <title>Springseil mit Holzgriff</title>

         <recommended_browse_node1>190817011</recommended_browse_node1>

         <recommended_browse_node2>23034647031</recommended_browse_node2>

         <listing_settings>

            <primary>0</primary>

            <placing_count>15</placing_count>

            <refill_count>5</refill_count>

         </listing_settings>

         <description_template>

            <template_id>118</template_id>

            <template_identifier>Allgemein mit Design</template_identifier>

         </description_template>

         <shipping_group>

            <shipping_group_id>73717</shipping_group_id>

            <shipping_group_identifier>D-A-CH + EU</shipping_group_identifier>

         </shipping_group>

         <listing_settings>

            <primary>0</primary>

            <placing_count>10</placing_count>

            <refill_count>5</refill_count>

         </listing_settings>

         <amazon_prices>

            <amazon_price>

               <price_type>STANDARD_PRICE</price_type>

               <amount>39.79</amount>

            </amazon_price>

            <amazon_price>

               <price_type>DISCOUNTED_PRICE</price_type>

               <amount>32.79</amount>

               <start_date>2026-05-19</start_date>

               <end_date>2026-07-20</end_date>

            </amazon_price>

         </amazon_prices>

         <amazon_images>

            <amazon_image>

               <image_type>MAIN_PRODUCT_IMAGE_LOCATOR</image_type>

               <image_module_type_id>1727550</image_module_type_id>

            </amazon_image>

         </amazon_images>

         <amazon_attributes>

         <!-- Alternative 1 - Die Daten werden direkt als JSON-Objekt zurückgegeben. -->

            <amazon_attribute>

               <name>condition_type</name>

               <value>[{"value":"new_new","marketplace_id":"A1PA6795UKMFR9"}]</value>

            </amazon_attribute>

         <!-- Alternative 2 - Die Daten werden als JSON-Pointer zurückgegeben. -->

            <amazon_attribute>

               <name>uvp_list_price</name>

                  <amazon_attribute_values>

                     <amazon_attribute_value>

                        <json_pointer>/value</json_pointer>

                        <value>42.99</value>

                  </amazon_attribute_value>

                  <amazon_attribute_value>

                     <json_pointer>/currency</json_pointer>

                     <value>EUR</value>

                  </amazon_attribute_value>

               </amazon_attribute_values>

            </amazon_attribute>

         </amazon_attributes>

      </account_specific>

   </account_specific_data>

</amazon_listing_item_data>

Feldliste Response

Name

Beschreibung        

Anz.

Typ

sonstiges

amazon_listing_item_data

Wrapper-Element, das die spezifischen Artikeldaten für die Verkaufsplattform Amazon enthält.

0..1

Element

account_specific_data

Wrapper-Element, das die Account-spezifischen Daten des Amazon-Artikels nach ihren Accounts zusammenfasst.

0..1

Element

account_specific

Wrapper-Element, das die Account-spezifischen Daten eines Accounts zusammenfasst.

0..N

Element

account_id

ID des Accounts.

1

integer

product_type

Amazonspezifische Bezeichnung des Produkttyps.

0..1

string

listing_mode

Listing-Modus des Angebots.

0..1

string

Feste Werte: "LISTING" | "LISTING_OFFER_ONLY

asin

Die ASIN des Produkts.

0..1

string

restock_date

Das Wiederverfügbarkeitsdatum.

0..1

date

fulfillment_latency

Die Bearbeitungszeit für den Versand.

0..1

integer

endless_stock

Bei endlosem Vorrat wird durch Amazon der Bestand ignoriert und Kunden können das Angebot ohne Limit kaufen.

1

boolean

title

Der Angebotstitel.

0..1

string

recommended_browse_node1

Die Nummer der ersten Recommended Browse Node (Empfohlene Stöbern-Kategorie)

0..1

integer

recommended_browse_node2

Die Nummer der zweiten Recommended Browse Node (Empfohlene Stöbern-Kategorie)

0..1

integer

listing_settings

Wrapper-Element welches die Einstellmengen für diesen Artikel, die Plattform und den Account festlegt.


placing_count



refill_count



description_template

Wrapper-Element, das die Informationen zur Angebotsvorlage zusammenfasst.

0..1

Element

template_id

Softwareinterne ID der Angebotsvorlage.

0..1

integer

template_identifier

Bezeichnung der Angebotsvorlage.

0..1

string

shipping_group

Wrapper-Element, das die Informationen zur Versandvorlage.


shipping_group_id

Softwareinterne ID der Versandvorlage.


shipping_group_identifier

Bezeichnung der Versandvorlage.


listing_settings

Wrapper-Element welches die Einstellmengen für diesen Artikel, die Plattform und den Account festlegt.

0..1

Element

primary

Legt fest ob dieser Account der primäre Verkaufskanal sein soll.

1

boolean

Feste Werte:

1 = primär. |

0 = nicht primär

placing_count

Legt die initiale Einstellmenge für den Artikel fest.

1

integer

refill_count

Legt die Menge fest, ab der wieder aufgefüllt wird.

1

integer

amazon_prices

Wrapper-Element, das die Preisinformationen des Artikels zusammenfasst.

0..1

Element

amazon_price

Wrapper-Element, das die Information zu einem Preistyp beinhaltet.

1..N

Element

price_type

Bezeichner des Preistyps.

1

string

Liste der Preistypen

amount

Preis für diesen Preistyp.

1

decimal

start_date

Nur relevant beim Preistyp: DISCOUNTED_PRICE

0..1

date

end_date

Nur relevant beim Preistyp: DISCOUNTED_PRICE

0..1

date

discount_type_id

Nur relevant beim Preistyp: QUANTITY_DISCOUNT_PLAN. Gibt an ob es sich um welchen Rabatttyp (Prozent/Festpreis) handelt.

0..1

integer

Werte:
"1" = "fixed"
"2" = "percent

discount_type

Nur relevant beim Preistyp: QUANTITY_DISCOUNT_PLAN. Gibt an ob es sich um welchen Rabatttyp (Prozent/Festpreis) handelt.

0..1

string

Werte:
"fixed"
"percent"

lower_bound

Nur relevant beim Preistyp: QUANTITY_DISCOUNT_PLAN. Ab dieser Bestellmenge greift der Mengenrabatt.

0..1

integer

amazon_images

Wrapper-Element, das Bilder für einen Account zusammenfasst.

0..1

Element

amazon_image

Wrapper-Element, das Informationen für ein Bild beinhaltet.

1..N

Element

image_type

Gibt den Bildtyp an.

1

string

Liste der Bildtypen

image_module_type_id

Gibt die ID des Bildbausteins an.

1

integer

amazon_attributes

Wrapper-Element, das die Marktplatz-Attribute zusammenfasst.

0..1

Element

Siehe Hinweise

Alternative 1 - Es wird direkt das JSON-Objekt im Feld value ausgegeben.


amazon_attribute

Wrapper-Element, das die Informationen zu einem Attribut enthält.

1..N

Element

name

Technischer Name des Elements

1

string

value

JSON-Objekt - Enthält immer den JSON-Pointer, einen Wert und die zugehörige Amazon Marktplatz-ID (marketplace_id)

1

string

Siehe marketplace_id-Tabelle

Alternative 2 - Die Daten werden per JSON-Pointer ausgegeben.


amazon_attribute

Wrapper-Element, das die Informationen zu einem Attribut enthält.

1..N

Element

name

Technischer Name des Elements

1

string

amazon_attribute_values

Wrapper-Element, das die Attributwerte eines Amazon-Attributes zusammenfasst.

1

Element

amazon_attribute_value

Wrapper-Element, das die Informationen eines Attributwertes beinhaltet.

1..N

Element

json_pointer

Technischer Name des Attributwertpointers

1

string

value

Der Attributwert der Amazon-Produktdaten

1

string

Wertetabelle(n)

Aufgeführte Werte gelten für das Feld price_type

Wert

Bemerkung

STANDARD_PRICE

B2C - Standardpreis

DISCOUNTED_PRICE

B2C - Rabattpreis

MINIMUM_SELLER_ALLOWED_PRICE

B2C - Unterste Preisgrenze

MAXIMUM_SELLER_ALLOWED_PRICE

B2C - Oberste Preisgrenze

MAP_PRICE

B2C - Minimaler beworbener Preis (Hersteller)

MAP_PRICE_B2B

B2B - Minimaler beworbener Preis (Hersteller)

STANDARD_PRICE_B2B

B2B - Standardpreis

MINIMUM_SELLER_ALLOWED_PRICE_B2B

B2B - Unterste Preisgrenze

MAXIMUM_SELLER_ALLOWED_PRICE_B2B

B2B - Oberste Preisgrenze

Aufgeführte Werte gelten für das Feld image_type

Wert

Bemerkung

MAIN_PRODUCT_IMAGE_LOCATOR

Hauptbild

SWATCH_PRODUCT_IMAGE_LOCATOR

Musterbild

OTHER_PRODUCT_IMAGE_LOCATOR_1

Zusatzbild 1

OTHER_PRODUCT_IMAGE_LOCATOR_2

Zusatzbild 2

OTHER_PRODUCT_IMAGE_LOCATOR_3

Zusatzbild 3

OTHER_PRODUCT_IMAGE_LOCATOR_4

Zusatzbild 4

OTHER_PRODUCT_IMAGE_LOCATOR_5

Zusatzbild 5

OTHER_PRODUCT_IMAGE_LOCATOR_6

Zusatzbild 6

OTHER_PRODUCT_IMAGE_LOCATOR_7

Zusatzbild 7

OTHER_PRODUCT_IMAGE_LOCATOR_8

Zusatzbild 8

MAIN_OFFER_IMAGE_LOCATOR

Hauptzustandsbild

OTHER_OFFER_IMAGE_LOCATOR_1

Zustandsbild 1

OTHER_OFFER_IMAGE_LOCATOR_2

Zustandsbild 2

OTHER_OFFER_IMAGE_LOCATOR_3

Zustandsbild 3

OTHER_OFFER_IMAGE_LOCATOR_4

Zustandsbild 4

OTHER_OFFER_IMAGE_LOCATOR_5

Zustandsbild 5

IMAGE_LOCATOR_PFUK

UK Produktdatenblatt

IMAGE_LOCATOR_PFDE

DE Produktdatenblatt

IMAGE_LOCATOR_PFFR

FR Produktdatenblatt

IMAGE_LOCATOR_PFIT

IT Produktdatenblatt

IMAGE_LOCATOR_PFES

ES Produktdatenblatt

IMAGE_LOCATOR_EEGL

Energieeffizienzlabel

IMAGE_LOCATOR_ELFL

Beleuchtungsdaten (Lighting Facts)

IMAGE_LOCATOR_PS01

PS01 (Produktsicherheit)

IMAGE_LOCATOR_PS02

PS02

IMAGE_LOCATOR_PS03

PS03

IMAGE_LOCATOR_PS04

PS04

IMAGE_LOCATOR_PS05

PS05

IMAGE_LOCATOR_PS06

PS06

Aufgeführte Werte gelten für das Feld marketplace_id

Wert

Bemerkung

A2VIGQ35RCS4UG

amazon.ae

A2EUQ1WTGCTBG2

amazon.ca

A1F83G8C2ARO7P

amazon.co.uk

ATVPDKIKX0DER

amazon.com

A39IBJ37TRP1C6

amazon.com.au

AMEN7PMS3EDWL

amazon.com.be

A1AM78C64UM0Y8

amazon.com.mx

A33AVAJ2PDY3EV

amazon.com.tr

A1PA6795UKMFR9

amazon.de

ARBP9OOSHTCHU

amazon.eg

A1RKKUPIHCS9HS

amazon.es

A13V1IB3VIYZZH

amazon.fr

APJ6JRA9NG5V4

amazon.it

A1805IZSGTT6HS

amazon.nl

A1C3SOZRARQ6R3

amazon.pl

A17E79C6D8DWNP

amazon.sa

A2NODRKZP88ZB9

amazon.se

Value Table - for Field sub_channel_id

sub_channel_id

sub_channel_identifier

channel_identifier

1001

Speed4Trade COMMERCE

Onlineshops

1100

modified Shop

Onlineshops

1600

MagentoCommerce

Onlineshops

1700

OXID

Onlineshops

1900

Shopware

Onlineshops

2100

eBay.de

eBay

2200

eBay.co.uk

eBay

2250

eBay.ie

eBay

2300

eBay.com

eBay

2310

eBay Motors

eBay

2350

eBay.ca

eBay

2400

eBay.fr

eBay

2500

eBay.it

eBay

2600

eBay.at

eBay

2650

eBay.ch

eBay

2700

eBay.es

eBay

2750

eBay.com.au

eBay

2800

eBay.nl

eBay

2850

eBay.be

eBay

2900

eBay.pl

eBay

3100

amazon.de

Amazon

3200

amazon.co.uk

Amazon

3300

amazon.fr

Amazon

3350

amazon.nl

Amazon

3400

amazon.com

Amazon

3500

amazon.it

Amazon

3550

amazon.ae

Amazon

3600

amazon.es

Amazon

3700

amazon.ca

Amazon

3750

amazon.com.au

Amazon

3800

amazon.com.mx

Amazon

3820

amazon.eg

Amazon

3830

amazon.sa

Amazon

3840

amazon.tr

Amazon

3850

amazon.se

Amazon

3860

amazon.pl

Amazon

4100

Telefonverkauf

manual sales / telesales

6100

Yatego

Yatego

9100

DAPARTO.de

DAPARTO

10100

otto.de

OTTO

10200

otto.at

OTTO

10300

otto.ch

OTTO

10400

otto.nl

OTTO

10500

otto.ru

OTTO

13100

Kaufland.de

Kaufland.de

14001-14999

individual channel name (see notes below)

Multi-Channel-Plugin (MCP)

15100

OTTO Market DE

OTTO Market

 

Note for value table and field : sub_channel_id:

The sub channels for the Multi-Channel-Plugin (MCP) can be configured via the Speed4Trade CONNECT UI. This doesn't allow for a standardized definition across all customer systems. The required subchannel_ids can be retrieved by using the call fetchSubChannels which could be executed after the initial configuration of a new subchannel using a tool like SoapUI. Setup of this tool is described in the Partnerportal.

 

Aufgeführte Werte gelten für das Feld product_tax_code

Wert

A_BABY_BIBCLOTH

A_BABY_CARSEAT

A_BABY_NAPPIES

A_BOOKS_GEN

A_BOOK_ADULT

A_BOOK_ATLAS

A_BOOK_AUDIOBOOK

A_BOOK_GLOBE

A_BOOK_MAGAZINE

A_BOOK_MAP

A_CLTH_BABY

A_CLTH_CHILD

A_CLTH_PROTECTIVE

A_FOOD_ANIMALFOOD

A_FOOD_ANIMALMED

A_FOOD_ANIMALVITAMINS

A_FOOD_CAKEDECOR

A_FOOD_CANFRUIT

A_FOOD_CEREALBARS

A_FOOD_CEREALCHOCBARS

A_FOOD_CHOCEREAL

A_FOOD_CNDY

A_FOOD_COFFEE

A_FOOD_DAIRY

A_FOOD_DESSERT

A_FOOD_DRIEDFRUIT

A_FOOD_FLOUR

A_FOOD_GEN

A_FOOD_MEATCHICKEN

A_FOOD_MISCBEVERAGE

A_FOOD_NAAN

A_FOOD_NCARBWTR

A_FOOD_OIL

A_FOOD_OLIVEOIL

A_FOOD_PASTANOODLE

A_FOOD_PASTRYCASE

A_FOOD_PETFOOD

A_FOOD_PLAINBISCUIT

A_FOOD_PLAINCRACKER

A_FOOD_PLAINNUT

A_FOOD_RICE

A_FOOD_SEASONINGS

A_FOOD_SNACK

A_FOOD_SODAJUICE

A_FOOD_SODAJUICEUNSWEET

A_FOOD_SPREAD

A_FOOD_SWEETNER

A_FOOD_TEA

A_FOOD_VEGETABLE

A_GEN_NOTAX

A_GEN_STANDARD

A_HLTH_NUTRITIONBAR

A_HLTH_NUTRITIONDRINK

A_HLTH_PILLCAPSULETABLET

A_HLTH_SMOKINGCESSATION

A_HLTH_SMOKINGGUM

A_HLTH_VITAMINS

A_HPC_CONTACTLENSES

A_HPC_CONTRACEPTIVE

A_HPC_CORRECTIVEGLASSES

A_HPC_DIETARYSUPPL

A_HPC_INCONTINENCE

A_HPC_MEDICINE

A_HPC_PPECLOTHING

A_HPC_PPEMASKS

A_HPC_PPESANITISER

A_HPC_SANITARYPRODUCTS

A_HPC_SANITARYPRODUCTSWASHABLE

A_HPC_THERMOMETER

A_HPC_WALKINGSTICK

A_HPC_WHEELCHAIR

A_OUTDOOR_FERTILIZER

A_OUTDOOR_FUEL

A_OUTDOOR_LAWNCONTROL

A_OUTDOOR_PLANTFOOD

A_OUTDOOR_PLANTS

A_OUTDOOR_SEEDS

Hinweise

•Es werden zwei Listing-Modus unterstützt.

oLISTING = Als Verkäufer möchte man sowohl Produkt- als auch Angebotsdaten übertragen.

oLISTING_OFFER_ONLY = Als Verkäufer möchte man nur Angebotsdaten übertragen und sich an bestehende Angebote "anhängen".

Hinweise zu amazon_attributes

Über die amazon_attributes können die Amazon-Produktdaten direkt gepflegt werden. Wir empfehlen die Vererbung der Daten aus zentralen Attributen.

Im FetchItems werden die Amazon-Produktdaten als amazon_attributes ausgegeben, die direkt im Artikel gesetzt sind. Für die Ausgabe der amazon_attributes gibt es zwei Arten des Aufbaus. In dem Beispielresponse sind beide Optionen enthalten.

Die Option mit json_pointer (Alternative 2) wird nur zurückgegeben, wenn Sie die Werte für die Produktdaten per Webservicecall UpdateItems ebenfalls per Pointer übergeben haben.

Ansonsten werden die Daten immer als JSON-Objekt im Feld value (Alternative 1) zurückgegeben.

Änderungsübersicht

Version

Änderungsbeschreibung

Erweiterung von fetchItems um amazon_listing_item_data für die Amazon Listing API.