最近Jerry在做一个微信和SAP Commerce Cloud集成的项目，需要在微信里调用后者的Restful API进行订单创建和读取。以前Jerry对SAP Commerce Cloud知之甚少，这次趁机学习了一下，过程中得到了SAP成都研究院Commerce开发团队的Jonathan，Kevin和Kate等几位同学的大力帮助，这里表示感谢。

在SAP官网help.sap.com上根据关键字commerce搜索，结果列表里会显示出好几个产品，这难免会让像Jerry这种刚接触commerce的人感到有点疑惑。

其实只需要耐心地打开这些链接逐一阅读一会儿，就能弄清楚这几个产品间的差异：

SAP Commerce：SAP On-Premises上的电商解决方案

SAP Commerce Cloud on SAP Infrastructure: SAP Commerce的云端解决方案，Commerce核心代码通过SAP内部工具打成一个容器镜像，部署和运行在SAP自己的数据中心里。在很多文档里又称为Commerce Cloud Version One, 简称为CCV1.

SAP Commerce Cloud on Public Cloud：SAP Commerce云端解决方案，部署运行在公有云上，比如微软的Azure，简称为CCV2.

Medium上有一篇不错的博客Two clouds in practice: a comparison of SAP Commerce Cloud v1 and v2介绍CCV1和CCV2的对比，这里Jerry就不深入展开了。

回到本文主题，要想消费Commerce Cloud的订单服务，首先需要熟悉一下如何手动在Commerce Cloud里下单。在Commerce Cloud B2C的场景里，下单的流程对我们每个人来说几乎熟悉得不能再熟悉了——和我们日常在某宝上购物如出一辙。

到电商店铺里浏览商品，看中自己心仪的一款产品后，

总结一下，手动下单的流程可以分成这五步：

(1) 创建一个购物车Shopping Cart

(2) 给该购物车里添加产品

(3) 给该购物车维护发货地址

(4) 给该购物车维护支付明细

(5) 执行下单操作，成功生成订单

搞清楚流程之后，接下来需要找到每个步骤分别调用哪些API来实现。

登录SAP官网https://api.sap.com, 根据关键字Commerce Cloud搜索，很容易就能找到所有需要使用的API：

前面说到手动下单需要5个步骤，而Jerry项目文件里有七个step.js, 多出来的两个步骤，一个是获取Access Token，另一个是设置购物车的Delivery Mode. 前者是后续调用所有API的基础，而后者完成的逻辑，当我们在浏览器里手动下单时，Commerce Cloud应用会自动帮我们设置，但是用API的方式下单时，需要我们显式调用设置Delivery Mode的API, 因此最后一共需要7个步骤才能完成订单的创建。

获取Access Token的步骤，仍然是采用常规的OAuth认证，通过client id和client secret去换取Access Token.

我们首先需要在Commerce Cloud上创建一个OAuth Client，维护Client ID, Client Secret, 密码，token刷新间隔，相关权限等信息：

因为隐私原因，Jerry没有把urlconfig.js上传到github上，只上传了一个urlconfigTemplate.js, 请大家在使用这个nodejs应用之前，把urlconfigTemplate.js里的以左右尖括号标识的占位符替换成实际值，然后重命名成urlconfig.js即可。