支持第三方调用
支持沙箱环境调用
禁止个人开发者调用
商品同步-实物电商
公共请求参数
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| app_id | string | 是 | 小程序appid |
| access_token | string | 是 | 小程序调用凭证 |
业务请求参数
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| out_product_id | string | 是 | 外部商品id，不超过64字符 |
| name | string | 是 | 商品名称 |
| short_title | string | 是 | 短标题，限制64个字 |
| desc | string | 是 | 商品描述，限制1000个字符 |
| path | string | 是 | 小程序商品详情页打开路径，需要支持打开后默认切到最低价sku页面，以 / 开头 |
| top_image | string | 是 | 商品头图，单张; 仅支持jpg、jpeg、png格式 |
| category_id | string | 否 | 类目id，通过类目接口获取，最后一级的id |
| biz_create_time | int64 | 是 | 商品创建时间，时间戳精确到秒 |
| biz_update_time | int64 | 是 | 商品修改时间，时间戳精确到秒 |
skus | list_struct | 是 | 子商品集合 |
out_sku_id | string | 是 | sku商品外部id，不超过64字符 |
name | string | 是 | 商品名称 |
sku_image | string | 是 | sku商品图片，单张; 仅支持jpg、jpeg、png格式 |
origin_price | int64 | 否 | 商品原始价格，划线价格，单位（分） |
sale_price | int64 | 是 | 商品售卖价格，单位（分） |
status | int32 | 否 | sku状态：1：上架，0：下架，2：系统下架，如果不填，默认：1 |
ext | map | 否 | 自定义字段 |
key | string | 否 | key |
value | string | 否 | value |
请求示例
{
"out_product_id":"string",
"name":"string",
"short_title":"string",
"desc":"string",
"path":"string",
"top_image":"string",
"category_id":"string",
"biz_create_time":0,
"biz_update_time":0,
"skus":[
{
"out_sku_id":"string",
"name":"string",
"sku_image":"string",
"origin_price":0,
"sale_price":0,
"status":0
}
]
}
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| success | bool | 否 | 是否成功 |
| msg | string | 否 | 说明，正确响应时为 success，错误响应时为错误描述 |
| code | int32 | 否 | 错误码，正确响应时为 0，错误响应时非0 |
{
"success":true,
"msg":"string",
"code":0
}
code | Msg | 说明 |
|---|---|---|
| 400001 | 参数不合法引导去开交易能力 | 请检查入参是否缺失、错误 |
| 420001 | 该应用不具有小程序交易组件能力 | 请在专业号管理后台开通担保支付 |
| 400003 | 数组元素超过最大限制sku数量超限制 | sku数量最大50 |
| 420207 | 电商担保支付获取类目异常-业务异常 | |
| 420209 | 电商担保支付获取类目未查到当前商品的类目信息-业务异常 | |
| 420157 | 不支持的交易类型 | |
| 420156 | 未开通交易权限 | 小程序支付功能被禁用，请小程序开发者重新申请 |
| 420200 | sku商品不能为空 | |
| 420202 | 商品审核未通过，请重新修改sku状态审核未通过，无法上架 | 商品审核结果会通过回调接口查询，请根据审核拒绝原因调整后重新同步 |
| 420204 | 本地生活商家,请使用「商品同步-生活服务」接口同步商品 | 商品同步-生活服务 |
| 420206 | 本地生活商品同步失败本地商品同步失败 | |
| 420207 | 商家无可售类目,请先认领对应类目 | 查询已设置类目, 可在专业号管理后台认领类目 |
| 420208 | 商家无商品类目权限，请先认领对应类目 | 查询已设置类目 |
| 420210 | 类目非实物电商类目，请确认参数是否正确 | 生活服务类目同步商品用商品同步-生活服务 |
| 520200 | 商品同步失败同步下游服务异常 | 系统异常，请联系管理员 |
| 520201 | 商品下线失败 | 系统异常，请联系管理员 |
| 520202 | 商品上线失败 | 系统异常，请联系管理员 |
| 520205 | 商品搜索失败 | |
| 520402 | 已切流商户必须传新类目 | 类目ID必须为接口可用类目查询 可查询到的类目ID。有部分商家使用的类目ID,是早前运营提供的，已经不再使用，需要替换为接口里可以查询到类目ID |
参见错误码