通用场景
保存本地商品日历价格
公共请求参数
业务请求参数
以下参数 二选一 传入必选
item_id｜平台侧商品idstring[16,64]
【描述】支付宝平台侧商品id，是支付宝平台侧商品的唯一标识，后续与平台交互，需要使用该 id，建议持久化。该字段特殊可选，与out_item_id不能同时为空，优先使用item_id。
【示例值】2023010100000000000001
out_item_id｜商家侧商品idstring[4,100]
【描述】商家侧商品id，要求 appid 下全局唯一。该字段特殊可选，与item_id不能同时为空，优先使用item_id。
【示例值】beijingkaoya
calendar_prices｜日历价格列表条件必选array
【描述】日历价格列表（商品维度），价格设置的总天数不得大于60天
【注意事项】与sku维度列表二选其一，若价格需挂载在商品下，则传入该列表。
【必选条件】商品维度价格列表（与sku维度价格列表 二选一）
start_date｜价格的有效开始日期必选string[10,10]
【描述】价格的有效开始日期。 等于或晚于当前日期且在365天内(即不接收365天后的数据)， 有效开始日期和有效结束日期之间的间隔最大为60天。格式：yyyy-mm-dd 如2023-09-26
【示例值】2023-09-26
end_date｜价格的有效截止日期必选string[10,10]
【描述】价格的有效截止日期。 等于或晚于当前日期且在365天内(即不接收365天后的数据) ，有效开始日期和有效结束日期之间的间隔最大为60天。格式：yyyy-mm-dd 如2023-09-26
【示例值】2023-09-26
status｜价格的状态必选number[0,1]
【描述】价格的状态，1:有效/0:删除
【示例值】1
exclude_dates｜日历中排除某些日期可选array[0,60]
【描述】日历中排除某些日期，如["2023-10-01","2023-10-02","2023-10-03"]
【示例值】["2023-10-01","2023-10-02","2023-10-03"]
original_price｜原价可选number[0,99999999]
【描述】原价，单位:分，为非负数。为空则不创建或更新。
【示例值】10000
sale_price｜售价可选number[0,99999999]
【描述】售价，单位:分，为非负数。为空则不创建或更新。
【示例值】5000
sku_calendar_prices｜sku维度日历价格列表条件必选array
【描述】日历价格列表（sku维度），价格设置的总天数不得大于60天。
【注意事项】与商品维度列表二选其一，若库存需挂载在sku下，则传入该列表。
【必选条件】sku维度价格列表（与商品维度价格列表 二选一）
out_sku_id｜商家侧skuid必选string[1,64]
【描述】商家侧skuid,必须是商家提报商品时所填的商家侧skuid
【示例值】xxxxxx
calendar_prices｜日历价格列表必选array
【描述】日历价格对象列表，用于描述一段时间的价格
start_date｜价格的有效开始日期必选string[10,10]
【描述】价格的有效开始日期。 等于或晚于当前日期且在365天内(即不接收365天后的数据)， 有效开始日期和有效结束日期之间的间隔最大为60天。格式：yyyy-mm-dd 如2023-09-26
【示例值】2023-09-26
end_date｜价格的有效截止日期必选string[10,10]
【描述】价格的有效截止日期。 等于或晚于当前日期且在365天内(即不接收365天后的数据) ，有效开始日期和有效结束日期之间的间隔最大为60天。格式：yyyy-mm-dd 如2023-09-26
【示例值】2023-09-26
status｜价格的状态必选number[0,1]
【描述】价格的状态，1:有效/0:删除
【示例值】1
exclude_dates｜日历中排除某些日期可选array[0,60]
【描述】日历中排除某些日期，如["2023-10-01","2023-10-02","2023-10-03"]
【示例值】["2023-10-01","2023-10-02","2023-10-03"]
original_price｜原价可选number[0,99999999]
【描述】原价，单位:分，为非负数。为空则不创建或更新。
【示例值】10000
sale_price｜售价可选number[0,99999999]
【描述】售价，单位:分，为非负数。为空则不创建或更新。
【示例值】5000
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.app.localitem.calendarprice.save&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"item_id":"2023010100000000000001",
"out_item_id":"beijingkaoya",
"calendar_prices":[
{
"end_date":"2023-09-26",
"exclude_dates":[
"2023-10-01",
"2023-10-02",
"2023-10-03"
],
"original_price":10000,
"sale_price":5000,
"start_date":"2023-09-26",
"status":1
}
],
"sku_calendar_prices":[
{
"out_sku_id":"xxxxxx",
"calendar_prices":[
{
"end_date":"2023-09-26",
"exclude_dates":[
"2023-10-01",
"2023-10-02",
"2023-10-03"
],
"original_price":10000,
"sale_price":5000,
"start_date":"2023-09-26",
"status":1
}
]
}
]
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_open_app_localitem_calendarprice_save_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| item_null | 商品不存在 | 商品不存在，检查入参是否有误 |
| item_sku_not_exist | 商品sku信息不存在 | 商品sku不存在，请检查入参是否有误 |
| permission_check_error | 权限检查失败，确认当前请求账号是否匹配当前传入pid或alipay_app_id，或已做相关授权 | 确认当前请求账号是否匹配当前传入pid或alipay_app_id，或已做相关授权 |