小程序本地商品创建
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/open/app/localitem/create
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | SYSTEM_ERROR | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| 400 | INVALID_PARAMETER | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| 400 | CAT_ID_NULL | 参数有误类目ID不能为空 | 请传入可用的类目ID |
| 400 | CAT_LICENSE_NO_PERMISSION | 类目资质未申请 | 请先申请类目资质 |
| 400 | CAT_NOT_ACCESS | 类目不准入 | 请检查是商品类型/子类型是否有权限创建本地商品 |
| 400 | ITEM_ALREADY_EXIST | 商品已经存在 | 请确认商品信息 |
| 400 | ITEM_ATTR_RULE_CHECK_ERROR | 属性规则校验不通过 | 请检查提交的属性字段是否正确 |
| 400 | ITEM_CAT_NOT_EXIST | 类目不存在 | 请检查类目id是否正确 |
| 400 | ITEM_SETTLE_ACCOUNT_CHECK_FAIL | 账号校验失败 | 请确认商品收款账号是否配置、与当前主体是否关联正确 |
| 400 | ITEM_SHOP_CHECK_FAIL | 本地商品门店校验失败 | 请输入正确的门店id |
| 400 | ITEM_TEMPLATE_NOT_EXIST | 商品模板不存在 | 检查类目是否配置商品模板 |
| 400 | MINI_APP_NOT_ONLINE | 小程序未上架 | 请先上架当前小程序 |
| 400 | PERMISSION_CHECK_ERROR | 权限校验失败 | 确认当前请求账号是否匹配当前传入pid或alipay_app_id，或已做相关授权 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/app/localitem/create' \
--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 '{
"category_id":"C000001234",
"item_type":"1",
"out_item_id":"12345678",
"title":"product_name",
"head_img":"A*pHfaSaEsF_0AAAAAAAAAAAAAATcnAQ",
"image_list":[
"A*pHfaSaEsF_0AAAAAAAAAAAAAATcnAQ"
],
"item_details_page_model":"1",
"path":"alipays://platformapi/startapp?appId=88888&page=test",
"sold_time":{
"start_time":"2023-01-01 10:00:00",
"end_time":"2023-01-01 10:00:00"
},
"merchant_name":"merchant_name",
"customer_service_mobile":{
"phone_type":"1",
"phone_number":"18888888888",
"customer_link":"alipays://*****"
},
"skus":[
{
"sale_price":100,
"original_price":100,
"sale_status":"AVAILABLE",
"stock_num":9999
}
],
"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
返回响应
修改于 2023-11-21 09:15:16