美亚航旅机票B2B接口

用户工具

站点工具

3.9_订单详情_itoorderdetailquery

这是本文档旧的修订版！

目录

3.9订单详情(ITOOrderDetailQuery)

3.9.1请求参数

参数 类型 说明 必填 备注
TOOrderID String 订单号 Y

3.9.2请求样例

{
    "TOOrderID": "TO19010135632"
}

3.9.3返回参数

参数 类型 说明 备注
code String 是否调用接口成功 20000表示成功，非20000表异常
detail Object 结果集
description String 描述 当异常时记录异常信息

detail:

参数 类型 说明 备注
orderInfoObject 订单信息
flightListArray 航段组
passengerListArray 乘客组
ioSaleTotalList Array 保险财务信息组 支付时 IO保险单随TO单一起支付
financeDetailObject 财务信息组
contactObject 联系信息
OOOrderInfo Array 辅营产品 支付时 TO单一起支付

orderInfo:

参数 类型 说明 备注
orderIDString 单编号
orderStatusInt 单状态 0：已取消
2、3：处理中
4：待支付
7：待确认价格（需确认支付）
5：待出票
6：已出票
8：已支付
10:申请（异常状态，需人工跟进）
pnrStringPNR
airlinepnrString航司大PNR
productSubTypeInt 机票类型 0：国内
1：国际

flightList:

参数 类型 说明 备注
flightIDInt 航段编号
departTimeString 出发时间
destTimeString 到达时间
airlineString 航司码
flightNoString 航班号
classNoString 舱位
depAirString 出发机场编号
depAirCNString 出发机场名
desAirString 到达机场编号
desAirCNString 到达机场名
depTermString 出发航站楼
desTermString 到达航站楼
class String 舱等 F:头等舱
C:商务舱
Y:经济舱
W:豪华经济舱

passengerList:

参数 类型 说明 备注
passengerIDInt 乘客编号
nameString乘客姓名
passengerTypeInt乘客类型 0：成人
1：儿童
2：婴儿
3：老人
4：学生
5：劳务
6：移民
7：海员
8：青年
nationalityString国籍代码
IDTypeInt证件类型 0护照
1其他有效证件
IDNumberString 证件号码
IDExpirationString 证件有效期
genderInt性别 1：男
0：女
birthdayString 出生日期
PNRString PNR
ticketNoString 票号
statusInt退改废状态 0：正常
1：改
2：退
3：废
IDNationality String 证件签发地代码
IOOrderIDList Array 保险信息

IOOrderIDList:

参数 类型 说明 备注
IOOrderIDString 保险单号
recognizeeString 投保乘客
insureNumberString 投保编号
insureCountString 投保份数
salePriceString 投保金额
orderStatusString 保险状态
orderStatusNameString 保险状态名称
effectDateStrString 生效时间
expiryDateStrString 失效时间

financeDetail:

参数 类型 说明 备注
officeNumberString Office
agencyPolicyRemarkString 代理费政策限制
rewardPolicyRemarkString 奖励政策限制
financeListArray 价格组 每种乘客类型一条数据

financeList

参数 类型 说明 备注
passengerTypeInt 乘客类型 0：成人
1：儿童
2：婴儿
3：老人
4：学生
5：劳务
6：移民
7：海员
8：青年
salePrice Decimal 票面价
taxDecimal tax
beforeReturnDecimal 代理费点数
beforeReturnPriceDecimal 代理费金额
afterReturnBaseDecimal 奖励基数
afterReturnDecimal 奖励点数
afterReturnPriceDecimal 奖励金额
serviceFeeDecimal 服务费
saleTotalDecimal 结算价

ioSaleTotalList

参数 类型 说明 备注
IOOrderID String IO保险单号
orderStatus String 状态 参考IO详情状态
priceSeq Int 财务序号
payedTotal Decimal 已付金额
unPayTotal 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”则退票成功发送短信至上面参数联系人手机
isEmail_VoyageChangeBoolean 航变邮件通知 N 默认为“false”；若“true”则发生航变发送邮件至上面参数邮箱
isSMS_VoyageChange Boolean 航变短信通知 N 默认为“false”；若“true”则发生航变发送短信至上面参数联系人手机

OOOrderInfo：

参数 类型 说明 必填 备注
orderID String 辅营产品订单编号 Y
orderStatus String 订单状态 Y 处理中
待支付
已处理
已取消
saleTotal Decimal 订单结算价 Y
NDCProducts Array 产品详情 Y

NDCProducts：

参数 类型 说明 必填 备注
psgId int 关联乘客编号 N 购买NDC产品的乘客，如果是整单购买的，则不指定特定乘客
psgType string 关联乘客类型 N 购买NDC产品的乘客类型，如果是整单购买的，则不指定特定乘客
psgName string 关联乘客姓名 N 购买NDC产品的乘客姓名，如果是整单购买的，则不指定特定乘客
tripNumber int 行程类型 Y 0：全程，1：去程 2：回程
name string NDC产品 N 1：去程 2：回程
text string NDC产品描述 N 描述
salePrice string 销售价 N
currency string 销售价货币类型 N
weight string 规格 N tf类型辅营产品有值
quantity string 行李额 N tf类型辅营产品有值
proType string 辅营产品类型 N tf，agg
orgcity string 出发城市 N
descity string 到达城市 N

3.9.4返回样例

{
    "code":"20000",
    "detail":{
        "orderInfo":{
            "orderID":"TO19010135632",
            "status":6,
            "pnr":"JRX83L",
            "airlinepnr":"JRX83L"
        },
        "flightList":[
            {
                "flightID":8825234,
                "departTime":"2019-04-14 20:55:00",
                "destTime":"2019-04-14 22:40:00",
                "airline":"BR",
                "flightNo":"858",
                "classNo":"W",
                "depAir":"HKG",
                "depAirCN":"香港赤腊角国际机场",
                "desAir":"TPE",
                "desAirCN":"台湾桃园国际机场",
                "departureCityName":"香港",
                "destinationCityName":"台北"
            },
            {
                "flightID":8825235,
                "departTime":"2019-04-15 06:45:00",
                "destTime":"2019-04-15 09:15:00",
                "airline":"BR",
                "flightNo":"112",
                "classNo":"W",
                "depAir":"TPE",
                "depAirCN":"台湾桃园国际机场",
                "desAir":"OKA",
                "desAirCN":"那霸机场",
                "departureCityName":"台北",
                "destinationCityName":"冲绳"
            },
            {
                "flightID":8825236,
                "departTime":"2019-04-21 10:15:00",
                "destTime":"2019-04-21 10:55:00",
                "airline":"BR",
                "flightNo":"113",
                "classNo":"S",
                "depAir":"OKA",
                "depAirCN":"那霸机场",
                "desAir":"TPE",
                "desAirCN":"台湾桃园国际机场",
                "departureCityName":"冲绳",
                "destinationCityName":"台北"
            },
            {
                "flightID":8825237,
                "departTime":"2019-04-24 14:10:00",
                "destTime":"2019-04-24 16:00:00",
                "airline":"BR",
                "flightNo":"855",
                "classNo":"S",
                "depAir":"TPE",
                "depAirCN":"台湾桃园国际机场",
                "desAir":"HKG",
                "desAirCN":"香港赤腊角国际机场",
                "departureCityName":"台北",
                "destinationCityName":"香港"
            }
        ],
        "passengerList":[
            {
                "passengerID":7360342,
                "name":"CHEUNG/LAAM",
                "passengerType":0,
                "nationality":"HK",
                "IDType":0,
                "IDNumber":"K05523199",
                "IDExpiration":"2021-06-15",
                "gender":"0",
                "birthday":"2004-11-26",
                "PNR":"JRX83L",
                "ticketNo":"695-3422409213",
                "status":0
            },
            {
                "passengerID":7360343,
                "name":"CHEUNG/HEI",
                "passengerType":1,
                "nationality":"HK",
                "IDType":0,
                "IDNumber":"K2222523159",
                "IDExpiration":"2021-06-15",
                "gender":"0",
                "birthday":"2007-10-06",
                "PNR":"JRX83L",
                "ticketNo":"695-1111409214",
                "status":0
            },
            {
                "passengerID":7360344,
                "name":"CHOY/LAI",
                "passengerType":0,
                "nationality":"HK",
                "IDType":0,
                "IDNumber":"K011115088",
                "IDExpiration":"2026-06-11",
                "gender":"0",
                "birthday":"1976-08-11",
                "PNR":"JRX83L",
                "ticketNo":"695-1111409215",
                "status":0
            }
        ],
        "financeDetail":{
            "officeNumber":"CAN826",
            "agencyPolicyRemark":"",
            "rewardPolicyRemark":"",
            "financeList":[
                {
                    "passengerType":0,
                    "salePrice":1890,
                    "tax":663,
                    "beforeReturn":7,
                    "beforeReturnPrice":132,
                    "afterReturnBase":1758,
                    "afterReturn":3,
                    "afterReturnPrice":52,
                    "serviceFee":0,
                    "saleTotal":2369
                },
                {
                    "passengerType":1,
                    "salePrice":1430,
                    "tax":526,
                    "beforeReturn":7,
                    "beforeReturnPrice":100,
                    "afterReturnBase":1330,
                    "afterReturn":3,
                    "afterReturnPrice":39,
                    "serviceFee":0,
                    "saleTotal":1817
                }
            ]
        }
    }
}
3.9_订单详情_itoorderdetailquery.1678676698.txt.gz · 最后更改: 2023/03/13 03:04 由 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