美亚航旅机票B2B接口

用户工具

站点工具

3.9_订单详情_itoorderdetailquery

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版 		前一修订版
3.9_订单详情_itoorderdetailquery [2021/11/24 03:06]
tiny 		3.9_订单详情_itoorderdetailquery [2025/03/25 08:09] (当前版本)
tiny [表]
行 4: 行 4:
  
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^参数         ^类型   ^说明          ^必填         ^备注^ 
-|TOOrderID  |String |订单号   |Y | | +|TOOrderID  |String |订单号    |Y/N    |TOOrderID、QDOrderID 2个参数必传1个  传了TOOrderID时 则只根据TOOrderID查询|  
 +|QDOrderID  |String |第三方订单号     |N  |<color #ed1c24>20231018新增</color>| 
  
    
行 19: 行 20:
 ==== 3.9.3返回参数 ==== ==== 3.9.3返回参数 ====
  
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|code |String |是否调用接口成功 |20000表示成功，非20000表异常 | +|code   |String |是否调用接口成功   |20000表示成功，非20000表异常 | 
-|detail |Object |结果集  |  | +|detail |Object |结果集     |  | 
-|description |String |描述 |当异常时记录异常信息 |+|description |String    |描述 |当异常时记录异常信息 |
  
 detail: detail:
  
-^参数     ^类型 ^说明    ^备注^ +^ 参数                                     ^ 类型      ^ 说明       ^ 备注                  ^ 
-|orderInfo|Object |订单信息 |  | +| orderInfo                              | Object  | 订单信息     |                     | 
-|flightList|Array |航段组 |  | +| flightList                             | Array   | 航段组      |                     | 
-|passengerList|Array |乘客组|  | +| passengerList                          | Array   | 乘客组      |                     | 
-|<color #ed1c24>ioSaleTotalList</color> |Array |保险财务信息组 | 支付时 IO保险单随TO单一起支付  | +| financeDetail                          | Object  | 机票财务信息组  |                     | 
-|financeDetail|Object |财务信息组 |  | +| ioSaleTotalList                        | Array   | 保险财务信息组  | 支付时 IO保险单随TO单一起支付   | 
-|contact|Object |联系信息 |  | +| contact                                | Object  | 联系信息     |                     | 
-|<color #ed1c24>OOOrderInfo</color> |Array |辅营产品 | 支付时 TO单一起支付  | +| OOOrderInfo                            | Array   | 辅营产品     | 如果不存在辅营产品订单，则为null  | 
 +| <color #ed1c24>attachmentList</color>  | Array   | 附件信息     | 2024-08新增           |  
 +| <color #ed1c24>RCVServiceFee</color>| Object| 退改废服务费   <color #ed1c24>20241017新增</color>|                       |
 orderInfo: orderInfo:
  
-^参数     ^类型 ^说明    ^备注^ +^ 参数                                                  ^ 类型       ^ 说明                               ^ 备注                                                                                            ^ 
-|orderID|String |单编号 |  | +| orderID                                             | String   | 单编号                              |                                                                                               | 
-|orderStatus|Int |单状态 | 0：已取消 \\ 2、3：处理中 \\ 4：待支付 \\ 7：待确认价格（需确认支付） \\ 5：待出票 \\ 6：已出票  \\ 8：已支付 \\ 10:申请（异常状态，需人工跟进） | +| status                                              | Int      | 单状态                              | 0：已取消 \\ 2、3：处理中 \\ 4：待支付 \\ 7：待确认价格（需确认支付） \\ 5：待出票 \\ 6：已出票  \\ 8：已支付 \\ 10:申请（异常状态，需人工跟进）  | 
-|pnr|String|PNR |  |  +| pnr                                                 | String   | PNR                              |                                                                                               | 
-|airlinepnr|String|航司大PNR|  |  +| airlinepnr                                          | String   | 航司大PNR                           |                                                                                               | 
-|productSubType|Int  |机票类型| 0：国内 \\ 1：国际|+| productSubType                                      | Int      | 机票类型                             | 0：国内 \\ 1：国际                                                                                  | 
 +| <color #ed1c24>groupTag</color>                     | Bool     | true代表该运价为小团价产品  若退改废必须全部旅客一起申请  | <color #ed1c24>20230921新增</color>                                                             | 
 +| <color #ed1c24>canBeVoid</color>                    | Boolean  | 是否可作废(true-可作废,false-不可作废)       |                                                                                               | 
 +| <color #ed1c24>latestVoidTicketingDeadline</color>  | String   | 最晚作废时间格式 yyyy-MM-ddTHH:mm:ss     |                                                                                               | 
  
 flightList: flightList:
  
-^参数     ^类型 ^说明    ^备注^ +^ 参数                            ^ 类型      ^ 说明      ^ 备注                                  ^ 
-|flightID|Int |航段编号 |  | +| flightID                      | Int     | 航段编号    |                                     | 
-|departTime|String |出发时间 |  | +| departTime                    | String  | 出发时间    |                                     | 
-|destTime|String |到达时间 |  | +| destTime                      | String  | 到达时间    |                                     | 
-|airline|String         |航司码 |  | +| airline                       | String  | 航司码     |                                     | 
-|flightNo|String |航班号|  | +| flightNo                      | String  | 航班号     |                                     | 
-|classNo|String   |舱位 |  | +| classNo                       | String  | 舱位      |                                     | 
-|depAir|String   |出发机场编号 |  | +| depAir                        | String  | 出发机场编号  |                                     | 
-|depAirCN|String   |出发机场名 |  | +| depAirCN                      | String  | 出发机场名   |                                     | 
-|desAir|String   |到达机场编号 |  | +| desAir                        | String  | 到达机场编号  |                                     | 
-|desAirCN|String   |到达机场名 |  | +| desAirCN                      | String  | 到达机场名   |                                     | 
-|<color #ed1c24>depTerm</color>|String   |出发航站楼 |  | +| depTerm                       | String  | 出发航站楼   |                                     | 
-|<color #ed1c24>desTerm</color>|String   |到达航站楼 |  |+| desTerm                       | String  | 到达航站楼   |                                     | 
 +| <color #ed1c24>class</color>  | String  | 舱等      | F:头等舱 \\ C:商务舱 \\ Y:经济舱 \\ W:豪华经济舱  |
  
 passengerList: passengerList:
  
-^参数     ^类型 ^说明    ^备注^ +^ 参数                                    ^ 类型      ^ 说明       ^ 备注                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
-|passengerID|Int |乘客编号 |  | +| passengerID                           | Int     | 乘客编号     |                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
-|name|String|乘客姓名 |  | +| name                                  | String  | 乘客姓名     |                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
-|passengerType|Int|乘客类型| 0：成人 \\ 1：儿童 \\ 2：婴儿 \\ 3：老人 \\ 4：学生 \\ 5：劳务 \\ 6：移民 \\ 7：海员 \\ 8：青年 | +| passengerType                         | Int     | 乘客类型     | 0：成人 \\ 1：儿童 \\ 2：婴儿 \\ 3：老人 \\ 4：学生 \\ 5：劳务 \\ 6：移民 \\ 7：海员 \\ 8：青年  |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
-|nationality|String|国籍代码 |  | +| nationality                           | String  | 国籍代码     |                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
-|IDType|Int|证件类型 | 0护照 \\ 1其他有效证件 | +| 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 |证件号码|  | +| IDNumber                              | String  | 证件号码     |                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
-|IDExpiration|String |证件有效期|  | +| IDExpiration                          | String  | 证件有效期    |                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
-|gender|Int|性别| 1：男 \\ 0：女 | +| gender                                | Int     | 性别       | 1：男 \\ 0：女                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
-|birthday|String |出生日期|  | +| birthday                              | String  | 出生日期     |                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
-|PNR|String |PNR  | | +| PNR                                   | String  | PNR      |                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
-|ticketNo|String |票号  | | +| ticketNo                              | String  | 票号       |                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
-|status|Int|退改废状态  |0：正常 \\ 1：改 \\ 2：退 \\ 3：废 | +| <color #ed1c24>issueDate</color>      | String  | 出票时间     |                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
-| <color #ed1c24>IOOrderIDList</color>  | Array   | 保险信息   | |+| <color #ed1c24>issueOutDate</color>   | String  | 票号有效期    | 出票时间1年内                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
 +| status                                | Int     | 退改废状态    | 0：正常 \\ 1：改 \\ 2：退 \\ 3：废                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
 +| <color #ed1c24>IDNationality</color>  | String  | 证件签发地代码  |                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
 +| <color #ed1c24>EName</color>          | String  | 旅客英文名    |                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
 + 
 +| IOOrderIDList  | Array   | 保险信息   | | 
  
 IOOrderIDList: IOOrderIDList:
  
-^参数     ^类型 ^说明    ^备注^+^参数     ^类型 ^说明    ^备注^
 |IOOrderID|String | 保险单号 | | |IOOrderID|String | 保险单号 | |
 |recognizee|String | 投保乘客 | | |recognizee|String | 投保乘客 | |
行 89: 行 102:
 |effectDateStr|String | 生效时间 | | |effectDateStr|String | 生效时间 | |
 |expiryDateStr|String | 失效时间 | | |expiryDateStr|String | 失效时间 | |
 +
  
 financeDetail: financeDetail:
  
-^参数     ^类型 ^说明    ^备注^+^参数     ^类型 ^说明    ^备注^ 
 +|<color #ed1c24>ticketType</color>|String | 票证类型  |10:美亚BSP 30:外购票证 40:非美亚BSP 50:官网 60:航司B2B 70:航司B2T 80:BSP国际EMD  \\ 202401 新增  |
 |officeNumber|String | Office  | | |officeNumber|String | Office  | |
 |agencyPolicyRemark|String | 代理费政策限制| | |agencyPolicyRemark|String | 代理费政策限制| |
行 99: 行 114:
  
 financeList financeList
-^参数     ^类型 ^说明    ^备注^ +^参数     ^类型 ^说明    ^备注^ 
-|passengerType|Int |乘客类型 | 0：成人 \\ 1：儿童 \\ 2：婴儿 \\ 3：老人 \\ 4：学生 \\ 5：劳务 \\ 6：移民 \\ 7：海员 \\ 8：青年 | +|passengerType|Int  |乘客类型 | 0：成人 \\ 1：儿童 \\ 2：婴儿 \\ 3：老人 \\ 4：学生 \\ 5：劳务 \\ 6：移民 \\ 7：海员 \\ 8：青年 | 
-|salePrice| Decimal |票面价 |  | +|salePrice| Decimal |票面价 |  | 
-|tax|Decimal |tax |  | +|tax|Decimal    |tax |  | 
-|beforeReturn|Decimal |代理费点数 |  | +|beforeReturn|Decimal   |代理费点数 |  | 
-|beforeReturnPrice|Decimal |代理费金额 |  | +|beforeReturnPrice|Decimal  |代理费金额 |  | 
-|afterReturnBase|Decimal |奖励基数 |  | +|afterReturnBase|Decimal    |奖励基数 |  | 
-|afterReturn|Decimal |奖励点数 |  | +|afterReturn|Decimal    |奖励点数 |  | 
-|afterReturnPrice|Decimal |奖励金额 |  | +|afterReturnPrice|Decimal   |奖励金额 |  | 
-|serviceFee|Decimal |服务费 |  |  +|serviceFee|Decimal |服务费 |  |  
-|saleTotal|Decimal |结算价 |  | +|saleTotal|Decimal  |结算价 |  | 
  
 ioSaleTotalList ioSaleTotalList
行 119: 行 134:
 | unPayTotal   | Decimal  | 未付金额    |           | | unPayTotal   | Decimal  | 未付金额    |           |
 | saleTotal    | Decimal  | 总价      |           | | saleTotal    | Decimal  | 总价      |           |
 +
  
 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”则出票成功发送短信至上面参数联系人手机                                       | 
-|<color #ed1c24>isEmail_VoyageChange</color>|Boolean  |航变邮件通知  |N |默认为“false”；若“true”则发生航变发送邮件至上面参数邮箱 | +| <color #ed1c24>isEmail_VoyageChange</color>  | Boolean  | 航变邮件通知  | N   | 默认为“false”；若“true”则发生航变发送邮件至上面参数邮箱；航变信息只通知订票人，收到航变通知请及时通知乘机人，以免造成损失及投诉；     | 
-|<color #ed1c24>isSMS_VoyageChange</color>  |Boolean  |航变短信通知  |N |默认为“false”；若“true”则发生航变发送短信至上面参数联系人手机 |+| <color #ed1c24>isSMS_VoyageChange</color>    | Boolean  | 航变短信通知  | N   | 默认为“false”；若“true”则发生航变发送短信至上面参数联系人手机；航变信息只通知订票人，收到航变通知请及时通知乘机人，以免造成损失及投诉；  |
  
 OOOrderInfo： OOOrderInfo：
-^参数         ^类型     ^说明         ^必填 ^备注^ +^参数         ^类型     ^说明         ^必填 ^备注^ 
-|orderID         |String   |辅营产品订单编号 |Y | | +|orderID            |String   |辅营产品订单编号 |Y  | | 
-|orderStatus         |String   |订单状态 |Y |处理中 \\ 待支付 \\ 已处理 \\ 已取消| +|orderStatus            |String   |订单状态 |Y  |处理中 \\ 待支付 \\ 已处理 \\ 已取消| 
-|saleTotal         |Decimal   |订单结算价 |Y | | +|saleTotal          |Decimal   |订单结算价   |Y  | | 
-|NDCProducts         |Array   |产品详情 |Y | | +|NDCProducts            |Array   |产品详情  |Y  | |
 NDCProducts： NDCProducts：
-^参数         ^类型     ^说明         ^必填 ^备注^ +^参数         ^类型     ^说明         ^必填 ^备注^ 
-|psgId         |int   |关联乘客编号 |N | 购买NDC产品的乘客，如果是整单购买的，则不指定特定乘客| +|psgId          |int   |关联乘客编号  |N  | 购买NDC产品的乘客，如果是整单购买的，则不指定特定乘客| 
-|psgType        |string   |关联乘客类型 |N |购买NDC产品的乘客类型，如果是整单购买的，则不指定特定乘客 | +|psgType        |string   |关联乘客类型   |N  |购买NDC产品的乘客类型，如果是整单购买的，则不指定特定乘客 | 
-|psgName        |string   |关联乘客姓名 |N |购买NDC产品的乘客姓名，如果是整单购买的，则不指定特定乘客 | +|psgName        |string   |关联乘客姓名   |N  |购买NDC产品的乘客姓名，如果是整单购买的，则不指定特定乘客 | 
-|tripNumber     |int   |行程类型  |Y |0：全程，1：去程 2：回程 | +|tripNumber     |int   |行程类型    |Y  |0：全程，1：去程 2：回程 | 
-|name     |string   |NDC产品  |N |1：去程 2：回程 | +|name     |string   |NDC产品  |N  |1：去程 2：回程 | 
-|text     |string   |NDC产品描述  |N | 描述 | +|text     |string   |NDC产品描述    |N  | 描述 | 
-|salePrice     |string   |销售价  |N |   | +|salePrice     |string   |销售价   |N  |   | 
-|currency     |string   |销售价货币类型  |N |   | +|currency     |string   |销售价货币类型    |N  |   | 
-|weight    |string   |规格  |N | tf类型辅营产品有值 | +|weight    |string   |规格    |N  | tf类型辅营产品有值 | 
-|quantity    |string   |行李额  |N | tf类型辅营产品有值 | +|quantity    |string   |行李额     |N  | tf类型辅营产品有值 | 
-|proType    |string   |辅营产品类型  |N | tf，agg| +|proType    |string   |辅营产品类型   |N  | tf，agg| 
-|orgcity    |string   |出发城市  |N |  | +|orgcity    |string   |出发城市     |N  |  | 
-|descity    |string   |到达城市  |N |  |+|descity    |string   |到达城市     |N  |  | 
  
 +attachmentList：
 +^参数         ^类型     ^说明         ^必填 ^备注^
 +|id          |string   |附件id  |N  | |
 +|name          |string   |附件名称  |N  | |
 +|path          |string   |附件地址  |N  | |
 +RCVServiceFee
 +^参数         ^类型     ^说明         ^必填 ^备注^
 +|RefundFeeCNY|float|退票加收服务费  |N  |无数据则以退票时为准 |
 +|ChangeFeeCNY|float|改签收服务费  |N  |无数据则以退票时为准 |
 +|VoidFeeCNY|float|废票加收服务费  |N  |无数据则以退票时为准 |
  
  
3.9_订单详情_itoorderdetailquery.1637723217.txt.gz · 最后更改: 2021/11/24 03:06 由 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