全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
商品免审编辑
接口地址： http://www.yunyingtool.com/papi/tool/erps/ks-autopass-edit
必须用户授权 : 需要用户的授权，才能拿到被授权的数据
请求方式： POST
返回格式： JSON
接口收费： 扣账户余额
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
| 参数名 | 类型 | 必须 | 示例值 | 详情描述 |
|---|---|---|---|---|
| shop_id | String | 是 | 13211 | 店铺 id(可在快手小店获取) |
| itemId | Long | 是 | 3221412313 | 商品唯一 id |
| relItemId | Long | 否 | 16234132132412 | 三方商品 id |
| purchaseLimit | Boolean | 否 | true | 是否限购 |
| limitCount | Integer | 否 | 99 | 限购数量 |
| itemRemark | String | 否 | 商品备注 | 商品备注 |
| skuList | OpenApiAutoPassSkuDTO[] | 否 | [{}] | sku 信息 |
| skuId | Long | 是 | 321231312 | sku 唯一 id |
| skuChangeStock | Long | 是 | 100 | 要更新的库存 |
| skuStockChangeType | Integer | 是 | 1 | 1 增加库存 2 减少库存 3 设置库存 免审编辑只支持 1 和 2 |
| skuSalePrice | Long | 是 | 299 | Sku 价格，单位为分。1 <= 数值 <=9999999 |
| skuMarketPrice | Long | 否 | 355 | 划线价 |
| skuNick | String | 否 | NS3847 | sku 编码，分仓商品必填，SKU 编码仅支持中英文、数字以及特殊字符 |
| relSkuId | Long | 否 | 162312312 | 三方 skuId |
| skuCertificatePropValues | SkuCertificatePropParam | 否 | { "condition": "9 成新", "purchasingChannels": "国行", "batteryEfficiency": "80-90%", "mainBoard": "无维修", "batteryCondition": "原装电池", "screenCondition": "第三方屏幕", "shellCollision": "明显", "reportUrl": "https://m.paipai.com/ppinspect/activeReport?", "qualityInspectionNo": "852180", "sn": "353************625", "shellScratch": "明显", "shellPaint": "明显", "deviceSystem": "无越狱/无 Root" } | 质检参数 |
| serviceRule | ServiceRule | 否 | {} | 服务规则 |
| refundRule | String | 是 | 1 | 退款规则，请求内容为枚举数值，非后面文案： 1:支持 7 天无理由退货 4:不支持 7 天无理由退货 5:支持 7 天无理由退货(拆封后不支持) 6:支持 7 天无理由退货(激活后不支持) 7:支持 7 天无理由退货(安装后不支持) 8:支持 7 天无理由退货(定制类不支持) 9:支持 7 天无理由退货(使用后不支持) ，由 open.item.category.config 获得（退款规则会根据类目变化而变化） |
| deliverGoodsInteralTime | Long | 否 | 345600 | 发货间隔时间，单位：秒，范围在[4,90 天] 需要转换为秒 345600 为 4 天，deliverGoodsInteralTime 和 promiseDeliveryTime 至少填一个且不能都填。填 deliverGoodsInteralTime 代码预售商品，填 promiseDeliveryTime 代表非预售商品。（如果需要取消请传 0 或 -1） |
| promiseDeliveryTime | Long | 否 | 172800 | 非预售商品承诺发货时间，单位：秒，取值 86400,172800,259200,分别代表 24、48、72 小时，deliverGoodsInteralTime 和 promiseDeliveryTime 至少填一个且不能都填。填 deliverGoodsInteralTime 代码预售商品，填 promiseDeliveryTime 代表非预售商品。（如果需要取消请传 0 或 -1） |
| immediatelyOnOfflineFlag | Integer | 否 | 0 | 是否立即上架 ,0 立即上架，1 不立即上架 |
| deliveryMethod | String | 否 | logistics：物流配送（默认） | 发货方式 logistics：物流配送（默认） certificate：电子凭证 |
| expressTemplateId | Long | 否 | 12321321 | 运费模板 Id |
| saleTimeFlag | Boolean | 否 | false | 是否定点开售 |
| timeOfSale | Long | 否 | 1631001896457 | 定点开售时间 |
| payWay | Integer | 否 | 2 | 支付方式：1 货到付款 2 在线支付 3 在线支付和货到付款 |
| vvtype | int | 否 | 1 | 普通版 1，不传默认 1，增强版 2，增强版的需要传参 2 |
请求示例
{
}
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| result | Integer | 1 | 返回码，1 成功 |
| error_msg | String | success | 错误信息 |
| data | AddItemResponseParam | {} | 返回内容 |
| kwaiItemId | Number | 234225423 | 快手商品 id |
| relItemId | Number | 23322112 | 外部商品 id，仅供记录外部商品和快手商品对应关系 |
| skuIdMapping | List | [] | skuIdList |
| kwaiSkuId | Number | 1232141 | 快手商品 sku id |
| relSkuId | Number | 233233 | 外部商品 Sku id，仅供记录外部商品 sku 和快手商品 sku 对应关系 |
| skuNick | String | 123422 | skuNick，sku 编码必须 30 个字符以内 |
| withholding_money | Integer | 该接口扣费金额（点券） |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": {
"result": 1,
"error_msg": "success",
"data": {
"kwaiItemId": 234225423,
"relItemId": 23322112,
"skuIdMapping": [
{
"kwaiSkuId": 1232141,
"relSkuId": 233233,
"skuNick": "123422"
}
]
},"withholding_money":4
}
}
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |