WMS 门户帮助中心- Niwo Partners Inc
如何在 NIWO OMS 中授权 Wayfair 商店
下单前注意事项:
- 系统同步的Wayfair门店订单的SKU为 Supplier Part Number ,为保证同步的订单能够顺利生成一件代发订单,请提前在Wayfair后台添加相应信息。
- 系统不同步平台创建的产品信息,需要客户在Leadstar OMS中自行创建SKU,并将系统创建的SKU与供应商零件编号进行映射。
- 目前 仅支持Wayfair创建的物流单,不支持使用海外仓物流在NIWO OMS获取物流单。订单同步到NIWO OMS后,选择“上传物流单”分配物流渠道;
- 由于Wayfair平台同步机制的限制, 无法检索历史文档 ,仅能同步成功获取店铺链接后产生的新订单。
1. 创建沙盒应用程序
1.1 在您商店的常用环境中,进入 Wayfair 开发者中心。
https://partners.wayfair.com/developer/applications ,使用您的 Wayfair 商店帐户登录。
路径:开发者→应用程序,显示如下页面:
如果出现这个界面:
请打开账户管理 → 我的账户,会出现如下图所示的页面,勾选红框中的API选项,然后重新打开开发者 → 应用程序。如果您无法自行开通API,则需要发送邮件给Wayfair管理员申请。
1.2 创建沙盒应用
路径:应用程序→应用程序管理
点击New Application,创建NIWO WMS应用(Description字段不限)→选择Sandbox模式→Save。保存生成的Client ID和Client Secret。
注意: 请记住,此处创建的应用程序为 沙盒 类型 。建议只创建一个 沙盒 类型的应用程序,以避免测试认证时在多个沙盒环境中发生混淆。
2.明确wayfair门店库存管理类型以及需要同步到OMS的订单所属仓库,提供给NIWO WMS客服。
2.1 父级库存管理/父级订单管理
如果你的 Wayfair 账户设置为父库存管理/父订单管理,那么你所有的订单都会属于你的父 SUID。如果你提供你的父 SUID 进行沙盒测试, 系统会获取所有符合要求的订单,不区分仓库。
方法一:点击右上角账户设置—>供应商,查看供应商ID
方法二:开发者—>应用—>API集成状态—>供应商查看供应商ID
2.2 子级库存管理/子级订单管理
如果您的 Wayfair 账户设置为分级库存管理/分级订单管理,那么您的每一个订单都会有独立的仓库 ID,而不是供应商 ID。此时,您 在 Star OMS 中只能将其中一个仓库的订单入库 。因此,请将需要同步到 Star OMS 的子仓库 ID 提供给 Star WMS 客服进行沙盒测试。
获取方式:左侧库存管理=>点击Excel/CSV导出导出库存=>在导出的库存文件中可以看到第一列的供应商ID会被子仓库ID替换。
请参阅 Wayfair 的一段介绍: 当新仓库添加到帐户时,它会被赋予一个唯一 ID,该 ID 与您原来的供应商 ID 不同。当您从外联网导出 Excel/CSV 文件时,新分配的仓库 ID 以及每个仓库中对应已配送的产品将填充到一个新文件中。
仓库 ID 将取代供应商 ID。在以下示例中,供应商提交了一个包含每个仓库中每件商品库存的 Feed。10001 代表一个仓库(以蓝色突出显示),10003 代表另一个仓库(以绿色突出显示)。请注意,一款产品 (TVHM1002) 从两个仓库发货。如果并非所有商品都从所有仓库发货,Wayfair 可以设置仓库例外情况。
3. 沙盒测试
3.1 确认后台是否有新的订单数据可以测试
路径:订单→订单管理
按照图中步骤检查是否有新的可以测试的订单数据,如下图所示。(温馨提示: 只有订单数据处于 New 和 Processing 状态时才能进行订单测试流程 ,否则会返回错误信息:Internal server error)
3.2 向WMS客服提供测试账户信息
将之前获取到的 Client ID( Sandbox 应用的 Clinet ID )、Client Secret( Sandbox 应用的 Client Secret )、Supplier ID 以及可能的仓库 ID(如果需要获取指定仓库的订单)发送给 Leadstar WMS 客服进行 Sandbox 测试。待客服通知测试完成后,登录 Wayfair 进行正式环境对接。
4. 正式环境连接
4.1 确认接口状态
路径:菜单 —> 开发者 —> 供应商集成状态,查看对应的采购订单、发货通知、发货接口。如果状态为 Ready For Production 或 Live,则表示之前的测试流程已通过,可以启用账户权限。如果接口状态仍为 Testing in Progress 或 Not Started,请联系领星WMS客服重新操作对应接口的测试步骤。
当 Status 更新为 Ready For Production 后,即可在正式环境中操作该应用程序。
4.2 创建生产应用程序
路径:应用程序→应用程序管理点击新建应用程序,创建NIWO WMS应用程序(描述输入不限)→选择生产模式—>保存。
将生成的Client ID和Client Secret复制并填入NIWO OMS中。
4.3 启用 API 权限
路径:菜单→开发者→供应商集成状态
选择当前门店账户的供应商ID,点击更新。分别在采购订单\发货通知\发货右侧点击查看/更新。确认应用是刚刚创建的生产应用,将上线状态修改为YES。授权成功后即可正式使用。
当Purchase Order\Ship Notification\Shipping的API Status变为Live时,店铺账户的授权正式完成。
4.4 接口验证
使用生产应用进入后端接口测试工具,验证接口是否可以正常使用,若返回订单数据,则表示应用可以正常上线。
5. NIWO OMS 连接 Wayfair 商店
路径:NIWO OMS-系统设置-平台授权-Wayfair-添加授权-填写授权信息-前往授权
6. 平台SKU与系统SKU之间的产品映射
路径:设置-产品映射-新建/导入
- 在映射产品之前,请确保已在OMS中创建了相应的产品SKU,并且已在Wayfair商店后端添加了供应商零件编号;
- 如果平台SKU是组合品,请填写数量的具体搭配关系,如果是多个SKU的组合,可以点击加号继续添加;
- 商品映射关系与平台门店绑定,若授权多个平台门店,需重新进行商品映射。
点击链接获取有关如何创建产品映射的详细教程: 如何将产品映射到平台 SKU
7.NIWO OMS平台上的订单操作
由于Wayfair同步机制的限制,只有成功链接至Star OMS后产生的新订单才能同步成功。系统每15分钟同步一次门店内符合条件的待处理订单。如需立即查看所有最新订单,需点击【手动同步】按钮进行数据同步。点击链接查看详细操作步骤: 平台订单