一、功能價值簡述

Wayfair使用接口存在特殊性，即某一店鋪需要使用接口，用戶需要在店鋪后臺逐個完成接口測試，接口才能給到領星ERP調用，對于沒有技術基礎的賣家，這一步很難操作。領星ERP提供自動測試工具，只需要提供授權碼，接口測試即可以由系統(tǒng)自動執(zhí)行。

二、操作說明

1. 權限設置

• 超級管理員已在【多平臺系統(tǒng)】>【業(yè)務配置】>【平臺管理】模塊開啟了Wayfair平臺；
• 用戶有【設置】>【Wayfair店鋪授權】中的 添加/編輯/刪除 功能權限。

2.Wayfair開發(fā)者申請

• 部分賣家賬號支持直接開通接口，無需等待郵件，開通方式見下圖：
•  
• 大部分賣家都可以直接開通 接口 權限，然后就可以跳過該流程，直接到 【3.創(chuàng)建沙盒應用】 繼續(xù)激活。若無法開通該 接口，再往下進行申請 接口 權限流程：
• 申請接口權限

（1）給平臺發(fā)送一封郵件，申請開通接口（預計5-10個工作日）

收件人：icrowley@wayfair.com、supplierintegration@wayfair.com

（2）平臺一般會回復需要商家在后臺提供Ticket，此時提前準備好 Ticket 提交即可，菜單路徑：Menu —> Tickets —> Submit a Ticket：

【ticket 說明】

需要選擇如圖所示的內容，在 tech contact name 和 email 當中填寫您的聯(lián)系方式即可。

提交 ticket 后，往下操作確認開通結果，并時刻注意 ticket 是否有回復。

（3）確認開通結果，如果在后臺看到有以下菜單，代表開通成功，進行下一步激活操作。

（4）若沒有 上一步驟 所示菜單，請檢查賬戶 接口 權限是否已開通。

3. 創(chuàng)建沙盒應用

（1）相關幫助可參考官方幫助文檔：https://partners.wayfair.com/help/3  ，在店鋪常用環(huán)境打開網址。步驟一 Application Creation 則是創(chuàng)建應用，可參考該文檔進行操作，也可繼續(xù)查看領星幫助文檔操作。

除了以上通過幫助文檔進入創(chuàng)建應用界面外，還可以直接通過菜單進入，路徑：Menu —> Developer —> Applications：

（2）進入點擊進行創(chuàng)建沙盒應用

注意：創(chuàng)建沙盒（Sandbox）應用一定要選擇 Sandbox

4. 下載庫存CSV文件

進入Inventory>Inventory Management 菜單頁，下載完整的庫存CSV表格，表格包含Supplier ID、Supplier Part#、Quantity On Hand。

5. 測試接口

復制上述步驟生成的Sandox application，進入領星ERP 中Wayfair 店鋪列表，點擊。Sandbox 測試，在彈出框中，分別輸入前述步驟復制的Application(務必注意使用Sandbox的Application)，并導入庫存CSV文件，點擊[開始測試]，系統(tǒng)將自動測試列表所示接口，測試狀態(tài)顯示完成后，可進行下一步。

常見失敗場景：

1）獲取訂單接口失?。篠andbox接口測試基于店鋪產生的訂單進行測試，如果店鋪并未產生dropShip order，該接口無法測試成功。如果店鋪只有Castlegate訂單，該接口測試失敗無需處理。

2）獲取Castlegate訂單接口失?。涸摻涌谥会槍astleGate訂單，如果店鋪并無CastleGate訂單業(yè)務，該接口測試失敗無需處理。

3）發(fā)貨通知接口失敗：該接口基于dropship訂單測試，如果店鋪并未產生dropShip order，該接口無法測試成功。如果店鋪只有Castlegate訂單，該接口測試失敗無需處理。

4）接受訂單接口失敗：該接口基于dropship訂單測試，如果店鋪并未產生dropShip order，該接口無法測試成功。如果店鋪只有Castlegate訂單，該接口測試失敗無需處理。

5）注冊面單接口失?。涸摻涌诨赿ropship訂單測試，如果店鋪并未產生dropShip order，該接口無法測試成功。如果店鋪只有Castlegate訂單，該接口測試失敗無需處理。

6）庫存同步：該接口用于同步庫存到店鋪，數據來源于導入的表格，如果該接口測試失敗，請確認表格格式是否為以下格式。

6. 開通接口權限

• DropShip Order Query（獲取訂單）、Ship Notification Mutation（發(fā)貨通知）、Accept Order Mutation（接受訂單）、Register Mutation（注冊面單）：

這幾個接口測試完成后，可進入店鋪后臺查看接口狀態(tài)。路徑進入服務商接入狀態(tài)頁面，路徑：Menu —> Developer —> Supplier Integration Status，查看 接口 Status（測試狀態(tài)），對應Purchase Order、ShipNotice、Shipping 接口，如果為 Ready For Production 或者 Live，代表前面的測試流程已通過，可以開啟帳號權限。若存在接口狀態(tài)依舊為 Testing in Progress 或 Not Ready，請重新測試對應接口的測試步驟。完成接口測試后，接口狀態(tài)將處于 Ready（已完成）狀態(tài)。最后將接口給對應 Production（生產）應用開啟后，可在【正式環(huán)境對接】查看，接口將處于 Live（激活）狀態(tài)。

• Save Inventory Mutation（同步庫存）：

該接口測試完成后，需進入店鋪提交Ticket給平臺開通接口權限。如果不需要從系統(tǒng)同步庫存到店鋪，可不處理。

Ticket內容可以為：

We are going to integrate inventory mutation with LINGXING ERP, Sandbox test was completed,please grant access to enpoint Save Inventory Mutation.Our production application is [附上用于授權到領星ERP的 production application 的client ID].

Ticket提交后，平臺一般會回復告知需要完成測試才能開啟接口權限，如果已在系統(tǒng)中完成庫存同步接口測試，可直接回復平臺 說明測試已經完成 。

• 獲取CastleGate訂單（CastleGate Order Query）：

依據平臺新的接口要求，CastleGate訂單接口測試處理獲取訂單接口測試外，還需要測試其他CastleGate訂單相關接口，目前系統(tǒng)測試工具暫未兼容其他接口，需要用戶進入Wayfair店鋪后臺GraphQL工具進行測試，操作步驟如下：

進入GraphQL頁面，選擇Sandbox Application

1）[getCastleGatePurchaseOrders]接口測試。Operation type 選擇Queries，接口下拉選擇getCastleGatePurchaseOrders,如下按步驟操作

2）[getCastleGateWarehouseShippingAdvice]接口測試。Operation type 選擇Queries，接口下拉選擇getCastleGateWarehouseShippingAdvice,如下按步驟操作

3）[acknowledgeCastleGate]接口測試。Operation type 選擇Mutation，接口下拉選擇acknowledgeCastleGate,如下按步驟操作

4）[acknowledgeCastleGateWarehouseShippingAdvice]接口測試。Operation type 選擇Mutation，接口下拉選擇acknowledgeCastleGateWarehouseShippingAdvice,如下按步驟操作

以上接口測試完成后，需進入店鋪提交Ticket給平臺,平臺確認測試完成后會開啟對應接口權限。

Ticket內容可以為：We are going to integrate CastleGate Orders with LINGXING ERP, Sandbox test was completed,please check and grant access to enpoint CastleGate Order Query.

7. 正式環(huán)境對接

要使用沙盒環(huán)境的應用測試完成后，生產環(huán)境（Production）的應用才能開啟權限，請注意店鋪后臺中測試進度，確保測試通過。

創(chuàng)建一個生產環(huán)境（Production）狀態(tài)的應用用于領星ERP授權，應用名稱建議用“LINGXING”字樣便于辨認。

開啟上一步創(chuàng)建的生產環(huán)境應用的對應的接口權限

使用 Production 應用， 驗證接口是否正常使用。進入后臺接口測試工具，驗證接口。

• 返回了訂單數據，則應用正常啟用。
• 未返回訂單數據，應用未正常啟用，截圖以下頁面，提t(yī)icket給平臺告知平臺 "XX店鋪賬號已經測試成功，請驗證"。然后等待平臺回復結果即可。

截圖一：

切換到 Purchase Orders，繼續(xù)截圖提供給平臺。

截圖二：