SetCustomers

Use the call SetCustomers to change the entries of a certain customer data record.

This call is available since SOAP version 100.
The CustomerID has to be indicated. If a customer data record can not be altered, the error message will be returned according to the customer ID.
No more than 50 customers can be edited at the same time.

SetCustomers Input

Field Type Occurrence Meaning Available since
CallItemsLimit Integer Optional Call items limit for own server 112
Customers ObjectRequired List of customers 105
Customers.
PlentySoapObject_Customer.
AdditionalName
String Optional Additional name 105
Customers.
PlentySoapObject_Customer.
ArchiveNumber
Integer Optional Archive number 105
Customers.
PlentySoapObject_Customer.
BankData
ObjectOptional Bank data 105
Customers.
PlentySoapObject_Customer.
BankData.
PlentySoapObject_CustomerBankData.
Accountnumber
String Optional Account number 105
Customers.
PlentySoapObject_Customer.
BankData.
PlentySoapObject_CustomerBankData.
BIC
String Optional BIC 111
Customers.
PlentySoapObject_Customer.
BankData.
PlentySoapObject_CustomerBankData.
BankName
String Optional Bank name 105
Customers.
PlentySoapObject_Customer.
BankData.
PlentySoapObject_CustomerBankData.
Blz
String Optional Bank code 105
Customers.
PlentySoapObject_Customer.
BankData.
PlentySoapObject_CustomerBankData.
Date
Integer Optional Date 105
Customers.
PlentySoapObject_Customer.
BankData.
PlentySoapObject_CustomerBankData.
IBAN
String Optional IBAN 111
Customers.
PlentySoapObject_Customer.
BankData.
PlentySoapObject_CustomerBankData.
OwnerFirstname
String Optional Owner first name 105
Customers.
PlentySoapObject_Customer.
BankData.
PlentySoapObject_CustomerBankData.
OwnerName
String Optional Owner surname 105
Customers.
PlentySoapObject_Customer.
City
String Optional City 105
Customers.
PlentySoapObject_Customer.
Company
String Optional Company 105
Customers.
PlentySoapObject_Customer.
ContactPerson
String Optional Contact person 105
Customers.
PlentySoapObject_Customer.
CountryID
Integer Optional Country ID 105
Customers.
PlentySoapObject_Customer.
CountryISO2
String Optional Country code 105
Customers.
PlentySoapObject_Customer.
CustomerClass
Integer Optional Customer class 105
Customers.
PlentySoapObject_Customer.
CustomerID
Integer Optional Customer ID 105
Customers.
PlentySoapObject_Customer.
CustomerNumber
String Optional Customer number 105
Customers.
PlentySoapObject_Customer.
CustomerRating
Integer Optional Customer evaluation 105
Customers.
PlentySoapObject_Customer.
CustomerSince
Integer Optional Customer since 105
Customers.
PlentySoapObject_Customer.
DateOfBirth
Integer Optional Birthday 105
Customers.
PlentySoapObject_Customer.
DebitorAccount
String Optional Debtor account 105
Customers.
PlentySoapObject_Customer.
EbayName
String Optional eBay name 105
Customers.
PlentySoapObject_Customer.
Email
String Optional E-mail address 105
Customers.
PlentySoapObject_Customer.
Evaluation
String Optional Evaluation 105
Customers.
PlentySoapObject_Customer.
ExternalCustomerID
String Optional External customer ID 105
Customers.
PlentySoapObject_Customer.
FSK
Integer Optional Motion picture rating 105
Customers.
PlentySoapObject_Customer.
Fax
String Optional Fax number 105
Customers.
PlentySoapObject_Customer.
FirstName
String Optional First name 105
Customers.
PlentySoapObject_Customer.
FormOfAddress
Integer Optional Form of address 105
Customers.
PlentySoapObject_Customer.
FreeTextFields
ObjectOptional Free text fields 105
Customers.
PlentySoapObject_Customer.
FreeTextFields.
PlentySoapObject_CustomerFreeTestFields.
Free1
String Optional free text field 1 105
Customers.
PlentySoapObject_Customer.
FreeTextFields.
PlentySoapObject_CustomerFreeTestFields.
Free2
String Optional free text field 2 105
Customers.
PlentySoapObject_Customer.
FreeTextFields.
PlentySoapObject_CustomerFreeTestFields.
Free3
String Optional free text field 3 105
Customers.
PlentySoapObject_Customer.
FreeTextFields.
PlentySoapObject_CustomerFreeTestFields.
Free4
String Optional free text field 4 105
Customers.
PlentySoapObject_Customer.
FreeTextFields.
PlentySoapObject_CustomerFreeTestFields.
Free5
String Optional free text field 5 105
Customers.
PlentySoapObject_Customer.
FreeTextFields.
PlentySoapObject_CustomerFreeTestFields.
Free6
String Optional free text field 6 105
Customers.
PlentySoapObject_Customer.
FreeTextFields.
PlentySoapObject_CustomerFreeTestFields.
Free7
String Optional free text field 7 105
Customers.
PlentySoapObject_Customer.
FreeTextFields.
PlentySoapObject_CustomerFreeTestFields.
Free8
String Optional free text field 8 105
Customers.
PlentySoapObject_Customer.
HouseNo
String Optional House number 105
Customers.
PlentySoapObject_Customer.
IsBlocked
Boolean Optional Is the customer blocked 109
Customers.
PlentySoapObject_Customer.
Language
String Optional Language 105
Customers.
PlentySoapObject_Customer.
LastLogin
Integer Optional Last login 105
Customers.
PlentySoapObject_Customer.
LastSalesOrder
Integer Optional Last sales order 105
Customers.
PlentySoapObject_Customer.
LastSalesOrderCount
Integer Optional Last sales order count 105
Customers.
PlentySoapObject_Customer.
LastSalesOrderID
Integer Optional Last sales order ID 105
Customers.
PlentySoapObject_Customer.
Mobile
String Optional Cell phone number 105
Customers.
PlentySoapObject_Customer.
Newsletter
Integer Optional Newsletter 105
Customers.
PlentySoapObject_Customer.
PasswordMD5
String Optional PasswordMD5 110
Customers.
PlentySoapObject_Customer.
PasswordPlain
String Optional PasswordPlain 110
Customers.
PlentySoapObject_Customer.
PayDebitnode
Boolean Optional Pay debitnode 105
Customers.
PlentySoapObject_Customer.
PayInvoice
Boolean Optional Pay invoice 105
Customers.
PlentySoapObject_Customer.
PaymentDueWithin
Integer Optional Payment due within xxx days 105
Customers.
PlentySoapObject_Customer.
Postident
String Optional Post ident 109
Customers.
PlentySoapObject_Customer.
ResponsibleID
String Optional ID of the person responsible 105
Customers.
PlentySoapObject_Customer.
StoreID
Integer Optional Multishop ID 110
Customers.
PlentySoapObject_Customer.
Street
String Optional Street 105
Customers.
PlentySoapObject_Customer.
Surname
String Optional Surname 105
Customers.
PlentySoapObject_Customer.
Telephone
String Optional Telephone number 105
Customers.
PlentySoapObject_Customer.
Title
String Optional Title 105
Customers.
PlentySoapObject_Customer.
Type
Integer Optional Customer type 105
Customers.
PlentySoapObject_Customer.
Updated
Integer Optional Last update 105
Customers.
PlentySoapObject_Customer.
VAT_ID
String Optional VAT number 105
Customers.
PlentySoapObject_Customer.
ZIP
String Optional ZIP code 105

SetCustomers 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_SetCustomers>
<Customers>
<PlentySoapObject_Customer>
<City>String</City>
<Company>String</Company>
<CountryID>Integer</CountryID>
<EbayName>String</EbayName>
<Email>String</Email>
<FSK>Integer</FSK>
<Fax>String</Fax>
<HouseNo>String</HouseNo>
<IsBlocked>Boolean</IsBlocked>
<Language>String</Language>
<LastLogin>Integer</LastLogin>
<Mobile>String</Mobile>
<StoreID>Integer</StoreID>
<Street>String</Street>
<Surname>String</Surname>
<Title>String</Title>
<Type>Integer</Type>
<Updated>Integer</Updated>
<VAT_ID>String</VAT_ID>
<ZIP>String</ZIP>
</PlentySoapObject_Customer>
</Customers>
</PlentySoapRequest_SetCustomers>

SetCustomers 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

SetCustomers 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
CustomerNumber 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 - - - Customer was successfully altered. The customer ID is returned.

Success Messages Output schema

For this call no success messages output schema exists.

Error messages

Code Key Value Message Explanation
800 CustomerID Missing parameter Required parameter was not entered
800 Email Invalid parameter The value of entered parameter is not allowed
800 PasswordMD5 Invalid parameter The value of entered parameter is not allowed
810 Limit 50 Max items limit 50 The request contains more items than the maximum of 50 items.

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>CustomerID</Key>
</item>
<item>
<Value>Invalid parameter</Value>
</item>
<item>
<Value>Invalid parameter</Value>
<Key>PasswordMD5</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