| 两侧同时换到之前的修订记录
前一修订版
后一修订版
|
前一修订版
|
6.1_退票申请_iticketrulequeryv2 [2021/02/08 06:12]
tiny [6.1.1请求参数] |
6.1_退票申请_iticketrulequeryv2 [2024/08/08 07:03] (当前版本)
tiny [表] |
| 6.1退票申请(ITROrderSave) | 6.1退票申请(ITROrderSave) |
| | |
| | <color #ed1c24>已购买的保险单按是否符合退保规定(产品为可退的、保险保障期仍未开始生效、保险单没有开具报销凭证等)进行退保处理。 退票完成后详情中返回退保信息(如保险单有退保单创建可接入【合作方退保单通知(IMeiyaIROrderNotice)】获取退保单)；若无退保信息,请使用【退保申请前检验(IIROrderApplyCheck)】接口判断是否可退保申请 若可申请退保 请使用【退保申请(IIROrderSave)】接口申请退保</color> |
| |
| ==== 6.1.1请求参数 ==== | ==== 6.1.1请求参数 ==== |
| |
| |
| ^参数 ^类型 ^说明 ^必填 ^备注^ | ^ 参数 ^ 类型 ^ 说明 ^ 必填 ^ 备注 ^ |
| |TOOrderID |String |订单号 |Y |待退票的TO单单号 | | | TOOrderID | String | 订单号 | Y | 待退票的TO/TC单单号 | |
| |PassengerList |Array |乘客组 |Y | | | | serialNumber | String | 退票报价key | N | <color #ed1c24>如退票报价成功并传入时 则TROperation可传0/1(不必传3再进行退票询价) </color> | |
| |FlightList |Array |航段组 |Y | | | | PassengerList | Array | 乘客组 | Y | | |
| |QDOrderID |String |第三方退票单号 |Y | | | | FlightList | Array | 航段组 | Y | | |
| |TRReason |Int |退票原因 |Y |0：【自愿退票】：客人自愿退_按客规收取手续费 \\ 1：【其它退票情况】:其它退票情况 \\ 3:【非自愿退票】：航班延误、取消，申请全退 \\ 4:【非自愿退票】：客人因病无法乘机，申请全退 \\ 5：【非自愿退票】：原编码退票重出 \\ 6：【非自愿退票】：姓名错误重购全退 \\ 7：【非自愿退票】：重复出票申请全退 \\ 8：【非自愿退票】：客人死亡申请全退 \\ 9：【非自愿退票】：系统问题申请全退_用于代码共享航班航司未接收到票号产生的非自愿| | | QDOrderID | String | 第三方退票单号 | Y | | |
| |TROperation |Int |退票操作 |Y |0:委托美亚取消编码座位 \\ 1:我已取消编码座位 \\ 3:退票询价_暂不取消编码 | | | TRReason | Int | 退票原因 若传了 serialNumber时，则按报价请求时取值，忽略该赋值 | Y | 0. 自愿退票\\ 1. 非自愿退票：其他（请备注具体原因）\\ 3. 非自愿退票：航班延误取消\\ 4. 非自愿退票：因病/身故无法乘机 | |
| |TRReasonContent |String|退票原因（备注）|Y/N |TRReason=1时，必填写此备注 | | | TROperation | Int | 退票操作 | Y | 0:直接退票_委托美亚取消编码座位(提交后PNR将被取消且不可恢复) \\ 1:直接退票_已自行取消编码_请粘贴取消编码的RT文本 \\ 3:退票询价_暂不取消编码 \\ <color #ed1c24>注：原单为TC或TO为非美亚编码的订单不可选择0 \\ 选择0和1，美亚客服会直接按照客规操作退票，不再与您确认；如为先询价，再确认，请选择3，退票询价</color> | |
| |contact |Object|联系信息 |N |订单联系信息，若不传则默认取原单 | | | TRReasonContent | String | 退票原因（备注） | Y/N | TRReason=1时，必填写此备注 | |
| | | PNRText | String | 编码取消记录（黑屏RT记录） | Y/N | TROperation=1时 需填写 | |
| | | contact | Object | 联系信息 | N | 订单联系信息，若不传则默认取原单 | |
| | | <color #ed1c24>attachmentList</color> | Array | 附件信息 | N | 2024-08新增 9.5 附件上传(IFileUpload)的requestkey | |
| |
| |
| |
| PassengerList： | PassengerList： |
| ^参数 ^类型 ^说明 ^必填 ^备注^ | ^ 参数 ^ 类型 ^ 说明 ^ 必填 ^ 备注 ^ |
| |TOPassengerID |Int |订单乘客编号 |Y |欲退票的乘客对应的原TO单乘客编号，可从ITOOrderDetailQuery接口查询获取（passengerList列表中的passengerID） | | | TOPassengerID | Int | 订单乘客编号 | Y | 欲退票的乘客对应的原TO单乘客编号，可从ITOOrderDetailQuery/ITCOrderDetailQuery接口查询获取（passengerList/TCPassengerList列表中的passengerID） | |
| |
| |
| FlightList： | FlightList： |
| ^参数 ^类型 ^说明 ^必填 ^备注^ | ^ 参数 ^ 类型 ^ 说明 ^ 必填 ^ 备注 ^ |
| |TOFlightID |Int |航段编号 |Y |欲退票的航段对应的原TO单的航段编号，可从ITOOrderDetailQuery接口查询获取（flightList列表中的flightID） | | | TOFlightID | Int | 航段编号 | Y | 欲退票的航段对应的原TO单的航段编号，可从ITOOrderDetailQuery/ITCOrderDetailQuery接口查询获取（flightList/TCFlightList列表中的flightID） | |
| |
| contact： | contact： |
| ^参数 ^类型 ^说明 ^必填 ^备注^ | ^参数 ^类型 ^说明 ^必填 ^备注^ |
| |linker |String |联系人 |Y | | | |linker |String |联系人 |Y | | |
| |phone |String |联系人手机 |Y | | | |phone |String |联系人手机 |Y | | |
| |email |String |邮箱 |N | | | |email |String |邮箱 |N | | |
| |content |String |备注 |N | | | |content |String |备注 |N | | |
| |isEmail |Boolean |退票邮件通知 |N |默认为“false”；若“true”则退票成功发送邮件至上面参数邮箱 | | |isEmail |Boolean |退票邮件通知 |N |默认为“false”；若“true”则退票成功发送邮件至上面参数邮箱 | |
| |isSMS |Boolean |退票短信通知 |N |默认为“false”；若“true”则退票成功发送短信至上面参数联系人手机 | | |isSMS |Boolean |退票短信通知 |N |默认为“false”；若“true”则退票成功发送短信至上面参数联系人手机 | |
| |
| |
| ==== 6.1.3返回参数 ==== | ==== 6.1.3返回参数 ==== |
| |
| ^参数 ^类型 ^说明 ^备注^ | ^参数 ^类型 ^说明 ^备注^ |
| |code |String |是否调用接口成功 |20000表示成功，非20000表异常 | | |code |String |是否调用接口成功 |20000表示成功，非20000表异常 | |
| |detail |Object |结果集 | | | |detail |Object |结果集 | | |
| |description |String |描述 |当异常时记录异常信息 | | |description |String |描述 |当异常时记录异常信息 | |
| |
| detail: | detail: |
| |
| ^参数 ^类型 ^说明 ^备注^ | ^参数 ^类型 ^说明 ^备注^ |
| |TROrderID |String |退票单编号 |下单时回传给接口 | | |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返回样例 ==== | ==== 6.1.4返回样例 ==== |
| <code> | <code> |
| { | { |
| "code": "20000", | "code": "20000", |
| "detail": { | "detail": { |
| "TROrder":"TR16021500377" | "TROrder":"TR16021500377", |
| } | "status": "2", |
| | "TRFinanceList": [] |
| | } |
| } | } |
| </code> | </code> |
