如何使用 API 的方式消费 SAP Commerce Cloud 的订单服务

在SAP官网 help.sap.com 上根据关键字 commerce 搜索，结果列表里会显示出好几个名称相近的产品，这难免会让一些 SAP commerce (电商云)的初学者感到有点疑惑。

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

SAP Commerce：SAP On-Premises上的电商解决方案
SAP Commerce Cloud on SAP Infrastructure: SAP Commerce的云端解决方案，Commerce核心代码通过SAP内部工具打成一个容器镜像，部署和运行在SAP自己的数据中心里。在很多文档里又称为Commerce Cloud Version One, 简称为 CCV1. 从严格意义上说，CCV1 是一组标准化的 Linux 虚拟机，遵循在 SAP 数据中心运行的基本 SAP Commerce 架构设置。

默认情况下，SAP 在 CCv1 中提供三种环境：Development、Staging 和 Production（以及访问这些环境的 VPN）。典型的开发环境包含以下服务器类型之一：Hybris 应用程序服务器、Web 服务器、SOLR 搜索服务器、Hybris Data hub 和 HANA 数据库。另一方面，在生产环境中，一套典型的系统 Landscape 通常至少有两个 Web 服务器、两个前端应用程序服务器、一个管理应用程序服务器、三个 SOLR 服务器（一个主服务器和两个从属服务器）、两个数据中心服务器和一个 HANA 数据库集群服务器。这种规模对于流量适中的标准 B2B 电子商务网站已经足够，但对于公共 B2C 网站，或许有进一步优化的空间。

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

SAP CCV2 不同于 CCV1 的架构，是一套使用 Kubernetes 等现代技术在 Microsoft Azure 上运行的云原生解决方案。提供一个 Web UI 可用于管理所有环境，包括生产环境。

CCV2 具有与 CCV1 中相同的一组环境：Development、Staging 和 Production. 与 CCV1 不同，客户不会获得显示每个环境的服务器设置的详细架构图。客户可以通过手动提出申请的方向，向 SAP 请求对生产环境进行水平扩展和垂直扩展，以预防其站点的预计流量达到峰值的情况出现。该数据库始终是 Microsoft Azure SQL 数据库，它作为 Azure 云的服务提供。 Kibana 用于服务器监控和日志。

在某种程度上，CCV2 比 CCV1 更开放。客户以及合作伙伴能够创建新的构建，并将它们部署到包括生产环境在内的所有环境。通过将 Git 存储库连接到云平台来创建一个 Build. 开发人员只需要在存储库的根目录中维护一个特殊的 manifest.json 文件，将存储库连接到 CCv2 后，可以通过单击 CCv2 用户界面中的按钮来创建新版本。构建完成后，您可以单击另一个按钮将构建部署到环境中。

从 CCV1 到 CCV2 的演进之路不难看出，SAP（与所有其他公司一样）正在将其服务从本地迁移到云端。

回到本文主题，要想消费Commerce Cloud的订单服务，首先需要熟悉一下如何手动在Commerce Cloud里下单。在Commerce Cloud B2C的场景里，下单的流程对我们每个人来说几乎熟悉得不能再熟悉了——和我们日常在某宝上购物如出一辙。
到电商店铺里浏览商品，看中自己心仪的一款产品后，

点击Add To Cart把产品加到购物车里：

点Check Out去结账：

会生成一个购物车ID：

维护发货地址。当然我们平时在某宝上购物时，一般都提前在手机app里维护了好几个发货地址，然后结账时只需从中选择一个即可。

维护支付方式和明细(Payment Detail)，这一步好比我们在某宝上购物选择微信，支付宝，花呗等方式支付。

Place Order点击后，成功生成订单，得到订单ID.

总结一下，手动下单的流程可以分成这五步：
(1) 创建一个购物车Shopping Cart
(2) 给该购物车里添加产品
(3) 给该购物车维护发货地址
(4) 给该购物车维护支付明细
(5) 执行下单操作，成功生成订单

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

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

笔者写了一个nodejs应用来演示这些API的用法。
执行这个应用，在第20行的回调函数里会打印出成功创建的订单ID：

根据这个ID到Commerce Cloud的backoffice里，能查找到成功创建的订单：

前面说到手动下单需要5个步骤，而笔者项目文件里有七个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刷新间隔，相关权限等信息：