API
查询可预约送仓时间
更新时间： 2026-07-31 18:29:34 访问次数：4

接口说明

查询指定仓库的可预约送仓时间段。

接口名称

winit.wh.inbound.booking.queryAvailableWarehouseinPlan

请求说明

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

请求入参

名称 类型 必填 说明 示例
warehouseCode String(128) Y 仓库编码 -
bookingType String(128) Y 预约类型
Normal：普通预约
ValueAdded：增值预约
VIP：VIP 预约
deliveryWayType String(128) Y 送仓方式
FCL：整柜
LCL：散货
unloadType String(128) O 卸货方式（整柜必传）
DROP：DROP 模式
LIVE：LIVE 模式
cabinetType String(128) O
 柜型（整柜必传）
20GP/40GP/40HQ/45HQ/53HQ
inboundOrderList List Y 入库单信息列表 -
inboundOrderList[].orderNo String(128) Y 入库单号 -

请求示例

  1. {
  2.       "action": "winit.wh.inbound.booking.queryAvailableWarehouseinPlan",
  3.       "app_key": "rebecca",
  4.       "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5.       "client_sign":"72DD01D66A971198C6E6CDE0057EE067",
  6.       "data": {
  7.         "warehouseCode": "US0001",
  8.         "bookingType": "Normal",
  9.         "deliveryWayType": "LCL",
  10.         "unloadType": "LIVE",
  11.         "cabinetType": "40HQ",
  12.         "isPallet": "Y",
  13.         "inboundOrderList": [
  14.             {
  15.                 "orderNo": "WI46122840"
  16.             }
  17.         ]
  18.       },
  19.       "format": "json",
  20.       "language": "zh_CN",
  21.       "platform": "OWNERERP",
  22.       "sign": "AF99170EDFFFD64F407C930A7083C3E1",
  23.       "sign_method": "md5",
  24.       "timestamp": "2016-09-09 10:52:47",
  25.       "version": "1.0"
  26. }

返回出参

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

名称 类型 必传 说明 示例
availablePlanList List Y 可预约时间信息列表 -
availablePlanList[].warehouseinPlanId String Y 入库计划编码 1121212
availablePlanList[].warehouseinDate String Y 可选送仓日期 2024-10-01
availablePlanList[].surplusVolume BigDecimal(16,9) Y 全天剩余 SLOT 35
availablePlanList[].warehouseDateTimeList List Y 可选送仓时间段集合 [“08:00-11:00”,”12:00-16:00”]

返回示例

成功

  1. {
  2.     "code": "0",
  3.     "msg": "操作成功",
  4.     "data": {
  5.         "availablePlanList": [
  6.             {
  7.                 "warehouseinDate": "2024-10-01",
  8.                 "surplusVolume": 35,
  9.                 "warehouseDateTimeList": ["08:00-11:00", "12:00-16:00"]
  10.             }
  11.         ]
  12.     }
  13. }

失败

  1. {
  2.     "code": "02020245301",
  3.     "msg": "不存在可预约时间，无法预约！",
  4.     "data": ""
  5. }

错误码说明

错误编码 错误场景 错误信息
02070260059 入库单不属于对应客户 入库单【xxx】不存在
02070260123 存在不需要预约的入库单 存在不需要预约的入库单【xxx】
02070260089 存在不需要预约的入库单 入库单{0}的送仓方式=快递，无需预约送仓…
02070260125 存在已预约送仓的入库单 存在已经预约送仓的入库单【xxx】预约单号【xxx】
02070260092 入库单目的仓不一致 入库单【xxx】和入库单【xxx】的目的仓不一致
02070260088 整柜散货混合预约 整柜入库单【xxx】和散货入库单【xxx】不允许一起预约
02070260074 无可预约时间 不存在可预约时间，无法预约！
02070260067 无可预约时间 预约计划不在可选预约日期内，请更换预约日期重新预约！
关键词