1.操作场景
定义:通过OMS系统的平台授权将Wayfair店铺与OMS进行连接绑定,使OMS能够获取Wayfair店铺相关数据和权限,从而实现对店铺订单等业务的统一管理。
作用:将Wayfair店铺后台订单同步至OMS进行管理,可以直接对订单进行审核、提交仓库处理等操作;同时可通过设置平台订单规则实现自动发货,提高订单处理效率,提升整体运营效能。本章将指导您如何在领星OMS授权Wayfair店铺。
2.操作指引
2.1授权前注意事项
(1)抓取的平台SKU:系统同步的Wayfair店铺订单SKU为Supplier Part Number,为保证已同步订单顺利生成一件代发出库单,请提前在Wayfair后台补充对应信息。
(2)在OMS创建SKU:系统不同步平台已创建的产品信息,需客户独立在领星OMS创建SKU,并将系统创建的SKU与Supplier Part Number进行配对。
(3)仅支持平台物流面单:当前仅支持获取Wayfair的平台物流,不支持在领星OMS使用海外仓物流获取面单。订单同步至领星OMS后,分配物流渠道请选择“上传物流面单”或者是其他支持获取平台面单的自定义物流渠道。
(4)仅同步拉取新订单:因Wayfair平台同步机制限制,不支持拉取历史单据,只能同步获取到店铺链接成功之后产生的新订单。
2.2授权步骤
(1)创建sandbox沙盒应用在店铺的常用环境下,进入Wayfair开发者中心:https://partners.wayfair.com/developer/applications,使用Wayfair店铺账号登录。路径:Developer - Applications
若出现该界面:
请打开Account Management - My Account,勾选红框中的API选项后,再重新打开Developer - Applications。如果无法自行开通API,需要向Wayfair管理者发送邮件申请。
点击New Application,创建应用LINGXING WMS(Description输入内容不限 - 选择 Sandbox 模式 - Save,即创建Sandbox沙盒应用)。保存生成的Client ID和Client Secret。路径:Applications → Application Management
(2)明确wayfair店铺库存管理类型和需要同步到OMS的订单所属仓库,提供给领星WMS客服父级库存管理/父级订单管理-Parent-level:如果您的wayfair账号设置为父级库存管理/父级订单管理,那么您的订单都将属于您的父级SUID。则提供您的父级SUID进行沙盒测试,系统会获取所有符合要求的订单,不做仓库区分获取。路径1:右上角Account Setting - Suppliers,查看 Supplier ID。
路径2:Developer - Applications - API Integration Status - supplier,查看Supplier ID。
子级库存管理/子级订单管理-Child Level:如果您的Wayfair账号设置为子级库存管理/子级订单管理,那么您的每个订单会有属于自己的仓库ID,而不是属于Supplier ID,这时候您可以在领星OMS实现只获取其中一个仓库的订单进系统。所以请提供需要同步到领星OMS的一个子仓库ID给领星WMS客服进行沙盒测试。
路径:左侧Inventory management-点击Excel /CSV Export导出库,在导出的库存文件里面,可以看到第一列的Supplier ID将会被子仓库ID代替。
关于该处介绍,请阅读来自Wayfair摘录的一段解释说明:When a new warehouse is added to an account it is given a unique ID, which is different from your orginial Supplier ID. The newly assigned warehouse IDs with the corresponding products that are fulfilled in each warehouse will populate in a new file when you export the excel/csv file from the Extranet.The warehouse ID will replace the Supplier ID. In the example below, a supplier is submitting a feed with the inventory for each item in each warehouse. 10001 is one warehouse (highlighted in blue) and 10003 is another warehouse (highlighted in green). Note that one product (TVHM1002) ships from both warehouses. Wayfair can set up warehouse exceptions if not all items ship out of all warehouses.
(3)Sanbox测试确认后台是否有可测试的新订单数据,只有存在New、Processing状态的订单数据时,才能进行订单测试流程,否则会返回错误提示:Internal server error。路径:Orders - Order Management
将前面获取到的Client ID(Sandbox应用的Clinet ID)、Client Secret(Sandbox应用的Client Secret)和Supplier ID和可能有的warehouse ID(如果需要获取指定仓库的订单)一起发给领星WMS客服做Sanbox测试。待客服通知测试完成后,登录wayfair操作正式环境对接。(4)正式环境对接确认接口状态:在Supplier Integration Status查看对应Purchase Order、ShipNotice、Shipping 接口,如果为 Ready For Production 或者 Live,代表前面的测试流程已通过,可以开启帐号权限;若存在接口状态依旧为 Testing in Progress 或 Not Started,请联系领星WMS客服重新操作对应接口的测试步骤。路径:Menu - Developer - Supplier Integration Status
当Status均更新为Ready For Production,可往下操作正式环境的应用
创建Production正式应用:点击Applications - Application Management - New Application,创建应用LINGXING WMS(Description输入内容不限),选择 Production 模式后保存(Save)。
将生成的Client ID和Client Secret,复制填入领星OMS。
开启API权限:选择当前操作店铺账号的Supplier ID点击Update,分别依次点击Purchase Order\Ship Notice\Shipping 右侧的View/Update,确认Application为刚刚创建的Production应用,将Live in Production状态变更为YES,授权成功以后就可以正式使用了。路径:Menu - Developer - Supplier Integration Status
Purchase Order\Ship Notice\Shipping 的API Status 都变更为Live时,店铺账号的授权正式完成。
接口验证:使用 Production 应用,进入后台接口测试工具,验证接口是否能正常使用。返回了订单数据,则应用可正常启用。
(5)领星OMS连接wayfair店铺路径:领星OMS - 系统设置 - 平台授权 - Wayfair - 添加授权 - 填写授权信息 - 前往授权
(6)将平台SKU与系统SKU进行产品映射路径:设置 - 产品映射 - 新建/导入
3.补充说明
(1)名词解释
- Ready For Production:测试完成
- Live:生效
(2)注意事项
- 创建Sandbox沙盒应用时,建议Sandbox类型的应用只创建一个,避免测试认证中多沙盒环境混乱。
- 产品映射前请确保OMS已创建对应的产品SKU,且Wayfair店铺后台已补充Supplier Part Number;如果平台SKU为组合产品,数量请填写具体配对关系;产品映射关系是与平台店铺进行绑定,若授权了多个平台店铺,都需要重新进行产品映射。
4.常见问题
Q1:如何创建产品配对?
答案:详细教程可以参考链接使用OMS实现产品配对 | 领星WMS帮助中心-卖家版
答案:因Wayfair同步机制限制,只有在领星OMS链接成功以后产生的新订单才能同步成功。系统每15分钟同步一次店铺内符合条件的待处理状态订单,如果需要立刻看到最新的所有订单,需要点击【手动同步】按钮进行数据同步。