接口说明

### 接口说明 - 旅业助手对外接口分为输入模式和输出模式; 1. **输入模式** 客人信息输入在第三方Pms或自助开房系统,第三方系统在办理业务时,将客人的入住,换房,续住以及退房信息通过接口输入给旅业助手,由旅业助手完成数据的分发及公安上传。 2. **输出模式** 客人信息有旅业助手进行采集输入,第三方Pms或自助开房系统通过接口获取客人的信息; **两种模式均支持文件交互方式和API接口方式;** 接口配置界面如下: ![image.png](https://cos.easydoc.net/66155113/files/kep3gmvo.png) ## Api接口信息文档 ### 编码 若请求消息体中的参数支持中文,则中文字符必须为UTF-8编码。 ### 时间与日期 表示日期一律采用YYYY-MM-DD方式,例如2020-06-01表示2016年6月1日 表示时间一律采用hh:mm:ss方式, 凡涉及日期和时间合并表示时,在两者中间加空格,例如2020-06-01 23:00:10 表示UTC时间2020年6月1日23点0分10秒 ### ToKen 联系软件供应商获取有效ToKen信息,在每次调用中均需要携带ToKen信息 ### 旅业助手 API 规格 - 公共请求消息头 下表列出了所有接口所携带的公共头域。HTTP 协议的标准头域不再这里列出了。 |消息头(Header)|是否必须|说明| |-|-|-| |Content-Type|可选|application/json; charset=utf-8| - 下表列出了所有接口的公共响应头域。HTTP协议的标准响应头域不再这里列出了 |消息头(Header)|说明| |-|-|-| |Content-Type|只支持JSON格式,application/json; charset=utf-8| ### 返回格式 统一为如下格式。后续各接口不再单独列出。 |参数名|类型|说明 |-|-|-| |ResultCode|string|状态码| |msg|string|说明| 示例 ```json { "Msg": "成功", "Gid": "L09110105803620035", "ResultCode": 200 } ``` ### 注意事项 - 入住成功后接口会返回宾客id “GuestID”,需保存该信息,修改信息和退房时需要提供宾客id; - 换房,退房,修改预离时间时如果没有提供GuestID,需要提供RoomID和CardID两个参数,服务端会根据这两个参数在当前入住客人中检索GuestID; - 退房时间 不可超过当前时间也不可小于入住时间; #### 常见返回码 200: Result.s['Msg'] := '成功'; 101: Result.s['Msg'] := '机构标识不正确'; 102: Result.s['Msg'] := '校验码不正确'; 103: Result.s['Msg'] := 'ToKen错误'; 104: Result.s['Msg'] := 'ToKen超时'; 199: Result.s['Msg'] := '其他错误'; 404: Result.s['Msg'] := '没找到对应的接口'; ### 测试信息 机构标识:091101058036 校验码:091101058036 工作站:Api测试 工号:101 密码:888 ToKen:B9D92A6AAAEA2D6D97F7187898 ### 测试房间号 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1714 1715 1716 1717 1718 1719 1720 1721 1723 1724 1725 1727 1729 1730