A guide on how to create customers on Shopware-6 using Alumio
Customer creation is a straight-forward operation.
Requirements
An input XML file that contains at least the mandatory fields that are depicted in the Shopware-6 Customer creation document.
Name | Type | Comments |
salutationId | uuid | |
firstName | String | |
lastName | String | |
String | ||
password | String | Only required when the guest is false. |
billingAddress.street | String | |
billingAddress.zipcode | String | |
billingAddress.city | String | |
billingAddress.countryId | String | |
shippingAddress.salutationId | String | Only required, when shippingAddress is given |
shippingAddress.firstName | String | |
shippingAddress.lastName | String | |
shippingAddress.street | String | |
shippingAddress.zipcode | String | |
shippingAddress.city | String | |
shippingAddress.countryId | String |
A sample Customer creation request body is as follows,
How to obtain the Ids
Strategy-1: The IDs must be obtained from an external source or the Shopware provider who created the Store.
Strategy-2: Create a customer on Shopware and perform a GET operation to retrieve the customer along with the relevant IDs.
Perform a GET call for the created customer to get the relevant default IDs.
Setting up the FTP Filesystem to Read customer input files
Navigate to the Filesystem configuration on the Dashboard and create an FTP configuration as shown below, the Root Directory should point to the parent and/or root folder of the FTP.
Create an incoming connection
Refer to the basic guide on how to create configurations in Alumio
https://docs.alumio.com/get-started-with-the-ipaas#creating-an-integration-pipeline
Reading the input XML file to create the customer
If the input file contains multiple customers in a single XML file use the "Get branches from a pattern" transformed to split them into individual tasks.
For example, if the input file is as follows,
Equivalent branches transformer.
Create a Route
Create an Outgoing connection
Any additional modifications to the data and/or payload should be performed by constructing relevant Transformers and invoking them in the correct sequence.
Avoid processing duplicate Customers from input file
Alumio provides an in-built transformer "Filter previously stored entities" that will perform the following tasks,
- Filter the input tasks and/or entities that have been already processed by Alumio.
- Make an entry in the delta filter storage of the new tasks that were processed by Alumio.
NOTE: It is recommended to invoke the delta filter functionality after branching the records into their individual task.
Setup a delta filter storage
Setup the Delta filter