美亚航旅机票B2B接口

用户工具

站点工具

7.2_废票单详情_itvorderdetailquery

差别

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

到此差别页面的链接

后一修订版 		前一修订版
7.2_废票单详情_itvorderdetailquery [2021/01/28 09:03]
louis 创建 		7.2_废票单详情_itvorderdetailquery [2024/08/08 07:05] (当前版本)
tiny
行 4: 行 4:
  
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^参数         ^类型   ^说明          ^必填         ^备注^ 
-|TVOrderID      |String |作废订单号   |Y | | +|TVOrderID      |String |作废订单号      |Y/N    | TVOrderID、QDOrderID 2个参数必传1个  传了TVOrderID时 则只根据TVOrderID查询|  
 +|QDOrderID     |String  |第三方订单号   |N    |<color #ed1c24>20231018新增</color>| 
  
    
 ==== 7.2.2请求样例 ==== ==== 7.2.2请求样例 ====
 +
 +<code>
 +{
 +"TVOrderID":"TV16011800608"
 +}
 +
 +</code>
 +
 +==== 7.2.3返回参数 ====
 +
 +^参数 ^类型 ^说明 ^备注^
 +|code   |String |是否调用接口成功   |20000表示成功，非20000表异常 |
 +|detail |Object |结果集     |  |
 +|description |String    |描述 |当异常时记录异常信息 |
 +
 +detail:
 +
 +^ 参数                                     ^ 类型      ^ 说明        ^ 备注         ^
 +| TVOrderInfo                            | Object  | 作废单信息     |            |
 +| TVFlightList                           | Array   | 作废单航段组    |            |
 +| TVPassengerList                        | Array   | 作废单乘客组    |            |
 +| TVFinanceList                          | Array   | 作废单财务信息组  |            |
 +| contact                                | Object  | 联系信息      |            |
 +| IROrderList                            | Array   | 退保单信息     |            |
 +| <color #ed1c24>AttachmentList</color>  | Array   | 附件信息      | 2024-08新增  |
 +
 +TVOrderInfo:
 +
 +^参数     ^类型 ^说明    ^备注^
 +|TOOrderID|String       |原机票订单单号(TO单单号) |  |
 +|TVOrderID|String   |作废单编号 |  |
 +|orderStatus|Int    |作废单状态 | 0: 已取消 \\ 1: 待提交 \\ 2: 待审核 \\ 3: 待审核 \\ 4: 待废票 \\ 5: 已废票 \\ 6: 审核退回 |
 +|createDate|DateTime    |作废单下单时间 |  | 
 +
 +
 +TVFlightList:
 +
 +^ 参数                            ^ 类型      ^ 说明      ^ 备注                                  ^
 +| departTime                    | String  | 出发时间    |                                     |
 +| destTime                      | String  | 到达时间    |                                     |
 +| airline                       | String  | 航司码     |                                     |
 +| flightNo                      | String  | 航班号     |                                     |
 +| classNo                       | String  | 舱位      |                                     |
 +| depAir                        | String  | 出发机场编号  |                                     |
 +| depAirCN                      | String  | 出发机场名   |                                     |
 +| desAir                        | String  | 到达机场编号  |                                     |
 +| desAirCN                      | String  | 到达机场名   |                                     |
 +| <color #ed1c24>class</color>  | String  | 舱等      | F:头等舱 \\ C:商务舱 \\ Y:经济舱 \\ W:豪华经济舱  |
 +
 +TVPassengerList:
 +
 +^参数     ^类型 ^说明    ^备注^
 +|name|String|乘客姓名 |  |
 +|passengerType|Int|乘客类型| 0：成人 \\ 1：儿童 \\ 2：婴儿 \\ 3：老人 \\ 4：学生 \\ 5：劳务 \\ 6：移民 \\ 7：海员 \\ 8：青年 |
 +|nationality|String|国籍代码 |  |
 +|IDType|Int |证件类型|Y | 0：护照 \\ <del><color #ed1c24> 1：其他有效证件（注：含军人证、回乡证、台胞证、户口簿、出生证明、学生证、外国人永久居留证、民航局规定的其他有效乘机身份证件 长度不超过15位）</color></del> \\  <color #ed1c24>身份证:2</color> \\ 港澳通行证:3 \\  回乡证:4 \\ 户口簿:5 \\ 出生证明:6 \\ 台湾通行证:7 \\ 台胞证:8 \\ 军人证:9 \\ <color #ed1c24>港澳台居民居住证 : 10</color> \\ 外国人永久居留身份证:11 \\ <color #ed1c24>其他有效证件 : 12</color> \\ <color #ed1c24>电子护照:13</color> \\  <color #ed1c24>海员证:14</color> \\ <color #7092be>旧单按原含义展示</color>|
 +|IDNumber|String |证件号码|  |
 +|IDExpiration|String |证件有效期|  |
 +|IDNationality|String|证件签发国二字码|  |
 +|gender|Int|性别| 1：男 \\ 0：女 |
 +|birthday|String |出生日期|  |
 +|PNR|String |PNR  |
 +|ticketNo|String |票号  |
 +
 +TVFinanceList:
 +
 +^参数     ^类型 ^说明    ^备注^
 +|passengerType|Int  |乘客类型 | 0：成人 \\ 1：儿童 \\ 2：婴儿 \\ 3：老人 \\ 4：学生 \\ 5：劳务 \\ 6：移民 \\ 7：海员 \\ 8：青年 |
 +|toPrice| Decimal   |原单退款金额 |  |
 +|voidedFee|Decimal  |作废手续费 |  |
 +|saleTotal|Decimal  |合计 |  | 
 +
 +contact：
 +^参数         ^类型     ^说明         ^必填 ^备注^
 +|linker         |String   |联系人  |Y  | |
 +|phone          |String   |联系人手机    |Y  | |
 +|email          |String   |邮箱   |N  | |
 +|content        |String   |备注   |N  | |
 +|isEmail        |Boolean  |废票邮件通知   |N  |默认为“false”；若“true”则废票成功发送邮件至上面参数邮箱 |
 +|isSMS          |Boolean  |废票短信通知   |N  |默认为“false”；若“true”则废票成功发送短信至上面参数联系人手机 |
 +
 +IROrderList：
 +^ 参数           ^ 类型      ^ 说明      ^ 备注         ^
 +| IROrderID    | String  | 退保单号    |            |
 +| productName  | String  | 保险产品名称  |            |
 +| status       | String  | 退保状态    | 参考IR退保单详情  |
 +
 +AttachmentList：
 +^参数         ^类型     ^说明         ^必填 ^备注^
 +|id          |string   |附件id  |N  | |
 +|name          |string   |附件名称  |N  | |
 +|path          |string   |附件地址  |N  | |
 +
 +
 +==== 7.1.4返回样例 ====
  
 <code> <code>
行 121: 行 217:
         ]         ]
     }     }
-} 
- 
-</code> 
- 
-==== 7.2.3返回参数 ==== 
- 
-^参数 ^类型 ^说明 ^备注^ 
-|code |String |是否调用接口成功 |20000表示成功，非20000表异常 | 
-|detail |Object |结果集 |  | 
-|description |String |描述 |当异常时记录异常信息 | 
- 
-detail: 
- 
-^参数     ^类型 ^说明    ^备注^ 
-|TVOrderInfo|Object |作废单信息 |  | 
-|TVFlightList|Object |作废单航段组 |  | 
-|TVPassengerList|Object |作废单乘客组 |  | 
-|TVFinanceList|Object |作废单财务信息组 |  | 
-|contact|Object |联系信息 |  | 
- 
-TVOrderInfo: 
- 
-^参数     ^类型 ^说明    ^备注^ 
-|TVOrderInfo|Object |作废单信息 |  | 
-|TVFlightList|Object |作废单航段组 |  | 
-|TVPassengerList|Object |作废单乘客组 |  | 
-|TVFinanceList|Object |作废单财务信息组 |  | 
-|contact|Object |联系信息 |  | 
- 
- 
-TVFlightList: 
- 
-^参数     ^类型 ^说明    ^备注^ 
-|TVOrderInfo|Object |作废单信息 |  | 
-|TVFlightList|Object |作废单航段组 |  | 
-|TVPassengerList|Object |作废单乘客组 |  | 
-|TVFinanceList|Object |作废单财务信息组 |  | 
-|contact|Object |联系信息 |  | 
- 
-TVPassengerList: 
- 
-^参数     ^类型 ^说明    ^备注^ 
-|TVOrderInfo|Object |作废单信息 |  | 
-|TVFlightList|Object |作废单航段组 |  | 
-|TVPassengerList|Object |作废单乘客组 |  | 
-|TVFinanceList|Object |作废单财务信息组 |  | 
-|contact|Object |联系信息 |  | 
- 
-TVFinanceList: 
- 
-^参数     ^类型 ^说明    ^备注^ 
-|TVOrderInfo|Object |作废单信息 |  | 
-|TVFlightList|Object |作废单航段组 |  | 
-|TVPassengerList|Object |作废单乘客组 |  | 
-|TVFinanceList|Object |作废单财务信息组 |  | 
-|contact|Object |联系信息 |  | 
- 
-contact: 
- 
-^参数     ^类型 ^说明    ^备注^ 
-|TVOrderInfo|Object |作废单信息 |  | 
-|TVFlightList|Object |作废单航段组 |  | 
-|TVPassengerList|Object |作废单乘客组 |  | 
-|TVFinanceList|Object |作废单财务信息组 |  | 
-|contact|Object |联系信息 |  | 
- 
-==== 7.1.4返回样例 ==== 
- 
-<code> 
-{ 
-    "code": "20000", 
-    "detail": { 
-              "TVOrderID": "TV16020500617" 
-          } 
 } }
 </code> </code>
7.2_废票单详情_itvorderdetailquery.1611824615.txt.gz · 最后更改: 2021/01/28 09:03 由 louis

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： 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