国际机票


国际机票

国际机票订单详情查询

通过该接口查询国际机票订单详情。

接口URL

/iair/order/detail

请求参数定义

参数名参数说明必填参数类型长度值举例备注
version版本号YString3.0固定为3.0。
msgID唯一标识YString1000120150511190411000001企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode操作企业账号YString企业账号
tenantUserId操作人帐号YStringHW_0000011、如果是系统维护,写"sysadmin"
2、如果是普通员工维护,写员工id
orderID订单IDYStringI218154970国际机票订单号

响应参数定义

参数名参数说明必填参数类型长度值举例备注
resultCode返回码YString00表示成功
description描述YStringSuccess描述信息,出错时为错误信息即错误原因。
orderID订单号NStringI218154970
orderTime下订单时间NString20180811113019yyyyMMddHHmmss
orderStatus订单状态NString0 占位失败 1 待支付 2 待出票 3 待审核出票结果 4 已取消 5 出票失败 8 待用户确认费用 9 待更新 10 待审核 11 待审批 12 已完成 13 价格变更待退款 14 订单取消待退款 15 订单出票中 16 订单预订中 17 报价中 18 待用户选择报价0、4、12为终态
travelType出行方式NString0:因公出行1:因私出行
totalPrice订单总价NString115订单总价=票价+税费+总服务费。退票改期不更新总价。
totalServiceFee总服务费NString115服务费可能按订单、人、航段计算此数据仅供参考,以结算报表数据为准
currency币种NStringCNY
orderSource订单产品来源NStringFront:PC前台,Backend:后台,H5:H5,Welink:welink,IOS:IOS客户端,Android:安卓客户端,PNRImport:PNR导单,OpenAPI:OpenAPI开放接口,harmony:鸿蒙客户端
payWay支付方式NString1:个人在线支付 2:个人IVR支付(OP)3:现金 4:POS 6:因公欠款 7:vip欠款 8:担保欠款 10:外部月结
payStatus支付状态NString0:未支付1:已支付
interTicketList客票信息集合NList<InterTicketInfo>输出所有客票历史
interAirChangeInfoList改期单详情集合NList<InterAirChangeInfo>
interAirRefundInfoList申退单详情集合NList<InterAirRefundInfo>
enterpriseTrID企业客户系统审批单编号NStringTA0315012116281300028
htTrID华为云数字化差旅审批单编号NStringTA0315012116281300028
contactInfoList联系人信息列表YList<ContactInfo >第一个为主联系人
orderer预订人YEmployee包含TenantUserId/Name/EmployeeNum字段

联系人信息ContactInfo

参数名参数说明必填参数类型长度值举例备注
contactName联系人姓名NString张三
contactMobile联系人手机号NString13710001000
contactMail联系人邮件NStringzhangsan@huawei.com

客票信息InterTicketInfo

参数名参数说明必填参数类型长度值举例备注
ticketCode票号YString781-1231231连续票号用分号隔开已出票的才有数据,仅占位的不提供
ticketTime出票时间YString20180811113019yyyyMMddHHmmss
ticketStatus客票状态YString0:不可1:可用
refundStatus退票状态NString0:已退票1:未退票2:退票中默认为1。
changeStatus改期状态NString0:已改期1:未改期2:改期中默认为1。
ticketPrice票面价YString1000
tax税费YString100
flightInfoList航班信息集合YList<FlightInfo>
passengerInfo乘客信息YIairPassenger一张票一个乘客

航班信息FlightInfo

参数名参数说明必填参数类型长度值举例备注
journeyIndex航程YString1:第1程 2:第2程,以此类推
segmentindex航段idYString1:第1段2:第2段去程、返程均从1开始编码
airways航空公司二字码YStringCA
airwaysName航空公司名称YString中国国际航空公司
actualAirways实际承运航空公司二字码NStringY8
actualAirwaysName实际承运航空公司名称NString金鹏航空
departAirport起飞机场三字码YStringNKG
departAirportName起飞机场名称YString南京禄口国际机场
arrivalAirport到达机场三字码YStringNKG
arrivalAirportName到达机场名称YString南京禄口国际机场
departTime起飞时间YString20180811113019yyyyMMddHHMMss
departCityThreeCode出发城市三字码NString城市三字码
departCityChineseName出发城市中文名称NString上海
arriveTime到达时间YString20180811113019yyyyMMddHHMMss
arriveCityThreeCode到达城市三字码NString城市三字码
arriveCityChineseName到达城市中文名称NString上海
flight航班号YStringZC12312
actualFlight实际承运航班号NStringY87537
cabin舱位编码NStringF
cabinLevel舱位等级NString0: 头等舱 1: 商务舱 2: 经济舱 3: 高端经济舱
cabinDiscount舱位折扣NString暂不支持
departTerminal起飞航站楼NStringT1
arrivalTerminal到达航站楼NString
segmentStatus航段状态NStringO:有效未使用,V:已作废,R:已退,F:已使用
freeLuggage免费行李额NString中文文本
stopInfoList经停城市集合NList<StopInfo>
tpm里程信息NString1226单位:KM

经停信息StopInfo

参数名参数说明必填参数类型长度值举例备注
cityChineseName经停城市中文名NString北京
cityEnglishName经停城市英文名NStringBeijing
countryChineseName经停国家中文名NString中国
countryEnglishName经停国家英文名NStringChina

改期信息InterAirChangeInfo

参数名参数说明必填参数类型长度值举例备注
changeID改期单号YStringCI218154971
orderID订单号YStringI218154970
payWay支付方式NString1:个人在线支付 2:个人IVR支付(OP)3:现金 4:POS 6:因公欠款 7:vip欠款 8:担保欠款 10:外部月结
payStatus支付状态NString0:未支付1:已支付
changeStatus改期单状态YString0:草稿1:申请改期2:完成改期6:待审批7:待改期8:已取消9:待员工确认改期费11:待支付终态2、8才能提供完整改期数据,包括费用及新航班信息
changeSource改期单来源YStringFront:PC前台,Backend:后台,H5:H5,Welink:welink,IOS:IOS客户端,Android:安卓客户端,PNRImport:PNR导单,OpenAPI:OpenAPI开放接口
totalChangeFee总改期费NString100改期总费用=票价差价+税费差价+改期费
changeRemark用户备注NString员工填写
changeReason改期原因NString用户选择的预设中文改期原因
changeAppTime改期申请时间YString20180811113019yyyyMMddHHMMss
changeCompleteTime改期完成时间NString20180811113019yyyyMMddHHMMss
changeDetailList改期单详情NList<ChangeDetail>

改期单详情ChangeDetail

参数名参数说明必填参数类型长度值举例备注
passengerInfo乘客信息YIairPassenger
oldTicket原客票YChangeTicketInfo
newTicket新客票YChangeTicketInfo
orgFlightInfoList原航班列表YList<FlightInfo>
newFlightInfoList新航班列表YList<FlightInfo>
ticketPriceDiff票价差价NString100
taxDiff税费差价NString100
changeFee改期费NString100航司收取

改期ChangeTicketInfo

参数名参数说明必填参数类型长度值举例备注
ticketNo票号YString880-1234678590
ticketAmount票面价YString1200.00
tax税费YString200.00

机票申退InterAirRefundInfo

参数名参数说明必填参数类型长度值举例备注
refundNO申退单号YStringR0612063112585500002
orderID订单号YString
payWay支付方式NString1:个人在线支付 2:个人IVR支付(OP)3:现金 4:POS 6:因公欠款 7:vip欠款 8:担保欠款 10:外部月结14:酒店到店付款
refundStatus申退状态YString1:退票申请中 3:拒绝申退 4:退票完成并完成退款 9:已取消 11:待退票 12:待结算员确认 13:待员工确认退票费 14:待退款终态4、9才能提供完整数据
refundTime申退时间YString
refundCompleteTime退票完成时间NString20180811113019
actualRefundTotal实际退款总计YString-1203.00(国际为负值)实际退款总计=应退票价(负值)+应退税费(负值)+应退服务费(负值)-退票费(正值)
refundDetailInfoList申退详情列表NList<RefundDetailInfo>
refundReason退票原因NString用户选择的预设中文退票原因

申退明细RefundDetailInfo

参数名参数说明必填参数类型长度值举例备注
ticketNo票号YString880-1234678590
ticketAmount应退票面价YString1200.00
ticketFee应退客票税费YString200.00
ticketServiceFee应退服务费YString20.00
refundFee退票费YString60.00航司收取
passengerInfo乘客信息YIairPassenger一张票一个乘客

员工信息Passenger

参数名参数说明必填参数类型长度值举例备注
tenantUserId租户用户idNString为企业的员工时必填;为企业的外部客户时不填
name中文姓名NString张三中文姓名与英文姓名必填其一如果国内出差,必填。
surname英文姓NString中文姓名与英文姓名必填其一如果国际出差,必填。
givenName英文名NString如果国际出差,必填。
gender性别NStringM:男(默认)F:女
type乘客类型NString0:成人(默认)1:儿童2:婴儿机票信息需携带,酒店则不做要求
ageType乘客年龄段类型NStringINF:婴儿 CHD:儿童 TEEN:青少年 ADT:成人 ELDER:老人婴儿[0,2);儿童[2,12);青少年[12,18);成人[18,70);老人[70,∞)
nationality国籍NString156预订国际机票和国际酒店必填,填写系统国家ID。
birthday生日NString19881111YYYYMMDD
mailbox邮箱NStringzhangsan@huawei.com为企业的员工时必填,用于接收初始密码
cellphone手机号NString13710001000使用新增员工接口、变更员工接口、审批单同步接口时,手机号必填。
certificateInfoList证件信息NList<CertificateInfo>
deptNum主部门编号NString1234主部门视为默认部门
deptName主部门名称NString市场部主部门视为默认部门,部门名称必须唯一;如不唯一,可以考虑加上部门编码信息区分
employeeNum企业内部工号NString12345
employeeUID企业内部用户IDNString20区别于工号外的员工唯一ID标识
role角色NString2:员工固定为2,暂时不用
employeeVIPLevel员工VIP级别NString21:VIP不支持员工VIP标识传递,仅供查询接口(/employee/detail/query)使用。

CertificateInfo证件信息

参数名参数说明必填参数类型长度值举例备注
certificateType证件类型YString1 身份证2 护照3 其他4 台湾通行证5 回乡证6 港澳通行证7 台胞证
expiredDate有效期NString20180811证件类型为2时建议填写。作为护照失效日期。
passportIssueCountry护照签发国家NString填写系统国家ID。

样例

请求示例

{
    "Version": "3.0",
    "MsgID": "0008120220929071248283828",
    "CorpCode": "0008",
    "TenantUserId": "sysadmin",
    "OrderID": "I218369150"
}

响应示例

{
  "resultCode": "0",
  "description": "Success",
  "orderID": "I1100064280",
  "orderTime": "20250808093923",
  "orderStatus": "12",
  "orderType": "",
  "travelType": "0",
  "journeyType": "1",
  "totalPrice": "818.00",
  "totalServiceFee": "20.00",
  "currency": "CNY",
  "orderSource": "Front",
  "payWay": "10",
  "payStatus": "0",
  "payChannel": null,
  "interTicketList": [
    {
      "ticketCode": "BAANYNN-1",
      "ticketTime": "20250808094322",
      "ticketStatus": "0",
      "refundStatus": "0",
      "changeStatus": "1",
      "ticketPrice": "224.00",
      "tax": "315.00",
      "flightInfoList": [
        {
          "journeyIndex": "1",
          "segmentIndex": "1",
          "airways": "9C",
          "airwaysName": "春秋航空",
          "departAirport": "PVG",
          "departAirportName": "上海浦东国际机场",
          "arrivalAirport": "BKK",
          "arrivalAirportName": "素万那普国际机场",
          "departTime": "20250910213000",
          "departCityThreeCode": "SHA",
          "departCityChineseName": "上海",
          "arriveTime": "20250910235000",
          "arriveCityThreeCode": "BKK",
          "arriveCityChineseName": "曼谷",
          "flight": "9C0031",
          "cabin": "R2",
          "cabinLevel": "2",
          "cabinDiscount": null,
          "departTerminal": "T4",
          "arrivalTerminal": "T2",
          "freeLuggage": "手提行李:每人1件,每件10公斤,体积不超过20×40×55CM。\n托运行李:每人1件,每件30公斤,体积不超过40×60×100CM。",
          "aircraft": null,
          "actualAirways": null,
          "actualAirwaysName": null,
          "actualFlight": null,
          "tpm": "",
          "arriveCityId": "76400026",
          "departCityId": "156310100",
          "stopInfoList": [],
          "segmentStatus": "R"
        }
      ],
      "passengerInfo": {
        "tenantUserId": null,
        "name": "ZHANG/SAN",
        "surname": "WU",
        "givenName": "SAN",
        "gender": "F",
        "type": "0",
        "nationality": "中国",
        "birthday": "19860203",
        "mailbox": "wuji****ng15@hwht.com",
        "cellphone": "137****9685",
        "certificateInfoList": [
          {
            "certificateType": "2",
            "expiredDate": "20300801000000",
            "passportIssueCountry": "CN"
          }
        ],
        "deptNum": "TEST01",
        "deptName": "测试组",
        "employeeNum": "wwx1262196",
        "role": "2",
        "ageType": "ADT"
      }
    },
    {
      "ticketCode": "BAANYNO-1",
      "ticketTime": "20250808094036",
      "ticketStatus": "1",
      "refundStatus": "1",
      "changeStatus": "1",
      "ticketPrice": "249.00",
      "tax": "10.00",
      "flightInfoList": [
        {
          "journeyIndex": "2",
          "segmentIndex": "1",
          "airways": "9C",
          "airwaysName": "春秋航空",
          "departAirport": "BKK",
          "departAirportName": "素万那普国际机场",
          "arrivalAirport": "PVG",
          "arrivalAirportName": "上海浦东国际机场",
          "departTime": "20250914080000",
          "departCityThreeCode": "BKK",
          "departCityChineseName": "曼谷",
          "arriveTime": "20250914110000",
          "arriveCityThreeCode": "SHA",
          "arriveCityChineseName": "上海",
          "flight": "9C3303",
          "cabin": "P1",
          "cabinLevel": "2",
          "cabinDiscount": null,
          "departTerminal": "T2",
          "arrivalTerminal": "T4",
          "freeLuggage": "手提行李:每人1件,每件7公斤,体积不超过20×30×40cm。\n托运行李:每人1件,每件20公斤,体积不超过40×60×100cm。",
          "aircraft": null,
          "actualAirways": null,
          "actualAirwaysName": null,
          "actualFlight": null,
          "tpm": "",
          "arriveCityId": "156310100",
          "departCityId": "76400026",
          "stopInfoList": [],
          "segmentStatus": "O"
        }
      ],
      "passengerInfo": {
        "tenantUserId": null,
        "name": "ZHANG/SAN",
        "surname": "WU",
        "givenName": "SAN",
        "gender": "F",
        "type": "0",
        "nationality": "中国",
        "birthday": "19860203",
        "mailbox": "wuji****ng15@hwht.com",
        "cellphone": "137****9685",
        "certificateInfoList": [
          {
            "certificateType": "2",
            "expiredDate": "20300801000000",
            "passportIssueCountry": "CN"
          }
        ],
        "deptNum": "TEST01",
        "deptName": "测试组",
        "employeeNum": "wwx1262196",
        "role": "2",
        "ageType": "ADT"
      }
    }
  ],
  "interAirChangeInfoList": [
    {
      "changeID": "CI1100064281",
      "orderID": "I1100064280",
      "payWay": "10",
      "payStatus": "0",
      "changeStatus": "2",
      "changeSource": "Front",
      "totalChangeFee": "159.00",
      "changeRemark": null,
      "changeReason": "自愿改期:其它",
      "changeAppTime": "20250808094227",
      "changeDetailList": [
        {
          "passengerInfo": {
            "tenantUserId": null,
            "name": "ZHANG/SAN",
            "surname": "WU",
            "givenName": "SAN",
            "gender": "F",
            "type": "0",
            "nationality": "中国",
            "birthday": "19860203",
            "mailbox": "wuji****ng15@hwht.com",
            "cellphone": "137****9685",
            "certificateInfoList": [
              {
                "certificateType": "2",
                "expiredDate": "20300801000000",
                "passportIssueCountry": "CN"
              }
            ],
            "deptNum": "TEST01",
            "deptName": "测试组",
            "employeeNum": "wwx1262196",
            "role": "2",
            "ageType": "ADT"
          },
          "oldTicket": {
            "ticketNo": "BAANYNN-1",
            "ticketAmount": "224.00",
            "tax": "315.00"
          },
          "newTicket": {
            "ticketNo": "BAANYNN-1",
            "ticketAmount": "293.00",
            "tax": "315.00"
          },
          "orgFlightInfoList": [
            {
              "journeyIndex": "1",
              "segmentIndex": "1",
              "airways": "9C",
              "airwaysName": "春秋航空",
              "departAirport": "PVG",
              "departAirportName": "上海浦东国际机场",
              "arrivalAirport": "BKK",
              "arrivalAirportName": "素万那普国际机场",
              "departTime": "20250910210000",
              "departCityThreeCode": "SHA",
              "departCityChineseName": "上海",
              "arriveTime": "20250910210000",
              "arriveCityThreeCode": "BKK",
              "arriveCityChineseName": "曼谷",
              "flight": "9C8888",
              "cabin": "P1",
              "cabinLevel": "2",
              "cabinDiscount": null,
              "departTerminal": "T4",
              "arrivalTerminal": "T2",
              "freeLuggage": "手提行李:每人1件,每件10公斤,体积不超过20×40×55cm。\n托运行李:每人1件,每件30公斤,体积不超过40×60×100cm。",
              "aircraft": null,
              "actualAirways": null,
              "actualAirwaysName": null,
              "actualFlight": null,
              "tpm": "",
              "arriveCityId": "76400026",
              "departCityId": "156310100",
              "stopInfoList": [],
              "segmentStatus": "O"
            }
          ],
          "newFlightInfoList": [
            {
              "journeyIndex": "1",
              "segmentIndex": "1",
              "airways": "9C",
              "airwaysName": "春秋航空",
              "departAirport": "PVG",
              "departAirportName": "上海浦东国际机场",
              "arrivalAirport": "BKK",
              "arrivalAirportName": "素万那普国际机场",
              "departTime": "20250910213000",
              "departCityThreeCode": "SHA",
              "departCityChineseName": "上海",
              "arriveTime": "20250910235000",
              "arriveCityThreeCode": "BKK",
              "arriveCityChineseName": "曼谷",
              "flight": "9C0031",
              "cabin": "R2",
              "cabinLevel": "2",
              "cabinDiscount": null,
              "departTerminal": "T4",
              "arrivalTerminal": "T2",
              "freeLuggage": "手提行李:每人1件,每件10公斤,体积不超过20×40×55CM。\n托运行李:每人1件,每件30公斤,体积不超过40×60×100CM。",
              "aircraft": null,
              "actualAirways": null,
              "actualAirwaysName": null,
              "actualFlight": null,
              "tpm": "",
              "arriveCityId": "76400026",
              "departCityId": "156310100",
              "stopInfoList": [],
              "segmentStatus": "R"
            }
          ],
          "ticketPriceDiff": "69.00",
          "taxDiff": "0.00",
          "changeFee": "90.00"
        }
      ],
      "changeCompleteTime": "20250808094322",
      "payType": "COMPANY_PAYMENT"
    }
  ],
  "interAirRefundInfoList": [
    {
      "refundNO": "RI1100064281",
      "orderID": "I1100064280",
      "payWay": "10",
      "refundStatus": "14",
      "refundTime": "20250808094404",
      "refundCompleteTime": "20250808094740",
      "actualRefundTotal": "-608.00",
      "refundDetailInfoList": [
        {
          "ticketNo": "BAANYNN-1",
          "ticketAmount": "293.00",
          "ticketFee": "315.00",
          "ticketServiceFee": "0.00",
          "refundFee": "0.00",
          "passengerInfo": {
            "tenantUserId": null,
            "name": "ZHANG/SAN",
            "surname": "WU",
            "givenName": "SAN",
            "gender": "F",
            "type": "0",
            "nationality": "中国",
            "birthday": "19860203",
            "mailbox": "wuji****ng15@hwht.com",
            "cellphone": "137****9685",
            "certificateInfoList": [
              {
                "certificateType": "2",
                "expiredDate": "20300801000000",
                "passportIssueCountry": "CN"
              }
            ],
            "deptNum": "TEST01",
            "deptName": "测试组",
            "employeeNum": "wwx1262196",
            "role": "2",
            "ageType": "ADT"
          }
        }
      ],
      "refundReason": "(自愿)其他"
    }
  ],
  "enterpriseTrID": "TA0612111295",
  "htTrID": "TA0612111295",
  "contactInfoList": [
    {
      "contactName": "张三",
      "contactMobile": "137****9685",
      "contactMail": "wuji****ng15@hwht.com"
    }
  ],
  "orderEr": {
    "tenantUserId": null,
    "name": "张三",
    "employeeNum": "wwx1262196"
  }
}

错误码

错误码错误描述解决方案
10011公司编号不能为空检查入参
3003未知错误,请稍后重试联系技术支持人
3010用户不存在检查账号或者联系技术支持人员
3404时间戳信息错误,请确认后重试检查入参
3401企业账号不存在,请确认后重试检查账号或者联系技术支持人员
10012操作人帐号不能为空检查入参
10013操作人帐号不合法检查账号或者联系技术支持人员
400参数错误根据描述信息检查入参
4000系统繁忙,请稍后重试未知错误,联系技术支持人员
4001系统繁忙,请稍后重试数据库错误,联系技术支持人员
4002参数错误根据描述信息检查入参
10109页码设置错误,请确认后重试检查入参
10110每页条数需要在1~50之间检查入参
10511开始时间不能为空检查入参
10512结束时间不能为空检查入参
10513开始时间格式错误检查入参
10514结束时间格式错误检查入参
10515结束时间不能大于当前时间检查入参
10516结束时间距离开始时间不能超过24小时检查入参
10518该集团下无对应公司检查是否集团查询
10519集团编号不存在,请确认后重试检查账号或者联系技术支持人员
120001070参数错误根据描述信息检查入参
120001086详情查询失败具体描述详见响应,一般需要联系技术支持人员
120001102没有权限越权访问,详见描述信息