美亚航旅机票B2B接口

这是本文档旧的修订版！

已购买的保险单按是否符合退保规定(产品为可退的、保险保障期仍未开始生效、保险单没有开具报销凭证等)进行退保处理。退票完成后详情中返回退保信息(如保险单有退保单创建可接入【合作方退保单通知(IMeiyaIROrderNotice)】获取退保单)；若无退保信息,请使用【退保申请前检验(IIROrderApplyCheck)】接口判断是否可退保申请若可申请退保请使用【退保申请(IIROrderSave)】接口申请退保

6.1.1请求参数

参数	类型	说明	必填	备注
TOOrderID	String	订单号	Y	待退票的TO/TC单单号
serialNumber	String	退票报价key	N	如退票报价成功并传入时则TROperation可传0/1(不必传3再进行退票询价)
PassengerList	Array	乘客组	Y
FlightList	Array	航段组	Y
QDOrderID	String	第三方退票单号	Y
TRReason	Int	退票原因若传了 serialNumber时，则按报价请求时取值，忽略该赋值	Y	0. 自愿退票 1. 非自愿退票：其他（请备注具体原因） 3. 非自愿退票：航班延误取消 4. 非自愿退票：因病/身故无法乘机
TROperation	Int	退票操作	Y	0:直接退票_委托美亚取消编码座位(提交后PNR将被取消且不可恢复) 1:直接退票_已自行取消编码_请粘贴取消编码的RT文本 3:退票询价_暂不取消编码注：原单为TC或TO为非美亚编码的订单不可选择0 选择0和1，美亚客服会直接按照客规操作退票，不再与您确认；如为先询价，再确认，请选择3，退票询价
TRReasonContent	String	退票原因（备注）	Y/N	TRReason=1时，必填写此备注
PNRText	String	编码取消记录（黑屏RT记录）	Y/N	TROperation=1时需填写
contact	Object	联系信息	N	订单联系信息，若不传则默认取原单
attachmentList	Array	附件信息	N	2024-07新增 9.5 附件上传(IFileUpload)的requestkey

PassengerList：

参数	类型	说明	必填	备注
TOPassengerID	Int	订单乘客编号	Y	欲退票的乘客对应的原TO单乘客编号，可从ITOOrderDetailQuery/ITCOrderDetailQuery接口查询获取（passengerList/TCPassengerList列表中的passengerID）

FlightList：

参数	类型	说明	必填	备注
TOFlightID	Int	航段编号	Y	欲退票的航段对应的原TO单的航段编号，可从ITOOrderDetailQuery/ITCOrderDetailQuery接口查询获取（flightList/TCFlightList列表中的flightID）

contact：

参数	类型	说明	必填	备注
linker	String	联系人	Y
phone	String	联系人手机	Y
email	String	邮箱	N
content	String	备注	N
isEmail	Boolean	退票邮件通知	N	默认为“false”；若“true”则退票成功发送邮件至上面参数邮箱
isSMS	Boolean	退票短信通知	N	默认为“false”；若“true”则退票成功发送短信至上面参数联系人手机

6.1.2请求样例

{
    "TOOrderID": "TO16020574887",
    "PassengerList": [
        {
            "TOPassengerID": "836955"
        },
        {
            "TOPassengerID": "836957"
        }
    ],
    "FlightList": [
        {
            "TOFlightID": "1077654"
        },
        {
            "TOFlightID": "1077655"
        }
    ],
"QDOrderID": "1",
"TRReason": "0",
"TROperation": "0",
“TRReasonContent”:”退票原因备注”
}

6.1.3返回参数

参数	类型	说明	备注
code	String	是否调用接口成功	20000表示成功，非20000表异常
detail	Object	结果集
description	String	描述	当异常时记录异常信息

detail:

参数	类型	说明	备注
TROrderID	String	退票单编号
status	String	订单状态	参考退票单详情若为7:待价格确认,则系统自动报价,确认支付即可进行退票; 若为2、3、6:待审核,则需等待人工报价
TRFinanceList	Array	退票单财务信息组

TRFinanceList:

参数	类型	说明	备注
passengerType	Int	乘客类型	0：成人 1：儿童 2：婴儿 3：老人 4：学生 5：劳务 6：移民 7：海员 8：青年
toPrice	Decimal	原单退款金额
originOrderFee	Decimal	原单手续费
usePrice	Decimal	已使用航段费
returnFee	Decimal	退票手续费
serviceFee	Decimal	服务费
saleTotal	Decimal	合计

6.1.4返回样例

{
    "code": "20000",
    "detail": {
        "TROrder":"TR16021500377",
        "status": "2",
        "TRFinanceList": []
    }
}

美亚航旅机票B2B接口

用户工具

站点工具

目录

6.1.1请求参数

6.1.2请求样例

6.1.3返回参数

6.1.4返回样例

页面工具