Fulfillment业务

这里讲解在OMS系统授权后，Linnworks系统中需要如何配置才能和OMS系统实现对接，接收出库订单，处理仓发履约业务。
## 安装APP
方法1：点击下面链接，输入账号和密码进行授权，安装“Fulfillment By GRL”APP。
https://apps.linnworks.net/Authorization/Authorize/61f2359e-3be7-44f7-90d3-8a6987715666
![](/media/202308/2023-08-01_111404_239640.png)
录入账号密码进入，选择版本0.0.1，点击“Install”安装。
![](/media/202310/2023-10-19_104816_018512.png)
看到下面界面，安装成功。
![](/media/202308/2023-08-01_111435_046160.png)
方法2：按照下图路径，进入APP Store，查找到“Fulfillment By GRL”，点击“Install”按钮，安装GRL仓发履约业务的APP：
![](/media/202308/2023-08-01_100833_042726.png)
## 使用APP
### 进入APP
APP安装成功后刷新系统，就可以在APP菜单，找到“Fulfillment By GRL”，点击进入操作页面。
![](/media/202308/2023-08-01_111730_545993.png)
## 设置APP
### 设置—基础设置
主要配置Token、自动同步发货状态开关、自动同步库存开关、标记发货节点配置。具体参考下图及图下面的详细说明。
![](/media/202606/2026-06-29_101233_083311.png)
**Linnworks Token：**前面安装APP后获取到的Token，这个是Linnworks和GRL系统数据交换的凭证，一定要正确。
**Auto Sync Status：**是否自动同步出库单的发货状态并设置同步频率，如果选择NO，不同步GRL系统中订单的发货状态，如果选择其他选项，系统会根据选择的时间定时自动查询GRL系统中订单的状态并更新到Linnworks中。出库单创建成功即为“Outbound”状态，GRL出库完成即为“Complete”状态。建议配置12或24小时。
**Auto Sync Stock：**是否自动同步SKU库存到Linnworks，如果选择NO，不自动同步，如果选择其他选项，系统根据选择的时间定时查询SKU在GRL系统的库存并更新到Linnworks中。==注意仓库映射一定要配置，两边SKU一定要一致，不然同步库存会失败==。建议配置5天。
**Mark Fulfillment：**标记发货的操作节点，一共有两个选项：Shipped out from warehouse-GRL仓库发货完成标记发货；Once the waybill is obtained-获取到尾程运单就标记发货。正常情况下GRL收到出库订单就请求尾程服务商换取跟踪单号和物流面单。
### 设置-账号设置
这里设置在GRL申请的账号信息。如下图，打开Setting窗口，点击“Account”选项卡，就可以维护GRL系统的授权信息，GRL的授权信息可以在OMS系统申请，具体请参考《[开发者信息](https://help.wlwytech.com/project-8/doc-234/ "开发者信息")》。
如果在GRL有多个账号，可维护多个账号，账号的Name自定义，可以命名一个简短的易区分的。
![](/media/202606/2026-06-29_103725_058056.png)
### 设置-仓库映射
Setting窗口中切换到“Location Mapping”界面，建立您在Linnworks系统中的Location和GRL系统中的仓库的映射关系。
Account Name就是上面账号设置中维护的账号名字，选择后系统会用选择的Account请求GRL接口获取该账号在GRL的可用仓库(最后一列 Warehouse of Supplier)，选择后建立Linnworks和GRL仓库的映射关系。
![](/media/202606/2026-06-29_104414_398373.png)
### 设置-自动推单
当订单通过“Move Location”把订单分配到GRL的仓库(有映射GRL仓库的Locaiont)后，APP支持根据这里设置的设置自动推送订单到GRL系统生成出库单。
如下图，可以配置自动推送订单的频率(建议设置1小时)，设置后下面显示上次和下次推单任务执行的时间。
下面表格中可以根据订单的目的地国家指定要从哪个仓库发货，发送哪个物流渠道。配置完成后系统就会根据配置的频率执行任务，根据表格中配置的国家和发货仓库找到物流方式，符合条件的订单按照配置的物流方式推送到GRL系统生成出库单。
自动退单是系统定时任务异步排队执行。如不需要可不配置(Auto Push Order配置为NO)。
![](/media/202606/2026-06-29_105149_037542.png)
## 处理订单
### 订单分仓
如下图，在OpenOrders界面把要从GRL仓库发货的订单Move到对应的仓库下面。
![](/media/202607/2026-07-27_180258_674570.png)
### 推送订单
切换到对应的仓库，在“OpenOrders”页签您就会发现所切换的仓库下所有待处理的订单。选择订单，点击“Push”按钮，APP会异步调GRL的API接口创建出库单。
![](/media/202308/2023-08-01_113139_685558.png)
点击“Push”后弹出选择物流产品界面，选择您需要的产品并点击弹窗中的“Puch”。
![](/media/202308/2023-08-08_094629_547160.png)
创建中的订单您可以在“Pushing”页签看到，推送失败的您可以在“PushFail”页签看到，推送成功创建了出库单的您可以在Outbound中看到。
**一旦开始推送的订单会被Locked**，展示在“Pushing”中，不可进行任何操作。
![](/media/202308/2023-08-01_113808_362610.png)
### 订单重推
“PushFail”页签中推送失败的订单可以点击“Retry”重新推送订单，重推后将会再次出现在Pushing队列。
您可以在“Fail Msg”列查看推送失败的原因。根据原因解决问题后重新推送。
![](/media/202606/2026-06-29_110633_388827.png)
### 取消
推送失败的订单可以取消，如下图，点击取消后订单将会重新回到OpenOrders中。
![](/media/202308/2023-08-01_114252_887708.png)
推送成功，已经创建出库单的也可以申请取消(如下图)，此时取消APP会请求GRL的取消出库单接口，GRL允许取消APP才会取消成功，重新回到OpenOrders中。GRL不允许取消的会有提醒。
![](/media/202308/2023-08-01_114438_565845.png)
**重回OpenOrders的订单会被Unlocked**。
### 同步出库状态
成功创建出库单的可以手工点击“Sync Status”按钮，APP会请求GRL系统获取出库单的最新发货状态。
如果已经出库，会获取跟踪单号并变更状态展示在“Complete”中。**订单在Linnwoks的状态也会变更为Processed。**
也可能有了跟踪单号，但是还没出库，订单仍然在“Outbound”中。
![](/media/202606/2026-06-29_110943_502823.png)
上面基础设置中Auto Sync Status参数配置了同步频率的，系统会定时从GRL同步跟踪单号和出库状态。具体请见上面基础配置部分说明。
## 库存同步
选择需要同步库存的仓库(必须已经配置过仓库映射关系的，具体请见上面仓库映射)，点击同步库存图标，系统会异步同步库存到Linnworks系统。
同步逻辑：用Linnworks中的所有SKU每个100个向GRL查询在库库存，查到的就更新到Linnworks中当前仓库的库存中。没有查到的不更新。
同步进度会在“StockSyncHistory”列表中展示，每同步一次一行主数据。每次同步的主数据行可以展开查询失败成功情况，明细中一行代表100个SKU的一次请求，如果100个SKU有一个更新成功，则该请求行状态为成功；一个SKU的库存都没查到，则标记为失败。
![](/media/202311/2023-11-03_140058_769455.png)
## 常见问题
### Fulfillment By GRL界面操作时提醒“Token has expired”
解决方案：关闭当前页面重新打开或者通过浏览器的刷新功能，刷新当前页面。
发生原因：Linnworks的规则是授权信息半小时过期，如果超过半小时没有操作就要刷新页面重新获取授权。
### 订单SKU和仓库SKU不一样怎么办？
**问题描述：**订单销售的SKU是SKU001+002，GRL系统只有SKU001和SKU002，实际1个SKU001+002要发1个SKU001和1个SKU002，怎么操作？
解决方案：
步骤一：客户属性中开通SKU映射
![](/media/202606/2026-06-29_112008_282948.png)
步骤二：客户在OMS中维护平台SKU(SKU001+002)和实际要发货的SKU（SKU001和SKU002）的关系。
![](/media/202606/2026-06-29_112014_633389.png)
上面两步完成后Linnworks推送过来的SKU001+002就会根据SKU的映射关系直接转换为SKU001和SKU002下单发货了。