一、功能價(jià)值簡(jiǎn)述

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

二、操作說(shuō)明

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

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

2.Wayfair開(kāi)發(fā)者申請(qǐng)

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

（1）給平臺(tái)發(fā)送一封郵件，申請(qǐng)開(kāi)通接口（預(yù)計(jì)5-10個(gè)工作日）

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

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

【ticket 說(shuō)明】

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

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

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

（4）若沒(méi)有 上一步驟 所示菜單，請(qǐng)檢查賬戶(hù) 接口 權(quán)限是否已開(kāi)通。

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

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

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

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

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

4. 下載庫(kù)存CSV文件

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

5. 測(cè)試接口

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

常見(jiàn)失敗場(chǎng)景：

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

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

3）發(fā)貨通知接口失?。涸摻涌诨赿ropship訂單測(cè)試，如果店鋪并未產(chǎn)生dropShip order，該接口無(wú)法測(cè)試成功。如果店鋪只有Castlegate訂單，該接口測(cè)試失敗無(wú)需處理。

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

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

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

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

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

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

• Save Inventory Mutation（同步庫(kù)存）：

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

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提交后，平臺(tái)一般會(huì)回復(fù)告知需要完成測(cè)試才能開(kāi)啟接口權(quán)限，如果已在系統(tǒng)中完成庫(kù)存同步接口測(cè)試，可直接回復(fù)平臺(tái) 說(shuō)明測(cè)試已經(jīng)完成 。

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

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

進(jìn)入GraphQL頁(yè)面，選擇Sandbox Application

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

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

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

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

以上接口測(cè)試完成后，需進(jìn)入店鋪提交Ticket給平臺(tái),平臺(tái)確認(rèn)測(cè)試完成后會(huì)開(kāi)啟對(duì)應(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)境對(duì)接

要使用沙盒環(huán)境的應(yīng)用測(cè)試完成后，生產(chǎn)環(huán)境（Production）的應(yīng)用才能開(kāi)啟權(quán)限，請(qǐng)注意店鋪后臺(tái)中測(cè)試進(jìn)度，確保測(cè)試通過(guò)。

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

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

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

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

截圖一：

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

截圖二：