Wayfair Sandbox测试工具

一、功能价值简述

Wayfair使用接口存在特殊性，即某一店铺需要使用接口，用户需要在店铺后台逐个完成接口测试，接口才能给到领星ERP调用。领星ERP提供自动测试工具，只需要提供授权码，接口测试即可以由系统自动执行。

二、操作说明

1. 权限设置

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

2.Wayfair开发者申请

• 部分卖家账号支持直接开通 接口（API） 权限，无需等待邮件
  点击跳转到店铺后台
  开通方式见下图：在后台Partner Home的User Management勾选权限 
•  
• 大部分卖家都可以直接开通 接口 权限，可以跳过下方申请接口权限流程，直接到 3.创建沙盒应用 继续激活。

• 申请接口权限

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

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

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

Ticket 说明

需要选择如图所示的内容，在 Tech Contact Name 和 Tech Contact Email 当中填写您的联系方式即可。

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

（3）确认开通结果，请登录Wayfair开发者门户查看，查看登录后是否有截图中的按钮

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

3. 创建沙盒应用

（1）相关帮助可参考官方帮助文档：https://partners.wayfair.com/help/3  ，或点击跳转，在店铺常用环境打开网址。

也可继续查看领星帮助文档操作。

• 点击菜单栏 Integrations → Developer Portal

• 点击App Management

• 点击Create New Application

（2）创建沙盒应用

注意：创建沙盒（Sandbox）应用时一定要选择 Sandbox

当Sandbox APP创建完后请务必记录Client ID 和 Client Secret（如下图所示），这些字段会被用来获取token，从而完成API对接认证

（3）成功创建后，此Sandbox APP会在”Sandbox Applications”下面显示

（4）创建好Sandbox App后，请立即创建生产环境APP，即Production Application。如果没有立即完成生产环境APP的创建，完成沙盒测试后，系统无法自动给到生产环境APP权限

同时务必记录生产环境APP的 Client ID 和 Client Secret，这是最后授权到ERP时需要用到的ID和Secret

建议将App Name设为Lingxing以便于辨认

4. 下载库存CSV文件

进入Inventory>Inventory Management 菜单页，下载完整的库存CSV表格，表格包含Supplier ID、Supplier Part#、Quantity On Hand。

5. 测试接口

复制上述步骤生成的Sandox application，进入领星ERP 中Wayfair 店铺列表，点击 Sandbox测试，在弹窗中，分别输入前述步骤复制的沙盒环境的client_id和secret，并导入库存CSV文件，点击[开始测试]，系统将自动测试列表所示接口，测试状态显示完成后，可进行下一步。

Sandbox测试完成后，DropShip Order Query（获取订单）、Ship Notification Mutation（发货通知）、Accept Order Mutation（接受订单）、Register Mutation（注册面单）四个接口将自动开启生产环境接口权限，无需再到后台操作。

此时可以将3.（4）中生成的生产环境Client ID 和 Client Secret，填写进领星，进行店铺授权，参考链接：Wayfair店铺授权

常见失败场景：

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. 开通其他接口权限

• 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.