Spezifische Preisdaten für Amazon |
  
|
Spezifische Preisdaten für Amazon |
|
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/ |
Die XML-Struktur welche die spezifischen Preisdaten für die Verkaufsplattform Amazon enthält muss als Kindelement in das Element specific_item_data in den Request-Daten von updatePrices eingebettet sein. |
<amazon_item_data> <account_specific_data> <account_specific> <account_id>172</account_id> <!--<mandator_id>1</mandator_id> --><!-- Alternative 2 --> <!--<account_identifier>testuser_speed4trade</account_identifier> --><!-- Alternative 2 --> <price>10.00</price> <business_price>9.90</business_price> <minimal_price>8.00</minimal_price> <sale_price>8.50</sale_price> <sale_start_date>2015-12-23T09:30:47Z</sale_start_date> <sale_end_date>2016-01-05T20:30:47Z</sale_end_date> <amazon_prices> <amazon_price> <amount>125.55</amount> <type>DISCOUNTED_PRICE</type> <sale_start_date>2025-02-02T09:30:47Z</sale_start_date> <sale_end_date>2025-02-05T20:30:47Z</sale_end_date> </amazon_price> </amazon_prices> </account_specific> </account_specific_data> </amazon_item_data> |
Name |
Beschreibung |
Anz. |
Typ |
sonstiges |
amazon_item_data |
Wrapper-Element, das die spezifischen Preisdaten 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. |
1 |
Element |
|
account_specific |
Wrapper-Element, das die Account-spezifischen Daten eines Accounts zusammenfasst. |
1..N |
Element |
|
account_id |
ID des Accounts |
1 |
integer |
|
mandator_id |
ID des Mandanten. Wird nur benötigt wenn account_identifier verwendet wird. |
1 |
integer |
|
account_identifier |
Bezeichner des Accounts |
1 |
string |
|
price |
Gibt den Standardpreis des Artikels an |
0..1 |
decimal |
|
business_price |
B2B Preis |
0..1 |
decimal |
|
minimal_price |
Minimalpreis des Artikels |
0..1 |
decimal |
|
sale_price |
Sonderangebotspreis |
0..1 |
decimal |
|
sale_start_date |
Sonderangebot Startdatum |
0..1 |
datetime |
|
sale_end_date |
Sonderangebot Endedatum |
0..1 |
datetime |
|
amazon_prices |
Wrapper-Element, das die neuen Preisdaten (Amazon Listings API) zusammenfasst. |
0..1 |
Element |
Siehe Informationen zur Umstellung. |
amazon_price |
Wrapper-Element, das die neuen Preisdaten (Amazon Listings API) für einen Preistyp zusammenfasst. |
1..N |
Element |
|
amount |
Preis für den entsprechenden Preistyp |
1 |
decimal |
|
type |
Preistyp |
1 |
string |
Siehe Liste der möglichen Preistypen. |
sale_start_date |
Startdatum des Angebotspreises (Feld ist nur relevant beim Preistyp: DISCOUNTED_PRICE) |
0..1 |
dateTime |
|
sale_end_date |
Enddatum des Angebotspreises (Feld ist nur relevant beim Preistyp: DISCOUNTED_PRICE) |
0..1 |
dateTime |
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 |
•Die Felder account_id und account_identifier dürfen nicht gleichzeitig genutzt werden. •Wenn das Feld account_identifier genutzt wird muss gleichzeitig vorher das Feld mandator_id genutzt werden. |
Informationen zur Umstellung auf die Amazon Listings API
•Die bisherigen Amazon-Preisfelder (price, business_price etc.) können initial weiter verwendet werden. Die übergebenen Preise werden in die neuen Amazon-Listings-Preisfelder eingetragen. •Als erster Grund zur Umstellung auf die neuen Felder ist die Tatsache, dass neue Preisfelder hinzugekommen sind, die entsprechend über die bisherigen Preisfelder nicht gesetzt werden können. •Die Weiterverwendbarkeit der alten Felder ist eine Übergangsphase. Der Plan ist, dass die alten Felder noch bis 2026 verwendet werden können. •Werden im Aufruf sowohl die alten als auch die neuen Felder übergeben, dann werden die Angaben aus den alten Feldern verwendet. |
Version |
Änderungsbeschreibung |
3.4.3.1 |
Einführung des Calls updatePrices in Amazon. |
4.12.8 |
Request um business_price erweitert. |
Request um neuen Block für Amazon Listings Daten (amazon_prices) erweitert. |