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