运价中心统一权益服务

服务简介 由运价中心提供的统一权益服务， 服务包含接口如下：

接口名称	接口目录	httpMethods
统一权益接口	接入API后获取	POST

1. 统一权益接口

接口简介 由运价中心提供的统一权益接口，目前支持国内升舱和国际升舱两种权益

1.1输入契约

1.1.1 HEADER

项名	说明	是否必须
identification	识别请求方的标识，请向运价中心管理员申请	是
request-id	溯源ID（长度最大32位的字符串），若有设置本参数则会在响应的HEADER中返回相同的值	否

1.1.2 BODY

JSON形式，接口输入契约如下，对于每种权益，只有其中一部分参数有效，以下会针对性地分别说明

类名或节点	属性名	类型	是否必需	描述
根节点	segInfo	RequestFlightInfo	是	航班相关信息
	ticketInfo	RequestTicketInfo	是	客票相关信息
	rightList	List	是	请求权益信息列表
RequestFlightInfo	flightNo	String	否	承运方航班号
	depCity	String	否	始发地
	arrCity	String	否	目的地
	carrier	String	否	承运方航空公司
	marketCarrier	String	否	市场方航空公司
	marketFlightNo	String	否	市场方航班号
	cabin	String	否	舱位
	flightDate	Date (String)	否	起飞日期，格式为yyyy-MM-dd，时区为GMT+8
RequestTicketInfo	ticketType	String	是	客票类型
	ticketNum	String	否	票号
	prices	String	否	价格(FC_PRICE)
	psgType	String	否	旅客类型（PSGTYPE），儿童CHD，婴儿INF，成人ADT或空
	ticketCurrency	String	否	客票币种（输入币种）
RequestRightInfo	rightType	ProductTypeEnum	是	请求权益类型
	rightReqeustId	String	是	权益标识
	otherInfo	Map<String, String>	否	其他请求参数

1.1.2.1 RightTypeEnum可选值

编码	描述
INT_UPGRADE	国际升舱
DOM_UPGRADE	国内升舱

1.1.2.2 国际升舱

以下仅列举对于国际升舱有效的输入契约参数，未列举的参数即无效，在计算本权益时会被忽略

类名或节点	属性名	类型	是否必需	描述
根节点	segInfo	RequestFlightInfo	是	航班相关信息
	ticketInfo	RequestTicketInfo	是	客票相关信息
	rightList	List	是	请求权益信息列表
RequestFlightInfo	flightNo	String	是	承运方航班号
	depCity	String	是	始发地
	arrCity	String	是	目的地
	carrier	String	是	承运方航空公司
	flightDate	Date (String)	是	起飞日期，格式为YYYY-MM-DD，时区为GMT+8
RequestTicketInfo	ticketType	String	是	客票类型，可选值及说明：0 换开票，1 价格异常，2 单段，3 多段一张票，4 多段有联票
	ticketNum	String	是	票号
	prices	String	是	价格(FC_PRICE)
	psgType	String	否	旅客类型（PSGTYPE），儿童CHD，婴儿INF，成人ADT或空
	ticketCurrency	String	是	客票币种（输入币种）
RequestRightInfo	rightType	RightTypeEnum	是	请求权益类型
	rightReqeustId	String	是	权益标识
	otherInfo	Map<String, String>	是	其他请求参数
otherInfo	payCurrency	String	是	支付货币类型
	airRoute	String	否	航路，需要将各航程合并，用”/”隔开，如”KMGFOC/FOCWUX”，涉及多段则继续用”/”隔开继续添加，缺口程航段放空，如”CGOXMN/XMNTSA//TPEXMN/XMNCGO”，此航路中TSATPE为缺口程

1.1.2.2.1 请求示例

{  
  "rightList": [  
    {  
      "otherInfo": {  
        "airRoute": "PKXXMN/XMNMLE",  
        "payCurrency": "CNY"  
      },  
      "rightReqeustId": "120939123231",  
      "rightType": "INT_UPGRADE"  
    }  
  ],  
  "segInfo": {  
    "arrCity": "MLE",  
    "cabin": "U",  
    "carrier": "MF",  
    "depCity": "XMN",  
    "flightDate": "2024-11-20",  
    "flightNo": "MF606"  
  },  
  "ticketInfo": {  
    "prices": "3500",  
    "psgType": "ADT",  
    "ticketCurrency": "CNY",  
    "ticketNum": "73100000",  
    "ticketType": "4"  
  }  
}

1.1.2.3 国内升舱

以下仅列举对于国内升舱有效的输入契约参数，未列举的参数即无效，在计算本权益时会被忽略

类名或节点	属性名	类型	是否必需	描述
根节点	segInfo	RequestFlightInfo	是	航班相关信息
	ticketInfo	RequestTicketInfo	是	客票相关信息
	rightList	List	是	请求权益信息列表
RequestFlightInfo	flightNo	String	是	承运方航班号
	depCity	String	是	始发地
	arrCity	String	是	目的地
	carrier	String	是	承运方航空公司
	cabin	String	是	舱位
	flightDate	Date (String)	是	起飞日期，格式为YYYY-MM-DD，时区为GMT+8
RequestTicketInfo	ticketType	String	是	客票类型，可选值及说明：0 换开票，1 单段，2 多段-价格公开，3 多段-价格合并，4 国际票的国内段，5 代码共享-换开
	ticketNum	String	是	票号
	prices	String	否	价格(FC_PRICE)
RequestRightInfo	rightType	RightTypeEnum	是	请求权益类型
	rightReqeustId	String	是	权益标识
	otherInfo	Map<String, String>	否	其他请求参数
otherInfo	airRoute	String	否	航路，需要将各航程合并，用”/”隔开，如”KMGFOC/FOCWUX”，涉及多段则继续用”/”隔开继续添加，缺口程航段放空，如”CGOXMN/XMNTSA//TPEXMN/XMNCGO”，此航路中TSATPE为缺口程

1.1.2.3.1 请求示例：

{  
  "rightList": [  
    {  
      "otherInfo": {  
        "airRoute": "XMNCSX"  
      },  
      "rightReqeustId": "120939123232",  
      "rightType": "DOM_UPGRADE"  
    }  
  ],  
  "segInfo": {  
    "arrCity": "CSX",  
    "cabin": "U",  
    "carrier": "MF",  
    "depCity": "XMN",  
    "flightDate": "2024-10-20",  
    "flightNo": "MF606"  
  },  
  "ticketInfo": {  
    "prices": "3500",  
    "psgType": "ADT",  
    "ticketCurrency": "CNY",  
    "ticketNum": "73100000",  
    "ticketType": "5"  
  }  
}

1.2 输出契约

1.2.1 HEADER

项名	说明
request-id	溯源ID（长度最大32位的字符串），请求的header若设置了request-id项，此处会与请求中的值保持一致，优先级为：请求header的request-id>主动生成

1.2.2 BODY

JSON形式

类名或节点	属性名	类型	描述
根节点	rightOfferList	List	可用权益列表
RightOffer	rightType	RightTypeEnum	请求权益类型
	price	BigDecimal	权益价格
	payCurrency	String	支付币种（输出币种）
	rightRequestId	String	权益标识（通过rightRequestId关联输入与输出）