文档中心 > API类目 > 天猫新零售

tmall.nr.item.tag.ops (区域零售商品打标去标)

参加区域零售的商品,需要批量打标或去标,方便后续设置商品库存

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tag_req_d_t_o TagReqDto 必须 请求入参
  • └ type
  • Number
  • 必须
  • 1
  • 商品标操作类型,1:打标,2:去标
  • └ seller_id
  • Number
  • 必须
  • 3524355
  • 商家编码
  • └ item_ids
  • Number []
  • 必须
  • 12325354434
  • 商品编码列表
  • └ biz_identity
  • String
  • 可选
  • dss
  • 业务身份标识,dss定时送;FN蜂鸟,CN菜鸟
  • └ trace_id
  • String
  • 可选
  • 234231321323
  • 信息追踪串,用于后续排查问题,以及与外部厂商对账等场景下使用

响应参数

名称 类型 示例值 描述
result NewRetailResult result 返回结果
  • result_data
  • TagRespDto
  • TagRespDto
  • 请求结果
  • └ descs
  • String []
  • 商品不存在
  • 失败描述
  • └ fail_ids
  • Number []
  • 11233434
  • 失败商品编码
  • └ success_ids
  • Number []
  • 21233434
  • 成功商品编码
  • └ error_message
  • String
  • ErrorMessage
  • 错误信息
  • └ error_code
  • String
  • ErrorCode
  • 错误编码
  • └ success_flag
  • Boolean
  • true
  • 成功或者失败

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrItemTagOpsRequest req = new TmallNrItemTagOpsRequest();
TmallNrItemTagOpsRequest.TagReqDto obj1 = new TmallNrItemTagOpsRequest.TagReqDto();
obj1.setType(1L);
obj1.setSellerId(3524355L);
obj1.setItemIds(new Long[] { 12325354434 };
);
obj1.setBizIdentity("dss");
obj1.setTraceId("234231321323");
req.setTagReqDTO(obj1);
TmallNrItemTagOpsResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_nr_item_tag_ops_response>
    <result>
        <result_data>
            <descs>
                <string>商品不存在</string>
            </descs>
            <fail_ids>
                <number>11233434</number>
            </fail_ids>
            <success_ids>
                <number>21233434</number>
            </success_ids>
        </result_data>
        <error_message>ErrorMessage</error_message>
        <error_code>ErrorCode</error_code>
        <success_flag>true</success_flag>
    </result>
</tmall_nr_item_tag_ops_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

返回
顶部