在SAP官網 help.sap.com 上根據關鍵字 commerce 搜尋，結果列表裡會顯示出好幾個名稱相近的產品，這難免會讓一些 SAP commerce (電商雲)的初學者感到有點疑惑。

![](https://img-blog.csdnimg.cn/img_convert/653d78ae5800c7a0c9968ca584f82238.png)

其實只需要耐心地開啟這些連結逐一閱讀一會兒，就能弄清楚這幾個產品間的差異：

- 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 架構設定。

![](https://img-blog.csdnimg.cn/img_convert/02b2ef529848d93ff7d1cc4192bf0ed0.png)

預設情況下，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 可用於管理所有環境，包括生產環境。

![](https://img-blog.csdnimg.cn/img_convert/925b1bce6fc2f0028c7668d2b9d5709b.png)

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的場景裡，下單的流程對我們每個人來說幾乎熟悉得不能再熟悉了——和我們日常在某寶上購物如出一轍。
到電商店鋪裡瀏覽商品，看中自己心儀的一款產品後，

![](https://img-blog.csdnimg.cn/img_convert/39a940724a060d8f28151251e52332b1.png)

點選Add To Cart把產品加到購物車裡：

![](https://img-blog.csdnimg.cn/img_convert/a394d28bcedb8a65938aa80f1fc73d0a.png)

點Check Out去結賬：

![](https://img-blog.csdnimg.cn/img_convert/1df3891d0ecd75eb977859cfb714accf.png)

會生成一個購物車ID：

![](https://img-blog.csdnimg.cn/img_convert/9c2f9374ae637a58d1f16e076e1ca16a.png)

維護髮貨地址。當然我們平時在某寶上購物時，一般都提前在手機app裡維護了好幾個發貨地址，然後結賬時只需從中選擇一個即可。

![](https://img-blog.csdnimg.cn/img_convert/77fd5b7601efea70ad292ee5123ef53f.png)

維護支付方式和明細(Payment Detail)，這一步好比我們在某寶上購物選擇微信，支付寶，花唄等方式支付。

![](https://img-blog.csdnimg.cn/img_convert/0460d88faee8b88eeed7e2ad67058b2e.png)

Place Order點選後，成功生成訂單，得到訂單ID.

![](https://img-blog.csdnimg.cn/img_convert/0484189087be6fcd73bc867565a151ae.png)

總結一下，手動下單的流程可以分成這五步：
(1) 建立一個購物車Shopping Cart
(2) 給該購物車裡新增產品
(3) 給該購物車維護髮貨地址
(4) 給該購物車維護支付明細
(5) 執行下單操作，成功生成訂單

搞清楚流程之後，接下來需要找到每個步驟分別呼叫哪些API來實現。

登入SAP官網https://api.sap.com, 根據關鍵字Commerce Cloud搜尋，很容易就能找到所有需要使用的API：

![](https://img-blog.csdnimg.cn/img_convert/bae6fc8080fdc9d9ae47591d5a204983.png)

筆者寫了一個nodejs應用來演示這些API的用法。
執行這個應用，在第20行的回撥函式里會列印出成功建立的訂單ID：

![](https://img-blog.csdnimg.cn/img_convert/7e1afb401748b94a5c11840e20ab4118.png)

根據這個ID到Commerce Cloud的backoffice裡，能查詢到成功建立的訂單：

![](https://img-blog.csdnimg.cn/img_convert/686fb176c4603057718e986ae905732a.png)
![](https://img-blog.csdnimg.cn/img_convert/5319bd119a9f8343c9f9d91ee8741c68.png)

前面說到手動下單需要5個步驟，而筆者專案檔案裡有七個step.js, 多出來的兩個步驟，一個是獲取Access Token，另一個是設定購物車的Delivery Mode. 前者是後續呼叫所有API的基礎，而後者完成的邏輯，當我們在瀏覽器裡手動下單時，Commerce Cloud應用會自動幫我們設定，但是用API的方式下單時，需要我們顯式呼叫設定Delivery Mode的API, 因此最後一共需要7個步驟才能完成訂單的建立。

![](https://img-blog.csdnimg.cn/img_convert/c4ece3b4b2cd9367164ae591afd4387a.png)

獲取Access Token的步驟，仍然是採用常規的OAuth認證，透過client id和client secret去換取Access Token.
我們首先需要在Commerce Cloud上建立一個OAuth Client，維護Client ID, Client Secret, 密碼，token重新整理間隔，相關許可權等資訊：

![](https://img-blog.csdnimg.cn/img_convert/9568e26b30bea872335bab1949a30c04.png)

然後在step1_get_token.js裡，透過OAuth Client維護的這些資訊發一個POST請求到OAuth endpoint換取Access Token.

![](https://img-blog.csdnimg.cn/img_convert/974f86b97a3bcfdcb9219bb7729adee5.png)

因為隱私原因，筆者沒有把urlconfig.js上傳到github上，只上傳了一個urlconfigTemplate.js, 請大家在使用這個nodejs應用之前，把 urlconfigTemplate.js 裡的以左右尖括號標識的佔位符替換成實際值，然後重新命名成urlconfig.js即可。

![](https://img-blog.csdnimg.cn/img_convert/559ad8a5244840820a7b27e66784d7cd.png)

# 總結

本文首先介紹了 SAP 電商雲 CCV1 和 CCV2 的差別，接著詳細介紹了使用電商雲提供的 order API，透過 Node.js 程式碼的方式建立訂單的詳細技術實現。

如何使用 API 的方式消費 SAP Commerce Cloud 的訂單服務

相關文章