美亚航旅机票B2B接口

用户工具

站点工具

6.1_退票申请_iticketrulequeryv2

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版 		前一修订版
6.1_退票申请_iticketrulequeryv2 [2021/03/03 10:10]
tiny 		6.1_退票申请_iticketrulequeryv2 [2024/08/08 07:03] (当前版本)
tiny [表]
行 1: 行 1:
 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单单号                                                                                                                                                                                 | 
-|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:委托美亚取消编码座位 \\ 1:我已取消编码座位 \\ 3:退票询价_暂不取消编码 | +| 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                                                                                                                                                   |
  
  
  
 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”则退票成功发送短信至上面参数联系人手机 |
  
  
行 68: 行 71:
 ==== 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返回样例 ====
行 82: 行 99:
 <code> <code>
 { {
-"code": "20000", +    "code": "20000", 
-"detail": { +    "detail": { 
-    "TROrder":"TR16021500377" +        "TROrder":"TR16021500377", 
- }+        "status": "2", 
 +        "TRFinanceList": [] 
 +    }
 } }
 </code> </code>
6.1_退票申请_iticketrulequeryv2.1614766220.txt.gz · 最后更改: 2021/03/03 10:10 由 tiny

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki