# 商品属性映射及推荐

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：externalproductmappingnew

根据入参类目和多个站外属性/站外属性值、站外类目名称、商品标题、主图、详情图，返回多个启用的站内外属性映射中的站内属性/站内属性值。系统返回参数值仅供参考，商家应根据商品实际情况判断是否选用，并对商品信息负责。限频500/min

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/product/externalproductmappingnew?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用。

# 第三方调用

本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为：129
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代微信小店商家进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String Parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用）

# 请求体 `Request Payload`

参数名	类型	必填	示例	说明
cat_id	number	是	6261	叶子类目id
external_category_name	string	否	母婴:童鞋:雨鞋	外部商品类目名称
head_imgs	array	是	-	主图，至少传一张
detail_imgs	array	否	-	详情图
title	string	是	-	商品标题
external_attributes	objarray	否	-	属性列表

# Body.external_attributes(Array) `Object Payload`

属性列表

参数名	类型	必填	说明
key	string	否	外部属性key
value	string	否	外部属性值

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	示例	说明
errcode	number	0	错误码
errmsg	string	ok	错误信息
attributes	objarray	-	映射属性结果

# Res.attributes(Array) `Object Payload`

映射属性结果

参数名	类型	说明
key	string	属性key
value	string	属性值

# 4. 注意事项

注意输入的类目cat_id和属性要匹配，否则输出的结果可能有误

限频500/min

# 5. 代码示例

请求示例

{
    "cat_id": 6261,
    "external_category_name": "母婴:童鞋:雨鞋",
    "head_imgs": [
        "https://mmecimage.cn/p/wx2b255582a7b4bfd0/HMpEI3XtWmJc2CHv4lhnfoZcLtxVTBhH8QU48DcKtHr1"
    ],
    "detail_imgs": [
        "https://mmecimage.cn/p/wx2b255582a7b4bfd0/HKcyK0PMZvTGfiLiV0AXk0NTkg5NGkj-UOL8ZiKoYtTp"
    ],
    "title": "儿童雨鞋",
    "external_attributes": [
        {
          "key": "帮面材质",
          "value": "塑胶"
      }
    ]
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "attributes": [
        {
          "key": "鞋面材质",
          "value": "塑胶"
      }
    ]
}

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

错误码	错误描述	解决方案
10020017	类目id不合法	请输入正确的叶子类目id
10020059	商品头图为空	head_imgs至少包含一个正确的url
10020061	商品头图URL非法	head_imgs至少包含一个正确的url
10020294	商品图片有问题,传入的图片可能被损坏	建议检查一下图片
10020300	商品头图不存在	head_imgs至少包含一个正确的url
10020301	商品头图下载失败	请稍后重试或联系客服
10020316	站外商品映射属性key为空	external_attribute_name为必填且不能为空字符串
10020330	新站内外商品属性映射超过限频500/min	建议一分钟后再试（控制使用频率在500/min以内）
10020332	类目错挂,可能导致属性映射错误,请修改cat_id后再试	请使用正确的类目,否则输出的结果可以有误
10020504	类目不是叶子类目	请输入正确的叶子类目id

# 7. 适用范围

本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。

限频500/min

接口变更日志（6条）

2026 年 01 月 15 日

更名为商品属性映射及推荐、新增「商品头图为空」「商品图片有问题,传入的图片可能被损坏」等 5 个错误码

2026 年 01 月 14 日

API 上线

2026 年 01 月 13 日

新增类目不匹配错误码

2026 年 01 月 08 日

新增限频信息500/min和对应错误码

2025 年 12 月 24 日

新增新站内外商品属性映射接口