通用场景
保存本地商品日历库存
公共请求参数
业务请求参数
以下参数 二选一 传入必选
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_stocks｜日历库存列表条件必选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
stock_limit｜限制库存条件必选number[0,1]
【描述】库存限制类型，1:有限库存/0:无限库存。
【必选条件】status为0时，stock_limit可不传；status为1时，stock_limit必传。
【示例值】1
stock_num｜总库存条件必选number[1,9999]
【描述】总库存。
【必选条件】status为0时，stock_num可不传；status为1时，stock_num必传。
【示例值】100
exclude_dates｜日历中排除某些日期可选array[0,60]
【描述】日历中排除某些日期，如["2023-10-01","2023-10-02","2023-10-03"]
【示例值】["2023-10-01","2023-10-02","2023-10-03"]
sku_calendar_stocks｜sku日历库存列表条件必选[0,500]
【描述】日历库存列表（sku维度），库存设置的总天数不得大于60天。
【注意事项】与商品维度列表二选其一，若库存需挂载在sku下，则传入该列表。
【必选条件】sku维度库存列表（与商品维度库存列表 二选一）
out_sku_id｜商家侧skuid必选string[1,64]
【描述】外部skuid，必须为商家提报商品时自定义填写的商家侧skuid
【示例值】xxxxxx
calendar_stocks｜日历库存列表必选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
stock_limit｜限制库存条件必选number[0,1]
【描述】库存限制类型，1:有限库存/0:无限库存。
【必选条件】status为0时，stock_limit可不传；status为1时，stock_limit必传。
【示例值】1
stock_num｜总库存条件必选number[1,9999]
【描述】总库存。
【必选条件】status为0时，stock_num可不传；status为1时，stock_num必传。
【示例值】100
exclude_dates｜日历中排除某些日期可选array[0,60]
【描述】日历中排除某些日期，如["2023-10-01","2023-10-02","2023-10-03"]
【示例值】["2023-10-01","2023-10-02","2023-10-03"]
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.app.localitem.calendarstock.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_stocks":[
{
"end_date":"2023-09-26",
"exclude_dates":[
"2023-10-01",
"2023-10-02",
"2023-10-03"
],
"stock_num":100,
"stock_limit":1,
"start_date":"2023-09-26",
"status":1
}
],
"sku_calendar_stocks":[
{
"out_sku_id":"xxxxxx",
"calendar_stocks":[
{
"end_date":"2023-09-26",
"exclude_dates":[
"2023-10-01",
"2023-10-02",
"2023-10-03"
],
"stock_num":100,
"stock_limit":1,
"start_date":"2023-09-26",
"status":1
}
]
}
]
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_open_app_localitem_calendarstock_save_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| item_null | 商品不存在 | 商品不存在，检查入参是否有误 |
| item_sku_not_exist | 商品sku信息不存在 | 商品sku不存在，请检查入参是否有误 |
| mini_app_not_online | 小程序未上架 | 请先上架当前小程序 |
| permission_check_error | 权限检查失败，确认当前请求账号是否匹配当前传入pid或alipay_app_id，或已做相关授权 | 确认当前请求账号是否匹配当前传入pid或alipay_app_id，或已做相关授权 |