updatePrices |
  
|
updatePrices |
|
Dient zum Aktualisieren von Artikelpreisen. |
<request method="updatePrices" version="1.0.0"> <item significant_key="internal_item_number" reference_id="ASDF123456"> <mandator_id>1</mandator_id> <internal_item_number>testartikel_123</internal_item_number> <list_price>19.95</list_price> <specific_item_data><!-- Platzhalter für plattformspezifische Daten --></specific_item_data> </item> </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: „updatePrices“ |
version |
Attribut von request. Legt die Version der Anfrage fest. |
1 |
integer |
Fester Wert: „1.0.0“ |
item |
Wrapper-Element, das die Preisdaten des Artikels zusammenfasst. |
0..N |
Element |
|
significant_key |
Gibt an welches Feld zur Identifikation des Artikels beim Update genutzt wird. |
1 |
string |
Feste Werte: „item_id“ | „internal_item_ number“ | "ean_code" |
reference_id |
Optionales Attribut des Elements "item". 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 |
|
item_id |
Artikel-ID |
1 |
integer |
|
mandator_id |
Mandanten-ID |
1 |
integer |
|
internal_item_number |
interne Artikelnummer |
0..1 |
string |
Länge: 0-50 Zeichen |
ean_code |
EAN-Code des Artikels |
0..1 |
string |
Länge: 0-30 Zeichen |
list_price |
Listenpreis |
0..1 |
decimal |
|
delivery_charge_category_id |
Versandkostenkategorie-ID |
0..1 |
integer |
|
external_delivery_charge_category_id |
Externe Versandkostenkategorie-ID |
0..1 |
string |
|
specific_item_data |
Wrapper-Element, das die plattformspezifischen Preisdaten zusammenfasst. |
0..1 |
Element |
<response method="updatePrices" version="1.0.0"> <report return_code="0" reference_id="ASDF123456"> <item> <item_id>123456</item_id> <mandator_id>1</mandator_id> <internal_item_number>testartikel_123</internal_item_number> <ean_code>123456789012</ean_code> </item> </report> </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: „updatePrices“ |
version |
Attribut von response. Legt die Version der Anfrage fest. |
1 |
integer |
Fester Wert: „1.0.0“ |
report |
Information über die ausgeführte Operation. Für jedes Category-Element aus dem Request wird ein Report zurückgegeben. |
0..N |
Element |
|
action |
Attribut von report. Gibt an welche Operation mit dem Datensatz durchgeführt wurde. |
1 |
string |
Feste Werte: update |
return_code |
Attribut von report. Gibt an ob in der durchgeführten Operation Fehler aufgetreten sind. |
1 |
integer |
0 = OK. < 0 = Fehler |
reference_id |
Optionales Attribut von report. Enthält die im zugehörigen item-Block des Requests angegebene reference_id falls diese angegeben wurde. |
0..1 |
string |
|
error_description |
Falls bei der Durchführung der Operation Fehler aufgetreten sind wird in error_description eine Fehlerbeschreibung zurück geliefert |
0..1 |
string |
|
item |
Wrapper-Element, das die Preisdaten der Artikel zusammenfasst |
1 |
Element |
|
item_id |
Artikel-ID |
1 |
integer |
|
mandator_id |
Mandanten-ID |
0..1 |
integer |
|
internal_item_number |
Interne Artikelnummer |
0..1 |
string |
Länge: 0-50 Zeichen |
ean_code |
EAN-Code des Artikels |
0..1 |
string |
Länge: 0-30 Zeichen |
•Die reference_id wird nicht in Speed4Trade CONNECT gespeichert und ist damit auch nicht fest an den betroffenen Artikel gebunden. Die selbe ID kann daher in unterschiedlichen Calls problemlos wiederverwendet werden. Sie dient lediglich zur schnellen Zuordnung eines Reports in den Response-Daten zu einem item-Block aus den Request-Daten. Dies ist insbesondere dann nützlich wenn es bei der Verarbeitung eines oder mehrerer der übergebenen Artikel zu Fehlern kommt und noch keine Artikel-IDs für eine Zuordnung vorhanden sind. So kann dennoch die Fehlermeldung zu einem Request-Bestandteil zugeordnet werden. |
Version |
Änderungsbeschreibung |
|---|---|
3.4.9.1 |
Integration des Calls updatePrices. |