概述

销售渠道应用（Sales Channel App）是一种特殊类型的应用，用于将销售渠道（如 Amazon、eBay 或自研应用）接入 SHOPLINE 商家后台，实现订单、商品与履约流程的统一管理。

应用能力​

销售渠道应用面向在线商店之外的售卖场景。通过销售渠道应用，你可以实现以下能力：

• 接入多渠道触点：将外部平台（如 Amazon、eBay、Shopee、Facebook Marketplace 等）或商家自研触点（如移动端应用）作为目标平台接入。

• 统一订单履约：在 SHOPLINE 商家后台统一展示销售渠道的订单，并以一致方式完成履约。

• 同步商品清单：在 SHOPLINE 商家后台管理已发布到销售渠道的商品清单。

• 授权账号集成：通过 OAuth 2.0 进行安全认证并绑定销售渠道账号，以实现跨平台数据共享。

销售渠道类型​

销售渠道应用支持接入的销售渠道通常包含以下几类：

典型集成流程​

销售渠道应用从安装到产生订单，整体集成与业务流程如下：

graph LR
    A[商家安装应用] --> B[商家完成授权]
    B --> C[应用提示商家完成外部渠道账号绑定]
    C --> D{需要满足更多要求？}
    D -->|是| E[应用满足更多销售渠道要求]
    subgraph COL[" "]
        direction TB
        F[销售渠道就绪] --> G[商家发布商品到销售渠道]
        G --> H[应用创建订单与商家履约]
    end
    D -->|否| F
    classDef node fill:#1C212D,stroke:#111111,stroke-width:1px,color:#FFFFFF
    class A,B,C,D,E,F,G,H node
    style COL fill:none,stroke:none
    linkStyle default stroke:#111111,stroke-width:1.5px

1. 应用安装与授权：商家在 SHOPLINE 应用市场安装应用并完成 OAuth 2.0 授权。参考 应用授权。

2. 渠道账号连接：应用引导商家绑定销售渠道账户（如 Shopee）。若商家尚未注册，应用需引导商家在销售渠道页面完成注册。

3. 资质审核与配置：若目标平台要求资质审核，应用应在界面中提示商家补充信息或等待审批结果。

4. 商品发布与同步：商家将商品发布至销售渠道，应用读取商品清单，并通过 销售渠道商品增加 webhook 事件保持数据同步。

5. 订单同步与履约：销售渠道产生订单后，应用调用 创建订单 接口将数据写入 SHOPLINE 商家后台，由商家统一完成履约。

创建和管理结账​

销售渠道应用可使用以下两种方式创建结账对象并获取结账链接：

购物车永久链接​

链接基本格式如下：

https://{handle}.myshopline.com/cart/{sku_id}:{quantity},{sku_id}:{quantity}

除商品信息外，还可以通过 ? 在 URL 末尾追加可选查询参数，用以预填客户信息或应用优惠，如结账邮箱（checkout[email]）和折扣码（discount={discount_code}）。完整的购物车永久链接字段与示例见 购物车永久链接。

Storefront API​

应用调用 checkoutCreate mutation 接口创建结账对象，从响应中读取 checkoutUrl。调用该接口前，应用需要具有 unauthenticated_write_checkouts_info 权限。也可以通过 cart 对象获取已有购物车的 checkoutUrl。

应用要求​

销售渠道应用需同时满足下表中的应用通用规范和销售渠道要求。