两侧同时换到之前的修订记录
前一修订版
后一修订版
|
前一修订版
|
6.1_退票申请_iticketrulequeryv2 [2021/08/07 06:09] tiny |
6.1_退票申请_iticketrulequeryv2 [2024/08/08 07:03] (当前版本) tiny [表] |
| |
| |
^ 参数 ^ 类型 ^ 说明 ^ 必填 ^ 备注 ^ | ^ 参数 ^ 类型 ^ 说明 ^ 必填 ^ 备注 ^ |
| TOOrderID | String | 订单号 | Y | 待退票的TO/TC单单号 | | | TOOrderID | String | 订单号 | Y | 待退票的TO/TC单单号 | |
| serialNumber | String | 退票报价key | N | | | | serialNumber | String | 退票报价key | N | <color #ed1c24>如退票报价成功并传入时 则TROperation可传0/1(不必传3再进行退票询价) </color> | |
| PassengerList | Array | 乘客组 | Y | | | | PassengerList | Array | 乘客组 | Y | | |
| FlightList | Array | 航段组 | Y | | | | FlightList | Array | 航段组 | Y | | |
| QDOrderID | String | 第三方退票单号 | Y | | | | QDOrderID | String | 第三方退票单号 | Y | | |
| TRReason | Int | 退票原因 若传了 serialNumber时,则按报价请求时取值,忽略该赋值 | Y | 0:【自愿退票】:客人自愿退_按客规收取手续费 \\ 1:【其它退票情况】:其它退票情况 \\ 3:【非自愿退票】:航班延误、取消,申请全退 \\ 4:【非自愿退票】:客人因病无法乘机,申请全退 \\ 5:【非自愿退票】:原编码退票重出 \\ 6:【非自愿退票】:姓名错误重购全退 \\ 7:【非自愿退票】:重复出票申请全退 \\ 8:【非自愿退票】:客人死亡申请全退 \\ 9:【非自愿退票】:系统问题申请全退_用于代码共享航班航司未接收到票号产生的非自愿 | | | TRReason | Int | 退票原因 若传了 serialNumber时,则按报价请求时取值,忽略该赋值 | Y | 0. 自愿退票\\ 1. 非自愿退票:其他(请备注具体原因)\\ 3. 非自愿退票:航班延误取消\\ 4. 非自愿退票:因病/身故无法乘机 | |
| TROperation | Int | 退票操作 | Y | 0:直接退票_委托美亚取消编码座位(提交后PNR将被取消且不可恢复) \\ 1:直接退票_已自行取消编码_请粘贴取消编码的RT文本 \\ 3:退票询价_暂不取消编码 \\ <color #ed1c24>注:原单为TC或TO为非美亚编码的订单不可选择0 \\ 选择0和1,美亚客服会直接按照客规操作退票,不再与您确认;如为先询价,再确认,请选择3,退票询价</color> | | | TROperation | Int | 退票操作 | Y | 0:直接退票_委托美亚取消编码座位(提交后PNR将被取消且不可恢复) \\ 1:直接退票_已自行取消编码_请粘贴取消编码的RT文本 \\ 3:退票询价_暂不取消编码 \\ <color #ed1c24>注:原单为TC或TO为非美亚编码的订单不可选择0 \\ 选择0和1,美亚客服会直接按照客规操作退票,不再与您确认;如为先询价,再确认,请选择3,退票询价</color> | |
| TRReasonContent | String | 退票原因(备注) | Y/N | TRReason=1时,必填写此备注 | | | TRReasonContent | String | 退票原因(备注) | Y/N | TRReason=1时,必填写此备注 | |
| PNRText | String | 编码取消记录(黑屏RT记录) | Y/N | TROperation=1时 需填写 | | | PNRText | String | 编码取消记录(黑屏RT记录) | Y/N | TROperation=1时 需填写 | |
| contact | Object | 联系信息 | N | 订单联系信息,若不传则默认取原单 | | | contact | Object | 联系信息 | N | 订单联系信息,若不传则默认取原单 | |
| | <color #ed1c24>attachmentList</color> | Array | 附件信息 | N | 2024-08新增 9.5 附件上传(IFileUpload)的requestkey | |
| |
| |
| |
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:待审核,则需等待人工报价| | |status |String |订单状态 | 参考退票单详情 \\ 若为7:待价格确认,则系统自动报价,确认支付即可进行退票; \\ 若为2、3、6:待审核,则需等待人工报价| |
|TRFinanceList |Array |退票单财务信息组 | | | |TRFinanceList |Array |退票单财务信息组 | | |
| |
TRFinanceList: | TRFinanceList: |
| |
^参数 ^类型 ^说明 ^备注^ | ^参数 ^类型 ^说明 ^备注^ |
|passengerType|Int |乘客类型 | 0:成人 \\ 1:儿童 \\ 2:婴儿 \\ 3:老人 \\ 4:学生 \\ 5:劳务 \\ 6:移民 \\ 7:海员 \\ 8:青年 | | |passengerType|Int |乘客类型 | 0:成人 \\ 1:儿童 \\ 2:婴儿 \\ 3:老人 \\ 4:学生 \\ 5:劳务 \\ 6:移民 \\ 7:海员 \\ 8:青年 | |
|toPrice| Decimal |原单退款金额 | | | |toPrice| Decimal |原单退款金额 | | |
|originOrderFee|Decimal |原单手续费 | | | |originOrderFee|Decimal |原单手续费 | | |
|usePrice|Decimal |已使用航段费 | | | |usePrice|Decimal |已使用航段费 | | |
|returnFee|Decimal |退票手续费 | | | |returnFee|Decimal |退票手续费 | | |
|serviceFee|Decimal |服务费 | | | |serviceFee|Decimal |服务费 | | |
|saleTotal|Decimal |合计 | | | |saleTotal|Decimal |合计 | | |
| |
| |