WebService Calls > Options for Growth

Beschreibung

Löscht vorbereitete und beendete Angebote aller Verkaufsplattformen.

Beispiel Request

Feldliste 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: „deleteOffers“
version	Attribut von request. Legt die Version der Anfrage fest.	1	integer	Fester Wert: „1.0.0“
process_synchronous	Legt fest ob der Call synchron oder asynchron durchgeführt wird. Weitere Informationen finden sich im Abschnitt "Hinweise". Falls das Element nicht mit angegeben wird, erfolgt eine asynchrone Verarbeitung.	0..1	boolean	Feste Werte: true \| false
offers	Wrapper-Element, das die zu verarbeitenden Angebots-Ids zusammenfasst.	1	Element
offer_id	ID des Angebots, das gelöscht werden soll.	1..N	integer

Beispiel Response

Code

Feldliste 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: „deleteOffers“
version	Attribut von response. Legt die Version der Anfrage fest.	1	string	Fester Wert: „1.0.0“
report	Information über die ausgeführte Operation.	0 - N	Element
return_code	Attribut von report. Gibt an ob in der durchgeführten Operation Fehler aufgetreten sind.	1	integer	Feste Werte: Siehe Wertetabelle
error_description	Enthält im Fehlerfall eine Beschreibung weshalb das Wiedereinstellen des Angebots nicht möglich war.	0..1	String
offer_id	ID des Angebots, zu dem dieser Report gehört.	1	integer
overall_report	Element, welches ausschließlich im Response enthalten ist wenn ein Fehler auftritt der nicht direkt zu einem einzelnen Angebot zugeordnet werden kann.	0..1	Element
return_code	Attribut von overall_report. Enthält den Fehlercode -1, da beim Auftreten des overall_report in jedem Fall ein unspezifizierter Fehler aufgetreten ist.	1	integer	Fester Wert: -1
error_description	Enthält eine Fehlerbeschreibung.	1	String

Hinweise

•Bei einer synchronen Verarbeitung des Calls wird auf die Ergebnisse gewartet, und der Erfolg oder Miserfolg der Operationen im Response zurückgegeben. Dies kann jedoch insbesondere durch die Kommunikation mit verschiedenen Plattformen (z.B. eBay) viel Zeit in Anspruch nehmen. Daher kann der Call auch asynchron durchgeführt werden. Hier werden nur offensichtlich unmögliche Eingaben moniert, wenn z. B. kein Angebot zu einer Id existiert oder sich dieses nicht im Zustand "Beendet" befindet. Der Erfolg der weiteren Operationen muss separat per fetchOffers abgeprüft werden.

•Bei der synchronen Verarbeitung tritt ein Timeout auf wenn der Call nicht innerhalb von 3 Minuten abgearbeitet werden kann. Die zum Zeitpunkt des Timeouts vorhandenen Ergebnisse werden zurückgegeben und der Call läuft asynchron weiter. Es empfiehlt sich daher bei synchroner Verarbeitung maximal 100 Angebote pro Call zu löschen.

•Bei Angeboten mit Varianten genügt es die ID des Hauptangebotes zu übergeben. Die zugehörigen Variantenangebote werden automatisch mit gelöscht.

Wertetabelle(n)

Return-Codes

Für den Webservice-Call "deleteOffers" sind folgende Return-Codes möglich:

Code	Beschreibung
0	Das Angebot mit der zugehörigen Angebots-Id wurde erfolgreich gelöscht.
-1	Das Angebot konnte auf Grund eines unspezifizierten Fehlers nicht gelöscht werden. Bitte beachten Sie die mitgelieferte Fehlerbeschreibung.
-2	Das Angebot konnte auf Grund eines internen Fehlers nicht gelöscht werden. Bitte beachten Sie die mitgelieferte Fehlerbeschreibung.
-10001	Es existiert kein Angebot mit dern angegebenen Angebots-Id
-10002	Das Angebot mit der übergebenen Id befindet sich nicht in den Status "Vorbereitet" oder "Beendet" und kann deshalb nicht gelöscht werden.

Änderungsübersicht

Version	Änderungsbeschreibung
3.2.11.46	Einführung des Calls.
4.7.15	Bei Variantenangeboten genügt es nun die ID des Hauptangebotes zu übergeben.