@code33 2016-10-11T07:16:31.000000Z 字数 4356 阅读 735

Aladin-Weaver 酒店收益设置数据接入开发说明文档1.3.1

迪联文档 说明文档 API文档 公开文档 收益文档

API版本
1.3.1

Email: code0515@163.com

Modify by Jyo on 2016-10-11 1.3.1

更新部分标题目录名称

更新develop环境下域名

Modify by Jyo on 2016-09-08

Modify by Jyo on 2016-08-30

CREATE BY JYO ON 2016-08-07

需求目的

酒店大数据分析,以得出酒店未来出租率预测,其中参与预测的数据包含本地经营历史数据,竞争对手OTA报价数据等
酒店房型比价

API

domain:

develop: 
    http://weaver.develop.dlhis.com/
prepro:
    http://weaver.dlhis.com/

Header ContentType

字符集要求:

Content-Type:application/json;charset=utf-8

PS:develop模式下可使用测试专用密钥信息:

ID123
KEY123

PMSMST.订单接入

PMSMST.INIT 初始化数据

场景:

应用于初始化历史订单数据库构建
数据文件以CSV格式提交於我方客服,每页数据一年,无需字段头

accnt	sysdate	restime	arr	dep	isGroup	mktCode	price	rooms	mstSta	rmiCode
A00001	2016-01-01	2016-01-01 08:00:00	2016-01-02 08:00:00	2016-01-03 08:00:00	'T'	'QUA'	200.00	1	R	BJ
`账单号`	`账期日`	`预订时间`	`抵达时间`	`离店时间`	`是否团队`	`市场代码`	`房间单价`,最多小数点后2位	`房间数`	`主单状态`	`房型代码`

PS:

该文件生成完成后,可通过点击阿拉丁用户后台界面的右下角气泡按钮,联系客服人员,她将会引导你完成下一步操作

接入完成后请完善市场码的类型设置,收益预测分析,对OTA网络订单和钟点房订单将以不同类型的方式处理方可获取相对准确预测分析结果,务必对其市场码-类型准确的设置

API.PMSMST01 实时订单接口

场景:

PMS应用程序,提交其实时订单数据,仅提交有效订单,用于预测算法统计之数据源

method:
POST

URi:

/pmsmst/create

鉴权要求:
HTTP头信息

header:
weaver-token=${token}

或 链接参数

urlParameter:
?weaver-token=${token}

PS:以上两种形式只能二选一

PMSMST01.字段说明一.postBody

字段	类型	说明	必须
sysDate	String	该资源所属账期年月日格式:yyyy-MM-dd	必填
mktCodes	string[ ] (字符串数组)	市场码数组,用于服务器验证,仅提交本次资源所涉及之房型编码	必填
rmiCodes	string[ ] (字符串数组)	资源房型代码数组,用于服务器验证,仅提交本次资源所涉及之房型编码	必填
mstList	Map[ ] (对象数组)	主单对象数组	必填

PMSMST01.字段说明二.mstList

字段	类型	说明	必须
accnt	VARCHAR(55)	账单号,UNIQUE非重复	必填
arr	String Datetime	抵达	必填
dep	String Datetime	离店	必填
isGroup	CHAR(1)	是否为团队	必填 T/F
mktCode	VARCHAR(25)	市场码	必填
price	decimal 0.00	房价	必填
restime	String Datetime	预定时间	可空 / "" 空字符
rooms	int	房间数	必填
mstSta	VARCHAR(15)	主单状态	必填
rmiCode	VARCHAR(25)	主单状态	必填

PostRequestBody:

{
    "mktCodes":[
        "TESTMKT1 ",
        "TESTMKT2 "
    ],
    "sysDate":"2016-08-16",
    "rmiCodes":[
        "TESTRMI1 ",
        "TESTRMI2 "
    ],
    "mstList":[
        {
            "accnt":"TESTA00001  ",
            "arr":"2016-08-16 08:10:00",
            "dep":"2016-08-17 12:00:00",
            "isGroup":"F",
            "mktCode":"TESTA1 ",
            "price":200.00,
            "restime":"2016-08-13 16:23:45",
            "rooms":11,
            "mstSta":"T",
            "rmiCode":"TESTRMI1 "
        },
        {
            "accnt":"TESTA00002",
            "arr":"2016-08-16 08:10:00",
            "dep":"2016-08-17 12:00:00",
            "isGroup":"F",
            "mktCode":"TESTA1 ",
            "price":210.00,
            "restime":"2016-08-13 16:23:45",
            "rooms":11,
            "mstSta":"T",
            "rmiCode":"TESTRMI2"
        }
    ]
}

RMS.资源接入

API.RMS01 提交实时资源

场景:

PMS等应用程序,提交rmiResRecords(房型资源记录),用于比价报告 , 尾房促销

method:
POST

URi:

rmi/res

鉴权要求:
HTTP头信息

header:
weaver-token=${token}

或 链接参数

urlParameter:
?weaver-token=${token}

PS:以上两种形式只能二选一

RMS01.字段说明一.postBody

字段	类型	说明	必须
sysDate	String	该资源所属账期年月日格式:yyyy-MM-dd	必填
rmiResRecords	map[ ] (对象数组)	资源对象列表	必填
rmiCodes	string[ ] (字符串数组)	资源房型代码数组,用于服务器验证,仅提交本次资源所涉及之房型编码	必填

RMS01.字段说明二.rmiResRecords

字段	类型	说明	必填
rmiCode	String	房型代码	必填
rmiName	String	房型名称	必填
allNum	int	总间数	必填
avlNum	int	可用间数	必填
occNum	int	占用间数	必填

Post request body 数据样本如下:

{
    "sysDate": "2016-01-01", 
    "rmiResRecords": [
        {
            "rmiCode": "BZ", 
            "rmiName": "标间", 
            "allNum": 99, 
            "avlNum": 50, 
            "occNum": 80
        }, 
        {
            "rmiCode": "JD", 
            "rmiName": "单间",
            "allNum": 99, 
            "avlNum": 50, 
            "occNum": 80
        }, 
        {
            "rmiCode": "HH", 
            "rmiName": "豪间",
            "allNum": 99, 
            "avlNum": 50, 
            "occNum": 80
        }
    ], 
    "rmiCodes": [
        "BZ", 
        "JD", 
        "HH"
    ]
}

return:
success

{
  "envName": "local",
  "resCode": "4c1277efbb0e6866",
  "msg": "success",
  "statusNo": 200,
  "error": "nothing",
  "data": {},
  "re": 3,//提交成功条目数
  "reErr": {}
}

return:

error body

header:
statusCode : 401

{
  "envName": "local",
  "resCode": "dba2ba649ff6184b",
  "msg": "参数校验失败:房型代码於此系统中尚未设置",
  "statusNo": 10404,
  "error": "232222",
  "data": {},
  "re": {},
  "reErr":{}
}

SN.用户模块

API.SN01-应用获取token

一次token存活24小时

场景:

PMS等应用程序,提交rmiResRecords(房型资源记录),需要进行获取token字符串,以便进行后续数据交互

method:
POST

URi:

sign/in

Post body request 字段说明:

字段	类型	中文	必填
logId	String	系统商名称,如dlhis	必填
AppId	String	用户密钥ID	必填
AppKey	String	用户密钥KEY	必填

数据样本,该测试密钥仅在develop模式下有效
sendData:

{
    "logId":"dlhis",
    "AppId":"ID123",
    "AppKey":"KEY123"
}

return:
success

{
  "envName": "local",
  "resCode": "7fed43f7a08e3ef4",
  "msg": "success",
  "statusNo": 200,
  "error": "nothing",
  "data": {
    "weaver-token": "69BD700C8D85A5C1"
  },
  "re": {},
  "reErr": {}
}

PS:resCode响应ID如有未知错误请提供此编码告之

return:
error

{
  "envName": "dev",
  "resCode": "f9f5aa1f55ca772f",
  "msg": "该APPID/APPKEY验证失败,无法获取token",
  "statusNo": 10404,
  "error": "THE_AUTHERAPP_ISNT_EXISTS",
  "data": {},
  "re": {},
  "reErr": {}
}

API.SN05-根据酒店信息,获取APPID

场景:

未注册阿拉丁产品的用户,可直接通过其加密狗号的形式,直接兑换APPID APPKEY;
使用前提,其PMS与本公司深度对接

method:
POST

URi:

sign/hotel

sendData:

{
    "arCode":"6位地区编号",
    "hotelName":"酒店名称",
    "regDog":"加密狗号orPMS注册码序列号"
}

return:

{
  "envName": "dev",
  "version": "1.0.14",
  "resCode": "0648450f72a8936d",
  "msg": "success",
  "statusNo": 200,
  "error": "nothing",
  "data": {
    "appId": "",
    "appKey": ""
  },
  "re": {},
  "reErr": {}
}

感谢
如有疑问请联系 code0515@163.com

Aladin-Weaver 酒店收益设置数据接入 开发说明文档1.3.1

目录

需求目的

API

domain:

Header ContentType

PMSMST.订单接入

PMSMST.INIT 初始化数据

API.PMSMST01 实时订单接口

RMS.资源接入

API.RMS01 提交实时资源

SN.用户模块

API.SN01-应用获取token

API.SN05-根据酒店信息,获取APPID

内容目录

Aladin-Weaver 酒店收益设置数据接入开发说明文档1.3.1