» Create Customer

METHODS

Create Customer

This method creates a customer. The client makes a POST request providing Request body in either xml or json format and input parameter LangID in the request url. The output will be either in json or xml format depending on the request type. New Customer’s object is returned.

Please note that CustomerField node has “CustomerFieldValues” node only when CustomerFieldType is “ComboBox” or “ListBox”.

Name	Value
REST-API METHOD	CREATE CUSTOMER
HTTP METHOD	POST
RESPONSE TYPE	XML
URL	https://api.csm.next4biz.net/services/CustomerService/{CompanyID}/SaveCustomer.json/{LangID}	https://api.csm.next4biz.net/services/CustomerService/{CompanyID}/SaveCustomer.xml/{LangID}
REQUEST HEAD	Authorization: Basic {base64 encoded username:password} Accept: text/html,application/xhtml+json,application/json;q=0.9,/;q=0.8 Content-Type: application/json	Authorization: Basic {base64 encoded username:password} Accept: text/html,application/xhtml+xml,application/xml;q=0.9,/;q=0.8 Content-Type: application/xml

XML
JSON

ENDPOINT DEFINITION

POST

REQUEST BODY

                                    
                                        <Customer>
	<CustomerCode>{CustomerCode}</CustomerCode>
	<CustomerEmail>{CustomerEmailAddress}</CustomerEmail>
	<CustomerHomePhoneNumber>{CustomerHomePhone}</CustomerHomePhoneNumber>
	<CustomerMobilePhoneNumber>{MobilePhone}</CustomerMobilePhoneNumber>
	<CustomerName>{CustomerName}</CustomerName>
	<CustomerSurname>{CustomerSurname}</CustomerSurname>
	<CustomerPassword>{CustomerPassword}</CustomerPassword>
	<CustomerWorkPhoneNumber>{CustomerWorkPhone}</CustomerWorkPhoneNumber>
	<CustomerBusinessChannelID>{BusinessChannelID}</CustomerBusinessChannelID>
	<CustomerUnitID>{CustomerUnit}</CustomerUnitID>
	<CustomerDefaultLangID>{CustomerDefaultLangID}</CustomerDefaultLangID>
	<CustomerGroups>
		<CustomerGroup>
			<GroupID>{GroupID}</GroupID>
		</CustomerGroup>
	</CustomerGroups>
	<CustomerFields>
		<CustomerField>
			<CustomerFieldID>{CustomerFieldID}</CustomerFieldID>
			<CustomerFieldValues>
				<CustomerFieldReferenceValue CustomerFieldReferenceValueID="{ID}" />
			</CustomerFieldValues>
		</CustomerField>
		<CustomerField>
			<CustomerFieldID>{CustomerFieldID}</CustomerFieldID>
			<CustomerFieldValue>{CustomerFieldValue}</CustomerFieldValue>
		</CustomerField>
	</CustomerFields>
</Customer>

                                                                         
                                        {
    "CustomerCode": "{CustomerCode}",
    "CustomerEmail": "{CustomerEmailAddress}",
    "CustomerHomePhoneNumber": "{CustomerHomePhone}",
    "CustomerMobilePhoneNumber": "{MobilePhone}",
    "CustomerName": "{CustomerName}",
    "CustomerSurname": "{CustomerSurname}",
    "CustomerPassword": "{CustomerPassword}",
    "CustomerWorkPhoneNumber": "{CustomerWorkPhone}",
    "CustomerBusinessChannelID": "{BusinessChannelID}",
    "CustomerUnitID": "{CustomerUnit}",
    "CustomerDefaultLangID": "{CustomerDefaultLangID}",
    "CustomerGroups": {
        "CustomerGroup": {
            "GroupID": "{GroupID}"
        }
    },
    "CustomerFields":  [
            {
                "CustomerFieldID": "{CustomerFieldID}",
                "CustomerFieldValues": [ 
                    {
                        "CustomerFieldReferenceValueID": "{ID}"
                    }
                ]
            },
            {
                "CustomerFieldID": "{CustomerFieldID}",
                "CustomerFieldValue": "{CustomerFieldValue}"
            }
        ]
}

RESPONSE BODY

                                    
                                        <Customer>
	<CustomerCode>{CustomerCode}</CustomerCode>
	<CustomerEmail>{CustomerEmailAddress}</CustomerEmail>
	<CustomerHomePhoneNumber>{CustomerHomePhone}</CustomerHomePhoneNumber>
	<CustomerMobilePhoneNumber>{MobilePhone}</CustomerMobilePhoneNumber>
	<CustomerName>{CustomerName}</CustomerName>
	<CustomerSurname>{CustomerSurname}</CustomerSurname>
	<CustomerPassword>{CustomerPassword}</CustomerPassword>
	<CustomerWorkPhoneNumber>{CustomerWorkPhone}</CustomerWorkPhoneNumber>
	<CustomerBusinessChannelID>{BusinessChannelID}</CustomerBusinessChannelID>
	<CustomerUnitID>{CustomerUnit}</CustomerUnitID>
	<CustomerDefaultLangID>{CustomerDefaultLangID}</CustomerDefaultLangID>
	<CustomerGroups>
		<CustomerGroup>
			<GroupID>{GroupID}</GroupID>
		</CustomerGroup>
	</CustomerGroups>
	<CustomerFields>
		<CustomerField>
			<CustomerFieldID>{CustomerFieldID}</CustomerFieldID>
			<CustomerFieldValues>
				<CustomerFieldReferenceValue CustomerFieldReferenceValueID="{ID}" />
			</CustomerFieldValues>
		</CustomerField>
		<CustomerField>
			<CustomerFieldID>{CustomerFieldID}</CustomerFieldID>
			<CustomerFieldValue>{CustomerFieldValue}</CustomerFieldValue>
		</CustomerField>
	</CustomerFields>
	<CustomerUserID>{CustomerUserID}</CustomerUserID>
</Customer>

                                                                        
                                        {
    "CustomerCode": "{CustomerCode}",
    "CustomerEmail": "{CustomerEmailAddress}",
    "CustomerHomePhoneNumber": "{CustomerHomePhone}",
    "CustomerMobilePhoneNumber": "{MobilePhone}",
    "CustomerName": "{CustomerName}",
    "CustomerSurname": "{CustomerSurname}",
    "CustomerPassword": "{CustomerPassword}",
    "CustomerWorkPhoneNumber": "{CustomerWorkPhone}",
    "CustomerBusinessChannelID": "{BusinessChannelID}",
    "CustomerUnitID": "{CustomerUnit}",
    "CustomerDefaultLangID": "{CustomerDefaultLangID}",
    "CustomerGroups": {
        "CustomerGroup": {
            "GroupID": "{GroupID}"
        }
    },
    "CustomerFields": {
        "CustomerField": [
            {
                "CustomerFieldID": "{CustomerFieldID}",
                "CustomerFieldValues": {
                    "CustomerFieldReferenceValue": {
                        "CustomerFieldReferenceValueID": "{ID}"
                    }
                }
            },
            {
                "CustomerFieldID": "{CustomerFieldID}",
                "CustomerFieldValue": "{CustomerFieldValue}"
            }
        ]
    },
    "CustomerUserID": "{CustomerUserID}"
}