[关闭]
@931876502 2016-09-13T17:34:16.000000Z 字数 12231 阅读 531

信用住管家酒店迁移接口文档

OTA 信用住管家酒店迁移

  • Version:1.7.6
  • Author:杨松
  • CreateTime:2016-08-17
  • LastTime:2016-09-13

调试工具

POSTMAN 测试连接:https://www.getpostman.com/collections/2971e0c220a3d570580a

POSTMAN DOMAIN 环境变量 env

{{ALDOTA}} 接口域名

测试版:TEST =
开发版:DEVE = http://aladinsrv.dev.dlhis.com
预发布:PREPRO = http://aldapi.prepro.dlhis.com
正式版:PRODUCTION = http://api.aladin.dlhis.com



校验模块

API.RS01 校验酒店ID与激光码是否匹配(以及是否有订单正在进行中)

参数说明:

参数 中文名称 类型 举例 说明 参数位置
uId 用户ID Integer 110 必填 RequestBody中
otacHotelid ota酒店ID String(20) HD000001 必填 RequestBody中
regCode 原信用住管家酒店激光码 String(55) store001 必填 RequestBody中

sendData:

  1. {
  2. "uId": 110,
  3. "otacHotelid": "HD000001",
  4. "regCode": "dogno001"
  5. }

response:

  1. {
  2. "resCode": "d65254d8e89b166f",
  3. "statusNo": 200,
  4. "err": "nothing",
  5. "msg": "success",
  6. "actionCode": "",
  7. "re": {},
  8. "data": {},
  9. "reErr": {},
  10. "version": "1.7.6"
  11. }

fail response

  1. {
  2. "resCode": "7a68bdbac61e403c",
  3. "statusNo": 422,
  4. "err": "CHECK_REGCODE_FAILED",
  5. "msg": "OTAC酒店ID和激光码不匹配",
  6. "actionCode": "",
  7. "re": {},
  8. "data": {},
  9. "reErr": {},
  10. "version": "1.7.6"
  11. }

同步酒店信息模块

API.RS02 获取OTAC原信用住管家酒店信息

参数说明:

参数 中文名称 类型 举例 说明 参数位置
uId 用户ID Integer 110 必填 RequestParam中

response

  1. {
  2. "resCode": "666d438fa3faeed9",
  3. "statusNo": 200,
  4. "err": "nothing",
  5. "msg": "success",
  6. "actionCode": "",
  7. "re": {},
  8. "data": {
  9. "arCode": "341723",
  10. "createTime": null,
  11. "htiAddr": "池州市九华山风景区柯村新区",
  12. "htiContact": "",
  13. "htiName": "恒8连锁酒店九华山风景区店",
  14. "htiPhone": "0086#0566#2828248",
  15. "htrId": 0,
  16. "otacHotelid": "HD101689",
  17. "sta": "",
  18. "uId": 41
  19. },
  20. "reErr": {},
  21. "version": "1.7.6"
  22. }

返回值data说明:

返回值 中文名称 类型 举例 说明
htiName 酒店名称 VARCHAR(100) 恒8连锁酒店九华山风景区店
htiPhone 酒店电话 VARCHAR(20) 0086#0566#2828248
otacHotelid otac酒店ID VARCHAR(20) HD101689
arCode 酒店地区代码 CHAR(6) 341723 阿里酒店地区代码
htiAddr 酒店详细地址 CHAR(100) 池州市九华山风景区柯村新区 如:街道地址

API.RS03 完善并保存酒店信息

参数说明:

参数 中文名称 类型 举例 说明 参数位置
uId 用户ID Integer 41 必填 RequestBody中
content 联系人 VARCHAR(20) X经理 必填 RequestBody中
email 邮箱 String(50) hashmap@dingtalk.com 必填 RequestBody中
emailCode 邮箱验证码 VARCHAR(6) 1234 必填 RequestBody中
cellphone 手机号 VARCHAR(11) 135XXXX1239 必填 RequestBody中
phoneCode 手机验证码 VARCHAR(6) 1234 必填 RequestBody中

sendData:

  1. {
  2. "uId": 41,
  3. "content": "X经理",
  4. "email": "hashmap@dingtalk.com",
  5. "emailCode": "1234",
  6. "cellphone": "13554521239",
  7. "phoneCode": "1234"
  8. }

response

  1. {
  2. "resCode": "be230f01c5f98806",
  3. "statusNo": 200,
  4. "err": "nothing",
  5. "msg": "success",
  6. "actionCode": "",
  7. "re": {},
  8. "data": {},
  9. "reErr": {},
  10. "version": "1.7.6"
  11. }

同步Rp信息模块

API.RS04 获取OTA原信用住管家Rp信息

参数说明:

参数 中文名称 类型 举例 说明 参数位置
uId 用户ID Integer 110 必填 RequestParam中

response

  1. {
  2. "resCode": "3d01ef8a2f50e1ff",
  3. "statusNo": 200,
  4. "err": "nothing",
  5. "msg": "success",
  6. "actionCode": "",
  7. "re": {},
  8. "data": [
  9. {
  10. "createTime": null,
  11. "otacHotelid": "HD101689",
  12. "otacRpCode": "RP102455",
  13. "otasrvCancelPolicy": {
  14. "Ctrip": "",
  15. "QUA": {
  16. "cancelPolicyType": "5",
  17. "policyInfo": {
  18. "timeBefore": "18:00"
  19. }
  20. }
  21. },
  22. "otasrvGrtCodeJson": "{\"Ctrip\":\"\",\"QUA\":3}",
  23. "rpBreakfastCount": 2,
  24. "rpName": "不含早",
  25. "rptrId": 0,
  26. "sta": ""
  27. },
  28. {
  29. "createTime": null,
  30. "otacHotelid": "HD101689",
  31. "otacRpCode": "RP106409",
  32. "otasrvCancelPolicy": {
  33. "Ctrip": "",
  34. "QUA": {
  35. "cancelPolicyType": "5",
  36. "policyInfo": {
  37. "timeBefore": "18:00"
  38. }
  39. }
  40. },
  41. "otasrvGrtCodeJson": "{\"Ctrip\":\"\",\"QUA\":3}",
  42. "rpBreakfastCount": 3,
  43. "rpName": "不含早",
  44. "rptrId": 0,
  45. "sta": ""
  46. },
  47. {
  48. "createTime": null,
  49. "otacHotelid": "HD101689",
  50. "otacRpCode": "RP106410",
  51. "otasrvCancelPolicy": {
  52. "Ctrip": "",
  53. "QUA": {
  54. "cancelPolicyType": "5",
  55. "policyInfo": {
  56. "timeBefore": "18:00"
  57. }
  58. }
  59. },
  60. "otasrvGrtCodeJson": "{\"Ctrip\":\"\",\"QUA\":3}",
  61. "rpBreakfastCount": 4,
  62. "rpName": "不含早",
  63. "rptrId": 0,
  64. "sta": ""
  65. },
  66. {
  67. "createTime": null,
  68. "otacHotelid": "HD101689",
  69. "otacRpCode": "RP106411",
  70. "otasrvCancelPolicy": {
  71. "Ctrip": "",
  72. "QUA": {
  73. "cancelPolicyType": "5",
  74. "policyInfo": {
  75. "timeBefore": "18:00"
  76. }
  77. }
  78. },
  79. "otasrvGrtCodeJson": "{\"Ctrip\":\"\",\"QUA\":3}",
  80. "rpBreakfastCount": 4,
  81. "rpName": "不含早",
  82. "rptrId": 0,
  83. "sta": ""
  84. }
  85. ],
  86. "reErr": {},
  87. "version": "1.7.6"
  88. }

返回值data说明:

返回值 中文名称 类型 举例 说明
rpName 房价Rp名称 VARCHAR(20) 不含早
otacRpCode OTARp代码 VARCHAR(20) RP106411
otasrvGrtCodeJson 担保类型 JSON {"Ctrip":"","QUA":3} 担保类型和退订政策有关
otacHotelid otac酒店ID VARCHAR(20) HD101689
otasrvCancelPolicy 退订政策 JSON {"Ctrip": "","QUA": {"cancelPolicyType": "5","policyInfo": {"timeBefore":"18:00"}}} 阿里房价计划退订政策
rpBreakfastCount 早餐份数 Integer 4

API.RS05 完善并保存Rp信息

参数说明:

参数 中文名称 类型 举例 说明 参数位置
uId 用户ID Integer 110 必填 RequestParam中

response

  1. {
  2. "resCode": "b40179fdfdcec4ec",
  3. "statusNo": 200,
  4. "err": "nothing",
  5. "msg": "success",
  6. "actionCode": "",
  7. "re": {},
  8. "data": {},
  9. "reErr": {},
  10. "version": "1.7.6"
  11. }

同步房型信息模块

API.RS06 获取OTA原信用住管家房型信息

参数说明:

参数 中文名称 类型 举例 说明 参数位置
uId 用户ID Integer 110 必填 RequestParam中

response

  1. {
  2. "resCode": "9fb1bb1046b0ad0c",
  3. "statusNo": 200,
  4. "err": "nothing",
  5. "msg": "success",
  6. "actionCode": "",
  7. "re": {},
  8. "data": [
  9. {
  10. "broadbandtype": "B",
  11. "createTime": null,
  12. "haswindow": "1",
  13. "otacHotelid": "HD101689",
  14. "rmiCode": "HD101689_HB",
  15. "rmiName": "豪华标准间",
  16. "rttrId": 0,
  17. "sta": ""
  18. },
  19. {
  20. "broadbandtype": "B",
  21. "createTime": null,
  22. "haswindow": "1",
  23. "otacHotelid": "HD101689",
  24. "rmiCode": "HD101689_HD",
  25. "rmiName": "豪华单人间",
  26. "rttrId": 0,
  27. "sta": ""
  28. },
  29. {
  30. "broadbandtype": "B",
  31. "createTime": null,
  32. "haswindow": "1",
  33. "otacHotelid": "HD101689",
  34. "rmiCode": "HD101689_HT",
  35. "rmiName": "豪华套房",
  36. "rttrId": 0,
  37. "sta": ""
  38. },
  39. {
  40. "broadbandtype": "B",
  41. "createTime": null,
  42. "haswindow": "1",
  43. "otacHotelid": "HD101689",
  44. "rmiCode": "HD101689_PB",
  45. "rmiName": "普通标准间",
  46. "rttrId": 0,
  47. "sta": ""
  48. },
  49. {
  50. "broadbandtype": "B",
  51. "createTime": null,
  52. "haswindow": "1",
  53. "otacHotelid": "HD101689",
  54. "rmiCode": "HD101689_PD",
  55. "rmiName": "普通单人间",
  56. "rttrId": 0,
  57. "sta": ""
  58. },
  59. {
  60. "broadbandtype": "B",
  61. "createTime": null,
  62. "haswindow": "1",
  63. "otacHotelid": "HD101689",
  64. "rmiCode": "HD101689_TJ",
  65. "rmiName": "每日特价房",
  66. "rttrId": 0,
  67. "sta": ""
  68. }
  69. ],
  70. "reErr": {},
  71. "version": "1.7.6"
  72. }

返回值data说明:

返回值 中文名称 类型 举例 说明
rmiName 房型名称 VARCHAR(20) 每日特价房
rmiCode OTA房型代码 VARCHAR(20) HD101689_TJ
haswindow 是否有窗 Enum 1 1:有窗,0:无窗
broadbandtype 宽带类型 Enum B A:无宽带,B:免费宽带,C:收费宽带,D:部分收费宽带
otacHotelid otac酒店ID VARCHAR(20) HD101689

API.RS07 完善并保存房型信息

参数说明:

参数 中文名称 类型 举例 说明 参数位置
uId 用户ID Integer 110 必填 RequestBody中
roomCountInfoList 待完善房型信息列表 LIST 如下 必填 RequestBody中
LIST对象属性
rmiCode 获取房型信息得到的房型代码 String HD101689_HB 必填 RequestBody中
rmiAvl 该房型实际数量 Integer 10 必填 RequestBody中
globalLimit 该房型线上可售总量 Integer 10 必填 RequestBody中

senddata

  1. {
  2. "uId": 41,
  3. "roomCountInfoList": [
  4. {
  5. "rmiCode":"HD101689_HB",
  6. "rmiAvl":10,
  7. "globalLimit":10
  8. },
  9. {
  10. "rmiCode":"HD101689_HD",
  11. "rmiAvl":11,
  12. "globalLimit":11
  13. },
  14. {
  15. "rmiCode":"HD101689_HT",
  16. "rmiAvl":11,
  17. "globalLimit":11
  18. },
  19. {
  20. "rmiCode":"HD101689_PB",
  21. "rmiAvl":11,
  22. "globalLimit":11
  23. },
  24. {
  25. "rmiCode":"HD101689_PD",
  26. "rmiAvl":11,
  27. "globalLimit":11
  28. },
  29. {
  30. "rmiCode":"HD101689_TJ",
  31. "rmiAvl":11,
  32. "globalLimit":11
  33. }
  34. ]
  35. }

response

  1. {
  2. "resCode": "b368c1f1190d5b37",
  3. "statusNo": 200,
  4. "err": "nothing",
  5. "msg": "success",
  6. "actionCode": "",
  7. "re": {},
  8. "data": {},
  9. "reErr": {},
  10. "version": "1.7.6"
  11. }

设置mapping模块

API.RS08 获取mapping信息

参数说明:

参数 中文名称 类型 举例 说明 参数位置
uId 用户ID Integer 110 必填 RequestParam中

response

  1. {
  2. "resCode": "34259c6cf88b6eb4",
  3. "statusNo": 200,
  4. "err": "nothing",
  5. "msg": "success",
  6. "actionCode": "",
  7. "re": {},
  8. "data": [
  9. {
  10. "rmi_id": 153,
  11. "rmi_name": "豪华标准间",
  12. "rp_breakfast_count": 2,
  13. "rp_id": 13,
  14. "rp_name": "不含早",
  15. "rrsc_name": "豪华标准间不含早"
  16. },
  17. {
  18. "rmi_id": 154,
  19. "rmi_name": "豪华单人间",
  20. "rp_breakfast_count": 2,
  21. "rp_id": 13,
  22. "rp_name": "不含早",
  23. "rrsc_name": "豪华单人间不含早"
  24. },
  25. {
  26. "rmi_id": 155,
  27. "rmi_name": "豪华套房",
  28. "rp_breakfast_count": 2,
  29. "rp_id": 13,
  30. "rp_name": "不含早",
  31. "rrsc_name": "豪华套房不含早"
  32. },
  33. {
  34. "rmi_id": 156,
  35. "rmi_name": "普通标准间",
  36. "rp_breakfast_count": 2,
  37. "rp_id": 13,
  38. "rp_name": "不含早",
  39. "rrsc_name": "普通标准间不含早"
  40. },
  41. {
  42. "rmi_id": 157,
  43. "rmi_name": "普通单人间",
  44. "rp_breakfast_count": 2,
  45. "rp_id": 13,
  46. "rp_name": "不含早",
  47. "rrsc_name": "普通单人间不含早"
  48. },
  49. {
  50. "rmi_id": 158,
  51. "rmi_name": "每日特价房",
  52. "rp_breakfast_count": 2,
  53. "rp_id": 13,
  54. "rp_name": "不含早",
  55. "rrsc_name": "每日特价房不含早"
  56. },
  57. {
  58. "rmi_id": 153,
  59. "rmi_name": "豪华标准间",
  60. "rp_breakfast_count": 3,
  61. "rp_id": 14,
  62. "rp_name": "不含早",
  63. "rrsc_name": "豪华标准间不含早"
  64. },
  65. {
  66. "rmi_id": 154,
  67. "rmi_name": "豪华单人间",
  68. "rp_breakfast_count": 3,
  69. "rp_id": 14,
  70. "rp_name": "不含早",
  71. "rrsc_name": "豪华单人间不含早"
  72. },
  73. {
  74. "rmi_id": 155,
  75. "rmi_name": "豪华套房",
  76. "rp_breakfast_count": 3,
  77. "rp_id": 14,
  78. "rp_name": "不含早",
  79. "rrsc_name": "豪华套房不含早"
  80. },
  81. {
  82. "rmi_id": 156,
  83. "rmi_name": "普通标准间",
  84. "rp_breakfast_count": 3,
  85. "rp_id": 14,
  86. "rp_name": "不含早",
  87. "rrsc_name": "普通标准间不含早"
  88. },
  89. {
  90. "rmi_id": 157,
  91. "rmi_name": "普通单人间",
  92. "rp_breakfast_count": 3,
  93. "rp_id": 14,
  94. "rp_name": "不含早",
  95. "rrsc_name": "普通单人间不含早"
  96. },
  97. {
  98. "rmi_id": 158,
  99. "rmi_name": "每日特价房",
  100. "rp_breakfast_count": 3,
  101. "rp_id": 14,
  102. "rp_name": "不含早",
  103. "rrsc_name": "每日特价房不含早"
  104. },
  105. {
  106. "rmi_id": 153,
  107. "rmi_name": "豪华标准间",
  108. "rp_breakfast_count": 4,
  109. "rp_id": 15,
  110. "rp_name": "不含早",
  111. "rrsc_name": "豪华标准间不含早"
  112. },
  113. {
  114. "rmi_id": 154,
  115. "rmi_name": "豪华单人间",
  116. "rp_breakfast_count": 4,
  117. "rp_id": 15,
  118. "rp_name": "不含早",
  119. "rrsc_name": "豪华单人间不含早"
  120. },
  121. {
  122. "rmi_id": 155,
  123. "rmi_name": "豪华套房",
  124. "rp_breakfast_count": 4,
  125. "rp_id": 15,
  126. "rp_name": "不含早",
  127. "rrsc_name": "豪华套房不含早"
  128. },
  129. {
  130. "rmi_id": 156,
  131. "rmi_name": "普通标准间",
  132. "rp_breakfast_count": 4,
  133. "rp_id": 15,
  134. "rp_name": "不含早",
  135. "rrsc_name": "普通标准间不含早"
  136. },
  137. {
  138. "rmi_id": 157,
  139. "rmi_name": "普通单人间",
  140. "rp_breakfast_count": 4,
  141. "rp_id": 15,
  142. "rp_name": "不含早",
  143. "rrsc_name": "普通单人间不含早"
  144. },
  145. {
  146. "rmi_id": 158,
  147. "rmi_name": "每日特价房",
  148. "rp_breakfast_count": 4,
  149. "rp_id": 15,
  150. "rp_name": "不含早",
  151. "rrsc_name": "每日特价房不含早"
  152. },
  153. {
  154. "rmi_id": 153,
  155. "rmi_name": "豪华标准间",
  156. "rp_breakfast_count": 4,
  157. "rp_id": 16,
  158. "rp_name": "不含早",
  159. "rrsc_name": "豪华标准间不含早"
  160. },
  161. {
  162. "rmi_id": 154,
  163. "rmi_name": "豪华单人间",
  164. "rp_breakfast_count": 4,
  165. "rp_id": 16,
  166. "rp_name": "不含早",
  167. "rrsc_name": "豪华单人间不含早"
  168. },
  169. {
  170. "rmi_id": 155,
  171. "rmi_name": "豪华套房",
  172. "rp_breakfast_count": 4,
  173. "rp_id": 16,
  174. "rp_name": "不含早",
  175. "rrsc_name": "豪华套房不含早"
  176. },
  177. {
  178. "rmi_id": 156,
  179. "rmi_name": "普通标准间",
  180. "rp_breakfast_count": 4,
  181. "rp_id": 16,
  182. "rp_name": "不含早",
  183. "rrsc_name": "普通标准间不含早"
  184. },
  185. {
  186. "rmi_id": 157,
  187. "rmi_name": "普通单人间",
  188. "rp_breakfast_count": 4,
  189. "rp_id": 16,
  190. "rp_name": "不含早",
  191. "rrsc_name": "普通单人间不含早"
  192. },
  193. {
  194. "rmi_id": 158,
  195. "rmi_name": "每日特价房",
  196. "rp_breakfast_count": 4,
  197. "rp_id": 16,
  198. "rp_name": "不含早",
  199. "rrsc_name": "每日特价房不含早"
  200. }
  201. ],
  202. "reErr": {},
  203. "version": "1.7.6"
  204. }

返回值data说明:

返回值 中文名称 类型 举例 说明
rrsc_name mapping名称 VARCHAR(20) 每日特价房不含早
rmi_name 房型名称 VARCHAR(20) 每日特价房
rp_name 房价名称 VARCHAR(20) 不含早
rmi_id 房型ID Integer 158
rp_id 房价ID Integer 16
rp_breakfast_count 早餐份数 Integer 4

API.RS09 完善并保存mapping信息

参数说明:

参数 中文名称 类型 举例 说明 参数位置
uId 用户ID Integer 110 必填 RequestBody中
rmRpList mapping待完善信息列表 LIST 参数同aladin更新mapping 必填 RequestBody中

senddata

  1. {
  2. "uId": 1,
  3. "rmRpList": [
  4. {
  5. "rrsc_name":"标间无早",
  6. "otasrv_code":"QUA",
  7. "rmi_id":10,
  8. "rp_id":101,
  9. "rrsc_steps_point":"{5,6}",
  10. "rrsc_steps_price":"12800",
  11. "rrsc_stand_price":"10000",
  12. "rrsc_steps_limit":10,
  13. "rrsc_stand_limit":10
  14. },
  15. {
  16. "rrsc_name":"大床房无早",
  17. "otasrv_code":"QUA",
  18. "rmi_id":11,
  19. "rp_id":101,
  20. "rrsc_steps_point":"{5,6}",
  21. "rrsc_steps_price":"25600",
  22. "rrsc_stand_price":"19900",
  23. "rrsc_steps_limit":10,
  24. "rrsc_stand_limit":10
  25. }
  26. ]
  27. }

response

  1. {
  2. "resCode": "44f4a7c141a70b49",
  3. "statusNo": 200,
  4. "err": "nothing",
  5. "msg": "success",
  6. "actionCode": "",
  7. "re": {},
  8. "data": {},
  9. "reErr": {},
  10. "version": "1.7.6"
  11. }

设置订单走向模块

API.RS10 设置原信用住管家订单走向变为ALADIN

参数说明:

参数 中文名称 类型 举例 说明 参数位置
uId 用户ID Integer 110 必填 RequestParam中

response

  1. {
  2. "resCode": "18c171121ff01377",
  3. "statusNo": 200,
  4. "err": "nothing",
  5. "msg": "success",
  6. "actionCode": "",
  7. "re": {},
  8. "data": {},
  9. "reErr": {},
  10. "version": "1.7.6"
  11. }

同步订单信息模块

API.RS11 获取OAT原信用住管家订单信息

参数说明:

参数 中文名称 类型 举例 说明 参数位置
uId 用户ID Integer 110 必填 RequestParam中

response

  1. {
  2. "resCode": "dc06913bc69006bd",
  3. "statusNo": 200,
  4. "err": "nothing",
  5. "msg": "success",
  6. "actionCode": "",
  7. "re": {},
  8. "data": [
  9. {
  10. "createTime": "2016-09-13 16:54:07",
  11. "logTime": "2016-08-17 09:05:18",
  12. "orderInfoJson": null,
  13. "otaOrderNo": "2206637007362286",
  14. "otacHotelid": "HD101689",
  15. "otrId": 127,
  16. "sta": "T"
  17. },
  18. {
  19. "createTime": "2016-09-13 16:54:07",
  20. "logTime": "2016-09-12 16:24:10",
  21. "orderInfoJson": null,
  22. "otaOrderNo": "2337250010395722",
  23. "otacHotelid": "HD101689",
  24. "otrId": 128,
  25. "sta": "T"
  26. }
  27. ],
  28. "reErr": {},
  29. "version": "1.7.6"
  30. }

返回值data说明:

返回值 中文名称 类型 举例 说明
otaOrderNo 淘宝订单编号 VARCHAR(20) 2337250010395722
logTime 订单建立时间 VARCHAR(19) 2016-09-12 16:24:10 格式"yyyy-MM-dd"

API.RS12 保存order信息

参数说明:

参数 中文名称 类型 举例 说明 参数位置
uId 用户ID Integer 110 必填 RequestParam中

response

  1. {
  2. "resCode": "811b26530eb4c4dc",
  3. "statusNo": 200,
  4. "err": "nothing",
  5. "msg": "success",
  6. "actionCode": "",
  7. "re": {},
  8. "data": {},
  9. "reErr": {},
  10. "version": "1.7.6"
  11. }
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注