概述

SHOPLINE 履约服务商是为商品提供履约发货的角色之一，这类服务商可为商家提供专业的仓配一体物流解决方案（例如 Amazon MCF），支持商家进行商品的多销售渠道管理及履约发货或退换货。

在 SHOPLINE，每一个履约服务商通过履约应用提供服务。商家安装履约应用后，应用会注册成为一个履约服务商，并以履约服务商的角色创建和管理一个专用地点。

地点是指可以履约订单商品的仓库地点。履约应用始终有其自己的地点并且由该履约应用管理，商品应始终从该地点履约发货。

履约应用使用场景和优势​

使用场景​

一般情况下，使用履约应用管理订单发货的场景如下：

• ERP 集中发货：ERP 作为履约应用接入销售平台，商家在 ERP 中集中处理订单和发货，ERP 自动将发货状态同步至平台。
• 专业物流跟踪：商家使用专业的履约应用获取物流跟踪和状态更新能力，提升客户体验。
• 多渠道仓储对接：商家使用了第三方物流仓储的履约应用，将多渠道订单统一至仓储系统，仓库完成发货后由履约应用向各平台回传发货信息。

优势​

履约应用能将商家从复杂的仓库物流管理中解放出来，让商家专注于核心业务（如产品开发、市场营销），从而提升运营效率和客户体验。

履约应用运行机制​

商家通过履约应用关联 SHOPLINE 商家后台所展示的商品与履约服务商仓库中实物商品的对应关系，并在 SHOPLINE 商家后台中将商品的库存地点设置为履约服务地点。商家在履约应用平台管理商品库存，履约应用需要通过 更新地点库存数量 接口同步商品库存至 SHOPLINE。

一笔交易成单后，SHOPLINE 会自动将同一个履约服务地点的商品关联在同一个履约单中，并通过请求发货的方式通知履约应用对商品发货。履约应用只需处理该地点关联的履约单中的商品即可。

以下为履约应用发货流程图：

• 商家：客户下单后，商家可根据实际情况调整原订单商品，然后向履约应用请求履约发货。另外，若商家请求履约发货后想取消发货，可向履约应用请求取消履约发货。
• 履约应用：履约应用在接收到履约发货请求后可同意或拒绝请求发货。若履约应用同意发货，商品将打包并配送给客户。若商家在履约应用同意发货后请求取消发货，履约应用可根据物流情况决定是否同意取消，例如仓库尚未进行相关作业时，则可以同意取消发货。若履约应用拒绝取消发货，发货流程继续执行。
• 第三方物流：履约应用同意履约发货请求后，履约服务商仓库将商品打包并交由第三方物流配送给客户。
• 客户：签收物流送到的商品。

履约应用相关权限要求​

• 你的应用已完成 应用授权 流程，并获得访问 REST API 的权限。
• 你的应用具有 write_fulfillment_service、read_assigned_fulfillment_orders、write_assigned_fulfillment_orders 访问权限。有关在安装应用时请求访问权限的更多信息，参阅 权限点列表。

履约服务商管理相关接口​

履约服务商​

商家安装某个履约应用时，该应用会调用 创建履约服务 接口为商家创建一个履约服务商角色。

接口示例：

• POST：https://{handle}.myshopline.com/admin/openapi/v20260301/fulfillment_service.json
• 请求体：

{
  "name": "MCF test"
}

• 响应体：

{
  "fulfillment_service": {
    "name": "MCF test",
    "id": "4106281043992999650327",
    "location_id": "6255171172604321136"
  }
}

商家可通过 修改履约服务 和 删除履约服务 接口更新和删除现有的履约服务商角色。

履约服务商相关接口如下：

履约服务地点​

履约服务创建完成后，履约应用调用 创建履约服务地点 接口来创建该履约服务商唯一一个专用地点。该地点仅能由商家通过履约服务商角色进行管理。

接口示例：

• POST：https://{handle}.myshopline.com/admin/openapi/v20260301/fulfillment_service_location/create.json
• 请求体：

{
  "location": {
    "name": "MCF-location",
    "phone_code": null,
    "phone": "13322221111",
    "country_code": "SG",
    "country": "Singapore",
    "province_code": "",
    "province": "",
    "city_code": "",
    "city": "",
    "district_code": "",
    "district": "",
    "address1": "1874 prospect valley road",
    "address2": "",
    "zip": "999000"
  }
}

• 响应体：

{
  "zip": "999000",
  "country": "Singapore",
  "legacy": true,
  "address2": "",
  "city": "",
  "address1": "1874 prospect valley road",
  "active": true,
  "create_at": "2024-01-08T18:20:55+08:00",
  "is_default": false,
  "province_code": "",
  "country_code": "SG",
  "province": "",
  "update_at": "2024-01-08T18:20:55+08:00",
  "phone": "13322221111",
  "name": "MCF-location",
  "id": "6281073353496741086",
  "phone_code": null
}

履约服务专用地点是商家在第三方仓配系统中管理库存所需的最核心要素。商家管理商品库存时，选择某个履约应用的专用地点后，该地点处的商品库存数据将直接从该履约应用同步至 SHOPLINE。商家切换地点前，需处理好当前地点的库存，确保库存数据完整。

更多参考​

关于履约服务商如何通过应用进行履约发货，参考 发货流程。