Wayfair Sandbox测试工具

一、功能价值简述

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

 

二、操作说明

1. 权限设置

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

 

2.Wayfair开发者申请

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

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

收件人:icrowley@wayfair.comsupplierintegration@wayfair.com

Dear Wayfair

Have a nice day. 

Now our ERP is ready for integration with Wayfair. 

Our IT Department needs Technical documents to integrate. 

Can you send me the Technical documents or any URL? 

Best Regards 

(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。

如果您的界面非上图所示,请按以下页面步骤下载标准表格
Wayfair Sandbox测试工具
Wayfair Sandbox测试工具

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

Wayfair Sandbox测试工具

1)[getCastleGatePurchaseOrders]接口测试。Operation type 选择Queries,接口下拉选择getCastleGatePurchaseOrders,如下按步骤操作

Wayfair Sandbox测试工具

2)[getCastleGateWarehouseShippingAdvice]接口测试。Operation type 选择Queries,接口下拉选择getCastleGateWarehouseShippingAdvice,如下按步骤操作

Wayfair Sandbox测试工具

3)[acknowledgeCastleGate]接口测试。Operation type 选择Mutation,接口下拉选择acknowledgeCastleGate,如下按步骤操作

Wayfair Sandbox测试工具

4)[acknowledgeCastleGateWarehouseShippingAdvice]接口测试。Operation type 选择Mutation,接口下拉选择acknowledgeCastleGateWarehouseShippingAdvice,如下按步骤操作

Wayfair Sandbox测试工具

以上接口测试完成后,需进入店铺提交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)的应用才能开启权限,请注意店铺后台中测试进度,确保测试通过。

(1)创建应用

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

(2)开启权限

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

(3)接口验证

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

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

截图一:

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

截图二:

 

未能解决你的问题?请联系在线客服

上一篇
Wayfair店铺授权
下一篇
UeeShop店铺授权
本文是否对您有帮助?
有帮助
无帮助