制作宾客卡(多门卡)
- 房间封房状态不允许制作宾客卡
本地服务器版本:
- V1.9.0
命令值(cmd):
- 301
服务器接口版本(version):
- 1.1
注意:
1.接口版本1.1支持制作多门卡,多门卡最多支持4个房间 2.多门卡只支持第一个房间为套房,后面出现套房则自动授权主房间
入参说明:
参数名 | 层级 | 类型 | 条件 | 说明 | 备注 |
---|---|---|---|---|---|
lockCode | 1 | List<String> | 必填 | 门锁号 | 每个房间的门锁号都是唯一 最多4个房间,只支持第一个是套房,其他三个不能是套房 通过房间列表获取 |
cardDispenserSeq | 1 | String | 必填 | 发卡器序列号 | 唯一 |
cardNo | 1 | String | 必填 | 卡号 | |
customerName | 1 | String | 必填 | 房客名称 | |
checkInFlag | 1 | int | 可选 | 入住标记 | 0 立即入住(默认) 以已入住房客授权的开始时间作为本次入住授权的开始时间,如对应房源内没有已入住的房客,则取入参开始时间(建议为当前时间)作为本次入住授权的开始时间(时间精度为小时) 1 其他时间入住 取入参开始时间作为本次入住授权的起始时间(可以为未来时间,时间精度为小时) 备注: 房间门锁开启顶替功能,如果入住时间触发其他授权顶替,服务器则会有异常提示,第三方需要调整入住时间。 |
beginTime | 1 | long | 必填 | 开始时间 | 时间戳:秒 |
endTime | 1 | long | 必填 | 结束时间 | 时间戳:秒 |
idType | 1 | int | 可选 | 证件类型 | 1身份证 2护照 3回乡证 4军官证 5士兵证 6学生证 7导游证 8驾驶证 |
phoneNo | 1 | String | 可选 | 手机号码 | 公寓场景必传 |
countryCode | 1 | int | 可选 | 国家编码 | |
normallyOpen | 1 | int | 可选 | 常开模式 | 1常开打开,常开模式 2常开关闭,正常模式 不传默认2,常开关闭 |
isLock | 1 | int | 可选 | 反锁功能 | 1:反锁功能开启,可开反锁 2:反锁功能关闭,不能开反锁 不传默认2,反锁功能关闭 |
floorList | 1 | list | 可选 | 可开楼层 | 2.7.3新增 |
floorCode | 2 | int | 可选 | 楼层码 | 2.7.3新增 |
云端发布Pub(示例):
{
"cmd": 301,
"msgId": 122321323,
"version":1.1,
"data": {
"lockCode":["1.2.202","1.2.204"],
"cardDispenserSeq": "MNR63218751FB5",
"customerName":"zzy",
"beginTime":1649984400,
"endTime":1650090000,
"phoneNo":13535455351,
"cardNo":"E370DE92"
"floorList" : [{"floorCode" : 1},{"floorCode" :2,},{"floorCode" :3,},{"floorCode" :4,},{"floorCode" :5,}]
}
}
响应参数说明:
参数名 | 层级 | 类型 | 条件 | 描述 | 备注 |
---|---|---|---|---|---|
list | 1 | List | 必填 | -- | |
lockCode | 2 | String | 必填 | 门锁号 | -- |
checkInId | 2 | String | 必填 | 授权ID | -- |
边缘网关响应Sub(示例):
{
"cmd": 301,
"msgId": 122321323,
"version":1.1,
"data": {
"lockCode": ["5.2.201"],
"cardDispenserSeq": "MNR600E48A4A71",
"customerName": "zzy",
"beginTime": 1693452689,
"endTime": 1696044689,
"phoneNo": 13535455351,
"cardNo": "E35F81A2",
"floorList" : [{"floorCode": 1},{"floorCode": 2},{"floorCode": 3},{"floorCode": 4},{"floorCode": 5}]
}
}
异常码
异常码 | 异常描述 |
---|---|
500001 | 参数异常 |
500300 | 房间不存在 |
500322 | 制卡失败,xxx房间信息不全 |
500321 | 制卡失败,xxx没有安装门锁 |
500324 | xxx房间时间段内已有人预约,请调整选择的时间范围 |
500330 | 非立即入住,开始时间不能小于xxx,避免“在住房客”被顶替掉导致无法开锁 |
500331 | 入住的时间段内已有人入住,为避免顶替导致有人无法开锁,请调整选择的时间范围 |
500400 | 非法卡片,不是酒店加密卡 |
500528 | xxx房间已存在授权 |
500533 | 操作失败,房间已封房 |
500404 | 安裝卡,请先进行回收 |
500405 | 操作失败,加密卡非法 |
-- | 其他异常 |