Wayfair Sandbox测试工具

一、功能价值简述

Wayfair使用接口存在特殊性，即某一店铺需要使用接口，用户需要在店铺后台逐个完成接口测试，接口才能给到领星ERP调用，对于没有技术基础的卖家，这一步很难操作。领星ERP提供自动测试工具，只需要提供授权码，接口测试即可以由系统自动执行。

二、操作说明

1. 权限设置

• 超级管理员已在【多平台系统】>【业务配置】>【平台管理】模块开启了Wayfair平台；
• 用户有【设置】>【Wayfair店铺授权】中的 添加/编辑/删除 功能权限。

2.Wayfair开发者申请

• 部分卖家账号支持直接开通接口，无需等待邮件，开通方式见下图：
•  
• 大部分卖家都可以直接开通 接口 权限，然后就可以跳过该流程，直接到 【3.创建沙盒应用】 继续激活。若无法开通该 接口，再往下进行申请 接口 权限流程：
• 申请接口权限

（1）给平台发送一封邮件，申请开通接口（预计5-10个工作日）

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

（2）平台一般会回复需要商家在后台提供Ticket，此时提前准备好 Ticket 提交即可，菜单路径：Menu —> Tickets —> Submit a Ticket：

【ticket 说明】

需要选择如图所示的内容，在 tech contact name 和 email 当中填写您的联系方式即可。

提交 ticket 后，往下操作确认开通结果，并时刻注意 ticket 是否有回复。

（3）确认开通结果，如果在后台看到有以下菜单，代表开通成功，进行下一步激活操作。

（4）若没有 上一步骤 所示菜单，请检查账户 接口 权限是否已开通。

3. 创建沙盒应用

（1）相关帮助可参考官方帮助文档：https://partners.wayfair.com/help/3  ，在店铺常用环境打开网址。步骤一 Application Creation 则是创建应用，可参考该文档进行操作，也可继续查看领星帮助文档操作。

除了以上通过帮助文档进入创建应用界面外，还可以直接通过菜单进入，路径：Menu —> Developer —> Applications：

（2）进入点击进行创建沙盒应用

注意：创建沙盒（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文件，点击[开始测试]，系统将自动测试列表所示接口，测试状态显示完成后，可进行下一步。

常见失败场景：

1）获取订单接口失败：Sandbox接口测试基于店铺产生的订单进行测试，如果店铺并未产生dropShip order，该接口无法测试成功。如果店铺只有Castlegate订单，该接口测试失败无需处理。

2）获取Castlegate订单接口失败：该接口只针对CastleGate订单，如果店铺并无CastleGate订单业务，该接口测试失败无需处理。

3）发货通知接口失败：该接口基于dropship订单测试，如果店铺并未产生dropShip order，该接口无法测试成功。如果店铺只有Castlegate订单，该接口测试失败无需处理。

4）接受订单接口失败：该接口基于dropship订单测试，如果店铺并未产生dropShip order，该接口无法测试成功。如果店铺只有Castlegate订单，该接口测试失败无需处理。

5）注册面单接口失败：该接口基于dropship订单测试，如果店铺并未产生dropShip order，该接口无法测试成功。如果店铺只有Castlegate订单，该接口测试失败无需处理。

6）库存同步：该接口用于同步库存到店铺，数据来源于导入的表格，如果该接口测试失败，请确认表格格式是否为以下格式。

6. 开通接口权限

• DropShip Order Query（获取订单）、Ship Notification Mutation（发货通知）、Accept Order Mutation（接受订单）、Register Mutation（注册面单）：

这几个接口测试完成后，可进入店铺后台查看接口状态。路径进入服务商接入状态页面，路径：Menu —> Developer —> Supplier Integration Status，查看 接口 Status（测试状态），对应Purchase Order、ShipNotice、Shipping 接口，如果为 Ready For Production 或者 Live，代表前面的测试流程已通过，可以开启帐号权限。若存在接口状态依旧为 Testing in Progress 或 Not Ready，请重新测试对应接口的测试步骤。完成接口测试后，接口状态将处于 Ready（已完成）状态。最后将接口给对应 Production（生产）应用开启后，可在【正式环境对接】查看，接口将处于 Live（激活）状态。

• Save Inventory Mutation（同步库存）：

该接口测试完成后，需进入店铺提交Ticket给平台开通接口权限。如果不需要从系统同步库存到店铺，可不处理。

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提交后，平台一般会回复告知需要完成测试才能开启接口权限，如果已在系统中完成库存同步接口测试，可直接回复平台 说明测试已经完成 。

• 获取CastleGate订单（CastleGate Order Query）：

依据平台新的接口要求，CastleGate订单接口测试处理获取订单接口测试外，还需要测试其他CastleGate订单相关接口，目前系统测试工具暂未兼容其他接口，需要用户进入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. 正式环境对接

要使用沙盒环境的应用测试完成后，生产环境（Production）的应用才能开启权限，请注意店铺后台中测试进度，确保测试通过。

创建一个生产环境（Production）状态的应用用于领星ERP授权，应用名称建议用“LINGXING”字样便于辨认。

开启上一步创建的生产环境应用的对应的接口权限

使用 Production 应用， 验证接口是否正常使用。进入后台接口测试工具，验证接口。

• 返回了订单数据，则应用正常启用。
• 未返回订单数据，应用未正常启用，截图以下页面，提ticket给平台告知平台 "XX店铺账号已经测试成功，请验证"。然后等待平台回复结果即可。

截图一：

切换到 Purchase Orders，继续截图提供给平台。

截图二：