通用场景
批量创建商品营销活动
公共请求参数
业务请求参数
item_attr_list｜商品及其属性列表必选array
【描述】批量创建商品营销活动记录
以下参数 二选一 传入必选
item_id｜平台侧商品idstring[0,64]
【描述】支付宝平台侧商品id，是支付宝平台侧商品的唯一标识，后续与平台交互，需要使用该 id，建议持久化。该字段特殊可选，与out_item_id不能同时为空，优先使用item_id。
【示例值】2023052222000300025154
out_item_id｜商家侧商品idstring[0,100]
【描述】商家侧商品id，要求 appid 下全局唯一。该字段特殊可选，与item_id不能同时为空，优先使用item_id。
【示例值】43214321
activity_attr_list｜营销活动属性列表可选[0,100]
【描述】属性列表
attr_key｜属性key必选string[1,100]
【描述】属性的 key
【示例值】zhimassdiscountprice
attr_value｜属性值必选string[0,1000]
【描述】属性值
【示例值】0.88
promotion_type｜营销活动类型必选string[1,100]
【描述】营销活动类型
【枚举值】
差异化定价——芝麻信用: sesame_score
商品分期免息: free_installment
先用后付/0元囤: credit_pay
【示例值】free_installment
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.app.itempromoactivity.list.create&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"promotion_type":"free_installment",
"item_attr_list":[
{
"activity_attr_list":[
{
"attr_key":"zhimassdiscountprice",
"attr_value":"0.88"
}
],
"item_id":"2023052222000300025154",
"out_item_id":"43214321"
}
]
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
total_num｜提交的所有数量必选number(10)
【描述】提交的所有数量
【示例值】10
success_num｜成功的数量必选number(10)
【描述】成功的数量
【示例值】1
failed_item_list｜失败商品列表可选itempromoactivityfailvo[]
【描述】失败的商品
item_id｜平台侧商品id可选string(100)
【描述】商家侧 id
【示例值】2023052222000300025154
fail_reason｜失败原因可选string(100)
【描述】失败原因
【示例值】已经创建过
out_item_id｜商家侧商品id可选string(100)
【描述】商家侧商品id，要求 appid 下全局唯一
【示例值】12345678
响应示例
正常示例
异常示例
{
"alipay_open_app_itempromoactivity_list_create_response": {
"code": "10000",
"msg": "success",
"total_num": 10,
"success_num": 1,
"failed_item_list": [
{
"item_id": "2023052222000300025154",
"fail_reason": "已经创建过",
"out_item_id": "12345678"
}
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| online_item_not_exist_error | 不存在上架的商品 | 当前商品未上架，请检查该商品的状态 |
| permission_check_error | 权限校验不通过 | 小程序无权限操作当前商品, 请检查商品是否归属于当前小程序 |
| promo_activity_access_check_fail | 营销活动准入校验不通过 | 请根据接口返回的错误信息，检查请求参数，修改后重新发起 |
| promo_activity_attr_key_not_available | 营销活动属性key为空或不存在 | 请检查营销活动属性的 key 是否为空以及是否存在 |
| promo_activity_not_available | 营销活动不可用 | 营销活动不可用 |
| promo_activity_operate_error | 营销活动操作异常 | 请根据接口返回的错误信息，检查请求参数，修改后重新发起 |