Integration between SAP Commerce Cloud and CPI using Integration Object – one case with Emarsys
This article will explain how you can integrate SAP Commerce and Emarsys through CPI.
This post can be helpful for things like Customer Register or any Item Type of SAP Commerce. We will show an approach with the out-of-the-box (OOTB) features.
This blog was built in 3 parts:
- Requirement – SAP Commerce set up with information from CPI;
- Integration Object setup;
The proposal is through the store (Spartacus) to make a register of customers, capture the event with Integration Object and send it to CPI.
In CPI, we will set up the Emarsys authentication (WSSE) and create a map of fields after sending it to Emarsys.
|To CPI setups and Emarsys information, access the post Integrating SAP Commerce and SAP Emarsys using Cloud Integration post by David Pietroniro.|
In Emarsys, we are going to check the information sent from CPI.
1.1 Firstly, we need CPI credentials and the URL of the public endpoint. In our sample, we used Basic Credentials.
1.2 Go to SAP Commerce Backoffice of SAP Commerce
1.3 Going to the vertical menu, select Basic Credentials and add a new Basic Credential.
1.4 Put the credential generated in CPI
OK. We have the CPI credentials saved in our SAP Commerce.
We are going to save the public endpoint shared by CPI.
1.5 Again, in the vertical Backoffice menu, click on Consumed Destinations
1.6 Add the public endpoint according to the following image
1.7 Select the credential created before
1.8 Test the endpoint from CPI and check if the green message is shown.
With that steps, you have a connection with CPI.
2 Integration Object (IO) Setup
2.1 At the top of Commerce, select Integration UI Tool.
|To see the full extensions list necessary for this resource, click here Integration Object – Extensions.|
2.2 Click on ‘Create Integration Object’ button
2.3 Define the name according to the context; in our case, Customer, I give the name ‘ioCustomer’ (i= Integration o= Object)
2.4 Select which Item Type of Commerce you need to capture the information; in our case, the Customer
2.5 After creating the ioCustomer, you can select the created IO.
2.6 Will be available many attributes; in our case, we selected the first level (Customer) and two attributes: ‘contactEmail’ and ‘customerID.’
2.7 Choose also the attribute that will have a unique value.
2.8 Now, you will create the Webhook; this functionality “allows SAP Commerce to send notifications to a configured destination URL when an item is saved (created or updated) or deleted.”
|To see more information about Webhook, click here Webhook|
2.9 In the vertical menu, select Webhook, following click on the plus button (CreateWebhookConfiguration)
2.10 In droplists, select the ‘ioCustomer,’ previously created; select ‘sendCustomer2CPI’, previously created in 1.6 item; select Event Type, in our case, ‘Item Saved.’
|‘Item Saved’ events will trigger all time that object Customer went changed.|
3.2 We choose the electronics store
|It is not necessary to use Spartacus because what triggers the event is the Commerce platform.|
3.3 Click on ‘Sign/ Register’
3.4 Considering that you are a new user, select ‘Register’.
3.5 Fill in all required fields and click on ‘Register’
3.6 Return to SAP Commerce, select the perspective ‘Integration UI Tool again.’
3.7 In the vertical menu, click on ‘Monitoring → Outbound.’
3.8 The submission record must be available with a success status.
|If the transaction is not available, put in local.properties of SAP Commerce the properties below:|
inboundservices.monitoring.success.payload.retention=true inboundservices.monitoring.error.payload.retention=true inboundservices.monitoring.enabled=true outboundservices.monitoring.success.payload.retention=true outboundservices.monitoring.error.payload.retention=true outboundservices.monitoring.enabled=true
3.9 If you’ve set up the CPI with Emarsys, is it possible to check your register in Emarsys
This work was done with my buddy David Pietroniro to explore SAP Commerce’s OOTB features for integration.
I will bring in future posts SAP Commerce integrations directly with Emarsys.
Also, take the time to visit my colleague David Pietroniro profile to find out more information about Integrating SAP Commerce and SAP Emarsys using Cloud Integration.