API
查询入库单(详情)
更新时间: 2017-11-22 16:53:01 访问次数:3405
接口说明

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

接口英文名称

winit.wh.inbound.getOrderDetail

使用场景

入库单详情,仅支持入库单。

备注

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
orderNo String(50) Y WINIT订单号
isIncludePackage String(10) N 返回结果是否包含包裹信息。Y-是,N-否,默认N。
请求示例
{
      "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 订单类型
status String(20) Y 订单状态
DR-草稿
OD-已下单
RE-已收货
TS-运输中
EWC-已到仓
SHD-已上架
VO-作废
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 预计上架时间 2016-09-09 09:50:54
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 Array 包裹列表,以下为子节点
-|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) 包裹条码
-|thirdPartyCaseNoString(50)

第三方包裹编号
-|height Numberic(10,2) 实际包裹高(CM)
-|length Numberic(10,2) 实际包裹长(CM)
-|weight Numberic(10,4) 实际包裹重量(KG)
-|width Numberic(10,2) 实际包裹宽(CM)
-|merchandiseList Array 包裹中的商品信息,以下为merchandiseList的子节点(包裹级)
--|sku String(50) Winit商品条码(M码)
--|merchandiseCode String(255) 卖家商品编码
--|specification String(255) 商品规格
--|quantity Integer 数量
下单数量
--|actualQuantity Number 实际验货数量
merchandiseList
Array
入库订单商品数量汇总
以订单级依sku进行汇总的数量

-|productBarcode String(255)

商品条码
万邑通内商品条码与sku一对一对应

-|merchandiseCode String(255)

卖家商品编码

-|specificationString(255)

商品规格

-|quantityNumber

数量(下单数量)

-|inspectionQtyNumber

验货数量
-|actualQuantityNumber

实际上架数量
-|skuCode3rdListArray
第三方商品编码列表
-|-|thirdPartyCodeString()
第三方商品编码
-|-|markString()
说明

返回参数说明 正确的返回结果:订单详情。 错误的返回结果:错误码,错误信息。

返回示例
{
   "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"
   }
}