微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # 商品管理

    # 开发前准备

    # 商品数据模型

    商品存在草稿数据和线上数据两份数据，理解这个模型是使用商品管理接口的前提。

    # 两份数据的关系

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["[API] 添加商品<br/>addproduct"] -->|写入| B[草稿数据<br/>edit_product] C["[API] 更新商品<br/>updateproduct"] -->|写入| B B -->|提交审核| D{审核} D -->|通过 + 上架| E[线上数据<br/>product] D -->|不通过| B style B fill:#ffffff,stroke:#0ab8a6,color:#666666 style D fill:#ffffff,stroke:#0ab8a6,color:#666666 style E fill:#ffffff,stroke:#0ab8a6,color:#666666

    调用 [API] 添加商品 / addproduct 和 [API] 更新商品 / updateproduct 修改的都是草稿数据，只有审核通过并上架后，草稿数据才会覆盖线上数据正式生效。

    # 两份数据对比

    对比项 草稿数据（edit_product） 线上数据（product）
    含义 商家正在编辑、尚未生效的数据 当前在店铺中实际生效、用户可见的数据
    写入时机 调用添加商品 / addproduct 或更新商品 / updateproduct 时写入 ① 审核通过 + 上架后，草稿覆盖线上；② 调用免审更新商品 / updateproductauditfree 直接写入
    状态字段 edit_status（编辑状态） status（商品线上状态）
    存在条件 商品有未发布的编辑内容 商品曾经上架过

    # 草稿状态（edit_status）

    值 状态 说明
    0 初始值 刚创建
    1 编辑中 商家正在修改
    2 审核中 已提交等待审核
    3 审核失败 需修改后重新提交
    4 审核成功 可上架
    7 上传中 商品异步提交中，此时调用上架接口会返回错误码 10020067
    8 上传失败 请重新提交

    # 线上状态（status）

    值 状态 说明
    5 上架 正常售卖中
    11 自主下架 商家主动下架
    12 售罄下架 库存售罄自动下架
    13 违规下架 平台风控/违规下架
    14 保证金不足下架 店铺保证金不足导致下架
    15 品牌过期下架 品牌资质过期导致下架
    20 封禁 严重违规被封禁

    # 查询数据时如何区分

    通过 [API] 获取商品 / getproduct 的 data_type 参数控制：

    data_type 返回内容 使用场景
    1（默认） 仅返回 product（线上数据） 查看当前在售信息
    2 仅返回 edit_product（草稿数据） 查看编辑进度和审核状态
    3 同时返回 product + edit_product 对比线上版本和草稿版本

    从未上架过的商品没有线上数据，data_type=1 或 3 时不会返回 product 字段。

    # 接入流程

    # 阶段一：商品发品流程

    发品流程分为前置准备、数据组装、提交审核上架三个环节。

    # 1-1 前置准备：资质配置、校验与获取发布规则

    发品前需完成运费模板、退货地址、品牌资质、类目权限的申请，然后进行发品前校验并获取发布规则。

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["[API] 申请类目<br/>addcategory<br/>→ cat_id"] --> B[前置配置就绪] C["[API] 增加运费模板<br/>addfreighttemplate<br/>→ template_id"] --> B D["[API] 添加地址<br/>addaddress<br/>→ address_id"] --> B E["[API] 新增品牌资质<br/>addbrand<br/>→ brand_id"] --> B B --> F["[API] 发品前校验<br/>categoryprecheck<br/>→ 店铺权限 + 类目权限<br/>+ 保证金 + 运费险"] F --> G{校验通过?} G -- 是 --> H["[API] 获取类目下商品发布规则<br/>getcategoryproductrule<br/>→ 属性 / 资质 / 尺码表 / 价格下限"] G -- 否 --> I{失败原因} I -- 无类目权限 --> A I -- 保证金不足 --> J[补缴保证金] I -- 需开通运费险 --> K[开通运费险] style B fill:#ffffff,stroke:#0ab8a6,color:#666666 style G fill:#ffffff,stroke:#0ab8a6,color:#666666 style I fill:#ffffff,stroke:#0ab8a6,color:#666666 style J fill:#ffffff,stroke:#0ab8a6,color:#666666 style K fill:#ffffff,stroke:#0ab8a6,color:#666666

    以上接口分属类目管理、物流发货、品牌资质等模块，产出的 ID 将在 [API] 添加商品 / addproduct 中使用：

    • template_id → express_info 参数
    • address_id → after_sale_info 参数
    • brand_id → brand_id 参数
    • cat_id → cats 参数

    [API] 发品前校验 / categoryprecheck 用于校验店铺和类目权限；校验通过后，调用 [API] 获取类目下商品发布规则 / getcategoryproductrule 获取类目的发布规则（product_attr_list、sale_attr_list、product_qua_list、size_chart、floor_price 等），用于动态构建商品发布表单。

    # 1-2 数据组装：获取发品所需数据

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["[API] 上传图片<br/>img_upload<br/>→ media_id"] --> B["[API] 上传头图视频（可选）<br/>→ video_url"] B --> C["[API] 类目推荐<br/>product_classify<br/>→ 推荐类目 + 错挂检查"] C --> D["[API] 获取品牌库列表<br/>getallbrandslogic<br/>→ brand_id"] D --> E["[API] 获取运费模板列表<br/>getfreighttemplatelist<br/>→ template_id"] E --> F["[API] 获取地址列表<br/>getaddresslist<br/>→ address_id"]
    # 上传头图视频（可选）

    商品支持在主图区域展示一个视频（即「头图视频」），视频上传需要通过以下 3 个 API 分步完成：

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["① [API] 申请上传视频<br/>video_initupload<br/>→ video_upload_key"] --> B["② [API] 上传视频数据分块<br/>video_uploadpart<br/>（1~2MB/块，支持并发）"] B --> C["③ [API] 完成视频上传<br/>video_finishupload"] C --> D["④ [API] 获取视频播放信息<br/>video_getplayinfo<br/>→ video_url"] style D fill:#ffffff,stroke:#0ab8a6,color:#666666

    流程说明：

    1. 调用 [API] 申请上传视频 / video_initupload，传入视频文件名和大小，获取 video_upload_key
    2. 将视频文件切分为 1MB~2MB 的分块，调用 [API] 上传视频数据分块 / video_uploadpart 逐块上传（支持并发上传），每块需携带 video_upload_key、part_number（从 1 开始）和对应的分块数据
    3. 所有分块上传完成后，调用 [API] 完成视频上传 / video_finishupload 通知服务端合并视频
    4. 轮询调用 [API] 获取视频播放信息 / video_getplayinfo，等待视频转码完成后即可获取到 video_url，用于填入 [API] 添加商品 / addproduct / [API] 更新商品 / updateproduct 的 head_videos 字段

    注意：[API] 获取视频播放信息 / video_getplayinfo 返回的 video_url 是临时地址，仅用于传入发品/更新接口，不可直接作为播放地址持久化存储。

    # 1-3 数据组装：属性映射（ISV/跨平台场景）

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A[站外商品数据] --> B["[API] 站内外商品属性映射<br/>externalproductmapping<br/>→ attr_key / attr_value"] A --> C["[API] 商品属性映射及推荐<br/>externalproductmappingnew<br/>→ 属性推荐"] A --> D["[API] 商品品牌推荐<br/>productbrandrecommend<br/>→ brand_id"] B --> E["组装添加商品 / addproduct 参数"] C --> E D --> E style A fill:#ffffff,stroke:#0ab8a6,color:#666666 style E fill:#ffffff,stroke:#0ab8a6,color:#666666

    此步骤主要面向 ISV 服务商或跨平台搬品场景，自研商家直接填写属性即可跳过。

    # 1-4 提交发品与审核上架

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["[API] 添加商品<br/>addproduct<br/>→ product_id"] --> B{上架审核} B -- 审核通过 --> C["[事件] 商品审核<br/>product_spu_audit<br/>status=3"] B -- 审核不通过 --> D["[事件] 商品审核<br/>product_spu_audit<br/>status=2"] C --> E["[API] 上架商品<br/>listingproduct"] E --> F[商品上架完成] D --> G["[API] 获取商品<br/>getproduct<br/>查看审核原因"] G --> H["[API] 更新商品<br/>updateproduct"] H --> B B -- 撤回审核 --> I["[API] 撤回商品审核<br/>cancelauditproduct"] style B fill:#ffffff,stroke:#0ab8a6,color:#666666 style F fill:#ffffff,stroke:#0ab8a6,color:#666666

    [API] 添加商品 / addproduct 提交后商品进入审核，通过 [事件] 商品审核 / product_spu_audit 事件通知获取审核结果。审核通过后需主动调用 [API] 上架商品 / listingproduct 上架（也可通过 [API] 设置商品上架策略 / setproductauditstrategy 配置审核通过后自动上架）。审核不通过时，可通过 [API] 获取商品 / getproduct 查看 audit_info 中的审核原因。

    # 阶段二：商品日常管理流程

    # 2-1 商品信息更新

    商品更新有两个接口，作用于不同的数据层：

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A[已上架商品] --> B{更新方式} B -- 需审核更新 --> C["[API] 更新商品<br/>updateproduct<br/>写入草稿数据"] C --> D["[事件] 商品审核<br/>product_spu_audit"] D -- 通过 --> E[草稿覆盖线上<br/>更新生效] D -- 不通过 --> F[查看原因并修改] B -- 免审更新 --> G["[API] 免审更新商品<br/>updateproductauditfree<br/>直接更新线上数据"] G --> H[立即生效] style A fill:#ffffff,stroke:#0ab8a6,color:#666666 style B fill:#ffffff,stroke:#0ab8a6,color:#666666 style E fill:#ffffff,stroke:#0ab8a6,color:#666666 style F fill:#ffffff,stroke:#0ab8a6,color:#666666 style H fill:#ffffff,stroke:#0ab8a6,color:#666666

    两个更新接口的区别：

    对比项 [API] 更新商品 / updateproduct [API] 免审更新商品 / updateproductauditfree
    作用数据 草稿数据（edit_product） 线上数据（product）
    是否审核 必须审核，通过后草稿覆盖线上 不需要审核，直接生效
    适用状态 所有状态的商品 仅已上架商品
    可更新范围 所有字段（标题/图片/类目/SKU等） 有限字段（价格/库存/运费/限购/预售/售后地址/额外服务等）
    写入方式 覆盖写（未传的 SKU 会被删除） 覆盖更新（缺省字段不处理）
    提示 可设置 listing=1 自动提交审核 仅更新库存时建议用 [API] 快速更新库存 / updatestock

    # 2-2 商品上下架与删除

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A[已上架商品] --> B["[API] 下架商品<br/>delistingproduct"] B --> C[未上架状态] C --> D["[API] 上架商品<br/>listingproduct"] D --> A C --> E["[API] 删除商品<br/>deleteproduct"] A --> F["[API] 商品立即开售<br/>begintimingsale"] A --> G["[API] 取消商品开售<br/>canceltimingsale"] style A fill:#ffffff,stroke:#0ab8a6,color:#666666 style C fill:#ffffff,stroke:#0ab8a6,color:#666666

    下架后商品进入「未上架」状态，可重新上架。商品开售/取消开售用于控制定时上架场景。[事件] 商品上下架 / product_spu_listing 会推送上下架状态变更（status: 5-上架, 11-自主下架, 13-系统下架）。

    # 2-3 商品查询与提审管理

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A[商品查询] --> B["[API] 获取商品<br/>getproduct"] A --> C["[API] 获取商品列表<br/>getproductlist"] D[提审管理] --> E["[API] 获取商品提审限额<br/>getauditquota"] D --> F["[API] 获取商品上架策略<br/>getproductauditstrategy"] F --> G["[API] 设置商品上架策略<br/>setproductauditstrategy<br/>审核通过后自动上架"] style A fill:#ffffff,stroke:#0ab8a6,color:#666666 style D fill:#ffffff,stroke:#0ab8a6,color:#666666

    # 阶段三：库存管理流程

    库存管理涉及通用库存和区域仓库库存两套体系，内容较复杂，已独立整理到库存管理开发指南中。

    详见：库存管理 - 开发指南

    # 阶段四：赠品与买赠活动流程

    # 4-1 添加非卖商品（赠品）

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["[API] 上传图片<br/>img_upload"] --> B["[API] 获取所有类目<br/>getallcategory<br/>筛选非卖商品可用类目"] B --> C["[API] 获取类目信息<br/>getcategorydetail<br/>→ attrs 必填属性"] C --> D["[API] 添加非卖商品<br/>addgiftproduct<br/>→ product_id"] D --> E{审核} E -- 通过 --> F["[API] 上架商品<br/>listingproduct"] F --> G[赠品上架完成] E -- 不通过 --> H[修改后重新提交] style E fill:#ffffff,stroke:#0ab8a6,color:#666666 style G fill:#ffffff,stroke:#0ab8a6,color:#666666 style H fill:#ffffff,stroke:#0ab8a6,color:#666666

    非卖商品的类目必须在 [API] 获取所有类目 / getallcategory 返回的可用范围内，超出范围的类目不支持添加为非卖商品。

    # 4-2 在售商品转赠品 + 赠品管理

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["[API] 在售商品转赠品<br/>setproductasgift<br/>→ 非卖商品ID列表"] --> B[赠品就绪] C["[API] 获取赠品列表<br/>getgiftproductlist"] --> D["[API] 获取赠品<br/>getgiftproduct"] D --> E["[API] 更新非卖商品<br/>updategiftproduct"] D --> F["[API] 更新赠品库存<br/>updategiftstock<br/>diff_type: 增加/减少"] style B fill:#ffffff,stroke:#0ab8a6,color:#666666

    同一个在售商品只能被设置为一次非卖商品（转换不可重复）。

    # 4-3 买赠活动管理

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["[API] 创建赠品活动<br/>addgiftactivity<br/>关联 gift_id = 非卖商品 product_id"] --> B["活动生效<br/>→ activity_id"] B --> C{活动管理} C -- 停止 --> D["[API] 停止赠品活动<br/>stopgiftactivity"] C -- 删除 --> E["[API] 删除赠品活动<br/>deletegiftactivity"] style B fill:#ffffff,stroke:#0ab8a6,color:#666666 style C fill:#ffffff,stroke:#0ab8a6,color:#666666

    gift_id 对应的是非卖商品的 product_id（通过 [API] 添加非卖商品 / addgiftproduct 或 [API] 在售商品转赠品 / setproductasgift 获得）。

    # 阶段五：限时抢购流程

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["[API] 添加限时抢购任务<br/>addlimiteddiscounttask<br/>→ task_id"] --> B[任务生效] B --> C["[API] 获取限时抢购任务列表<br/>getlimiteddiscounttasklist"] B --> D{任务管理} D -- 停止 --> E["[API] 停止限时抢购任务<br/>stoplimiteddiscounttask"] D -- 删除 --> F["[API] 删除限时抢购任务<br/>deletelimiteddiscounttask"] style B fill:#ffffff,stroke:#0ab8a6,color:#666666 style D fill:#ffffff,stroke:#0ab8a6,color:#666666

    # 商品状态流转

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A[初始创建] -->|"添加商品"| B[审核中] B -->|"审核通过"| C[未上架] B -->|"审核不通过"| D[审核不通过] D -->|"修改重提"| B B -->|"撤回审核"| C C -->|"上架"| E[已上架] E -.->|"下架"| C E -->|"更新核心信息"| B E -->|"删除"| G[已删除] C -->|"删除"| G

    [API] 免审更新商品 / updateproductauditfree 直接更新线上数据，不改变商品状态。

    # 状态流转操作对照表

    操作 中文名 / 英文名 起始状态 目标状态
    添加商品 [API] 添加商品 / addproduct 初始创建 审核中
    审核通过 [事件] 商品审核 / product_spu_audit（status=3） 审核中 未上架
    审核不通过 [事件] 商品审核 / product_spu_audit（status=2） 审核中 审核不通过
    修改重提 [API] 更新商品 / updateproduct 审核不通过 审核中
    撤回审核 [API] 撤回商品审核 / cancelauditproduct 审核中 未上架
    上架 [API] 上架商品 / listingproduct 未上架 已上架
    下架 [API] 下架商品 / delistingproduct 已上架 未上架
    更新核心信息 [API] 更新商品 / updateproduct 已上架 审核中
    删除 [API] 删除商品 / deleteproduct 已上架 / 未上架 已删除
    免审更新 [API] 免审更新商品 / updateproductauditfree 已上架 已上架（不变）

    审核通过后需主动调用 [API] 上架商品 / listingproduct 上架，或通过 [API] 设置商品上架策略 / setproductauditstrategy 设置自动上架。状态变更通过 3 个事件通知推送：[事件] 商品审核 / product_spu_audit、[事件] 商品上下架 / product_spu_listing、[事件] 商品更新 / product_spu_update。

    # 前端对接说明

    中文名 / 英文名 请求方式 功能说明
    获取商品H5短链 / getproducth5url POST /channels/ec/product/h5url/get 生成商品 H5 页面短链接
    获取商品口令 / getproducttaglink POST /channels/ec/product/taglink/get 生成商品口令用于分享
    获取商品二维码 / getproductqrcode POST /channels/ec/product/qrcode/get 生成商品二维码图片
    获取商品Scheme码 / getproductscheme POST /channels/ec/product/scheme/get 生成商品 URL Scheme

    # 接口全览

    # 必接接口

    # API 接口

    中文名 / 英文名 请求方式 功能说明
    上传图片 / img_upload POST /shop/ec/basics/img/upload 上传商品图片，获取 media_id 或图片链接
    发品前校验 / categoryprecheck POST /channels/ec/product/categoryprecheck 校验店铺/类目权限
    添加商品 / addproduct POST /channels/ec/product/add 提交商品草稿数据并发起审核
    获取商品 / getproduct POST /channels/ec/product/get 查询单个商品的草稿/线上数据
    获取商品列表 / getproductlist POST /channels/ec/product/list/get 分页查询商品列表
    更新商品 / updateproduct POST /channels/ec/product/update 修改草稿数据，需重新审核
    上架商品 / listingproduct POST /channels/ec/product/listing 审核通过后上架商品
    下架商品 / delistingproduct POST /channels/ec/product/delisting 将已上架商品下架
    获取库存 / getstock POST /channels/ec/product/stock/get 获取单个 SKU 库存数量
    快速更新库存 / updatestock POST /channels/ec/product/stock/update 增加/减少/设置 SKU 库存

    # 事件通知

    中文名 / 英文名 事件标识 功能说明
    商品审核 / product_spu_audit Event: product_spu_audit 审核通过/不通过时回调
    商品上下架 / product_spu_listing Event: product_spu_listing 上架/自主下架/系统下架时回调
    商品更新 / product_spu_update Event: product_spu_update 商品信息变更时回调

    # 全量接口

    商品管理 API 接口按功能分为商品、库存、赠品、买赠活动、限时抢购、资源管理六个模块，另有事件通知。各模块接口的完整参数说明请查阅官方文档：

    # 常见问题 FAQ

    Q：调用 [API] 添加商品 / addproduct 提示需要开通运费险？ A：[API] 发品前校验 / categoryprecheck 返回 all_pass: true 代表店铺层面已开通运费险，但发品时还需在商品维度打开运费险开关。

    文档变更日志（2条）
    2026 年 04 月 22 日
    补充 上传头图视频
    2026 年 04 月 07 日
    新增 商品管理 - 开发指南