AddItemAttribute

You can use the AddItemAttribute call to create or edit as many attributes as you want.

If you do not specify an attribute ID, then a new attribute will be created in the system. The attribute values will also be created and will be assigned to the attribute. If you specify an attribute ID, then this existing attribute will be edited. The same applies to the specified values. Not only can you use this call to create and edit attributes, but you can also use it to edit attribute values or add new attribute values to an attribute. You can not use this call to delete attribute values.

If no language is specified, then German will be used.

This call is available since SOAP version 102.
The following values for the view of attributes in webshop are available: Dropdown, Image, Box. The default value is Dropdown. The default value for attribute views will be used if an invalid value was entered.

AddItemAttribute Input

Field Type Occurrence Meaning Available since
Attributes ObjectOptional 105
Attributes.
PlentySoapObject_AddItemAttribute.
AmazonVariation
Integer Optional Amazon variation 105
Attributes.
PlentySoapObject_AddItemAttribute.
BackendName
String Optional Name in the system 105
Attributes.
PlentySoapObject_AddItemAttribute.
Contentpage
String Optional Content page 105
Attributes.
PlentySoapObject_AddItemAttribute.
FrontendLang
String Optional Language in the webshop (default setting: de) 105
Attributes.
PlentySoapObject_AddItemAttribute.
FrontendName
String Optional Name in the webshop 105
Attributes.
PlentySoapObject_AddItemAttribute.
GoogleProductsVariation
Integer Optional GoogleProducts variation 105
Attributes.
PlentySoapObject_AddItemAttribute.
Id
Integer Optional Attribute ID 105
Attributes.
PlentySoapObject_AddItemAttribute.
ImageAttribute
Boolean Optional Image link 105
Attributes.
PlentySoapObject_AddItemAttribute.
MarkupPercental
Double Optional Surcharge in percentage 105
Attributes.
PlentySoapObject_AddItemAttribute.
NeckermannAttribute
Integer Optional Neckermann attribute 105
Attributes.
PlentySoapObject_AddItemAttribute.
OttoVariation
Integer Optional Otto variation 105
Attributes.
PlentySoapObject_AddItemAttribute.
PixmaniaAttribute
Integer Optional Pixmania attribute 105
Attributes.
PlentySoapObject_AddItemAttribute.
Position
Integer Optional Position 105
Attributes.
PlentySoapObject_AddItemAttribute.
ShopperellaVariation
Integer Optional @see Read the manual page important notes / variation 105
Attributes.
PlentySoapObject_AddItemAttribute.
Values
ObjectOptional Attribut values 105
Attributes.
PlentySoapObject_AddItemAttribute.
Values.
PlentySoapObject_AddItemAttributeValue.
BackendName
String Optional Name in the system 105
Attributes.
PlentySoapObject_AddItemAttribute.
Values.
PlentySoapObject_AddItemAttributeValue.
Comment
String Optional Comment 105
Attributes.
PlentySoapObject_AddItemAttribute.
Values.
PlentySoapObject_AddItemAttributeValue.
FrontendName
String Optional Name in the webshop 105
Attributes.
PlentySoapObject_AddItemAttribute.
Values.
PlentySoapObject_AddItemAttributeValue.
Markup
Double Optional Surcharge 105
Attributes.
PlentySoapObject_AddItemAttribute.
Values.
PlentySoapObject_AddItemAttributeValue.
Position
Integer Optional Position 105
Attributes.
PlentySoapObject_AddItemAttribute.
Values.
PlentySoapObject_AddItemAttributeValue.
ValueId
Integer Optional Value id 105
Attributes.
PlentySoapObject_AddItemAttribute.
ViewWebshop
ObjectOptional The view of attributes in webshop 111
CallItemsLimit Integer Optional Call items limit for own server 112

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

AddItemAttribute 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

AddItemAttribute 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
BackendName 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 AttributeID dynamicValue BackendName Attribute was correctly created.
100 AttributeValueID dynamicValue BackendName AttributeValue was correctly created.

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>AttributeID</Key>
</item>
<item>
<Value>dynamicValue</Value>
<Key>AttributeValueID</Key>
</item>
</Success>

Error messages

Code Key Value Message Explanation
810 Limit 50 Too many data records The request has to many data records. Attend the defined limit.
800 could not save attribute An error occurred while creating the attribute.

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.

Warnings

For this call no warnings exist.

Warnings Output schema

For this call no warnings output schema exists.

Nach oben