updatePricelist |
  
|
updatePricelist |
|
UpdatePricelist wird verwendet um Basispreislisten anzulegen und zu aktualisieren. |
<request method="updatePricelist" version="1.0.0"> <pricelist significant_key="identifier" reference_id="Pricelist-Ref-ID-1"> <mandator_id>2</mandator_id> <external_id>Externe ID der Preisliste</external_id> <identifier>Bezeichnung der Preisliste</identifier> <full_import>true</full_import> <iso_currency>EUR</iso_currency> <rounding_id>1</rounding_id> <gross>true</gross> <validities> <validity> <identifier>Weihnachtsrabatt</identifier> <valid_from>2016-12-23</valid_from> <valid_to>2016-12-26</valid_to> <prices> <entry item_nr="20161212-001" price="10.15"/> </prices> </validity> </validities> </pricelist> </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: „updatePricelist“ |
version |
Attribut von request. Legt die Version der Anfrage fest. |
1 |
integer |
Fester Wert: „1.0.0“ |
pricelist |
Wrapper-Element, das die Informationen zu einer Preisliste beinhaltet. |
1..N |
Element |
|
significant_key |
Gibt an welches Feld zur Identifikation der Preisliste bei einem Update genutzt wird. |
1 |
string |
Feste Werte: "identifier", "external_id" |
reference_id |
Optionales Attribut des Elements "pricelist". In diesem Feld kann eine beliebige ID angegeben werden die später im zugehörigen Report-Block der Response-Daten wieder ausgegeben wird. |
0..1 |
string |
|
mandator_id |
Mandanten ID |
1 |
integer |
|
external_id |
Externe ID der Preisliste. |
0..1 |
string |
|
identifier |
Bezeichnung der Preisliste. |
1 |
string |
|
full_import |
Mit diesem Flag wird definiert ob der Import überschreibend oder aktualisierend durchgeführt wird. |
1 |
boolean |
|
iso_currency |
Währung |
1 |
string |
|
rounding_id |
ID des Rundungsmodus |
1 |
integer |
Feste Werte. |
gross |
Flag das kennzeichnet ob es sich um eine Brutto- oder Nettopreisliste handelt. |
0..1 |
boolean |
true = Brutto (default) false = Netto |
validities |
Wrapper-Element, das die Gültigkeitszeiträume einer Preisliste zusammenfasst. |
1 |
Element |
|
validity |
Wrapper-Element, das einen Gültigkeitszeitraum einer Preisliste beinhaltet. |
1..N |
Element |
|
identifier |
Bezeichnung des Gültigkeitszeitraumes. |
0..1 |
string |
Siehe Hinweise. |
valid_from |
Startdatum des Gültigkeitszeitraumes im Format "yyyy-mm-dd". |
date |
Siehe Hinweise. |
|
valid_to |
Endedatum des Gültigkeitszeitraumes im Format "yyyy-mm-dd". |
date |
Siehe Hinweise. |
|
prices |
Wrapper-Element, das die Artikelpreise für einen Gültigkeitszeitraum zusammenfasst. |
1 |
Element |
|
entry |
Wrapper-Element, das den Artikelpreis beinhaltet. |
1..N |
Element |
|
item_nr |
Attribut von entry. Die interne Artikelnummer. |
1 |
string |
|
price |
Attribut von entry. Der Artikelpreis. |
1 |
decimal |
<response method="updatePricelist" version="1.0.0"> <report action="insert" return_code="0" reference_id="Pricelist-Ref-ID-1"> <pricelist> <mandator_id>2</mandator_id> <external_id>Bezeichnung der Preisliste</external_id> <identifier>Externe ID der Preisliste</identifier> <full_import>true</full_import> <iso_currency>EUR</iso_currency> <rounding_id>1</rounding_id> <gross>true</gross> <validities> <validity> <identifier>Weihnachtsrabatt</identifier> <valid_from>2016-12-23T00:00:00.000+01:00</valid_from> <valid_to>2016-12-26T23:59:59.000+01:00</valid_to> <prices_count>1</prices_count> <processed_prices>1</processed_prices> </validity> </validities> <prices_count>1</prices_count> <processed_prices>1</processed_prices> </pricelist> </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: „updatePricelist“ |
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..N |
Element |
|
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 pricelist-Block des Requests angegebene reference_id. |
0..1 |
string |
Siehe Hinweise. |
error_description |
Falls bei der Durchführung der Operation Fehler aufgetreten sind wird in error_description eine Fehlerbeschreibung zurück geliefert |
0..1 |
string |
|
pricelist |
Wrapper-Element, das die Informationen zu einer Preisliste beinhaltet. |
0..1 |
Element |
|
mandator_id |
ID des Mandanten. |
1 |
integer |
|
external_id |
Externe ID der Preisliste. |
0..1 |
string |
|
identifier |
Bezeichnung der Preisliste. |
1 |
string |
|
full_import |
Mit diesem Flag wird definiert ob der Import aktualisierend oder überschreibend durchgeführt wurde. |
1 |
boolean |
Siehe Hinweise. |
iso_currency |
Währung |
1 |
string |
|
rounding_id |
ID des verwendeten Rundungsmodus |
1 |
integer |
Feste Werte. |
gross |
Flag das kennzeichnet ob es sich um eine Brutto- oder Nettopreisliste handelt. |
1 |
boolean |
true = Brutto false = Netto |
validities |
Wrapper-Element, das die Gültigkeitszeiträume einer Preisliste zusammenfasst. |
1 |
Element |
|
validity |
Wrapper-Element, das einen Gültigkeitszeitraum einer Preisliste beinhaltet. |
1..N |
Element |
|
identifier |
Bezeichnung des Gültigkeitszeitraumes. |
1 |
string |
Default: "Standard" |
valid_from |
Startdatum des Gültigkeitszeitraumes. |
0..1 |
dateTime |
|
valid_to |
Endedatum des Gültigkeitszeitraumes. |
0..1 |
dateTime |
|
prices_count |
Anzahl der Preise in diesem Gültigkeitszeitraum. |
1 |
integer |
|
processed_prices |
Anzahl der Preise in diesem Gültigkeitszeitraum, die erfolgreich verarbeitet werden konnten. |
1 |
integer |
|
prices_count |
Anzahl der Preise in dieser Preisliste (kombinierter Wert aller Gültigkeitszeiträume). |
1 |
integer |
|
processed_prices |
Anzahl der Preise in dieser Preisliste, die erfolgreich verarbeitet werden konnten (kombinierter Wert aller Gültigkeitszeiträume). |
1 |
integer |
•Bei den Datumsfeldern des Gültigkeitszeitraumes ist nur der Tag zu übergeben. Die Start- und Ende-Uhrzeiten werden durch Speed4Trade CONNECT automatisch gesetzt. Beim Starttag handelt es sich dabei um die Uhrzeit 00:00:00.000, beim Endtag ist es 23:59:59.000. •Um Preise in den Standardgültigkeitszeitraum einzufügen lassen Sie die Felder 'identifier', 'valid_from' und 'valid_to' weg. Bei jedem weiteren Gültigkeitszeitraum sind die drei Felder zwingend nötig. •Das Flag 'full_import' bezieht sich auf die Preise der Gültigkeitszeiträume. Wird die Option 'true' gewählt so beinhalten alle durch den Request aktualisierten Gültigkeitszeiträume nur die zuletzt übergebenen Artikelpreise. Gültigkeitszeiträume die nicht übergeben werden, bleiben unverändert erhalten. •Die reference_id wird nicht in Speed4Trade CONNECT gespeichert und ist damit auch nicht fest an die betroffene Preisliste 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 order-Block aus den Request-Daten. •Ein Ändern der Datumsgrenzen von Gültigkeitszeiträumen ist aus technischen Gründen nicht möglich. In diesem Fall muss ein Gültigkeitszeitraum gelöscht und neu angelegt werden. |
Value Table - for Field: rounding_id. |
Value |
Description |
|---|---|
1 |
"rounded to 2 decimal figures": Commercial rounding (Default) |
2 |
"rounding to 0,99": (Sample: 18,49 € => 17,99 €; 18,50 € => 18,99 €.) |
Version |
Änderungsbeschreibung |
4.6.46 |
Integration des Calls updatePricelist. |