上架/下架商品

接口描述

如果其余可售卖条件满足，该接口可作为被商家操作上架、下架商品。

URL

/ark/open_api/v1/item/{item_id}/availability

URL Parameters

字段名称 类型 说明
item_id String 商品 ID

Method

PUT

Request Body

{
   "available": true
}

Request Parameter

字段名称 类型 说明
available Bool true为上架 false为下架

Response 200 (application/json;charset=utf-8)

{
    "error_code": 0,
    "data": {
        "spvs": [],
        "items": [
            {
                "spu_id": "58d1de0dc9d75913647aceb5",
                "update_time": 1491919202,
                "ename": null,
                "name": "RED 森林小妖精尖头系带平底鞋 黑色 36",
                "skucode": "6907315906864",
                "barcode": "6907315906864",
                "original_price": 699.0,
                "tax": 52.700000000000003,   
                "pre_tax_price": 200.0,   
                "price": 252.69999999999999,  
                "tax_rate": 0.26350000000000001,
                "available": false,
                "buyable": false,
                "spv_id": "58d1e19ec9d759133168f1cc",
                "state": 1,
                "create_time": 1490149790,
                "pending_changes": null,
                "status": 2,
                "spl_id": "58d1e19dc9d759133168f1cb",
                "top_image": null,
                "id": "58d1e19ec9d759133168f1ce",
                "barcode_type": "upc"
            }
        ],
        "spls": [],
        "spus": [],
        "spl_items": []
    },
    "error_msg": null,
    "success": true
}

Response parameters

名称 类型 说明
pending_changes Array 待审核的更改信息
spus Array SPU模块信息
spls Array SPL模块信息
spl_items Array SPL ITEM模块信息
spvs Array SPV模块信息
items Array ITEM模块信息
id String ITEM ID
available Bool true为可选择上架，false为不可选择上架
buyable Bool true为可售卖，实际上架状态， false为不可售卖，实际下架状态
top_image String 天王图
create_time Int 商品创建时间
update_time Int 最后更新时间
original_price Float 商品原价
tax Float 税金
pre_tax_price Float 税前价,跨境税商家必填
price Float 税后价,非跨境税商家必填
tax_rate Float 税率

补充说明

  1. state & status 具体状态码请参考商品状态码

  2. 商品的available字段标识商家可以操控的商品的上下架操作，商品的buyable字段标识商品的可售卖状态（实际的上下架状态），当商品available为true时，且其他可售卖必备的信息都满足时（图片、描述、海关备案信息等）商品的可售卖状态（buyable）自动会变成true。