文档中心 > API类目 > 淘宝服饰

taobao.cloth.fulfillment.sync (淘宝服饰平台仓履约单同步)

淘宝服饰平台仓履约单同步

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
req FulfillmentMainOrderTopDTO 可选 请求体
  • └ idempotent_id
  • String
  • 可选
  • 123
  • 操作幂等ID
  • └ event_type
  • String
  • 必须
  • ACCEPTED
  • 事件类型:正向履约:仓已接单ACCEPTED、开始拣选 PICKING、拣选完成 PICKED、已出库 YCK、物流已揽收 WSYLS、已签收 YQS、已拒收 YJS、缺货等待 OUT_OF_STOCK_WAIT、确定缺货无法出货 OUT_OF_STOCK。逆向履约:仓库已签收 SIGNED、质检完成 INSPECTED、已上架 LISTED
  • sub_orders
  • FulfillmentSubOrderTopDTO []
  • 可选
  • subOrders
  • 子单列表
  • └ fulfillment_sub_order_id
  • String
  • 可选
  • FSB00001145023636
  • 子履约单号
  • inspected_result
  • InspectedResult
  • 可选
  • inspectedResult
  • 质检结果
  • └ genuine_quantity
  • Number
  • 可选
  • 1
  • 正品数量
  • defective_infos
  • DefectiveInfo []
  • 可选
  • defectiveInfos
  • 残次品列表
  • └ defective_count
  • Number
  • 可选
  • 1
  • 残次品数量
  • └ defective_reason
  • String
  • 可选
  • 物流原因
  • 残次品原因描述
  • └ defective_responsible
  • String
  • 可选
  • EXPRESS
  • 残次品认责: EXPRESS快递、BUYER买家
  • package_materials_info_list
  • PackageMaterialsInfo []
  • 可选
  • packageMaterialsInfoList
  • 包材信息
  • └ material_type
  • String
  • 可选
  • QPD23*23
  • 包材类型
  • └ use_quantity
  • Number
  • 可选
  • 2
  • 使用数量
  • └ fabric_type
  • String
  • 可选
  • 梭织
  • 织物类型
  • └ goods_category
  • String
  • 可选
  • 牛仔裤
  • 商品品类
  • └ goods_category_code
  • String
  • 可选
  • SZNZK
  • 商品品类编码
  • logistics_info_list
  • LogisticsInfo []
  • 可选
  • logisticsInfoList
  • 物流信息
  • └ logistics_no
  • String
  • 可选
  • SF1030419570000
  • 物流单号
  • └ cp_code
  • String
  • 可选
  • SF
  • 物流公司编码
  • └ cp_name
  • String
  • 可选
  • 顺丰
  • 物流公司名称
  • └ quantity
  • Number
  • 可选
  • 1
  • 数量
  • package_info
  • PackageInfo
  • 可选
  • packageInfos
  • 包裹信息
  • └ weight
  • Number
  • 可选
  • 1220
  • 重量(单位:克)
  • package_materials_info_list
  • PackageMaterialsInfo []
  • 可选
  • packageMaterialsInfoList
  • 包材信息
  • └ material_type
  • String
  • 可选
  • QPD23*23
  • 包材类型
  • └ use_quantity
  • Number
  • 可选
  • 2
  • 使用数量
  • └ all_shipped
  • Boolean
  • 可选
  • true
  • 是否全部发货完成
  • └ related_fulfill_sub_order_ids
  • String []
  • 可选
  • ["xxxx","yyyyy"]
  • 关联所有的子履约单id
  • picked_result
  • PickedResult
  • 可选
  • 拣选结果
  • └ fabric_type
  • String
  • 可选
  • 梭织
  • 织物类型
  • └ goods_category
  • String
  • 可选
  • 牛仔裤
  • 商品品类
  • └ goods_category_code
  • String
  • 可选
  • SZNZJ
  • 商品品类编码
  • └ fulfillment_main_order_id
  • String
  • 必须
  • FB00001170023636
  • 履约单单号

响应参数

名称 类型 示例值 描述
result TResult 返回体
  • └ success
  • Boolean
  • true
  • 调用是否成功
  • └ error_message
  • String
  • 授权异常
  • 错误信息
  • └ error_code
  • String
  • 401
  • 错误码
  • └ data
  • Boolean
  • true
  • 同步是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ClothFulfillmentSyncRequest req = new ClothFulfillmentSyncRequest();
ClothFulfillmentSyncRequest.FulfillmentMainOrderTopDTO obj1 = new ClothFulfillmentSyncRequest.FulfillmentMainOrderTopDTO();
obj1.setIdempotentId("123");
obj1.setEventType("ACCEPTED");
List<ClothFulfillmentSyncRequest.FulfillmentSubOrderTopDTO> list3 = new ArrayList<ClothFulfillmentSyncRequest.FulfillmentSubOrderTopDTO>();
ClothFulfillmentSyncRequest.FulfillmentSubOrderTopDTO obj4 = new ClothFulfillmentSyncRequest.FulfillmentSubOrderTopDTO();
list3.add(obj4);
obj4.setFulfillmentSubOrderId("FSB00001145023636");
ClothFulfillmentSyncRequest.InspectedResult obj6 = new ClothFulfillmentSyncRequest.InspectedResult();
obj6.setGenuineQuantity(1L);
List<ClothFulfillmentSyncRequest.DefectiveInfo> list8 = new ArrayList<ClothFulfillmentSyncRequest.DefectiveInfo>();
ClothFulfillmentSyncRequest.DefectiveInfo obj9 = new ClothFulfillmentSyncRequest.DefectiveInfo();
list8.add(obj9);
obj9.setDefectiveCount(1L);
obj9.setDefectiveReason("物流原因");
obj9.setDefectiveResponsible("EXPRESS");
obj6.setDefectiveInfos(list8);
List<ClothFulfillmentSyncRequest.PackageMaterialsInfo> list11 = new ArrayList<ClothFulfillmentSyncRequest.PackageMaterialsInfo>();
ClothFulfillmentSyncRequest.PackageMaterialsInfo obj12 = new ClothFulfillmentSyncRequest.PackageMaterialsInfo();
list11.add(obj12);
obj12.setMaterialType("QPD23*23");
obj12.setUseQuantity(2L);
obj6.setPackageMaterialsInfoList(list11);
obj6.setFabricType("梭织");
obj6.setGoodsCategory("牛仔裤");
obj6.setGoodsCategoryCode("SZNZK");
list5.setInspectedResult(obj6);
List<ClothFulfillmentSyncRequest.LogisticsInfo> list15 = new ArrayList<ClothFulfillmentSyncRequest.LogisticsInfo>();
ClothFulfillmentSyncRequest.LogisticsInfo obj16 = new ClothFulfillmentSyncRequest.LogisticsInfo();
list15.add(obj16);
obj16.setLogisticsNo("SF1030419570000");
obj16.setCpCode("SF");
obj16.setCpName("顺丰");
obj16.setQuantity(1L);
ClothFulfillmentSyncRequest.PackageInfo obj18 = new ClothFulfillmentSyncRequest.PackageInfo();
obj18.setWeight(1220L);
List<ClothFulfillmentSyncRequest.PackageMaterialsInfo> list20 = new ArrayList<ClothFulfillmentSyncRequest.PackageMaterialsInfo>();
ClothFulfillmentSyncRequest.PackageMaterialsInfo obj21 = new ClothFulfillmentSyncRequest.PackageMaterialsInfo();
list20.add(obj21);
obj21.setMaterialType("QPD23*23");
obj21.setUseQuantity(2L);
obj18.setPackageMaterialsInfoList(list20);
obj18.setAllShipped(true);
obj18.setRelatedFulfillSubOrderIds(""xxxx","yyyyy"");
list17.setPackageInfo(obj18);
list13.setLogisticsInfoList(list15);
ClothFulfillmentSyncRequest.PickedResult obj23 = new ClothFulfillmentSyncRequest.PickedResult();
obj23.setFabricType("梭织");
obj23.setGoodsCategory("牛仔裤");
obj23.setGoodsCategoryCode("SZNZJ");
list22.setPickedResult(obj23);
obj1.setSubOrders(list3);
obj1.setFulfillmentMainOrderId("FB00001170023636");
req.setReq(obj1);
ClothFulfillmentSyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<cloth_fulfillment_sync_response>
    <result>
        <success>true</success>
        <error_message>授权异常</error_message>
        <error_code>401</error_code>
        <data>true</data>
    </result>
</cloth_fulfillment_sync_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

返回
顶部