GetItemsPriceUpdate

The GetItemsPriceUpdate call returns the price sets for a list of items.

There are several possibilities for specifying which items have price sets that you want to retrieve.

The first option is to use the external item ID (ExternalItemID). However, there is no guarantee that you will only receive the price sets for one item. This is because the external item ID is not a unique number (i.e. it can appear in the system several different times).

The second option is to use the SKU. The SKU lets you specify whether you want to retrieve all of the price sets for a particular item or whether you only want to retrieve a certain price set for an item. If you want to receive all of the prices sets for an item, then you have to transmit 0 as the price ID (-0). If you want to receive a specific price set, then you have to transmit valid numbers for two parameters (item ID and price set ID).

It is not possible to retrieve data with a price set ID if you do not also use the corresponding item ID. You can use a combination of the SKU and the external item ID.

This call is available since SOAP version 110.
A maximum of 200 items can be edited per call.

GetItemsPriceUpdate Input

Field Type Occurrence Meaning Available since
CallItemsLimit Integer Optional Call items limit for own server 112
LastUpdateFrom Integer Optional 110
Page Integer Optional 110

GetItemsPriceUpdate Input schema

The box below lists all fields that could be included in the call request (version 112). To learn more about an individual field or its type, click its name in the box.

<PlentySoapRequest_GetItemsPriceUpdate>
<Page>Integer</Page>
</PlentySoapRequest_GetItemsPriceUpdate>

GetItemsPriceUpdate Output

Field Type Occurrence Meaning Available since
ItemsPriceUpdate ObjectOptional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Markup
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Price
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Price1
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Price10
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Price11
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Price12
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Price2
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Price3
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Price4
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Price5
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Price6
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Price7
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Price8
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
Price9
Double Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
PurchasePriceNet
Integer Optional 112
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
RRP
Double Optional 111
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
RebateLevelPrice10
Integer Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
RebateLevelPrice11
Integer Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
RebateLevelPrice6
Integer Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
RebateLevelPrice7
Integer Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
RebateLevelPrice8
Integer Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
RebateLevelPrice9
Integer Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
SKU
String Optional 110
ItemsPriceUpdate.
PlentySoapResponseObject_GetItemsPriceUpdate.
VAT
Double Optional 111
Pages Integer Optional 110
ResponseMessages ObjectOptional Returns a list of error messages for the current call. 112
ResponseMessages.
PlentySoapResponseMessage.
Code
Integer Optional Code 105
ResponseMessages.
PlentySoapResponseMessage.
ErrorMessages
ObjectOptional Sub Messages 110
ResponseMessages.
PlentySoapResponseMessage.
ErrorMessages.
PlentySoapResponseSubMessage.
Key
String Optional Key 109
ResponseMessages.
PlentySoapResponseMessage.
ErrorMessages.
PlentySoapResponseSubMessage.
Value
String Optional Value 109
ResponseMessages.
PlentySoapResponseMessage.
IdentificationKey
String Optional Message 110
ResponseMessages.
PlentySoapResponseMessage.
IdentificationValue
String Optional Message 110
ResponseMessages.
PlentySoapResponseMessage.
SuccessMessages
ObjectOptional Sub Messages 110
ResponseMessages.
PlentySoapResponseMessage.
SuccessMessages.
PlentySoapResponseSubMessage.
Key
String Optional Key 109
ResponseMessages.
PlentySoapResponseMessage.
SuccessMessages.
PlentySoapResponseSubMessage.
Value
String Optional Value 109
ResponseMessages.
PlentySoapResponseMessage.
Warnings
ObjectOptional Sub Messages 110
ResponseMessages.
PlentySoapResponseMessage.
Warnings.
PlentySoapResponseSubMessage.
Key
String Optional Key 109
ResponseMessages.
PlentySoapResponseMessage.
Warnings.
PlentySoapResponseSubMessage.
Value
String Optional Value 109
Success Boolean Optional Has the value true or false, depending on whether a request worked. 112

GetItemsPriceUpdate Output schema

The box below lists all fields that could be included in the response call (version 112). To learn more about an individual field or its type, click its name in the box.

<PlentySoapResponse_GetItemsPriceUpdate>
<Pages>Integer</Pages>
<Success>Boolean</Success>
</PlentySoapResponse_GetItemsPriceUpdate>

Identification Keys

For this call no identification keys and values exist.

Identification Output schema

For this call no identification output schema exists.

Success messages

(The dynamicValue stands for any parameter values that could be outputted.)

Code Key Value Message Explanation
100 - - - The price list was successfully returned.

Success Messages Output schema

For this call no success messages output schema exists.

Error messages

Code Key Value Message Explanation
800 Page Missing parameter Required parameter was not entered
800 LastUpdateForm Missing parameter Required parameter was not entered
800 Page Invalid parameter Required parameter was not entered

Error messages Output schema

The box below lists all error message fields that could be outputted in the call response (version 112). To learn more about an individual field or its type, click its name in the box.

<ErrorMessages>
<item>
<Value>Missing parameter</Value>
</item>
<item>
<Value>Missing parameter</Value>
<Key>LastUpdateForm</Key>
</item>
<item>
<Value>Invalid parameter</Value>
</item>
</ErrorMessages>

Warnings

Code Key Value Message Explanation
110 No data ItemID,PriceID,ExternalItemID No result was found for the item with the given item and price ID.

Warnings Output schema

The box below lists all warning fields that could be outputted in the call response (version 112). To learn more about an individual field or its type, click its name in the box.

Nach oben