万邑通开发者网站 - 查询入库单详情

API

查询入库单详情

更新时间： 2021-11-12 11:22:54 访问次数：16569

接口说明

通过入库单winit订单号，查询订单和包裹的详细信息。

常用工具

请求说明

URL	https://openapi.winit.com.cn/openapi/service
接口测试	https://sandboxopenapi.winit.com.cn/openapi/service
接口名	winit.wh.inbound.getOrderDetail
验证方法	Token,md5
格式	json
字符编码	UTF-8
http请求方式	http
请求数限制	默认每分钟1000，有需要可申请加大。

请求入参

名称	类型	必填	说明	示例
orderNo	String(50)	Y	WINIT订单号	WI9900001290
isIncludePackage	String(10)	N	返回结果是否包含包裹信息。Y-是,N-否,默认N。	Y

请求示例

Json
XML

{
      "action": " winit.wh.inbound.getOrderDetail",
      "app_key": "rebecca",
      "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
      "client_sign":"3F66F76AE27E3B34991F24DA218CAF05",
    
      "data": {
          "orderNo": "WI9900001290",
          "isIncludePackage": "Y"
      },
      "format": "json",
      "language": "zh_CN",
      "platform": "OWNERERP",
      "sign": "CBA010210F78629ECBEDB05BC1842BF5",
      "sign_method": "md5",
      "timestamp": "2017-09-09 10:17:52",
      "version": "1.0"
}

返回出参

名称	类型	必填	说明	示例
orderNo	String(50)	Y	WINIT订单号
orderType	String(20)	Y	订单类型 SD-标准海外仓入库 DW-直发海外验入库 DI-直发国内验入库
status	String(20)	Y	订单状态 DR-草稿：卖家创建草稿单 OD-已下单：卖家创建订单，但尚未发货。 RE-已收货: Winit承运，国内验货仓已收货。 IC-验货完成： ①标准海外仓入库和标准快递入库，国内验货仓验货完成。 ②自验，自验验货完成。 TS-运输中: ①Winit承运时，国内验货仓出库完成。 ②卖家直发时，卖家确认发货。 PEWC-部分到仓：入库单内部分包裹在海外仓卸货。 EWC-已到仓：入库单内所有无异常(丢失或终止)的包裹在海外仓卸货。 SHD-已上架：入库单内所有无异常(丢失或终止)的包裹在海外仓已上架。 VO-作废:已下单状态下作废的订单。 STOP-终止:运输中状态下终止的订单。
isCompleted	String(50)	Y	订单是否完结 Y-是；N-否 Y-是的定义：包含以下两种场景：（1）入库单内包裹状态全部[上架完成]；（2）入库单包裹存在[终止][丢失]状态，但不存在[上架异常区]状态，并且最后一个包裹上架已经超过1个月。背景：入库单状态切[已上架]后还可能发生上架，因为入库单完全完结，需要有一个持续时间才能做到，尤其是以下（2）和（3）的场景。（1）包裹[上架异常区]：异常待提增值处理，订单先切已上架，后续异常处理完，继续原单上架。（2）包裹[终止]：例如直发部分包裹未到仓，超过一定时间， WINIT认为不会再到仓了执行终止包裹，订单先切已上架，但是后续这部分包裹又到仓继续原单上架。（3）包裹[丢失]：例如仓库先判定包裹丢失，并且已经赔付，订单先切已上架，后续丢失找回，继续原单上架。注意：即使是上架超过1个月被认定[订单完结]，也无法确保100%后续不会再有商品上架，因为上述（2）和（3）的场景也有可能在上架超过1个月后仍然发生。
inspectionWarehouseCode	String(50)	Y	验货仓编码
inspectionWarehouseName	String(50)	Y	验货仓名称
destinationWarehouseCode	String(50)	Y	目的仓编码
destinationWarehouseName	String(50)	Y	目的仓名称
createdDate	String(50)	Y	创建时间	2016-09-09 09:50:54
sellerOrderNo	String(255)	Y	客户订单号
winitProductCode	String(50)	Y	WINIT产品编码
winitProductName	String(60)	Y	WINIT产品名称
planShelfCompletedDate	String(50)	Y	目标上架时间目标上架时间=实际到仓时间+SLA（北京时间）假设实际到仓时间是2016-09-09 09:50:54，SLA是1，那么目标上架时间=2016-09-10 09:50:54	2016-09-09 09:50:54
shelveCompletedDate	String(50)	Y	海外仓实际上架时间北京时间	2019-06-03 17:44:4
totalPackageQty	Int	Y	总包裹数
totalMerchandiseQty	Int	Y	总商品数
totalItemQty	Int	Y	总单品数
logisticsPlanNo	String(50)	Y	物流计划编码
logisticsPlanName	String(50)	Y	物流计划名称
exporterCode	String(50)	Y	出口商编码
exporterName	String(50)	Y	出口商名称
importerCode	String(50)	Y	进口商编码
importerName	String(50)	Y	进口商名称
inspectionType	String(20)	Y	验货类型 WI-验货仓验货 VI-上门验货
pickupType	String(20)	Y	提货类型 P-Winit上门提货 S-自发物流
reservePickupDate	String(20)	Y	预计提货日期	2016-09-11
reservePickupTime	String(20)	Y	预计提货时间	12:00:00-15:00:00
pickupAddressCode	String(50)	Y	提货/验货地址编码
pickupAddress	String(255)	Y	提货地址
expressNo	String(100)	Y	快递单号提货类型为自发物流时会有快递单号
expressVendorCode	String(50)	Y	发货承运编码提货类型为自发物流时会有发货承运编码
expressVendorName	String(50)	Y	发货承运人名称提货类型为自发物流时会有发货承运人名称
importDeclarationRuleCode	String(50)	Y	进口报关规则编码
importDeclarationRuleName	String(50)	Y	进口报关规则编码名称	普通清关-第三方进口商
importDeclareValueType	String(50)	Y	进口申报价值 IMPORTPRICE1-进口申报价值, IMPORTPRICE2-采购成本, CUSTOMS_IMPORTPRICE-海关建议申报价值
importDeclareWay	String(50)	Y	报关方式进口报关方式 Genenal——传统清关模式, Fiscal——电商清关模式, Bond——美国Bond模式	General
importDeclarationType	String(50)	Y	进口报关类型编码
importDeclarationName	String(50)	Y	进口报关类型名称
customsDeclarationType	String(50)	Y	出口报关类型编码
customsDeclarationName	String(50)	Y	出口报关类型名称
packageList			包裹列表
sellerCaseNo	String(50)	Y	卖家箱号
sellerHeight	Numberic(10,2)		预估包裹高(CM)
sellerLength	Numberic(10,2)		预估包裹长(CM)
sellerWeight	Numberic(10,4)		预估包裹重量(KG)
sellerWidth	Numberic(10,2)		预估包裹宽(CM)
packageNo	String(50)		包裹条码
thirdPartyCaseNo	String(50)		第三方包裹编号
status	String(50)		包裹状态 DR：草稿 PI：已下单 RE：已收货 IS：已验货 VC：核验完成 TS：运输中 UD：已卸货 PS：部分上架 SCP：已上架 STOP：终止 Lost：已丢失 SAA：上架异常区
unloadingTime	String(50)		包裹卸货时间
shelvesTime	String(50)		包裹上架时间	2019-06-03 17:44:49
height	Numberic(10,2)		实际包裹高(CM)
length	Numberic(10,2)		实际包裹长(CM)
weight	Numberic(10,4)		实际包裹重量(KG)
width	Numberic(10,2)		实际包裹宽(CM)
packageList.merchandiseList			包裹中的商品信息
sku	String(50)		Winit商品条码（M码）
merchandiseCode	String(255)		卖家商品编码
specification	String(255)		商品规格
quantity	Integer		下单数量
inspectionQty	Number		验货数量
actualQuantity	Number		上架数量
merchandiseList			以订单级依sku进行汇总的数量
productBarcode	String(255)		商品条码万邑通内商品条码与sku一对一对应
merchandiseCode	String(255)		卖家商品编码
specification	String(255)		商品规格
quantity	Number		数量(下单数量)
inspectionQty	Number		验货数量
actualQuantity	Number		实际上架数量
merchandiseList.skuCode3rdList			第三方商品编码列表
thirdPartyCode	String()		第三方商品编码
mark	String()		说明

返回示例

Json
XML

{
   "code": "0",
   "msg": "操作成功",
   "data":    {
      "orderType": "SD",
      "sellerOrderNo": "AutoStandard air 222222",
      "destinationWarehouseCode": "US0001",
      "customsDeclarationName": "第三方出口商",
      "expressNo": "55555555",
      "winitProductName": "空运-普货",
      "totalItemQty": 4,
      "importDeclarationRuleName": "普通清关-第三方进口商",
      "totalMerchandiseQty": 2,
      "needReservationSendWh": "N",
      "expressVendorName": "龙邦",
      "inspectionWarehouseCode": "SZ0001",
      "importerName": "YIDA EXPRESS INC.",
      "importDeclarationType": "TIOR",
      "exporterCode": null,
      "orderNo": "WI9900001290",
      "importDeclareValueType": "IMPORTPRICE1",
      "totalPackageQty": 1,
      "inspectionWarehouseName": "ShenZhen Warehouse",
      "inspectionType": "WI",
      "planShelfCompletedDate": "2019-07-05 14:00:00",
      "logisticsPlanName": "SZX-US-27-May",
      "destinationWarehouseName": "USWC Warehouse",
      "expressVendorCode": "LB",
      "importDeclarationRuleCode": "TIOR",
      "importDeclareWay": "General",
      "pickupType": "S",
      "packageList": [      {
         "sellerCaseNo": "AutoPackAge0001",
         "merchandiseList":          [
                        {
               "quantity": 2,
               "actualQuantity": 2,
               "specification": "",
               "sku": "M010000000001674549",
               "merchandiseCode": "auto_sku22"
            },
                        {
               "quantity": 2,
               "actualQuantity": 2,
               "specification": "",
               "sku": "M010000000001674550",
               "merchandiseCode": "auto_sku23"
            }
         ],
         "thirdPartyCaseNo": null,
         "sellerWeight": 10,
         "sellerLength": 50,
         "length": 50,
         "width": 40,
         "weight": 10,
         "sellerHeight": 30,
         "sellerWidth": 40,
         "packageNo": "B0400000000000001732",
         "height": 30
      }],
      "merchandiseList":       [
                  {
            "inspectionQty": 2,
            "quantity": 2,
            "productBarcode": "M010000000001674549",
            "actualQuantity": 2,
            "specification": "",
            "merchandiseCode": "auto_sku22",
            "skuCode3rdList": []
         },
                  {
            "inspectionQty": 2,
            "quantity": 2,
            "productBarcode": "M010000000001674550",
            "actualQuantity": 2,
            "specification": "",
            "merchandiseCode": "auto_sku23",
            "skuCode3rdList": []
         }
      ],
      "importDeclarationName": "第三方进口商",
      "pickupAddressCode": "",
      "createdDate": "2019-06-03 17:38:08",
      "logisticsPlanNo": 187483,
      "pickupAddress": "",
      "exporterName": "ENERGY CIRCLE LIMITED",
      "winitProductCode": "OW01010343",
      "shelveCompletedDate": "2019-06-03 17:44:49",
      "customsDeclarationType": "TEOR",
      "importerCode": null,
      "status": "SHD"
   }
}

关键词

WI13.查询入库单（详情）