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

tmall.nr.inventory.initial (门店库存初始化前后端商品绑定)

用于门店业务的商品的初始化,前端商品和后端商品绑定,走后端库存模式

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param0 NrStoreInvItemInitialReqDto 可选 请求入参
  • └ user_id
  • Number
  • 必须
  • 2432432
  • 如果是品牌商家填写商家的sellerID,如果是零售商需要填写品牌商的sellerID,但是需要平台授权;
  • └ operation_time
  • String
  • 可选
  • 2016-03-01 10:10:10
  • 操作时间
  • stores
  • StoreDto []
  • 必须
  • 门店信息
  • └ warehouse_type
  • String
  • 必须
  • STORE
  • 库存来源的类型;STORE表示门店
  • └ warehouse_id
  • String
  • 必须
  • 1232421
  • 门店对应的storeID值
  • store_inventories
  • StoreInvetoryDto []
  • 可选
  • 门店商品,最大列表长度:20
  • └ outer_id
  • String
  • 可选
  • XX999
  • 商家的外部商品编码,写入值。
  • └ sku_id
  • Number
  • 可选
  • 432432432
  • sku号
  • └ item_id
  • Number
  • 可选
  • 2432432432
  • 天猫商品id
  • └ sc_item_id
  • Number
  • 可选
  • 3432432432
  • 天猫后端商品id
  • └ bill_num
  • String
  • 必须
  • 23432432432432
  • 单据流水号,用于幂等操作
  • └ inventory_type
  • String
  • 必须
  • CERTAINTY
  • CERTAINTY 表示确定性库存
  • └ quantity
  • Number
  • 可选
  • 100
  • 默认值:0
  • 库存数量
  • └ operator
  • String
  • 可选
  • 张三
  • 操作者

响应参数

名称 类型 示例值 描述
result_data Boolean true 初始化成功
error_message String 商品未授权打标 错误信息提示
error_code2 String errorCode 错误编码
is_success Boolean true isSuccess

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrInventoryInitialRequest req = new TmallNrInventoryInitialRequest();
TmallNrInventoryInitialRequest.NrStoreInvItemInitialReqDto obj1 = new TmallNrInventoryInitialRequest.NrStoreInvItemInitialReqDto();
obj1.setUserId(2432432L);
obj1.setOperationTime("2016-03-01 10:10:10");
List<TmallNrInventoryInitialRequest.StoreDto> list3 = new ArrayList<TmallNrInventoryInitialRequest.StoreDto>();
TmallNrInventoryInitialRequest.StoreDto obj4 = new TmallNrInventoryInitialRequest.StoreDto();
list3.add(obj4);
obj4.setWarehouseType("STORE");
obj4.setWarehouseId("1232421");
List<TmallNrInventoryInitialRequest.StoreInvetoryDto> list7 = new ArrayList<TmallNrInventoryInitialRequest.StoreInvetoryDto>();
TmallNrInventoryInitialRequest.StoreInvetoryDto obj8 = new TmallNrInventoryInitialRequest.StoreInvetoryDto();
list7.add(obj8);
obj8.setOuterId("XX999");
obj8.setSkuId(432432432L);
obj8.setItemId(2432432432L);
obj8.setScItemId(3432432432L);
obj8.setBillNum("23432432432432");
obj8.setInventoryType("CERTAINTY");
obj8.setQuantity(100L);
list5.setStoreInventories(list7);
obj1.setStores(list3);
obj1.setOperator("张三");
req.setParam0(obj1);
TmallNrInventoryInitialResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_nr_inventory_initial_response>
    <result_data>true</result_data>
    <error_message>商品未授权打标</error_message>
    <error_code2>errorCode</error_code2>
    <is_success>true</is_success>
</tmall_nr_inventory_initial_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

返回
顶部