一、功能價值簡述

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

二、操作說明

1. 權(quán)限設(shè)置

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

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

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

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

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

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

【ticket 說明】

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

提交 ticket 后，往下操作確認(rèn)開通結(jié)果，并時刻注意 ticket 是否有回復(fù)。

（3）確認(rèn)開通結(jié)果，如果在后臺看到有以下菜單，代表開通成功，進(jìn)行下一步激活操作。

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

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

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

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

（2）進(jìn)入點(diǎn)擊進(jìn)行創(chuàng)建沙盒應(yīng)用

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

4. 下載庫存CSV文件

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

5. 測試接口

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

常見失敗場景：

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

2）獲取Castlegate訂單接口失敗：該接口只針對CastleGate訂單，如果店鋪并無CastleGate訂單業(yè)務(wù)，該接口測試失敗無需處理。

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

4）接受訂單接口失?。涸摻涌诨赿ropship訂單測試，如果店鋪并未產(chǎn)生dropShip order，該接口無法測試成功。如果店鋪只有Castlegate訂單，該接口測試失敗無需處理。

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

6）庫存同步：該接口用于同步庫存到店鋪，數(shù)據(jù)來源于導(dǎo)入的表格，如果該接口測試失敗，請確認(rèn)表格格式是否為以下格式。

6. 開通接口權(quán)限

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

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

• Save Inventory Mutation（同步庫存）：

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

Ticket內(nèi)容可以為：

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 [附上用于授權(quán)到領(lǐng)星ERP的 production application 的client ID].

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

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

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

進(jìn)入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,如下按步驟操作

以上接口測試完成后，需進(jìn)入店鋪提交Ticket給平臺,平臺確認(rèn)測試完成后會開啟對應(yīng)接口權(quán)限。

Ticket內(nèi)容可以為：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)境的應(yīng)用測試完成后，生產(chǎn)環(huán)境（Production）的應(yīng)用才能開啟權(quán)限，請注意店鋪后臺中測試進(jìn)度，確保測試通過。

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

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

使用 Production 應(yīng)用， 驗(yàn)證接口是否正常使用。進(jìn)入后臺接口測試工具，驗(yàn)證接口。

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

截圖一：

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

截圖二：