美亚航旅机票B2B接口

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

7.1.1请求参数

参数	类型	说明	必填	备注
TOOrderID	String	订单号	Y	待作废的TO/TC单单号
PassengerList	Array	乘客组	Y
QDOrderID	String	第三方作废单号	Y
contact	Object	联系信息	N	订单联系信息，若不传则默认取原单
attachmentList	Array	附件信息	N	2024-08新增 9.5 附件上传(IFileUpload)的requestkey

PassengerList：

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

contact：

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

7.1.2请求样例

{
    "TOOrderID": "TO16020574887",
    "PassengerList": [
        {
            "TOPassengerID": "836953"
        }
    ],
    "QDOrderID": "1"
}

7.1.3返回参数

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

detail:

参数	类型	说明	备注
TVOrderID	String	作废单编号
status	Int	订单状态	参考废票单详情
TVFinanceList	Array	废票单财务信息	若为4:待作废,则系统自动作废流程若为2、3:待审核,则需等待人工报价

TVFinanceList:

参数	类型	说明	备注
passengerType	Int	乘客类型	0：成人 1：儿童 2：婴儿 3：老人 4：学生 5：劳务 6：移民 7：海员 8：青年
toPrice	Decimal	原单退款金额
voidedFee	Decimal	作废手续费
Fee	Decimal	服务费
saleTotal	Decimal	合计

7.1.4返回样例

{
    "code": "20000",
    "detail": {
        "TVOrderID": "TV16020500617",
        "status": 2,
        "TCFinanceList": [
            {
                "passengerType": 0,
                "toPrice": 999,
                "voidedFee": 0,
                "Fee": 0,
                "saleTotal": 999
            }
        ]
    }
}

美亚航旅机票B2B接口

用户工具

站点工具

目录

7.1.1请求参数

7.1.2请求样例

7.1.3返回参数

7.1.4返回样例

页面工具