# 质检管理

# 开发前准备

• 权限与凭证：商家自研可直接调用，使用小店 access_token；第三方服务商需获得商家对权限集 ID：131的授权，使用 authorizer_access_token
• 消息推送配置：本模块无独立事件通知，无需配置

# 质检业务说明

微信小店对部分类目商品要求质检后方可发货，目前支持两种质检模式，接口体系完全不同：

# 接入流程

# 一、识别订单质检类型

商家通过 [API] 获取订单详情 / getorder 的 delivery_info.quality_inspect_type 字段判断质检类型，再按 delivery_info.quality_inspect_info.inspect_status 确定当前状态和下一步操作。

# 二、珠宝玉石类质检流程

# 2.1 前置配置

珠宝玉石类质检需要商家先在微信小店后台开通质检服务并完成质检仓配置（路径：微信小店后台 → 平台服务 → 先检后发），开通后通过接口获取送检所需的配置模板。

[API] 查询质检仓配置 / getinspectconfig 返回质检仓 ID、仓库名称、仓库地址、发货地址和退货地址。若返回错误码 10021602（小店尚未配置质检基础信息），需先在微信小店后台完成配置。

[API] 查询送检配置模板信息 / getinspectsubmitconfig 返回绑定送检信息所需的配置选项，包括：

• 快递公司列表（delivery_list）：每家快递下有多个产品可选，部分支持保价
• 质检机构列表（inspect_org_list）：包含珠宝质检机构和沉香质检机构，通过 org_category 区分
• 资费标准链接（charge_url）：质检服务的收费说明

# 2.2 送检操作

通过 [API] 获取订单详情 / getorder 返回的 delivery_info.quality_inspect_info.inspect_status 字段（详见「一、识别订单质检类型」），商家识别到 inspect_status = 0（待录入送检信息）或 inspect_status = 12（待重新送检）的订单后，进入送检操作。

绑定送检信息的关键参数：

[API] 绑定送检信息 / submitinspectinfo 需要指定以下核心信息，参数值均来自前置配置接口：

打印质检码说明：

[API] 打印质检码 / printinspectcode 返回的 printInfo 字段包含打印模板数据和模板 HTML 地址（Base64 编码），将此字段传入打印控件即可完成打印。

自寄快递说明：

当商家选择自行寄送快递而非通过平台下单寄件时，需额外调用 [API] 自寄快递送检 / registerlogistics 登记物流信息。该接口支持批量操作，通过 order_id_list 可同时为多个订单登记同一快递单号。快递公司编码需通过物流发货模块的 [API] 获取快递公司列表 / getdeliverycompanylistnew 获取。

自寄快递信息最多可修改 3 次，且质检单入库后不可修改。

# 2.3 质检状态流转

珠宝玉石类质检状态（inspect_status）：

状态流转图：

主线流程：待录入 → 待送检 → 已入库 → 质检中 → 待出库 → 已发货。质检不通过时退回「待重新送检」，商家需重新绑定送检信息；连续不通过达到上限后进入「已达送检上限」终态。

# 三、生鲜类质检流程

生鲜类质检（quality_inspect_type = 2）不需要配置质检仓，不走送检流程，由商家在发货前拍摄打包信息上传平台审核。

# 3.1 上传质检信息

通过 [API] 获取订单详情 / getorder 返回的 delivery_info.quality_inspect_info.inspect_status 字段（详见「一、识别订单质检类型」），商家识别到 inspect_status = 100（待上传打包信息）的订单后，上传质检信息。

上传内容要求：

商家通过 [API] 上传生鲜质检信息 / submitfreshinspectinfo 上传以下审核项（图片/视频 URL 须通过 [API] 图片上传 / img_upload 获取）：

审核通过（inspect_status = 202）后商家自行发货；审核不通过（inspect_status = 201）需重新拍摄上传。

# 3.2 质检状态流转

生鲜类质检状态（inspect_status）：

状态流转图：

# 接口全览

# 珠宝玉石类质检接口

# 订单管理模块接口

# 相关运营文档

详见成长中心：

• 《微信小店珠宝玉石商品准禁售细则》
• 《微信小店沉香带宝、沉香、沉香木商品准禁售细则》
• 《微信小店商品品质抽检管理规范》# 质检管理

# 开发前准备

• 权限与凭证：商家自研可直接调用，使用小店 access_token；第三方服务商需获得商家对权限集 ID：131的授权，使用 authorizer_access_token
• 消息推送配置：本模块无独立事件通知，无需配置

# 质检业务说明

微信小店对部分类目商品要求质检后方可发货，目前支持两种质检模式，接口体系完全不同：

# 接入流程

# 一、识别订单质检类型

商家通过 [API] 获取订单详情 / getorder 的 delivery_info.quality_inspect_type 字段判断质检类型，再按 delivery_info.quality_inspect_info.inspect_status 确定当前状态和下一步操作。

# 二、珠宝玉石类质检流程

# 2.1 前置配置

珠宝玉石类质检需要商家先在微信小店后台开通质检服务并完成质检仓配置（路径：微信小店后台 → 平台服务 → 先检后发），开通后通过接口获取送检所需的配置模板。

[API] 查询质检仓配置 / getinspectconfig 返回质检仓 ID、仓库名称、仓库地址、发货地址和退货地址。若返回错误码 10021602（小店尚未配置质检基础信息），需先在微信小店后台完成配置。

[API] 查询送检配置模板信息 / getinspectsubmitconfig 返回绑定送检信息所需的配置选项，包括：

• 快递公司列表（delivery_list）：每家快递下有多个产品可选，部分支持保价
• 质检机构列表（inspect_org_list）：包含珠宝质检机构和沉香质检机构，通过 org_category 区分
• 资费标准链接（charge_url）：质检服务的收费说明

# 2.2 送检操作

通过 [API] 获取订单详情 / getorder 返回的 delivery_info.quality_inspect_info.inspect_status 字段（详见「一、识别订单质检类型」），商家识别到 inspect_status = 0（待录入送检信息）或 inspect_status = 12（待重新送检）的订单后，进入送检操作。

绑定送检信息的关键参数：

[API] 绑定送检信息 / submitinspectinfo 需要指定以下核心信息，参数值均来自前置配置接口：

打印质检码说明：

[API] 打印质检码 / printinspectcode 返回的 printInfo 字段包含打印模板数据和模板 HTML 地址（Base64 编码），将此字段传入打印控件即可完成打印。

自寄快递说明：

当商家选择自行寄送快递而非通过平台下单寄件时，需额外调用 [API] 自寄快递送检 / registerlogistics 登记物流信息。该接口支持批量操作，通过 order_id_list 可同时为多个订单登记同一快递单号。快递公司编码需通过物流发货模块的 [API] 获取快递公司列表 / getdeliverycompanylistnew 获取。

自寄快递信息最多可修改 3 次，且质检单入库后不可修改。

# 2.3 质检状态流转

珠宝玉石类质检状态（inspect_status）：

状态流转图：

主线流程：待录入 → 待送检 → 已入库 → 质检中 → 待出库 → 已发货。质检不通过时退回「待重新送检」，商家需重新绑定送检信息；连续不通过达到上限后进入「已达送检上限」终态。

# 三、生鲜类质检流程

生鲜类质检（quality_inspect_type = 2）不需要配置质检仓，不走送检流程，由商家在发货前拍摄打包信息上传平台审核。

# 3.1 上传质检信息

通过 [API] 获取订单详情 / getorder 返回的 delivery_info.quality_inspect_info.inspect_status 字段（详见「一、识别订单质检类型」），商家识别到 inspect_status = 100（待上传打包信息）的订单后，上传质检信息。

上传内容要求：

商家通过 [API] 上传生鲜质检信息 / submitfreshinspectinfo 上传以下审核项（图片/视频 URL 须通过 [API] 图片上传 / img_upload 获取）：

审核通过（inspect_status = 202）后商家自行发货；审核不通过（inspect_status = 201）需重新拍摄上传。

# 3.2 质检状态流转

生鲜类质检状态（inspect_status）：

状态流转图：

# 接口全览

# 珠宝玉石类质检接口

# 订单管理模块接口

# 相关运营文档

详见成长中心：

• 《微信小店珠宝玉石商品准禁售细则》
• 《微信小店沉香带宝、沉香、沉香木商品准禁售细则》
• 《微信小店商品品质抽检管理规范》# 质检管理

# 开发前准备

• 权限与凭证：商家自研可直接调用，使用小店 access_token；第三方服务商需获得商家对权限集 ID：131的授权，使用 authorizer_access_token
• 消息推送配置：本模块无独立事件通知，无需配置

# 质检业务说明

微信小店对部分类目商品要求质检后方可发货，目前支持两种质检模式，接口体系完全不同：

# 接入流程

# 一、识别订单质检类型

商家通过 [API] 获取订单详情 / getorder 的 delivery_info.quality_inspect_type 字段判断质检类型，再按 delivery_info.quality_inspect_info.inspect_status 确定当前状态和下一步操作。

!识别订单质检类型

# 二、珠宝玉石类质检流程

# 2.1 前置配置

珠宝玉石类质检需要商家先在微信小店后台开通质检服务并完成质检仓配置（路径：微信小店后台 → 平台服务 → 先检后发），开通后通过接口获取送检所需的配置模板。

!前置配置

[API] 查询质检仓配置 / getinspectconfig 返回质检仓 ID、仓库名称、仓库地址、发货地址和退货地址。若返回错误码 10021602（小店尚未配置质检基础信息），需先在微信小店后台完成配置。

[API] 查询送检配置模板信息 / getinspectsubmitconfig 返回绑定送检信息所需的配置选项，包括：

• 快递公司列表（delivery_list）：每家快递下有多个产品可选，部分支持保价
• 质检机构列表（inspect_org_list）：包含珠宝质检机构和沉香质检机构，通过 org_category 区分
• 资费标准链接（charge_url）：质检服务的收费说明

# 2.2 送检操作

通过 [API] 获取订单详情 / getorder 返回的 delivery_info.quality_inspect_info.inspect_status 字段（详见「一、识别订单质检类型」），商家识别到 inspect_status = 0（待录入送检信息）或 inspect_status = 12（待重新送检）的订单后，进入送检操作。

!送检操作

绑定送检信息的关键参数：

[API] 绑定送检信息 / submitinspectinfo 需要指定以下核心信息，参数值均来自前置配置接口：

打印质检码说明：

[API] 打印质检码 / printinspectcode 返回的 printInfo 字段包含打印模板数据和模板 HTML 地址（Base64 编码），将此字段传入打印控件即可完成打印。

自寄快递说明：

当商家选择自行寄送快递而非通过平台下单寄件时，需额外调用 [API] 自寄快递送检 / registerlogistics 登记物流信息。该接口支持批量操作，通过 order_id_list 可同时为多个订单登记同一快递单号。快递公司编码需通过物流发货模块的 [API] 获取快递公司列表 / getdeliverycompanylistnew 获取。

自寄快递信息最多可修改 3 次，且质检单入库后不可修改。

# 2.3 质检状态流转

珠宝玉石类质检状态（inspect_status）：

状态流转图：

!珠宝玉石类质检状态流转

主线流程：待录入 → 待送检 → 已入库 → 质检中 → 待出库 → 已发货。质检不通过时退回「待重新送检」，商家需重新绑定送检信息；连续不通过达到上限后进入「已达送检上限」终态。

# 三、生鲜类质检流程

生鲜类质检（quality_inspect_type = 2）不需要配置质检仓，不走送检流程，由商家在发货前拍摄打包信息上传平台审核。

# 3.1 上传质检信息

通过 [API] 获取订单详情 / getorder 返回的 delivery_info.quality_inspect_info.inspect_status 字段（详见「一、识别订单质检类型」），商家识别到 inspect_status = 100（待上传打包信息）的订单后，上传质检信息。

!生鲜类质检操作流程

上传内容要求：

商家通过 [API] 上传生鲜质检信息 / submitfreshinspectinfo 上传以下审核项（图片/视频 URL 须通过 [API] 图片上传 / img_upload 获取）：

审核通过（inspect_status = 202）后商家自行发货；审核不通过（inspect_status = 201）需重新拍摄上传。

# 3.2 质检状态流转

生鲜类质检状态（inspect_status）：

状态流转图：

!生鲜类质检状态流转

# 接口全览

# 珠宝玉石类质检接口

# 订单管理模块接口

# 相关运营文档

详见成长中心：

• 《微信小店珠宝玉石商品准禁售细则》
• 《微信小店沉香带宝、沉香、沉香木商品准禁售细则》
• 《微信小店商品品质抽检管理规范》

文档变更日志（1条）

2026 年 04 月 10 日

新增 质检管理 开发指南