请输入
菜单

店铺授权—Wayfair(新)

注意事项:

  1. US、CA、EU需要分别创建店铺账号去授权

一、店铺授权操作

步骤1 给账号开通API权限

新版页面

  • 查看当前登录账号:

下拉找到当前登录邮箱

  • 为当前登录账号提供API相关权限,根据邮箱找到对应账户,点击右侧 '...'

旧版页面

使用管理员账号登录Wayfair Partner Home,在User Management页面给账号开通API权限


步骤2 创建应用

登陆后台,点击左边菜单,选择【Integrations】-【Developer Portal】

注意下选择对应店铺,如果店铺不正确则切换店铺

点击右上角的创建应用(如果已经创建过应用可以忽略此步)

创建应用(如果已经创建过应用可以忽略此步),输入应用名称,选择应用类型
注意:需要在平台后台创建两个应用,一个是沙箱环境(sandbox)的应用,用于平台接口测试审核;一个生产环境应用,用于拉取真实数据,处理后期订单履约等业务

如果已经有应用则检查应用权限,在应用列表选择【Manage Application 】

在应用详情页面选择【Permissions】,下面会列出当前应用已经拥有的权限(绿色背景表示已经拥有此项API接口权限

步骤3 将密钥信息回填到积加ERP并进行自动测试

  1. 填写生产环境密钥
    在多平台店铺对接页,点击【添加】

    在此处填写生产环境的密钥后,点击【授权】

  2. 填写沙箱环境密钥(如之前已进行过测试则跳过此步骤
    在店铺列表找到刚刚添加的店铺,在操作栏菜单选择【自动测试】

    在自动测试页面填写沙箱密钥并完成API测试

步骤4 完成自动测试

注意:
发货通知、发货、平台仓订单测试不是必勾项,不影响店铺授权
发货通知、发货测试影响自发货订单履约,所以如果需要订单处理履约请务必勾选!
平台仓订单测试影响平台仓发货订单的拉取,互相不干涉

点击【刷新进度】可刷新当前测试进度,如果测试进度显示“测试失败”则请重新检查一下测试条件是否都满足,并勾选失败的测试项点击【开始测试】进行重新测试

1. 自发货订单、发货通知、发货测试

注意:必须近30天有新订单,或者正在处理中的New、Processing状态的订单,否则影响订单接口测试结果

测试通过后,到后台应用检查是否已经开通了权限

2. 自发货库存同步测试

注意:一定要先勾选、然后上传后台的库存报告,然后点击开始测试
先到后台找到【库存管理】菜单
 
选择右上角的【导出库存报告】

选择自发货库存模板

导出文件后,直接点击ERP中的【上传后台Inventory】,完成上传操作,最后点击开始测试

导入库存报告如下

测试通过后,到后台应用检查是否已经开通了权限

3. 平台仓订单测试

注意:必须近30天内有平台仓发货的订单,否则影响订单接口测试结果

测试通过后,到后台应用哪里检查是否已经开通了权限

4. 取消订单获取测试


测试通过后,到后台应用检查是否已经开通了权限

5. 转FBA发货测试

注意:申请FBA多渠道API权限,先在后台设置虚拟仓,然后完成自动测试,最后开ticket
5.1 在wayfair设置一个虚拟的自发货Warehouse_id代表所有的FBA仓库
5.2 找中国这边账号对接的经理提交ticket,申请进入FBA发货项目,获得测试订单(TEST开头的订单号)
5.3 已经有了测试订单后,才开始完成自动测试

5.4 上述操作完成后,找中国这边账号对接的经理提交ticket,Wafyair确认数据准确后就可授权到正式环境。
5.5 开通后,建议先看一下,转FBA多渠道配送的帮助文档,如下:
自动转FBA多渠道配送
手动转FBA多渠道配送

6. 平台仓库存、转多渠道订单测试

平台仓库存、多渠道订单暂时不支持自动测试。如需申请以上权限,请按照以下操作
请贵司同事:
创建新的 sandbox 应用(不需要创建新的production应用),并获取clientId 和 secret
将clientId 和 secret 提供给客服,并备注需要申请的功能权限
客服会内部提交给开发处理,处理好之后通知贵司完成授权。

测试通过后,到后台应用检查是否已经开通了权限


二、QA

1.发货通知测试和发货测试都需要有状态为New、Processing的自发货订单,然后点击【自动测试】后【刷新进度】,否则测试程序会报找不到自发货订单

2.销售订单推送自发货失败,报店铺发货通知测试接口权限未授权,实际店铺授权哪里已经完成了发货通知测试



如果遇到这种情况,请到后台检查是否已经给积加开通了对应权限,如下图所示,需要将3个API都打勾

3.在排查某些异常问题和平台经理沟通的时候,平台经理会找客户要SUID

SUID获取
SUID只Wayfair一个店铺的ID,全称为Supplier ID,在[Supplier Integration Status] 页面,用于店铺唯一性校验

4.沙箱应用已经测试通过,但是生产应用还是没有权限

由于沙箱应用测试通过后,平台是自动给生产应用分配权限,有可能分配错误,需要先检查账号是否已经具有了对应的权限,如果已经具有权限了,则和平台反馈生产应用权限分配错误,让平台重新给正确的生产应用分配接口权限

最近修改: 2026-01-20