制作宾客卡(多门卡)

  • 房间封房状态不允许制作宾客卡

本地服务器版本:

  • V1.9.0

命令值(cmd):

  • 301

服务器接口版本(version):

  • 1.1
注意:

1.接口版本1.1支持制作多门卡,多门卡最多支持4个房间 2.多门卡只支持第一个房间为套房,后面出现套房则自动授权主房间

入参说明:
参数名层级类型条件说明备注
lockCode1List<String>必填门锁号每个房间的门锁号都是唯一
最多4个房间,只支持第一个是套房,其他三个不能是套房
通过房间列表获取
cardDispenserSeq1String必填发卡器序列号唯一
cardNo1String必填卡号
customerName1String必填房客名称
checkInFlag1int可选入住标记0 立即入住(默认)
以已入住房客授权的开始时间作为本次入住授权的开始时间,如对应房源内没有已入住的房客,则取入参开始时间(建议为当前时间)作为本次入住授权的开始时间(时间精度为小时)
1 其他时间入住
取入参开始时间作为本次入住授权的起始时间(可以为未来时间,时间精度为小时)
备注:
房间门锁开启顶替功能,如果入住时间触发其他授权顶替,服务器则会有异常提示,第三方需要调整入住时间。
beginTime1long必填开始时间时间戳:秒
endTime1long必填结束时间时间戳:秒
idType1int可选证件类型1身份证
2护照
3回乡证
4军官证
5士兵证
6学生证
7导游证
8驾驶证
phoneNo1String可选手机号码公寓场景必传
countryCode1int可选国家编码
normallyOpen1int可选常开模式1常开打开,常开模式
2常开关闭,正常模式
不传默认2,常开关闭
isLock1int可选反锁功能1:反锁功能开启,可开反锁
2:反锁功能关闭,不能开反锁
不传默认2,反锁功能关闭
floorList1list可选可开楼层2.7.3新增
floorCode2int可选楼层码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,}]
	}
}
响应参数说明:
参数名层级类型条件描述备注
list1List必填--
lockCode2String必填门锁号--
checkInId2String必填授权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没有安装门锁
500324xxx房间时间段内已有人预约,请调整选择的时间范围
500330非立即入住,开始时间不能小于xxx,避免“在住房客”被顶替掉导致无法开锁
500331入住的时间段内已有人入住,为避免顶替导致有人无法开锁,请调整选择的时间范围
500400非法卡片,不是酒店加密卡
500528xxx房间已存在授权
500533操作失败,房间已封房
500404安裝卡,请先进行回收
500405操作失败,加密卡非法
--其他异常