When a user registers, a new customer/address/user is directly created in CloudSuite. Depending on the userrole the user immediately order products.

The keys for the data are:

Data	Key

Data	Key
customer	Predefined formated number with an optional prefix ( e.g. BK12345 ) generated by CloudSuite
address	Generated UUID ( e.g. 8eb9cbc3-7f5c-4f14-9045-f978d72a7d7d ) by CloudSuite
user	generated UUID ( e.g. b3ea7d82-d1e1-420c-bd41-cabc1d9d20c9 ) by CloudSuite

You can get the customer/address/user in two different ways:

The customer/address/user data is sent as part of the cXML order data.
All customer/address/user data can be fetched from the CloudSuite API.

There is no trigger or outgoing API call that pushes customer/address/user data to an external system like ERP.

1. Getting customer data into the ERP system

When placing an order in the webshop, the user/address/customer information is included in the order cXML in the Billto and the Contact block.

BillTo:

Extra info:

<Extrinsic name="CloudsuiteCustomerCode">12345</Extrinsic>

Contact:

2. Retrieving user/address/customer data into the ERP

Another option is to fetch the customer data using the following API calls and parameters to GET the data:

GET /api/origin/{origin_code}/customer/?create_date__gte>{date from last_update}

GET /api/origin/{origin_code}/address/?create_date__gte>{date from last_update}

GET /api/origin/{origin_code}/user/?create_date__gte>{date from last_update}

The API returns ALL user data (CloudSuite registered and ERP registered). The requester should check if the data is already present in the ERP and then add or update new or changed user data.

Important note

When data is communicated from the ERP system to CloudSuite, ALWAYS use the original key initially included in the cXML (see: New customer/address/user registration in CloudSuite | 1. Getting customer data into the ERP system).

The code, however, can be adjusted to represent the same customer code as in the ERP system.

Data	Key	Code / E-mail

Data	Key	Code / E-mail
User	Generated UUID ( e.g. b3ea7d82-d1e1-420c-bd41-cabc1d9d20c9 )	E-mail address
Address	Generated UUID ( e.g. 8eb9cbc3-7f5c-4f14-9045-f978d72a7d7d )	N/a
Customer	Predefined formated number with an optional prefix ( e.g. BK12345 )	Own defined code from ERP

It is not possible to change the key of the user/address/customer after it has been created.
There is a workaround as described here.