WebService Calls > Options for Growth > sendMessages > Plattformspezifische Daten

Beschreibung

Die XML-Struktur, welche die Daten der Nachrichten für die Plattform eBay enthält, ist als Kindelement in den Request-Daten von sendMessages eingebettet. Sie besitzt folgende Struktur:

Beispiel Request

Code

Feldliste Request

Name	Beschreibung	Anz.	Typ	sonstiges
ebay_message	Wrapper-Element, das die spezifischen Daten einer Nachricht für die Plattform eBay zusammenfasst.	0..N	Element
reference_id	Optionales Attribut des Elements "ebay_message". In diesem Feld kann eine beliebige ID angegeben werden die später im zugehörigen Report-Block der Response-Daten wieder erscheint.	0..1	string
account_id	ID des eBay-Accounts.	1	integer
recipient_id	eBay-Name des Empfägners.	1	string
body	Nachrichtentext	1	string
ebay_item_id	eBay-Artikelnummer. Die eBay-Artikelnummer muss gesetzt werden, wenn es sich um eine AaqToBidder oder AaqToPartner Nachricht handelt.	0..1	string
email_copy_to_sender	Gibt an, ob die Nachricht als Kopie an den Absender geschickt werden soll.	0..1	boolean
parent_message_id	Eltern-ID der eBay-Nachricht. Die Eltern-ID muss gesetzt werden wenn es sich um Rtq Nachricht handelt	0..1	string	Hinweis
subject	Betreff der Nachricht. Der Betreff muss gesetzt werden, wenn es sich um eine AaqToPartner Nachricht handelt.	0..1	string	Hinweis
message_question_type	Fragetyp der Nachricht. Der Fragetyp muss gesetzt werden, wenn es sich um eine AaqToPartner Nachricht handelt.	0..1	string	Werte Hinweis

Beispiel Response

Code

Feldliste Response

Name	Beschreibung	Anz.	Typ
ebay_message	Wrapper-Element, das die spezifischen Daten einer Nachricht für die Plattform eBay zusammenfasst.	0..N	Element
account	Wrapper-Element, das die Daten des Accounts zusammenfasst.	1	Element
account_id	Element von account. ID des Accounts	1	integer
account_identifier	Element von account. Bezeichnung des Accounts	1	string
recipient_id	eBay-Name des Empfägners.	1	string
ebay_item_id	eBay-Artikelnummer. Die eBay-Artikelnummer ist gesetzt, wenn es sich um eine AaqToBidder oder AaqToPartner Nachricht handelt.	0..1	string

Hinweise

•Die reference_id wird nicht in Speed4Trade CONNECT gespeichert und ist damit auch nicht fest an die betroffene Nachricht gebunden. Die gleiche ID kann daher in unterschiedlichen Calls problemlos wiederverwendet werden. Sie dient lediglich zur schnellen Zuordnung eines Reports in den Response-Daten zu einem Block aus den Request-Daten. Dies ist insbesondere dann nützlich wenn es bei der Verarbeitung eines oder mehrerer der übergebenen Nachrichten zu Fehlern kommt. So kann die resultierende Fehlermeldung schnell zu einem Request-Bestandteil zugeordnet werden.

•Da eBay intern mehrere API-Calls anbietet um unterschiedliche Nachrichten zu verschicken, wird durch das Setzen von bestimmten Feldern dieses Calls festgelegt, welche Art von Nachricht verschickt wird. Kann ein Call dadurch nicht eindeutig bestimmt werden, schlägt das Senden der Nachricht fehl.

Call-Typ	Beschreibung
AaqToBidder	Call-Typ für eine Nachricht bei einer Verkäufer-Bieter/Interessent-Beziehung bezogen auf ein laufendes Angebot. Soll dieser Nachrichten-Call genutzt werden, müssen die Felder parent_message_id, subject und message_question_type weggelassen werden.
Rtq	Call-Typ, der dazu dient, einem Kaufinteressenten, der eine Frage gestellt hat, zu antworten. Soll dieser Nachrichten-Call genutzt werden, muss das Feld parent_message_id angegeben und die Felder subject und message_question_type weggelassen werden.
AaqToPartner	Call-Typ für eine Nachricht bei einer Verkäufer-Käufer-Beziehung unabhängig ob das Angebot weiterhin aktiv ist (Nachricht kann innerhalb von 90 Tagen nach zustande kommen des Verkaufs an den Käufer gesendet werden). Soll dieser Nachrichten-Call genutzt werden, muss das Feld parent_message_id weggelassen und die Felder subject und message_question_type angegeben werden.

Call-Typ

Beschreibung

AaqToBidder

Call-Typ für eine Nachricht bei einer Verkäufer-Bieter/Interessent-Beziehung bezogen auf ein laufendes Angebot.

Soll dieser Nachrichten-Call genutzt werden, müssen die Felder parent_message_id, subject und message_question_type weggelassen werden.

Rtq

Call-Typ, der dazu dient, einem Kaufinteressenten, der eine Frage gestellt hat, zu antworten.

Soll dieser Nachrichten-Call genutzt werden, muss das Feld parent_message_id angegeben und die Felder subject und message_question_type weggelassen werden.

AaqToPartner

Call-Typ für eine Nachricht bei einer Verkäufer-Käufer-Beziehung unabhängig ob das Angebot weiterhin aktiv ist (Nachricht kann innerhalb von 90 Tagen nach zustande kommen des Verkaufs an den Käufer gesendet werden).

Soll dieser Nachrichten-Call genutzt werden, muss das Feld parent_message_id weggelassen und die Felder subject und message_question_type angegeben werden.

Return-Codes

Für eBay-Nachrichten sind zusätzlich noch folgende Return-Codes möglich:

Code	Beschreibung
-4	Fehler beim Validieren der Daten. Eventuell sind Pflichtfelder nicht gesetzt.
-5	Zugriff verweigert. Es besteht kein Zugriff auf die ausgewählten Daten.
-10001	Der Call-Typ konnte nicht eindeutig identifiziert werden. Siehe Hinweis.
-10002	Interner Fehler von eBay. Kann Beispielsweise entstehen, wenn der Empfängername nicht korrekt ist. Genauere Information stehen in dem Feld error_description.

Wertetabelle(n)

Aufgeführte Werte gelten für das Feld message_question_type

Wert	Beschreibung
CustomizedSubject	Benutzerdefiniert Betreff
General	Allgemeine Frage über den Artikel.
MultipleItemShipping	Frage über eine Zusammenfassung von mehreren Artikeln für den Versand.
None	Es wurde kein Fragetyp angegeben.
Payment	Frage zur Zahlung eines Artikels.
Shipping	Frage zum Versand eines Artikels.

Änderungsübersicht

Version	Änderungsbeschreibung
3.4.9.1	Integration des Calls sendMessages zum Anlegen von Nachrichten

Spezifische Daten der Verkaufsplattform eBay

Spezifische Daten der Verkaufsplattform eBay