fetchUploadMessages |
  
|
fetchUploadMessages |
|
Beim Einstellen von Angeboten kann es zu Meldungen seitens des Marktplatzes kommen die beschreiben warum das Einstellen des Angebotes fehlgeschlagen ist. Speed4Trade CONNECT speichert diese Meldungen für eine gewisse Zeit zwischen. Je nach Marktplatz sind diese Meldungen unterschiedlich umfangreich. Die Meldungen stellen nicht ausschließlich Fehler dar. Es sind auch Warnungs- oder Hinweismeldungen dabei, die Ihnen helfen können ihr Angebot weiter zu verbessern. Um diese Meldungen gezielt für einzelne Artikel abfragen zu können wurde dieser Request implementiert. |
<request method="fetchUploadMessages" version="1.0.0"> <filter> <mandator_id filter_method="=" filter_value="2"/> <item_id filter_method="=" filter_value="88325"/> <subchannel_id filter_method="=" filter_value="2100"/> <account_id filter_method="=" filter_value="82712"/> <offer_id filter_method="=" filter_value="88329"/> <order_id filter_method="=" filter_value="38091"/> <order_number filter_method="=" filter_value="52"/> <external_order_number_1 filter_method="=" filter_value="ext_ord_no_1"/> <external_order_number_2 filter_method="=" filter_value="ext_ord_no_2"/> <marketplace_order_id filter_method="=" filter_value="254-9874518-65723"/> <order_number_prefix filter_method="=" filter_value="Ama-A1-"/> </filter> </request> |
Name |
Beschreibung |
Anz. |
Typ |
Sonstiges |
request |
Root-Element der Anfrage |
1 |
Element |
|
method |
Attribut von request. Name der Webservice-Methode. |
1 |
string |
Fester Wert: „“ |
version |
Attribut von request. Legt die Version der Anfrage fest. |
1 |
integer |
Fester Wert: „1.0.0“ |
filter |
Legt Parameter fest nach denen die Ergebnismenge eingeschränkt wird. Mehrere Filter werden als ODER-Verknüpfung, Elemente innerhalb des Filters als UND-Verknüpfung behandelt. |
1..N |
Element |
|
mandator_id |
Schränkt die Ergebnismenge auf einen bestimmten Mandanten ein. |
1 |
Element |
|
filter_method |
Attribut von mandator_id. Legt das Verhalten des Mandanten-Filters fest. |
1 |
string |
Fester Wert: „=“ |
filter_value |
Attribut von mandator_id. Legt den Filterwert des Mandanten-Filters fest. |
1 |
integer |
|
item_id |
Schränkt die Ergebnismenge auf einen bestimmten Artikel ein. |
0..1 |
Element |
|
filter_method |
Attribut von item_id. Legt das Verhalten des Artikel-Filters fest. |
1 |
string |
Fester Wert: „=“ |
filter_value |
Attribut von item_id. Legt den Filterwert des Artikel-Filters fest. |
1 |
integer |
|
subchannel_id |
Schränkt die Ergebnismenge auf einen Subchannel ein. |
0..1 |
Element |
|
filter_method |
Attribut von subchannel_id. Legt das Verhalten des Subchannel-Filters fest. |
1 |
string |
Fester Wert: „=“ |
filter_value |
Attribut von subchannel_id. Legt den Filterwert des Subchannel-Filters fest. |
1 |
integer |
|
account_id |
Schränkt die Ergebnismenge auf einen Account ein. |
0..1 |
Element |
|
filter_method |
Attribut von account_id. Legt das Verhalten des Account-Filters fest. |
1 |
string |
Fester Wert: „=“ |
filter_value |
Attribut von account_id. Legt den Filterwert des Account-Filters fest. |
1 |
integer |
|
offer_id |
Schränkt die Ergebnismenge auf ein Angebot ein. |
0..1 |
Element |
|
filter_method |
Attribut von offer_id. Legt das Verhalten des Angebots-Filters fest. |
1 |
string |
Fester Wert: „=“ |
filter_value |
Attribut von offer_id. Legt den Filterwert des Angebots-Filters fest. |
1 |
integer |
|
order_id |
Schränkt die Ergebnismenge auf die Bestellung ein. |
|||
filter_method |
Attribut von order_id. Legt das Verhalten des Angebots-Filters fest. |
|||
filter_value |
Attribut von order_id. Legt den Filterwert des Angebots-Filters fest. |
|||
order_number |
Schränkt die Ergebnismenge auf die Bestellnummer ein. |
|||
filter_method |
Attribut von order_number. Legt das Verhalten des Angebots-Filters fest. |
|||
filter_value |
Attribut von order_number. Legt den Filterwert des Angebots-Filters fest. |
|||
external_order_number_1 |
Schränkt die Ergebnismenge auf die externe Auftragsnummer (1) ein. |
|||
filter_method |
Attribut von external_order_number_1. Legt das Verhalten des Angebots-Filters fest. |
|||
filter_value |
Attribut von external_order_number_1. Legt den Filterwert des Angebots-Filters fest. |
|||
external_order_number_2 |
Schränkt die Ergebnismenge auf die externe Auftragsnummer (2) ein. |
|||
filter_method |
Attribut von external_order_number_2. Legt das Verhalten des Angebots-Filters fest. |
|||
filter_value |
Attribut von external_order_number_2. Legt den Filterwert des Angebots-Filters fest. |
|||
marketplace_order_id |
Schränkt die Ergebnismenge auf die Bestell-ID des Marktplatz ein. |
Hinweise für eBay Aufträge |
||
filter_method |
Attribut von marketplace_order_id. Legt das Verhalten des Angebots-Filters fest. |
|||
filter_value |
Attribut von marketplace_order_id. Legt den Filterwert des Angebots-Filters fest. |
|||
order_number_prefix |
Schränkt die Ergebnismenge auf den Prefix der Bestellnummer ein. |
|||
filter_method |
Attribut von order_number_prefix. Legt das Verhalten des Angebots-Filters fest. |
|||
filter_value |
Attribut von order_number_prefix. Legt den Filterwert des Angebots-Filters fest. |
<response method="fetchUploadMessages" version="1.0.0"> <report return_code="0"/> <upload_message> <upload_message_id>10</upload_message_id> <offer_id>88271</offer_id> <item_id>88270</item_id> <account_id>12</account_id> <subchannel_id>2100</subchannel_id> <order_id>2053944</order_id> <translation_message_id>3</translation_message_id> <translation_message> <message_code>21916626</message_code> <plugin_id>2000</plugin_id> <severity>1</severity> <multilingual_data> <translation> <language_code_iso>de</language_code_iso> <message>Marktplatzmeldung_de</message> </translation> <translation> <language_code_iso>en</language_code_iso> <message>Marketplace Message_en</message> </translation> <translation> <language_code_iso>fr</language_code_iso> <message>message du marché</message> </translation> </multilingual_data> </translation_message> <date>2015-11-17T15:38:52.637+01:00</date> <original_message_code>21916626</original_message_code> <original_message>Original_Message</original_message> <original_severity>1</original_severity> </upload_message> </response> |
Name |
Beschreibung |
Anz. |
Typ |
Sonstiges |
response |
Root-Element der Antwort |
1 |
Element |
|
method |
Attribut von response. Name der Webservice-Methode. |
1 |
string |
Fester Wert: „“ |
version |
Attribut von response. Legt die Version der Anfrage fest. |
1 |
string |
Fester Wert: „1.0.0“ |
report |
Information über die ausgeführte Operation. |
1 |
Element |
|
return_code |
Attribut von report. Gibt an ob in der durchgeführten Operation Fehler aufgetreten sind. |
1 |
integer |
0 = OK. < 0 = Fehler |
error_description |
Falls bei der Durchführung der Operation Fehler aufgetreten sind wird in error_description eine Fehlerbeschreibung zurück geliefert |
1 |
string |
|
upload_message |
Wrapper-Element, das die Informationen einer Upload-Message zusammenfasst. |
0..N |
Element |
|
upload_message_id |
ID der Upload-Message. |
1 |
integer |
|
offer_id |
ID des Angebotes. |
0..1 |
integer |
|
item_id |
ID des Artikels. |
1 |
integer |
|
account_id |
ID des Accounts. |
0..1 |
integer |
|
subchannel_id |
ID des Subchannels. |
0..1 |
integer |
Siehe Wertetabelle. |
order_id |
ID des Auftrages. |
0..1 |
integer |
|
translation_message_id |
ID der Übersetzung. |
0..1 |
integer |
|
translation_message |
Übersetzte Version des Meldungstextes. |
0..1 |
Element |
|
message_code |
ID des Marktplatzes zur Meldung. |
1 |
string |
|
plugin_id |
ID des Channels. |
1 |
integer |
|
severity |
Definiert den Schweregrad der Meldung. |
1 |
integer |
Feste Werte: "0" = Fehler; "1" = Warnung |
multilingual_data |
Wrapper-Element, das die Übersetzungen der Upload-Messages zusammenfasst. |
0..1 |
Element |
|
translation |
Wrapper-Element, das die Übersetzung der Upload-Message zu einer Sprache beinhaltet. |
1..N |
Element |
|
language_code_iso |
Gibt die Sprache in diesem Element an. |
1 |
string |
Sprachcode ISO 639-1 ALPHA-2 (z.B. „de“) Siehe Wertetabelle. |
message |
Upload-Message in der angegebenen Sprache. |
1 |
string |
|
date |
Datum und Uhrzeit an dem die Meldung aufgetreten ist. |
1 |
dateTime |
|
original_message_code |
Ursprüngliche ID des Marktplatzes zur Meldung. |
0..1 |
string |
|
original_message |
Ursprüngliche Nachricht des Marktplatzes. |
0..1 |
string |
|
original_severity |
Ursprünglicher Schweregrad der Meldung. |
0..1 |
integer |
•Nicht zu jeder Marktplatzmeldung sind Übersetzungen vorhanden. Meist wird die Meldung des Marktplatzes unverändert durchgereicht. •Welche ID im Response zurückkommt hängt davon ab mit was die UploadMessage verknüpft ist. Bei Meldungen zu Aufträgen (z.B.: Bei Verwendung von Amazon Sellerfulfilled-Prime) wird die Auftrags-ID mit ausgegeben. Bei Meldungen zu Angeboten die neu eingestellt werden sollen und fehlgeschlagen sind wird die Account-ID, Item-Id und Subchannel-Id mit ausgegeben usw. Immer in Abhängigkeit davon welche Informationen verfügbar sind. •Verwenden Sie marketplace_order_id nicht als significant_key für eBay Aufträge, da diese Felder bei eBay ihre Werte nach Abschluss des Bestellvorgangs ändern und somit keine eindeutige Zuordnung mehr möglich ist. |
Value Table - for Field: language_code_iso. |
Value |
Description |
|---|---|
de |
German |
en |
English |
fr |
French |
... |
Value Table - for Field sub_channel_id |
sub_channel_id |
sub_channel_identifier |
channel_identifier |
|---|---|---|
1001 |
Speed4Trade COMMERCE |
Onlineshops |
1100 |
modified Shop |
Onlineshops |
1400 |
Gambio |
Onlineshops |
1500 |
Shopgate |
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 |
5100 |
Allyouneed.de (Deprecated) |
Allyouneed (Deprecated) |
6100 |
Yatego |
Yatego |
7100 |
Rakuten.de (Deprecated) |
Rakuten (Deprecated) |
9100 |
DAPARTO.de |
DAPARTO |
10100 |
otto.de |
OTTO |
10200 |
otto.at |
OTTO |
10300 |
otto.ch |
OTTO |
10400 |
otto.nl |
OTTO |
10500 |
otto.ru |
OTTO |
11100 |
Locafox.de (Deprecated) |
Locafox (Deprecated) |
12100 |
WEBSALE (Deprecated) |
WEBSALE (Deprecated) |
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. |
Version |
Änderungsbeschreibung |
3.5.47 |
Initiale Erstellung des Calls. |
4.6.40 |
Erweitern des Requests und Response um Auftrag spezifische Informationen. |
4.8.2 |
Wertetabelle für Subchannels eingefügt. |
4.9.28 |
Neuer Hinweistext zu marketplace_order_id bei eBay Aufträgen. |