文档中心 > API类目 > 零售终端API

tmall.nr.item.itemstate.update (天鲜配商品上下架状态编辑)

天鲜配业务编辑商品上下架状态

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_dto ItemStateUpdateDto 可选 商品模型
  • └ biz_code
  • String
  • 可选
  • txp
  • 业务编码
  • item_status
  • ItemStatusEnum
  • 可选
  • 商品上、下架状态(9是上架、-9是下架)
  • └ name
  • String
  • 可选
  • NORMAL
  • 1
  • └ item_id
  • Number
  • 可选
  • 100
  • itemId
  • └ store_id
  • Number
  • 可选
  • 100
  • 所属门店ID,主商品storeId = 0
options ItemUpdateOptions 可选 门店商品更新可选项
  • └ use_item_update_do
  • Boolean
  • 可选
  • true
  • 更新ic商品时,是否以门店中台为主
  • └ update_target_category_id
  • Boolean
  • 可选
  • true
  • 修改状态
  • └ channel_switches
  • String
  • 可选
  • {}
  • 需要同步的渠道列表,只用于商品发布、编辑时异步同步给饿了么等渠道
  • └ sync_store
  • Boolean
  • 可选
  • true
  • 是否同步给门店,默认同步;只有连锁管理模式才会有效
  • └ ic_options
  • Number []
  • 可选
  • 100,200
  • 同步到ic的options,仅syncIC=true时有效
  • └ extends_map
  • String
  • 可选
  • {}
  • 额外的扩展信息
  • └ update_status
  • Boolean
  • 可选
  • true
  • 修改状态
  • └ only_update_child_item
  • Boolean
  • 可选
  • true
  • 仅批量更新子商品
  • └ scene
  • String
  • 可选
  • txp
  • 价格更新场景 透传给异步任务使用
  • └ store_id_list
  • Number []
  • 可选
  • [100,200]
  • 需要同步的门店ID列表,syncStore = true时,不能为空
  • └ sync_ic
  • Boolean
  • 可选
  • true
  • 是否同步到IC,默认同步
  • └ sync_item_state
  • Boolean
  • 可选
  • true
  • 是否同步商品状态到IC

响应参数

名称 类型 示例值 描述
succ Boolean true 是否成功
sys_code String 0 错误码
sys_message String 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrItemItemstateUpdateRequest req = new TmallNrItemItemstateUpdateRequest();
TmallNrItemItemstateUpdateRequest.ItemStateUpdateDto obj1 = new TmallNrItemItemstateUpdateRequest.ItemStateUpdateDto();
obj1.setBizCode("txp");
TmallNrItemItemstateUpdateRequest.ItemStatusEnum obj2 = new TmallNrItemItemstateUpdateRequest.ItemStatusEnum();
obj2.setName("NORMAL");
obj1.setItemStatus(obj2);
obj1.setItemId(100L);
obj1.setStoreId(100L);
req.setItemDto(obj1);
TmallNrItemItemstateUpdateRequest.ItemUpdateOptions obj3 = new TmallNrItemItemstateUpdateRequest.ItemUpdateOptions();
obj3.setUseItemUpdateDo(true);
obj3.setUpdateTargetCategoryId(true);
obj3.setChannelSwitches("{}");
obj3.setSyncStore(true);
obj3.setIcOptions(new Long[] { 100,200 };
);
obj3.setExtendsMap("{}");
obj3.setUpdateStatus(true);
obj3.setOnlyUpdateChildItem(true);
obj3.setScene("txp");
obj3.setStoreIdList(new Long[] { 100,200 };
);
obj3.setSyncIc(true);
obj3.setSyncItemState(true);
req.setOptions(obj3);
TmallNrItemItemstateUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_nr_item_itemstate_update_response>
    <succ>true</succ>
    <sys_code>0</sys_code>
    <sys_message></sys_message>
</tmall_nr_item_itemstate_update_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部