updatePricelist |
  
|
updatePricelist |
|
Create and update pricelists. Pricelists can be assigned to accounts and accounts are assigned to trading channels in Speed4Trade CONNECT.
For additional Growth options see also the full updatePricelist call. |
<request method="updatePricelist" version="1.0.0"> <pricelist significant_key="identifier"> <mandator_id>2</mandator_id> <identifier>price list labeling</identifier><!-- Alternative 1 --> <!-- <external_id>external id of price list</external_id>--><!-- Alternative 2 --> <full_import>true</full_import> <iso_currency>EUR</iso_currency> <rounding_id>1</rounding_id> <gross>true</gross> <validities> <validity> <prices> <entry item_nr="201-1212-001" price="10.15"/> </prices> </validity> </validities> </pricelist> </request> |
Name |
Description |
Occ. |
Type |
Value Info |
request |
Root-Element of request. |
1 |
Element |
|
method |
Attribute of request. Name of Webservice-Method. |
1 |
string |
Fixed value: „updatePricelist“ |
version |
Attribute of request. Version of the request. |
1 |
integer |
Fixed value: „1.0.0“ |
pricelist |
Wrapper-Element, summarizing the data of a pricelist. |
1..N |
Element |
|
significant_key |
Selected identifier for pricelist updates. |
1 |
string |
Fixed value: "identifier", "external_id" |
mandator_id |
Client ID |
1 |
integer |
|
external_id |
Externe ID of pricelist. |
0..1 |
string |
|
identifier |
Unique pricelist identifier. |
1 |
string |
|
full_import |
Allows for full import (delete pricelist and import full) or just updating transmitted prices (update). |
1 |
boolean |
true = full import false = update |
iso_currency |
currency |
1 |
string |
|
rounding_id |
ID of rounding setting |
1 |
integer |
Fixed values. |
gross |
Flag to identify a pricelist as net/gross |
0..1 |
boolean |
true = gross (default) false = net |
validities |
Wrapper-Element, which contains the pricelist information for multiple time validities. |
1 |
Element |
|
validity |
Wrapper-Element, which contains the pricelist information just for the "infinite" validity. |
1..N |
Element |
For additional Growth options see also the full updatePricelist call. |
prices |
Wrapper-Element, which summarizes the price information for all items. |
1 |
Element |
|
entry |
Wrapper-Element, which contains the price. |
1..N |
Element |
|
item_nr |
Attribute of entry. The internal item number. |
1 |
string |
|
price |
Attribute of entry. The item price |
1 |
decimal |
<response method="updatePricelist" version="1.0.0"> <report return_code="<0"> <error_description>Detailed Error Description in the language of the mandator language setting</error_description> </report> </response> |
Name |
Description |
Occ. |
Type |
Value Info |
response |
Root-element of response |
1 |
Element |
|
method |
Attribute of response. Name of Webservice-Method. |
1 |
string |
fixed value: „updatePricelist“ |
version |
Attribute of response. Version control of request. |
1 |
string |
fixed value: „1.0.0“ |
report |
Information about executed operation. A report element is returned for each requested pricelist element. |
1..N |
Element |
|
return_code |
Attribute of report. Identifies error reason code. |
1 |
integer |
0 = OK. < 0 = error |
error_description |
Describes errors and error reasons of executed operation, once appeared. |
0..1 |
string |
For additional Growth options, especially using validities beyond the infinite validity, see also the full updatePricelist call. |
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 |
Change Description |
4.8.46 |
Introduction of a Basic "Simplified" Integration |