接口说明

创建预约单，一步完成预约送仓。

接口名称

winit.wh.inbound.booking.create

请求说明

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

请求入参

名称	类型	必填	说明	示例
toWhInOrderList	List	Y	送仓订单列表	-
– orderNo	String(128)	Y	入库单号	WI46122840
– isWholeOrderToWh	String(1)	N	是否整单送仓 Y是，N否。默认 Y	Y
sendWarehouseInfo	Object	Y	送仓信息	-
– warehouseCode	String(128)	Y	预约送仓的目的仓库编码	US0001
– bookingType	String(128)	Y	预约类型 Normal：普通预约 ValueAdded：增值预约 VIP：VIP 预约 RegularBus：班车预约
– deliveryWayType	String(128)	Y	送仓方式 FCL：整柜 LCL：散货
– unloadType	String(128)	Y	卸货方式 LIVE：LIVE 模式（默认支持整柜和散货两个模式） DROP：DROP 模式（仅整柜支持）
– contactPerson	String(128)	O	联系人（整柜必填）	张三
– email	String(255)	O	邮箱（整柜必填，多个用英文逗号分隔）	aa@xx.com,bb@xx.com
– contactNumber	String(128)	O	联系电话（整柜必填）	13800138000
– sendWarehouseDate	String	Y	预约送仓时间（仓库当地时间）	2025-09-29（格式：yyyy-MM-dd）
– sendWarehouseDateTimeSlot	String(128)	Y	预约送仓时段	08:30-16:00
– containerNo	String(128)	O	集装箱号（整柜必填）	ABCD1234567
– isPallet	String(1)	O	是否打托（整柜必填） Y是，N否
– palletQty	Integer	O	托盘数（打托=是时必填）	5
– sealNo	String(128)	N	封条号	-
– cabinetType	String(128)	O	柜型（整柜必填） 20GP/40GP/40HQ/45HQ/53HQ

请求示例

{
      "action": "winit.wh.inbound.booking.create",
      "app_key": "rebecca",
      "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
      "client_sign":"72DD01D66A971198C6E6CDE0057EE067",
      "data": {
        "toWhInOrderList": [
            {
                "orderNo": "WIxxxxx1",
                "isWholeOrderToWh": "Y"
            },
            {
                "orderNo": "WIxxxxx2"
            }
          ],
          "sendWarehouseInfo": {
            "warehouseCode": "US0001",
            "bookingType": "RegularBus",
            "deliveryWayType": "LCL",
            "unloadType": "LIVE",
            "sendWarehouseDate": "2025-09-29",
            "sendWarehouseDateTimeSlot": "08:30-16:00",
            "contactPerson": "张三",
            "contactNumber": "13800138000",
            "email": "supplier1@example.com,supplier2@example.com"
        }
      },
      "format": "json",
      "language": "zh_CN",
      "platform": "OWNERERP",
      "sign": "AF99170EDFFFD64F407C930A7083C3E1",
      "sign_method": "md5",
      "timestamp": "2016-09-09 10:52:47",
      "version": "1.0"
}

返回出参

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

名称	类型	必传	说明	示例
bookingNo	String(128)	Y	预约单号	Y0100000002
bookingCode	String(128)	Y	预约码	ADEC18HFGS1

返回示例

成功

{
    "code": "0",
    "msg": "",
    "data": {
        "bookingNo": "Y0100000002",
        "bookingCode": "ADEC18HFGS1"
    }
}

失败

{
    "code": "02020245301",
    "msg": "预约超过当天产能",
    "data": ""
}

关键词