[关闭]
@lxx3061313 2018-07-24T05:43:13.000000Z 字数 7759 阅读 170

hotel mgr后台接口

未分类

订单操作

订单基础枚举

url：/kissfish/man/order/baseinfo
method:get
request:null
response:

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": {
  5.         "orderStatus": {
  6.             "INIT": "平台下单",
  7.             "ORDER_CONFIRMED": "订单已经确认(下单成功)",
  8.             "ORDER_CANCELLED": "已取消",
  9.             "ORDER_CONFIRM_FAIL": "下单失败、满房等",
  10.             "CHECKED_OUT": "已离店",
  11.             "SUPPLIER_WAIT_PAY": "等待支付",
  12.             "ORDER_WAIT_CONFIRM": "等待确认",
  13.             "NO_SHOW": "未入住",
  14.             "CHECKED_IN": "已入住"
  15.         },
  16.         "suppliers": {
  17.             "HDS": "发现假期"
  18.         },
  19.         "platform": {
  20.             "ALI_TRIP": "飞猪"
  21.         }
  22.     }
  23. }

订单列表

url:/kissfish/man/order/list
method:post;
request:

  1. {
  2. "currentPage":1,// 分页参数
  3. "pageSize":10,//分页参数
  4. "orderNo":"58401049735596672",//订单号
  5. "platfromOrderNo":"",//分销平台订单号
  6. "supplierOrderNo":"",//供应商订单号
  7. "hotelName":"",//就店名称
  8. "contactPhone":"18600009886",//联系人电话
  9.   "checkIn":"2018-07-21",//入住日期 yyyy-MM-dd
  10.   "checkOut":"2018-07-22",//离店日期 yyyy-MM-dd 
  11.   "createTime":"2018-07-22",//订单创建时间, yyyy-MM-dd
  12.   "minBasePrice":17,//最小底价
  13.   "maxBasePrice":100,//最大底价
  14.   "orderStatus":"",//订单状态，枚举上baseinf接口
  15.   "supplier":"",//供应商，见baseinfo枚举
  16.   "platform":"",//分销商，见baseinfo枚举
  17.   "needInvoice":""//布尔值
  18. }

respoonse:

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": {
  5.         "totalCount": 1,
  6.         "orderList": [
  7.             {
  8.                 "orderId": "58401049735596672",
  9.                 "hotelName": "",
  10.                 "orderStatus": "INIT",
  11.                 "productId": "572543473#7471897062#128455729",
  12.                 "createTime": "2018-07-18 16:32:57",
  13.                 "checkInTime": "2018-07-21",
  14.                 "checkOutTime": "2018-07-22",
  15.                 "needInvoice": true,
  16.                 "saleAmount": "23.04",
  17.                 "basePrice": "17.72",
  18.                 "roomNight": 1,
  19.                 "supplier": "HDS",
  20.                 "platform": "ALI_TRIP"
  21.             }
  22.         ]
  23.     }
  24. }

订单详情

url:/kissfish/man/order/detail?orderId=58401049735596672
method:get
req:

  1. orderId=?

response:

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": {
  5.         "orderId": "58401049735596672",
  6.         "supplier": "HDS",
  7.         "supplierHotelId": "572543473",
  8.         "supplierHotelName": "西安花时间青年旅舍",
  9.         "hotelTel": "18092168948",
  10.         "city": "xian",
  11.         "address": "西安碑林区振兴路振兴嘉苑25层9号",
  12.         "roomTypeName": "简约地铺",
  13.         "contactName": "李枭雄",
  14.         "contactPhone": "18600207890",
  15.         "logs": [
  16.             {
  17.                 "opName": "ALI_TRIP",
  18.                 "opTime": "2018-07-18 16:32:57",
  19.                 "opContext": "平台：ALI_TRIP创新订单：58401049735596672"
  20.             }
  21.         ]
  22.     }
  23. }

订单备注

url:/kissfish/man/order/remark
method:post
request:

  1. {
  2. "orderId":"58401049735596672",
  3.   "remark":"又拒单了"
  4. }

response:

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": null
  5. }

发票操作

发票相关枚举

url:/kissfish/man/invoice/baseinfo
method:get
request:null
response

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": {
  5.         "invoiceStatus": {
  6.             "ISSUED": "已开票",
  7.             "NOT_ISSUED": "未开票"
  8.         }
  9.     }
  10. }

增加一个订单的发票

url：/kissfish/man/invoice/add
method：post
param:
发票类型

  1. ADDED_VALUE_TAX_GENERAL_INVOICE(1, "增值税普通发票"),
  2. ADDED_VALUE_TAX_SPECIAL_INVOICE(2, "增值税专用发票");

req

  1. {
  2. "orderId":"59997583568801920",
  3.   "invoiceType":"ADDED_VALUE_TAX_GENERAL_INVOICE",
  4.   "invoiceComment":"代订房费",
  5.   "invoiceTax":"23234234234234234j",
  6.   "invoiceHead":"北京协议集团",
  7.   "receiver":"王东",
  8.   "receiverPhone":"19839292832",
  9.   "receiverAddress":"北京金融街2好远"
  10. }

response:

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": null
  5. }
  6. {
  7.     "resCode": 10000,
  8.     "msg": "纳税人识别码不能为空",
  9.     "data": null
  10. }

发票列表

url:/kissfish/man/invoice/list
method:post
request:

  1. {
  2. "currentPage":1,
  3.   "pateSize":10,
  4.   "orderId":"59997583568801920",
  5.   "checkout":"2018-07-22",
  6.   "status":"NOT_ISSUED"//枚举
  7. }

response

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": {
  5.         "totalCount": 1,
  6.         "items": [
  7.             {
  8.                 "orderId": "59997583568801920",
  9.                 "status": "NOT_ISSUED",
  10.                 "invoiceAmount": "25.86",
  11.                 "realInvoiceAmount": "0",
  12.                 "expressFee": "0",
  13.                 "expressCompany": "",
  14.                 "expressOrderNo": "",
  15.                 "checkout": "2018-07-22"
  16.             }
  17.         ]
  18.     }
  19. }

发票详情

url:/kissfish/man/invoice/detail?orderId=59997583568801920
method:get
request:

  1. orderId=59997583568801920

response

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": {
  5.         "invoiceType": "ADDED_VALUE_TAX_GENERAL_INVOICE",
  6.         "receiver": "王东",
  7.         "receiverPhone": "19839292832",
  8.         "receiverAddress": "北京金融街2好远",
  9.         "invoiceHead": "北京协议集团",
  10.         "taxNo": "23234234234234234j",
  11.         "invoiceAmount": "25.86",
  12.         "realInvoiceAmount": "0",
  13.         "orderId": "59997583568801920",
  14.         "platformOrderId": "187264123377405352",
  15.         "expressFee": "0",
  16.         "expressCompany": "",
  17.         "expressOrderNo": ""
  18.     }
  19. }

更新发票

url:/kissfish/man/invoice/update
method:post
request:

  1. {
  2.   "orderId":"59997583568801920",
  3.   "realInvoiceAmount":"400",
  4.   "invoiceType":"ADDED_VALUE_TAX_GENERAL_INVOICE", 
  5.   "invoiceComment":"食品类",
  6.   "invoiceTax":"2348237947982739423242abdc",
  7.   "invoiceHead":"北京芳草地集团",
  8.   "receiver":"马群群群",
  9.   "receiverPhone":"11111111111",
  10.   "receiverAddress":"北京东大桥",
  11.   "expressFee":"15",
  12.   "expressCompany":"顺丰",
  13.   "expressOrderNo":"18729387923",
  14.   "invoiceStatus":"ISSUED"
  15. }

response

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": null
  5. }

赔付信息操作

赔付信息相关枚举

url:/kissfish/man/compensate/baseinfo
method:get
request:null
response:

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": {
  5.         "platform": {
  6.             "ALI_TRIP": "飞猪"
  7.         },
  8.         "supplier": {
  9.             "HDS": "发现假期"
  10.         },
  11.         "method": {
  12.             "WEICHAT_PAY": "微信支付",
  13.             "ZHIFUBAO": "支付宝支付",
  14.             "CASH": "现金支付"
  15.         },
  16.         "party": {
  17.             "GSB_TRIP": "合众",
  18.             "HDS": "发现假期",
  19.             "ALI_TRIP": "飞猪"
  20.         },
  21.         "status": {
  22.             "WAIT_COMPENSATE": "待赔付",
  23.             "COMPENSATED": "已赔付"
  24.         }
  25.     }
  26. }

增加赔付信息

url:/kissfish/man/compensate/add
method:post;
request:

  1. {
  2.   "orderId":"59997583568801920",
  3.   "compensateAmount":"400",
  4.   "compensateMethod":"WEICHAT_PAY", 
  5.   "responsiblePartner":"HDS",
  6.   "remark":"供应商拒单"
  7. }

response

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": null
  5. }

赔付信息列表

url:/kissfish/man/compensate/list
method:post
request:

  1. {
  2.   "currentPage":1,
  3.   "pageSize":20,
  4.   "orderId":"", 
  5.   "supplier":"",//供应商枚举，见baseinfo接口
  6.   "platform":""//分销商，见baseinfo接口
  7. }

response:

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": {
  5.         "totalCount": 2,
  6.         "items": [
  7.             {
  8.                 "orderId": "59997583568801920",
  9.                 "supplier": "HDS",
  10.                 "platform": "ALI_TRIP",
  11.                 "compensateAmount": "400",
  12.                 "compensateMethodDesc": "微信支付",
  13.                 "compensateMethod": "WEICHAT_PAY",
  14.                 "responsibleParty": "HDS",
  15.                 "responsiblePartyDesc": "发现假期",
  16.                 "status": "WAIT_COMPENSATE",
  17.                 "statusDesc": "待赔付",
  18.                 "remark": "供应商拒单"
  19.             },
  20.             {
  21.                 "orderId": "59745666557022400",
  22.                 "supplier": "HDS",
  23.                 "platform": "ALI_TRIP",
  24.                 "compensateAmount": "25.86",
  25.                 "compensateMethodDesc": "现金支付",
  26.                 "compensateMethod": "CASH",
  27.                 "responsibleParty": "ALI_TRIP",
  28.                 "responsiblePartyDesc": "飞猪",
  29.                 "status": "WAIT_COMPENSATE",
  30.                 "statusDesc": "待赔付",
  31.                 "remark": "平台故障"
  32.             }
  33.         ]
  34.     }
  35. }

赔付信息更新

url:/kissfish/man/compensate/update
method:post
request:

  1. {
  2.   "orderId":"59997583568801920", 
  3.   "compensateAmount":"100",
  4.   "method":"ZHIFUBAO",
  5.   "responsibleParty":"GSB_TRIP",
  6.   "remark":"这里测试一下更新的机制",
  7.   "status":"COMPENSATED"
  8. }

response:

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": null
  5. }

赔付信息详情

url:/kissfish/man/compensate/detail?orderId=59997583568801920
method:get
request;

  1. orderId=59997583568801920

response:

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": {
  5.         "orderId": "59997583568801920",
  6.         "supplier": "HDS",
  7.         "platform": "ALI_TRIP",
  8.         "compensateAmount": "100",
  9.         "compensateMethodDesc": "支付宝支付",
  10.         "compensateMethod": "ZHIFUBAO",
  11.         "responsibleParty": "GSB_TRIP",
  12.         "responsiblePartyDesc": "合众",
  13.         "status": "COMPENSATED",
  14.         "statusDesc": "已赔付",
  15.         "remark": "这里测试一下更新的机制"
  16.     }
  17. }

加价规则操作

加价规则枚举

url：/kissfish/man/price/rule/baseinfo
method:get
request:null
response:

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": {
  5.         "ruleStatus": {
  6.             "VALID": "可用",
  7.             "INVALID": "不可用"
  8.         },
  9.         "type": {
  10.             "HOTEL_SUPPLIER_HOTEL": "供应商下面酒店加价",
  11.             "HOTEL_SUPPLIER_HOTEL_ROOM_RP": "RP级别加价",
  12.             "HOTEL_SUPPLIER": "酒店供应商加价",
  13.             "HOTEL_PLATFORM": "酒店分销平台加价",
  14.             "HOTEL_SUPPLIER_HOTEL_ROOM": "酒店房型级别加价"
  15.         }
  16.     }
  17. }

添加加价规则

url：/kissfish/man/price/rule/add
method：post
requests:

  1. {
  2.   "priceType":"HOTEL_PLATFORM", 
  3.   "method":{"calModel":"PERCENT_VALUE","value":"0.1"},
  4.   "overCal":"true",
  5.   "platform":"ALI_TRIP",
  6.   "supplier":"HDS",
  7.   "hotelId":"573232521",
  8.   "roomId":"",
  9.   "rateplanId":"",
  10.   "ruleStatus":"VALID"
  11. }

response:

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": null
  5. }
  6. {
  7.     "resCode": 10000,
  8.     "msg": "该加价规则已经存在",
  9.     "data": null
  10. }

规则列表

url:/kissfish/man/price/rule/list
method:post
request:

  1. {
  2.   "currentPage":1,
  3.   "pageSize":10,
  4.   "addPriceType":"HOTEL_PLATFORM", 
  5.   "platform":"ALI_TRIP",
  6.   "supplier":"HDS",
  7.   "hotelId":"573232521",
  8.   "roomId":"",
  9.   "rateplanId":"",
  10.   "ruleStatus":"VALID"
  11. }

response:

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": {
  5.         "totalCount": 1,
  6.         "rules": [
  7.             {
  8.                 "id": 4,
  9.                 "bizType": "HOTEL",
  10.                 "ruleId": "ALI_TRIP",
  11.                 "addPriceType": "HOTEL_PLATFORM",
  12.                 "addPriceTypeDesc": "酒店分销平台加价",
  13.                 "calModel": "PERCENT_VALUE",
  14.                 "calModelDesc": "百分比",
  15.                 "value": 0.1,
  16.                 "overCal": true,
  17.                 "createTime": "2018-07-22 19:14:29"
  18.             }
  19.         ]
  20.     }
  21. }

更新加价规则

url:/kissfish/man/price/rule/update
method:post
request:

  1. {
  2.   "ruleId":"ALI_TRIP",
  3.   "calModel":"CONCRETE_VALUE",
  4.   "value":"20", 
  5.   "overCal":"true",
  6.   "ruleStatus":"VALID"
  7. }

response

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": null
  5. }

规则详情

url:/kissfish/man/price/rule/detail?ruleId=5
method:get;
req:null
response:

  1. {
  2.     "resCode": 0,
  3.     "msg": null,
  4.     "data": {
  5.         "id": 5,
  6.         "bizType": "HOTEL",
  7.         "ruleId": "ALI_TRIP",
  8.         "addPriceType": "HOTEL_PLATFORM",
  9.         "addPriceTypeDesc": "酒店分销平台加价",
  10.         "calModel": "CONCRETE_VALUE",
  11.         "calModelDesc": "具体数字",
  12.         "value": 20,
  13.         "overCal": true,
  14.         "createTime": "2018-07-22 19:39:31"
  15.     }
  16. }
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注