宾客业务办理
https://api.orbitaiot.com/open/v1/hotelguest/guestCheckIn
1. HTTP请求方法及示例
| POST /open/v1/hotelguest/guestCheckIn Host: api.orbitaiot.com Content-Type: application/json Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxNiIsImp0aSI6Ijg3MjYxNmExMGFlYzdmMmNlY2RhM2NiOGRhNWU0YTVhZTI......... {"open_type":1, "antilock_permission":1, "start_time":0, "end_time":0} |
2. 参数说明
Headers参数
| 字段 | 类型 | 是否必需 | 值 |
| Content-Type | String | 是 | application/json |
| Authorization | String | 是 | Bearer + 空格 + access_token值 |
Body参数
| 字段 | 类型 | 是否必需 | 描述 |
| masterId | String | Y | 宾客ID | 同一酒店下唯一; 第三方自己生成客人唯一标识，后面的续住、退房、换房等都使用这个masterId |
| bizType | String | Y | 业务点 | CHECKIN：入住，CHECKOUT：退房，MASTERCHG:续住，RMCHG:换房,GUESTCHG:客人档案修改（默认只在客人姓名、手机号、蓝牙授权修改时触发发送） |
| rmno | String | N | 楼号+楼层号+房间编号如010101 |
| BTAuth | Boolean | Y | 蓝牙开锁权限 | 默认不授权，蓝牙授权时手机号邮箱必填其一 |
| name | String | Y | 宾客姓名 |
| idNo | String | N | 证件号 | 默认身份证 |
| countryNo | String | Y | 国家代码 | 中国 +86 |
| mobile | String | N | 手机号 | 手机号跟邮箱至少需要一个 |
| email | String | N | 邮箱 | 手机号跟邮箱至少需要一个 |
| arr | String | Y | 抵店时间 | 格式yyyy-MM-dd HH:mm:ss |
| dep | String | Y | 离店时间 | 格式yyyy-MM-dd HH:mm:ss |
| orgRmno | String | N | 原房间 换房需要传 |
| realRate | String | N | 房价 |
3. 返回参数及示例
| 参数 | 类型 | 描述 |
| code | Int | |
| data | String | |
| message | String | |
| bin | String |
4. 接口示例
4.1“CHECKIN：入住”示例
4.2“CHECKOUT：退房”示例
4.3“MASTERCHG:续住”示例
如果有多人入住一间房间，只用操作其中一个人就行了，其他的会自动变动；
4.4“GUESTCHG:客人档案修改”示例
4.5“RMCHG:客人换房”示例
如果有多人入住一间房间，只用操作其中一个人就行了，其他的会自动变动；
