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

tmall.nr.inventory.update (门店业务同步库存)

用于商家每日同步更新门店库存

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param0 NrInventoryUpdateReqDto 可选 入参
  • └ check_mode
  • Number
  • 可选
  • 1
  • 1表示全量,2表示增量
  • └ owner_id
  • Number
  • 可选
  • 1232321
  • 商家的sellerID,如果是零售商需要给品牌的sellerId
  • detail_list
  • NrInventoryCheckDetailDto []
  • 可选
  • 更新库存的列表值
  • └ quantity
  • Number
  • 可选
  • 2
  • 数量
  • └ sc_item_code
  • String
  • 可选
  • X000099
  • 商家的商品编码
  • └ sc_item_id
  • Number
  • 可选
  • 2432432
  • 淘宝后端商品的id号
  • └ sub_order_id
  • String
  • 可选
  • 23432432233
  • 幂等值
  • └ biz_identity
  • String
  • 可选
  • dss
  • 定时送dss,jsd极速达
  • └ order_id
  • String
  • 可选
  • 2432432
  • 幂等值
  • └ store_code
  • String
  • 可选
  • 34324324
  • 门店编号
  • └ store_type
  • Number
  • 可选
  • 6
  • 默认为6:门店库存,2:电商库存

响应参数

名称 类型 示例值 描述
result NrResult result 返回结果
  • result_data
  • InventoryUpdateRespDto
  • resultData
  • 返回数据
  • success_inventorys
  • NrInventoryCheckDetailDto []
  • successInventorys
  • 返回成功的库存记录数
  • └ quantity
  • Number
  • 10
  • 数量
  • └ sc_item_code
  • String
  • X0009
  • 商家商品编码
  • └ sub_order_id
  • String
  • 2343242
  • 幂等值
  • └ sc_item_id
  • Number
  • 432432432
  • 后端商品的Id号
  • fail_inventorys
  • NrInventoryCheckDetailDto []
  • failInventorys
  • 失败的库存更新记录
  • └ sub_order_id
  • String
  • 432432432
  • 幂等值
  • └ sc_item_id
  • Number
  • 432432432
  • 后端商品的Id号
  • └ sc_item_code
  • String
  • X0009
  • 商家商品编码
  • └ quantity
  • Number
  • 10
  • 数量
  • └ error_message
  • String
  • 商品未绑定
  • 更新错误信息提示
  • └ error_code
  • String
  • X001
  • 更新错误code
  • └ is_success
  • Boolean
  • true
  • 废弃,请使用succ
  • └ succ
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrInventoryUpdateRequest req = new TmallNrInventoryUpdateRequest();
TmallNrInventoryUpdateRequest.NrInventoryUpdateReqDto obj1 = new TmallNrInventoryUpdateRequest.NrInventoryUpdateReqDto();
obj1.setCheckMode(1L);
obj1.setOwnerId(1232321L);
List<TmallNrInventoryUpdateRequest.NrInventoryCheckDetailDto> list3 = new ArrayList<TmallNrInventoryUpdateRequest.NrInventoryCheckDetailDto>();
TmallNrInventoryUpdateRequest.NrInventoryCheckDetailDto obj4 = new TmallNrInventoryUpdateRequest.NrInventoryCheckDetailDto();
list3.add(obj4);
obj4.setQuantity(2L);
obj4.setScItemCode("X000099");
obj4.setScItemId(2432432L);
obj4.setSubOrderId("23432432233");
obj1.setDetailList(list3);
obj1.setBizIdentity("dss");
obj1.setOrderId("2432432");
obj1.setStoreCode("34324324");
obj1.setStoreType(6L);
req.setParam0(obj1);
TmallNrInventoryUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_nr_inventory_update_response>
    <result>
        <result_data>
            <success_inventorys>
                <nr_inventory_check_detail_dto>
                    <quantity>10</quantity>
                    <sc_item_code>X0009</sc_item_code>
                    <sub_order_id>2343242</sub_order_id>
                    <sc_item_id>432432432</sc_item_id>
                </nr_inventory_check_detail_dto>
            </success_inventorys>
            <fail_inventorys>
                <nr_inventory_check_detail_dto>
                    <sub_order_id>432432432</sub_order_id>
                    <sc_item_id>432432432</sc_item_id>
                    <sc_item_code>X0009</sc_item_code>
                    <quantity>10</quantity>
                </nr_inventory_check_detail_dto>
            </fail_inventorys>
        </result_data>
        <error_message>商品未绑定</error_message>
        <error_code>X001</error_code>
        <is_success>true</is_success>
        <succ>true</succ>
    </result>
</tmall_nr_inventory_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

返回
顶部