接口说明

通过入库单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	订单状态 DR-草稿：卖家创建草稿单。 OD-已下单：卖家创建订单，但尚未发货。 RE-已收货: Winit承运，国内验货仓已收货。 TS-运输中: ①Winit承运时，国内验货仓出库完成。 ②卖家直发时，卖家确认发货。 PEWC-部分到仓：订单有任一包裹已卸货。 EWC-已到仓：订单所有包裹已卸货。 SHD-已上架：订单中全部包裹为已上架或终止，且至少有一个包裹已上架。 STOP-终止：订单终止。
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	上架数量
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	实际上架数量
–\|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"
    }
}

关键词

WI13.查询入库单（详情）