SetItemsCategories

You can use this call to assign a list of category links to a list of items. Furthermore, you can set the default category for your multishops.

This call is available since SOAP version 108.
A maximum of 100 item data records can be edited per call.

SetItemsCategories Input

Field Type Occurrence Meaning Available since
CallItemsLimit Integer Optional Call items limit for own server 112
ItemsList ObjectOptional Items List 108
ItemsList.
PlentySoapObject_SetItemsCategories.
Categories
ObjectOptional Categories 108
ItemsList.
PlentySoapObject_SetItemsCategories.
Categories.
PlentySoapObject_SetItemsCategoriesCategory.
CategoryPath
String Optional Category IDs, separated by semicolons 108
ItemsList.
PlentySoapObject_SetItemsCategories.
Categories.
PlentySoapObject_SetItemsCategoriesCategory.
DefaultCategory
Boolean Optional Default category 108
ItemsList.
PlentySoapObject_SetItemsCategories.
Categories.
PlentySoapObject_SetItemsCategoriesCategory.
StoreID
Integer Optional Multishop ID 110
ItemsList.
PlentySoapObject_SetItemsCategories.
ItemID
Integer Optional ItemID 108
ItemsList.
PlentySoapObject_SetItemsCategories.
RemoveCategories
Boolean Optional remove all existing categories 108

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

SetItemsCategories 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

SetItemsCategories 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
ItemID 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 CategoryPath dynamicValue - -

Success Messages Output schema

The box below lists all success messages 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.

<SuccessMessages>
<item>
<Value>dynamicValue</Value>
<Key>CategoryPath</Key>
</item>
</Success>

Error messages

Code Key Value Message Explanation
800 ItemID Missing parameter Required parameter was not entered
800 CategoryPath Missing parameter Required parameter was not entered
810 Limit 100 Max items limit 100 The request contains more items than the maximum of 100 items
800 This call is deprecated This call is deprecated, please use the Soap-Call SetItemsDefaultCategories(v.112)

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>
<Key>ItemID</Key>
</item>
<item>
<Value>Missing parameter</Value>
<Key>CategoryPath</Key>
</item>
<item> </item>
</ErrorMessages>

Warnings

For this call no warnings exist.

Warnings Output schema

For this call no warnings output schema exists.

Nach oben