通用场景
商品免审更新接口。正常情况下，修改商品的基础字段等信息都是需要审核的，通过免审更新接口，商家可以直接修改商品及其sku的售卖状态、库存信息、价格等信息。免审更新是基于线上版商品数据进行操作的（如果最新版商品处于审核中，会基于免审更新的数据同步更新到最新版商品中）
公共请求参数
业务请求参数
skus｜sku数组必选array
【描述】sku数组
【注意事项】免审更新不支持修改商品原价，原价不能小于等于售价，或者设置为0、负数
sale_price｜sku售价必选number[0,9999999999]
【描述】sku售价，分为单位。（代金券对应代金券价格）
【示例值】30
sale_status｜sku售卖状态必选string[1,16]
【描述】sku售卖状态，包含以下两种状态： 已下架(delisting) 可售卖(available) 已下架: delisting 可售卖: available
【枚举值】
已下架: delisting
可售卖: available
【示例值】available
original_price｜sku原价可选number[0,9999999999]
【描述】sku原价，分为单位。（代金券对应代金券面额）
【示例值】30
stock_num｜商品sku库存可选number[0,9999999999]
【描述】商品sku库存
【示例值】99999
limit_type｜商品sku库存限制类型可选string[1,32]
该参数已废弃
由新字段stock_limit_type代替
【描述】支持限制库存和不限库存的相互转换
【枚举值】
不限库存: 0
限库存: 1
【示例值】1
stock_limit_type｜商品sku库存限制类型可选string[1,32]
【描述】支持限制库存和不限库存的相互转换
【枚举值】
不限库存: 0
限库存: 1
【示例值】1
sku_id｜支付宝平台侧skuid可选string[1,64]
【描述】支付宝平台侧sku id
该参数值只允许为数字加字母
【示例值】2023010123000000000001
out_sku_id｜商家侧skuid可选string[1,64]
【描述】商家侧sku id，要求 appid 下全局唯一。
该参数值只允许为数字加字母
【示例值】99999
item_id｜支付宝平台侧商品id条件必选string[1,64]
【描述】支付宝平台侧商品id，是支付宝平台侧商品的唯一标识，后续与平台交互，需要使用该 id，建议持久化。该字段特殊可选，与out_item_id不能同时为空，优先使用item_id。
【必选条件】该字段特殊可选，与item_id不能同时为空，优先使用item_id。
【示例值】2023010100000000000001
out_item_id｜商家侧商品id条件必选string[1,100]
【描述】商家侧商品id，要求 appid 下全局唯一。该字段特殊可选，与item_id不能同时为空，优先使用item_id。
【必选条件】该字段特殊可选，与item_id不能同时为空，优先使用item_id。
【示例值】beijingkaoya
sold_time｜售卖时间可选timerangestructvo
【描述】start_time描述售卖开始时间，end_time描述售卖结束时间，时间格式均为yyyy-mm-dd hh:mm:ss
【注意事项】免审更新仅支持修改售卖结束时间
start_time｜开始时间必选string[1,30]
【描述】开始时间，格式为yyyy-mm-dd hh:mm:ss
【示例值】2023-01-01 10:00:00
end_time｜结束时间必选string[1,30]
【描述】结束时间，格式为yyyy-mm-dd hh:mm:ss
【示例值】2023-01-01 10:00:00
attrs｜属性列表可选array
【描述】商品属性列表
【注意事项】该字段仅支持传入允许免审更新的属性，详见本地生活商品模版
attr_key｜商品属性key必选string[1,40]
【描述】商品属性key
【示例值】key1
attr_value｜商品属性value必选string[1,102400]
【描述】商品属性value
【示例值】value1
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.app.localitem.direct.modify&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",
"sold_time":{
"start_time":"2023-01-01 10:00:00",
"end_time":"2023-01-01 10:00:00"
},
"skus":[
{
"out_sku_id":"99999",
"original_price":30,
"stock_limit_type":"1",
"stock_num":99999,
"sale_status":"available",
"sku_id":"2023010123000000000001",
"sale_price":30
}
],
"attrs":[
{
"attr_key":"key1",
"attr_value":"value1"
}
]
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
out_item_id｜商家侧商品id必选string(100)
【描述】商家侧商品id，要求 appid 下全局唯一.
【示例值】12345
item_id｜支付宝平台侧商品id必选string(64)
【描述】支付宝平台侧商品id，是支付宝平台侧商品的唯一标识，后续与平台交互，需要使用该 id，建议持久化。
【示例值】2023010122000000000001
skus｜sku数组必选itemskuidpair[]
【描述】sku数组
sku_id｜支付宝平台侧sku id必选string(64)
【描述】支付宝平台侧商品sku的唯一标识，后续与平台交互，需要使用该 id，建议持久化。
【示例值】2023010123000000000001
out_sku_id｜商家侧sku id必选string(100)
【描述】商家侧sku id，appid 下全局唯一。
【注意事项】如果是普通商品，该字段值由创建、更新接口传入；
如果是本地生活商品，该字段值由系统自动设置，保持和out_item_id一致
【示例值】99999
响应示例
正常示例
异常示例
{
"alipay_open_app_localitem_direct_modify_response": {
"code": "10000",
"msg": "success",
"out_item_id": "12345",
"item_id": "2023010122000000000001",
"skus": [
{
"sku_id": "2023010123000000000001",
"out_sku_id": "99999"
}
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| item_already_exist | 商品已经存在 | 请确认商品信息 |
| item_attr_rule_check_error | 属性规则校验不通过 | 请检查提交的属性字段是否正确 |
| item_cannot_op_when_activity | 商品在活动中不可修改 | 商品在活动中不可修改，请等待活动结束 |
| item_null | 线上版商品查询不到 | 请确定商品编码或商品状态 |
| item_sku_not_exist | 商品sku不存在 | 请检查商品的sku_id是否存在 |
| mini_app_not_online | 小程序未上架 | 请先上架当前小程序 |
| permission_check_error | 权限校验失败 | 确认当前请求账号是否匹配当前传入pid或alipay_app_id，或已做相关授权 |