Shopfiy API對接教程
時間：2020-11-04
我們已對接Shopify API，您可以直接在PFC系統(tǒng)中批量獲取Shopify訂單了。
與本章節(jié)有關(guān)的主題
1. 生成Shopify API key和password
2. 定義Shopify發(fā)貨和配送
3. 在PFC系統(tǒng)配置API對接
4. 批量獲取Shopify訂單
5. Shopify API對接常見問題解答
1. 生成Shopify API key和password
請登錄Shopify生成API key和password。關(guān)于更多，請點擊此處查看Shopify幫助頁面。
1. 在您的Shopify后臺，點擊左導(dǎo)航中的【Apps】;
2. 點擊頁面下方的【Manage private apps】；
3. 點擊【Create new private app】；
4. 在【App details】部分中的【Private app name】欄位，輸入PFC；
5. 輸入您常用的郵箱地址；
6. 在【Admin API】，選擇您允許PFC系統(tǒng)訪問的權(quán)限；
6.1 在Fulfillment services下拉菜單中選擇【Read and write】；
6.2 在Locations下拉菜單中選擇【Read access】；
6.3 在Merchant-managed fulfillment orders下拉菜單中選擇【Read and write】；
6.4 在Orders下拉菜單中選擇【Read and write】；
6.5 在Shipping下拉菜單中選擇【Read and write】；
7. 設(shè)置完成后點擊【Save】；
8. 在彈出對話框中點擊【Create app】。
此時，您的API key和password將顯示在頁面中。
2. 定義Shopify發(fā)貨和配送
1. 在您的Shopify后臺，點擊左下角的【Settings】；
2. 點擊【Shipping and delivery】；
3. 點擊【Manage rates】來定義您的發(fā)貨和配送選項（您可以根據(jù)需要定義通用模板或自定義模板）。
請注意，您在發(fā)貨和配送設(shè)置中定義的Rate name將被用于匹配PFC運輸方式。
3. 在PFC系統(tǒng)配置API對接
1. 登錄PFC系統(tǒng)；
2. 點擊進(jìn)入【出口轉(zhuǎn)運】>【訂單管理】>【API對接】，或；
3. 點擊進(jìn)入【倉儲管理]> 【出口轉(zhuǎn)運】>【API對接】；
4. 如您是第一次在PFC系統(tǒng)中配置API，請在默認(rèn)【API接口】選項卡中，點擊【生成密鑰】（若您已經(jīng)配置過API可忽略此步驟）；
5. 在彈出窗口中點擊【生成】（您的API密鑰將展示在客戶ID右側(cè)）；
6. 切換至【Shopify】選項卡，然后點擊【Add】;
7. 在彈出窗口中，輸入您的Shopify店鋪名稱（請屬于您第一次注冊Shopify時所使用的名稱）；
8. 復(fù)制并粘貼您在步驟1中獲取的API key和password到指定欄位；
9. 在兩個下拉選項中選擇【啟用】；
10. 在【運輸方式對應(yīng)】部分，點擊右側(cè)的【添加】定義您的自動運輸匹配規(guī)則；
10.1 在第一列【運輸方式】欄位，復(fù)制您在Shopify中所設(shè)置的Rate name；
10.2 在第二列【PFC運輸方式】欄位，選擇您需要使用的運輸方式；
10.3 重復(fù)上述步驟直至完成了所有目標(biāo)國家的運輸匹配設(shè)置；
11. 根據(jù)需要設(shè)置默認(rèn)申報價值和重量；
12. 若您需要使用倉儲服務(wù)來處理Shopify訂單，請選擇您已開通服務(wù)的倉庫；
13. 設(shè)置完成后點擊【生成】。
4. 批量獲取Shopify訂單
當(dāng)您完成了所有的配置，并且有訂單需要發(fā)貨，您可以根據(jù)以下步驟獲取訂單；1. 登錄PFC系統(tǒng)；
2. 點擊進(jìn)入【出口轉(zhuǎn)運】>【訂單管理】>【API對接】，或；
3. 點擊進(jìn)入【倉儲管理]> 【出口轉(zhuǎn)運】>【API對接】；
4. 在您的Shopify店鋪右側(cè)，點擊【獲取訂單】；
5. 在彈出窗口中，選擇訂單的起止時間；
6. 在Financial status下拉菜單中選擇【Paid】;
7. 根據(jù)需要選擇Fulfillment status；
9. 點擊【Acquire Order】。
系統(tǒng)將處理您的訂單請求并返回相應(yīng)的提示。若提示訂單創(chuàng)建成功，則您可以前往【出口轉(zhuǎn)運】>【訂單管理】>【出口訂單列表】>【草稿】查看代發(fā)貨訂單，或前往【倉儲管理]> 【出口轉(zhuǎn)運】>【倉儲訂單列表】>【草稿】查看倉儲訂單。
5. Shopify API對接常見問題解答
Q1. 獲取訂單失敗，提示“未將對象引用設(shè)置到對象的實例”，或”Not Found“該怎么操作？
A1. 請檢查您是否輸入了正確的Shopify店鋪名稱。此名稱必須與您第一次注冊Shopify所使用的名稱完全匹配。若您不知道第一次注冊時所使用的名稱，可以通過一下方法查看：
1. 登錄您的Shopify后臺；
2. 在Admin API部分，找到【Example URL】欄位（此欄位位于【API key】和【Password】欄位下方）；
3. 在您的example URL中，找到并復(fù)制@和.myshopify.com中間的所有字符，并粘貼至PFC API設(shè)置頁面中（此串字符即為您最初注冊Shopify所使用的店鋪名稱）。
Q2. 獲取訂單失敗，提示"[API] This action requires merchant approval for read_orders scope."，該怎么操作？
A2. 請檢查您在Shopify后臺的權(quán)限設(shè)置，必須開通以下權(quán)限才能獲取訂單：
1. 在Fulfillment services下拉菜單中選擇【Read and write】；
2. 在Locations下拉菜單中選擇【Read access】；
3. 在Merchant-managed fulfillment orders下拉菜單中選擇【Read and write】；
4. 在Orders下拉菜單中選擇【Read and write】；
5. 在Shipping下拉菜單中選擇【Read and write】；
Q3. 獲取訂單失敗，提示“Cannot find the product”，該怎么操作？
A3. 若您是使用倉儲管理來處理Shopify訂單，則您需要在Shopify產(chǎn)品中添加SKU，且此SKU必須與PFC系統(tǒng)中上架的SKU完全匹配（區(qū)分大小寫）。若您沒有完成此步驟，當(dāng)買家下單時，對應(yīng)的SKU值為空，系統(tǒng)無法匹配PFC SKU，則導(dǎo)致獲取訂單失敗。Shopify完善SKU信息后只對未來的訂單生效。若您的訂單在添加Shopify SKU之前已經(jīng)生成了，則您需要手動在PFC系統(tǒng)中創(chuàng)建訂單或者使用Excel批量上傳訂單。
Q4. 獲取訂單失敗，提示“Cannot find the channel code”，該怎么操作？
A4. 出現(xiàn)此提示可能有以下原因：
1. 所選擇的運輸方式已禁用。
2. 所選擇的運輸方式不再支持運送至訂單中的目的地國家。
系統(tǒng)可能會根據(jù)需要調(diào)整運輸方式，若您所選擇的運輸方式已被禁用，或目的地國家已被屏蔽，可以聯(lián)系您的客戶經(jīng)理為您推薦新的運輸方式并更新到設(shè)置中。
Q5. 獲取訂單成功，但是系統(tǒng)匹配的運輸方式并不是我所選擇的，該怎么操作？
A5. 請檢查您在Shopify設(shè)置中填寫的Rate name與PFC設(shè)置中填寫的Rate name是否完全匹配（區(qū)分大小寫）。若系統(tǒng)無法匹配Rate name，則會默認(rèn)為相應(yīng)訂單選擇CNAPOST運輸方式。