SetCurrentStocks

The SetCurrentStocks call sets the physical stock for the specified items. You have to specify a complete SKU in order to edit an amount of stock. You also have to specify the warehouse, storage location and new amount of stock.

The change in the amount of stock will be recorded as an item movement. For example, if the current stock is 13 and you use the SetCurrentStocks call to change the stock to 15, then an item movement of +2 will be recorded.

You can also specify a reason for changing the amount of stock. A list of reasons can be found here. If you do not specify a reason, then the reason 0 will be used by default.

This call is available since SOAP version 100.
At maximum, the stock of 100 different items/variants can be edited per call.

SetCurrentStocks Input

Field Type Occurrence Meaning Available since
CallItemsLimit Integer Optional Call items limit for own server 112
CurrentStocks ObjectRequired List of current stocks 105
CurrentStocks.
PlentySoapObject_SetCurrentStocks.
EAN
String Optional EAN 112
CurrentStocks.
PlentySoapObject_SetCurrentStocks.
EAN2
String Optional EAN 2 112
CurrentStocks.
PlentySoapObject_SetCurrentStocks.
EAN3
String Optional EAN3 112
CurrentStocks.
PlentySoapObject_SetCurrentStocks.
EAN4
String Optional EAN4 112
CurrentStocks.
PlentySoapObject_SetCurrentStocks.
PhysicalStock
String Required Physical stock 105
CurrentStocks.
PlentySoapObject_SetCurrentStocks.
Reason
Integer Optional Reason 105
CurrentStocks.
PlentySoapObject_SetCurrentStocks.
SKU
String Required SKU 105
CurrentStocks.
PlentySoapObject_SetCurrentStocks.
StorageLocation
Integer Required Storage location 105
CurrentStocks.
PlentySoapObject_SetCurrentStocks.
WarehouseID
Integer Required Warehouse ID 105

SetCurrentStocks 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_SetCurrentStocks> </PlentySoapRequest_SetCurrentStocks>

SetCurrentStocks Output

Field Type Occurrence Meaning Available since
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

SetCurrentStocks 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.

Identification Keys

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

Key Value
SKU dynamicValue

Identification Output schema

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

Success messages

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

Code Key Value Message Explanation
100 - - - Stock booked for SKU.

Success Messages Output schema

For this call no success messages output schema exists.

Error messages

Code Key Value Message Explanation
800 SKU Missing parameter Required parameter was not entered
800 WarehouseID Missing parameter Required parameter was not entered
800 StorageLocation Missing parameter Required parameter was not entered
800 PhysicalStock Missing parameter Required parameter was not entered
800 Reason Missing parameter Required parameter was not entered
800 EAN1-EAN4 Missing parameter Required parameter was not entered
800 SKU Invalid parameter The value of entered parameter is not allowed
810 Limit 250 Max items limit 250 The request contains more items than the maximum of 250 items
800 StorageLocation does not match to WarehouseID Current stocks could not be set. The given StorageLocation does not match to WarehouseID.

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>WarehouseID</Key>
</item>
<item>
<Value>Missing parameter</Value>
<Key>StorageLocation</Key>
</item>
<item>
<Value>Missing parameter</Value>
<Key>PhysicalStock</Key>
</item>
<item>
<Value>Missing parameter</Value>
<Key>Reason</Key>
</item>
<item>
<Value>Missing parameter</Value>
<Key>EAN1-EAN4</Key>
</item>
<item>
<Value>Invalid parameter</Value>
</item>
<item> </item>
</ErrorMessages>

Warnings

Code Key Value Message Explanation
110 No data No data found No items where found for the given EAN.

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