支持第三方调用
支持沙箱环境调用
禁止个人开发者调用
商品同步-生活服务
公共请求参数
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| 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 | 是 | 商品修改时间，时间戳精确到秒 |
package_detail | struct | 否 | 套餐内容明细，仅在category_id=627a33edff16300001314989（户外出行服务-民宿/酒店-套餐）时为必填； 数量和单位请同时填写/不填写 |
package_rooms | list_struct | 否 | 套餐-“住宿”list （不超过10项） |
name | string | 是 | 名称（不超过20个字） |
count | int32 | 否 | 数量 |
unit | string | 否 | 单位 |
package_foods | list_struct | 否 | 套餐-“吃喝”List （不超过10项） |
name | string | 是 | 名称（不超过20个字） |
count | int32 | 否 | 数量 |
unit | string | 否 | 单位 |
package_entertainments | list_struct | 否 | 套餐-“玩乐”list （不超过10项） |
name | string | 是 | 名称（不超过20个字） |
count | int32 | 否 | 数量 |
unit | string | 否 | 单位 |
package_others | list_struct | 否 | 套餐-“其他”list （不超过10项） |
name | string | 是 | 名称（不超过20个字） |
count | int32 | 否 | 数量 |
unit | string | 否 | 单位 |
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 | 否 | 自定义字段(Map对象的形式)，对于补差商品可传入key=saleMode,value=INDIRECT，补差商品将不会在POI页展示) |
key | string | 否 | key |
value | string | 否 | value |
| product_type | int32 | 否 | 商品类型， 1-团购，2-酒旅预售券，3-日历商品 |
| settle_type | int32 | 否 | 结算方式，1-总店结算，2-门店结算，3-区域结算，开通担保支付的商家下必传，使用门店或区域结算的前提是已认领门店并提交了门店资质 |
| poi_id_list | list_string | 否 | 1. 新版本小程序POI_ID_List部分类目必传，类目查询 2. 旧版本小程序POI_ID_List 针对【民宿、酒店、景点、露营】身份必填，针对【旅行社】、【商旅票务代理】身份不可填写 |
请求示例
{
"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,
"package_detail":{
"package_rooms":[
{
"name":"string",
"count":0,
"unit":"string"
}
],
"package_foods":[
{
"name":"string",
"count":0,
"unit":"string"
}
],
"package_entertainments":[
{
"name":"string",
"count":0,
"unit":"string"
}
],
"package_others":[
{
"name":"string",
"count":0,
"unit":"string"
}
]
},
"skus":[
{
"out_sku_id":"string",
"name":"string",
"sku_image":"string",
"origin_price":0,
"sale_price":0,
"status":0
}
],
"product_type":0,
"settle_type":0,
"poi_id_list":[
"string"
]
}
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| 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 | 商家无商品类目权限，请先认领对应类目 | 查询已设置类目 |
| 420209 | 类目非生活服务类目，请确认参数是否正确 | 非生活服务类目同步商品用商品同步-实物电商 |
| 520200 | 商品同步失败同步下游服务异常 | 系统异常，请联系管理员 |
| 520201 | 商品下线失败 | 系统异常，请联系管理员 |
| 520202 | 商品上线失败 | 系统异常，请联系管理员 |
| 520205 | 商品搜索失败 | |
| 520402 | 已切流商户必须传新类目 | 类目ID必须为接口可用类目查询 可查询到的类目ID。有部分商家使用的类目ID,是早前运营提供的，已经不再使用，需要替换为接口里可以查询到类目ID |
参见错误码