文档中心 > API类目 > 天猫供应链

taobao.logistics.warehouse.resource.update (服务商新建/更新仓)

服务商新建/更新仓

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
warehouse_update_request WarehouseUpdateRequest 必须 创建/更新仓入参
  • └ request_time
  • Number
  • 必须
  • 1689067417799
  • 业务请求时间戳(毫秒)
  • └ request_id
  • String
  • 必须
  • xxx1689067417799xxx
  • 业务请求ID(服务商发起请求的ID)
  • └ supplier_id
  • String
  • 必须
  • 1000001
  • 淘天物流服务商ID
  • warehouse_infos
  • WarehouseInfo []
  • 必须
  • 仓信息数组
  • └ warehouse_code
  • String
  • 必须
  • whCode1
  • 服务商自定义的仓编码,服务商+业务身份下唯一
  • └ warehouse_name
  • String
  • 必须
  • 物流仓
  • 服务商自定义的仓库名称,创建时必填
  • └ wms_store_code
  • String
  • 必须
  • wmsWhCode1
  • WMS系统仓code,创建时必填
  • └ wms_appkey
  • String
  • 必须
  • 192042
  • WMSAppkey,创建时必填
  • └ status
  • Number
  • 可选
  • 1
  • 状态:0=停用,1=启用;创建默认启用
  • └ province
  • String
  • 可选
  • 浙江省
  • 省份,string(15),不支持更新,创建时必填
  • └ city
  • String
  • 可选
  • 杭州市
  • 城市,string(15),不支持更新,创建时必填
  • └ area
  • String
  • 可选
  • 余杭区
  • 地区,string(15),不支持更新,创建时必填
  • └ town
  • String
  • 可选
  • 五常街道
  • 乡镇,string(15),不支持更新,创建时必填
  • └ detail_address
  • String
  • 必须
  • 浙江省杭州市余杭区五常街道
  • 详细地址,string(50),不支持更新,创建时必填
  • └ zip_code
  • String
  • 可选
  • 92384
  • 邮编,string(15
  • contact_infos
  • ContactInfo []
  • 必须
  • 联系人信息;(组),创建时必填
  • └ type
  • String
  • 必须
  • kn
  • 联系人分组,string(50),mr=默认组,th=退货组,kf=客服组,rk=入库组,ck=出库组,kn=库内组,sw=商务组
  • └ name
  • String
  • 必须
  • 客服
  • 联系人名称,string(20)
  • └ mobile
  • String
  • 必须
  • 13333333333
  • 联系人手机,string(20)
  • └ tel
  • String
  • 可选
  • 21314123
  • 固定电话 ,string(20)
  • extend_info
  • ExtendInfo
  • 可选
  • 仓拓展信息,创建时必填
  • └ daily_order_quantity
  • Number
  • 可选
  • 1029
  • 日均单量,创建时必填
  • └ max_outbound_capacity
  • Number
  • 可选
  • 1
  • 峰值出库能力,创建时必填 1:小于日常20倍 2:大于等于日常20倍小于50倍 3:大于等于日常50倍
  • └ platform_delivery_codes
  • String []
  • 可选
  • 顺丰
  • 合作快递公司编码列表;最多50个,创建时必填
  • └ storage_area
  • Number
  • 可选
  • 1000
  • 仓储面积(m³),创建时必填
  • └ b2c_experience
  • Number
  • 可选
  • 1
  • B2C经验:创建时必填 1:小于1年 2:大于等于1,小于2年 3:大于等于2,小于5年 4:大于等于5年
  • └ goods_categories
  • String []
  • 可选
  • 10,11
  • 优势品类:创建时必填 10=医药健康;11=宠物用品;12=家装家居;13=家清用品;14=母婴亲子;15=美妆个护;16=图书音像;17=服装服饰;18=箱包配件;19=汽车用品;20=电子产品;21=玩具潮玩;22=生鲜;23=运动户外;24=食品
  • └ additional_services
  • String []
  • 可选
  • 1,2
  • 增值服务:创建时必填 1=商品有效期管理;2=冷链储运;3=包裹内物品整理;4=礼盒打包;5=商品定制服务;6=送货上门;7=订单仓内拦截;8=订单仓外拦截
  • └ warehouse_type
  • Number
  • 可选
  • 1
  • 仓库类型:创建时必填 1=平库;2=楼库;3=高台库;4=立体仓库
  • └ fire_safety_qualification
  • Number
  • 可选
  • 1
  • 消防资质:创建时必填 1=甲类;2=乙一类;3=乙二类;4=丙一类;5=丙二类;6=丁类;7=戊类
  • └ lease_qualification
  • Number
  • 可选
  • 1
  • 租赁资质:创建时必填 1=租赁物业;2=自建物业
  • └ insurance_contract
  • Number
  • 可选
  • 1
  • 保险合同 1=基本险;2=综合险;3=一切险
  • └ fire_safety_acceptances
  • String []
  • 可选
  • ["xxx","xxxxxx"]
  • 消防验收凭证链接(仅支持png、jpg、jpge格式,最多6张,每张大小不超过10M):创建时必填
  • └ ownership_proofs
  • String []
  • 可选
  • ["xxx","xxxxxx"]
  • 租赁/产权证明链接(仅支持png、jpg、jpge格式,最多6张,每张大小不超过10M):创建时必填
  • └ wh_insurance_policies
  • String []
  • 可选
  • ["xxx","xxxxxx"]
  • 仓库/货品保险单链接(仅支持png、jpg、jpge格式,最多6张,每张大小不超过10M)
  • └ wh_interior_pictures
  • String []
  • 可选
  • ["xxx","xxxxxx"]
  • 仓内图片链接(仅支持png、jpg、jpge格式,最多6张,每张大小不超过10M):创建时必填
  • └ business_licenses
  • String []
  • 可选
  • ["xxx","xxxxxx"]
  • 营业执照链接(仅支持png、jpg、jpge格式,最多6张,每张大小不超过10M):创建时必填
  • └ introduction_video
  • String
  • 可选
  • xxxxxx
  • 介绍视频链接(仅支持mov、mp4、avi格式,大小不超过20M建议上传仓内作业视频。且不能露出人脸)
  • └ service_products
  • String []
  • 可选
  • ["xxx","xxxxxx"]
  • 服务产品列表

响应参数

名称 类型 示例值 描述
warehouse_update_response WarehouseUpdateResponse 创建/更新仓出参
  • └ success
  • Boolean
  • true
  • true|false
  • └ code
  • String
  • UPDATE_FAIL
  • 响应码
  • └ message
  • String
  • 更新失败
  • 响应信息
  • └ result
  • String
  • 1
  • 0=全部失败,1=全部成功,2=部分成功
  • data
  • WarehouseResultDetail []
  • 处理失败的仓(组)
  • └ code
  • String
  • UPDATE_FAIL
  • 错误码
  • └ message
  • String
  • 更新失败
  • 错误信息
  • └ warehouse_code
  • String
  • whCode1
  • 服务商自定义的仓编码,服务商+业务身份下唯一,string(50)

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LogisticsWarehouseResourceUpdateRequest req = new LogisticsWarehouseResourceUpdateRequest();
LogisticsWarehouseResourceUpdateRequest.WarehouseUpdateRequest obj1 = new LogisticsWarehouseResourceUpdateRequest.WarehouseUpdateRequest();
obj1.setRequestTime(1689067417799L);
obj1.setRequestId("xxx1689067417799xxx");
obj1.setSupplierId("1000001");
List<LogisticsWarehouseResourceUpdateRequest.WarehouseInfo> list3 = new ArrayList<LogisticsWarehouseResourceUpdateRequest.WarehouseInfo>();
LogisticsWarehouseResourceUpdateRequest.WarehouseInfo obj4 = new LogisticsWarehouseResourceUpdateRequest.WarehouseInfo();
list3.add(obj4);
obj4.setWarehouseCode("whCode1");
obj4.setWarehouseName("物流仓");
obj4.setWmsStoreCode("wmsWhCode1");
obj4.setWmsAppkey("192042");
obj4.setStatus(1L);
obj4.setProvince("浙江省");
obj4.setCity("杭州市");
obj4.setArea("余杭区");
obj4.setTown("五常街道");
obj4.setDetailAddress("浙江省杭州市余杭区五常街道");
obj4.setZipCode("92384");
List<LogisticsWarehouseResourceUpdateRequest.ContactInfo> list7 = new ArrayList<LogisticsWarehouseResourceUpdateRequest.ContactInfo>();
LogisticsWarehouseResourceUpdateRequest.ContactInfo obj8 = new LogisticsWarehouseResourceUpdateRequest.ContactInfo();
list7.add(obj8);
obj8.setType("kn");
obj8.setName("客服");
obj8.setMobile("13333333333");
obj8.setTel("21314123");
list5.setContactInfos(list7);
LogisticsWarehouseResourceUpdateRequest.ExtendInfo obj10 = new LogisticsWarehouseResourceUpdateRequest.ExtendInfo();
obj10.setDailyOrderQuantity(1029L);
obj10.setMaxOutboundCapacity(1L);
obj10.setPlatformDeliveryCodes("顺丰");
obj10.setStorageArea(1000L);
obj10.setB2cExperience(1L);
obj10.setGoodsCategories("10,11");
obj10.setAdditionalServices("1,2");
obj10.setWarehouseType(1L);
obj10.setFireSafetyQualification(1L);
obj10.setLeaseQualification(1L);
obj10.setInsuranceContract(1L);
obj10.setFireSafetyAcceptances(""xxx","xxxxxx"");
obj10.setOwnershipProofs(""xxx","xxxxxx"");
obj10.setWhInsurancePolicies(""xxx","xxxxxx"");
obj10.setWhInteriorPictures(""xxx","xxxxxx"");
obj10.setBusinessLicenses(""xxx","xxxxxx"");
obj10.setIntroductionVideo("xxxxxx");
obj10.setServiceProducts(""xxx","xxxxxx"");
list9.setExtendInfo(obj10);
obj1.setWarehouseInfos(list3);
req.setWarehouseUpdateRequest(obj1);
LogisticsWarehouseResourceUpdateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<logistics_warehouse_resource_update_response>
    <warehouse_update_response>
        <success>true</success>
        <code>UPDATE_FAIL</code>
        <message>更新失败</message>
        <result>1</result>
        <data>
            <warehouse_result_detail>
                <code>UPDATE_FAIL</code>
                <message>更新失败</message>
                <warehouse_code>whCode1</warehouse_code>
            </warehouse_result_detail>
        </data>
    </warehouse_update_response>
</logistics_warehouse_resource_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

返回
顶部