relistOffers

Navigation:  WebService Calls > Options for Growth >

relistOffers

 Previous pageReturn to chapter overviewNext page

Texte ein-/ausblenden

Beschreibung

Ermöglicht die Wiedereinstellung von bereits beendeten Angeboten der untertützten Verkaufsplattformen.

Beispiel Request

Code

<request method="relistOffers" version="1.0.0">

   <process_synchronous>true</process_synchronous>

   <offers>

      <offer_id>2735702</offer_id>

      <offer_id>2735701</offer_id>

      <offer_id>2221111</offer_id>

      <offer_id>2735706</offer_id>

      <offer_id>2735587</offer_id>

   </offers>

</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:

„relistOffers“

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 wiedereingestellt werden soll.

1..N

integer

Beispiel Response

Code

<response method="relistOffers" version="1.0.0">

    <report return_code="0">

        <offer_id>2735702</offer_id>

    </report>

    <report return_code="0">

        <offer_id>2735701</offer_id>

    </report>    

    <report return_code="-10001">

        <error_description>Es konnte kein Angebot zur angegebenen 

                            Angebots-Id 2221111 gefunden werden.

        </error_description>

        <offer_id>2221111</offer_id>

    </report>

    <report return_code="-10002">

        <error_description>Das Angebot mit der angegebenen Angebots-Id 2735706 befindet sich nicht im 

                   Angebotsstatus "Beendet" und kann daher nicht neu eingestellt werden. 

        </error_description>

        <offer_id>2735706</offer_id>

    </report>

    <report return_code="-10003">

        <error_description>ResponseMessage [Ungültiger Wert für EAN. ]</error_description>

        <offer_id>2735587</offer_id>

    </report>

    <!-- 

    <overall_report return_code="-1">

        <error_description>Fehler bei der Plugin-Spezifischen Verarbeitung des "relistOffers"-Webservice-Calls 

            im Plug-In eBay.

        </error_description>

    </overall_report>

    -->

</response>

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:

„relistOffers“

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 Misserfolg 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 50 Angebote pro Call wiedereinzustellen.

Wertetabelle(n)

Return-Codes

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

Code

Beschreibung

0

Das Angebot mit der zugehörigen Angebots-Id wurde erfolgreich wiedereingestellt.

-1

Das Angebot konnte auf Grund eines unspezifizierten Fehlers nicht wiedereingestellt werden. Bitte beachten Sie die mitgelieferte Fehlerbeschreibung.

-2

Das Angebot konnte auf Grund eines internen Fehlers nicht wiedereingestellt 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 im Status "Beendet" und kann deshalb nicht wiedereingestellt werden.

-10003

Das Angebot konnte auf Grund eines plattformspezifischen Problems nicht wiedereingestellt werden. Bitte beachten Sie die mitgelieferte Fehlerbeschreibung.

Unterstützte Verkaufsplattformen

Version

Änderungsbeschreibung

3.2.11.46

•eBay

Änderungsübersicht

Version

Änderungsbeschreibung

3.2.11.46

Einführung des Calls für Angebote der Verkaufsplattform eBay.