小程序本地商品免审更新商品接口

开发环境

http://dev-cn.your-api-server.com

POST

/v3/alipay/open/app/localitem/direct/modify

商品免审更新接口。正常情况下，修改商品的基础字段等信息都是需要审核的，通过免审更新接口，商家可以直接修改商品及其SKU的售卖状态、库存信息、价格等信息。免审更新是基于线上版商品数据进行操作的（如果最新版商品处于审核中，会基于免审更新的数据同步更新到最新版商品中）

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/app/localitem/direct/modify' \
--header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw '{
	"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":[
		{
			"sale_price":30,
			"original_price":30,
			"sale_status":"AVAILABLE",
			"stock_num":99999
		}
	],
	"attrs":[
		{
			"attr_key":"key1",
			"attr_value":"value1"
		}
	]
}'

响应示例

200 - 成功示例

{
	"out_item_id":"12345",
	"item_id":"2023010122000000000001",
	"skus":[
		{
			"sku_id":"2023010123000000000001",
			"out_sku_id":"99999"
		}
	]
}

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

item_id

string

必需

【描述】支付宝平台侧商品ID，是支付宝平台侧商品的唯一标识，后续与平台交互，需要使用该 ID，建议持久化。该字段特殊可选，与out_item_id不能同时为空，优先使用item_id。【示例值】2023010100000000000001

out_item_id

string

必需

【描述】商家侧商品ID，要求 APPID 下全局唯一。该字段特殊可选，与item_id不能同时为空，优先使用item_id。【示例值】BEIJINGKAOYA

sold_time

object

必需

【描述】start_time描述售卖开始时间，end_time描述售卖结束时间，时间格式均为yyyy-MM-dd HH:mm:ss

start_time

string

必需

【描述】开始时间，格式为yyyy-MM-dd HH:mm:ss 【示例值】2023-01-01 10:00:00

end_time

string

必需

【描述】结束时间，格式为yyyy-MM-dd HH:mm:ss 【示例值】2023-01-01 10:00:00

skus

array [object {4}]

必需

【描述】sku数组【注意事项】免审更新不支持修改商品原价，原价不能小于等于售价，或者设置为0、负数

sale_price

integer

必需

【描述】sku售价，分为单位。（代金券对应代金券价格）【示例值】30

original_price

integer

可选

【描述】sku原价，分为单位。（代金券对应代金券面额）【示例值】30

sale_status

string

必需

【描述】sku售卖状态，包含以下两种状态：已下架(DELISTING) 可售卖(AVAILABLE) 已下架: DELISTING 可售卖: AVAILABLE 【枚举值】已下架: DELISTING 可售卖: AVAILABLE 【示例值】AVAILABLE

stock_num

integer

可选

【描述】商品sku库存【示例值】99999

attrs

array [object {2}]

可选

【描述】商品属性列表【注意事项】该字段仅支持传入允许免审更新的属性，详见本地生活商品模版

attr_key

string

可选

attr_value

string

可选

示例

返回响应

🟢200成功

application/json

Body

out_item_id

string

必需

【描述】商家侧商品ID，要求 APPID 下全局唯一. 【示例值】12345

item_id

string

必需

【描述】支付宝平台侧商品ID，是支付宝平台侧商品的唯一标识，后续与平台交互，需要使用该 ID，建议持久化。【示例值】2023010122000000000001

skus

array [object {2}]

必需

【描述】sku数组

sku_id

string

必需

【描述】支付宝平台侧商品sku的唯一标识，后续与平台交互，需要使用该 ID，建议持久化。【示例值】2023010123000000000001

out_sku_id

string

必需

【描述】商家侧sku ID，APPID 下全局唯一。【注意事项】如果是普通商品，该字段值由创建、更新接口传入；如果是本地生活商品，该字段值由系统自动设置，保持和out_item_id一致【示例值】99999

🟠400请求有误

修改于 2023-11-21 09:17:14

小程序本地商品创建

小程序本地商品修改接口