Step by Step to create orders by consuming SAP Commerce Cloud Restful API

Posted JerryWangSAP

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Step by Step to create orders by consuming SAP Commerce Cloud Restful API相关的知识,希望对你有一定的参考价值。

Recently Jerry is working on an integration project about creating orders in Wechat platform by consuming SAP Commerce Cloud Restful API.

Consultants who didn‘t touch SAP Commerce before(such as Jerry ) might get confused once they saw the search result by key word "commerce" in https://help.sap.com:

技术图片

Several products with similar name are listed in search result.

  • SAP Commerce:SAP commerce solution based on On-Premises deployment approach

  • SAP Commerce Cloud on SAP Infrastructure & SAP Commerce Cloud on Public Cloud: as their names give a very clear hint: both are SAP Commerce solution based on cloud, and differentiated by the underlying cloud infrastructure the solution are running. SAP Commerce Cloud on SAP Infrastructure are sometimes called Commerce Cloud Version One and CCV1 for short, while the latter called CCV2.

There is a nice blog Two clouds in practice: a comparison of SAP Commerce Cloud v1 and v2in medium comparing both.

技术图片

Back to my task, it‘s helpful if we play around in Commerce Cloud storefront UI to create a order manually to get ourselves familar with the process.

Log in to storefront and browse the site:
技术图片

And identify a favourite product and add it to cart by pressing button "ADD TO CART":

技术图片

Press CHECK OUT to proceed:

技术图片

Now we get a cart ID:

技术图片

Maintain shipping address:

技术图片

Maintain payment details:

技术图片

Once Place Order button is clicked, the order is successfully created with an automatically populated order ID:

技术图片

In summary, the process of order manual creation in SAP Commerce Cloud consists of five steps:

(1) create a Shopping Cart

(2) add products into the cart

(3) maintain shipping address to the cart

(4) maintain payment details to the cart

(5) execution place order action on the cart to get order created

Now we should figure out for each step, what exactly APIs should be called.

Go to https://api.sap.com, search by keyword "Commerce Cloud", and it‘s easy to find the supported API list there.

技术图片

Jerry has written a simple nodejs application to demonstrate how to consume such APIs to create orders in SAP Commerce Cloud. The whole source code is uploaded to my github.

Execute the application, and we can observe the successflly created order with its ID in callback function in line 20:

技术图片

Search the ID in Commerce Cloud backoffice UI to check the details of created order.

技术图片
技术图片

As introduced before, it‘s necessary to go through five steps to have an order generated. And in Jerry‘s project there are totally seven "step.js" implementation files, why?

For the additional two step.js, one is for access token retrieve and the other for cart delivery mode set operation. Access token will be appended to the header fields of all the subsequent API calls for authorization purpose. And the cart delivery mode will be set implicitly if performed in storefront UI via browser whereas an explicit API call is necessary in our case. As a result totally seven HTTP roundtrip is needed in API consumption case.

技术图片

The access token fetch is implemented by following OAuth protocol: send the OAuth Client ID and secret to SAP Commerce Cloud OAuth endpoint to get the issued access token.

First we have to create a new OAuth Client in SAP Commerce Cloud backoffice:

技术图片

Then in file "step1_get_token.js", send a HTTP POST to Commerce Cloud Authentication endpoint to request access token:

技术图片

For privacy reason I didn‘t upload urlconfig.js to github which contains the dedicated url of my own Commerce Cloud API endpoint. Instead I upload the template file: urlconfigTemplate.js. Just replace the place holder marked with "<>" with your actual value there, rename the template file back to urlconfig.js. After that you can create orders in your own Commerce Cloud tenant.

技术图片

要获取更多Jerry的原创文章,请关注公众号"汪子熙":
技术图片

以上是关于Step by Step to create orders by consuming SAP Commerce Cloud Restful API的主要内容,如果未能解决你的问题,请参考以下文章

[Transducer] Step by Step to build a simple transducer

《Practical UVM Step By Step with IEEE》2.4 Create UVM Testbench Environment for the DUT

step by step guide tell you how to build a website

leetcode1413. Minimum Value to Get Positive Step by Step Sum

leetcode1413. Minimum Value to Get Positive Step by Step Sum

EGit with eclipse to clone project from GitHub(Step by step)