SHOPLINE API 功能更新​

2025 年 11 月​

折扣与营销管理​

• 折扣项目字段更新：在 Admin GraphQL API 中，以下对象里的 collections、productVariants、products 字段，如果没有数据，过去会返回 null。从 2025 年 12 月 10 日起，这些字段将统一改为返回空数组[]。受影响的对象包括：
  • DiscountCodeBasic
  • DiscountCodeBxgy
  • DiscountAutomaticBasic
  • DiscountAutomaticBxgy
  • DiscountAutomaticPfnt
  • DiscountAutomaticDoni
  • DiscountAutomaticDoli

订单管理​

• 退货单状态更新：从 2025 年 12 月 15 日起，退货单将新增 cancelled（已取消）状态，支持取消退货单。退货单被取消后，原本在该退货单里的商品可以再次发起退货流程。

SHOPLINE Payments​

• Webhook 更新：新增 争议创建 与 争议更新 兩个事件，方便你更及时掌握争议相关信息。

2025 年 8 月​

订单管理​

• 订单归因信息查询：你现在可以通过 Admin Rest API 批量查询订单归因信息，方便你快速了解每个订单的来源和归因详情。

SHOPLINE Payments​

• 店铺提款记录查询：为了提升性能和体验，如果你正在使用 查询店铺提款记录 获取数据 ，请尽快将 API 版本升级到 v20250601 或更高版本。旧版本将在后续停止支持，届时将无法继续使用。

2025 年 7 月​

订单管理​

• 订单与草稿单字段更新：以下 Admin REST API 与 Webhook 收货地址及账单地址中，新增 standard_province_code 字段，该字段采用 ISO 3166-2 标准编码。
  • 订单相关 API
    • 查询订单
    • 更新订单
    • 取消订单
    • 批量查询弃单
  • 草稿单相关 API
    • 创建草稿单
    • 编辑草稿单
    • 查询草稿单
    • 完成草稿单
  • 订单相关 Webhook
    • 订单支付成功
    • 订单更新
    • 订单取消
    • 订单全部发货
    • 订单部分发货
    • 订单编辑

API 版本管理更新​

• 废弃接口预告：以下元字段 API 将停止使用，若你正在使用这些 API，请尽快迁移至替代接口，以确保业务的稳定运行。
  • 新增二级元字段
  • 更新元字段资源
  • 删除二级元字段资源
  • 分页查询二级元字段资源
  • 查询元字段资源详情
  • 查询二级元字段数量

2025 年 6 月​

商品管理​

• Webhook 更新：新增分类树 节点创建、节点删除 与 节点更新 三个事件，帮助你更高效地管理分类结构。
• 分类树节点查询：Storefront API 新增 分类树节点查询 功能，支持根据指定分类节点 ID 查询节点详细信息。

营销管理​

• Webhook 更新：新增 折扣活动规则更新、折扣活动规则创建 与 折扣码新增 三个事件，帮助你提升折扣活动管理效率。

API 版本管理更新​

• v20251201 版本发布：API 新版本 v20251201 已正式发布，原版本 v20250601 已调整为候选版本。详情请参阅 API 版本管理说明。
• 废弃字段通知：自 v20250601 版本起，以下 API 的部分字段已不再使用，请及时调整以确保服务稳定运行。
  • 获取订单下的所有发货单
  • 订单更新运单号
  • 更新发货单追踪信息
  • 为履约单创建发货单（单个或批量）

2025 年 5 月​

商品管理​

• 媒体资源上传：Admin REST API 新增 初始化分段文件上传任务，用于获取媒体文件上传所需的 URL 和参数，帮助你更安全、高效地完成本地文件上传。
• 文件字段更新：以下文件字段已进行了扩展和优化。content_type 字段支持所有类型的文件、original_source 字段支持使用分段上传的 URL。
  • 创建文件
  • 查看单个文件
  • 批量查询文件
• 分类树管理：Admin REST API 新增以下分类树节点新增、删除、修改及查询功能，帮助你更高效地管理商品分类，提升消费者的购物体验：
  • 创建分类节点
  • 更新分类节点
  • 查询分类节点
  • 批量查询子分类节点
  • 删除分类节点
  • 查询店铺分类结构

订单管理​

• 订单查询优化：Admin REST API 查询订单 时，响应体中新增 channel_refund_id 字段，便于你根据渠道退款 ID 进行对账处理。

元字段管理​

• 元字段查询：Storefront API 新增 元字段查询 功能，让你可以更方便地获取商品相关的元字段信息。

履约管理​

• Webhook 优化：在 履约单创建 及 履约单更新 事件中，Webhook 回调新增 service_code、shipping_rate_name 及 shipping_strategy_name 字段。

开发文档优化​

• 文档 URL 优化：开发文档的 URL 结构已优化，现在可以通过 URL 清晰识别对应功能，提升可读性。旧的 URL 仍可正常访问。

2025 年 3 月​

顾客管理​

• 顾客信息查询：Admin REST API 在 通过邮件查询顾客信息、查询顾客地址详情2.0 以及 批量查询客户地址2.0 的响应体中，新增字段 provinceCode_V2，该字段采用 ISO-3166-2 标准的两位省份编码缩写。

交易管理​

• Webhook 更新：新增 结账支付单创建 与 结账支付单更新 两个事件，帮助你实时掌握交易动态，提升支付管理效率。

API 版本管理更新​

• 私有应用 Webhook 订阅规则更新：自 2025 年 4 月底起，SHOPLINE 商家后台将仅支持私有应用订阅 v20240601 及以上版本的 Webhook。现有订阅可继续使用，但修改维护时需要遵循新的规则。请务必确保后续新增或修改的订阅使用符合要求的版本。

2025 年 2 月​

SHOPLINE Payments​

• 店铺交易记录查询：你现在可以通过 Admin REST API 查询店铺交易记录，包括支付、退款和争议等信息，帮助你更全面地掌握交易情况。

Admin REST API​

• 新增错误代码 Code 字段：预计从 2025 年 3 月底开始，Admin REST API 在发生调用异常时，响应体将新增 Code 字段，让你能更精准地识别错误代码和相关信息。

2025 年 1 月​

订单管理​

• 订单创建：Admin REST API 创建订单 请求体中新增 company_location_id 字段，让你在建立 B2B 订单时可以指定公司地点 ID。

顾客管理​

• 黑名单管理：你现在可以通过 Admin REST API 将客户加入黑名单 或 从黑名单中删除客户。

SHOPLINE Payments​

• 帐单记录查询：Admin REST API 查询账单记录 响应体中新增 exchange_rate、settlement_amount 及 settlement_currency 字段，协助你获取更全面的帐单信息。

尺码表应用​

• 尺码表管理优化：Admin REST API 创建尺码、更新尺码 及 批量查询尺码，新增 languages 和 tabs 字段，提升你在管理尺码数据时的灵活性。

2024 年 12 月​

商品管理​

• 自定义 URL 查询：以下 Admin REST API 响应体中新增 path 字段，你可以查询其页面的自定义 URL 路径。

  • 批量查询商品

  • 查询单个商品

  • 查询某个分类下商品信息

  • 根据id查询分类信息

  • 根据id查询手动分类属性

  • 根据id查询智能分类属性

  • 批量查询手动分类

  • 批量查询智能分类

2024 年 11 月​

市场管理​

• 产品列表管理：你现在可以通过 Admin REST API 获取市场包含的产品、在市场中添加产品，以及 在市场中排除产品。

本地化管理​

• 店铺可用语言查询：你现在可以通过 Admin REST API 和 Admin GraphQL API 查询店铺目前支持的语言列表（包括正在使用和未使用的语言）。你可以基于此数据，配置应用开发的语言范围。

UGC多语言可视化翻译应用​

• 语料字段类型查询：你现在可以通过 Admin REST API 查询店铺翻译语料，并对字段类型进行过滤使用。

2024 年 10 月​

店铺管理​

• 员工信息查询：若你使用 Enterprise 套餐，现在可以通过 Admin GraphQL API 查询 店铺员工信息。

会员系统插件​

• Webhook 事件更新：若你使用会员系统插件 Pro Plan，现在可以通过 Webhook 接收以下事件的实时更新：

  • 礼品卡更新

  • 付费会员更新

  • 用户购物金更新

  • 会员积分更新

  • 会员等级更新

  • 成功邀请

2024 年 9 月​

店铺管理​

• 日志存取：你现在可以操作日志存取

  • 查询店铺操作日志列表

  • 查询店铺单条操作日志

  • 查询店铺操作日志总数

2024 年 8 月​

店铺管理​

• 员工信息查询：若你使用 Enterprise 套餐，现在可以通过 Admin REST API 查询店铺指定 员工信息。

订单管理​

• 采购订单号查询：你现在可以通过 Admin REST API 查询 B2B 订单 和 B2B 草稿单 关联的采购订单号。

• Webhook 优化：订单 Webhook 和 草稿单 Webhook 新增采购订单号字段，提供更全面的订单数据。

商品管理​

• 货币代码灵活性：你现在可以使用 货币代码字段 为其 B2B 公司位置目录配置产品价格币种。

• Webhook 优化：目录 Webhook 新增货币代码字段，提供有关商品定价和货币偏好的详细信息。