接口说明

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

接口名称

winit.wh.inbound.getOrderDetail

请求说明

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

请求入参

名称	类型	必填	说明	示例
orderNo	String(50)	Y	WINIT订单号	WI9900001290
isIncludePackage	String(10)	N	返回结果是否包含包裹及商品信息，不传默认N Y：是, 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"
}

返回出参

返回参数说明：正确的返回编码code：0及结果data，错误的返回错误码及错误信息msg。

名称	类型	必传	说明	示例
orderNo	String(50)	Y	WINIT订单号
sellerOrderNo	String(255)	Y	客户订单号
orderType	String(20)	Y	订单类型 SD：标准海外仓入库 DW：直发海外验入库 DI：直发国内验入库
status	String(20)	Y	订单状态编码，详见入库单状态列表
isCompleted	String(50)	Y	订单是否完结，Y-是；N-否 Y-是的定义：包含以下两种场景：（1）入库单内包裹状态全部[上架完成]；（2）入库单包裹存在[终止][丢失]状态，但不存在[上架异常区]状态，并且最后一个包裹上架已经超过1个月。背景：入库单状态切[已上架]后还可能发生上架，因为入库单完全完结，需要有一个持续时间才能做到，尤其是以下（2）和（3）的场景。（1）包裹[上架异常区]：异常待提增值处理，订单先切已上架，后续异常处理完，继续原单上架。（2）包裹[终止]：例如直发部分包裹未到仓，超过一定时间， WINIT认为不会再到仓了执行终止包裹，订单先切已上架，但是后续这部分包裹又到仓继续原单上架。（3）包裹[丢失]：例如仓库先判定包裹丢失，并且已经赔付，订单先切已上架，后续丢失找回，继续原单上架。注意：即使是上架超过1个月被认定[订单完结]，也无法确保100%后续不会再有商品上架，因为上述（2）和（3）的场景也有可能在上架超过1个月后仍然发生。
winitProductCode	String(50)	Y	WINIT产品编码
winitProductName	String(60)	Y	WINIT产品名称
inspectionWarehouseCode	String(50)	Y	验货仓编码
inspectionWarehouseName	String(50)	Y	验货仓名称
destinationWarehouseCode	String(50)	Y	目的仓编码
destinationWarehouseName	String(50)	Y	目的仓名称
logisticsPlanNo	String(50)	Y	物流计划编码
logisticsPlanName	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	发货承运人名称提货类型为自发物流时会有发货承运人名称
importerCode	String(50)	Y	进口商编码
importerName	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	进口报关类型名称
exporterCode	String(50)	Y	出口商编码
exporterName	String(50)	Y	出口商名称
customsDeclarationType	String(50)	Y	出口报关类型编码
customsDeclarationName	String(50)	Y	出口报关类型名称
totalPackageQty	Int	Y	总包裹数
totalMerchandiseQty	Int	Y	总商品数
totalItemQty	Int	Y	总单品数
createdDate	String(50)	Y	创建时间	2016-09-09 09:50:54
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
inboundBookingStatus	String(50)	Y	入库单预约状态 UN_BOOKING：无需预约 NOT_ARRIVE_BOOKING_NODE：未到预约节点 WAIT_CREATE_BOOKING_ORDER：待创建预约单 WAIT_BOOKING_SEND_WAREHOUSE：待预约送仓 BOOKING：已预约 ARRIVED_WAREHOUSE：已到仓 NOT_BOOKING_ARRIVED_WAREHOUSE：未预约到仓
bookingCode	String(50)	N	预约单号预约状态为待预约送仓/已预约/已到仓时，返回绑定的预约单号
bookingNo	String(50)	N	预约编码预约单号对应的预约码
packageLis	Array	Y	包裹列表****
– sellerCaseNo	String(50)	Y	卖家箱号若使用新自验，此字段不会返回
– packageNo	String(50)	Y	包裹条码
– thirdPartyCaseNo	String(50)	Y	第三方包裹编号
– sellerHeight	Numberic(10,2)	Y	预估包裹高(CM)
– sellerLength	Numberic(10,2)	Y	预估包裹长(CM)
– sellerWeight	Numberic(10,4)	Y	预估包裹重量(KG)
– sellerWidth	Numberic(10,2)	Y	预估包裹宽(CM)
– status	String(50)	Y	包裹状态编码，详见入库单状态列表
– unloadingTime	String(50)	Y	包裹卸货时间
– shelvesTime	String(50)	Y	包裹上架时间	2019-06-03 17:44:49
– height	Numberic(10,2)	Y	实际包裹高(CM)
– length	Numberic(10,2)	Y	实际包裹长(CM)
– weight	Numberic(10,4)	Y	实际包裹重量(KG)
– width	Numberic(10,2)	Y	实际包裹宽(CM)
– merchandiseList	Array	Y	包裹中的商品信息
– – sku	String(50)	Y	Winit商品条码（M码）
– – merchandiseCode	String(255)	Y	卖家商品编码
– – specification	String(255)	Y	商品规格
– – quantity	Integer	Y	下单数量注：若商品为箱套产品，则此数量为箱数/套数。需要乘以库存单元标准件数得到单品数量
– – inspectionQty	Number	Y	验货数量注：若商品为箱套产品，则此数量为箱数/套数。需要乘以库存单元标准件数得到单品数量（实际不拆箱验货，以信息流为准）
– – actualQuantity	Number	Y	上架数量注：若商品为箱套产品，则此数量为箱数/套数。需要乘以库存单元标准件数得到单品数量（实际不拆箱验货，以信息流为准）
– – skuType	String	N	SKU类型 SINGLE：单一产品 SUITE：套装产品 BOX：箱产品
– – standardPartsNum	Number	N	库存单元标准件数
– – itemList	Array	N	包裹下商品的单品信息
– – – itemSerno	String(50)	N	单品条码注：商品单品化管理，非A+验货完成或上架完成会返回；A+包导入箱单会生成对应的单品码
– – – status	String(50)	N	单品状态 DR：草稿 PI：已下单 RE：已收货 IS：已验货 TS：运输中 UD：已卸货 SCP：已上架 STOP：终止 Lost：已丢失
merchandiseList	Array	Y	以订单级依sku进行汇总的数量
– productBarcode	String(255)	Y	商品条码万邑通内商品条码与sku一对一对应
– merchandiseCode	String(255)	Y	卖家商品编码
– specification	String(255)	Y	商品规格
– quantity	Number	Y	下单数量注：若商品为箱套产品，则此数量为箱数/套数。需要乘以库存单元标准件数得到单品数量
– inspectionQty	Number	Y	验货数量注：若商品为箱套产品，则此数量为箱数/套数。需要乘以库存单元标准件数得到单品数量（实际不拆箱验货，以信息流为准）
– actualQuantity	Number	Y	实际上架数量注：若商品为箱套产品，则此数量为箱数/套数。需要乘以库存单元标准件数得到单品数量（实际不拆箱验货，以信息流为准）
– skuType	String	N	SKU类型 SINGLE：单一产品 SUITE：套装产品 BOX：箱产品
– standardPartsNum	Number	N	库存单元标准件数
– skuCode3rdList	Array	Y	第三方商品编码列表
– – thirdPartyCode	String()	Y	第三方商品编码
– – mark	String()	Y	说明

返回示例

1、返回不带包裹信息

{
  "code": "0",
  "msg": "操作成功",
  "data": {
    "bookingNo": "",
    "orderType": "DI",
    "sellerOrderNo": "auto demestic 111111",
    "destinationWarehouseCode": "US0001",
    "customsDeclarationName": null,
    "expressNo": null,
    "winitProductName": "自验-直发-国际快递",
    "totalItemQty": 7,
    "importDeclarationRuleName": null,
    "totalMerchandiseQty": 3,
    "isForecastOrder": "N",
    "inboundBookingStatus": "NOT_BOOKING_ARRIVED_WAREHOUSE",
    "needReservationSendWh": "Y",
    "expressVendorName": null,
    "inspectionWarehouseCode": "CSIW01",
    "importerName": null,
    "importDeclarationType": null,
    "exporterCode": null,
    "isCompleted": "Y",
    "orderNo": "WI9900000073",
    "importDeclareValueType": null,
    "totalPackageQty": 3,
    "inspectionWarehouseName": "客户自验仓",
    "inspectionType": null,
    "planShelfCompletedDate": null,
    "logisticsPlanName": null,
    "destinationWarehouseName": "USWC Warehouse",
    "expressVendorCode": null,
    "importDeclarationRuleCode": null,
    "importDeclareWay": null,
    "pickupType": null,
    "importDeclarationName": null,
    "pickupAddressCode": null,
    "createdDate": "2024-06-19 21:26:49",
    "logisticsPlanNo": null,
    "pickupAddress": null,
    "exporterName": null,
    "winitProductCode": "OW01022004010",
    "shelveCompletedDate": "2024-06-19 21:30:06",
    "customsDeclarationType": null,
    "bookingCode": "",
    "importerCode": null,
    "status": "SHD"
  }
}

2、返回带包裹信息

{
    "code": "0",
    "msg": "操作成功",
    "data": {
        "orderType": "DI",
        "sellerOrderNo": "",
        "destinationWarehouseCode": "US0001",
        "customsDeclarationName": null,
        "expressNo": null,
        "winitProductName": "自验-直发-散货",
        "totalItemQty": 1,
        "importDeclarationRuleName": null,
        "totalMerchandiseQty": 1,
        "needReservationSendWh": "N",
        "expressVendorName": null,
        "inspectionWarehouseCode": "CSIW01",
        "importerName": null,
        "importDeclarationType": null,
        "exporterCode": null,
        "isCompleted": "N",
        "orderNo": "WI9900057846",
        "importDeclareValueType": null,
        "totalPackageQty": 1,
        "inspectionWarehouseName": "客户自验仓",
        "inspectionType": null,
        "planShelfCompletedDate": null,
        "logisticsPlanName": null,
        "destinationWarehouseName": "USWC Warehouse",
        "expressVendorCode": null,
        "importDeclarationRuleCode": null,
        "importDeclareWay": null,
        "pickupType": null,
        "packageList": [
            {
                "thirdPartyCaseNo": "",
                "sellerWeight": 1.0000,
                "length": 1.00,
                "weight": 1.0000,
                "sellerWidth": 1.00,
                "actualTrackingNo": null,
                "packageNo": "B0400000000034402463",
                "sellerCaseNo": "1",
                "merchandiseList": [
                    {
                        "inspectionQty": 1,
                        "quantity": 1,
                        "actualQuantity": 0,
                        "specification": "测试",
                        "batchInfo": {
                            "actualBatchInfos": [],
                            "orderBatchInfo": {}
                        },
                        "sku": "M010000000001676082",
                        "merchandiseCode": "2321424"
                    }
                ],
                "shelvesTime": null,
                "unloadingTime": "2023-07-05 13:01:50",
                "trackingNo": null,
                "sellerLength": 1.00,
                "width": 1.00,
                "sellerHeight": 1.00,
                "height": 1.00,
                "status": "UD"
            }
        ],
        "merchandiseList": [
            {
                "actualLength": 1.00,
                "inspectionQty": 1,
                "actualWeight": 1.0000,
                "quantity": 1,
                "productBarcode": "M010000000001676082",
                "actualWidth": 1.00,
                "actualQuantity": 0,
                "specification": "测试",
                "actualHeight": 1.00,
                "merchandiseCode": "2321424",
                "skuCode3rdList": []
            }
        ],
        "importDeclarationName": null,
        "pickupAddressCode": null,
        "createdDate": "2023-07-04 18:17:12",
        "logisticsPlanNo": null,
        "pickupAddress": null,
        "exporterName": null,
        "winitProductCode": "OW01022003989",
        "shelveCompletedDate": null,
        "customsDeclarationType": null,
        "importerCode": null,
        "status": "EWC"
    }
}

3、返回带单品条码信息

{
  "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",
    "isCompleted": "Y",
    "isForecastOrder": "N",
    "relatedSplitSubOrder": [
      {
        "orderNo": "WI9900001290A",
        "winitProductCode": "OW0101001",
        "winitProductName": "空运-普货",
        "status": "IC",
        "createdDate": "2019-06-03 17:38:08"
      }
    ],
    "packageList": [
      {
        "sellerCaseNo": "AutoPackAge0001",
        "merchandiseList": [
          {
            "quantity": 2,
            "actualQuantity": 2,
            "specification": "",
            "sku": "M010000000001674549",
            "merchandiseCode": "auto_sku22",
            "itemList": [
              {
                "itemSerno": "S0000000000111",
                "status": "TS"
              },
              {
                "itemSerno": "S0000000000112",
                "status": "TS"
              }
            ],
            "batchInfo": {
              "actualBatchInfos": [
                {
                  "qty": 1,
                  "productionBatch": "a01010211",
                  "expirationDate": "2023-09-09",
                  "productionDate": "2023-09-09"
                }
              ],
              "orderBatchInfo": {
                "qty": 1,
                "productionBatch": "a01010211",
                "expirationDate": "2023-09-09",
                "productionDate": "2023-09-09"
              }
            }
          },
          {
            "quantity": 2,
            "actualQuantity": 2,
            "specification": "",
            "sku": "M010000000001674550",
            "merchandiseCode": "auto_sku23",
            "itemList": [
              {
                "itemSerno": "S0000000000113",
                "status": "TS"
              },
              {
                "itemSerno": "S0000000000114",
                "status": "TS"
              }
            ],
            "batchInfo": {
              "actualBatchInfos": [
                {
                  "qty": 1,
                  "productionBatch": "a01010211",
                  "expirationDate": "2023-09-09",
                  "productionDate": "2023-09-09"
                }
              ],
              "orderBatchInfo": {
                "qty": 1,
                "productionBatch": "a01010211",
                "expirationDate": "2023-09-09",
                "productionDate": "2023-09-09"
              }
            }
          }
        ],
        "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.查询入库单（详情）