# 开发前准备

• 权限与凭证：供货商可直接调用，使用供货商的 access_token；第三方服务商需获得供货商对权限集 ID：129的授权，使用 authorizer_access_token
• 消息推送配置：需配置消息推送回调 URL，本模块涉及货品审核、货品上下架、供货单流转等事件通知（完整事件列表见下方接口全览）。详见 消息通知（回调）说明
• 前置条件：供货商需入驻 微信小店供货商平台 并完成账号认证；需先申请经营的商品类目，审核通过后方可发布货品；需配置发货地址和运费模板，方可发布包含快递发货的货品

# 核心概念

供货管理是帮助供货商完整管理产品生命周期的业务模块，涵盖从类目申请、货品发布到库存管理、物流配置的全套功能。

# 五个核心子模块

# 业务流程概览

申请类目 → 获取类目资质要求 → 配置运费模板 → 发布货品 → 货品审核 → 上架销售 → 管理库存 → 追踪订单

# 接入流程

# 阶段一：类目申请

供货商需先申请经营某些需要资质的商品类目。

# 流程说明

第一步：获取类目列表

操作步骤：

1. 通过 [API] 获取所有类目 / getallcategory 获取全部类目树，找出要申请的目标类目
2. 通过 [API] 获取类目详情 / getcategorydetail 查询类目的资质要求
3. 准备所需的资质材料（如营业执照、行业资质等）
4. 通过 [API] 申请类目 / addcategory 上传资质材料提交申请
5. 平台审核后，可通过 [API] 获取类目审核单列表 / getbizcatflowlist 查询审核结果

第二步：查看类目审核状态

供货商可通过以下接口查询已申请类目的状态：

• [API] 获取类目权限列表 / getcategoryrelationlist：查看所有已获得权限的类目
• [API] 获取类目审核单列表 / getbizcatflowlist：查看类目申请审核记录
• [API] 获取类目审核单详情 / getbizcatflowdetail：查看单个申请单的详细审核信息

# 阶段二：配置运费模板

发布包含快递发货的货品前，需先配置运费模板。

# 流程说明

操作步骤：

1. 通过 [API] 获取运费模板列表 / getfreighttemplatelist 查看已有的运费模板
2. 如需新建模板，调用 [API] 增加运费模板 / addfreighttemplate，配置：
   • 发货地址
   • 运费计算方式（按件数/按重量）
   • 配送方式（快递/无需快递）
   • 包邮规则（全包邮/条件包邮/不包邮）
3. 如需修改已有模板，调用 [API] 更新运费模板 / updatefreighttemplate
4. 在后续发布货品时关联此运费模板 ID

# 阶段三：发布与管理货品

供货商发布并审核通过、上架的货品会自动进入货源市场，商家可在货源市场自主选品，将货品铺货到自己的小店销售。因此，发布优质货品并保持上架是供货商获取供货单的前提，无需与商家逐一签约建联。

# 流程说明

第一步：获取发布规则

在发布货品前，需要了解所选类目对货品的编辑要求：

1. 通过 [API] 获取类目下商品发布规则 / getcategoryproductrule 查询目标类目的：
   • 必填属性
   • 可选属性
   • 图片要求（数量、尺寸等）
   • SKU 规格要求

第二步：发布新货品

1. 调用 [API] 添加货品 / addsupplyproduct，上传：

   • 货品基本信息（标题、描述、品牌等）
   • 货品主图和详情图（必须通过 [API] 上传图片 / imgupload 接口获取图片 URL）
   • 三级类目信息
   • SKU 列表（包含规格、价格、库存）
   • 运费模板 ID
   • 售后信息（退货地址等）

2. 货品提交后进入审核流程，平台会通过 [事件] 货品审核结果 / ec_supplier_product_audit 事件通知审核结果

第三步：货品审核后处理

• 审核通过：调用 [API] 上架货品 / listingsupplyproduct 上架发售
• 审核驳回：修改并重新提交，或使用 [API] 免审核更新货品 / updatesupplyproductauditfree 更新已上架货品

第四步：货品日常管理

发布后可通过以下接口进行日常管理：

• [API] 获取货品详情 / getsupplyproduct：查看货品信息
• [API] 获取货品列表 / getsupplyproductlist：批量查询货品
• [API] 更新货品 / updatesupplyproduct：修改货品信息
• [API] 下架货品 / delistingsupplyproduct：临时下架
• [API] 删除货品 / deletesupplyproduct：彻底删除（仅草稿状态）

# 阶段四：库存管理

发布货品后，需要持续管理货品库存。

# 流程说明

操作步骤：

1. 通过 [API] 批量获取库存信息 / batchgetstock 批量查询货品 SKU 的实时库存
2. 当库存不足时，通过 [API] 快速更新库存 / updatestock 调整库存数量
3. 通过 [API] 获取库存流水 / getstockflow 查看库存的变化历史（下单、取消、售后等）

# 阶段五：供货单追踪

承接阶段三的货源市场链路：供货商上架的货品被商家铺货到小店后，当消费者在商家小店下单该货品，平台会自动为对应供货商生成一张供货单。供货商无需商家逐笔下单，只需追踪供货单的流转状态并及时发货。

# 流程说明

操作步骤：

1. 供货商通过 [事件] 供货单新增 / supply_order_new 事件接收新的供货单
2. 调用 [API] 获取供货单列表 / supplyorder_list 或 [API] 搜索供货单 / supplyorder_search 查询供货单
3. 通过 [API] 查询供货单详情 / supplyorder_get 获取订单的详细信息（商品、收货地址等）
4. 在供货商管理后台确认订单、打单出库、发货
5. 平台自动同步发货进度给商家（供货单状态会自动更新）

供货单在整个流转过程中，除新增外还会推送以下事件，供货商可据此实时同步本地数据：

• [事件] 供货单取消 / supply_order_cancel：供货单被取消时推送
• [事件] 供货单更新 / supply_order_update：供货单信息更新时推送
• [事件] 供货单完成 / supply_order_complete：供货单完成时推送

# 货品状态流转

与小店商品一致，货品同样区分草稿数据（edit_product，供货商正在编辑、尚未生效）和线上数据（product，当前实际生效、买家可见），分别用 edit_status、status 两个字段表示状态。通过 [API] 获取货品详情 / getsupplyproduct 的 data_type 参数可控制返回草稿数据、线上数据或两者。

# 草稿状态（edit_status）

# 线上状态（status）

# 状态流转图

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

# 状态流转操作对照表

添加/更新货品时可传 listing=1 实现提审后自动上架；否则审核通过后需主动调用 [API] 上架货品 / listingsupplyproduct 上架。审核结果通过 [事件] 货品审核结果 / ec_supplier_product_audit 推送。删除货品仅支持未上架（草稿或已下架）状态，审核中需先撤回审核、已上架需先下架。

# 接口全览

# 1. 类目管理

# 2. 货品管理

# 3. 货品库存

# 4. 货品运费模板

# 5. 供货单管理

# 事件通知

# 常见问题 FAQ

Q：货品发布后多久会审核完成？ A：平台通常在 1-3 个工作日内完成审核。审核结果会通过 [事件] 货品审核结果 / ec_supplier_product_audit 事件推送给供货商。

Q：货品被驳回后怎么重新提交？ A：可以使用 [API] 更新货品 / updatesupplyproduct 接口修改货品信息后重新提交。如果货品已上架，可使用 [API] 免审核更新货品 / updatesupplyproductauditfree 进行免审核更新。

Q：上传货品图片有什么要求？ A：所有图片都必须通过 [API] 上传图片 / imgupload 接口获取 mmecimage.cn 域名的 URL，不支持其他来源的图片 URL。

Q：供货商如何快速了解类目要求？ A：通过 [API] 获取类目下商品发布规则 / getcategoryproductrule 接口可以获取类目的所有要求，包括必填属性、可选属性、图片数量等。

Q：库存更新后多久能生效？ A：库存更新通常在数秒内生效。可通过 [API] 批量获取库存信息 / batchgetstock 接口实时查询最新库存。

文档变更日志（1条）

2026 年 07 月 07 日

新增 供货管理 开发指南