WebService Calls > Options for Growth > updateItems > Plattformspezifische Daten

Information zur Umstellung auf die Amazon Listings API

Mit der Umstellung zur Amazon Listings API gibt es für die Webservice-API-Calls updatePrices, fetchItems und UpdateItems Änderungen.

Um den Übergang zu erleichtern, können sowohl die alte (<amazon_item_data>) als auch die neue Struktur (<amazon_listing_item_data>) parallel übertragen werden. So wird sichergestellt, dass der Datenaustausch auch nach der Aktivierung der neuen Amazon-Schnittstelle weiterhin funktioniert. Nach erfolgreicher Migration empfehlen wir, die alte Struktur aus dem updateItems-Request zu entfernen, um die Datenmenge im Call weiterhin schlank zu halten.

Bei Verwendung des alten <amazon_item_data> und der neuen Software-Version, werden Titel und Preis noch in die neuen Felder übernommen.

Die Veröffentlichung der entsprechenden Software-Version wird wie gewohnt hier dokumentiert: https://www.speed4trade.com/kontakt/versionshistorie/

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 muss als Kindelement in das Element specific_item_data in den Request-Daten von updateItems eingebettet sein. Hierbei handelt es sich um den neuen Aufbau der Daten für die Amazon Listings API.

Beispiel Request

Code

<amazon_listing_item_data>

<account_specific_data delete="false">

<account_specific>

<account_id>73706</account_id>

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

<fulfillment_latency>3</fulfillment_latency>

<endless_stock>false</endless_stock>

<title>Springseil mit Holzgriff</title>

<product_type>JUMP_ROPE</product_type>

<listing_mode>LISTING</listing_mode>

<recommended_browse_node1>190817011</recommended_browse_node1>

<recommended_browse_node2>23034647031</recommended_browse_node2>

<shipping_group_identifier>Standard</shipping_group_identifier>

<listing_settings>

<placing_count>15</placing_count>

<refill_count>5</refill_count>

<transfer_to_offer>false</transfer_to_offer>

</listing_settings>

<description_template>

<template_id>118</template_id>

<template_identifier>Allgemein mit Design</template_identifier>

</description_template>

<amazon_prices delete="false">

<amazon_price>

<price_type>STANDARD_PRICE</price_type>

</amazon_price>

<amazon_price>

<price_type>DISCOUNTED_PRICE</price_type>

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

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

</amazon_price>

</amazon_prices>

<amazon_images delete="false">

<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 delete="false">

<amazon_attribute>

<name>condition_type</name>

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

</amazon_attribute>

<amazon_attribute>

<name>uvp_list_price</name>

<amazon_attribute_values>

<amazon_attribute_value>

<json_pointer>/value</json_pointer>

</amazon_attribute_value>

<amazon_attribute_value>

<json_pointer>/currency</json_pointer>

</amazon_attribute_value>

</amazon_attribute_values>

</amazon_attribute>

</amazon_attributes>

</account_specific>

</account_specific_data>

</amazon_listing_item_data>

Feldliste Request

Name	Beschreibung	Anz.	Typ	sonstiges
amazon_listing_item_data	Wrapper-Element, das die spezifischen Artikeldaten für die Verkaufsplattform Amazon enthält.	0..N	Element
account_specific_data	Wrapper-Element, das die Account-spezifischen Daten des Amazon-Artikels nach ihren Accounts zusammenfasst.	0..1	Element
delete	Löschkennzeichen - Attribut von account_specific_data, mit dem festgelegt werden kann ob die übergebenen Daten additiv (delete="false") oder überschreibend (delete="true") zugewiesen werden. Wird das Flag delete="true" übergeben und keine weiteren Daten, werden alle bisher gepflegten account_specific_data entfernt.
account_specific	Wrapper-Element, das die Account-spezifischen Daten eines Accounts zusammenfasst.	0..N	Element
account_id	ID des Accounts.	1	integer
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.	0..1	boolean
title	Der Angebotstitel.	0..1	string
product_type	Amazonspezifische Bezeichnung des Produkttyps.	0..1	string	Siehe Hinweis
listing_mode	Listing-Modus des Angebots.	0..1	string	Feste Werte: "LISTING" \| "LISTING_OFFER_ONLY
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
shipping_group_id	Zuweisung einer Versandvorlage anhand der ID..	0..1	integer
shipping_group_identifier	Zuweisung einer Versandvorlage anhand der Bezeichnung.	0..1	string
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
transfer_to_offer	Ist die Option aktiv, so wird die angegebene Einstellmenge und Auffüllmenge an laufende Angebote übertragen.	0..1	boolean
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
amazon_prices	Wrapper-Element, das die Preisinformationen des Artikels zusammenfasst.	0..1	Element
delete	Löschkennzeichen - Attribut von amazon_prices, mit dem festgelegt werden kann ob die übergebenen Daten additiv (delete="false") oder überschreibend (delete="true") zugewiesen werden. Wird das Flag delete="true" übergeben und keine weiteren Daten, werden alle bisher gepflegten amazon_prices entfernt.
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
delete	Löschkennzeichen - Attribut von amazon_images, mit dem festgelegt werden kann ob die übergebenen Daten additiv (delete="false") oder überschreibend (delete="true") zugewiesen werden. Wird das Flag delete="true" übergeben und keine weiteren Daten, werden alle bisher gepflegten amazon_images entfernt.
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
delete	Löschkennzeichen - Attribut von amazon_attributes, mit dem festgelegt werden kann ob die übergebenen Daten additiv (delete="false") oder überschreibend (delete="true") zugewiesen werden. Wird das Flag delete="true" übergeben und keine weiteren Daten, werden alle bisher gepflegten amazon_attributes entfernt.
	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
	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.

Hinweise zu den Amazon-Produktdaten

Um Amazonangebote über die neue Listings API einstellen zu können, sind immer Produktdaten notwendig. Diese definieren sich entsprechend des gewählten Produkttyps (product_type). Wird per UpdateItems ein Artikel angelegt oder aktualisiert und es wird ein Produkttyp übergeben der noch nicht in der Software bekannt ist, dann wird asynchron versucht die Produkttypdaten von Amazon abzurufen. Dabei ist entsprechend wichtig, dass die Schreibeweise des Produkttyps mit dem erwarteten Wert von Amazon übereinstimmt (z.B: AUTO_OIL für Motoröl).

Änderungsübersicht

Version	Änderungsbeschreibung
	Erweiterung von updateItems um den Aufbau für die Amazon Listing API.

Spezifische Artikeldaten für Amazon

Spezifische Artikeldaten für Amazon