API
查询入库单详情
更新时间: 2021-11-12 11:22:54 访问次数:10502
接口说明

通过入库单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
请求示例
{
      "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-草稿:卖家创建草稿单
SB-已提交:新版自验独有。创建订单但未完成验货。
OD-已下单:卖家创建订单,但尚未发货。
RE-已收货: Winit承运,国内验货仓已收货。
TS-运输中:
①Winit承运时,国内验货仓出库完成。
②卖家直发时,卖家确认发货。
EWC-已到仓 :海外仓收到货。
PS-部分上架:订单中部分包裹上架
SHD-已上架:订单中全部包裹上架,或部分未上架但确定可以关闭。
VO-作废:已下单状态下作废的订单。
STOP-终止:运输中状态下终止的订单。
SB-已提交
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) 包裹条码
thirdPartyCaseNoString(50)

第三方包裹编号
statusString(50)

包裹状态
PI准备中
RE已收货
IS已验货
DC取消发货
TS运输中
UD已卸货
PS部分上架
SCP已上架
STOP终止
Lost已丢失
Abnormal异常

SCP
shelvesTimeString(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 数量
下单数量
actualQuantity Number 订单当前状态的数量
1.已下单:下单的数量
2.验货:验货的数量
3.部分上架/上架:上架的数量
即将修改,请以订单纬度的商品数量为准
merchandiseList


以订单级依sku进行汇总的数量
productBarcode String(255)

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

merchandiseCode String(255)

卖家商品编码

specificationString(255)

商品规格

quantityNumber

数量(下单数量)

inspectionQtyNumber

验货数量
actualQuantityNumber

实际上架数量
merchandiseList.skuCode3rdList

第三方商品编码列表
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"
   }
}