专资影票订单上报需要的信息接口

2017-09-30 本文已影响0人行走的路人丙

1.实时消息内容

使用MQ进行实时消息传递，传递内容使用json格式。
发送消息的时机：
1.影票订单确认完成，并且营业日期为当天的，发送售票消息（operation: 1）。
2.影票订单确认完成，并且营业日期大于当天的，发送预售消息（operation: 3）。
3.影票订单取消/退订订单发送退票消息（operation:2）。
4.改签操作，系统调用取消订单->锁座->确认订单，则应该发送两次消息，一次取消订单消息，一次销售或预售消息。

1.1 消息字段说明

字段名称	字段说明	字段类型	备注
orderId	服务商系统订单ID	string	小于等于32个字符
businessDate	营业日期	string	格式：yyyy-MM-dd
cinemaCode	影院编码	string	8位数字字符组成
screenCode	影厅编码	string	小于等于16个字符
filmCode	影片编码	string	固定12位数字字符组成
sessionCode	场次编码	string	小于等于16个字符
sessionDateTime	影片放映时间	string	格式：yyyy-MM-ddThh:mm:ss
ticketCode	电影票编码	string	固定16位数字字符组成
seatCode	座位编码	string	小于等于16个字符
ticketPrice	影票价格	int	单位：分
servicePrice	网络服务费	int	单位：分
operation	操作	int	1：售票，2：退票，3：预售
operationDateTime	操作时间	string	格式：yyyy-MM-ddThh:mm:ss

1.2 示例

MQ通道： report.ticket.order
消息内容：

{
    "orderId": "TO201709190938451772583",
    "businessDate": "2017-10-09",
    "cinemaCode": "35012401",
    "screenCode": "3",
    "filmCode": "077101622017",
    "sessionCode": "9191709136J2XP84",
    "sessionDateTime ": "2017-09-15T10:30:00",
    "ticketCode": "9191709180001799",
    "seatCode": "9",
    "ticketPrice": "3500",
    "servicePrice": "200",
    "operation": 1,
    "operationDateTime": "2017-09-15T09:32:25"
}

2.历史查询接口

以 HTTP GET 接口形式提供。所有查询条件均非必填字段，可根据需要选择性的进行填写。

2.1 查询参数说明

字段名称	字段说明	字段类型	备注
startBusinessDate	营业日期查询开始时间，营业日期时间上限	string	格式：yyyy-MM-dd
endBusinessDate	营业日期查询结束时间，营业日期时间下限	string	格式：yyyy-MM-dd
cinemaCode	影院编码	string	固定8位数字字符组成
screenCode	影厅编码	string	小于等于16个字符
filmCode	影片编码	string	固定12位数字字符组成
sessionCode	场次编码	string	小于等于16个字符
ticketCode	电影票编码	string	固定16位数字字符组成
startDateTime	查询开始时间，票务操作时间上限	string	格式：yyyy-MM-ddThh:mm:ss
endDateTime	查询结束时间，票务操作时间下限	string	格式：yyyy-MM-ddThh:mm:ss

2.2 返回字段说明

字段名称	字段说明	字段类型	备注
orderId	服务商系统订单ID	string	小于等于32个字符
businessDate	营业日期	string	格式：yyyy-MM-dd
cinemaCode	影院编码	string	固定 8位数字字符组成
screenCode	影厅编码	string	小于等于16个字符
filmCode	影片编码	string	固定12位数字字符组成
sessionCode	场次编码	string	小于等于16个字符
sessionDateTime	影片放映时间	string	格式：yyyy-MM-ddThh:mm:ss
ticketCode	电影票编码	string	固定16位数字字符组成
seatCode	座位编码	string	小于等于16个字符
ticketPrice	影票价格	int	单位：分
servicePrice	网络服务费	int	单位：分
saleDateTime	影票销售时间	string	格式：yyyy-MM-ddThh:mm:ss
refundDateTime	影票退票时间	string	格式：yyyy-MM-ddThh:mm:ss

2.3 返回示例

请求：

curl "http://192.168.10.90:8081/report/ticket/getOrderList?cinemaCode=35012401&startBusinessDate=2017-10-09&endBusinessDate=2017-10-10"

{
    [
        {
            "orderId ": "TO201709190938451772583",
            "businessDate ": "2017-10-09",
            "cinemaCode ": "35012401",
            "screenCode": "3",
            "filmCode": "077101622017",
            "sessionCode": "9191709136J2XP84",
            "sessionDateTime ": "2017-09-15T10:30:00",
            "ticketCode": "9191709180001799",
            "seatCode": "9",
            "ticketPrice": "3500",
            "servicePrice": "200",
            "saleDateTime": "2017-09-15T09:32:25"
        },
        {
            "orderId ": "TO201709151453250693641",
            "businessDate ": "2017-10-09",
            "cinemaCode ": "35012401",
            "screenCode": "3",
            "filmCode": "077101622017",
            "sessionCode": "9191709136J2XP84",
            "sessionDateTime ": "2017-09-15T10:30:00",
            "ticketCode": "9191709180001802",
            "seatCode": "6",
            "ticketPrice": "3500",
            "servicePrice": "200",
            "saleDateTime": "2017-09-15T09:32:25",
            "refundDateTime": "2017-09-15T09:32:25"
        }
    ]
}