模块 | 位置 | 类型 | 描述 | 更新时间 |
---|---|---|---|---|
全API模块 | 全部API接口 | 新增 | 去掉部分不必要字段(多传字段非必要字段不会影响接口) | 2017年01月17日 |
国际机票 | 国际机票询价单 | 新增 | 新增标准国际机票询价单接口 | 2022年3月01日 |
国内机票 | 国内机票南网个性化接口 | 新增 | 新增南网个性化部分接口 | 2022年6月16日 |
火车票 | 火车票API接口 | 新增 | 火车票API全流程改造 | 2022年12月30日 |
公共 | H5跳转接口 | 修改 | 南网对接-H5因私跳转对接增加自定义字段 | 2023年09月12日 |
国际机票推送 | 国际机票推送 | 修改 | API-国际机票订单推送接口增加出发地国家和目的地国家 | 2023年10月10日 |
接口格式使用最常用的API接口类型之一:RESTful API,请求方式:POST,数据格式:json格式。
如果请求返回的不是json格式,非常可能是请求参数的json数据格式跟文档的要求的json结构不一致,先检查参数json格式后,仍不到找到问题,请带上参数联系美亚技术
接口接入联调前对接客户需要知晓以下注意事项并严格遵守:
1.关于登录 key(重要):
● 分配对接方密钥key需要用于Login接口时生成Password的身份凭证,正式环境使用密钥key,不可对外泄露;
● 接口login返回的sessiondid有效期为当天,每天00:00会失效,失效后需重新登录获取;
2.关于环境:
测试环境http://testapi.shinetour.com和生产环境http://api.shinetour.com,地址请阅读接口文档里提供的请求示例;
3.关于测试航班和订单的说明(重要):
● 出差单城市对需使用国家标准城市数据或者使用美亚提供的【行政区域数据接口:GetCityAreaList】
● 测试预订航班建议选用出发日期为当前日期+90天的航班;
● 测试使用的旅客姓名请使用正常旅客名称和证件号,不可随意乱填不合符规范的旅客名称和证件号;
● 测试的订单出票均为虚拟出票,可以放心测试预订和出票
● 测试单未退票或没有及时退票导致的费用,需要分销商自己来承担;
● 需要订单推送,则参考文档订单推送部分,并测试前提供推送接口地址美亚实施进行配置;
4.关于接口上线:
正式环境上线前请通知相应商务,并注意找美亚实施提供上线密钥key;
5.对接流程参考:
查阅对接流程
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
password | 加密签名; 加密方式示例参考以下文档:http://apidoc.shinetour.com/dochelper/logindoc | String | 是 | |
staffCode | 员工编号 | String | 是 | |
timeStamp | 时间戳 | String | 是 | |
realName | 真实姓名 | String | 是 | |
passwordType | 0- 员工工号单点登录; | String | 是 | |
companyId | 公司编号 | String | 是 |
{
"password":"5e60c74c9016085c60bf492d33226e586175ec2e", //加密签名;
加密方式示例参考以下文档:http://apidoc.shinetour.com/dochelper/logindoc
"staffCode":"P586522", //员工编号
"timeStamp":"20231011093726357", //时间戳
"realName":"系统对接", //真实姓名
"passwordType":"0", //0- 员工工号单点登录;
"companyId":"S118022", //公司编号
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
sessionId | 会话ID,相当于token(有效期一天,每天00:00失效一次) | String | ||
url | 跳转地址 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //会话ID,相当于token(有效期一天,每天00:00失效一次)
"url":"https://testincsz.shinetour.com/inc/#/common/index?goto=", //跳转地址
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
查询平台重要公告通知和航班相关信息通知
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
productSubType | 产品子类型(1-国内机票、2-国际机票、3-国内酒店、4-国际酒店、5-火车票) | Integer | 是 | |
departureCity | 出发城市编号 | String | 是 | |
arrivalCity | 到达城市编号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"productSubType":1, //产品子类型(1-国内机票、2-国际机票、3-国内酒店、4-国际酒店、5-火车票)
"departureCity":"SHA", //出发城市编号
"arrivalCity":"BJS", //到达城市编号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
noticeInfoList | 城市公告通知 | Array[] | ||
noticeNo | 公告编号 | String | noticeInfoList | |
tripNum | 行程编号(不是实体字段,展示时使用) | Integer | noticeInfoList | |
titleName | 公告标题 | String | noticeInfoList | |
noticeType | 公告类型(0=城市公告) | Integer | noticeInfoList | |
isDomesticTicket | 是否勾选国内机票(0=未勾选 1=已勾选) | Integer | noticeInfoList | |
isIntairTicket | 是否勾选国际机票(0=未勾选 1=已勾选) | Integer | noticeInfoList | |
isDomesticHotel | 是否勾选国内酒店(0=未勾选 1=已勾选) | Integer | noticeInfoList | |
isTrain | 是否勾选火车票(0=未勾选 1=已勾选) | Integer | noticeInfoList | |
cityType | 城市类型(1=出发城市 2=到达城市) | Integer | noticeInfoList | |
noticeContent | 公告内容 | String | noticeInfoList | |
formatContent | 文本简介 | String | noticeInfoList | |
validityStart | 公告有效期开始 | String | noticeInfoList | |
updateDate | 最后修改时间 | String | noticeInfoList |
{
"noticeInfoList":
[{
"noticeNo":"20231025452", //公告编号
"tripNum":1, //行程编号(不是实体字段,展示时使用)
"titleName":"公告标题", //公告标题
"noticeType":0, //公告类型(0=城市公告)
"isDomesticTicket":1, //是否勾选国内机票(0=未勾选 1=已勾选)
"isIntairTicket":0, //是否勾选国际机票(0=未勾选 1=已勾选)
"isDomesticHotel":0, //是否勾选国内酒店(0=未勾选 1=已勾选)
"isTrain":0, //是否勾选火车票(0=未勾选 1=已勾选)
"cityType":1, //城市类型(1=出发城市 2=到达城市)
"noticeContent":"无航班公告内容", //公告内容
"formatContent":"无", //文本简介
"validityStart":"2023-10-15 10:10:01", //公告有效期开始
"updateDate":"2023-10-15 10:10:01", //最后修改时间
}], //城市公告通知
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
PC跳转预订,获取跳转相关地址
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
pageCode | url编码;I-首页, FI-国内机票首页,F-机票查询页,FD-国内机票订单详情页,FC-国内机票改签订单页,FR-国内机票退票订单页,FL-国内机票订单列表, IFI-首页国际机票tab标签,IF-国际机票首页,IFD-国际机票订单详情页,IFL-国际机票订单列表, HC-国内酒店首页,H-酒店查询页,HD-酒店订单页,HR-酒店退房订单页,HL-酒店订单列表, TI-火车票首页,T-火车票查询页,TD-火车票订单页,TC-火车票改签订单页,TR-火车票退票订单页,TL-火车票订单列表, RD-出差申请单详情页,RL-出差申请单列表页,ZF-支付页面(订单详情页要传入订单号,支付页要传入支付金额); IH-国际酒店首页,IHD-国际酒店订购单详情,IHL-国际酒店订单列表,IHR-国际酒店退票详情 | String | 是 | |
infoID | 信息编号(当pageCode=RD时,传 美亚出差申请单号,EC开头的) | String | 否 | |
orderNo | 出差申请单号或者订单号,支付或者查询订单详情时必须传 | String | 否 | |
totalAmount | 订单总额(支付),pageCode=ZF 时才需要传,否则不传 | Number | 否 | |
backUrl | 需要返回的链接地址 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
applyOrderInfo | 出差单跳转信息 带行程信息跳转到预订页(目前只支持国内机票和国际机票两种产品,并且只对跳转到产品首页(FI、IFI)和查询页有效(F,IF)) | ApplyOrderInfo | 否 | |
applyOutsiderOrderNo | 【客户出差申请单号】必传 | String | applyOrderInfo | |
departureCity | 【出发城市】ApplyOrderInfo不为空传值时,必传; | String | applyOrderInfo | |
arrivalCity | 【到达城市】ApplyOrderInfo不为空传值时,必传; | String | applyOrderInfo | |
departureCityCode | 【出发城市三字码】非必传 | String | applyOrderInfo | |
arrivalCityCode | 【到达城市三字码】非必传 | String | applyOrderInfo | |
beginDate | 【出发时间】ApplyOrderInfo不为空传值时,必传; | String | applyOrderInfo | |
endDate | 【到达时间】非必传,当航程类型=往返,必传。 | String | applyOrderInfo |
{
"pageCode":"I", //url编码;I-首页,
FI-国内机票首页,F-机票查询页,FD-国内机票订单详情页,FC-国内机票改签订单页,FR-国内机票退票订单页,FL-国内机票订单列表,
IFI-首页国际机票tab标签,IF-国际机票首页,IFD-国际机票订单详情页,IFL-国际机票订单列表,
HC-国内酒店首页,H-酒店查询页,HD-酒店订单页,HR-酒店退房订单页,HL-酒店订单列表,
TI-火车票首页,T-火车票查询页,TD-火车票订单页,TC-火车票改签订单页,TR-火车票退票订单页,TL-火车票订单列表,
RD-出差申请单详情页,RL-出差申请单列表页,ZF-支付页面(订单详情页要传入订单号,支付页要传入支付金额);
IH-国际酒店首页,IHD-国际酒店订购单详情,IHL-国际酒店订单列表,IHR-国际酒店退票详情
"infoID":"EC230005481", //信息编号(当pageCode=RD时,传 美亚出差申请单号,EC开头的)
"orderNo":"TB230005488", //出差申请单号或者订单号,支付或者查询订单详情时必须传
"totalAmount":200, //订单总额(支付),pageCode=ZF 时才需要传,否则不传
"backUrl":"http://testapi.shinetour.com", //需要返回的链接地址
"applyOrderInfo":
{
"applyOutsiderOrderNo":"SEN2024061503", //【客户出差申请单号】必传
"departureCity":"广州", //【出发城市】ApplyOrderInfo不为空传值时,必传;
"arrivalCity":"北京", //【到达城市】ApplyOrderInfo不为空传值时,必传;
"departureCityCode":"CAN", //【出发城市三字码】非必传
"arrivalCityCode":"BJS", //【到达城市三字码】非必传
"beginDate":"2024-07-15", //【出发时间】ApplyOrderInfo不为空传值时,必传;
"endDate": "", //【到达时间】非必传,当航程类型=往返,必传。
}, //出差单跳转信息 带行程信息跳转到预订页(目前只支持国内机票和国际机票两种产品,并且只对跳转到产品首页(FI、IFI)和查询页有效(F,IF))
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
url | 跳转Url | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"url":"https://testwsz.shinetour.com/Route.aspx?code=", //跳转Url
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
H5移动页面跳转预订,获取跳转相关地址
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
pageCode | url编码;I-首页,F-机票查询页,PF-因私机票查询页,IF-国际机票查询页,H-酒店查询页,PH-因私酒店查询页, T-火车票查询页,FD-机票订单详情页,FC-国内机票改签订单页,FR-国内机票退票订单页,HD-酒店订单详情页,TD-火车票订单详情页, FL-机票订单列表页,PFL-因私机票订单列表页,HL-酒店订单列表页,PHL-因私酒店订单列表页,IFD-国际机票订单详情页,IFL-国际机票订单列表, L-订单列表页,RD-出差申请单详情页,RL-出差申请单列表页,ZF-支付页面 (订单详情页要传入订单号,支付页要传入支付金额) IH-国际酒店首页,IHD-国际酒店订购单详情,IHL-国际酒店订单列表,IHR-国际酒店退票详情 | String | 否 | |
orderNo | 出差申请单号 或者 订单号 | String | 否 | |
applyTripId | 行程编码,默认第一行程 | String | 否 | |
tripNum | 行程类型,0-单程,1-往返; 只支持机票;火车票无往返默认都是单程 | String | 否 | |
totalAmount | 订单总额,,pageCode=ZF 时才需要传,否则不传 | Number | 否 | |
backUrl | 支付后返回的链接地址,pageCode=ZF 时才需要传,否则不传 | String | 否 | |
oaOtherInfo | 其他信息,个性化客户需要(比如:中奖码) | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
applyOrderInfo | 出差单跳转信息带行程信息跳转到预订页,出差单跳转信息 带行程信息跳转到预订页(目前只支持国内机票和国际机票两种产品,并且只对跳转到产品首页(FI、IFI)和查询页有效(F,IF)) | ApplyOrderInfo | 否 | |
applyOutsiderOrderNo | 【客户出差申请单号】必传 | String | applyOrderInfo | |
departureCity | 【出发城市】ApplyOrderInfo不为空传值时,必传; | String | applyOrderInfo | |
arrivalCity | 【到达城市】ApplyOrderInfo不为空传值时,必传; | String | applyOrderInfo | |
departureCityCode | 【出发城市三字码】非必传 | String | applyOrderInfo | |
arrivalCityCode | 【到达城市三字码】非必传 | String | applyOrderInfo | |
beginDate | 【出发时间】ApplyOrderInfo不为空传值时,必传; | String | applyOrderInfo | |
endDate | 【到达时间】非必传,当航程类型=往返,必传。 | String | applyOrderInfo |
{
"pageCode":"RD", //url编码;I-首页,F-机票查询页,PF-因私机票查询页,IF-国际机票查询页,H-酒店查询页,PH-因私酒店查询页,
T-火车票查询页,FD-机票订单详情页,FC-国内机票改签订单页,FR-国内机票退票订单页,HD-酒店订单详情页,TD-火车票订单详情页,
FL-机票订单列表页,PFL-因私机票订单列表页,HL-酒店订单列表页,PHL-因私酒店订单列表页,IFD-国际机票订单详情页,IFL-国际机票订单列表,
L-订单列表页,RD-出差申请单详情页,RL-出差申请单列表页,ZF-支付页面 (订单详情页要传入订单号,支付页要传入支付金额)
IH-国际酒店首页,IHD-国际酒店订购单详情,IHL-国际酒店订单列表,IHR-国际酒店退票详情
"orderNo":"EC2300653893", //出差申请单号 或者 订单号
"applyTripId":"1", //行程编码,默认第一行程
"tripNum":"0", //行程类型,0-单程,1-往返; 只支持机票;火车票无往返默认都是单程
"totalAmount":true, //订单总额,,pageCode=ZF 时才需要传,否则不传
"backUrl":"http://testapi.shinetour.com/web", //支付后返回的链接地址,pageCode=ZF 时才需要传,否则不传
"oaOtherInfo":"X155742", //其他信息,个性化客户需要(比如:中奖码)
"applyOrderInfo":
{
"applyOutsiderOrderNo":"SEN2024061503", //【客户出差申请单号】必传
"departureCity":"广州", //【出发城市】ApplyOrderInfo不为空传值时,必传;
"arrivalCity":"北京", //【到达城市】ApplyOrderInfo不为空传值时,必传;
"departureCityCode":"CAN", //【出发城市三字码】非必传
"arrivalCityCode":"BJS", //【到达城市三字码】非必传
"beginDate":"2024-07-15", //【出发时间】ApplyOrderInfo不为空传值时,必传;
"endDate": "", //【到达时间】非必传,当航程类型=往返,必传。
}, //出差单跳转信息带行程信息跳转到预订页,出差单跳转信息 带行程信息跳转到预订页(目前只支持国内机票和国际机票两种产品,并且只对跳转到产品首页(FI、IFI)和查询页有效(F,IF))
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
url | 跳转Url,可以直接打开 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"url":"https://testh5sz.shinetour.com/unih5/#/pages/index/index?backUrl=&formResult=1¶meters=", //跳转Url,可以直接打开
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
线上支付,通过支付流水进行确认成功与否
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号 | String | 是 | |
totalAmount | 订单总额(注意:国际机票订单QT,QC开头的订单元为单位,其他订单分为单位) | String | 是 | |
payType | 支付方式 0-跳转,默认跳转H5支付(PC跳转暂不支持),1-支付账号托管,2-代扣(暂不支持),3 预存款支付 | String | 是 | |
payChannel | 支付渠道,不传默认H5支付 跳转支付渠道:0-H5支付,1-PC支付(暂不支持);2-支付账号托管支付渠道;3-支付宝代扣支付渠道(暂不支持);4-微信代扣支付渠道(暂不支持) | String | 是 | |
payBankNo | 支付银行账号;当支付方式为支付账号托管的,必填,否则为空值 | String | 否 | |
payPlatform | 付款方金融机构(平台);当支付方式为支付账号托管时,必填,参数:支付宝或微信 | String | 否 | |
receiptBankNo | 收款方银行账号;当支付方式为支付账号托管时,必填,否则为空值 | String | 否 | |
receiptPlatform | 收款方金融机构(平台);当支付方式为支付账号托管时,必填,参数:支付宝或微信 | String | 否 | |
paySerialNo | 当支付方式为支付账号托管时,必填,第三方流水号,否则为空值 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB230000261", //美亚订单号
"totalAmount":"1000", //订单总额(注意:国际机票订单QT,QC开头的订单元为单位,其他订单分为单位)
"payType":"0", //支付方式 0-跳转,默认跳转H5支付(PC跳转暂不支持),1-支付账号托管,2-代扣(暂不支持),3 预存款支付
"payChannel":"0", //支付渠道,不传默认H5支付
跳转支付渠道:0-H5支付,1-PC支付(暂不支持);2-支付账号托管支付渠道;3-支付宝代扣支付渠道(暂不支持);4-微信代扣支付渠道(暂不支持)
"payBankNo":"8258521013300112255", //支付银行账号;当支付方式为支付账号托管的,必填,否则为空值
"payPlatform":"支付宝", //付款方金融机构(平台);当支付方式为支付账号托管时,必填,参数:支付宝或微信
"receiptBankNo":"8258521013300113366", //收款方银行账号;当支付方式为支付账号托管时,必填,否则为空值
"receiptPlatform":"支付宝", //收款方金融机构(平台);当支付方式为支付账号托管时,必填,参数:支付宝或微信
"paySerialNo":"ls20231011025455", //当支付方式为支付账号托管时,必填,第三方流水号,否则为空值
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
url | 跳转Url,可以直接打开,用于在线支付 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"url":"https://testh5sz.shinetour.com/unih5/#/pages/index/index?backUrl=&formResult=1¶meters=", //跳转Url,可以直接打开,用于在线支付
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
订单取消和出票处理,所有订单的取消和出票
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单号 | String | 是 | |
operate | 操作(取消 或者 出票) 中文字串 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB230000261", //订单号
"operate":"取消", //操作(取消 或者 出票) 中文字串
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
priceInfo | PAT信息,只有出票时变价才返回 | PATPriceInfo | ||
newPrice | 新价格 | Number | priceInfo | |
oldPrice | 旧价格 | Number | priceInfo |
{
"priceInfo":
{
"newPrice":1500.00, //新价格
"oldPrice":1350.00, //旧价格
}, //PAT信息,只有出票时变价才返回
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
客户平台差旅政策同步到美亚系统差旅政策
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
sessionId | sessionId,login接口返回 | String | 是 | |
syncPolicyInfoList | 旅客 | Array[] | 是 | |
outsidePolicyId | 客户系统差旅政策ID(要唯一,系统是根据该ID 进行更新和删除的) | String | syncPolicyInfoList | |
policyName | 差旅政策名称 | String | syncPolicyInfoList | |
policyType | 政策类型 "基础" "分类" "个人" | String | syncPolicyInfoList | |
remark | 备注说明 | String | syncPolicyInfoList | |
departmentName | 部门名称树结构用/隔开,多个以,分割;根据部门设置差标的查需要传 | String | syncPolicyInfoList | |
passengerId | 旅客ID,旅客必须已存在美亚系统,多个以,分割;个人分类的差标才需要传 | String | syncPolicyInfoList | |
positionName | 职称名称树结构用/隔开,多个以,分割;必须职级在接口之前已做好同步处理; | String | syncPolicyInfoList | |
productType | 产品类型 1、国内机票 2、国内酒店 3、国际机票 5、火车票 | String | syncPolicyInfoList | |
beginDate | 开始生效时间,必须是yyyy-MM-dd hh:mm:ss,不传默认系统时间 | String | syncPolicyInfoList | |
endDate | 结束生效时间,必须是yyyy-MM-dd hh:mm:ss,不传默认当前有效期一年 | String | syncPolicyInfoList | |
operate | 操作指示; 默认0更新,1则删除 | Integer | syncPolicyInfoList | |
PostName | 职位名称,多个以,分割 | String | syncPolicyInfoList | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验PostName 职位) | Integer | syncPolicyInfoList | |
paraments | 详细政策信息 | PolicyDefineParaments | syncPolicyInfoList | |
trainParaments | 火车票政策信息 | TrainParaments | syncPolicyInfoList.paraments | |
advanceDay | A01 提前预定天数 | Integer | syncPolicyInfoList.paraments.trainParaments | |
advanceDayLevel | A01 限制级数 0-不开启;1-强制;2-建议; | Integer | syncPolicyInfoList.paraments.trainParaments | |
seatTypeLS | A02 商务座 特等座 一等座 二等座 软座 硬座 无座 高级软卧 高级动卧 软卧 动卧 硬卧 一等卧 二等卧其他; 传文字,多个用英文,分割;例如:二等座,硬座,软卧 | String | syncPolicyInfoList.paraments.trainParaments | |
starsLevel | A02 A01 限制级数 0-不开启;1-强制;2-建议; | Integer | syncPolicyInfoList.paraments.trainParaments | |
flightParaments | 国内机票航班信息 | FlightParaments | syncPolicyInfoList.paraments | |
mileage | A01 公里数 | Integer | syncPolicyInfoList.paraments.flightParaments | |
mileageLevel | A01 限制级数 0-不开启;1-强制;2-建议; | Integer | syncPolicyInfoList.paraments.flightParaments | |
advanceDay | A02 提前预定天数 | Integer | syncPolicyInfoList.paraments.flightParaments | |
advanceDayLevel | A01 限制级数 0-不开启;1-强制;2-建议; | Integer | syncPolicyInfoList.paraments.flightParaments | |
fCabin | A03 舱等 1-经济舱 2-商务舱 3-头等舱 4-豪华经济舱 | Integer | syncPolicyInfoList.paraments.flightParaments | |
fCabinLevel | A03 限制级数 0-不开启;1-强制;2-建议; | Integer | syncPolicyInfoList.paraments.flightParaments | |
discount | Number | syncPolicyInfoList.paraments.flightParaments | ||
discountLevel | A04 限制级数 0-不开启;1-强制;2-建议; | Integer | syncPolicyInfoList.paraments.flightParaments | |
priceLimit | A12 航班最高价限制;1- 每个航班仅允许预订最低价;2- 每个航班仅允许预订最低价,并且全舱位比价 | Integer | syncPolicyInfoList.paraments.flightParaments | |
priceLimitLevel | A12 限制级数 0-不开启;1-强制;2-建议; | Integer | syncPolicyInfoList.paraments.flightParaments | |
fCabinChange | B01 改签机票最高舱等 1-经济舱 2-商务舱 3-头等舱 4-豪华经济舱 | Integer | syncPolicyInfoList.paraments.flightParaments | |
fCabinChangeLevel | B01 限制级数 0-不开启;1-强制;2-建议; | Integer | syncPolicyInfoList.paraments.flightParaments | |
discountChange | Integer | syncPolicyInfoList.paraments.flightParaments | ||
discountChangeLevel | B02 限制级数 0-不开启;1-强制;2-建议; | Integer | syncPolicyInfoList.paraments.flightParaments | |
hotelParaments | 国内酒店政策信息 | HotelParaments | syncPolicyInfoList.paraments | |
advanceDay | A01 提前预定天数 | Integer | syncPolicyInfoList.paraments.hotelParaments | |
advanceDayLevel | A01 限制级数 0-不开启;1-强制;2-建议; | Integer | syncPolicyInfoList.paraments.hotelParaments | |
stars | A03 星级 2- 二星及以下(经济)3- 三星(舒适)4- 四星(高档) 5-五星及以上(豪华),多个以英文,分割 | String | syncPolicyInfoList.paraments.hotelParaments | |
starsLevel | A03 限制级数 0-不开启;1-强制;2-建议; | Integer | syncPolicyInfoList.paraments.hotelParaments | |
hotelPriceLimit | A04 酒店房价限制 true 开启 false 不开启 | Boolean | syncPolicyInfoList.paraments.hotelParaments | |
cityEnabled1 | A04 城市1 是否启用 | Boolean | syncPolicyInfoList.paraments.hotelParaments | |
maxPrice1 | A04 上限金额 | Integer | syncPolicyInfoList.paraments.hotelParaments | |
cityEnabled2 | A04 城市2 是否启用 | Boolean | syncPolicyInfoList.paraments.hotelParaments | |
maxPrice2 | A03 上限金额 | Integer | syncPolicyInfoList.paraments.hotelParaments | |
cityEnabled3 | A04 城市3 是否启用 | Boolean | syncPolicyInfoList.paraments.hotelParaments | |
maxPrice3 | A04 上限金额 | Integer | syncPolicyInfoList.paraments.hotelParaments | |
cityEnabled4 | A04 城市4 是否启用 | Boolean | syncPolicyInfoList.paraments.hotelParaments | |
maxPrice4 | A04 上限金额 | Integer | syncPolicyInfoList.paraments.hotelParaments | |
cityEnabledOther | A04 其他 | Boolean | syncPolicyInfoList.paraments.hotelParaments | |
maxPriceOther | A04 上限金额 | Integer | syncPolicyInfoList.paraments.hotelParaments | |
cityStr1 | A04 城市组1 | Array[] | syncPolicyInfoList.paraments.hotelParaments | |
cityStr1 | 城市唯一码 | String | syncPolicyInfoList.paraments.hotelParaments.cityStr1 | |
cityStr1 | 城市名称 | String | syncPolicyInfoList.paraments.hotelParaments.cityStr1 | |
cityStr2 | A04 城市组3 | Array[] | syncPolicyInfoList.paraments.hotelParaments | |
cityStr2 | 城市唯一码 | String | syncPolicyInfoList.paraments.hotelParaments.cityStr2 | |
cityStr2 | 城市名称 | String | syncPolicyInfoList.paraments.hotelParaments.cityStr2 | |
cityStr3 | A04 城市组3 | Array[] | syncPolicyInfoList.paraments.hotelParaments | |
cityStr3 | 城市唯一码 | String | syncPolicyInfoList.paraments.hotelParaments.cityStr3 | |
cityStr3 | 城市名称 | String | syncPolicyInfoList.paraments.hotelParaments.cityStr3 | |
cityStr4 | A04 城市组4 | Array[] | syncPolicyInfoList.paraments.hotelParaments | |
cityStr4 | 城市唯一码 | String | syncPolicyInfoList.paraments.hotelParaments.cityStr4 | |
cityStr4 | 城市名称 | String | syncPolicyInfoList.paraments.hotelParaments.cityStr4 |
{
"syncPolicyInfoList":
[{
"outsidePolicyId":"CL20230321", //客户系统差旅政策ID(要唯一,系统是根据该ID 进行更新和删除的)
"policyName":"其他人员", //差旅政策名称
"policyType":"分类", //政策类型 "基础" "分类" "个人"
"paraments":
{
"flightParaments":
{
"mileage":1000, //A01 公里数
"mileageLevel":1, //A01 限制级数 0-不开启;1-强制;2-建议;
"advanceDay":5, //A02 提前预定天数
"advanceDayLevel":2, //A01 限制级数 0-不开启;1-强制;2-建议;
"fCabin":1, //A03 舱等 1-经济舱 2-商务舱 3-头等舱 4-豪华经济舱
"fCabinLevel":2, //A03 限制级数 0-不开启;1-强制;2-建议;
"discount":8.5, //
"discountLevel":2, //A04 限制级数 0-不开启;1-强制;2-建议;
"priceLimit":1, //A12 航班最高价限制;1- 每个航班仅允许预订最低价;2- 每个航班仅允许预订最低价,并且全舱位比价
"priceLimitLevel":02, //A12 限制级数 0-不开启;1-强制;2-建议;
"fCabinChange":2, //B01 改签机票最高舱等 1-经济舱 2-商务舱 3-头等舱 4-豪华经济舱
"fCabinChangeLevel":2, //B01 限制级数 0-不开启;1-强制;2-建议;
"discountChange":1, //
"discountChangeLevel":2, //B02 限制级数 0-不开启;1-强制;2-建议;
}, //国内机票航班信息
"hotelParaments":
{
"advanceDay":1, //A01 提前预定天数
"advanceDayLevel":2, //A01 限制级数 0-不开启;1-强制;2-建议;
"stars":"4", //A03 星级 2- 二星及以下(经济)3- 三星(舒适)4- 四星(高档) 5-五星及以上(豪华),多个以英文,分割
"starsLevel":2, //A03 限制级数 0-不开启;1-强制;2-建议;
"hotelPriceLimit":true, //A04 酒店房价限制 true 开启 false 不开启
"cityEnabled1":true, //A04 城市1 是否启用
"cityStr1":
[{
"PolicyCityCode":"c10750", //城市唯一码
"PolicyCityName":"北京", //城市名称
}], //A04 城市组1
"maxPrice1":800, //A04 上限金额
"cityEnabled2":true, //A04 城市2 是否启用
"cityStr2":
[{
"PolicyCityCode":"c10750", //城市唯一码
"PolicyCityName":"北京", //城市名称
}], //A04 城市组3
"maxPrice2":600, //A03 上限金额
"cityEnabled3":true, //A04 城市3 是否启用
"cityStr3":
[{
"PolicyCityCode":"c10750", //城市唯一码
"PolicyCityName":"北京", //城市名称
}], //A04 城市组3
"maxPrice3":400, //A04 上限金额
"cityEnabled4":false, //A04 城市4 是否启用
"cityStr4":
[{
"PolicyCityCode":"c10750", //城市唯一码
"PolicyCityName":"北京", //城市名称
}], //A04 城市组4
"maxPrice4":0, //A04 上限金额
"cityEnabledOther":true, //A04 其他
"maxPriceOther":300, //A04 上限金额
}, //国内酒店政策信息
"trainParaments":
{
"advanceDay":3, //A01 提前预定天数
"advanceDayLevel":2, //A01 限制级数 0-不开启;1-强制;2-建议;
"seatTypeLS":"二等座,硬座,软卧", //A02 商务座 特等座 一等座 二等座 软座 硬座 无座 高级软卧 高级动卧 软卧 动卧 硬卧 一等卧 二等卧其他;
传文字,多个用英文,分割;例如:二等座,硬座,软卧
"starsLevel":2, //A02 A01 限制级数 0-不开启;1-强制;2-建议;
}, //火车票政策信息
}, //详细政策信息
"remark":"CL20230321差旅政策", //备注说明
"departmentName": "", //部门名称树结构用/隔开,多个以,分割;根据部门设置差标的查需要传
"passengerId":"ak10002", //旅客ID,旅客必须已存在美亚系统,多个以,分割;个人分类的差标才需要传
"positionName":"其他人员", //职称名称树结构用/隔开,多个以,分割;必须职级在接口之前已做好同步处理;
"productType":"2", //产品类型 1、国内机票 2、国内酒店 3、国际机票 5、火车票
"beginDate":"2023-10-18", //开始生效时间,必须是yyyy-MM-dd hh:mm:ss,不传默认系统时间
"endDate":"2031-08-02", //结束生效时间,必须是yyyy-MM-dd hh:mm:ss,不传默认当前有效期一年
"operate":0, //操作指示; 默认0更新,1则删除
"PostName": "", //职位名称,多个以,分割
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验PostName 职位)
}], //旅客
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
policyInfoKey | 用户列表 | Array[] | ||
outsidePolicyId | 外部出差政策编号 | String | policyInfoKey | |
meiyaPolicyId | 美亚出差政策编号 | String | policyInfoKey |
{
"policyInfoKey":
[{
"outsidePolicyId":"CL20230321", //外部出差政策编号
"meiyaPolicyId":"ZC20231018009007", //美亚出差政策编号
}], //用户列表
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
同步旅客信息(旧版),无法返回部分成功部分失败情况,建议使用:SyncPsgInfoNew接口
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
sessionId | sessionId,login接口返回 | String | 是 | |
SyncPsgList | 旅客 | Array[] | 是 | |
isCreateLoginDefault | 如果账号重复,默认false-提示重复,true-不提示重复直接按美亚默认旅客编号创建 | Boolean | SyncPsgList | |
isCreateLoginUser | 是否创建登录账号,初始化创建账号则true | Boolean | SyncPsgList | |
isLeave | 调离职; true = 调为离职; false = 调为在职 | Boolean | SyncPsgList | |
Pwd | 密码,初始化账号的密码;建议 数字+字符+英文字母 8位以上 | String | SyncPsgList | |
PassengerInfo | 旅客信息 | PassengerInfo | SyncPsgList | |
uatpCardNameList | uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | SyncPsgList.PassengerInfo | |
uatpCardNumberList | uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | SyncPsgList.PassengerInfo | |
passengerJruisdictions | 拥有的权限列表(根据passengerJruisdictionType决定) | Array[] | SyncPsgList.PassengerInfo | |
passengerJruisdictionType | passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理 | Integer | SyncPsgList.PassengerInfo | |
outsidePassengerId | 对接方系统的旅客编号 | String | SyncPsgList.PassengerInfo | |
passengerName | 乘机人姓名 | String | SyncPsgList.PassengerInfo | |
passengerType | 旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿) | String | SyncPsgList.PassengerInfo | |
companyId | 公司编号 | String | SyncPsgList.PassengerInfo | |
sex | 必传 性别:男/女;不能传其他字符 | String | SyncPsgList.PassengerInfo | |
cnName | 中文姓名(中文姓名、英文姓名2选一) | String | SyncPsgList.PassengerInfo | |
enName | 英文姓名(中文姓名、英文姓名2选一,格式:zhang/san) | String | SyncPsgList.PassengerInfo | |
userName | 登录用户名 | String | SyncPsgList.PassengerInfo | |
dName | 部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | SyncPsgList.PassengerInfo | |
nationality | 国籍:中国填写 CN,必传 | String | SyncPsgList.PassengerInfo | |
birthday | 出生日期(yyyy-MM-dd)必传 | String | SyncPsgList.PassengerInfo | |
mobile | 手机号码 | String | SyncPsgList.PassengerInfo | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | SyncPsgList.PassengerInfo | |
电子邮箱 | String | SyncPsgList.PassengerInfo | ||
holderId | 职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值 | String | SyncPsgList.PassengerInfo | |
postID | 职位ID | String | SyncPsgList.PassengerInfo | |
SuperVip | 0:非VIP 1VIP | Integer | SyncPsgList.PassengerInfo | |
phone | 固定电话 | String | SyncPsgList.PassengerInfo | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | SyncPsgList.PassengerInfo | |
CostList | 成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可 | Array[] | SyncPsgList.PassengerInfo | |
costCenterName | 成本中心名称 | String | SyncPsgList.PassengerInfo.CostList | |
certificatePhoto | 证件图片信息(只有国际机票使用,其他产品传null 或者不处理) | CertificatePhoto | SyncPsgList.PassengerInfo | |
fileName | 文件名称 | String | SyncPsgList.PassengerInfo.certificatePhoto | |
fileCode | 文件流 | String | SyncPsgList.PassengerInfo.certificatePhoto | |
frequentTraveller | 常旅卡信息 | FrequentTraveller | SyncPsgList.PassengerInfo | |
airlineCode | 航司二字码 | String | SyncPsgList.PassengerInfo.frequentTraveller | |
cardName | 常旅卡名称 | String | SyncPsgList.PassengerInfo.frequentTraveller | |
cardNumber | 常旅卡号 | String | SyncPsgList.PassengerInfo.frequentTraveller | |
certificatesList | 证件 | Array[] | SyncPsgList.PassengerInfo | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | SyncPsgList.PassengerInfo.certificatesList | |
certNumber | 证件号码 | String | SyncPsgList.PassengerInfo.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | SyncPsgList.PassengerInfo.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | SyncPsgList.PassengerInfo.certificatesList |
{
"SyncPsgList":
[{
"isCreateLoginDefault":true, //如果账号重复,默认false-提示重复,true-不提示重复直接按美亚默认旅客编号创建
"isCreateLoginUser":true, //是否创建登录账号,初始化创建账号则true
"isLeave":false, //调离职; true = 调为离职; false = 调为在职
"Pwd":"1258!abeh", //密码,初始化账号的密码;建议 数字+字符+英文字母 8位以上
"PassengerInfo":
{
"uatpCardNameList":"null", //uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理)
"uatpCardNumberList":"null", //uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理)
"passengerJruisdictions":"null", //拥有的权限列表(根据passengerJruisdictionType决定)
"passengerJruisdictionType":0, //passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理
"outsidePassengerId":"ak10002", //对接方系统的旅客编号
"passengerName":"刘展超", //乘机人姓名
"passengerType":"成人", //旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿)
"companyId":"S118022", //公司编号
"sex":"男", //必传 性别:男/女;不能传其他字符
"cnName":"刘展超", //中文姓名(中文姓名、英文姓名2选一)
"enName":"liu/zhanchao", //英文姓名(中文姓名、英文姓名2选一,格式:zhang/san)
"userName":"AK_liuzhanchao", //登录用户名
"dName":"美亚集团/旅游产品部/运营中心", //部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"nationality":"CN", //国籍:中国填写 CN,必传
"birthday":"2000-01-20", //出生日期(yyyy-MM-dd)必传
"mobile":"18628535565", //手机号码
"mobileAreaCode":"556", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"CostList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件
"holderId":"M1", //职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值
"postID":"一厂经理", //职位ID
"SuperVip":0, //0:非VIP 1VIP
"phone":"020-82862903", //固定电话
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
"frequentTraveller":
{
"airlineCode":"MU", //航司二字码
"cardName":"东方明珠积分卡", //常旅卡名称
"cardNumber":"7894587775", //常旅卡号
}, //常旅卡信息
"certificatePhoto":
{
"fileName":"我的证件.jpg", //文件名称
"fileCode":"ADWHIFHWFJJSFJWFJ...", //文件流
}, //证件图片信息(只有国际机票使用,其他产品传null 或者不处理)
}, //旅客信息
}], //旅客
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
userInfoList | 用户列表 | Array[] | ||
sessionId | 用户回话ID | String | userInfoList | |
companyId | 公司编号 | String | userInfoList | |
userId | 登录人ID | String | userInfoList | |
userName | 登录用户名 | String | userInfoList | |
password | 用户密码 | String | userInfoList | |
DId | 部门编号 | Integer | userInfoList | |
DepName | 部门名称 | String | userInfoList | |
OutsidePassengerId | 外部旅客编号 | String | userInfoList |
{
"userInfoList":
[{
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //用户回话ID
"companyId":"S118022", //公司编号
"userId":"P258456", //登录人ID
"userName":"ak_LiuZhanChao", //登录用户名
"password": "", //用户密码
"DId":100086, //部门编号
"DepName":"研发中心", //部门名称
"OutsidePassengerId":"ak10002", //外部旅客编号
}], //用户列表
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
同步旅客信息(新版),优点:中途旅客信息异常不中断,可以详细返回哪个旅客同步成功,哪个旅客同步失败,并列明失败旅客的原因;
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
sessionId | sessionId,login接口返回 | String | 是 | |
SyncPsgList | 旅客 | Array[] | 是 | |
isCreateLoginDefault | 如果账号重复,默认false-提示重复,true-不提示重复直接按美亚默认旅客编号创建 | Boolean | SyncPsgList | |
isCreateLoginUser | 是否创建登录账号,初始化创建账号则true | Boolean | SyncPsgList | |
isLeave | 调离职; true = 调为离职; false = 调为在职 | Boolean | SyncPsgList | |
Pwd | 密码,初始化账号的密码;建议 数字+字符+英文字母 8位以上 | String | SyncPsgList | |
PassengerInfo | 旅客信息 | PassengerInfo | SyncPsgList | |
uatpCardNameList | uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | SyncPsgList.PassengerInfo | |
uatpCardNumberList | uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | SyncPsgList.PassengerInfo | |
passengerJruisdictions | 拥有的权限列表(根据passengerJruisdictionType决定) | Array[] | SyncPsgList.PassengerInfo | |
passengerJruisdictionType | passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理 | Integer | SyncPsgList.PassengerInfo | |
outsidePassengerId | 对接方系统的旅客编号 | String | SyncPsgList.PassengerInfo | |
passengerId | 美亚旅客编号(不用传) | String | SyncPsgList.PassengerInfo | |
passengerName | 乘机人姓名 | String | SyncPsgList.PassengerInfo | |
passengerType | 旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿) | String | SyncPsgList.PassengerInfo | |
companyId | 公司编号 | String | SyncPsgList.PassengerInfo | |
sex | 必传 性别:男/女;不能传其他字符 | String | SyncPsgList.PassengerInfo | |
cnName | 中文姓名(中文姓名、英文姓名2选一) | String | SyncPsgList.PassengerInfo | |
enName | 英文姓名(中文姓名、英文姓名2选一,格式:zhang/san) | String | SyncPsgList.PassengerInfo | |
userName | 登录用户名 | String | SyncPsgList.PassengerInfo | |
dName | 部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | SyncPsgList.PassengerInfo | |
nationality | 国籍:中国填写 CN,必传 | String | SyncPsgList.PassengerInfo | |
birthday | 出生日期(yyyy-MM-dd)必传 | String | SyncPsgList.PassengerInfo | |
mobile | 手机号码 | String | SyncPsgList.PassengerInfo | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | SyncPsgList.PassengerInfo | |
电子邮箱 | String | SyncPsgList.PassengerInfo | ||
holderId | 职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值 | String | SyncPsgList.PassengerInfo | |
postID | 职位ID | String | SyncPsgList.PassengerInfo | |
SuperVip | 0:非VIP 1VIP | Integer | SyncPsgList.PassengerInfo | |
phone | 固定电话 | String | SyncPsgList.PassengerInfo | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | SyncPsgList.PassengerInfo | |
CostList | 成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可 | Array[] | SyncPsgList.PassengerInfo | |
costCenterName | 成本中心名称 | String | SyncPsgList.PassengerInfo.CostList | |
certificatePhoto | 证件图片信息(只有国际机票使用,其他产品传null 或者不处理) | CertificatePhoto | SyncPsgList.PassengerInfo | |
fileName | 文件名称 | String | SyncPsgList.PassengerInfo.certificatePhoto | |
fileCode | 文件流 | String | SyncPsgList.PassengerInfo.certificatePhoto | |
frequentTraveller | 常旅卡信息 | FrequentTraveller | SyncPsgList.PassengerInfo | |
airlineCode | 航司二字码 | String | SyncPsgList.PassengerInfo.frequentTraveller | |
cardName | 常旅卡名称 | String | SyncPsgList.PassengerInfo.frequentTraveller | |
cardNumber | 常旅卡号 | String | SyncPsgList.PassengerInfo.frequentTraveller | |
certificatesList | 证件 | Array[] | SyncPsgList.PassengerInfo | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | SyncPsgList.PassengerInfo.certificatesList | |
certNumber | 证件号码 | String | SyncPsgList.PassengerInfo.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | SyncPsgList.PassengerInfo.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | SyncPsgList.PassengerInfo.certificatesList |
{
"SyncPsgList":
[{
"isCreateLoginDefault":true, //如果账号重复,默认false-提示重复,true-不提示重复直接按美亚默认旅客编号创建
"isCreateLoginUser":true, //是否创建登录账号,初始化创建账号则true
"isLeave":false, //调离职; true = 调为离职; false = 调为在职
"Pwd":"1258!abeh", //密码,初始化账号的密码;建议 数字+字符+英文字母 8位以上
"PassengerInfo":
{
"uatpCardNameList":"null", //uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理)
"uatpCardNumberList":"null", //uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理)
"passengerJruisdictions":"null", //拥有的权限列表(根据passengerJruisdictionType决定)
"passengerJruisdictionType":0, //passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理
"outsidePassengerId":"ak10002", //对接方系统的旅客编号
"passengerId": "", //美亚旅客编号(不用传)
"passengerName":"刘展超", //乘机人姓名
"passengerType":"成人", //旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿)
"companyId":"S118022", //公司编号
"sex":"男", //必传 性别:男/女;不能传其他字符
"cnName":"刘展超", //中文姓名(中文姓名、英文姓名2选一)
"enName":"liu/zhanchao", //英文姓名(中文姓名、英文姓名2选一,格式:zhang/san)
"userName":"AK_liuzhanchao", //登录用户名
"dName":"美亚集团/旅游产品部/运营中心", //部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"nationality":"CN", //国籍:中国填写 CN,必传
"birthday":"2000-01-20", //出生日期(yyyy-MM-dd)必传
"mobile":"18628535565", //手机号码
"mobileAreaCode":"556", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"CostList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件
"holderId":"M1", //职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值
"postID":"一厂经理", //职位ID
"SuperVip":0, //0:非VIP 1VIP
"phone":"020-82862903", //固定电话
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
"frequentTraveller":
{
"airlineCode":"MU", //航司二字码
"cardName":"东方明珠积分卡", //常旅卡名称
"cardNumber":"7894587775", //常旅卡号
}, //常旅卡信息
"certificatePhoto":
{
"fileName":"我的证件.jpg", //文件名称
"fileCode":"ADWHIFHWFJJSFJWFJ...", //文件流
}, //证件图片信息(只有国际机票使用,其他产品传null 或者不处理)
}, //旅客信息
}], //旅客
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
failList | 用户失败列表 | Array[] | ||
description | 错误描述 | String | failList | |
companyId | 公司编号 | String | failList | |
passengerName | 旅客姓名 | String | failList | |
outsidePassengerId | 外部旅客编号 | String | failList | |
userInfoList | 用户成功列表 | Array[] | ||
sessionId | 用户回话ID | String | userInfoList | |
companyId | 公司编号 | String | userInfoList | |
userId | 登录人ID | String | userInfoList | |
userName | 登录用户名 | String | userInfoList | |
password | 用户密码 | String | userInfoList | |
DId | 部门编号 | Integer | userInfoList | |
DepName | 部门名称 | String | userInfoList | |
OutsidePassengerId | 外部旅客编号 | String | userInfoList |
{
"userInfoList":
[{
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //用户回话ID
"companyId":"S118022", //公司编号
"userId":"P258456", //登录人ID
"userName":"ak_LiuZhanChao", //登录用户名
"password": "", //用户密码
"DId":100086, //部门编号
"DepName":"研发中心", //部门名称
"OutsidePassengerId":"ak10002", //外部旅客编号
}], //用户成功列表
"failList":
[{
"description":"旅客英文名格式不正确,请修正", //错误描述
"companyId":"S118022", //公司编号
"passengerName":"刘展超", //旅客姓名
"outsidePassengerId":"ak10002", //外部旅客编号
}], //用户失败列表
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
根据订单号查询订单状态
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚美亚订单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB230000261", //美亚美亚订单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 订单号 | String | ||
orderStatusName | 订单状态名称 | String | ||
orderStatusCode | 订单状态代码 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo": "", //订单号
"orderStatusName": "", //订单状态名称
"orderStatusCode":0, //订单状态代码
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
旧接口,目前无使用场景
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
sessionId | sessionId,login接口返回 | String | 是 |
{
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
RoleList | Array[] | |||
ID | Integer | RoleList | ||
RoleID | String | RoleList | ||
RoleName | String | RoleList | ||
Remark | String | RoleList |
{
"RoleList":
[{
"ID":0, //
"RoleID": "", //
"RoleName": "", //
"Remark": "", //
}], //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
旧接口,目前无使用场景
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
type | 字典类型 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"type": "", //字典类型
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
dictionaryList | 返回结果 | Array[] | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"dictionaryList":
[{
}], //返回结果
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
同步审批人信息,支持按旅客审批 或 按成本中心审批,按旅客审批示范:A旅客国内机票订单一审节点,审批人有:B、C、D三人;其中被审批人和审批人信息都必须用SyncPsgInfoNew接口先同步到美亚系统,该接口不处理旅客同步信息,只处理审批人信息,另外outsidePassengerId是识别旅客唯一的标识必须和同步旅客的唯一值一致;按成本中心审批:先用SyncCostCenter批量同步成本中心名称,注意请求参数中outsidePassengerId被审批人外部成本中心编号必填,approverList对应可审批人信息
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsidePassengerId | 被审批人的外部旅客编号、外部成本中心编号 | String | 是 | |
outsidePassengerName | 被审批人的外部旅客姓名、成本中心名称 | String | 是 | |
approverType | 审批类型 默认是1:按旅客审批 2:按成本中心审批 | Integer | 是 | |
type | 传参标识,同一集团下外部旅客编号唯一,传groupApprove 否则传companyApprove | String | 是 | |
approverCompanyId | 被审批人公司ID,同一集团下外部旅客编号唯一可不传 | String | 是 | |
compulsoryApprove | 是否强制审批,强制传1 默认0为不强制审批 | Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
approverList | 审批人列表 | Array[] | 是 | |
orderType | 订单类型 1:国内机票订购单 2:国内机票变更单 3:国内机票退订单 11:国际机票订购单 12:国际机票变更单 13:国际机票退订单 5:国内酒店订购单 6:国内酒店退订单 15:国际酒店订购单 70:火车票订购单 80:火车票退订单 90:火车票改签单 40:保险单 45:保险退单 | Integer | approverList | |
approveKey | 审批标识,传入:一审、二审、三审、四审 | String | approverList | |
outsidePassengerId | 审批人的外部旅客编号 | String | approverList | |
outsidePassengerName | 审批人的外部旅客姓名 | String | approverList | |
cApprover | 创建或者删除审批人 传 0 创建 ;传 1 删除 | Integer | approverList | |
remark | 备注,用于返回失败原因 | String | approverList | |
companyId | 审批人公司ID,同一集团下外部旅客编号唯一可不传 | String | approverList |
{
"outsidePassengerId":"ak10002", //被审批人的外部旅客编号、外部成本中心编号
"outsidePassengerName":"刘展强", //被审批人的外部旅客姓名、成本中心名称
"approverList":
[{
"orderType":1, //订单类型
1:国内机票订购单 2:国内机票变更单 3:国内机票退订单
11:国际机票订购单 12:国际机票变更单 13:国际机票退订单
5:国内酒店订购单 6:国内酒店退订单
15:国际酒店订购单
70:火车票订购单 80:火车票退订单 90:火车票改签单
40:保险单 45:保险退单
"approveKey":"一审", //审批标识,传入:一审、二审、三审、四审
"outsidePassengerId":"ak8520", //审批人的外部旅客编号
"outsidePassengerName":"张杭州", //审批人的外部旅客姓名
"cApprover":0, //创建或者删除审批人 传 0 创建 ;传 1 删除
"remark":"异常:S118022未设置审批流程", //备注,用于返回失败原因
"companyId":"S118022", //审批人公司ID,同一集团下外部旅客编号唯一可不传
}], //审批人列表
"approverType":1, //审批类型 默认是1:按旅客审批 2:按成本中心审批
"type":"companyApprove", //传参标识,同一集团下外部旅客编号唯一,传groupApprove 否则传companyApprove
"approverCompanyId":"S118022", //被审批人公司ID,同一集团下外部旅客编号唯一可不传
"compulsoryApprove":0, //是否强制审批,强制传1 默认0为不强制审批
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
data | 同步审批人返回数据 | SyncAooroverAll | ||
outsidePassengerId | 被审批人的外部旅客编号 | String | data | |
outsidePassengerName | 被审批人的外部旅客姓名 | String | data | |
failList | 审批人失败列表 | Array[] | data | |
orderType | 订单类型 1:国内机票订购单 2:国内机票变更单 3:国内机票退订单 11:国际机票订购单 12:国际机票变更单 13:国际机票退订单 5:国内酒店订购单 6:国内酒店退订单 15:国际酒店订购单 70:火车票订购单 80:火车票退订单 90:火车票改签单 40:保险单 45:保险退单 | Integer | data.failList | |
approveKey | 审批标识,传入:一审、二审、三审、四审 | String | data.failList | |
outsidePassengerId | 审批人的外部旅客编号 | String | data.failList | |
outsidePassengerName | 审批人的外部旅客姓名 | String | data.failList | |
cApprover | 创建或者删除审批人 传 0 创建 ;传 1 删除 | Integer | data.failList | |
remark | 备注,用于返回失败原因 | String | data.failList | |
companyId | 审批人公司ID,同一集团下外部旅客编号唯一可不传 | String | data.failList |
{
"data":
{
"outsidePassengerId":"ak10002", //被审批人的外部旅客编号
"outsidePassengerName":"刘展强", //被审批人的外部旅客姓名
"failList":
[{
"orderType":1, //订单类型
1:国内机票订购单 2:国内机票变更单 3:国内机票退订单
11:国际机票订购单 12:国际机票变更单 13:国际机票退订单
5:国内酒店订购单 6:国内酒店退订单
15:国际酒店订购单
70:火车票订购单 80:火车票退订单 90:火车票改签单
40:保险单 45:保险退单
"approveKey":"一审", //审批标识,传入:一审、二审、三审、四审
"outsidePassengerId":"ak8520", //审批人的外部旅客编号
"outsidePassengerName":"张杭州", //审批人的外部旅客姓名
"cApprover":0, //创建或者删除审批人 传 0 创建 ;传 1 删除
"remark":"异常:S118022未设置审批流程", //备注,用于返回失败原因
"companyId":"S118022", //审批人公司ID,同一集团下外部旅客编号唯一可不传
}], //审批人失败列表
}, //同步审批人返回数据
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
批量同步成本中心,costCenterList成本中心名称,costCenterOutsidePidList 成本中心外部编码, 注意 1:必须格式: 美亚集团/美亚技术部门/研发部成本中心 全链条格式同步 2:必须每个节点的名称必须是这层级唯一的,比如:美亚技术部门 和 美亚技术 会判定为不是一个部门,必须全字符唯一;如果使用外部编码,如 p1/p2/p3,外部编码的层级要与成本中心名称的层级完全匹配。
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
costCenterList | 成本中心名称list,格式: 美亚集团/美亚技术部门/研发部成本中心 | Array[] | 是 | |
costCenterOutsidePidList | 成本中心外部编码list,(成本中心名称list一一对应的外部编码)格式: P1/P2/P3 | Array[] | 否 | |
type | 0-启用,默认; 1-禁用; | Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"costCenterList":"[‘美亚集团/美亚技术部门/研发部成本中心’,‘美亚集团/美亚技术部门/客服中心’]", //成本中心名称list,格式: 美亚集团/美亚技术部门/研发部成本中心
"costCenterOutsidePidList":"[‘meiya/jsb/yfb’,‘P1/P2/P3’]", //成本中心外部编码list,(成本中心名称list一一对应的外部编码)格式: P1/P2/P3
"type":0, //0-启用,默认; 1-禁用;
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
sessionId | sessionId,login接口返回 | String | 是 |
{
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
departmentList | Array[] | |||
companyId | 公司ID | String | departmentList | |
parentID | 上层ID | String | departmentList | |
departmentID | 部门ID | String | departmentList | |
departmentName | 部门名称 | String | departmentList | |
status | 状态 | Integer | departmentList |
{
"departmentList":
[{
"companyId": "", //公司ID
"parentID": "", //上层ID
"departmentID": "", //部门ID
"departmentName": "", //部门名称
"status":0, //状态
}], //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
根据产品类型,获取对应的基础城市数据,1-国内机票,2-国际机票,3-国内酒店,4-国际酒店(未启用),5-火车票
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
cityType | 城市数据类型,1-国内机票,2-国际机票,3-国内酒店,4-国际酒店(未启用),5-火车票 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"cityType":"1", //城市数据类型,1-国内机票,2-国际机票,3-国内酒店,4-国际酒店(未启用),5-火车票
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
cityList | 城市数据集合 | Array[] | ||
py | 拼音 | String | cityList | |
cn | 城市中文名称 | String | cityList | |
cityCode | 城市三字码 | String | cityList | |
en | 城市英文名称 | String | cityList | |
stateName | 省/州中文名 | String | cityList | |
countryName | 国家中文名 | String | cityList | |
code | 机场三字码 | String | cityList | |
airportCnName | 机场中文名称 | String | cityList | |
airportEgName | 机场英文名称 | String | cityList | |
stationName | 站点名称(火车票的) | String | cityList | |
dataDistrictName | 关联的区县名称(酒店的数据) | String | cityList | |
dataDistrictAreaCode | 关联的区县行政代码(酒店的数据) | String | cityList | |
cityType | 0默认值,1直辖市、2地级市、3县级市、4行政区(酒店的数据,非酒店数据都默认0) | Integer | cityList | |
dataCityName | 关联的城市名称(酒店的数据) | String | cityList | |
dataCityCode | 关联的城市三字码(酒店的数据) | String | cityList |
{
"cityList":
[{
"py":"GuangZhou", //拼音
"cn":"广州", //城市中文名称
"cityCode":"CAN", //城市三字码
"en":"GuangZhou", //城市英文名称
"stateName":"广东", //省/州中文名
"countryName":"中国", //国家中文名
"code":"CAN", //机场三字码
"airportCnName":"白云国际机场", //机场中文名称
"airportEgName":"baiyunguojijichang", //机场英文名称
"stationName": "", //站点名称(火车票的)
"dataDistrictName": "", //关联的区县名称(酒店的数据)
"dataDistrictAreaCode": "", //关联的区县行政代码(酒店的数据)
"cityType":0, //0默认值,1直辖市、2地级市、3县级市、4行政区(酒店的数据,非酒店数据都默认0)
"dataCityName": "", //关联的城市名称(酒店的数据)
"dataCityCode": "", //关联的城市三字码(酒店的数据)
}], //城市数据集合
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
航变动态查询
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
flightNo | 航班号:非必填 | String | 否 | |
originalFlightNo | 原航班号:非必填 | String | 否 | |
originAirportCode | 始发地机场三字码:非必填 | String | 否 | |
destinationAirportCode | 目的地机场三字码:非必填 | String | 否 | |
departureDateTime | 查询范围开始日期:非必填 | String | 否 | |
departureDateTo | 查询范围结束日期 | String | 否 | |
flightChangeType | 航变类型:0-所有 1、计划 2、起飞 3、延误 4、变更 5、取消 | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"flightNo": "", //航班号:非必填
"originalFlightNo": "", //原航班号:非必填
"originAirportCode": "", //始发地机场三字码:非必填
"destinationAirportCode":"SHA", //目的地机场三字码:非必填
"departureDateTime":"2023-10-23", //查询范围开始日期:非必填
"departureDateTo":"2023-10-23", //查询范围结束日期
"flightChangeType":0, //航变类型:0-所有 1、计划 2、起飞 3、延误 4、变更 5、取消
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
flightChangeNoticeList | 航变信息List | Array[] | ||
orderNo | 订单号 | String | flightChangeNoticeList | |
originCityName | 始发城市 | String | flightChangeNoticeList | |
destinationCityName | 到达城市 | String | flightChangeNoticeList | |
originAirportName | 始发地机场名称 | String | flightChangeNoticeList | |
destinationAirportName | 目的地机场名称 | String | flightChangeNoticeList | |
originAirportCode | 始发地机场三字码 | String | flightChangeNoticeList | |
destinationAirportCode | 目的地机场三字码 | String | flightChangeNoticeList | |
depTerminal | 出发航站楼 | String | flightChangeNoticeList | |
arrTerminal | 目的地航站楼(不详时传 --) | String | flightChangeNoticeList | |
originalFlightNo | 原航班号 必填,如果航变类型不是“变更-航班号”时,取航班动态数据库中【航班号】;如果是“变更-航班号”,取【原航班号】 | String | flightChangeNoticeList | |
departureDateTime | 原计划起飞时间:必填,格式:日期+时间 | String | flightChangeNoticeList | |
arrivalDateTime | 原计划到达时间:必填,格式:日期+时间 | String | flightChangeNoticeList | |
flightChangeType | 航变类型 | String | flightChangeNoticeList | |
newFlightNo | (新)航班号 | String | flightChangeNoticeList | |
newDepartureDateTime | 新航班,预计起飞时间:必填,格式:日期+时间 | String | flightChangeNoticeList | |
newArrivalDateTime | 新航班,预计到达时间:必填,格式:日期+时间 | String | flightChangeNoticeList | |
newOriginAirportCode | 始发地机场三字码 | String | flightChangeNoticeList | |
newDestinationAirportCode | 目的地机场三字码 | String | flightChangeNoticeList | |
newDepTerminal | 出发航站楼 | String | flightChangeNoticeList | |
newArrTerminal | 目的地航站楼(不详时传 --) | String | flightChangeNoticeList | |
noticeDateTime | 航班变动时间:取【消息推送时间】 | String | flightChangeNoticeList |
{
"flightChangeNoticeList":
[{
"orderNo": "", //订单号
"originCityName":"北京", //始发城市
"destinationCityName":"广州", //到达城市
"originAirportName":"首都国际机场", //始发地机场名称
"destinationAirportName":"白云国际机场", //目的地机场名称
"originAirportCode":"PEK", //始发地机场三字码
"destinationAirportCode":"CAN", //目的地机场三字码
"depTerminal":"T3", //出发航站楼
"arrTerminal":"T1", //目的地航站楼(不详时传 --)
"originalFlightNo":"CA1301", //原航班号 必填,如果航变类型不是“变更-航班号”时,取航班动态数据库中【航班号】;如果是“变更-航班号”,取【原航班号】
"departureDateTime":"2023-10-23 15:00:00", //原计划起飞时间:必填,格式:日期+时间
"arrivalDateTime":"2023-10-23 18:20:00", //原计划到达时间:必填,格式:日期+时间
"flightChangeType":"起飞", //航变类型
"newFlightNo":"CA1301", //(新)航班号
"newDepartureDateTime":"2023-10-23 15:00:00", //新航班,预计起飞时间:必填,格式:日期+时间
"newArrivalDateTime":"2023-10-23 18:10:00", //新航班,预计到达时间:必填,格式:日期+时间
"newOriginAirportCode":"PEK", //始发地机场三字码
"newDestinationAirportCode":"CAN", //目的地机场三字码
"newDepTerminal": "", //出发航站楼
"newArrTerminal": "", //目的地航站楼(不详时传 --)
"noticeDateTime":"2023/10/23 15:38:09", //航班变动时间:取【消息推送时间】
}], //航变信息List
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
同步出差单,outsideOrderNo外部出差单号必须唯一,该接口包含了同步旅客信息,同步出差单成功即包含同步旅客信息成功。 status=4目前只支持生效中出差单,并且同步成功后无法修改该出差单信息。costList、applyPlanList等list对象,如无业务需要,则不处理或者costList=null,不要costList=[]传值 。
departureCityCode>departureCity ; arrivalCityCode>arrivalCity 如果传入的departureCityCode/arrivalCityCode在系统中没有;但传入的departureCity/arrivalCity存在,系统仍然会识别。
出差单对接流程参考:出差单流程
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsideOrderNo | 客户出差申请单号,必须唯一 | String | 是 | |
beginDate | 出差开始时间:yyyy-MM-dd 【大概预算出差时间,不做具体校验,但必须传值】 | String | 是 | |
endDate | 出差结束时间:yyyy-MM-dd【大概预算出差时间,不做具体校验,但必须传值】 | String | 是 | |
purpose | 出差事由和目的 | String | 否 | |
status | 0-草稿单,2-草稿单(退回),3-审批,4-生效,8-取消,9-结束(对接过来的出差申请单都要传4),目前对接客户只支持修改8,9 | Integer | 是 | |
tripType | 行程类型 0 国内,1国际 | Integer | 是 | |
c_TextField_2401 | 客户自定义字段1 | String | 否 | |
c_TextField_2402 | 客户自定义字段2 | String | 否 | |
c_TextField_2403 | 客户自定义字段3 | String | 否 | |
c_TextField_2404 | 客户自定义字段4 | String | 否 | |
c_TextField_2405 | 客户自定义字段5 | String | 否 | |
c_TextField_2406 | 客户自定义字段6 | String | 否 | |
c_TextField_2407 | 客户自定义字段7 | String | 否 | |
c_TextField_2408 | 客户自定义字段8 | String | 否 | |
sessionId |
sessionId,login接口返回
制单人sessiondid有效登录 出差申请单的sessionId 一定要用applyPassengerInfo 里的旅客工号登录获取的sessionId |
String | 是 | |
costList | 出差申请成本中心,对接默认都传null | Array[] | 否 | |
costCenterName | 成本中心名称 | String | costList | |
applyPlanList | 拜访计划 | Array[] | 否 | |
visitUnit | 拜访单位 | String | applyPlanList | |
visitMan | 拜访人 | String | applyPlanList | |
visitTimeBegin | 拜访开始时间 | String | applyPlanList | |
visitTimeEnd | 拜访结束时间 | String | applyPlanList | |
unitAddress | 单位地址 | String | applyPlanList | |
applyPassengerInfo | 制单人或出差填单人 | PassengerInfo2 | 是 | |
companyId | 公司编号 | String | applyPassengerInfo | |
staffCode | 员工工号,外部系统识别旅客唯一的编码 | String | applyPassengerInfo | |
cnName | 中文名,不支持带特殊字符的名字,比如:玛丽.沙利亚(cnName,enName 其中一项必填) | String | applyPassengerInfo | |
enName | 英文名,格式 liu/zhanchao(cnName,enName 其中一项必填) | String | applyPassengerInfo | |
sex | 性别:男/女 | String | applyPassengerInfo | |
birthday | 出生日期(yyyy-MM-dd) | String | applyPassengerInfo | |
nationality | 国籍:中国:CN | String | applyPassengerInfo | |
mobile | 手机号码 | String | applyPassengerInfo | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | applyPassengerInfo | |
电子邮箱 | String | applyPassengerInfo | ||
passengerType | 旅客类型:成人/儿童 | String | applyPassengerInfo | |
holderId | 职称ID,需要和美亚职级先做映射,没有则不传 | String | applyPassengerInfo | |
dName | 部门名称【不传则不更新原值】,多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | applyPassengerInfo | |
costCenterID | 员工成本中心,传成本中心名称或者代码均可;数据结构类似部门 | String | applyPassengerInfo | |
postID | 职位ID | String | applyPassengerInfo | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | applyPassengerInfo | |
policyDict | 差旅政策, key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6, value : policyID,没有可不传 | Array[] | applyPassengerInfo | |
Value | 美亚政策编号,客户方需要做好美亚政策和客户系统政策的映射; | String | applyPassengerInfo.policyDict | |
Key | key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6 | Integer | applyPassengerInfo.policyDict | |
certificatesList | 证件,【没有证件可以传null】,证件字段里重复的是文档问题,不用处理 | Array[] | applyPassengerInfo | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | applyPassengerInfo.certificatesList | |
certNumber | 证件号码 | String | applyPassengerInfo.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | applyPassengerInfo.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | applyPassengerInfo.certificatesList | |
authorizerList | 授权人 最多50个 | Array[] | 否 | |
companyId | 公司编号 | String | authorizerList | |
staffCode | 员工工号,外部系统识别旅客唯一的编码 | String | authorizerList | |
cnName | 中文名,不支持带特殊字符的名字,比如:玛丽.沙利亚(cnName,enName 其中一项必填) | String | authorizerList | |
enName | 英文名,格式 liu/zhanchao(cnName,enName 其中一项必填) | String | authorizerList | |
sex | 性别:男/女 | String | authorizerList | |
birthday | 出生日期(yyyy-MM-dd) | String | authorizerList | |
nationality | 国籍:中国:CN | String | authorizerList | |
mobile | 手机号码 | String | authorizerList | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | authorizerList | |
电子邮箱 | String | authorizerList | ||
passengerType | 旅客类型:成人/儿童 | String | authorizerList | |
holderId | 职称ID,需要和美亚职级先做映射,没有则不传 | String | authorizerList | |
dName | 部门名称【不传则不更新原值】,多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | authorizerList | |
costCenterID | 员工成本中心,传成本中心名称或者代码均可;数据结构类似部门 | String | authorizerList | |
postID | 职位ID | String | authorizerList | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | authorizerList | |
policyDict | 差旅政策, key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6, value : policyID,没有可不传 | Array[] | authorizerList | |
Value | 美亚政策编号,客户方需要做好美亚政策和客户系统政策的映射; | String | authorizerList.policyDict | |
Key | key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6 | Integer | authorizerList.policyDict | |
certificatesList | 证件,【没有证件可以传null】,证件字段里重复的是文档问题,不用处理 | Array[] | authorizerList | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | authorizerList.certificatesList | |
certNumber | 证件号码 | String | authorizerList.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | authorizerList.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | authorizerList.certificatesList | |
tripInfoList | 行程列表【List,多行程则传多个】 | Array[] | 是 | |
tripID | 行程ID,前缀加出差申请单ID | String | tripInfoList | |
departureCityCode | 始发城市编码 为旅客更好体验,建议优先使用美亚城市对,请查接口:GetCityAreaList 支持多个,多个城市之间用“,” 号隔开,并且城市编码与departureCity城市中文顺序要一致 | String | tripInfoList | |
departureCity | 始发城市 支持多个,多个城市之间用“,” 号隔开。 【当城市名称与城市编号同时存在时,优先取编号】 | String | tripInfoList | |
arrivalCityCode | 目的城市编码 为旅客更好体验,建议优先使用美亚城市对,请查接口:GetCityAreaList 支持多个,多个城市之间用“,” 号隔开,并且城市编码与arrivalCity城市中文顺序要一致 | String | tripInfoList | |
arrivalCity | 目的城市 支持多个,多个城市之间用“,” 号隔开。 【当城市名称与城市编号同时存在时,优先取编号】 | String | tripInfoList | |
startDay | 出发时间,实际出差跳转美亚查询机票、酒店、火车票时间 | String | tripInfoList | |
endDay | 到达时间,实际出差跳转美亚查询机票、酒店、火车票时间 | String | tripInfoList | |
isHotelForDepartureCity | 始发城市是否预订 国内酒店【必须true预订出发酒店按钮才显示】 | Boolean | tripInfoList | |
isHotelForArrivalCity | 目的城市是否预订 国内酒店【true时预订目的酒店按钮才显示】 | Boolean | tripInfoList | |
isIHotelForDepartureCity | 始发城市是否预订 国际酒店【true时预订目的酒店按钮才显示】 | Boolean | tripInfoList | |
isIHotelForArrivalCity | 目的城市是否预订 国际酒店【true时预订目的酒店按钮才显示】 | Boolean | tripInfoList | |
departCountry | 出发城市国籍编号(CN =中国)(国际酒店时必填) | String | tripInfoList | |
arrivalCountry | 到达城市国籍编号(CN =中国)(国际酒店时必填) | String | tripInfoList | |
isFlight | 机票预订按钮是否显示【true时预订机票按钮才显示】 | Boolean | tripInfoList | |
isTrain | 火车票预订按钮是否显示【true时预订机票按钮才显示】 | Boolean | tripInfoList | |
seatClass |
座位类别/舱等,只做快速查询过滤不做实际差标控制
机票 1,经济舱 2,公务舱 3,头等舱 4,豪华经济舱 5,公务舱及以下 6,头等舱及以下 7,豪华经济舱及以下 火车票 1,硬座 2,软座 3,硬卧 4,动卧 5,软卧 6,高级动卧 7,高级软卧 8,二等座 9,一等座 10,特等座 11,商务座 12,无座 13,一等卧 14,二等卧 15,优先一等座 |
String | tripInfoList | |
maxRoomPrice | 酒店最高可订价格,只做快速查询过滤不做实际差标控制 | Number | tripInfoList | |
tripType | 行程类型 0 国内,1国际(如果出差申请单为国内行程,则当前字段必须为国内行程(传值0)) | Integer | tripInfoList | |
reserveType | 预定类型1单程2往返 | String | tripInfoList | |
departureCityEnName | 出发地英文名(国际酒店产品预留使用,其他产品没有可以不传) | String | tripInfoList | |
departureCityProvinceName | 始发地所属省州名称(国际酒店产品预留使用,其他产品没有可以不传) | String | tripInfoList | |
arrivalCityEnName | 目的地英文名(国际酒店产品预留使用,其他产品没有可以不传) | String | tripInfoList | |
arrivalCityProvinceName | 目的地所属省州名称(国际酒店产品预留使用,其他产品没有可以不传) | String | tripInfoList | |
platformDepartureCity | 对接平台出发城市名称(国际酒店产品预留使用,其他产品没有可以不传) | String | tripInfoList | |
platformArrivalCity | 对接平台到达城市名称(国际酒店产品预留使用,其他产品没有可以不传) | String | tripInfoList | |
passengerInfoList | 旅客列表,国际机票产品同行程人数不可超过9人,系统不支持9人以上一起预订 | Array[] | tripInfoList | |
companyId | 公司编号 | String | tripInfoList.passengerInfoList | |
staffCode | 员工工号,外部系统识别旅客唯一的编码 | String | tripInfoList.passengerInfoList | |
cnName | 中文名,不支持带特殊字符的名字,比如:玛丽.沙利亚(cnName,enName 其中一项必填) | String | tripInfoList.passengerInfoList | |
enName | 英文名,格式 liu/zhanchao(cnName,enName 其中一项必填) | String | tripInfoList.passengerInfoList | |
sex | 性别:男/女 | String | tripInfoList.passengerInfoList | |
birthday | 出生日期(yyyy-MM-dd) | String | tripInfoList.passengerInfoList | |
nationality | 国籍:中国:CN | String | tripInfoList.passengerInfoList | |
mobile | 手机号码 | String | tripInfoList.passengerInfoList | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | tripInfoList.passengerInfoList | |
电子邮箱 | String | tripInfoList.passengerInfoList | ||
passengerType | 旅客类型:成人/儿童 | String | tripInfoList.passengerInfoList | |
holderId | 职称ID,需要和美亚职级先做映射,没有则不传 | String | tripInfoList.passengerInfoList | |
dName | 部门名称【不传则不更新原值】,多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | tripInfoList.passengerInfoList | |
costCenterID | 员工成本中心,传成本中心名称或者代码均可;数据结构类似部门 | String | tripInfoList.passengerInfoList | |
postID | 职位ID | String | tripInfoList.passengerInfoList | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | tripInfoList.passengerInfoList | |
policyDict | 差旅政策, key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6, value : policyID,没有可不传 | Array[] | tripInfoList.passengerInfoList | |
Value | 美亚政策编号,客户方需要做好美亚政策和客户系统政策的映射; | String | tripInfoList.passengerInfoList.policyDict | |
Key | key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6 | Integer | tripInfoList.passengerInfoList.policyDict | |
certificatesList | 证件,【没有证件可以传null】,证件字段里重复的是文档问题,不用处理 | Array[] | tripInfoList.passengerInfoList | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | tripInfoList.passengerInfoList.certificatesList | |
certNumber | 证件号码 | String | tripInfoList.passengerInfoList.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | tripInfoList.passengerInfoList.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | tripInfoList.passengerInfoList.certificatesList |
{
"outsideOrderNo":"CL202310160389", //客户出差申请单号,必须唯一
"applyPassengerInfo":
{
"companyId":"S118022", //公司编号
"staffCode":"ak10002", //员工工号,外部系统识别旅客唯一的编码
"cnName":"刘展超", //中文名,不支持带特殊字符的名字,比如:玛丽.沙利亚(cnName,enName 其中一项必填)
"enName":"liu/zhanchao", //英文名,格式 liu/zhanchao(cnName,enName 其中一项必填)
"sex":"男", //性别:男/女
"birthday":"1995-10-20", //出生日期(yyyy-MM-dd)
"nationality":"CN", //国籍:中国:CN
"mobile":"18625899912", //手机号码
"mobileAreaCode":"558", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"passengerType":"成人", //旅客类型:成人/儿童
"holderId":"所以在职人员", //职称ID,需要和美亚职级先做映射,没有则不传
"dName":"美亚集团/旅游产品部/运营中心", //部门名称【不传则不更新原值】,多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件,【没有证件可以传null】,证件字段里重复的是文档问题,不用处理
"policyDict":
[{
"Value":"ZC20190919002711", //美亚政策编号,客户方需要做好美亚政策和客户系统政策的映射;
"Key":1, //key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6
}], //差旅政策, key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6, value : policyID,没有可不传
"costCenterID":"美亚集团/旅游产品部/运营中心", //员工成本中心,传成本中心名称或者代码均可;数据结构类似部门
"postID": "", //职位ID
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
}, //制单人或出差填单人
"beginDate":"2023-10-16", //出差开始时间:yyyy-MM-dd 【大概预算出差时间,不做具体校验,但必须传值】
"endDate":"2023-10-18", //出差结束时间:yyyy-MM-dd【大概预算出差时间,不做具体校验,但必须传值】
"tripInfoList":
[{
"tripID":"CL202310160389-1", //行程ID,前缀加出差申请单ID
"passengerInfoList":
[{
"companyId":"S118022", //公司编号
"staffCode":"ak10002", //员工工号,外部系统识别旅客唯一的编码
"cnName":"刘展超", //中文名,不支持带特殊字符的名字,比如:玛丽.沙利亚(cnName,enName 其中一项必填)
"enName":"liu/zhanchao", //英文名,格式 liu/zhanchao(cnName,enName 其中一项必填)
"sex":"男", //性别:男/女
"birthday":"1995-10-20", //出生日期(yyyy-MM-dd)
"nationality":"CN", //国籍:中国:CN
"mobile":"18625899912", //手机号码
"mobileAreaCode":"558", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"passengerType":"成人", //旅客类型:成人/儿童
"holderId":"所以在职人员", //职称ID,需要和美亚职级先做映射,没有则不传
"dName":"美亚集团/旅游产品部/运营中心", //部门名称【不传则不更新原值】,多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件,【没有证件可以传null】,证件字段里重复的是文档问题,不用处理
"policyDict":
[{
"Value":"ZC20190919002711", //美亚政策编号,客户方需要做好美亚政策和客户系统政策的映射;
"Key":1, //key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6
}], //差旅政策, key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6, value : policyID,没有可不传
"costCenterID":"美亚集团/旅游产品部/运营中心", //员工成本中心,传成本中心名称或者代码均可;数据结构类似部门
"postID": "", //职位ID
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
}], //旅客列表,国际机票产品同行程人数不可超过9人,系统不支持9人以上一起预订
"departureCityCode":"SHA", //始发城市编码 为旅客更好体验,建议优先使用美亚城市对,请查接口:GetCityAreaList 支持多个,多个城市之间用“,” 号隔开,并且城市编码与departureCity城市中文顺序要一致
"departureCity":"上海", //始发城市 支持多个,多个城市之间用“,” 号隔开。
【当城市名称与城市编号同时存在时,优先取编号】
"arrivalCityCode":"BJS", //目的城市编码 为旅客更好体验,建议优先使用美亚城市对,请查接口:GetCityAreaList 支持多个,多个城市之间用“,” 号隔开,并且城市编码与arrivalCity城市中文顺序要一致
"arrivalCity":"北京", //目的城市 支持多个,多个城市之间用“,” 号隔开。
【当城市名称与城市编号同时存在时,优先取编号】
"startDay":"2023-10-16", //出发时间,实际出差跳转美亚查询机票、酒店、火车票时间
"endDay":"2023-10-18", //到达时间,实际出差跳转美亚查询机票、酒店、火车票时间
"isHotelForDepartureCity":true, //始发城市是否预订 国内酒店【必须true预订出发酒店按钮才显示】
"isHotelForArrivalCity":true, //目的城市是否预订 国内酒店【true时预订目的酒店按钮才显示】
"isIHotelForDepartureCity":true, //始发城市是否预订 国际酒店【true时预订目的酒店按钮才显示】
"isIHotelForArrivalCity":true, //目的城市是否预订 国际酒店【true时预订目的酒店按钮才显示】
"departCountry":"CN", //出发城市国籍编号(CN =中国)(国际酒店时必填)
"arrivalCountry":"CN", //到达城市国籍编号(CN =中国)(国际酒店时必填)
"isFlight":true, //机票预订按钮是否显示【true时预订机票按钮才显示】
"isTrain":true, //火车票预订按钮是否显示【true时预订机票按钮才显示】
"seatClass":"1", //座位类别/舱等,只做快速查询过滤不做实际差标控制
"maxRoomPrice":800, //酒店最高可订价格,只做快速查询过滤不做实际差标控制
"tripType":0, //行程类型 0 国内,1国际(如果出差申请单为国内行程,则当前字段必须为国内行程(传值0))
"reserveType":"1", //预定类型1单程2往返
"departureCityEnName": "", //出发地英文名(国际酒店产品预留使用,其他产品没有可以不传)
"departureCityProvinceName": "", //始发地所属省州名称(国际酒店产品预留使用,其他产品没有可以不传)
"arrivalCityEnName": "", //目的地英文名(国际酒店产品预留使用,其他产品没有可以不传)
"arrivalCityProvinceName": "", //目的地所属省州名称(国际酒店产品预留使用,其他产品没有可以不传)
"platformDepartureCity": "", //对接平台出发城市名称(国际酒店产品预留使用,其他产品没有可以不传)
"platformArrivalCity": "", //对接平台到达城市名称(国际酒店产品预留使用,其他产品没有可以不传)
}], //行程列表【List,多行程则传多个】
"purpose":"前往项目部,沟通对接施工", //出差事由和目的
"status":4, //0-草稿单,2-草稿单(退回),3-审批,4-生效,8-取消,9-结束(对接过来的出差申请单都要传4),目前对接客户只支持修改8,9
"costList":
[{
"costCenterName": "", //成本中心名称
}], //出差申请成本中心,对接默认都传null
"applyPlanList":
[{
"visitUnit":"美亚商旅科技有限公司", //拜访单位
"visitMan":"吴经理", //拜访人
"visitTimeBegin":"2023-10-16", //拜访开始时间
"visitTimeEnd":"2023-10-18", //拜访结束时间
"unitAddress":"广东省广州大道北520", //单位地址
}], //拜访计划
"tripType":0, //行程类型 0 国内,1国际
"authorizerList":
[{
"companyId":"S118022", //公司编号
"staffCode":"ak10002", //员工工号,外部系统识别旅客唯一的编码
"cnName":"刘展超", //中文名,不支持带特殊字符的名字,比如:玛丽.沙利亚(cnName,enName 其中一项必填)
"enName":"liu/zhanchao", //英文名,格式 liu/zhanchao(cnName,enName 其中一项必填)
"sex":"男", //性别:男/女
"birthday":"1995-10-20", //出生日期(yyyy-MM-dd)
"nationality":"CN", //国籍:中国:CN
"mobile":"18625899912", //手机号码
"mobileAreaCode":"558", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"passengerType":"成人", //旅客类型:成人/儿童
"holderId":"所以在职人员", //职称ID,需要和美亚职级先做映射,没有则不传
"dName":"美亚集团/旅游产品部/运营中心", //部门名称【不传则不更新原值】,多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件,【没有证件可以传null】,证件字段里重复的是文档问题,不用处理
"policyDict":
[{
"Value":"ZC20190919002711", //美亚政策编号,客户方需要做好美亚政策和客户系统政策的映射;
"Key":1, //key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6
}], //差旅政策, key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6, value : policyID,没有可不传
"costCenterID":"美亚集团/旅游产品部/运营中心", //员工成本中心,传成本中心名称或者代码均可;数据结构类似部门
"postID": "", //职位ID
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
}], //授权人 最多50个
"c_TextField_2401": "", //客户自定义字段1
"c_TextField_2402": "", //客户自定义字段2
"c_TextField_2403": "", //客户自定义字段3
"c_TextField_2404": "", //客户自定义字段4
"c_TextField_2405": "", //客户自定义字段5
"c_TextField_2406": "", //客户自定义字段6
"c_TextField_2407": "", //客户自定义字段7
"c_TextField_2408": "", //客户自定义字段8
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
stApplyOrderNo | 美亚出差申请单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"stApplyOrderNo":"EC230034854", //美亚出差申请单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
同步取消/废弃出差申请单,出差单号必须美亚出差单号
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
stApplyOrderNo | 美亚出差申请单号 | String | 是 | |
status |
接口操作对应的状态,注意:1、出差申请单如果是取消状态,不能恢复生效;2、出差申请单有订单的情况不能取消
4-生效 8-取消 9-结束 |
Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"stApplyOrderNo":"EC230034854", //美亚出差申请单号
"status":8, //接口操作对应的状态,注意:1、出差申请单如果是取消状态,不能恢复生效;2、出差申请单有订单的情况不能取消
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
出差单对接,获取区域城市基础数据,用于订机票、酒店锚点城市更精准
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
countryType | 国家类型: 1国内 2全部(含国内国际港澳台),不传默认返回1国内。 | Integer | 是 | |
cityAreaType | 行政区类型: 1地级市 2县级市 3自治县,不传默认返回1地级市。 | Integer | 是 | |
pageNum | 页数 默认1 | Integer | 是 | |
pageSize | 每页条数 默认100 | Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"countryType":1, //国家类型:
1国内 2全部(含国内国际港澳台),不传默认返回1国内。
"cityAreaType":1, //行政区类型:
1地级市 2县级市 3自治县,不传默认返回1地级市。
"pageNum":1, //页数 默认1
"pageSize":5000, //每页条数 默认100
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
pages | 总页数 | Integer | ||
total | 总记录数 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
cityAreaList | 城市数据集合 | Array[] | ||
t | 行政区域类型: 1 地级市、2 街道、3 旗、4 市辖区、5 县、6 县级市、7 镇、8 直辖市、9 自冶旗、10 自冶县 | Integer | cityAreaList | |
cn | 中文名称:如广州 | String | cityAreaList | |
en | 英文名称或拼音:如GUANGZHOUG | String | cityAreaList | |
cc | 城市三字码:不一定有值 | String | cityAreaList | |
zn | 所属城市中文名:城市表的无此值,区县表内的有此值 | String | cityAreaList | |
pn | 所属省州中文名:如广东 | String | cityAreaList | |
n | 国家中文名:如中国 | String | cityAreaList | |
c | 国家二字码:如CH | String | cityAreaList |
{
"cityAreaList":
[{
"t":1, //行政区域类型:
1 地级市、2 街道、3 旗、4 市辖区、5 县、6 县级市、7 镇、8 直辖市、9 自冶旗、10 自冶县
"cn":"广州", //中文名称:如广州
"en":"GUANGZHOU", //英文名称或拼音:如GUANGZHOUG
"cc":"CAN", //城市三字码:不一定有值
"zn":"广州", //所属城市中文名:城市表的无此值,区县表内的有此值
"pn":"广东", //所属省州中文名:如广东
"n":"中国", //国家中文名:如中国
"c":"CN", //国家二字码:如CH
}], //城市数据集合
"pages":1, //总页数
"total":480, //总记录数
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
历史接口,目前无场景使用
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单号 | String | 是 | |
status | 记账标记 | Integer | 是 | |
remark | 备注 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB230004582", //订单号
"status":1, //记账标记
"remark":"无", //备注
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
历史接口,目前无场景使用
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
stOrderNo | 美亚美亚订单号 | String | 是 | |
oaSerialnumber | 合作人出差申请单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"stOrderNo":"TB230004587", //美亚美亚订单号
"oaSerialnumber":"SL20231015316", //合作人出差申请单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
根据出差单号查询详细出差单信息
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
applyOrderNo | 出差申请单号 | String | 是 | |
outsideOrderNo | 外部申请单号 | String | 是 | |
startOpDate | 申请时间(开始) | String | 是 | |
endOpDate | 申请时间(结束) | String | 是 | |
IType | 访问来源 | Integer | 否 | |
startDate | 出发开始时间(出差申请单的StartDate) | String | 是 | |
endDate | 出发结束时间(出差申请单的StartDate) | String | 是 | |
outsideId | 出差人工号 | String | 否 | |
approvestatus | 审批状态(0:未审批,1:审批通过,2:审批不通过) | String | 是 | |
pageSize | 每页数量 | Integer | 是 | |
pageIndex | 分页码 | Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"applyOrderNo":"EC230034854", //出差申请单号
"outsideOrderNo":"CL202310160389", //外部申请单号
"startOpDate":"2023-10-01", //申请时间(开始)
"endOpDate":"2023-10-15", //申请时间(结束)
"IType":0, //访问来源
"startDate":"2023-10-01", //出发开始时间(出差申请单的StartDate)
"endDate":"2023-10-16", //出发结束时间(出差申请单的StartDate)
"outsideId":"ak1002", //出差人工号
"approvestatus":"1", //审批状态(0:未审批,1:审批通过,2:审批不通过)
"pageSize":100, //每页数量
"pageIndex":1, //分页码
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
applyOrderList | 出差申请信息 | Array[] | ||
applyOrderNo | 出差申请单号 | String | applyOrderList | |
outsideOrderNo | 外部申请单号 | String | applyOrderList | |
opDate | 申请时间 | String | applyOrderList | |
isPolicy | 是否违反政策 未设置-1,未违反0,违反1 | Integer | applyOrderList | |
breakPoliciesText | 违反预订政策文本 | String | applyOrderList | |
breakPoliciesReason | 违反出差政策原因 | String | applyOrderList | |
approveStatus | 审批状态 | Integer | applyOrderList | |
applyDate | 出差时间 格式:YYYY-MM-DD至YYYY-MM-DD | String | applyOrderList | |
psngrList | 出差人/同行人 | String | applyOrderList |
{
"applyOrderList":
[{
"applyOrderNo": "", //出差申请单号
"outsideOrderNo": "", //外部申请单号
"opDate": "", //申请时间
"isPolicy":0, //是否违反政策 未设置-1,未违反0,违反1
"breakPoliciesText": "", //违反预订政策文本
"breakPoliciesReason": "", //违反出差政策原因
"approveStatus":0, //审批状态
"applyDate": "", //出差时间 格式:YYYY-MM-DD至YYYY-MM-DD
"psngrList": "", //出差人/同行人
}], //出差申请信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
历史接口,目前无场景使用
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsideOrderNo | 客户出差申请单号,必须唯一 | String | 是 | |
beginDate | 出差开始时间:yyyy-MM-dd 【大概预算出差时间,不做具体校验,但必须传值】 | String | 是 | |
endDate | 出差结束时间:yyyy-MM-dd【大概预算出差时间,不做具体校验,但必须传值】 | String | 是 | |
purpose | 出差事由和目的 | String | 否 | |
status | 0-草稿单,2-草稿单(退回),3-审批,4-生效,8-取消,9-结束(对接过来的出差申请单都要传4),目前对接客户只支持修改8,9 | Integer | 是 | |
tripType | 行程类型 0 国内,1国际 | Integer | 是 | |
isPolicy | 是否校验违反出差政策 | Boolean | 否 | |
c_TextField_2401 | 客户自定义字段1 | String | 否 | |
c_TextField_2402 | 客户自定义字段2 | String | 否 | |
c_TextField_2403 | 客户自定义字段3 | String | 否 | |
c_TextField_2404 | 客户自定义字段4 | String | 否 | |
c_TextField_2405 | 客户自定义字段5 | String | 否 | |
c_TextField_2406 | 客户自定义字段6 | String | 否 | |
c_TextField_2407 | 客户自定义字段7 | String | 否 | |
c_TextField_2408 | 客户自定义字段8 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
costList | 出差申请成本中心,对接默认都传null | Array[] | 否 | |
costCenterName | 成本中心名称 | String | costList | |
applyPlanList | 拜访计划 | Array[] | 否 | |
visitUnit | 拜访单位 | String | applyPlanList | |
visitMan | 拜访人 | String | applyPlanList | |
visitTimeBegin | 拜访开始时间 | String | applyPlanList | |
visitTimeEnd | 拜访结束时间 | String | applyPlanList | |
unitAddress | 单位地址 | String | applyPlanList | |
applyPassengerInfo | 制单人或出差填单人 | PassengerInfo2 | 是 | |
companyId | 公司编号 | String | applyPassengerInfo | |
staffCode | 员工工号,外部系统识别旅客唯一的编码 | String | applyPassengerInfo | |
cnName | 中文名,不支持带特殊字符的名字,比如:玛丽.沙利亚(cnName,enName 其中一项必填) | String | applyPassengerInfo | |
enName | 英文名,格式 liu/zhanchao(cnName,enName 其中一项必填) | String | applyPassengerInfo | |
sex | 性别:男/女 | String | applyPassengerInfo | |
birthday | 出生日期(yyyy-MM-dd) | String | applyPassengerInfo | |
nationality | 国籍:中国:CN | String | applyPassengerInfo | |
mobile | 手机号码 | String | applyPassengerInfo | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | applyPassengerInfo | |
电子邮箱 | String | applyPassengerInfo | ||
passengerType | 旅客类型:成人/儿童 | String | applyPassengerInfo | |
holderId | 职称ID,需要和美亚职级先做映射,没有则不传 | String | applyPassengerInfo | |
dName | 部门名称【不传则不更新原值】,多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | applyPassengerInfo | |
costCenterID | 员工成本中心,传成本中心名称或者代码均可;数据结构类似部门 | String | applyPassengerInfo | |
postID | 职位ID | String | applyPassengerInfo | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | applyPassengerInfo | |
policyDict | 差旅政策, key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6, value : policyID,没有可不传 | Array[] | applyPassengerInfo | |
Value | 美亚政策编号,客户方需要做好美亚政策和客户系统政策的映射; | String | applyPassengerInfo.policyDict | |
Key | key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6 | Integer | applyPassengerInfo.policyDict | |
certificatesList | 证件,【没有证件可以传null】,证件字段里重复的是文档问题,不用处理 | Array[] | applyPassengerInfo | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | applyPassengerInfo.certificatesList | |
certNumber | 证件号码 | String | applyPassengerInfo.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | applyPassengerInfo.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | applyPassengerInfo.certificatesList | |
authorizerList | 授权人 最多50个 | Array[] | 否 | |
companyId | 公司编号 | String | authorizerList | |
staffCode | 员工工号,外部系统识别旅客唯一的编码 | String | authorizerList | |
cnName | 中文名,不支持带特殊字符的名字,比如:玛丽.沙利亚(cnName,enName 其中一项必填) | String | authorizerList | |
enName | 英文名,格式 liu/zhanchao(cnName,enName 其中一项必填) | String | authorizerList | |
sex | 性别:男/女 | String | authorizerList | |
birthday | 出生日期(yyyy-MM-dd) | String | authorizerList | |
nationality | 国籍:中国:CN | String | authorizerList | |
mobile | 手机号码 | String | authorizerList | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | authorizerList | |
电子邮箱 | String | authorizerList | ||
passengerType | 旅客类型:成人/儿童 | String | authorizerList | |
holderId | 职称ID,需要和美亚职级先做映射,没有则不传 | String | authorizerList | |
dName | 部门名称【不传则不更新原值】,多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | authorizerList | |
costCenterID | 员工成本中心,传成本中心名称或者代码均可;数据结构类似部门 | String | authorizerList | |
postID | 职位ID | String | authorizerList | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | authorizerList | |
policyDict | 差旅政策, key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6, value : policyID,没有可不传 | Array[] | authorizerList | |
Value | 美亚政策编号,客户方需要做好美亚政策和客户系统政策的映射; | String | authorizerList.policyDict | |
Key | key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6 | Integer | authorizerList.policyDict | |
certificatesList | 证件,【没有证件可以传null】,证件字段里重复的是文档问题,不用处理 | Array[] | authorizerList | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | authorizerList.certificatesList | |
certNumber | 证件号码 | String | authorizerList.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | authorizerList.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | authorizerList.certificatesList | |
tripInfoList | 行程列表【List,多行程则传多个】 | Array[] | 是 | |
departureCityCode | 始发城市编码 为旅客更好体验,建议优先使用美亚城市对,请查接口:GetCityAreaList 支持多个,多个城市之间用“,” 号隔开,并且城市编码与departureCity城市中文顺序要一致 | String | tripInfoList | |
departureCity | 始发城市 支持多个,多个城市之间用“,” 号隔开。 【当城市名称与城市编号同时存在时,优先取编号】 | String | tripInfoList | |
arrivalCityCode | 目的城市编码 为旅客更好体验,建议优先使用美亚城市对,请查接口:GetCityAreaList 支持多个,多个城市之间用“,” 号隔开,并且城市编码与arrivalCity城市中文顺序要一致 | String | tripInfoList | |
arrivalCity | 目的城市 支持多个,多个城市之间用“,” 号隔开。 【当城市名称与城市编号同时存在时,优先取编号】 | String | tripInfoList | |
startDay | 出发时间,实际出差跳转美亚查询机票、酒店、火车票时间 | String | tripInfoList | |
endDay | 到达时间,实际出差跳转美亚查询机票、酒店、火车票时间 | String | tripInfoList | |
isHotelForDepartureCity | 始发城市是否预订 国内酒店【必须true预订出发酒店按钮才显示】 | Boolean | tripInfoList | |
isHotelForArrivalCity | 目的城市是否预订 国内酒店【true时预订目的酒店按钮才显示】 | Boolean | tripInfoList | |
isIHotelForDepartureCity | 始发城市是否预订 国际酒店【true时预订目的酒店按钮才显示】 | Boolean | tripInfoList | |
isIHotelForArrivalCity | 目的城市是否预订 国际酒店【true时预订目的酒店按钮才显示】 | Boolean | tripInfoList | |
departCountry | 出发城市国籍编号(CN =中国)(国际酒店时必填) | String | tripInfoList | |
arrivalCountry | 到达城市国籍编号(CN =中国)(国际酒店时必填) | String | tripInfoList | |
isFlight | 机票预订按钮是否显示【true时预订机票按钮才显示】 | Boolean | tripInfoList | |
isTrain | 火车票预订按钮是否显示【true时预订机票按钮才显示】 | Boolean | tripInfoList | |
seatClass |
座位类别/舱等,只做快速查询过滤不做实际差标控制
机票 1,经济舱 2,公务舱 3,头等舱 4,豪华经济舱 5,公务舱及以下 6,头等舱及以下 7,豪华经济舱及以下 火车票 1,硬座 2,软座 3,硬卧 4,动卧 5,软卧 6,高级动卧 7,高级软卧 8,二等座 9,一等座 10,特等座 11,商务座 12,无座 13,一等卧 14,二等卧 15,优先一等座 |
String | tripInfoList | |
maxRoomPrice | 酒店最高可订价格,只做快速查询过滤不做实际差标控制 | Number | tripInfoList | |
tripType | 行程类型 0 国内,1国际(如果出差申请单为国内行程,则当前字段必须为国内行程(传值0)) | Integer | tripInfoList | |
reserveType | 预定类型1单程2往返 | String | tripInfoList | |
departureCityEnName | 出发地英文名(国际酒店产品预留使用,其他产品没有可以不传) | String | tripInfoList | |
departureCityProvinceName | 始发地所属省州名称(国际酒店产品预留使用,其他产品没有可以不传) | String | tripInfoList | |
arrivalCityEnName | 目的地英文名(国际酒店产品预留使用,其他产品没有可以不传) | String | tripInfoList | |
arrivalCityProvinceName | 目的地所属省州名称(国际酒店产品预留使用,其他产品没有可以不传) | String | tripInfoList | |
platformDepartureCity | 对接平台出发城市名称(国际酒店产品预留使用,其他产品没有可以不传) | String | tripInfoList | |
platformArrivalCity | 对接平台到达城市名称(国际酒店产品预留使用,其他产品没有可以不传) | String | tripInfoList | |
passengerInfoList | 旅客列表,国际机票产品同行程人数不可超过9人,系统不支持9人以上一起预订 | Array[] | tripInfoList | |
companyId | 公司编号 | String | tripInfoList.passengerInfoList | |
staffCode | 员工工号,外部系统识别旅客唯一的编码 | String | tripInfoList.passengerInfoList | |
cnName | 中文名,不支持带特殊字符的名字,比如:玛丽.沙利亚(cnName,enName 其中一项必填) | String | tripInfoList.passengerInfoList | |
enName | 英文名,格式 liu/zhanchao(cnName,enName 其中一项必填) | String | tripInfoList.passengerInfoList | |
sex | 性别:男/女 | String | tripInfoList.passengerInfoList | |
birthday | 出生日期(yyyy-MM-dd) | String | tripInfoList.passengerInfoList | |
nationality | 国籍:中国:CN | String | tripInfoList.passengerInfoList | |
mobile | 手机号码 | String | tripInfoList.passengerInfoList | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | tripInfoList.passengerInfoList | |
电子邮箱 | String | tripInfoList.passengerInfoList | ||
passengerType | 旅客类型:成人/儿童 | String | tripInfoList.passengerInfoList | |
holderId | 职称ID,需要和美亚职级先做映射,没有则不传 | String | tripInfoList.passengerInfoList | |
dName | 部门名称【不传则不更新原值】,多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | tripInfoList.passengerInfoList | |
costCenterID | 员工成本中心,传成本中心名称或者代码均可;数据结构类似部门 | String | tripInfoList.passengerInfoList | |
postID | 职位ID | String | tripInfoList.passengerInfoList | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | tripInfoList.passengerInfoList | |
policyDict | 差旅政策, key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6, value : policyID,没有可不传 | Array[] | tripInfoList.passengerInfoList | |
Value | 美亚政策编号,客户方需要做好美亚政策和客户系统政策的映射; | String | tripInfoList.passengerInfoList.policyDict | |
Key | key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6 | Integer | tripInfoList.passengerInfoList.policyDict | |
certificatesList | 证件,【没有证件可以传null】,证件字段里重复的是文档问题,不用处理 | Array[] | tripInfoList.passengerInfoList | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | tripInfoList.passengerInfoList.certificatesList | |
certNumber | 证件号码 | String | tripInfoList.passengerInfoList.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | tripInfoList.passengerInfoList.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | tripInfoList.passengerInfoList.certificatesList |
{
"outsideOrderNo":"CL202310160389", //客户出差申请单号,必须唯一
"applyPassengerInfo":
{
"companyId":"S118022", //公司编号
"staffCode":"ak10002", //员工工号,外部系统识别旅客唯一的编码
"cnName":"刘展超", //中文名,不支持带特殊字符的名字,比如:玛丽.沙利亚(cnName,enName 其中一项必填)
"enName":"liu/zhanchao", //英文名,格式 liu/zhanchao(cnName,enName 其中一项必填)
"sex":"男", //性别:男/女
"birthday":"1995-10-20", //出生日期(yyyy-MM-dd)
"nationality":"CN", //国籍:中国:CN
"mobile":"18625899912", //手机号码
"mobileAreaCode":"558", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"passengerType":"成人", //旅客类型:成人/儿童
"holderId":"所以在职人员", //职称ID,需要和美亚职级先做映射,没有则不传
"dName":"美亚集团/旅游产品部/运营中心", //部门名称【不传则不更新原值】,多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件,【没有证件可以传null】,证件字段里重复的是文档问题,不用处理
"policyDict":
[{
"Value":"ZC20190919002711", //美亚政策编号,客户方需要做好美亚政策和客户系统政策的映射;
"Key":1, //key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6
}], //差旅政策, key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6, value : policyID,没有可不传
"costCenterID":"美亚集团/旅游产品部/运营中心", //员工成本中心,传成本中心名称或者代码均可;数据结构类似部门
"postID": "", //职位ID
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
}, //制单人或出差填单人
"beginDate":"2023-10-16", //出差开始时间:yyyy-MM-dd 【大概预算出差时间,不做具体校验,但必须传值】
"endDate":"2023-10-18", //出差结束时间:yyyy-MM-dd【大概预算出差时间,不做具体校验,但必须传值】
"tripInfoList":
[{
"passengerInfoList":
[{
"companyId":"S118022", //公司编号
"staffCode":"ak10002", //员工工号,外部系统识别旅客唯一的编码
"cnName":"刘展超", //中文名,不支持带特殊字符的名字,比如:玛丽.沙利亚(cnName,enName 其中一项必填)
"enName":"liu/zhanchao", //英文名,格式 liu/zhanchao(cnName,enName 其中一项必填)
"sex":"男", //性别:男/女
"birthday":"1995-10-20", //出生日期(yyyy-MM-dd)
"nationality":"CN", //国籍:中国:CN
"mobile":"18625899912", //手机号码
"mobileAreaCode":"558", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"passengerType":"成人", //旅客类型:成人/儿童
"holderId":"所以在职人员", //职称ID,需要和美亚职级先做映射,没有则不传
"dName":"美亚集团/旅游产品部/运营中心", //部门名称【不传则不更新原值】,多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件,【没有证件可以传null】,证件字段里重复的是文档问题,不用处理
"policyDict":
[{
"Value":"ZC20190919002711", //美亚政策编号,客户方需要做好美亚政策和客户系统政策的映射;
"Key":1, //key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6
}], //差旅政策, key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6, value : policyID,没有可不传
"costCenterID":"美亚集团/旅游产品部/运营中心", //员工成本中心,传成本中心名称或者代码均可;数据结构类似部门
"postID": "", //职位ID
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
}], //旅客列表,国际机票产品同行程人数不可超过9人,系统不支持9人以上一起预订
"departureCityCode":"SHA", //始发城市编码 为旅客更好体验,建议优先使用美亚城市对,请查接口:GetCityAreaList 支持多个,多个城市之间用“,” 号隔开,并且城市编码与departureCity城市中文顺序要一致
"departureCity":"上海", //始发城市 支持多个,多个城市之间用“,” 号隔开。
【当城市名称与城市编号同时存在时,优先取编号】
"arrivalCityCode":"BJS", //目的城市编码 为旅客更好体验,建议优先使用美亚城市对,请查接口:GetCityAreaList 支持多个,多个城市之间用“,” 号隔开,并且城市编码与arrivalCity城市中文顺序要一致
"arrivalCity":"北京", //目的城市 支持多个,多个城市之间用“,” 号隔开。
【当城市名称与城市编号同时存在时,优先取编号】
"startDay":"2023-10-16", //出发时间,实际出差跳转美亚查询机票、酒店、火车票时间
"endDay":"2023-10-18", //到达时间,实际出差跳转美亚查询机票、酒店、火车票时间
"isHotelForDepartureCity":true, //始发城市是否预订 国内酒店【必须true预订出发酒店按钮才显示】
"isHotelForArrivalCity":true, //目的城市是否预订 国内酒店【true时预订目的酒店按钮才显示】
"isIHotelForDepartureCity":true, //始发城市是否预订 国际酒店【true时预订目的酒店按钮才显示】
"isIHotelForArrivalCity":true, //目的城市是否预订 国际酒店【true时预订目的酒店按钮才显示】
"departCountry":"CN", //出发城市国籍编号(CN =中国)(国际酒店时必填)
"arrivalCountry":"CN", //到达城市国籍编号(CN =中国)(国际酒店时必填)
"isFlight":true, //机票预订按钮是否显示【true时预订机票按钮才显示】
"isTrain":true, //火车票预订按钮是否显示【true时预订机票按钮才显示】
"seatClass":"1", //座位类别/舱等,只做快速查询过滤不做实际差标控制
"maxRoomPrice":800, //酒店最高可订价格,只做快速查询过滤不做实际差标控制
"tripType":0, //行程类型 0 国内,1国际(如果出差申请单为国内行程,则当前字段必须为国内行程(传值0))
"reserveType":"1", //预定类型1单程2往返
"departureCityEnName": "", //出发地英文名(国际酒店产品预留使用,其他产品没有可以不传)
"departureCityProvinceName": "", //始发地所属省州名称(国际酒店产品预留使用,其他产品没有可以不传)
"arrivalCityEnName": "", //目的地英文名(国际酒店产品预留使用,其他产品没有可以不传)
"arrivalCityProvinceName": "", //目的地所属省州名称(国际酒店产品预留使用,其他产品没有可以不传)
"platformDepartureCity": "", //对接平台出发城市名称(国际酒店产品预留使用,其他产品没有可以不传)
"platformArrivalCity": "", //对接平台到达城市名称(国际酒店产品预留使用,其他产品没有可以不传)
}], //行程列表【List,多行程则传多个】
"purpose":"前往项目部,沟通对接施工", //出差事由和目的
"status":4, //0-草稿单,2-草稿单(退回),3-审批,4-生效,8-取消,9-结束(对接过来的出差申请单都要传4),目前对接客户只支持修改8,9
"costList":
[{
"costCenterName": "", //成本中心名称
}], //出差申请成本中心,对接默认都传null
"applyPlanList":
[{
"visitUnit":"美亚商旅科技有限公司", //拜访单位
"visitMan":"吴经理", //拜访人
"visitTimeBegin":"2023-10-16", //拜访开始时间
"visitTimeEnd":"2023-10-18", //拜访结束时间
"unitAddress":"广东省广州大道北520", //单位地址
}], //拜访计划
"tripType":0, //行程类型 0 国内,1国际
"isPolicy":false, //是否校验违反出差政策
"authorizerList":
[{
"companyId":"S118022", //公司编号
"staffCode":"ak10002", //员工工号,外部系统识别旅客唯一的编码
"cnName":"刘展超", //中文名,不支持带特殊字符的名字,比如:玛丽.沙利亚(cnName,enName 其中一项必填)
"enName":"liu/zhanchao", //英文名,格式 liu/zhanchao(cnName,enName 其中一项必填)
"sex":"男", //性别:男/女
"birthday":"1995-10-20", //出生日期(yyyy-MM-dd)
"nationality":"CN", //国籍:中国:CN
"mobile":"18625899912", //手机号码
"mobileAreaCode":"558", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"passengerType":"成人", //旅客类型:成人/儿童
"holderId":"所以在职人员", //职称ID,需要和美亚职级先做映射,没有则不传
"dName":"美亚集团/旅游产品部/运营中心", //部门名称【不传则不更新原值】,多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件,【没有证件可以传null】,证件字段里重复的是文档问题,不用处理
"policyDict":
[{
"Value":"ZC20190919002711", //美亚政策编号,客户方需要做好美亚政策和客户系统政策的映射;
"Key":1, //key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6
}], //差旅政策, key: 国内机票 = 1,国际机票 = 2,国内酒店 = 3,国际酒店 = 4,火车票 = 5,广九直通车=6, value : policyID,没有可不传
"costCenterID":"美亚集团/旅游产品部/运营中心", //员工成本中心,传成本中心名称或者代码均可;数据结构类似部门
"postID": "", //职位ID
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
}], //授权人 最多50个
"c_TextField_2401": "", //客户自定义字段1
"c_TextField_2402": "", //客户自定义字段2
"c_TextField_2403": "", //客户自定义字段3
"c_TextField_2404": "", //客户自定义字段4
"c_TextField_2405": "", //客户自定义字段5
"c_TextField_2406": "", //客户自定义字段6
"c_TextField_2407": "", //客户自定义字段7
"c_TextField_2408": "", //客户自定义字段8
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
isBreakForcibly | 是否有违反强制性出差政策 | Boolean | ||
isPolicy | 是否违反出差政策 | Boolean | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
orderPolicyList | 违反出差政策列表,无则 orderPolicyList= null 或不处理 | Array[] | ||
policyDescription | 违反出差政策内容 | String | orderPolicyList | |
policyID | 违反出差政策编号 | String | orderPolicyList | |
policyName | 违反出差政策名称 | String | orderPolicyList | |
defineType | 违反出差政策性质 | String | orderPolicyList | |
passengerName | 旅客姓名 | String | orderPolicyList |
{
"isBreakForcibly":false, //是否有违反强制性出差政策
"isPolicy":false, //是否违反出差政策
"orderPolicyList":
[{
"policyDescription":"一线城市出差标准2000", //违反出差政策内容
"policyID":"EC4585211", //违反出差政策编号
"policyName":"一线城市", //违反出差政策名称
"defineType":"强制", //违反出差政策性质
"passengerName":"刘展超", //旅客姓名
}], //违反出差政策列表,无则 orderPolicyList= null 或不处理
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
新根据客户订单号或者美亚订单号查询所有美亚关联的订单信息,也可以理解为根据客户出差单信息查询所有预订的订单信息
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订购单号 | String | 是 | |
outsideOrderNo | 客户订单号 | String | 否 | |
staffCode | 客户系统旅客工号 | String | 否 | |
opDateStart | 查询预订日期开始(不传则默认查当天半年前,只对按旅客工号查询时有效) | String | 否 | |
opDateEnd | 查询预订日期结束(不传则默认查当天半年前,只对按旅客工号查询时有效) | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB230004581", //美亚订购单号
"outsideOrderNo":"SL20231015316", //客户订单号
"staffCode":"10000", //客户系统旅客工号
"opDateStart":"2024-01-01", //查询预订日期开始(不传则默认查当天半年前,只对按旅客工号查询时有效)
"opDateEnd":"2024-05-30", //查询预订日期结束(不传则默认查当天半年前,只对按旅客工号查询时有效)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
orderInfoList | 返回消费记录 | Array[] | ||
outsideOrderNo | 流程单号(GUID) | String | orderInfoList | |
orderNo | 美亚订单号 | String | orderInfoList | |
orderType | 订单类型 1:国内机票订单, 2:国内机票改签单, 3:国内机票退票单, 70:火车票订单, 80:火车票退票单, 90:火车票改签单, 5:国内酒店订单, 6:国内酒店退票单, 11: 国际机票订单, 12:国际机票改签单, 13:国际机票退票单, 15:国际酒店订单, 16:国际酒店退票单 | Integer | orderInfoList | |
originalOrderNo | 原订单编号 改签、退票、废票单的原美亚订单编号,订购单时为空 | String | orderInfoList | |
opName | 制单人 | String | orderInfoList | |
opTime | 制单时间 | String | orderInfoList | |
cost | 总金额 | Number | orderInfoList | |
detailInfo | 简略信息 (返回的是接口文档里,订单推送-data 对象里的数据,可以查看订单推送-data) | String | orderInfoList | |
remark | 订单备注 | String | orderInfoList |
{
"orderInfoList":
[{
"outsideOrderNo":"SL20230510321", //流程单号(GUID)
"orderNo":"TR230000545", //美亚订单号
"orderType":3, //订单类型
1:国内机票订单,
2:国内机票改签单,
3:国内机票退票单,
70:火车票订单,
80:火车票退票单,
90:火车票改签单,
5:国内酒店订单,
6:国内酒店退票单,
11: 国际机票订单,
12:国际机票改签单,
13:国际机票退票单,
15:国际酒店订单,
16:国际酒店退票单
"originalOrderNo":"TB230004561", //原订单编号
改签、退票、废票单的原美亚订单编号,订购单时为空
"opName":"刘展超", //制单人
"opTime":"2023-10-01 12:10:05", //制单时间
"cost":2000, //总金额
"detailInfo":"/示例数据{data:{sss}/}", //简略信息 (返回的是接口文档里,订单推送-data 对象里的数据,可以查看订单推送-data)
"remark":"无", //订单备注
}], //返回消费记录
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
该接口绑定线下预订的订单和客户系统出差单的关系,只对线下无出差单号的订单有绑定效果,对使用美亚EC出差单号下单的无效
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsideOrderNo | 客户流程单号(GUID) | String | 是 | |
orderNo | 美亚订单号 | String | 是 | |
type | 绑定(1);解绑(-1) | Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"outsideOrderNo":"SL20231015316", //客户流程单号(GUID)
"orderNo":"TB230004561", //美亚订单号
"type":1, //绑定(1);解绑(-1)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
查询航班信息
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
flightID | 航班ID(GetMoreFlights 接口为QueryFlights返回的 flightID) | String | 否 | |
departureCity | 出发城市(三字码) | String | 是 | |
arrivalCity | 达到城市(三字码) | String | 是 | |
departureDate | 出发日期:yyyy-MM-dd | String | 是 | |
departureTime | 出发时间段(如:[0,24]表示出发时间是0-24点) | Array[] | 否 | |
airline | 销售航司 | String | 否 | |
cabinClass | 舱位等级(经济舱:1 公务舱:2 头等舱:3 豪华经济舱:4) | String | 否 | |
PassengerList | 美亚美亚旅客编号或对接方员工编号 | Array[] | 否 | |
isShowALLPrice | 是否显示所有航班 | Boolean | 否 | |
isForce | 是否强制差旅政策 | Boolean | 否 | |
isShowTicketRule |
是否返回退改签规则:1返回(默认)、0:(不返回)
添加日期: 2019-07-16 |
Integer | 否 | |
isCodeShare |
是否返回共享航班:1返回(默认)、0:(不返回)
添加日期: 2019-10-12 |
Integer | 否 | |
receivePayType | 0-信用付 默认不传 ;1-即付,因私默认 即付; | String | 否 | |
bookingType | 预订类型;1= 因公,2 = 因私 | Integer | 否 | |
settlementWay | 结算方式 1 UATP 2 非UATP | String | 否 | |
isOnlyDirectFlight |
是否仅查直飞(仅支持单程),默认是true
添加日期: 2024-04-08 |
Boolean | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"flightID":"8ce833067568c92bb9876ba1c1e56e84", //航班ID(GetMoreFlights 接口为QueryFlights返回的 flightID)
"departureCity":"CAN", //出发城市(三字码)
"arrivalCity":"KMG", //达到城市(三字码)
"departureDate":"2023-12-26", //出发日期:yyyy-MM-dd
"departureTime":"[0,24]", //出发时间段(如:[0,24]表示出发时间是0-24点)
"airline":"CA", //销售航司
"cabinClass":"1", //舱位等级(经济舱:1 公务舱:2 头等舱:3 豪华经济舱:4)
"PassengerList":"['P154424']", //美亚美亚旅客编号或对接方员工编号
"isShowALLPrice":false, //是否显示所有航班
"isForce":false, //是否强制差旅政策
"isShowTicketRule":0, //是否返回退改签规则:1返回(默认)、0:(不返回)
"isCodeShare":0, //是否返回共享航班:1返回(默认)、0:(不返回)
"receivePayType":"0", //0-信用付 默认不传 ;1-即付,因私默认 即付;
"bookingType":1, //预订类型;1= 因公,2 = 因私
"settlementWay":"1", //结算方式 1 UATP 2 非UATP
"isOnlyDirectFlight":true, //是否仅查直飞(仅支持单程),默认是true
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
flightInfoList | 返回结果 | Array[] | ||
resultID | 行程ID 比如:去程、回程 | String | flightInfoList | |
segmentID | 航班ID | String | flightInfoList | |
depDate | 出发日期 | String | flightInfoList | |
depTime | 出发时间 | String | flightInfoList | |
arrDate | 到达日期 | String | flightInfoList | |
arrTime | 到达时间 | String | flightInfoList | |
orgCity | 出发城市名称 | String | flightInfoList | |
orgCityCode | 出发城市编码 | String | flightInfoList | |
desCity | 到达城市名称 | String | flightInfoList | |
desCityCode | 到达城市编码 | String | flightInfoList | |
orgAirport | 出发机场名称 | String | flightInfoList | |
orgAirportCode | 出发机场编号 | String | flightInfoList | |
desAirport | 到达机场名称 | String | flightInfoList | |
desAirportCode | 到达机场编号 | String | flightInfoList | |
depTerm | 出发航站楼 | String | flightInfoList | |
arrTerm | 到达航站楼 | String | flightInfoList | |
flightNo | 销售航班号 | String | flightInfoList | |
airlineCode | 销售航司编号 | String | flightInfoList | |
airlineName | 销售航司 | String | flightInfoList | |
planeMode | 机型 | String | flightInfoList | |
isCodeShare | 是否共享航班 | Boolean | flightInfoList | |
carrier | 实际承运航班号;如果销售航班号是共享航班号,那么实际承运航班号才有值的 | String | flightInfoList | |
meal | 餐食 | Boolean | flightInfoList | |
MealCode | 餐食编号 | String | flightInfoList | |
MealName | 餐食名称 B :早餐 C :免费酒精饮料 D :正餐 F :供采购的食物 G :供采购的食物和饮料 H :热膳食 K :轻快早餐 L :午餐 M: 膳食 N :没有饭食供应 O: 冷膳食 P :供采购的酒精饮料 R :茶点 S: 快餐 V :供采购的茶点 | String | flightInfoList | |
tpm | 里程 | Integer | flightInfoList | |
stopNumber | 经停0:无经停,1:有经停 | Integer | flightInfoList | |
fAmount | 头等舱全价 | Number | flightInfoList | |
cAmount | 公务舱全价 | Number | flightInfoList | |
yAmount | 经济舱全价 | Number | flightInfoList | |
secondFlight |
第二段
添加日期: 2024-04-08 |
SecondFlight | flightInfoList | |
depDate |
出发日期
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
depTime |
出发时间
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
arrDate |
到达日期
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
arrTime |
到达时间
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgCity |
出发城市名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgCityCode |
出发城市编码
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desCity |
到达城市名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desCityCode |
到达城市编码
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgAirport |
出发机场名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgAirportCode |
出发机场编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desAirport |
到达机场名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desAirportCode |
到达机场编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
depTerm |
出发航站楼
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
arrTerm |
到达航站楼
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
flightNo |
销售航班号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
airlineCode |
销售航司编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
airlineName |
销售航司
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
planeMode |
机型
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
isCodeShare |
是否共享航班
添加日期: 2024-04-08 |
Boolean | flightInfoList.secondFlight | |
carrier |
实际承运航班号;如果销售航班号是共享航班号,那么实际承运航班号才有值的
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
meal |
餐食
添加日期: 2024-04-08 |
Boolean | flightInfoList.secondFlight | |
MealCode |
餐食编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
MealName |
餐食名称
B :早餐
C :免费酒精饮料
D :正餐
F :供采购的食物
G :供采购的食物和饮料
H :热膳食
K :轻快早餐
L :午餐
M: 膳食
N :没有饭食供应
O: 冷膳食
P :供采购的酒精饮料
R :茶点
S: 快餐
V :供采购的茶点
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopNumber |
经停0:无经停,1:有经停
添加日期: 2024-04-08 |
Integer | flightInfoList.secondFlight | |
carrierAirlineName |
实际承运航司中文名
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopCityName |
经停城市名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopCityCode |
经停城市三字码
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopTime |
经停时长
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopItemList |
经停的具体项,仅当stopNumber>0时有数据
添加日期: 2024-04-08 |
Array[] | flightInfoList.secondFlight | |
cityName | 城市的中文说明 | String | flightInfoList.secondFlight.stopItemList | |
depTime | 从该经停地起飞的时间 | String | flightInfoList.secondFlight.stopItemList | |
arrTime | 到达该经停地的时间 | String | flightInfoList.secondFlight.stopItemList | |
flightPriceInfoList | 价格信息 | Array[] | flightInfoList | |
priceID | 价格ID | String | flightInfoList.flightPriceInfoList | |
flightID | 航段序号(等于resultID+segmentID+priceID下划线分割) | String | flightInfoList.flightPriceInfoList | |
discount | 折扣 | Number | flightInfoList.flightPriceInfoList | |
ticketPrice | 票价 | Number | flightInfoList.flightPriceInfoList | |
airPortFee | 机场建设费 | Number | flightInfoList.flightPriceInfoList | |
oilFee | 燃油费 | Number | flightInfoList.flightPriceInfoList | |
serviceAmount | 服务费 | Number | flightInfoList.flightPriceInfoList | |
airlineYouHui | 航司优惠 | Number | flightInfoList.flightPriceInfoList | |
meiYaYouHui | 美亚优惠 | Number | flightInfoList.flightPriceInfoList | |
amount | 舱位公布运价 | Number | flightInfoList.flightPriceInfoList | |
airlineYouHuiAmount | 机票票面价 | Number | flightInfoList.flightPriceInfoList | |
cabinType | 舱位(如:Y) | String | flightInfoList.flightPriceInfoList | |
cabin | 舱位等级 | String | flightInfoList.flightPriceInfoList | |
clazzName | 舱位名称 | String | flightInfoList.flightPriceInfoList | |
cabinAliasNameCn |
舱等别名-中文
添加日期: 2023-10-17 |
String | flightInfoList.flightPriceInfoList | |
cabinAliasNameEn |
舱等别名-英文
添加日期: 2023-10-17 |
String | flightInfoList.flightPriceInfoList | |
refundChangeInfo | 退改条款 | String | flightInfoList.flightPriceInfoList | |
violate | 违反差旅政策标识(0表示不违反,1表示违反但不是强制的,2标示违反强制差旅政策) | Integer | flightInfoList.flightPriceInfoList | |
seatNum | 座位数(9张或9张以上:A;1-8张:具体座位数) | String | flightInfoList.flightPriceInfoList | |
protocolType | 协议类型(0:非协议价;1、2协议价) | Integer | flightInfoList.flightPriceInfoList | |
isForbidReturn | 不得退票(只退未使用税费) | Boolean | flightInfoList.flightPriceInfoList | |
isForbidChange | 不得变更 | Boolean | flightInfoList.flightPriceInfoList | |
luggageRule | 行李额规则 | String | flightInfoList.flightPriceInfoList | |
fareType | 运价来源; PUBLIC 公布运价,PRIVATE 私有运价 AGREEMENT 协议价 | String | flightInfoList.flightPriceInfoList | |
refundRuleInfo | 退票规则内容 | String | flightInfoList.flightPriceInfoList | |
changeRuleInfo | 改签规则内容 | String | flightInfoList.flightPriceInfoList | |
transferRuleInfo | 签转规则内容 | String | flightInfoList.flightPriceInfoList | |
purchaseRule | 购票规定 | ApiTicketPricePurchaseRule | flightInfoList.flightPriceInfoList | |
content | 内容 | String | flightInfoList.flightPriceInfoList.purchaseRule | |
categories | 分类 | Array[] | flightInfoList.flightPriceInfoList.purchaseRule | |
type | 类型,0=小团专享,1=青年特惠,2=长者特惠 | String | flightInfoList.flightPriceInfoList.purchaseRule.categories | |
content | 内容 | String | flightInfoList.flightPriceInfoList.purchaseRule.categories | |
structor | 内容结构 | ApiTicketPricePurchaseRuleStruct | flightInfoList.flightPriceInfoList.purchaseRule | |
minCount | 最小旅客数量(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
maxCount | 最大旅客数量(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
minAge | 最小年龄(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
maxAge | 最大年龄(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
certificateTypes | 证件类型(身份证/因私护照/因公护照等等) | Array[] | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
gertificateNumber | 证件号码限制 | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
genders | 性别(男/女) | Array[] | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
ticketLuggageRule | 行李额 | TicketLuggageRule | flightInfoList.flightPriceInfoList | |
checkRuleInfo | 托运行李规则内容(托运汇总内容) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
handRuleInfo | 手提行李规则内容(手提汇总内容) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeCheckCount | 免费托运行李数量 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeCheckUnit | 免费托运行李单位 KG=公斤 PC=件 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeCheckLuggage | 免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
checkDescription | 托运行李说明 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeHandCount | 免费手提行李数量 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeHandUnit | 免费手提行李单位 KG=公斤 PC=件 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeHandLuggage | 免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
handDescription | 手提行李说明 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
refundFees | 退票规则费用计算 | Array[] | flightInfoList.flightPriceInfoList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | flightInfoList.flightPriceInfoList.refundFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.refundFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.refundFees | |
fee | 运算后的退改费用(元) | Number | flightInfoList.flightPriceInfoList.refundFees | |
baseFee | 运算基数 | Number | flightInfoList.flightPriceInfoList.refundFees | |
feePercent | 费用百分比 | Number | flightInfoList.flightPriceInfoList.refundFees | |
minimumFee | 保底费用(元) | Number | flightInfoList.flightPriceInfoList.refundFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | flightInfoList.flightPriceInfoList.refundFees | |
timingCount | 计时数量 | Integer | flightInfoList.flightPriceInfoList.refundFees | |
timingUnit | 计时单位:H 小时、D 天 | String | flightInfoList.flightPriceInfoList.refundFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | flightInfoList.flightPriceInfoList.refundFees | |
changeFees | 改签规则费用计算 | Array[] | flightInfoList.flightPriceInfoList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | flightInfoList.flightPriceInfoList.changeFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.changeFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.changeFees | |
fee | 运算后的退改费用(元) | Number | flightInfoList.flightPriceInfoList.changeFees | |
baseFee | 运算基数 | Number | flightInfoList.flightPriceInfoList.changeFees | |
feePercent | 费用百分比 | Number | flightInfoList.flightPriceInfoList.changeFees | |
minimumFee | 保底费用(元) | Number | flightInfoList.flightPriceInfoList.changeFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | flightInfoList.flightPriceInfoList.changeFees | |
timingCount | 计时数量 | Integer | flightInfoList.flightPriceInfoList.changeFees | |
timingUnit | 计时单位:H 小时、D 天 | String | flightInfoList.flightPriceInfoList.changeFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | flightInfoList.flightPriceInfoList.changeFees |
{
"flightInfoList":
[{
"resultID":"bbe4b225e9094de38e8750b6be292695", //行程ID 比如:去程、回程
"segmentID":"fb84a4ca567c4c56936e7ad739a60333", //航班ID
"depDate":"2023-12-26", //出发日期
"depTime":"06:30", //出发时间
"arrDate":"2023-12-26", //到达日期
"arrTime":"09:00", //到达时间
"orgCity":"广州", //出发城市名称
"orgCityCode":"CAN", //出发城市编码
"desCity":"昆明", //到达城市名称
"desCityCode":"KMG", //到达城市编码
"orgAirport":"白云国际机场", //出发机场名称
"orgAirportCode":"CAN", //出发机场编号
"desAirport":"长水国际机场", //到达机场名称
"desAirportCode":"KMG", //到达机场编号
"depTerm":"T1", //出发航站楼
"arrTerm":"T1", //到达航站楼
"flightNo":"MU6823", //销售航班号
"airlineCode":"MU", //销售航司编号
"airlineName":"东方航空-东", //销售航司
"planeMode":"波音73L(中)", //机型
"isCodeShare":false, //是否共享航班
"carrier":"null", //实际承运航班号;如果销售航班号是共享航班号,那么实际承运航班号才有值的
"meal":false, //餐食
"MealCode":"0", //餐食编号
"MealName":"null", //餐食名称
B :早餐
C :免费酒精饮料
D :正餐
F :供采购的食物
G :供采购的食物和饮料
H :热膳食
K :轻快早餐
L :午餐
M: 膳食
N :没有饭食供应
O: 冷膳食
P :供采购的酒精饮料
R :茶点
S: 快餐
V :供采购的茶点
"tpm":0, //里程
"stopNumber":0, //经停0:无经停,1:有经停
"fAmount":5450.0, //头等舱全价
"cAmount":4950.0, //公务舱全价
"yAmount":1980.0, //经济舱全价
"flightPriceInfoList":
[{
"priceID":"1", //价格ID
"flightID":"bbe4b225e9094de38e8750b6be292695_fb84a4ca567c4c56936e7ad739a60333_1", //航段序号(等于resultID+segmentID+priceID下划线分割)
"discount":33.8, //折扣
"ticketPrice":670.0, //票价
"airPortFee":50.0, //机场建设费
"oilFee":130.0, //燃油费
"serviceAmount":10.0, //服务费
"airlineYouHui":0.0, //航司优惠
"meiYaYouHui":0.0, //美亚优惠
"amount":670.0, //舱位公布运价
"airlineYouHuiAmount":670.0, //机票票面价
"cabinType":"V", //舱位(如:Y)
"cabin":"经济舱", //舱位等级
"clazzName":"经济舱", //舱位名称
"cabinAliasNameCn":"null", //舱等别名-中文
"cabinAliasNameEn":"null", //舱等别名-英文
"refundChangeInfo":"null", //退改条款
"violate":0, //违反差旅政策标识(0表示不违反,1表示违反但不是强制的,2标示违反强制差旅政策)
"seatNum":"A", //座位数(9张或9张以上:A;1-8张:具体座位数)
"protocolType":0, //协议类型(0:非协议价;1、2协议价)
"isForbidReturn":false, //不得退票(只退未使用税费)
"isForbidChange":false, //不得变更
"luggageRule":"免费托运行李额20KG,免费手提行李额10KG。(免费携带1件10KG以内)", //行李额规则
"fareType":"PRIVATE", //运价来源; PUBLIC 公布运价,PRIVATE 私有运价 AGREEMENT 协议价
"refundFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //退票规则费用计算
"changeFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //改签规则费用计算
"ticketLuggageRule":
{
"checkRuleInfo": "", //托运行李规则内容(托运汇总内容)
"handRuleInfo": "", //手提行李规则内容(手提汇总内容)
"freeCheckCount":"1", //免费托运行李数量
"freeCheckUnit":"PC", //免费托运行李单位 KG=公斤 PC=件
"freeCheckLuggage":"1PC", //免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”)
"checkDescription":"1件", //托运行李说明
"freeHandCount": "", //免费手提行李数量
"freeHandUnit": "", //免费手提行李单位 KG=公斤 PC=件
"freeHandLuggage": "", //免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”)
"handDescription": "", //手提行李说明
}, //行李额
"refundRuleInfo":"null", //退票规则内容
"changeRuleInfo":"null", //改签规则内容
"transferRuleInfo":"null", //签转规则内容
"purchaseRule":
{
"content": "", //内容
"categories":
[{
"type": "", //类型,0=小团专享,1=青年特惠,2=长者特惠
"content": "", //内容
}], //分类
"structor":
{
"minCount": "", //最小旅客数量(空为不限)
"maxCount": "", //最大旅客数量(空为不限)
"minAge": "", //最小年龄(空为不限)
"maxAge": "", //最大年龄(空为不限)
"certificateTypes":[], //证件类型(身份证/因私护照/因公护照等等)
"gertificateNumber": "", //证件号码限制
"genders":[], //性别(男/女)
}, //内容结构
}, //购票规定
}], //价格信息
"secondFlight":"1980.0", //第二段
}], //返回结果
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票退改规则,行李额查询
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
flightID | 航班ID(航班查询获取) | String | 是 | |
flightNo | 航班号 | String | 是 | |
cabinType | 舱位等级(从航班查询返回获取:如Y、L等) | String | 是 | |
departureCity | 出发城市(三字码) | String | 是 | |
arrivalCity | 达到城市(三字码) | String | 是 | |
departureDate | 出发日期 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
sencond |
中转两段航程才需要
添加日期: 2024-04-08 |
SencondTicket | 否 | |
flightNo |
航班号
添加日期: 2024-04-08 |
String | sencond | |
cabinType |
舱位等级(从航班查询返回获取:如Y、L等)
添加日期: 2024-04-08 |
String | sencond | |
departureCity |
出发城市(三字码)
添加日期: 2024-04-08 |
String | sencond | |
arrivalCity |
达到城市(三字码)
添加日期: 2024-04-08 |
String | sencond | |
departureDate |
出发日期
添加日期: 2024-04-08 |
String | sencond |
{
"flightID":"cccae9d265c94b1094cd6c80a5f268e8_1d655543d2384810897231557800f6e6_1", //航班ID(航班查询获取)
"flightNo":"MU6302", //航班号
"cabinType":"V", //舱位等级(从航班查询返回获取:如Y、L等)
"departureCity":"CAN", //出发城市(三字码)
"arrivalCity":"BJS", //达到城市(三字码)
"departureDate":"2023-11-08", //出发日期
"sencond":
{
"flightNo":"MU6304", //航班号
"cabinType":"Y", //舱位等级(从航班查询返回获取:如Y、L等)
"departureCity":"BJS", //出发城市(三字码)
"arrivalCity":"SZX", //达到城市(三字码)
"departureDate":"2023-11-08", //出发日期
}, //中转两段航程才需要
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
refundChangeInfo | 退改签信息 | String | ||
invalidInfo | 作废规定 | String | ||
isForbidReturn | 是否不得退票(只退未使用税费) | Boolean | ||
isForbidChange | 是否不得变更 | Boolean | ||
ruleRemark | 退改备注 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
specialService | 特殊服务 | Array[] | ||
type | 服务类型 | String | specialService | |
serviceName | 服务名称 | String | specialService | |
serviceDetail | 服务详情 | String | specialService | |
ticketLuggageRule | 行李额 | TicketLuggageRule | ||
checkRuleInfo | 托运行李规则内容(托运汇总内容) | String | ticketLuggageRule | |
handRuleInfo | 手提行李规则内容(手提汇总内容) | String | ticketLuggageRule | |
freeCheckCount | 免费托运行李数量 | String | ticketLuggageRule | |
freeCheckUnit | 免费托运行李单位 KG=公斤 PC=件 | String | ticketLuggageRule | |
freeCheckLuggage | 免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”) | String | ticketLuggageRule | |
checkDescription | 托运行李说明 | String | ticketLuggageRule | |
freeHandCount | 免费手提行李数量 | String | ticketLuggageRule | |
freeHandUnit | 免费手提行李单位 KG=公斤 PC=件 | String | ticketLuggageRule | |
freeHandLuggage | 免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”) | String | ticketLuggageRule | |
handDescription | 手提行李说明 | String | ticketLuggageRule | |
refundFees | 退票规则费用计算 | Array[] | ||
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | refundFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | refundFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | refundFees | |
fee | 运算后的退改费用(元) | Number | refundFees | |
baseFee | 运算基数 | Number | refundFees | |
feePercent | 费用百分比 | Number | refundFees | |
minimumFee | 保底费用(元) | Number | refundFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | refundFees | |
timingCount | 计时数量 | Integer | refundFees | |
timingUnit | 计时单位:H 小时、D 天 | String | refundFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | refundFees | |
changeFees | 改签规则费用计算 | Array[] | ||
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | changeFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | changeFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | changeFees | |
fee | 运算后的退改费用(元) | Number | changeFees | |
baseFee | 运算基数 | Number | changeFees | |
feePercent | 费用百分比 | Number | changeFees | |
minimumFee | 保底费用(元) | Number | changeFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | changeFees | |
timingCount | 计时数量 | Integer | changeFees | |
timingUnit | 计时单位:H 小时、D 天 | String | changeFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | changeFees | |
secondTicketRule |
中转两段航班时会有值
添加日期: 2024-04-08 |
SecondTicketRule | ||
refundChangeInfo |
退改签信息
添加日期: 2024-04-08 |
String | secondTicketRule | |
refundChangeEnInfo |
退改签英文信息
添加日期: 2024-04-08 |
String | secondTicketRule | |
RefundRuleInfo |
退票规则内容
添加日期: 2024-04-08 |
String | secondTicketRule | |
ChangeRuleInfo |
改签规则内容
添加日期: 2024-04-08 |
String | secondTicketRule | |
transferRuleInfo |
签转规则内容
添加日期: 2024-04-08 |
String | secondTicketRule | |
invalidInfo |
作废规定
添加日期: 2024-04-08 |
String | secondTicketRule | |
isForbidReturn |
是否不得退票(只退未使用税费)
添加日期: 2024-04-08 |
Boolean | secondTicketRule | |
isForbidChange |
是否不得变更
添加日期: 2024-04-08 |
Boolean | secondTicketRule | |
ruleRemark |
退改备注
添加日期: 2024-04-08 |
String | secondTicketRule | |
specialService |
特殊服务
添加日期: 2024-04-08 |
Array[] | secondTicketRule | |
type | 服务类型 | String | secondTicketRule.specialService | |
serviceName | 服务名称 | String | secondTicketRule.specialService | |
serviceDetail | 服务详情 | String | secondTicketRule.specialService | |
ticketLuggageRule |
行李额
添加日期: 2024-04-08 |
TicketLuggageRule | secondTicketRule | |
checkRuleInfo | 托运行李规则内容(托运汇总内容) | String | secondTicketRule.ticketLuggageRule | |
handRuleInfo | 手提行李规则内容(手提汇总内容) | String | secondTicketRule.ticketLuggageRule | |
freeCheckCount | 免费托运行李数量 | String | secondTicketRule.ticketLuggageRule | |
freeCheckUnit | 免费托运行李单位 KG=公斤 PC=件 | String | secondTicketRule.ticketLuggageRule | |
freeCheckLuggage | 免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”) | String | secondTicketRule.ticketLuggageRule | |
checkDescription | 托运行李说明 | String | secondTicketRule.ticketLuggageRule | |
freeHandCount | 免费手提行李数量 | String | secondTicketRule.ticketLuggageRule | |
freeHandUnit | 免费手提行李单位 KG=公斤 PC=件 | String | secondTicketRule.ticketLuggageRule | |
freeHandLuggage | 免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”) | String | secondTicketRule.ticketLuggageRule | |
handDescription | 手提行李说明 | String | secondTicketRule.ticketLuggageRule | |
refundFees |
退票规则费用计算
添加日期: 2024-04-08 |
Array[] | secondTicketRule | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | secondTicketRule.refundFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | secondTicketRule.refundFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | secondTicketRule.refundFees | |
fee | 运算后的退改费用(元) | Number | secondTicketRule.refundFees | |
baseFee | 运算基数 | Number | secondTicketRule.refundFees | |
feePercent | 费用百分比 | Number | secondTicketRule.refundFees | |
minimumFee | 保底费用(元) | Number | secondTicketRule.refundFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | secondTicketRule.refundFees | |
timingCount | 计时数量 | Integer | secondTicketRule.refundFees | |
timingUnit | 计时单位:H 小时、D 天 | String | secondTicketRule.refundFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | secondTicketRule.refundFees | |
changeFees |
改签规则费用计算
添加日期: 2024-04-08 |
Array[] | secondTicketRule | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | secondTicketRule.changeFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | secondTicketRule.changeFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | secondTicketRule.changeFees | |
fee | 运算后的退改费用(元) | Number | secondTicketRule.changeFees | |
baseFee | 运算基数 | Number | secondTicketRule.changeFees | |
feePercent | 费用百分比 | Number | secondTicketRule.changeFees | |
minimumFee | 保底费用(元) | Number | secondTicketRule.changeFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | secondTicketRule.changeFees | |
timingCount | 计时数量 | Integer | secondTicketRule.changeFees | |
timingUnit | 计时单位:H 小时、D 天 | String | secondTicketRule.changeFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | secondTicketRule.changeFees |
{
"refundChangeInfo":"退票规则:航班起飞前7天之前,收取票面价40%(360元)退票费;省略200字", //退改签信息
"invalidInfo":"所有舱位 - 东航 - 作废规则(DEL20010004)【取“销售航司”】", //作废规定
"isForbidReturn":false, //是否不得退票(只退未使用税费)
"isForbidChange":false, //是否不得变更
"specialService":"null", //特殊服务
"refundFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //退票规则费用计算
"changeFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //改签规则费用计算
"ticketLuggageRule":
{
"checkRuleInfo": "", //托运行李规则内容(托运汇总内容)
"handRuleInfo": "", //手提行李规则内容(手提汇总内容)
"freeCheckCount":"1", //免费托运行李数量
"freeCheckUnit":"PC", //免费托运行李单位 KG=公斤 PC=件
"freeCheckLuggage":"1PC", //免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”)
"checkDescription":"1件", //托运行李说明
"freeHandCount": "", //免费手提行李数量
"freeHandUnit": "", //免费手提行李单位 KG=公斤 PC=件
"freeHandLuggage": "", //免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”)
"handDescription": "", //手提行李说明
}, //行李额
"ruleRemark":"RUL20010000的退改规则", //退改备注
"secondTicketRule":
{
"refundChangeInfo": "", //退改签信息
"refundChangeEnInfo": "", //退改签英文信息
"RefundRuleInfo": "", //退票规则内容
"ChangeRuleInfo": "", //改签规则内容
"transferRuleInfo": "", //签转规则内容
"invalidInfo": "", //作废规定
"isForbidReturn":false, //是否不得退票(只退未使用税费)
"isForbidChange":false, //是否不得变更
"specialService":
[{
"type": "", //服务类型
"serviceName": "", //服务名称
"serviceDetail": "", //服务详情
}], //特殊服务
"refundFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //退票规则费用计算
"changeFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //改签规则费用计算
"ticketLuggageRule":
{
"checkRuleInfo": "", //托运行李规则内容(托运汇总内容)
"handRuleInfo": "", //手提行李规则内容(手提汇总内容)
"freeCheckCount":"1", //免费托运行李数量
"freeCheckUnit":"PC", //免费托运行李单位 KG=公斤 PC=件
"freeCheckLuggage":"1PC", //免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”)
"checkDescription":"1件", //托运行李说明
"freeHandCount": "", //免费手提行李数量
"freeHandUnit": "", //免费手提行李单位 KG=公斤 PC=件
"freeHandLuggage": "", //免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”)
"handDescription": "", //手提行李说明
}, //行李额
"ruleRemark": "", //退改备注
}, //中转两段航班时会有值
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
查询国内机票航班价格
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
flightID | 航班ID(GetMoreFlights 接口为QueryFlights返回的 flightID) | String | 是 | |
departureCity | 出发城市(三字码) | String | 是 | |
arrivalCity | 达到城市(三字码) | String | 是 | |
departureDate | 出发日期:yyyy-MM-dd | String | 是 | |
isShowTicketRule |
是否返回退改签规则:1返回(默认)、0:(不返回)
添加日期: 2019-07-16 |
Integer | 否 | |
isCodeShare |
是否返回共享航班:1返回(默认)、0:(不返回)
添加日期: 2019-10-12 |
Integer | 否 | |
receivePayType | 0-信用付 默认不传 ;1-即付,因私默认 即付; | String | 否 | |
bookingType | 预订类型;1= 因公,2 = 因私 | Integer | 否 | |
settlementWay | 结算方式 1 UATP 2 非UATP | String | 否 | |
isOnlyDirectFlight |
是否仅查直飞(仅支持单程),默认是true
添加日期: 2024-04-08 |
Boolean | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"flightID":"8ce833067568c92bb9876ba1c1e56e84", //航班ID(GetMoreFlights 接口为QueryFlights返回的 flightID)
"departureCity":"CAN", //出发城市(三字码)
"arrivalCity":"KMG", //达到城市(三字码)
"departureDate":"2023-12-26", //出发日期:yyyy-MM-dd
"isShowTicketRule":0, //是否返回退改签规则:1返回(默认)、0:(不返回)
"isCodeShare":0, //是否返回共享航班:1返回(默认)、0:(不返回)
"receivePayType":"0", //0-信用付 默认不传 ;1-即付,因私默认 即付;
"bookingType":1, //预订类型;1= 因公,2 = 因私
"settlementWay":"1", //结算方式 1 UATP 2 非UATP
"isOnlyDirectFlight":true, //是否仅查直飞(仅支持单程),默认是true
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
flightInfoList | 返回结果 | Array[] | ||
resultID | 行程ID 比如:去程、回程 | String | flightInfoList | |
segmentID | 航班ID | String | flightInfoList | |
depDate | 出发日期 | String | flightInfoList | |
depTime | 出发时间 | String | flightInfoList | |
arrDate | 到达日期 | String | flightInfoList | |
arrTime | 到达时间 | String | flightInfoList | |
orgCity | 出发城市名称 | String | flightInfoList | |
orgCityCode | 出发城市编码 | String | flightInfoList | |
desCity | 到达城市名称 | String | flightInfoList | |
desCityCode | 到达城市编码 | String | flightInfoList | |
orgAirport | 出发机场名称 | String | flightInfoList | |
orgAirportCode | 出发机场编号 | String | flightInfoList | |
desAirport | 到达机场名称 | String | flightInfoList | |
desAirportCode | 到达机场编号 | String | flightInfoList | |
depTerm | 出发航站楼 | String | flightInfoList | |
arrTerm | 到达航站楼 | String | flightInfoList | |
flightNo | 销售航班号 | String | flightInfoList | |
airlineCode | 销售航司编号 | String | flightInfoList | |
airlineName | 销售航司 | String | flightInfoList | |
planeMode | 机型 | String | flightInfoList | |
isCodeShare | 是否共享航班 | Boolean | flightInfoList | |
carrier | 实际承运航班号;如果销售航班号是共享航班号,那么实际承运航班号才有值的 | String | flightInfoList | |
meal | 餐食 | Boolean | flightInfoList | |
MealCode | 餐食编号 | String | flightInfoList | |
MealName | 餐食名称 B :早餐 C :免费酒精饮料 D :正餐 F :供采购的食物 G :供采购的食物和饮料 H :热膳食 K :轻快早餐 L :午餐 M: 膳食 N :没有饭食供应 O: 冷膳食 P :供采购的酒精饮料 R :茶点 S: 快餐 V :供采购的茶点 | String | flightInfoList | |
tpm | 里程 | Integer | flightInfoList | |
stopNumber | 经停0:无经停,1:有经停 | Integer | flightInfoList | |
fAmount | 头等舱全价 | Number | flightInfoList | |
cAmount | 公务舱全价 | Number | flightInfoList | |
yAmount | 经济舱全价 | Number | flightInfoList | |
secondFlight |
第二段
添加日期: 2024-04-08 |
SecondFlight | flightInfoList | |
depDate |
出发日期
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
depTime |
出发时间
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
arrDate |
到达日期
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
arrTime |
到达时间
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgCity |
出发城市名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgCityCode |
出发城市编码
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desCity |
到达城市名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desCityCode |
到达城市编码
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgAirport |
出发机场名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgAirportCode |
出发机场编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desAirport |
到达机场名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desAirportCode |
到达机场编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
depTerm |
出发航站楼
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
arrTerm |
到达航站楼
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
flightNo |
销售航班号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
airlineCode |
销售航司编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
airlineName |
销售航司
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
planeMode |
机型
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
isCodeShare |
是否共享航班
添加日期: 2024-04-08 |
Boolean | flightInfoList.secondFlight | |
carrier |
实际承运航班号;如果销售航班号是共享航班号,那么实际承运航班号才有值的
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
meal |
餐食
添加日期: 2024-04-08 |
Boolean | flightInfoList.secondFlight | |
MealCode |
餐食编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
MealName |
餐食名称
B :早餐
C :免费酒精饮料
D :正餐
F :供采购的食物
G :供采购的食物和饮料
H :热膳食
K :轻快早餐
L :午餐
M: 膳食
N :没有饭食供应
O: 冷膳食
P :供采购的酒精饮料
R :茶点
S: 快餐
V :供采购的茶点
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopNumber |
经停0:无经停,1:有经停
添加日期: 2024-04-08 |
Integer | flightInfoList.secondFlight | |
carrierAirlineName |
实际承运航司中文名
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopCityName |
经停城市名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopCityCode |
经停城市三字码
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopTime |
经停时长
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopItemList |
经停的具体项,仅当stopNumber>0时有数据
添加日期: 2024-04-08 |
Array[] | flightInfoList.secondFlight | |
cityName | 城市的中文说明 | String | flightInfoList.secondFlight.stopItemList | |
depTime | 从该经停地起飞的时间 | String | flightInfoList.secondFlight.stopItemList | |
arrTime | 到达该经停地的时间 | String | flightInfoList.secondFlight.stopItemList | |
flightPriceInfoList | 价格信息 | Array[] | flightInfoList | |
priceID | 价格ID | String | flightInfoList.flightPriceInfoList | |
flightID | 航段序号(等于resultID+segmentID+priceID下划线分割) | String | flightInfoList.flightPriceInfoList | |
discount | 折扣 | Number | flightInfoList.flightPriceInfoList | |
ticketPrice | 票价 | Number | flightInfoList.flightPriceInfoList | |
airPortFee | 机场建设费 | Number | flightInfoList.flightPriceInfoList | |
oilFee | 燃油费 | Number | flightInfoList.flightPriceInfoList | |
serviceAmount | 服务费 | Number | flightInfoList.flightPriceInfoList | |
airlineYouHui | 航司优惠 | Number | flightInfoList.flightPriceInfoList | |
meiYaYouHui | 美亚优惠 | Number | flightInfoList.flightPriceInfoList | |
amount | 舱位公布运价 | Number | flightInfoList.flightPriceInfoList | |
airlineYouHuiAmount | 机票票面价 | Number | flightInfoList.flightPriceInfoList | |
cabinType | 舱位(如:Y) | String | flightInfoList.flightPriceInfoList | |
cabin | 舱位等级 | String | flightInfoList.flightPriceInfoList | |
clazzName | 舱位名称 | String | flightInfoList.flightPriceInfoList | |
cabinAliasNameCn |
舱等别名-中文
添加日期: 2023-10-17 |
String | flightInfoList.flightPriceInfoList | |
cabinAliasNameEn |
舱等别名-英文
添加日期: 2023-10-17 |
String | flightInfoList.flightPriceInfoList | |
refundChangeInfo | 退改条款 | String | flightInfoList.flightPriceInfoList | |
violate | 违反差旅政策标识(0表示不违反,1表示违反但不是强制的,2标示违反强制差旅政策) | Integer | flightInfoList.flightPriceInfoList | |
seatNum | 座位数(9张或9张以上:A;1-8张:具体座位数) | String | flightInfoList.flightPriceInfoList | |
protocolType | 协议类型(0:非协议价;1、2协议价) | Integer | flightInfoList.flightPriceInfoList | |
isForbidReturn | 不得退票(只退未使用税费) | Boolean | flightInfoList.flightPriceInfoList | |
isForbidChange | 不得变更 | Boolean | flightInfoList.flightPriceInfoList | |
luggageRule | 行李额规则 | String | flightInfoList.flightPriceInfoList | |
fareType | 运价来源; PUBLIC 公布运价,PRIVATE 私有运价 AGREEMENT 协议价 | String | flightInfoList.flightPriceInfoList | |
refundRuleInfo | 退票规则内容 | String | flightInfoList.flightPriceInfoList | |
changeRuleInfo | 改签规则内容 | String | flightInfoList.flightPriceInfoList | |
transferRuleInfo | 签转规则内容 | String | flightInfoList.flightPriceInfoList | |
purchaseRule | 购票规定 | ApiTicketPricePurchaseRule | flightInfoList.flightPriceInfoList | |
content | 内容 | String | flightInfoList.flightPriceInfoList.purchaseRule | |
categories | 分类 | Array[] | flightInfoList.flightPriceInfoList.purchaseRule | |
type | 类型,0=小团专享,1=青年特惠,2=长者特惠 | String | flightInfoList.flightPriceInfoList.purchaseRule.categories | |
content | 内容 | String | flightInfoList.flightPriceInfoList.purchaseRule.categories | |
structor | 内容结构 | ApiTicketPricePurchaseRuleStruct | flightInfoList.flightPriceInfoList.purchaseRule | |
minCount | 最小旅客数量(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
maxCount | 最大旅客数量(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
minAge | 最小年龄(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
maxAge | 最大年龄(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
certificateTypes | 证件类型(身份证/因私护照/因公护照等等) | Array[] | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
gertificateNumber | 证件号码限制 | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
genders | 性别(男/女) | Array[] | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
ticketLuggageRule | 行李额 | TicketLuggageRule | flightInfoList.flightPriceInfoList | |
checkRuleInfo | 托运行李规则内容(托运汇总内容) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
handRuleInfo | 手提行李规则内容(手提汇总内容) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeCheckCount | 免费托运行李数量 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeCheckUnit | 免费托运行李单位 KG=公斤 PC=件 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeCheckLuggage | 免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
checkDescription | 托运行李说明 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeHandCount | 免费手提行李数量 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeHandUnit | 免费手提行李单位 KG=公斤 PC=件 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeHandLuggage | 免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
handDescription | 手提行李说明 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
refundFees | 退票规则费用计算 | Array[] | flightInfoList.flightPriceInfoList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | flightInfoList.flightPriceInfoList.refundFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.refundFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.refundFees | |
fee | 运算后的退改费用(元) | Number | flightInfoList.flightPriceInfoList.refundFees | |
baseFee | 运算基数 | Number | flightInfoList.flightPriceInfoList.refundFees | |
feePercent | 费用百分比 | Number | flightInfoList.flightPriceInfoList.refundFees | |
minimumFee | 保底费用(元) | Number | flightInfoList.flightPriceInfoList.refundFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | flightInfoList.flightPriceInfoList.refundFees | |
timingCount | 计时数量 | Integer | flightInfoList.flightPriceInfoList.refundFees | |
timingUnit | 计时单位:H 小时、D 天 | String | flightInfoList.flightPriceInfoList.refundFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | flightInfoList.flightPriceInfoList.refundFees | |
changeFees | 改签规则费用计算 | Array[] | flightInfoList.flightPriceInfoList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | flightInfoList.flightPriceInfoList.changeFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.changeFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.changeFees | |
fee | 运算后的退改费用(元) | Number | flightInfoList.flightPriceInfoList.changeFees | |
baseFee | 运算基数 | Number | flightInfoList.flightPriceInfoList.changeFees | |
feePercent | 费用百分比 | Number | flightInfoList.flightPriceInfoList.changeFees | |
minimumFee | 保底费用(元) | Number | flightInfoList.flightPriceInfoList.changeFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | flightInfoList.flightPriceInfoList.changeFees | |
timingCount | 计时数量 | Integer | flightInfoList.flightPriceInfoList.changeFees | |
timingUnit | 计时单位:H 小时、D 天 | String | flightInfoList.flightPriceInfoList.changeFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | flightInfoList.flightPriceInfoList.changeFees |
{
"flightInfoList":
[{
"resultID":"bbe4b225e9094de38e8750b6be292695", //行程ID 比如:去程、回程
"segmentID":"fb84a4ca567c4c56936e7ad739a60333", //航班ID
"depDate":"2023-12-26", //出发日期
"depTime":"06:30", //出发时间
"arrDate":"2023-12-26", //到达日期
"arrTime":"09:00", //到达时间
"orgCity":"广州", //出发城市名称
"orgCityCode":"CAN", //出发城市编码
"desCity":"昆明", //到达城市名称
"desCityCode":"KMG", //到达城市编码
"orgAirport":"白云国际机场", //出发机场名称
"orgAirportCode":"CAN", //出发机场编号
"desAirport":"长水国际机场", //到达机场名称
"desAirportCode":"KMG", //到达机场编号
"depTerm":"T1", //出发航站楼
"arrTerm":"T1", //到达航站楼
"flightNo":"MU6823", //销售航班号
"airlineCode":"MU", //销售航司编号
"airlineName":"东方航空-东", //销售航司
"planeMode":"波音73L(中)", //机型
"isCodeShare":false, //是否共享航班
"carrier":"null", //实际承运航班号;如果销售航班号是共享航班号,那么实际承运航班号才有值的
"meal":false, //餐食
"MealCode":"0", //餐食编号
"MealName":"null", //餐食名称
B :早餐
C :免费酒精饮料
D :正餐
F :供采购的食物
G :供采购的食物和饮料
H :热膳食
K :轻快早餐
L :午餐
M: 膳食
N :没有饭食供应
O: 冷膳食
P :供采购的酒精饮料
R :茶点
S: 快餐
V :供采购的茶点
"tpm":0, //里程
"stopNumber":0, //经停0:无经停,1:有经停
"fAmount":5450.0, //头等舱全价
"cAmount":4950.0, //公务舱全价
"yAmount":1980.0, //经济舱全价
"flightPriceInfoList":
[{
"priceID":"1", //价格ID
"flightID":"bbe4b225e9094de38e8750b6be292695_fb84a4ca567c4c56936e7ad739a60333_1", //航段序号(等于resultID+segmentID+priceID下划线分割)
"discount":33.8, //折扣
"ticketPrice":670.0, //票价
"airPortFee":50.0, //机场建设费
"oilFee":130.0, //燃油费
"serviceAmount":10.0, //服务费
"airlineYouHui":0.0, //航司优惠
"meiYaYouHui":0.0, //美亚优惠
"amount":670.0, //舱位公布运价
"airlineYouHuiAmount":670.0, //机票票面价
"cabinType":"V", //舱位(如:Y)
"cabin":"经济舱", //舱位等级
"clazzName":"经济舱", //舱位名称
"cabinAliasNameCn":"null", //舱等别名-中文
"cabinAliasNameEn":"null", //舱等别名-英文
"refundChangeInfo":"null", //退改条款
"violate":0, //违反差旅政策标识(0表示不违反,1表示违反但不是强制的,2标示违反强制差旅政策)
"seatNum":"A", //座位数(9张或9张以上:A;1-8张:具体座位数)
"protocolType":0, //协议类型(0:非协议价;1、2协议价)
"isForbidReturn":false, //不得退票(只退未使用税费)
"isForbidChange":false, //不得变更
"luggageRule":"免费托运行李额20KG,免费手提行李额10KG。(免费携带1件10KG以内)", //行李额规则
"fareType":"PRIVATE", //运价来源; PUBLIC 公布运价,PRIVATE 私有运价 AGREEMENT 协议价
"refundFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //退票规则费用计算
"changeFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //改签规则费用计算
"ticketLuggageRule":
{
"checkRuleInfo": "", //托运行李规则内容(托运汇总内容)
"handRuleInfo": "", //手提行李规则内容(手提汇总内容)
"freeCheckCount":"1", //免费托运行李数量
"freeCheckUnit":"PC", //免费托运行李单位 KG=公斤 PC=件
"freeCheckLuggage":"1PC", //免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”)
"checkDescription":"1件", //托运行李说明
"freeHandCount": "", //免费手提行李数量
"freeHandUnit": "", //免费手提行李单位 KG=公斤 PC=件
"freeHandLuggage": "", //免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”)
"handDescription": "", //手提行李说明
}, //行李额
"refundRuleInfo":"null", //退票规则内容
"changeRuleInfo":"null", //改签规则内容
"transferRuleInfo":"null", //签转规则内容
"purchaseRule":
{
"content": "", //内容
"categories":
[{
"type": "", //类型,0=小团专享,1=青年特惠,2=长者特惠
"content": "", //内容
}], //分类
"structor":
{
"minCount": "", //最小旅客数量(空为不限)
"maxCount": "", //最大旅客数量(空为不限)
"minAge": "", //最小年龄(空为不限)
"maxAge": "", //最大年龄(空为不限)
"certificateTypes":[], //证件类型(身份证/因私护照/因公护照等等)
"gertificateNumber": "", //证件号码限制
"genders":[], //性别(男/女)
}, //内容结构
}, //购票规定
}], //价格信息
"secondFlight":"1980.0", //第二段
}], //返回结果
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
根据航班,查询经停信息
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
flightNumber | 航班号(共享航班为实际承运人航班号) | String | 是 | |
departureDate | 起飞日期 yyyy-MM-dd | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"flightNumber":"MU5742", //航班号(共享航班为实际承运人航班号)
"departureDate":"2023-10-25", //起飞日期 yyyy-MM-dd
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
stopItemList | 返回结果 | Array[] | ||
cityName | 城市的中文说明 | String | stopItemList | |
depTime | 从该经停地起飞的时间 | String | stopItemList | |
arrTime | 到达该经停地的时间 | String | stopItemList |
{
"stopItemList":
[{
"cityName":"广州", //城市的中文说明
"depTime":"2023-10-25 10:30", //从该经停地起飞的时间
"arrTime":"2023-10-25 8:30", //到达该经停地的时间
}], //返回结果
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票机型信息
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
typeNumber | 机型号 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"typeNumber":"32L", //机型号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
planeType | 返回结果 | TpPlaneType | ||
typeNumber | 机型 | String | planeType | |
typeName | 机型名称 | String | planeType | |
bodyType | 类型,宽体、窄体 | String | planeType | |
minSeatNumber | 最小座位数,无具体数据则默认为0 | Integer | planeType | |
maxSeatNumber | 最大座位数,无具体数据则默认为0 | Integer | planeType |
{
"planeType":
{
"typeNumber":"32L", //机型
"typeName":"空客320", //机型名称
"bodyType":"窄体", //类型,宽体、窄体
"minSeatNumber":0, //最小座位数,无具体数据则默认为0
"maxSeatNumber":0, //最大座位数,无具体数据则默认为0
}, //返回结果
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
预订前验舱验价
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
flightId | 查询航班返回的 flightId | String | 是 | |
departureCity | 出发机场三字码 | String | 否 | |
arrivalCity | 达到机场三字码 | String | 否 | |
departureDate | 出发日期 | String | 否 | |
flightNo | 航班号 | String | 否 | |
price | 价格 | Number | 否 | |
cabinType | 舱位等级代码(如Y、L等) | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"flightId":"88a8333b6b884eee91e3e6d4a15b8504_f75314b3bb174d5fa02707373a94230f_6", //查询航班返回的 flightId
"departureCity":"KWE", //出发机场三字码
"arrivalCity":"CAN", //达到机场三字码
"departureDate":"2023-10-25", //出发日期
"flightNo":"CZ6394", //航班号
"price":720, //价格
"cabinType":"S", //舱位等级代码(如Y、L等)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
IsChangePrice | 是否变价(变价code=10000) | Boolean | ||
newPrice | 新价格 | Number | ||
isNoseat | 是否无座:true:无座(无座code=60007) | Boolean | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"IsChangePrice":false, //是否变价(变价code=10000)
"newPrice":720, //新价格
"isNoseat":false, //是否无座:true:无座(无座code=60007)
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票创建订单
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsideOrderNo | 外部订单号 | String | 否 | |
opRemark | 备注 | String | 否 | |
oaSerialnumber | 出差申请单号 | String | 否 | |
bookType | 默认不传为0, 0-因公 ;1-因私; | String | 是 | |
receivePayType | 默认不传为0, 0-信用付;1-即付, 3-预存款支付,因私默认0; | String | 是 | |
uatpCompany |
指定UATP公司
0:美亚运算 1 快钱 2 嘉惠 3 虫洞 4 中航结(商务卡) 5 易商旅 6.中航结(UATP卡) 添加日期: 2021-10-18 |
Integer | 否 | |
isUatp |
是否使用uatp(默认true)
仅已签订uatp出票协议时有效 添加日期: 2021-10-18 |
Boolean | 否 | |
IsAutoSubmit | 是否自动提交,如果没有审批流程自动审批的话则赋值为true,否则为false | Boolean | 是 | |
InvoiceType | 客户所需发票类型 默认=0 ( 0=纸质行程单 1=电子行程单 ) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
contactList | 联系人信息 | ContactInfo | 是 | |
contactName | 联系人 | String | contactList | |
mobile | 手机号码 | String | contactList | |
phone | 联系电话 | String | contactList | |
电子邮件 | String | contactList | ||
flightList | 选择的航班ID | Array[] | 是 | |
flightID | 航班ID(从查询航班返回获取) | String | flightList | |
departureCity | 出发城市(三字码) | String | flightList | |
arrivalCity | 达到城市(三字码) | String | flightList | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList | |
airline | 航空二字码,如 MU | String | flightList | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList | |
secondFlight | 预订多程中转航班时需要必传; | FlightInfoForCreateBase | flightList | |
flightID | 航班ID(从查询航班返回获取) | String | flightList.secondFlight | |
departureCity | 出发城市(三字码) | String | flightList.secondFlight | |
arrivalCity | 达到城市(三字码) | String | flightList.secondFlight | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList.secondFlight | |
airline | 航空二字码,如 MU | String | flightList.secondFlight | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList.secondFlight | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList.secondFlight | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList.secondFlight | |
passengerList | 旅客列表 | Array[] | 是 | |
uatpCardNameList | uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
uatpCardNumberList | uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
outsidePassengerId | 对接方系统的旅客编号 | String | passengerList | |
passengerId | 美亚旅客编号(不用传) | String | passengerList | |
passengerName | 乘机人姓名 | String | passengerList | |
passengerType | 旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿) | String | passengerList | |
companyId | 公司编号 | String | passengerList | |
sex | 必传 性别:男/女;不能传其他字符 | String | passengerList | |
cnName | 中文姓名(中文姓名、英文姓名2选一) | String | passengerList | |
enName | 英文姓名(中文姓名、英文姓名2选一,格式:zhang/san) | String | passengerList | |
userName | 登录用户名 | String | passengerList | |
dId | 部门ID(不传) | Integer | passengerList | |
dName | 部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | passengerList | |
nationality | 国籍:中国填写 CN,必传 | String | passengerList | |
birthday | 出生日期(yyyy-MM-dd)必传 | String | passengerList | |
mobile | 手机号码 | String | passengerList | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | passengerList | |
电子邮箱 | String | passengerList | ||
defaultRoleId | 默认角色 | String | passengerList | |
postID | 职位ID | String | passengerList | |
SuperVip | 0:非VIP 1VIP | Integer | passengerList | |
phone | 固定电话 | String | passengerList | |
XoSplitNumber |
行程单分拣编号
添加日期: 2021-10-18 |
String | passengerList | |
chooseSeatNo | 在线选座(火车票)如:1A | String | passengerList | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | passengerList | |
insuranceList | 保险产品信息 | Array[] | passengerList | |
insuranceId | 保险产品编号(联系美亚获取) | Integer | passengerList.insuranceList | |
insuranceCount | 保险份数(一般最大是两份) | Integer | passengerList.insuranceList | |
certificatePhoto | 证件图片信息(只有国际机票使用,其他产品传null 或者不处理) | CertificatePhoto | passengerList | |
fileName | 文件名称 | String | passengerList.certificatePhoto | |
fileCode | 文件流 | String | passengerList.certificatePhoto | |
CostList | 成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可 | Array[] | passengerList | |
remark | 备注 | String | passengerList.CostList | |
costCenterName | 成本中心名称 | String | passengerList.CostList | |
amount | 总金额, | Number | passengerList.CostList | |
frequentTraveller | 常旅卡信息 | FrequentTraveller | passengerList | |
airlineCode | 航司二字码 | String | passengerList.frequentTraveller | |
cardName | 常旅卡名称 | String | passengerList.frequentTraveller | |
cardNumber | 常旅卡号 | String | passengerList.frequentTraveller | |
certificatesList | 证件 | Array[] | passengerList | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | passengerList.certificatesList | |
certNumber | 证件号码 | String | passengerList.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | passengerList.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | passengerList.certificatesList |
{
"outsideOrderNo":"SLX154488874", //外部订单号
"opRemark":"订单备注说明", //备注
"oaSerialnumber":"SLX154488874", //出差申请单号
"flightList":
[{
"secondFlight":
{
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}, //预订多程中转航班时需要必传;
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}], //选择的航班ID
"passengerList":
[{
"uatpCardNameList":"null", //uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理)
"uatpCardNumberList":"null", //uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理)
"outsidePassengerId":"ak10002", //对接方系统的旅客编号
"passengerId": "", //美亚旅客编号(不用传)
"passengerName":"刘展超", //乘机人姓名
"passengerType":"成人", //旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿)
"companyId":"S118022", //公司编号
"sex":"男", //必传 性别:男/女;不能传其他字符
"cnName":"刘展超", //中文姓名(中文姓名、英文姓名2选一)
"enName":"liu/zhanchao", //英文姓名(中文姓名、英文姓名2选一,格式:zhang/san)
"userName":"AK_liuzhanchao", //登录用户名
"dId":0, //部门ID(不传)
"dName":"美亚集团/旅游产品部/运营中心", //部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"nationality":"CN", //国籍:中国填写 CN,必传
"birthday":"2000-01-20", //出生日期(yyyy-MM-dd)必传
"mobile":"18628535565", //手机号码
"mobileAreaCode":"556", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"CostList":
[{
"remark": "", //备注
"costCenterName": "", //成本中心名称
"amount":0, //总金额
}], //成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件
"defaultRoleId": "", //默认角色
"postID":"一厂经理", //职位ID
"SuperVip":0, //0:非VIP 1VIP
"phone":"020-82862903", //固定电话
"insuranceList":
[{
"insuranceId":0, //保险产品编号(联系美亚获取)
"insuranceCount":0, //保险份数(一般最大是两份)
}], //保险产品信息
"XoSplitNumber":"BK8525858", //行程单分拣编号
"chooseSeatNo": "", //在线选座(火车票)如:1A
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
"frequentTraveller":
{
"airlineCode":"MU", //航司二字码
"cardName":"东方明珠积分卡", //常旅卡名称
"cardNumber":"7894587775", //常旅卡号
}, //常旅卡信息
"certificatePhoto":
{
"fileName":"我的证件.jpg", //文件名称
"fileCode":"ADWHIFHWFJJSFJWFJ...", //文件流
}, //证件图片信息(只有国际机票使用,其他产品传null 或者不处理)
}], //旅客列表
"contactList":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"bookType":"0", //默认不传为0, 0-因公 ;1-因私;
"receivePayType":"0", //默认不传为0, 0-信用付;1-即付, 3-预存款支付,因私默认0;
"uatpCompany":0, //指定UATP公司
"isUatp":false, //是否使用uatp(默认true)
"IsAutoSubmit":false, //是否自动提交,如果没有审批流程自动审批的话则赋值为true,否则为false
"InvoiceType":0, //客户所需发票类型
默认=0 ( 0=纸质行程单 1=电子行程单 )
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNos | 订单号列表 | Array[] | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNos":"['TB2301739801']", //订单号列表
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票价格校验
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code |
返回代码,10000=成功,其他为错误
40001 提交/验价订单时协议出错 40002 提交/验价订单时价格变化 |
String | ||
description | 执行结果描述 | String | ||
priceInfo | PAT信息,只有出票时变价才返回 | PATPriceInfo | ||
newPrice | 新价格 | Number | priceInfo | |
oldPrice | 旧价格 | Number | priceInfo |
{
"priceInfo":
{
"newPrice":1500.00, //新价格
"oldPrice":1350.00, //旧价格
}, //PAT信息,只有出票时变价才返回
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票取消订单
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单编号, 共用的实体,订单号展示只做示例 | String | 是 | |
cancelReasonId | Integer | 否 | ||
cancelReason | 取消原因 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //订单编号, 共用的实体,订单号展示只做示例
"cancelReasonId":0, //
"cancelReason": "", //取消原因
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票提交审批
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code |
返回代码,10000=成功,其他为错误
40001 提交/验价订单时协议出错 40002 提交/验价订单时价格变化 |
String | ||
description | 执行结果描述 | String | ||
priceInfo | PAT信息,只有出票时变价才返回 | PATPriceInfo | ||
newPrice | 新价格 | Number | priceInfo | |
oldPrice | 旧价格 | Number | priceInfo |
{
"priceInfo":
{
"newPrice":1500.00, //新价格
"oldPrice":1350.00, //旧价格
}, //PAT信息,只有出票时变价才返回
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票订单列表,最新版本,新对接客户使用该接口,勿使用旧版本
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderType |
订单类型
国内机票 0:全部; 1:国内机票订购单; 2:国内机票改签单; 3:国内机票退票单 国际机票 0:全部; 11:国际机票订购单; 12:国际机票改签单; 13:国际机票退票单 |
Integer | 否 | |
originalOrderNo | 美亚原订购单号 | String | 否 | |
staffCode | 制单人的外部系统编号 | String | 否 | |
orderNo | 订单号,单个查则传订单号 | String | 否 | |
departureCity | 出发机场 三字码(如:CAN) | String | 否 | |
arrivalCity | 到达机场 三字码(如:CAN) | String | 否 | |
startTime | 制单时间范围(开始),大于 2023-10-23 00:00:00 | String | 否 | |
endTime | 制单时间范围(结束),小于 2023-10-24 00:00:00 | String | 否 | |
startDepartureTime | 出发时间范围(开始),大于 2023-10-25 00:00:00 | String | 否 | |
endDepartureTime | 出发时间范围(结束),小于 2023-10-28 00:00:00 | String | 否 | |
orderStatus |
订单状态(国际机票只包含:0、40,70,80)
0:全部 5 :待提交 10 :审批中 20 :待收款 25 :待付款 30 :出票中 35 :紧急处理 40 :已出票 50 :已取消 60 :待核对 70 :处理中 75 :紧急处理 80 :已处理 200:待审核 |
Integer | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数(最大50) | Integer | 否 | |
bookType | 0因公 1因私 其他数字查全部(2023-09-25加) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderType":0, //订单类型
"originalOrderNo": "", //美亚原订购单号
"staffCode": "", //制单人的外部系统编号
"orderNo": "", //订单号,单个查则传订单号
"departureCity": "", //出发机场 三字码(如:CAN)
"arrivalCity": "", //到达机场 三字码(如:CAN)
"startTime":"2023-10-23", //制单时间范围(开始),大于 2023-10-23 00:00:00
"endTime":"2023-10-23", //制单时间范围(结束),小于 2023-10-24 00:00:00
"startDepartureTime":"2023-10-25", //出发时间范围(开始),大于 2023-10-25 00:00:00
"endDepartureTime":"2023-10-28", //出发时间范围(结束),小于 2023-10-28 00:00:00
"orderStatus":0, //订单状态(国际机票只包含:0、40,70,80)
"pageIndex":1, //页码
"pageSize":50, //每页记录数(最大50)
"bookType":0, //0因公 1因私 其他数字查全部(2023-09-25加)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
totalCount | 总记录数 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
orderList | 订单信息 | Array[] | ||
companyId | 公司编号 | String | orderList | |
companyName | 公司名称 | String | orderList | |
orderNo | 美亚订单号 | String | orderList | |
originalOrderNo | 原订单编号 改签、退票、废票单的原单编号,订购单时为空 | String | orderList | |
opDate | 建单时间 | String | orderList | |
opId | 建单人 | String | orderList | |
opStaffCode | 建单人员工工号 | String | orderList | |
opName | 客户制单人 | String | orderList | |
onBusiness | 订单类型(1:因公;0:因私) | Integer | orderList | |
receivePayType | 返回字符串,支付方式:月结 或 现结 | String | orderList | |
statusText | 订单状态(中文) | String | orderList | |
status |
订单状态(国际机票只包含:40,70,80)
5 :待提交 10 :审批中 20 :待收款 25 :待付款 30 :出票中 35 :紧急处理 40 :已出票 50 :已取消 60 :待核对 70 :处理中 75 :紧急处理 80 :已处理 200:待审核 |
Integer | orderList | |
orderType |
订单类型
1:国内机票订购单; 2:国内机票改签单; 3:国内机票退票单; 11:国际机票订购单; 12:国际机票改签单; 13:国际机票退票单 |
Integer | orderList | |
oaSerialnumber | 出差申请单号,外部系统关联单号会放这里返回 | String | orderList | |
totalPrice | 订单总金额 | Number | orderList | |
passengerList | 旅客信息 | Array[] | orderList | |
passengerNo | 旅客排序号(从1开始递增) | Integer | orderList.passengerList | |
passengerCode | 旅客编号 | String | orderList.passengerList | |
passengerName | 旅客姓名 | String | orderList.passengerList | |
certificateType | 证件类型 | String | orderList.passengerList | |
certificateId | 证件号码 | String | orderList.passengerList | |
passengerType | 旅客类型(成人/儿童/婴儿) | String | orderList.passengerList | |
ticketNo | 机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系) | String | orderList.passengerList | |
staffCode | 员工工号 | String | orderList.passengerList | |
mobile | 旅客手机号码 | String | orderList.passengerList | |
旅客邮箱,国际机票使用 | String | orderList.passengerList | ||
statusDesc | 客票状态描述 | String | orderList.passengerList | |
ticketStatus | 票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到 | String | orderList.passengerList | |
depName |
部门名称,用/分隔(列表返回最后一级,详细返回全级)
添加日期: 2018-10-18 |
String | orderList.passengerList | |
segmentList | 航段信息 | Array[] | orderList | |
cabin |
舱位等级(1/2/3/4)
1 经济舱 2 公务舱 3 头等舱 4 豪华经济舱 |
String | orderList.segmentList | |
clazz | 小舱位(如:Y/Z/...) | String | orderList.segmentList | |
clazzName | 舱位名称 | String | orderList.segmentList | |
planeType | 机型 | String | orderList.segmentList | |
airlineCode | 销售航司编号(如:HU) | String | orderList.segmentList | |
segmentNo | 航段序号(从1开始) | Integer | orderList.segmentList | |
flightNumber | 销售航班号 | String | orderList.segmentList | |
originName | 出发机场名称 | String | orderList.segmentList | |
originCountryName | 出发地区或国家名称 | String | orderList.segmentList | |
originCountryCode | 出发地区或国家二字码 | String | orderList.segmentList | |
destinationName | 到达机场名称 | String | orderList.segmentList | |
destinationCountryName | 到达地区或国家名称 | String | orderList.segmentList | |
destinationCountryCode | 到达地区或国家二字码 | String | orderList.segmentList | |
departureDate | 出发日期 | String | orderList.segmentList | |
departureTime | 出发时间 | String | orderList.segmentList | |
arrivalDate | 到达日期 | String | orderList.segmentList | |
arrivalTime | 到达时间 | String | orderList.segmentList | |
flyTime | 飞行时间(分钟) | String | orderList.segmentList | |
carrier | 实际承运航班号(如果销售航班号是共享航班号,那么实际承运航班号才有值的) | String | orderList.segmentList | |
stopItem | 经停信息(格式:经停城市|到达时间|起飞时间)(如:上饶|2018-04-23 18:05|2018-04-23 18:55) | String | orderList.segmentList | |
originCityCode | 出发机场编码 | String | orderList.segmentList | |
destinationCityCode | 到达机场编码 | String | orderList.segmentList | |
origincityName | 出发城市名称 | String | orderList.segmentList | |
destinationCityName | 到达城市名称 | String | orderList.segmentList | |
depTerminal | 出发航站楼 | String | orderList.segmentList | |
arrTerminal | 到达航站楼(不详时传 --) | String | orderList.segmentList | |
airlineName | 航司名称 | String | orderList.segmentList | |
remark | 备注 | String | orderList.segmentList | |
ruleInfo | 航班退改规则; | String | orderList.segmentList | |
amount | 公布运价;(国际机票无公布运价) | Number | orderList.segmentList | |
fAmount | 头等舱标准价;(国际机票无头等舱标准价) | Number | orderList.segmentList | |
cAmount | 公务舱标准价;(国际机票无公务舱标准价) | Number | orderList.segmentList | |
yAmount | 经济舱标准价(国际机票无经济舱标准价) | Number | orderList.segmentList | |
mileage |
里程
添加日期: 2024-04-25 |
Number | orderList.segmentList | |
isProtocolPrice |
协议类型:0非协议票,1三方协议,2两方协议
添加日期: 2024-04-25 |
Integer | orderList.segmentList | |
destinationCityNameEn |
到达城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
destinationNameEng |
到达机场英文名 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
origincityNameEn |
出发城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
originNameEng |
出发机场英文名 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
stopType |
有无经停 0无 1有
添加日期: 2024-04-25 |
Integer | orderList.segmentList | |
stopCityName |
停留城市名称 PM2024123 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
stopCityNameEn |
停留城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
meal |
有无餐食:0 无 1 有 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
airlineNameEng |
航司英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
JourneyIndex |
行程序号 1-第一程;2-第二程;3-第三程
添加日期: 2024-05-07 |
String | orderList.segmentList | |
refundRuleInfo | 退票规则内容 | String | orderList.segmentList | |
changeRuleInfo | 改签规则内容 | String | orderList.segmentList | |
transferRuleInfo | 签转规则内容 | String | orderList.segmentList | |
segmentIndex |
航段序号(1开始,展示用)
添加日期: 2025-02-12 |
Integer | orderList.segmentList | |
departureDiffHour | 出发地时差 正负数值 2025-03-21之前下单的数据为空值 null | Number | orderList.segmentList | |
arrivalDiffHour |
出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
添加日期: 2025-02-21 |
Number | orderList.segmentList | |
originProvinceCN | 出发国家省州中文名 | String | orderList.segmentList | |
originProvinceEN | 出发国家省州英文名 | String | orderList.segmentList | |
originContinentCN | 出发机场所属大洲中文名 | String | orderList.segmentList | |
originContinentEN | 出发机场所属大洲英文名 | String | orderList.segmentList | |
destinationContinentCN | 到达机场所属大洲中文名 | String | orderList.segmentList | |
destinationContinentEN | 到达机场所属大洲英文名 | String | orderList.segmentList | |
departureTimeZone | 到达时区 | String | orderList.segmentList | |
originTimeZone | 出发时区 | String | orderList.segmentList | |
originCountryNameEN | 出发国家英文名称 | String | orderList.segmentList | |
destinationCountryNameEN | 到达国家英文名称 | String | orderList.segmentList | |
routeType | 航线类型,长航线-短航线 暂无实际数据 | String | orderList.segmentList | |
ticketLuggageRule | 行李额 | TicketLuggageRule | orderList.segmentList | |
checkRuleInfo | 托运行李规则内容(托运汇总内容) | String | orderList.segmentList.ticketLuggageRule | |
handRuleInfo | 手提行李规则内容(手提汇总内容) | String | orderList.segmentList.ticketLuggageRule | |
freeCheckCount | 免费托运行李数量 | String | orderList.segmentList.ticketLuggageRule | |
freeCheckUnit | 免费托运行李单位 KG=公斤 PC=件 | String | orderList.segmentList.ticketLuggageRule | |
freeCheckLuggage | 免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”) | String | orderList.segmentList.ticketLuggageRule | |
checkDescription | 托运行李说明 | String | orderList.segmentList.ticketLuggageRule | |
freeHandCount | 免费手提行李数量 | String | orderList.segmentList.ticketLuggageRule | |
freeHandUnit | 免费手提行李单位 KG=公斤 PC=件 | String | orderList.segmentList.ticketLuggageRule | |
freeHandLuggage | 免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”) | String | orderList.segmentList.ticketLuggageRule | |
handDescription | 手提行李说明 | String | orderList.segmentList.ticketLuggageRule | |
refundFees | 退票规则费用计算 | Array[] | orderList.segmentList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | orderList.segmentList.refundFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | orderList.segmentList.refundFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | orderList.segmentList.refundFees | |
fee | 运算后的退改费用(元) | Number | orderList.segmentList.refundFees | |
baseFee | 运算基数 | Number | orderList.segmentList.refundFees | |
feePercent | 费用百分比 | Number | orderList.segmentList.refundFees | |
minimumFee | 保底费用(元) | Number | orderList.segmentList.refundFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | orderList.segmentList.refundFees | |
timingCount | 计时数量 | Integer | orderList.segmentList.refundFees | |
timingUnit | 计时单位:H 小时、D 天 | String | orderList.segmentList.refundFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | orderList.segmentList.refundFees | |
changeFees | 改签规则费用计算 | Array[] | orderList.segmentList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | orderList.segmentList.changeFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | orderList.segmentList.changeFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | orderList.segmentList.changeFees | |
fee | 运算后的退改费用(元) | Number | orderList.segmentList.changeFees | |
baseFee | 运算基数 | Number | orderList.segmentList.changeFees | |
feePercent | 费用百分比 | Number | orderList.segmentList.changeFees | |
minimumFee | 保底费用(元) | Number | orderList.segmentList.changeFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | orderList.segmentList.changeFees | |
timingCount | 计时数量 | Integer | orderList.segmentList.changeFees | |
timingUnit | 计时单位:H 小时、D 天 | String | orderList.segmentList.changeFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | orderList.segmentList.changeFees |
{
"totalCount":21, //总记录数
"orderList":
[{
"companyId":"S118022", //公司编号
"companyName":"美亚测试股份有限公司", //公司名称
"orderNo":"TB2301738728", //美亚订单号
"originalOrderNo": "", //原订单编号 改签、退票、废票单的原单编号,订购单时为空
"opDate":"2023-10-23 21:46:49", //建单时间
"opId":"P3637330", //建单人
"opStaffCode":"ak10002", //建单人员工工号
"opName":"刘展超", //客户制单人
"onBusiness":1, //订单类型(1:因公;0:因私)
"receivePayType":"月结", //返回字符串,支付方式:月结 或 现结
"statusText":"已出票", //订单状态(中文)
"status":40, //订单状态(国际机票只包含:40,70,80)
"orderType":1, //订单类型
"oaSerialnumber":"SL445885212", //出差申请单号,外部系统关联单号会放这里返回
"totalPrice":1640.00, //订单总金额
"passengerList":
[{
"passengerNo":1, //旅客排序号(从1开始递增)
"passengerCode":"P827827", //旅客编号
"passengerName":"张宇宇", //旅客姓名
"certificateType":"因公护照", //证件类型
"certificateId":"562233", //证件号码
"passengerType":"成人", //旅客类型(成人/儿童/婴儿)
"ticketNo":"2", //机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系)
"staffCode":"WBDDH002", //员工工号
"mobile": "", //旅客手机号码
"email": "", //旅客邮箱,国际机票使用
"statusDesc": "", //客票状态描述
"ticketStatus": "", //票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到
"depName":"0922部门/0922", //部门名称,用/分隔(列表返回最后一级,详细返回全级)
}], //旅客信息
"segmentList":
[{
"cabin":"1", //舱位等级(1/2/3/4)
"clazz":"V", //小舱位(如:Y/Z/...)
"clazzName":"经济舱", //舱位名称
"planeType":"波音737", //机型
"airlineCode":"MF", //销售航司编号(如:HU)
"segmentNo":1, //航段序号(从1开始)
"flightNumber":"MF8969", //销售航班号
"originName":"虹桥国际机场", //出发机场名称
"originCountryName":"中国", //出发地区或国家名称
"originCountryCode":"CN", //出发地区或国家二字码
"destinationName":"经济舱", //到达机场名称
"destinationCountryName":"中国", //到达地区或国家名称
"destinationCountryCode":"CN", //到达地区或国家二字码
"departureDate":"2023-10-23", //出发日期
"departureTime":"14:00", //出发时间
"arrivalDate":"2023-10-23", //到达日期
"arrivalTime":"16:30", //到达时间
"flyTime":"150", //飞行时间(分钟)
"carrier": "", //实际承运航班号(如果销售航班号是共享航班号,那么实际承运航班号才有值的)
"stopItem": "", //经停信息(格式:经停城市|到达时间|起飞时间)(如:上饶|2018-04-23 18:05|2018-04-23 18:55)
"originCityCode":"SHA", //出发机场编码
"destinationCityCode":"SZX", //到达机场编码
"origincityName":"上海", //出发城市名称
"destinationCityName":"深圳", //到达城市名称
"depTerminal":"T1", //出发航站楼
"arrTerminal":"T3", //到达航站楼(不详时传 --)
"airlineName":"厦门航空", //航司名称
"remark":"无", //备注
"ruleInfo":"退票规则:航班预计离站时间之前168小时(含)前,收取20 % 退票费.航班预计离站时间之前48小时(含)前,收取40 % 退票费.航班预计离站时间之前4小时(含)前,收取70 % 退票费.航班预计离站之前4小时(不含)后,收取90 % 退票费.
变更规则:航班预计离站时间之前168小时(含)前,收取10 % 改期费.航班预计离站时间之前48小时(含)前,收取30 % 改期费.航班预计离站时间之前4小时(含)前,收取50 % 改期费.航班预计离站之前4小时(不含)后,收取70 % 改期费.
签转规则:不允许
免费托运行李:每件20KG,每人1件,每件体积不超过40×60×100厘米。
免费手提行李:每件5KG,每人1件,每件体积不超过20×40×55厘米。
", //航班退改规则;
"amount":1100.00, //公布运价;(国际机票无公布运价)
"fAmount":5080.00, //头等舱标准价;(国际机票无头等舱标准价)
"cAmount":2030.00, //公务舱标准价;(国际机票无公务舱标准价)
"yAmount":2030.00, //经济舱标准价(国际机票无经济舱标准价)
"mileage":1324, //里程
"isProtocolPrice":1, //协议类型:0非协议票,1三方协议,2两方协议
"destinationCityNameEn":"BeiJing", //到达城市英文名 PM2024123 添加
"destinationNameEng":"BeiJing DaXing AirPort", //到达机场英文名 PM2024123 2024-04-25 添加
"origincityNameEn":"Amsterdam", //出发城市英文名 PM2024123 添加
"originNameEng":"Amsterdam AirPort", //出发机场英文名 PM2024123 2024-04-25 添加
"stopType":1, //有无经停 0无 1有
"stopCityName":"伦敦", //停留城市名称 PM2024123 添加
"stopCityNameEn":"London", //停留城市英文名 PM2024123 添加
"meal":"1", //有无餐食:0 无 1 有 PM2024123 2024-04-25 添加
"airlineNameEng":"China Southern Airlines", //航司英文名 PM2024123 添加
"JourneyIndex":"1", //行程序号 1-第一程;2-第二程;3-第三程
"refundFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //退票规则费用计算
"changeFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //改签规则费用计算
"ticketLuggageRule":
{
"checkRuleInfo": "", //托运行李规则内容(托运汇总内容)
"handRuleInfo": "", //手提行李规则内容(手提汇总内容)
"freeCheckCount":"1", //免费托运行李数量
"freeCheckUnit":"PC", //免费托运行李单位 KG=公斤 PC=件
"freeCheckLuggage":"1PC", //免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”)
"checkDescription":"1件", //托运行李说明
"freeHandCount": "", //免费手提行李数量
"freeHandUnit": "", //免费手提行李单位 KG=公斤 PC=件
"freeHandLuggage": "", //免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”)
"handDescription": "", //手提行李说明
}, //行李额
"refundRuleInfo": "", //退票规则内容
"changeRuleInfo": "", //改签规则内容
"transferRuleInfo": "", //签转规则内容
"segmentIndex":1, //航段序号(1开始,展示用)
"departureDiffHour":0, //出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
"arrivalDiffHour":0, //出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
"originProvinceCN": "", //出发国家省州中文名
"originProvinceEN": "", //出发国家省州英文名
"originContinentCN": "", //出发机场所属大洲中文名
"originContinentEN": "", //出发机场所属大洲英文名
"destinationContinentCN": "", //到达机场所属大洲中文名
"destinationContinentEN": "", //到达机场所属大洲英文名
"departureTimeZone": "", //到达时区
"originTimeZone": "", //出发时区
"originCountryNameEN": "", //出发国家英文名称
"destinationCountryNameEN": "", //到达国家英文名称
"routeType": "", //航线类型,长航线-短航线 暂无实际数据
}], //航段信息
}], //订单信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票订单详细(新),最新版本,新对接客户使用该接口,勿使用旧版本
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订购单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB230004581", //美亚订购单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderType |
订单类型
1:国内机票订购单; 2:国内机票改签单; 3:国内机票退票单; 11:国际机票订购单; 12:国际机票改签单; 13:国际机票退票单 |
Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
data | 订单信息(国内国际机票通用) | FlightOrderPush | ||
changeType |
变更/改签类型
0:未知
100:自愿
200:非自愿
添加日期: 2018-11-22 |
Integer | data | |
changeReason |
变更/改签原因
添加日期: 2018-11-22 |
String | data | |
status |
订单状态
国际机票只包含:40,70,80 5 :待提交 10 :审批中 20 :待收款 25 :待付款 30 :出票中 35 :紧急处理 40 :已出票 50 :已取消 60 :待核对 70 :处理中 75 :紧急处理 80 :已处理 200:待审核 |
Integer | data | |
isUatpPay |
是否uatp出票(1:是)
添加日期: 2019-11-06 |
Integer | data | |
uatpCardNo |
uatp卡号(isUatpPay=1时有值)
添加日期: 2019-11-06 |
String | data | |
uatpSupplier |
uatp公司(isUatpPay=1时有值)
添加日期: 2019-11-06 |
String | data | |
customerCode |
大客户编号
添加日期: 2021-11-19 |
String | data | |
officeCode |
出票Office PM2024113 API接口-订单推送接口增加出票office字段
添加日期: 2024-04-15 |
String | data | |
pnrBigCode |
航司大编码 PM2024123 添加
添加日期: 2024-04-25 |
String | data | |
quotationLugage |
报价币种行李额费用
添加日期: 2025-03-25 |
Number | data | |
settlementServiceFee |
结算币种行程单服务费
添加日期: 2025-03-25 |
Number | data | |
settlementLugage |
结算币种行李额费用
添加日期: 2025-03-25 |
Number | data | |
quotationServiceFee |
报价币种行程单服务费
添加日期: 2025-03-25 |
Number | data | |
quotationAmountSaved |
报价币种三方协议节省金额 暂无实际数据
添加日期: 2025-03-25 |
Number | data | |
settlementAmountSaved |
结算币种三方协议节省金额 暂无实际数据
添加日期: 2025-03-25 |
Number | data | |
ticketCounter |
票台信息 暂无实际数据
添加日期: 2025-03-25 |
String | data | |
subOrderNo |
辅营子单号 暂无实际数据
添加日期: 2025-03-25 |
String | data | |
exchangeRate |
国际机票,结算汇率,多币种结算才使用 暂无实际数据 默认1
添加日期: 2025-03-25 |
Number | data | |
CNYToQuotationExchangeRate |
国际机票,汇率(CNY-报价):取人民币转报价币种的汇率,多币种结算才使用 暂无实际数据 默认1
添加日期: 2025-03-25 |
Number | data | |
CNYToSettlementExchangeRate |
国际机票,汇率(CNY-结算):取人民币转结算币种的汇率,多币种结算才使用 暂无实际数据 默认1
添加日期: 2025-03-25 |
Number | data | |
deadLineTime | 价格有效期(改签单和退票单时,订单需在价格有效期内提交订单,过了有效期会提交订单失败) | String | data | |
tripId | 行程编号 | String | data | |
companyId | 公司编号 | String | data | |
failureReason | 订单失败原因 | String | data | |
oaOtherInfo | 其他信息,个性化客户需要(比如:中奖码) | String | data | |
firstOrderNo | 美亚原购单号 | String | data | |
orderSource | 订单来源 | Integer | data | |
receivePayType |
支付方式
月结 现结 预存卡 |
String | data | |
affiliateBusinessName | 供应商 | String | data | |
pnr | pnr | String | data | |
StaffPayExcess |
个人承担费用,=true 为存在个人承担,false
添加日期: 2024-04-03 |
Boolean | data | |
PolicyExcessAmount |
StaffPayExcess=true 时需要关注,个人承担的金额,否则为 0;
添加日期: 2024-04-03 |
Number | data | |
CompanyExcessAmount |
StaffPayExcess=true 时需要关注,公司承担的金额;
添加日期: 2024-04-03 |
Number | data | |
c_TextField_2401 | 客户自定义字段1 | String | data | |
c_TextField_2402 | 客户自定义字段2 | String | data | |
c_TextField_2403 | 客户自定义字段3 | String | data | |
c_TextField_2404 | 客户自定义字段4 | String | data | |
c_TextField_2405 | 客户自定义字段5 | String | data | |
c_TextField_2406 | 客户自定义字段6 | String | data | |
c_TextField_2407 | 客户自定义字段7 | String | data | |
c_TextField_2408 | 客户自定义字段8 | String | data | |
totalPrice | 当前订单总金额 | Number | data | |
opId | 制单人旅客编号 | String | data | |
onBusiness | 订单类型(1:因公;0:因私) 注意:如果因私订单不需要的,记得接收时过滤掉 | Integer | data | |
orderRemark | 订单备注 | String | data | |
outsideOrderNo | 客户订单号 | String | data | |
orderNo | 美亚订单号 | String | data | |
originalOrderNo | 美亚原订单号 | String | data | |
opStaffCode | 客户制单人工号 | String | data | |
opName | 客户制单人 | String | data | |
opDate | 下单时间(yyyy-MM-dd HH:mm:ss) | String | data | |
statusText | 订单状态(名称) | String | data | |
issueDate | 出票日期(yyyy-MM-dd HH:mm:ss) | String | data | |
oaSerialnumber | 客户出差申请单号 | String | data | |
stApplyOrderNo | 美亚出差申请单号 | String | data | |
contactInfo | 联系人信息 | OrderPushContactinfo | data | |
contactName | 联系人姓名 | String | data.contactInfo | |
mobile | 手机号 | String | data.contactInfo | |
phone | 固定电话 | String | data.contactInfo | |
邮箱 | String | data.contactInfo | ||
policyList | 出差政策列表 | Array[] | data | |
passengerCode | 旅客编号 | String | data.policyList | |
staffCode | 旅客编号 | String | data.policyList | |
passengerName | 旅客姓名 | String | data.policyList | |
policyName | 政策名称 | String | data.policyList | |
policyProperty | 属性(建议/强制) | String | data.policyList | |
policyType | 基础/分类/个人/附加 | String | data.policyList | |
costList | 成本中心 | Array[] | data | |
remark | 备注 | String | data.costList | |
staffCode | 员工工号 | String | data.costList | |
passengerCode | 旅客编号 | String | data.costList | |
passengerName | 旅客名称 | String | data.costList | |
costId | 成本中心编号 | Integer | data.costList | |
costCenterName | 成本中心名称 | String | data.costList | |
amount | 成本金额 | Number | data.costList | |
priceList | 价格信息 | Array[] | data | |
passengerType | 旅客类型 | String | data.priceList | |
ticketPrice | 机票票面价格(改签时为升舱费) | Number | data.priceList | |
tax | 机场建设费;国际机票税费 | Number | data.priceList | |
oilFee | 燃油附加费;国际机票无 | Number | data.priceList | |
servicePrice | 服务费 | Number | data.priceList | |
discount | 折扣(8.0折进值为80);国际机票无 | Number | data.priceList | |
serviceCommission | 改签/退票手续费 | Number | data.priceList | |
usedFlight | 已使用航段费 | Number | data.priceList | |
orderSurcharge | 退票详情里的 单据附加费 | Number | data.priceList | |
passengerCode | 旅客编号 | String | data.priceList | |
passengerName | 旅客姓名 | String | data.priceList | |
staffCode | 员工工号 | String | data.priceList | |
currency | 结算币种 | String | data.priceList | |
quotationCurrency | 报价币种(预留,暂返回空) | String | data.priceList | |
QuotationPrice | 国际机票,报价价格,多币种报价结算时才使用 暂无实际数据 | QuotationPriceMode | data.priceList | |
quotationTicketPrice | 机票票面价格(改签时为升舱费) | Number | data.priceList.QuotationPrice | |
quotationTax | 机场建设费 | Number | data.priceList.QuotationPrice | |
quotationServicePrice | 服务费 | Number | data.priceList.QuotationPrice | |
quotationServiceCommission | 改签/退票手续费 | Number | data.priceList.QuotationPrice | |
quotationSellIticketChangefee | 国际改签单改签手续费 | Number | data.priceList.QuotationPrice | |
passengerList | 旅客信息 | Array[] | data | |
reasonId | 差旅政策违反原因序号 | Integer | data.passengerList | |
reasonRemark | 差旅政策违反原因 | String | data.passengerList | |
errorMessage | 退票失败原因(订单为火车票时有值) | String | data.passengerList | |
returnStatus | 出票状况(订单为火车票时有值) | String | data.passengerList | |
seatNo | 座席号(订单为火车票时有值) | String | data.passengerList | |
originalTicketNo | 机票/火车票原票号(改签单时有值) | String | data.passengerList | |
belongToProject |
归属项目
添加日期: 2023-11-21 |
String | data.passengerList | |
travelPurpose |
出行目的
添加日期: 2023-11-21 |
String | data.passengerList | |
passengerNo | 旅客排序号(从1开始递增) | Integer | data.passengerList | |
passengerCode | 旅客编号 | String | data.passengerList | |
passengerName | 旅客姓名 | String | data.passengerList | |
certificateType | 证件类型 | String | data.passengerList | |
certificateId | 证件号码 | String | data.passengerList | |
passengerType | 旅客类型(成人/儿童/婴儿) | String | data.passengerList | |
ticketNo | 机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系) | String | data.passengerList | |
staffCode | 员工工号 | String | data.passengerList | |
mobile | 旅客手机号码 | String | data.passengerList | |
旅客邮箱,国际机票使用 | String | data.passengerList | ||
statusDesc | 客票状态描述 | String | data.passengerList | |
ticketStatus | 票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到 | String | data.passengerList | |
depName |
部门名称,用/分隔(列表返回最后一级,详细返回全级)
添加日期: 2018-10-18 |
String | data.passengerList | |
electronicItineraryType | 机票 电子行程单 可否可开具 0=否 1=是 | Integer | data.passengerList | |
belongToCenter |
归属中心
添加日期: 2023-11-21 |
Array[] | data.passengerList | |
centerNo |
序号
添加日期: 2023-11-21 |
Integer | data.passengerList.belongToCenter | |
centerTitle |
归属中心标题
添加日期: 2023-11-21 |
String | data.passengerList.belongToCenter | |
centerName |
归属成本中心选项值
添加日期: 2023-11-21 |
String | data.passengerList.belongToCenter | |
segmentList | 航段信息 | Array[] | data | |
cabin |
舱位等级(1/2/3/4)
1 经济舱 2 公务舱 3 头等舱 4 豪华经济舱 |
String | data.segmentList | |
clazz | 小舱位(如:Y/Z/...) | String | data.segmentList | |
clazzName | 舱位名称 | String | data.segmentList | |
planeType | 机型 | String | data.segmentList | |
airlineCode | 销售航司编号(如:HU) | String | data.segmentList | |
segmentNo | 航段序号(从1开始) | Integer | data.segmentList | |
flightNumber | 销售航班号 | String | data.segmentList | |
originName | 出发机场名称 | String | data.segmentList | |
originCountryName | 出发地区或国家名称 | String | data.segmentList | |
originCountryCode | 出发地区或国家二字码 | String | data.segmentList | |
destinationName | 到达机场名称 | String | data.segmentList | |
destinationCountryName | 到达地区或国家名称 | String | data.segmentList | |
destinationCountryCode | 到达地区或国家二字码 | String | data.segmentList | |
departureDate | 出发日期 | String | data.segmentList | |
departureTime | 出发时间 | String | data.segmentList | |
arrivalDate | 到达日期 | String | data.segmentList | |
arrivalTime | 到达时间 | String | data.segmentList | |
flyTime | 飞行时间(分钟) | String | data.segmentList | |
carrier | 实际承运航班号(如果销售航班号是共享航班号,那么实际承运航班号才有值的) | String | data.segmentList | |
stopItem | 经停信息(格式:经停城市|到达时间|起飞时间)(如:上饶|2018-04-23 18:05|2018-04-23 18:55) | String | data.segmentList | |
originCityCode | 出发机场编码 | String | data.segmentList | |
destinationCityCode | 到达机场编码 | String | data.segmentList | |
origincityName | 出发城市名称 | String | data.segmentList | |
destinationCityName | 到达城市名称 | String | data.segmentList | |
depTerminal | 出发航站楼 | String | data.segmentList | |
arrTerminal | 到达航站楼(不详时传 --) | String | data.segmentList | |
airlineName | 航司名称 | String | data.segmentList | |
remark | 备注 | String | data.segmentList | |
ruleInfo | 航班退改规则; | String | data.segmentList | |
amount | 公布运价;(国际机票无公布运价) | Number | data.segmentList | |
fAmount | 头等舱标准价;(国际机票无头等舱标准价) | Number | data.segmentList | |
cAmount | 公务舱标准价;(国际机票无公务舱标准价) | Number | data.segmentList | |
yAmount | 经济舱标准价(国际机票无经济舱标准价) | Number | data.segmentList | |
mileage |
里程
添加日期: 2024-04-25 |
Number | data.segmentList | |
isProtocolPrice |
协议类型:0非协议票,1三方协议,2两方协议
添加日期: 2024-04-25 |
Integer | data.segmentList | |
destinationCityNameEn |
到达城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
destinationNameEng |
到达机场英文名 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
origincityNameEn |
出发城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
originNameEng |
出发机场英文名 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
stopType |
有无经停 0无 1有
添加日期: 2024-04-25 |
Integer | data.segmentList | |
stopCityName |
停留城市名称 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
stopCityNameEn |
停留城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
meal |
有无餐食:0 无 1 有 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
airlineNameEng |
航司英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
JourneyIndex |
行程序号 1-第一程;2-第二程;3-第三程
添加日期: 2024-05-07 |
String | data.segmentList | |
refundRuleInfo | 退票规则内容 | String | data.segmentList | |
changeRuleInfo | 改签规则内容 | String | data.segmentList | |
transferRuleInfo | 签转规则内容 | String | data.segmentList | |
segmentIndex |
航段序号(1开始,展示用)
添加日期: 2025-02-12 |
Integer | data.segmentList | |
departureDiffHour | 出发地时差 正负数值 2025-03-21之前下单的数据为空值 null | Number | data.segmentList | |
arrivalDiffHour |
出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
添加日期: 2025-02-21 |
Number | data.segmentList | |
originProvinceCN | 出发国家省州中文名 | String | data.segmentList | |
originProvinceEN | 出发国家省州英文名 | String | data.segmentList | |
originContinentCN | 出发机场所属大洲中文名 | String | data.segmentList | |
originContinentEN | 出发机场所属大洲英文名 | String | data.segmentList | |
destinationContinentCN | 到达机场所属大洲中文名 | String | data.segmentList | |
destinationContinentEN | 到达机场所属大洲英文名 | String | data.segmentList | |
departureTimeZone | 到达时区 | String | data.segmentList | |
originTimeZone | 出发时区 | String | data.segmentList | |
originCountryNameEN | 出发国家英文名称 | String | data.segmentList | |
destinationCountryNameEN | 到达国家英文名称 | String | data.segmentList | |
routeType | 航线类型,长航线-短航线 暂无实际数据 | String | data.segmentList | |
ticketLuggageRule | 行李额 | TicketLuggageRule | data.segmentList | |
checkRuleInfo | 托运行李规则内容(托运汇总内容) | String | data.segmentList.ticketLuggageRule | |
handRuleInfo | 手提行李规则内容(手提汇总内容) | String | data.segmentList.ticketLuggageRule | |
freeCheckCount | 免费托运行李数量 | String | data.segmentList.ticketLuggageRule | |
freeCheckUnit | 免费托运行李单位 KG=公斤 PC=件 | String | data.segmentList.ticketLuggageRule | |
freeCheckLuggage | 免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”) | String | data.segmentList.ticketLuggageRule | |
checkDescription | 托运行李说明 | String | data.segmentList.ticketLuggageRule | |
freeHandCount | 免费手提行李数量 | String | data.segmentList.ticketLuggageRule | |
freeHandUnit | 免费手提行李单位 KG=公斤 PC=件 | String | data.segmentList.ticketLuggageRule | |
freeHandLuggage | 免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”) | String | data.segmentList.ticketLuggageRule | |
handDescription | 手提行李说明 | String | data.segmentList.ticketLuggageRule | |
refundFees | 退票规则费用计算 | Array[] | data.segmentList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | data.segmentList.refundFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | data.segmentList.refundFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | data.segmentList.refundFees | |
fee | 运算后的退改费用(元) | Number | data.segmentList.refundFees | |
baseFee | 运算基数 | Number | data.segmentList.refundFees | |
feePercent | 费用百分比 | Number | data.segmentList.refundFees | |
minimumFee | 保底费用(元) | Number | data.segmentList.refundFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | data.segmentList.refundFees | |
timingCount | 计时数量 | Integer | data.segmentList.refundFees | |
timingUnit | 计时单位:H 小时、D 天 | String | data.segmentList.refundFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | data.segmentList.refundFees | |
changeFees | 改签规则费用计算 | Array[] | data.segmentList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | data.segmentList.changeFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | data.segmentList.changeFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | data.segmentList.changeFees | |
fee | 运算后的退改费用(元) | Number | data.segmentList.changeFees | |
baseFee | 运算基数 | Number | data.segmentList.changeFees | |
feePercent | 费用百分比 | Number | data.segmentList.changeFees | |
minimumFee | 保底费用(元) | Number | data.segmentList.changeFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | data.segmentList.changeFees | |
timingCount | 计时数量 | Integer | data.segmentList.changeFees | |
timingUnit | 计时单位:H 小时、D 天 | String | data.segmentList.changeFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | data.segmentList.changeFees |
{
"data":
{
"segmentList":
[{
"cabin":"1", //舱位等级(1/2/3/4)
"clazz":"V", //小舱位(如:Y/Z/...)
"clazzName":"经济舱", //舱位名称
"planeType":"波音737", //机型
"airlineCode":"MF", //销售航司编号(如:HU)
"segmentNo":1, //航段序号(从1开始)
"flightNumber":"MF8969", //销售航班号
"originName":"虹桥国际机场", //出发机场名称
"originCountryName":"中国", //出发地区或国家名称
"originCountryCode":"CN", //出发地区或国家二字码
"destinationName":"经济舱", //到达机场名称
"destinationCountryName":"中国", //到达地区或国家名称
"destinationCountryCode":"CN", //到达地区或国家二字码
"departureDate":"2023-10-23", //出发日期
"departureTime":"14:00", //出发时间
"arrivalDate":"2023-10-23", //到达日期
"arrivalTime":"16:30", //到达时间
"flyTime":"150", //飞行时间(分钟)
"carrier": "", //实际承运航班号(如果销售航班号是共享航班号,那么实际承运航班号才有值的)
"stopItem": "", //经停信息(格式:经停城市|到达时间|起飞时间)(如:上饶|2018-04-23 18:05|2018-04-23 18:55)
"originCityCode":"SHA", //出发机场编码
"destinationCityCode":"SZX", //到达机场编码
"origincityName":"上海", //出发城市名称
"destinationCityName":"深圳", //到达城市名称
"depTerminal":"T1", //出发航站楼
"arrTerminal":"T3", //到达航站楼(不详时传 --)
"airlineName":"厦门航空", //航司名称
"remark":"无", //备注
"ruleInfo":"退票规则:航班预计离站时间之前168小时(含)前,收取20 % 退票费.航班预计离站时间之前48小时(含)前,收取40 % 退票费.航班预计离站时间之前4小时(含)前,收取70 % 退票费.航班预计离站之前4小时(不含)后,收取90 % 退票费.
变更规则:航班预计离站时间之前168小时(含)前,收取10 % 改期费.航班预计离站时间之前48小时(含)前,收取30 % 改期费.航班预计离站时间之前4小时(含)前,收取50 % 改期费.航班预计离站之前4小时(不含)后,收取70 % 改期费.
签转规则:不允许
免费托运行李:每件20KG,每人1件,每件体积不超过40×60×100厘米。
免费手提行李:每件5KG,每人1件,每件体积不超过20×40×55厘米。
", //航班退改规则;
"amount":1100.00, //公布运价;(国际机票无公布运价)
"fAmount":5080.00, //头等舱标准价;(国际机票无头等舱标准价)
"cAmount":2030.00, //公务舱标准价;(国际机票无公务舱标准价)
"yAmount":2030.00, //经济舱标准价(国际机票无经济舱标准价)
"mileage":1324, //里程
"isProtocolPrice":1, //协议类型:0非协议票,1三方协议,2两方协议
"destinationCityNameEn":"BeiJing", //到达城市英文名 PM2024123 添加
"destinationNameEng":"BeiJing DaXing AirPort", //到达机场英文名 PM2024123 2024-04-25 添加
"origincityNameEn":"Amsterdam", //出发城市英文名 PM2024123 添加
"originNameEng":"Amsterdam AirPort", //出发机场英文名 PM2024123 2024-04-25 添加
"stopType":1, //有无经停 0无 1有
"stopCityName":"伦敦", //停留城市名称 PM2024123 添加
"stopCityNameEn":"London", //停留城市英文名 PM2024123 添加
"meal":"1", //有无餐食:0 无 1 有 PM2024123 2024-04-25 添加
"airlineNameEng":"China Southern Airlines", //航司英文名 PM2024123 添加
"JourneyIndex":"1", //行程序号 1-第一程;2-第二程;3-第三程
"refundFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //退票规则费用计算
"changeFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //改签规则费用计算
"ticketLuggageRule":
{
"checkRuleInfo": "", //托运行李规则内容(托运汇总内容)
"handRuleInfo": "", //手提行李规则内容(手提汇总内容)
"freeCheckCount":"1", //免费托运行李数量
"freeCheckUnit":"PC", //免费托运行李单位 KG=公斤 PC=件
"freeCheckLuggage":"1PC", //免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”)
"checkDescription":"1件", //托运行李说明
"freeHandCount": "", //免费手提行李数量
"freeHandUnit": "", //免费手提行李单位 KG=公斤 PC=件
"freeHandLuggage": "", //免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”)
"handDescription": "", //手提行李说明
}, //行李额
"refundRuleInfo": "", //退票规则内容
"changeRuleInfo": "", //改签规则内容
"transferRuleInfo": "", //签转规则内容
"segmentIndex":1, //航段序号(1开始,展示用)
"departureDiffHour":0, //出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
"arrivalDiffHour":0, //出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
"originProvinceCN": "", //出发国家省州中文名
"originProvinceEN": "", //出发国家省州英文名
"originContinentCN": "", //出发机场所属大洲中文名
"originContinentEN": "", //出发机场所属大洲英文名
"destinationContinentCN": "", //到达机场所属大洲中文名
"destinationContinentEN": "", //到达机场所属大洲英文名
"departureTimeZone": "", //到达时区
"originTimeZone": "", //出发时区
"originCountryNameEN": "", //出发国家英文名称
"destinationCountryNameEN": "", //到达国家英文名称
"routeType": "", //航线类型,长航线-短航线 暂无实际数据
}], //航段信息
"priceList":
[{
"passengerType":"成人", //旅客类型
"ticketPrice":1100, //机票票面价格(改签时为升舱费)
"tax":50, //机场建设费;国际机票税费
"oilFee":130, //燃油附加费;国际机票无
"servicePrice":10, //服务费
"discount":80, //折扣(8.0折进值为80);国际机票无
"serviceCommission":0, //改签/退票手续费
"usedFlight":0, //已使用航段费
"orderSurcharge":0, //退票详情里的 单据附加费
"passengerCode":"P3510651", //旅客编号
"passengerName":"刘晓东", //旅客姓名
"staffCode":"EMP2110131EAJFM1I", //员工工号
"currency": "", //结算币种
"quotationCurrency":"CNY", //报价币种(预留,暂返回空)
"QuotationPrice":
{
"quotationTicketPrice":0, //机票票面价格(改签时为升舱费)
"quotationTax":0, //机场建设费
"quotationServicePrice":0, //服务费
"quotationServiceCommission":0, //改签/退票手续费
"quotationSellIticketChangefee":0, //国际改签单改签手续费
}, //国际机票,报价价格,多币种报价结算时才使用 暂无实际数据
}], //价格信息
"changeType":0, //变更/改签类型
0:未知
100:自愿
200:非自愿
"changeReason": "", //变更/改签原因
"status":3, //订单状态
"isUatpPay":1, //是否uatp出票(1:是)
"uatpCardNo": "", //uatp卡号(isUatpPay=1时有值)
"uatpSupplier": "", //uatp公司(isUatpPay=1时有值)
"customerCode": "", //大客户编号
"officeCode":"CAN623", //出票Office PM2024113 API接口-订单推送接口增加出票office字段
"pnrBigCode":"KWX1DX", //航司大编码 PM2024123 添加
"quotationLugage":350.00, //报价币种行李额费用
"settlementServiceFee":350.00, //结算币种行程单服务费
"settlementLugage":350.00, //结算币种行李额费用
"quotationServiceFee":350.00, //报价币种行程单服务费
"quotationAmountSaved":350.00, //报价币种三方协议节省金额 暂无实际数据
"settlementAmountSaved":350.00, //结算币种三方协议节省金额 暂无实际数据
"ticketCounter":"美亚国际旅行社", //票台信息 暂无实际数据
"subOrderNo":"TQ255588744", //辅营子单号 暂无实际数据
"exchangeRate":1, //国际机票,结算汇率,多币种结算才使用 暂无实际数据 默认1
"CNYToQuotationExchangeRate":1, //国际机票,汇率(CNY-报价):取人民币转报价币种的汇率,多币种结算才使用 暂无实际数据 默认1
"CNYToSettlementExchangeRate":1, //国际机票,汇率(CNY-结算):取人民币转结算币种的汇率,多币种结算才使用 暂无实际数据 默认1
"deadLineTime":"2023/11/25 0:00:00", //价格有效期(改签单和退票单时,订单需在价格有效期内提交订单,过了有效期会提交订单失败)
"tripId": "", //行程编号
"companyId":"S117955", //公司编号
"failureReason": "", //订单失败原因
"oaOtherInfo":"zjm485215588", //其他信息,个性化客户需要(比如:中奖码)
"firstOrderNo":"TB2024000154", //美亚原购单号
"orderSource":3, //订单来源
"receivePayType":"月结", //支付方式
"affiliateBusinessName":"广东美亚商旅科技有限公司", //供应商
"pnr": "", //pnr
"passengerList":
[{
"reasonId":0, //差旅政策违反原因序号
"reasonRemark": "", //差旅政策违反原因
"errorMessage": "", //退票失败原因(订单为火车票时有值)
"returnStatus": "", //出票状况(订单为火车票时有值)
"seatNo": "", //座席号(订单为火车票时有值)
"originalTicketNo": "", //机票/火车票原票号(改签单时有值)
"belongToCenter":
[{
"centerNo":0, //序号
"centerTitle": "", //归属中心标题
"centerName": "", //归属成本中心选项值
}], //归属中心
"belongToProject": "", //归属项目
"travelPurpose": "", //出行目的
"passengerNo":1, //旅客排序号(从1开始递增)
"passengerCode":"P827827", //旅客编号
"passengerName":"张宇宇", //旅客姓名
"certificateType":"因公护照", //证件类型
"certificateId":"562233", //证件号码
"passengerType":"成人", //旅客类型(成人/儿童/婴儿)
"ticketNo":"2", //机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系)
"staffCode":"WBDDH002", //员工工号
"mobile": "", //旅客手机号码
"email": "", //旅客邮箱,国际机票使用
"statusDesc": "", //客票状态描述
"ticketStatus": "", //票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到
"depName":"0922部门/0922", //部门名称,用/分隔(列表返回最后一级,详细返回全级)
"electronicItineraryType":0, //机票 电子行程单 可否可开具 0=否 1=是
}], //旅客信息
"costList":
[{
"remark": "", //备注
"staffCode": "", //员工工号
"passengerCode":"P409149", //旅客编号
"passengerName":"陈军凤", //旅客名称
"costId":163939, //成本中心编号
"costCenterName":"董事会", //成本中心名称
"amount":240.00, //成本金额
}], //成本中心
"contactInfo":
{
"contactName":"张宇宇", //联系人姓名
"mobile":"15617929598", //手机号
"phone": "", //固定电话
"email":"St87875@meiya.com", //邮箱
}, //联系人信息
"policyList":
[{
"passengerCode":"P415090", //旅客编号
"staffCode":"董事会", //旅客编号
"passengerName":"WBDDH001", //旅客姓名
"policyName":"机票差旅政策一", //政策名称
"policyProperty":"强制", //属性(建议/强制)
"policyType":"基础", //基础/分类/个人/附加
}], //出差政策列表
"StaffPayExcess":false, //个人承担费用,=true 为存在个人承担,false
"PolicyExcessAmount":0.0, //StaffPayExcess=true 时需要关注,个人承担的金额,否则为 0;
"CompanyExcessAmount":818, //StaffPayExcess=true 时需要关注,公司承担的金额;
"c_TextField_2401": "", //客户自定义字段1
"c_TextField_2402": "", //客户自定义字段2
"c_TextField_2403": "", //客户自定义字段3
"c_TextField_2404": "", //客户自定义字段4
"c_TextField_2405": "", //客户自定义字段5
"c_TextField_2406": "", //客户自定义字段6
"c_TextField_2407": "", //客户自定义字段7
"c_TextField_2408": "", //客户自定义字段8
"totalPrice":818.00, //当前订单总金额
"opId": "", //制单人旅客编号
"onBusiness":0, //订单类型(1:因公;0:因私) 注意:如果因私订单不需要的,记得接收时过滤掉
"orderRemark":"订单备注", //订单备注
"outsideOrderNo":"jd20231011022", //客户订单号
"orderNo":"HB2300004135", //美亚订单号
"originalOrderNo": "", //美亚原订单号
"opStaffCode":"WBDDH001", //客户制单人工号
"opName":"张宇宇", //客户制单人
"opDate":"2023-10-20 11:24:26", //下单时间(yyyy-MM-dd HH:mm:ss)
"statusText":"处理成功", //订单状态(名称)
"issueDate":"zjm485215588", //出票日期(yyyy-MM-dd HH:mm:ss)
"oaSerialnumber":"SL58445577484", //客户出差申请单号
"stApplyOrderNo":"EC230005785", //美亚出差申请单号
}, //订单信息(国内国际机票通用)
"orderType":0, //订单类型
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
根据传入订单,查询可改签的航线
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单号 | String | 是 | |
changeType | 改签类型(自愿[默认]100;非自愿:200) | Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo": "", //订单号
"changeType":0, //改签类型(自愿[默认]100;非自愿:200)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
departureItems | 出发点集合 | Array[] | ||
code | 三字码(城市或机场) | String | departureItems | |
name | 名称 | String | departureItems | |
arrivalItems | 目的点集合 | Array[] | ||
code | 三字码(城市或机场) | String | arrivalItems | |
name | 名称 | String | arrivalItems |
{
"departureItems":
[{
"code":"CAN", //三字码(城市或机场)
"name":"广州", //名称
}], //出发点集合
"arrivalItems":
[{
"code":"CAN", //三字码(城市或机场)
"name":"广州", //名称
}], //目的点集合
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
根据传入订单,查询该订单可改签的航班
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单号 | String | 是 | |
departureDate | 出发日期 | String | 是 | |
airline | 销售航司 | String | 否 | |
cabinClass | 舱位等级(经济舱:1 公务舱:2 头等舱:3 豪华经济舱:4) | String | 否 | |
isShowALLPrice | 是否显示所有航班 | Boolean | 否 | |
isCodeShare | 是否返回共享航班:1返回(默认)、0:(不返回) | Integer | 否 | |
isShowALLFlight | 是否返回所有航班::1返回(默认)、0:(只返回可改签航班) | Integer | 否 | |
departureCity | 出发机场 | String | 否 | |
arrivalCity | 到达机场 | String | 否 | |
changeType | 改签类型(自愿[默认]100;非自愿:200) | Integer | 否 | |
isOnlyDirectFlight |
是否仅查直飞(仅支持单程),默认是true
添加日期: 2024-04-08 |
Boolean | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2300009065", //订单号
"departureDate":"TB2300009065", //出发日期
"airline":"TB2300009065", //销售航司
"cabinClass":"1", //舱位等级(经济舱:1 公务舱:2 头等舱:3 豪华经济舱:4)
"isShowALLPrice":true, //是否显示所有航班
"isCodeShare":1, //是否返回共享航班:1返回(默认)、0:(不返回)
"isShowALLFlight":1, //是否返回所有航班::1返回(默认)、0:(只返回可改签航班)
"departureCity":"CAN", //出发机场
"arrivalCity":"BJS", //到达机场
"changeType":100, //改签类型(自愿[默认]100;非自愿:200)
"isOnlyDirectFlight":true, //是否仅查直飞(仅支持单程),默认是true
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
flightInfoList | 返回结果 | Array[] | ||
resultID | 行程ID 比如:去程、回程 | String | flightInfoList | |
segmentID | 航班ID | String | flightInfoList | |
depDate | 出发日期 | String | flightInfoList | |
depTime | 出发时间 | String | flightInfoList | |
arrDate | 到达日期 | String | flightInfoList | |
arrTime | 到达时间 | String | flightInfoList | |
orgCity | 出发城市名称 | String | flightInfoList | |
orgCityCode | 出发城市编码 | String | flightInfoList | |
desCity | 到达城市名称 | String | flightInfoList | |
desCityCode | 到达城市编码 | String | flightInfoList | |
orgAirport | 出发机场名称 | String | flightInfoList | |
orgAirportCode | 出发机场编号 | String | flightInfoList | |
desAirport | 到达机场名称 | String | flightInfoList | |
desAirportCode | 到达机场编号 | String | flightInfoList | |
depTerm | 出发航站楼 | String | flightInfoList | |
arrTerm | 到达航站楼 | String | flightInfoList | |
flightNo | 销售航班号 | String | flightInfoList | |
airlineCode | 销售航司编号 | String | flightInfoList | |
airlineName | 销售航司 | String | flightInfoList | |
planeMode | 机型 | String | flightInfoList | |
isCodeShare | 是否共享航班 | Boolean | flightInfoList | |
carrier | 实际承运航班号;如果销售航班号是共享航班号,那么实际承运航班号才有值的 | String | flightInfoList | |
meal | 餐食 | Boolean | flightInfoList | |
MealCode | 餐食编号 | String | flightInfoList | |
MealName | 餐食名称 B :早餐 C :免费酒精饮料 D :正餐 F :供采购的食物 G :供采购的食物和饮料 H :热膳食 K :轻快早餐 L :午餐 M: 膳食 N :没有饭食供应 O: 冷膳食 P :供采购的酒精饮料 R :茶点 S: 快餐 V :供采购的茶点 | String | flightInfoList | |
tpm | 里程 | Integer | flightInfoList | |
stopNumber | 经停0:无经停,1:有经停 | Integer | flightInfoList | |
fAmount | 头等舱全价 | Number | flightInfoList | |
cAmount | 公务舱全价 | Number | flightInfoList | |
yAmount | 经济舱全价 | Number | flightInfoList | |
secondFlight |
第二段
添加日期: 2024-04-08 |
SecondFlight | flightInfoList | |
depDate |
出发日期
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
depTime |
出发时间
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
arrDate |
到达日期
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
arrTime |
到达时间
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgCity |
出发城市名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgCityCode |
出发城市编码
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desCity |
到达城市名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desCityCode |
到达城市编码
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgAirport |
出发机场名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgAirportCode |
出发机场编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desAirport |
到达机场名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desAirportCode |
到达机场编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
depTerm |
出发航站楼
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
arrTerm |
到达航站楼
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
flightNo |
销售航班号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
airlineCode |
销售航司编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
airlineName |
销售航司
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
planeMode |
机型
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
isCodeShare |
是否共享航班
添加日期: 2024-04-08 |
Boolean | flightInfoList.secondFlight | |
carrier |
实际承运航班号;如果销售航班号是共享航班号,那么实际承运航班号才有值的
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
meal |
餐食
添加日期: 2024-04-08 |
Boolean | flightInfoList.secondFlight | |
MealCode |
餐食编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
MealName |
餐食名称
B :早餐
C :免费酒精饮料
D :正餐
F :供采购的食物
G :供采购的食物和饮料
H :热膳食
K :轻快早餐
L :午餐
M: 膳食
N :没有饭食供应
O: 冷膳食
P :供采购的酒精饮料
R :茶点
S: 快餐
V :供采购的茶点
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopNumber |
经停0:无经停,1:有经停
添加日期: 2024-04-08 |
Integer | flightInfoList.secondFlight | |
carrierAirlineName |
实际承运航司中文名
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopCityName |
经停城市名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopCityCode |
经停城市三字码
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopTime |
经停时长
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopItemList |
经停的具体项,仅当stopNumber>0时有数据
添加日期: 2024-04-08 |
Array[] | flightInfoList.secondFlight | |
cityName | 城市的中文说明 | String | flightInfoList.secondFlight.stopItemList | |
depTime | 从该经停地起飞的时间 | String | flightInfoList.secondFlight.stopItemList | |
arrTime | 到达该经停地的时间 | String | flightInfoList.secondFlight.stopItemList | |
flightPriceInfoList | 价格信息 | Array[] | flightInfoList | |
priceID | 价格ID | String | flightInfoList.flightPriceInfoList | |
flightID | 航段序号(等于resultID+segmentID+priceID下划线分割) | String | flightInfoList.flightPriceInfoList | |
discount | 折扣 | Number | flightInfoList.flightPriceInfoList | |
ticketPrice | 票价 | Number | flightInfoList.flightPriceInfoList | |
airPortFee | 机场建设费 | Number | flightInfoList.flightPriceInfoList | |
oilFee | 燃油费 | Number | flightInfoList.flightPriceInfoList | |
serviceAmount | 服务费 | Number | flightInfoList.flightPriceInfoList | |
airlineYouHui | 航司优惠 | Number | flightInfoList.flightPriceInfoList | |
meiYaYouHui | 美亚优惠 | Number | flightInfoList.flightPriceInfoList | |
amount | 舱位公布运价 | Number | flightInfoList.flightPriceInfoList | |
airlineYouHuiAmount | 机票票面价 | Number | flightInfoList.flightPriceInfoList | |
cabinType | 舱位(如:Y) | String | flightInfoList.flightPriceInfoList | |
cabin | 舱位等级 | String | flightInfoList.flightPriceInfoList | |
clazzName | 舱位名称 | String | flightInfoList.flightPriceInfoList | |
cabinAliasNameCn |
舱等别名-中文
添加日期: 2023-10-17 |
String | flightInfoList.flightPriceInfoList | |
cabinAliasNameEn |
舱等别名-英文
添加日期: 2023-10-17 |
String | flightInfoList.flightPriceInfoList | |
refundChangeInfo | 退改条款 | String | flightInfoList.flightPriceInfoList | |
violate | 违反差旅政策标识(0表示不违反,1表示违反但不是强制的,2标示违反强制差旅政策) | Integer | flightInfoList.flightPriceInfoList | |
seatNum | 座位数(9张或9张以上:A;1-8张:具体座位数) | String | flightInfoList.flightPriceInfoList | |
protocolType | 协议类型(0:非协议价;1、2协议价) | Integer | flightInfoList.flightPriceInfoList | |
isForbidReturn | 不得退票(只退未使用税费) | Boolean | flightInfoList.flightPriceInfoList | |
isForbidChange | 不得变更 | Boolean | flightInfoList.flightPriceInfoList | |
luggageRule | 行李额规则 | String | flightInfoList.flightPriceInfoList | |
fareType | 运价来源; PUBLIC 公布运价,PRIVATE 私有运价 AGREEMENT 协议价 | String | flightInfoList.flightPriceInfoList | |
refundRuleInfo | 退票规则内容 | String | flightInfoList.flightPriceInfoList | |
changeRuleInfo | 改签规则内容 | String | flightInfoList.flightPriceInfoList | |
transferRuleInfo | 签转规则内容 | String | flightInfoList.flightPriceInfoList | |
purchaseRule | 购票规定 | ApiTicketPricePurchaseRule | flightInfoList.flightPriceInfoList | |
content | 内容 | String | flightInfoList.flightPriceInfoList.purchaseRule | |
categories | 分类 | Array[] | flightInfoList.flightPriceInfoList.purchaseRule | |
type | 类型,0=小团专享,1=青年特惠,2=长者特惠 | String | flightInfoList.flightPriceInfoList.purchaseRule.categories | |
content | 内容 | String | flightInfoList.flightPriceInfoList.purchaseRule.categories | |
structor | 内容结构 | ApiTicketPricePurchaseRuleStruct | flightInfoList.flightPriceInfoList.purchaseRule | |
minCount | 最小旅客数量(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
maxCount | 最大旅客数量(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
minAge | 最小年龄(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
maxAge | 最大年龄(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
certificateTypes | 证件类型(身份证/因私护照/因公护照等等) | Array[] | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
gertificateNumber | 证件号码限制 | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
genders | 性别(男/女) | Array[] | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
ticketLuggageRule | 行李额 | TicketLuggageRule | flightInfoList.flightPriceInfoList | |
checkRuleInfo | 托运行李规则内容(托运汇总内容) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
handRuleInfo | 手提行李规则内容(手提汇总内容) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeCheckCount | 免费托运行李数量 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeCheckUnit | 免费托运行李单位 KG=公斤 PC=件 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeCheckLuggage | 免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
checkDescription | 托运行李说明 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeHandCount | 免费手提行李数量 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeHandUnit | 免费手提行李单位 KG=公斤 PC=件 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeHandLuggage | 免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
handDescription | 手提行李说明 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
refundFees | 退票规则费用计算 | Array[] | flightInfoList.flightPriceInfoList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | flightInfoList.flightPriceInfoList.refundFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.refundFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.refundFees | |
fee | 运算后的退改费用(元) | Number | flightInfoList.flightPriceInfoList.refundFees | |
baseFee | 运算基数 | Number | flightInfoList.flightPriceInfoList.refundFees | |
feePercent | 费用百分比 | Number | flightInfoList.flightPriceInfoList.refundFees | |
minimumFee | 保底费用(元) | Number | flightInfoList.flightPriceInfoList.refundFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | flightInfoList.flightPriceInfoList.refundFees | |
timingCount | 计时数量 | Integer | flightInfoList.flightPriceInfoList.refundFees | |
timingUnit | 计时单位:H 小时、D 天 | String | flightInfoList.flightPriceInfoList.refundFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | flightInfoList.flightPriceInfoList.refundFees | |
changeFees | 改签规则费用计算 | Array[] | flightInfoList.flightPriceInfoList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | flightInfoList.flightPriceInfoList.changeFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.changeFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.changeFees | |
fee | 运算后的退改费用(元) | Number | flightInfoList.flightPriceInfoList.changeFees | |
baseFee | 运算基数 | Number | flightInfoList.flightPriceInfoList.changeFees | |
feePercent | 费用百分比 | Number | flightInfoList.flightPriceInfoList.changeFees | |
minimumFee | 保底费用(元) | Number | flightInfoList.flightPriceInfoList.changeFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | flightInfoList.flightPriceInfoList.changeFees | |
timingCount | 计时数量 | Integer | flightInfoList.flightPriceInfoList.changeFees | |
timingUnit | 计时单位:H 小时、D 天 | String | flightInfoList.flightPriceInfoList.changeFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | flightInfoList.flightPriceInfoList.changeFees |
{
"flightInfoList":
[{
"resultID":"bbe4b225e9094de38e8750b6be292695", //行程ID 比如:去程、回程
"segmentID":"fb84a4ca567c4c56936e7ad739a60333", //航班ID
"depDate":"2023-12-26", //出发日期
"depTime":"06:30", //出发时间
"arrDate":"2023-12-26", //到达日期
"arrTime":"09:00", //到达时间
"orgCity":"广州", //出发城市名称
"orgCityCode":"CAN", //出发城市编码
"desCity":"昆明", //到达城市名称
"desCityCode":"KMG", //到达城市编码
"orgAirport":"白云国际机场", //出发机场名称
"orgAirportCode":"CAN", //出发机场编号
"desAirport":"长水国际机场", //到达机场名称
"desAirportCode":"KMG", //到达机场编号
"depTerm":"T1", //出发航站楼
"arrTerm":"T1", //到达航站楼
"flightNo":"MU6823", //销售航班号
"airlineCode":"MU", //销售航司编号
"airlineName":"东方航空-东", //销售航司
"planeMode":"波音73L(中)", //机型
"isCodeShare":false, //是否共享航班
"carrier":"null", //实际承运航班号;如果销售航班号是共享航班号,那么实际承运航班号才有值的
"meal":false, //餐食
"MealCode":"0", //餐食编号
"MealName":"null", //餐食名称
B :早餐
C :免费酒精饮料
D :正餐
F :供采购的食物
G :供采购的食物和饮料
H :热膳食
K :轻快早餐
L :午餐
M: 膳食
N :没有饭食供应
O: 冷膳食
P :供采购的酒精饮料
R :茶点
S: 快餐
V :供采购的茶点
"tpm":0, //里程
"stopNumber":0, //经停0:无经停,1:有经停
"fAmount":5450.0, //头等舱全价
"cAmount":4950.0, //公务舱全价
"yAmount":1980.0, //经济舱全价
"flightPriceInfoList":
[{
"priceID":"1", //价格ID
"flightID":"bbe4b225e9094de38e8750b6be292695_fb84a4ca567c4c56936e7ad739a60333_1", //航段序号(等于resultID+segmentID+priceID下划线分割)
"discount":33.8, //折扣
"ticketPrice":670.0, //票价
"airPortFee":50.0, //机场建设费
"oilFee":130.0, //燃油费
"serviceAmount":10.0, //服务费
"airlineYouHui":0.0, //航司优惠
"meiYaYouHui":0.0, //美亚优惠
"amount":670.0, //舱位公布运价
"airlineYouHuiAmount":670.0, //机票票面价
"cabinType":"V", //舱位(如:Y)
"cabin":"经济舱", //舱位等级
"clazzName":"经济舱", //舱位名称
"cabinAliasNameCn":"null", //舱等别名-中文
"cabinAliasNameEn":"null", //舱等别名-英文
"refundChangeInfo":"null", //退改条款
"violate":0, //违反差旅政策标识(0表示不违反,1表示违反但不是强制的,2标示违反强制差旅政策)
"seatNum":"A", //座位数(9张或9张以上:A;1-8张:具体座位数)
"protocolType":0, //协议类型(0:非协议价;1、2协议价)
"isForbidReturn":false, //不得退票(只退未使用税费)
"isForbidChange":false, //不得变更
"luggageRule":"免费托运行李额20KG,免费手提行李额10KG。(免费携带1件10KG以内)", //行李额规则
"fareType":"PRIVATE", //运价来源; PUBLIC 公布运价,PRIVATE 私有运价 AGREEMENT 协议价
"refundFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //退票规则费用计算
"changeFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //改签规则费用计算
"ticketLuggageRule":
{
"checkRuleInfo": "", //托运行李规则内容(托运汇总内容)
"handRuleInfo": "", //手提行李规则内容(手提汇总内容)
"freeCheckCount":"1", //免费托运行李数量
"freeCheckUnit":"PC", //免费托运行李单位 KG=公斤 PC=件
"freeCheckLuggage":"1PC", //免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”)
"checkDescription":"1件", //托运行李说明
"freeHandCount": "", //免费手提行李数量
"freeHandUnit": "", //免费手提行李单位 KG=公斤 PC=件
"freeHandLuggage": "", //免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”)
"handDescription": "", //手提行李说明
}, //行李额
"refundRuleInfo":"null", //退票规则内容
"changeRuleInfo":"null", //改签规则内容
"transferRuleInfo":"null", //签转规则内容
"purchaseRule":
{
"content": "", //内容
"categories":
[{
"type": "", //类型,0=小团专享,1=青年特惠,2=长者特惠
"content": "", //内容
}], //分类
"structor":
{
"minCount": "", //最小旅客数量(空为不限)
"maxCount": "", //最大旅客数量(空为不限)
"minAge": "", //最小年龄(空为不限)
"maxAge": "", //最大年龄(空为不限)
"certificateTypes":[], //证件类型(身份证/因私护照/因公护照等等)
"gertificateNumber": "", //证件号码限制
"genders":[], //性别(男/女)
}, //内容结构
}, //购票规定
}], //价格信息
"secondFlight":"1980.0", //第二段
}], //返回结果
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
线上获取改签单费用
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
originalOrderNo | 美亚原订购单号 | String | 否 | |
ticketNo | 票号 | Array[] | 否 | |
changeType | 改签类型 自愿变更 = 100, 非自愿变更 = 200 | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
flightList | 航段列表 | Array[] | 否 | |
flightID | 航班ID(从查询航班返回获取) | String | flightList | |
departureCity | 出发城市(三字码) | String | flightList | |
arrivalCity | 达到城市(三字码) | String | flightList | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList | |
airline | 航空二字码,如 MU | String | flightList | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList | |
secondFlight | 预订多程中转航班时需要必传; | FlightInfoForCreateBase | flightList | |
flightID | 航班ID(从查询航班返回获取) | String | flightList.secondFlight | |
departureCity | 出发城市(三字码) | String | flightList.secondFlight | |
arrivalCity | 达到城市(三字码) | String | flightList.secondFlight | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList.secondFlight | |
airline | 航空二字码,如 MU | String | flightList.secondFlight | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList.secondFlight | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList.secondFlight | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList.secondFlight |
{
"originalOrderNo":"TB2301733006", //美亚原订购单号
"ticketNo":"[“999 - 3102966118”]", //票号
"flightList":
[{
"secondFlight":
{
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}, //预订多程中转航班时需要必传;
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}], //航段列表
"changeType":100, //改签类型 自愿变更 = 100,
非自愿变更 = 200
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
isCanOnlineReturn | 是否可以在线退 如果为false,则不显示价格信息,走人工核对流程 | Boolean | ||
noOnlineReason | 不能在线改签的原因,方便排查问题 | String | ||
pnr | 新PNR | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
changePrice | 费用信息 | Array[] | ||
passType | 旅客类型 成人/儿童/婴儿 | String | changePrice | |
personNum | 人数 | Integer | changePrice | |
upgradeFee | 升舱费 | Number | changePrice | |
sellAmount | 变更手续费 | Number | changePrice | |
airPortFee | 机建费 | Number | changePrice | |
oilFee | 燃油费 | Number | changePrice | |
servicePrice | 服务费 | Number | changePrice | |
total | 费用合计(单人) | Number | changePrice |
{
"isCanOnlineReturn":true, //是否可以在线退
如果为false,则不显示价格信息,走人工核对流程
"noOnlineReason":"No", //不能在线改签的原因,方便排查问题
"pnr":"KDL0N7", //新PNR
"changePrice":
[{
"passType":"成人", //旅客类型
成人/儿童/婴儿
"personNum":1, //人数
"upgradeFee":320.0, //升舱费
"sellAmount":120.0, //变更手续费
"airPortFee":0.0, //机建费
"oilFee":0.0, //燃油费
"servicePrice":10, //服务费
"total":450.0, //费用合计(单人)
}], //费用信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
退改初始化接口
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单编号 | String | 是 | |
operateType | 改签:change-改签;退票:refund | String | 是 | |
rebackType | 退票/改签类型(自愿 100;非自愿:200) | Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301737396", //订单编号
"operateType":"refund", //改签:change-改签;退票:refund
"rebackType":100, //退票/改签类型(自愿 100;非自愿:200)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 订单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
segmentInfos | 人员信息 | Array[] | ||
segmentNo | 航程号 | Integer | segmentInfos | |
passengerInfo | 旅客信息 | ApiChangeRefundInitPassenger | segmentInfos | |
passengerName | 乘机人名字 | String | segmentInfos.passengerInfo | |
ticketNo | 票号 | String | segmentInfos.passengerInfo | |
isCanRefund | 是否可退 | Boolean | segmentInfos.passengerInfo | |
isCanChange | 是否可改 | Boolean | segmentInfos.passengerInfo | |
unRefundReason | 不可退原因 | String | segmentInfos.passengerInfo | |
unChangeReason | 不可改原因 | String | segmentInfos.passengerInfo | |
changeServiceFee | 改签服务费 | Number | segmentInfos.passengerInfo | |
refundServiceCommission | 退票手续费(费用无值时返回-1) | Number | segmentInfos.passengerInfo | |
refundServiceFee | 退票服务费 | Number | segmentInfos.passengerInfo |
{
"orderNo":"TB2301740977", //订单号
"segmentInfos":
[{
"passengerInfo":
{
"passengerName":"刘展超", //乘机人名字
"ticketNo":"731-8533068416", //票号
"isCanRefund":true, //是否可退
"isCanChange":true, //是否可改
"unRefundReason": "", //不可退原因
"unChangeReason": "", //不可改原因
"changeServiceFee":0, //改签服务费
"refundServiceCommission":-1, //退票手续费(费用无值时返回-1)
"refundServiceFee":0, //退票服务费
}, //旅客信息
"segmentNo":1, //航程号
}], //人员信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票创建改签(新)
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 原订单编号(需要改签的订单号) | String | 是 | |
outsideOrderNo | 外部订单号 | String | 否 | |
oaSerialnumber | 出差申请单号 | String | 否 | |
opRemark | 备注 | String | 否 | |
ticketNoList | 票号 | Array[] | 是 | |
changeType | 改签类型(自愿 100;非自愿:200) | Integer | 是 | |
changeReason | 改签原因 | String | 是 | |
OaOrderSource | 订单来源 | String | 否 | |
opId | 制单人旅客编号(内部使用) | String | 否 | |
opName | 制单人旅客姓名(内部使用) | String | 否 | |
isSubmit | 是否提交改签出票(true时不用再调用SubmitChangeOrder,同一个公司需要统传值) | Boolean | 否 | |
receivePayType | 默认不传为0, 0-信用付;1-即付,因私默认0; | String | 是 | |
OrderFilePaths |
附件列表(完整网络路径)
添加日期: 2023-06-27 |
Array[] | 否 | |
InvoiceType | 客户所需发票类型 默认=0 ( 0=纸质行程单 1=电子行程单 ) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
contactInfo | 联系人信息 | ContactInfo | 是 | |
contactName | 联系人 | String | contactInfo | |
mobile | 手机号码 | String | contactInfo | |
phone | 联系电话 | String | contactInfo | |
电子邮件 | String | contactInfo | ||
flightList | 航段列表 | Array[] | 是 | |
flightID | 航班ID(从查询航班返回获取) | String | flightList | |
departureCity | 出发城市(三字码) | String | flightList | |
arrivalCity | 达到城市(三字码) | String | flightList | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList | |
airline | 航空二字码,如 MU | String | flightList | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList | |
secondFlight | 预订多程中转航班时需要必传; | FlightInfoForCreateBase | flightList | |
flightID | 航班ID(从查询航班返回获取) | String | flightList.secondFlight | |
departureCity | 出发城市(三字码) | String | flightList.secondFlight | |
arrivalCity | 达到城市(三字码) | String | flightList.secondFlight | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList.secondFlight | |
airline | 航空二字码,如 MU | String | flightList.secondFlight | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList.secondFlight | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList.secondFlight | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList.secondFlight |
{
"orderNo": "", //原订单编号(需要改签的订单号)
"outsideOrderNo": "", //外部订单号
"oaSerialnumber": "", //出差申请单号
"opRemark": "", //备注
"flightList":
[{
"secondFlight":
{
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}, //预订多程中转航班时需要必传;
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}], //航段列表
"ticketNoList":[], //票号
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"changeType":0, //改签类型(自愿 100;非自愿:200)
"changeReason": "", //改签原因
"OaOrderSource": "", //订单来源
"opId": "", //制单人旅客编号(内部使用)
"opName": "", //制单人旅客姓名(内部使用)
"isSubmit":false, //是否提交改签出票(true时不用再调用SubmitChangeOrder,同一个公司需要统传值)
"receivePayType": "", //默认不传为0, 0-信用付;1-即付,因私默认0;
"OrderFilePaths":[], //附件列表(完整网络路径)
"InvoiceType":0, //客户所需发票类型
默认=0 ( 0=纸质行程单 1=电子行程单 )
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 订单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo":"TB2301733006", //订单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
改签验价
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code |
返回代码,10000=成功,其他为错误
40002 验价时升舱费/改签/退票手续费发生变化 |
String | ||
description | 执行结果描述 | String | ||
changePrice | 费用信息 code=40002 时才有值 | Array[] | ||
passType | 旅客类型 成人/儿童/婴儿 | String | changePrice | |
personNum | 人数 | Integer | changePrice | |
upgradeFee | 升舱费 | Number | changePrice | |
sellAmount | 变更手续费 | Number | changePrice | |
airPortFee | 机建费 | Number | changePrice | |
oilFee | 燃油费 | Number | changePrice | |
servicePrice | 服务费 | Number | changePrice | |
total | 费用合计(单人) | Number | changePrice |
{
"changePrice":
[{
"passType":"成人", //旅客类型
成人/儿童/婴儿
"personNum":1, //人数
"upgradeFee":320.0, //升舱费
"sellAmount":120.0, //变更手续费
"airPortFee":0.0, //机建费
"oilFee":0.0, //燃油费
"servicePrice":10, //服务费
"total":450.0, //费用合计(单人)
}], //费用信息
code=40002 时才有值
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票取消改签单
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单编号, 共用的实体,订单号展示只做示例 | String | 是 | |
cancelReasonId | Integer | 否 | ||
cancelReason | 取消原因 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //订单编号, 共用的实体,订单号展示只做示例
"cancelReasonId":0, //
"cancelReason": "", //取消原因
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票提交改签审批
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsideOrderNo | 外部订单号 | String | 否 | |
oaSerialnumber | 出差申请单号 | String | 否 | |
orderNo | 原订单编号(需要退票的订单号) | String | 否 | |
rebackType | 退票/改签类型(自愿 100;非自愿:200) | Integer | 否 | |
refundReason | 退票原因 | String | 否 | |
segmentList | 航段号(退改初始化接口获取) | Array[] | 否 | |
ticketNoList | 票号列表 | Array[] | 否 | |
isSubmit | 是否提交退票(true时不用再调用SubmitReturnOrder,同一个公司需要统传值) | Boolean | 否 | |
OrderFilePaths | 附件列表 PM2022189 | Array[] | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
contactInfo | 联系人信息 | ContactInfo | 否 | |
contactName | 联系人 | String | contactInfo | |
mobile | 手机号码 | String | contactInfo | |
phone | 联系电话 | String | contactInfo | |
电子邮件 | String | contactInfo |
{
"outsideOrderNo": "", //外部订单号
"oaSerialnumber": "", //出差申请单号
"orderNo":"TB2301737396", //原订单编号(需要退票的订单号)
"rebackType":100, //退票/改签类型(自愿 100;非自愿:200)
"refundReason":"客户退票", //退票原因
"segmentList":"[1]", //航段号(退改初始化接口获取)
"ticketNoList":"[“781 - 2479774462”]", //票号列表
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"isSubmit":false, //是否提交退票(true时不用再调用SubmitReturnOrder,同一个公司需要统传值)
"OrderFilePaths":"null", //附件列表 PM2022189
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNoList | 订单号 | Array[] | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNoList":"[“TR2300119578”]", //订单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
退票验价
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
refundPrice | 退票费用 | Number | ||
code |
返回代码,10000=成功,其他为错误
40002 验价时升舱费/改签/退票手续费发生变化 |
String | ||
description | 执行结果描述 | String |
{
"refundPrice":630.00, //退票费用
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票取消退票单
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单编号, 共用的实体,订单号展示只做示例 | String | 是 | |
cancelReasonId | Integer | 否 | ||
cancelReason | 取消原因 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //订单编号, 共用的实体,订单号展示只做示例
"cancelReasonId":0, //
"cancelReason": "", //取消原因
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票提交退票审批
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票查询客票状态
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
TicketStatus | Array[] | |||
OrderNo | 订单号 | String | TicketStatus | |
PassengerName | 旅客名称 | String | TicketStatus | |
TicketNo | 票号 | String | TicketStatus | |
TicketStatus |
票号状态有以下几种: 【未使用】 【已使用】 【已退票】 【已作废】 【已换开】是指同航司之间的改期 【已签转】是指不同航司之前的改期 【挂起】是指机票被锁住挂起,不可用。谁挂起谁解挂,是机票出票后到使用前的状态,挂起机票不能登机使用 【其它】 【未知】 【空白】 |
String | TicketStatus |
{
"TicketStatus":
[{
"OrderNo":"TB2301739858", //订单号
"PassengerName":"刘展超", //旅客名称
"TicketNo":"781-9640642855", //票号
"TicketStatus":"已使用", //
}], //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
分页查询客票状态
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
pageIndex | 当前页码 | Integer | 是 | |
pageSize | 每页大小(最大500) | Integer | 是 | |
startTime | 开始日期,订单创建时间 如传订单或票号,可不传此参数,否则必传 | String | 否 | |
endTime | 结束日期,订单创建时间 如传订单或票号,可不传此参数,否则必传 | String | 否 | |
ticketNo | 机票票号,查单条则传 | String | 否 | |
ticketNoList |
机票票号-列表
添加日期: 2025-02-12 |
Array[] | 否 | |
orderNo | 美亚订单号,查单条则传 | String | 否 | |
orderNoList |
美亚订单号-列表
添加日期: 2025-02-12 |
Array[] | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"pageIndex":1, //当前页码
"pageSize":100, //每页大小(最大500)
"startTime":"2023-10-10", //开始日期,订单创建时间
如传订单或票号,可不传此参数,否则必传
"endTime":"2023-10-10", //结束日期,订单创建时间
如传订单或票号,可不传此参数,否则必传
"ticketNo":"018-3058303205", //机票票号,查单条则传
"ticketNoList":[], //机票票号-列表
"orderNo":"TB2301659102", //美亚订单号,查单条则传
"orderNoList":[], //美亚订单号-列表
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
totalCount | 记录总数 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
ticketStatus | Array[] | |||
OrderNo | 订单号 | String | ticketStatus | |
PassengerName | 旅客名称 | String | ticketStatus | |
TicketNo | 票号 | String | ticketStatus | |
TicketStatus |
票号状态有以下几种: 【未使用】 【已使用】 【已退票】 【已作废】 【已换开】是指同航司之间的改期 【已签转】是指不同航司之前的改期 【挂起】是指机票被锁住挂起,不可用。谁挂起谁解挂,是机票出票后到使用前的状态,挂起机票不能登机使用 【其它】 【未知】 【空白】 |
String | ticketStatus |
{
"ticketStatus":
[{
"OrderNo":"TB2301739858", //订单号
"PassengerName":"刘展超", //旅客名称
"TicketNo":"781-9640642855", //票号
"TicketStatus":"已使用", //
}], //
"totalCount":32, //记录总数
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国际城市列表
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
sessionId | sessionId,login接口返回 | String | 是 |
{
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
cityList | 城市数据集合 | Array[] | ||
py | 拼音 | String | cityList | |
cn | 城市中文名称 | String | cityList | |
cityCode | 城市三字码 | String | cityList | |
en | 城市英文名称 | String | cityList | |
stateName | 省/州中文名 | String | cityList | |
countryName | 国家中文名 | String | cityList | |
code | 机场三字码 | String | cityList | |
airportCnName | 机场中文名称 | String | cityList | |
airportEgName | 机场英文名称 | String | cityList | |
stationName | 站点名称(火车票的) | String | cityList | |
dataDistrictName | 关联的区县名称(酒店的数据) | String | cityList | |
dataDistrictAreaCode | 关联的区县行政代码(酒店的数据) | String | cityList | |
cityType | 0默认值,1直辖市、2地级市、3县级市、4行政区(酒店的数据,非酒店数据都默认0) | Integer | cityList | |
dataCityName | 关联的城市名称(酒店的数据) | String | cityList | |
dataCityCode | 关联的城市三字码(酒店的数据) | String | cityList |
{
"cityList":
[{
"py":"GuangZhou", //拼音
"cn":"广州", //城市中文名称
"cityCode":"CAN", //城市三字码
"en":"GuangZhou", //城市英文名称
"stateName":"广东", //省/州中文名
"countryName":"中国", //国家中文名
"code":"CAN", //机场三字码
"airportCnName":"白云国际机场", //机场中文名称
"airportEgName":"baiyunguojijichang", //机场英文名称
"stationName": "", //站点名称(火车票的)
"dataDistrictName": "", //关联的区县名称(酒店的数据)
"dataDistrictAreaCode": "", //关联的区县行政代码(酒店的数据)
"cityType":0, //0默认值,1直辖市、2地级市、3县级市、4行政区(酒店的数据,非酒店数据都默认0)
"dataCityName": "", //关联的城市名称(酒店的数据)
"dataCityCode": "", //关联的城市三字码(酒店的数据)
}], //城市数据集合
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
departureCity | 出发城市三字码 | String | 是 | |
arrivalCity | 达到城市三字码 | String | 是 | |
departureDate | 离开日期 | String | 是 | |
arrivalDate | 返回日期,非必填,往返才需要 | String | 否 | |
tripType | 行程类型;1:单程 2:往返 3:多程() | String | 是 | |
isDFO | 是否仅直飞 T是 F否 | String | 是 | |
airline | 航司二字码 | String | 否 | |
cabinClass | 舱位等级,必传 1-经济舱,2-公务舱,3-头等舱,4-豪华经济舱;暂不支持全舱位查询 | String | 否 | |
passengerList | 非必填,如果传了旅客外部编号时,多个旅客用逗号间隔,为空时仅可会获取产品类型是协议、自营产品 | Array[] | 否 | |
receivePayType | 0-信用付 ;1-即付 | String | 是 | |
mixClass | PM2023084添加 是否允许混舱:0.不允许 1.允许 默认不允许 | String | 否 | |
checkInLuggage | PM2023084添加 免费托运行李:1.不限免费托运行李 2.仅查免费托运行李,默认1 | String | 否 | |
isRefund | PM2023084添加 是否可退票:1.不限 2.仅查可退票,默认1 | String | 否 | |
isChange | PM2023084添加 是否可改期:1.不限 2.仅查可改期,默认1 | String | 否 | |
asynchronousReturn | PM2023084添加是否异步加载:1. 同步 2.异步,默认1 | Integer | 否 | |
asyReturnKey | PM2023084添加异步返回key,多次查询使用 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
passengerTypeAndNumber | PM2023084添加旅客人数,必填默认1 | Array[] | 否 | |
type | 旅客类型;成人,儿童,婴儿 | String | passengerTypeAndNumber | |
count | 数量 | Integer | passengerTypeAndNumber | |
journeys | 多程时,journeys 必传(目前只支持新版国际机票(2023-09-25加)) | Array[] | 否 | |
departureCityCode | 出发城市三字码 | String | journeys | |
arrivalCityCode | 到达城市三字码 | String | journeys | |
departureDate | 出发日期 | String | journeys |
{
"departureCity":"SHA", //出发城市三字码
"arrivalCity":"CAN", //达到城市三字码
"departureDate":"2023-10-25", //离开日期
"arrivalDate":"2023-10-29", //返回日期,非必填,往返才需要
"tripType":"1", //行程类型;1:单程 2:往返 3:多程()
"isDFO":"F", //是否仅直飞 T是 F否
"airline":"CA", //航司二字码
"cabinClass":"1", //舱位等级,必传 1-经济舱,2-公务舱,3-头等舱,4-豪华经济舱;暂不支持全舱位查询
"passengerList":"[ak10002,ak10003]", //非必填,如果传了旅客外部编号时,多个旅客用逗号间隔,为空时仅可会获取产品类型是协议、自营产品
"receivePayType":"0", //0-信用付 ;1-即付
"mixClass":"0", //PM2023084添加 是否允许混舱:0.不允许 1.允许 默认不允许
"checkInLuggage":"1", //PM2023084添加 免费托运行李:1.不限免费托运行李 2.仅查免费托运行李,默认1
"isRefund":"1", //PM2023084添加 是否可退票:1.不限 2.仅查可退票,默认1
"isChange":"1", //PM2023084添加 是否可改期:1.不限 2.仅查可改期,默认1
"passengerTypeAndNumber":
[{
"type":"成人", //旅客类型;成人,儿童,婴儿
"count":1, //数量
}], //PM2023084添加旅客人数,必填默认1
"asynchronousReturn":1, //PM2023084添加是否异步加载:1. 同步 2.异步,默认1
"asyReturnKey":"1", //PM2023084添加异步返回key,多次查询使用
"journeys":
[{
"departureCityCode":"SHA", //出发城市三字码
"arrivalCityCode":"CAN", //到达城市三字码
"departureDate":"1", //出发日期
}], //多程时,journeys 必传(目前只支持新版国际机票(2023-09-25加))
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
finish | 查询是否结束:0未结束可继续,1表示查询已结束无更多报价; | String | ||
asyReturnKey | 异步返回key,多次查询使用 | String | ||
resultId | ST的唯一号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
flightInfoList | Array[] | |||
platingCarrier | 销售航司 | String | flightInfoList | |
flightId | 航程Id,新版已不使用该参数,忽略 | Integer | flightInfoList | |
tripId | PM2023084添加 新版返回tripId代替flightId | String | flightInfoList | |
priceInfos | 价格信息 | Array[] | flightInfoList | |
solutionId | PM2023084添加 方案Id | String | flightInfoList.priceInfos | |
passengerType | 乘客类型,PASSENGER_ADULT,PASSENGER_CHILD,PASSENGER_BABY, | String | flightInfoList.priceInfos | |
passengerTypeCount | 乘客数量 | String | flightInfoList.priceInfos | |
activeTime | PM2023084添加 票价出票时限 | String | flightInfoList.priceInfos | |
proofType | PM2023084添加 报销凭证:1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,7=按政策设置,8=无 | Integer | flightInfoList.priceInfos | |
baseFare | 销售 -- 票面价 | Number | flightInfoList.priceInfos | |
tax | 销售 - 税 | Number | flightInfoList.priceInfos | |
servicePriceTotal | 服务费合计 | Number | flightInfoList.priceInfos | |
protocolStrategryCode | 三方协议产品编号 | String | flightInfoList.priceInfos | |
protocolShowType | 协议类型显示标识((0代表不显示、1代表显示协议、2代表显示美亚特惠)) | Integer | flightInfoList.priceInfos | |
source | 来源 (IBEPLUS航司接口;syber) | String | flightInfoList.priceInfos | |
fareType | 票证类型(10 美亚BSP,20 境外票,30 B2B, 40非美亚BSP,50航司直连) | String | flightInfoList.priceInfos | |
isRequireCertificate | 证件号是否为必填 | Boolean | flightInfoList.priceInfos | |
currency | 结算币种 | String | flightInfoList.priceInfos | |
FrequentTravellers | 常旅客计划 | Array[] | flightInfoList.priceInfos | |
airlineCode | 航司二字代码 | String | flightInfoList.priceInfos.FrequentTravellers | |
name | 常旅客计划中文名 | String | flightInfoList.priceInfos.FrequentTravellers | |
enName | 常旅客计划英文名 | String | flightInfoList.priceInfos.FrequentTravellers | |
SupportCertificates | 支持的证件类型 | Array[] | flightInfoList.priceInfos | |
certificateType | 证件类型 | String | flightInfoList.priceInfos.SupportCertificates | |
certificateTypeName | 证件类型中文名 | String | flightInfoList.priceInfos.SupportCertificates | |
CountryOrAreas | 国家或国家地区代码,空为不限 | Array[] | flightInfoList.priceInfos.SupportCertificates | |
code | 国家或国家地区代码 | String | flightInfoList.priceInfos.SupportCertificates.CountryOrAreas | |
name | 国家或国家地区中文名称 | String | flightInfoList.priceInfos.SupportCertificates.CountryOrAreas | |
Clazzs | 舱位信息 | Array[] | flightInfoList.priceInfos | |
flightId | 航班序号,对应航段信息里的flightId | String | flightInfoList.priceInfos.Clazzs | |
clazzNo | 舱位编码; 示例:P | String | flightInfoList.priceInfos.Clazzs | |
classLevel | 舱等;1-经济舱;2-商务舱;3-头等舱;4-豪华经济舱 | String | flightInfoList.priceInfos.Clazzs | |
seatNo | 座位数 | String | flightInfoList.priceInfos.Clazzs | |
policy | 差旅政策 | PolicyType | flightInfoList.priceInfos | |
farePriceType | 票价类型,公有 = 0,私有 = 1,协议= 2 | String | flightInfoList.priceInfos.policy | |
isHaveTravelItinerary | 是否有行程单 | Boolean | flightInfoList.priceInfos.policy | |
travelItinerary | 报销凭证,1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,8=无 | String | flightInfoList.priceInfos.policy | |
group | 团价信息 | GroupInfo | flightInfoList.priceInfos.policy | |
groupTag | 按逻辑运算符合数字拼装 | String | flightInfoList.priceInfos.policy.group | |
content | 内容,比如,此价格仅限2-9人 | String | flightInfoList.priceInfos.policy.group | |
structor | 团价结构化信息 json化 | String | flightInfoList.priceInfos.policy.group | |
supplierService | 供应商服务内容 | PolicySupplierServiceDto | flightInfoList.priceInfos.policy | |
Change | 改签 | SupplierServiceChangeDto | flightInfoList.priceInfos.policy.supplierService | |
Content | 服务内容 | String | flightInfoList.priceInfos.policy.supplierService.Change | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | flightInfoList.priceInfos.policy.supplierService.Change | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | flightInfoList.priceInfos.policy.supplierService.Change.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | flightInfoList.priceInfos.policy.supplierService.Change.ServiceTime | |
Refund | 退票 | SupplierServiceRefundDto | flightInfoList.priceInfos.policy.supplierService | |
Content | 服务内容 | String | flightInfoList.priceInfos.policy.supplierService.Refund | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | flightInfoList.priceInfos.policy.supplierService.Refund | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | flightInfoList.priceInfos.policy.supplierService.Refund.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | flightInfoList.priceInfos.policy.supplierService.Refund.ServiceTime | |
Issue | 出票 | SupplierServiceIssueDto | flightInfoList.priceInfos.policy.supplierService | |
ServicerType | 服务商类型(0=美亚自营,1=供应商提供服务) | Integer | flightInfoList.priceInfos.policy.supplierService.Issue | |
Content | 服务内容 | String | flightInfoList.priceInfos.policy.supplierService.Issue | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | flightInfoList.priceInfos.policy.supplierService.Issue | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | flightInfoList.priceInfos.policy.supplierService.Issue.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | flightInfoList.priceInfos.policy.supplierService.Issue.ServiceTime | |
Void | 作废 | SupplierServiceVoidDto | flightInfoList.priceInfos.policy.supplierService | |
IsCanVoid | 是否可以废票 | Boolean | flightInfoList.priceInfos.policy.supplierService.Void | |
VoidEffective | 作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认] | Integer | flightInfoList.priceInfos.policy.supplierService.Void | |
VoidTicketingDeadline | 废票截止时间 格式 yyyy-MM-ddTHH:mm:ss | String | flightInfoList.priceInfos.policy.supplierService.Void | |
Content | 服务内容 | String | flightInfoList.priceInfos.policy.supplierService.Void | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | flightInfoList.priceInfos.policy.supplierService.Void | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | flightInfoList.priceInfos.policy.supplierService.Void.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | flightInfoList.priceInfos.policy.supplierService.Void.ServiceTime | |
limiting | 限制信息 | PricePolicyLimitingDto | flightInfoList.priceInfos.policy | |
conentHadTheme | String | flightInfoList.priceInfos.policy.limiting | ||
contents | 限制内容 | Array[] | flightInfoList.priceInfos.policy.limiting | |
isRequiredCertificatePhoto | 是否需要证件照片 | Boolean | flightInfoList.priceInfos.policy.limiting | |
age | 年龄限制 | LimitingAgeDto | flightInfoList.priceInfos.policy.limiting | |
minAge | 最小年龄 | Integer | flightInfoList.priceInfos.policy.limiting.age | |
maxAge | 最大年龄 | Integer | flightInfoList.priceInfos.policy.limiting.age | |
typeName | 类型名称 | String | flightInfoList.priceInfos.policy.limiting.age | |
content | 限制内容 | String | flightInfoList.priceInfos.policy.limiting.age | |
nationalityOrArea | 国家或区域限制 | LimitingNationalityOrAreaDto | flightInfoList.priceInfos.policy.limiting | |
limitingCondition | 国籍限制条件:允许 true/不允许 false | Boolean | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
nationalityOrAreaNames | 国籍/地区名称 | Array[] | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
nationalityOrAreaCodes | 国籍/地区二字码 | Array[] | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
typeName | 类型名称 | String | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
content | 限制内容 | String | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
passagerCount | 旅客人数限制 | LimitingPassagerCountDto | flightInfoList.priceInfos.policy.limiting | |
minCount | 最小数量 | Integer | flightInfoList.priceInfos.policy.limiting.passagerCount | |
maxCount | 最大数量 | Integer | flightInfoList.priceInfos.policy.limiting.passagerCount | |
isMustBeEvenNumber | 是否必须偶数 | Boolean | flightInfoList.priceInfos.policy.limiting.passagerCount | |
typeName | 类型名称 | String | flightInfoList.priceInfos.policy.limiting.passagerCount | |
content | 限制内容 | String | flightInfoList.priceInfos.policy.limiting.passagerCount | |
certificate | 证件限制 | LimitingCertificateDto | flightInfoList.priceInfos.policy.limiting | |
limitingCondition | 证件类型名称限制条件:允许 true/不允许 false | Boolean | flightInfoList.priceInfos.policy.limiting.certificate | |
certificateTypeNames | 证件类型名称 | Array[] | flightInfoList.priceInfos.policy.limiting.certificate | |
certificateTypeCodes | 证件类型编码 | Array[] | flightInfoList.priceInfos.policy.limiting.certificate | |
certificateTypes | 证件类型 | Array[] | flightInfoList.priceInfos.policy.limiting.certificate | |
typeName | 类型名称 | String | flightInfoList.priceInfos.policy.limiting.certificate | |
content | 限制内容 | String | flightInfoList.priceInfos.policy.limiting.certificate | |
luggageList | PM2024166_国际标准API搜索、更多价格接口返回值增加行李额字段 | Array[] | flightInfoList.priceInfos | |
flightNo | 航班号 | String | flightInfoList.priceInfos.luggageList | |
departureCityName | 出发城市名称 | String | flightInfoList.priceInfos.luggageList | |
arrivalCityName | 到达城市名称 | String | flightInfoList.priceInfos.luggageList | |
departureCityCode | 出发城市三字码 | String | flightInfoList.priceInfos.luggageList | |
arrivalCityCode | 到达城市三字码 | String | flightInfoList.priceInfos.luggageList | |
checkInLuggagePieces | 免费托运行李件数 | String | flightInfoList.priceInfos.luggageList | |
checkInLuggageWeight | 免费托运行李重量 | String | flightInfoList.priceInfos.luggageList | |
checkInLuggageDemision | 免费托运行李体积 | String | flightInfoList.priceInfos.luggageList | |
checkInLuggageText | 行李额描述(免费托运行李) 新增字段,长宽高文本 | String | flightInfoList.priceInfos.luggageList | |
handLuggagePieces | 手提行李件数,允许件数(免费手提行李) | String | flightInfoList.priceInfos.luggageList | |
handLuggageWeight | 允许重量(免费手提行李) | String | flightInfoList.priceInfos.luggageList | |
handLuggageDemision | 体积(免费手提行李) | String | flightInfoList.priceInfos.luggageList | |
handLuggageText | 行李额描述(免费手提行李)长宽高文本 | String | flightInfoList.priceInfos.luggageList | |
seatBag | 随身物品内容 | LuaggageStructDto | flightInfoList.priceInfos.luggageList | |
Pieces | String | flightInfoList.priceInfos.luggageList.seatBag | ||
Weight | String | flightInfoList.priceInfos.luggageList.seatBag | ||
Demision | String | flightInfoList.priceInfos.luggageList.seatBag | ||
Description | String | flightInfoList.priceInfos.luggageList.seatBag | ||
CheckStruct | 托运行李结构化 | LuaggageStructDto | flightInfoList.priceInfos.luggageList | |
Pieces | String | flightInfoList.priceInfos.luggageList.CheckStruct | ||
Weight | String | flightInfoList.priceInfos.luggageList.CheckStruct | ||
Demision | String | flightInfoList.priceInfos.luggageList.CheckStruct | ||
Description | String | flightInfoList.priceInfos.luggageList.CheckStruct | ||
HandStruct | 手提行李结构化 | LuaggageStructDto | flightInfoList.priceInfos.luggageList | |
Pieces | String | flightInfoList.priceInfos.luggageList.HandStruct | ||
Weight | String | flightInfoList.priceInfos.luggageList.HandStruct | ||
Demision | String | flightInfoList.priceInfos.luggageList.HandStruct | ||
Description | String | flightInfoList.priceInfos.luggageList.HandStruct | ||
flightInfos | 航班信息 | Array[] | flightInfoList | |
segmentId | 在此集合中的ID | Integer | flightInfoList.flightInfos | |
flightId | 航程Id | String | flightInfoList.flightInfos | |
tripType | 行程类别,0第一程(去程) 、1第二程(回程)、2第三程(多程) | String | flightInfoList.flightInfos | |
journeyIndex | 行程序号(从1开始的自然数。表示第几个航程) | String | flightInfoList.flightInfos | |
departureAirport | 出发机场 | String | flightInfoList.flightInfos | |
arrivalAirport | 目的机场 | String | flightInfoList.flightInfos | |
termDep | 起飞航站楼 | String | flightInfoList.flightInfos | |
termArr | 到达航站楼 | String | flightInfoList.flightInfos | |
depAirportName | 出发机场中文名称 | String | flightInfoList.flightInfos | |
arrAirportName | 到达机场中文名称 | String | flightInfoList.flightInfos | |
depCity | 出发城市三字码 | String | flightInfoList.flightInfos | |
arrCity | 到达城市三字码 | String | flightInfoList.flightInfos | |
depCityName | 出发城市中文名称 | String | flightInfoList.flightInfos | |
arrCityName | 到达城市中文名称 | String | flightInfoList.flightInfos | |
departureDate | 出发日期 | String | flightInfoList.flightInfos | |
departuretimeModify | 本航段的起飞日期修正,例如+1表示第二天 | String | flightInfoList.flightInfos | |
departureTime | 出发时间 | String | flightInfoList.flightInfos | |
arrivalDate | 到达日期 | String | flightInfoList.flightInfos | |
arrivaltimeModify | 得到本航段的到达日期修正,例如+1表示第二天 | String | flightInfoList.flightInfos | |
arrivalTime | 到达时间 | String | flightInfoList.flightInfos | |
marketingAirline | 销售航司 | String | flightInfoList.flightInfos | |
marketingAirlineName_CN | 销售航司 中文名 | String | flightInfoList.flightInfos | |
airlineAllianceCode | 航司联盟(STARALLIANCE=星空联盟,ONEWORLD=寰宇一家,SKYTEAM=天合联盟) | String | flightInfoList.flightInfos | |
flightNumber | 航班号 | String | flightInfoList.flightInfos | |
operatingCarrier | 实际承运航空公司,共享航班才有值 | String | flightInfoList.flightInfos | |
operatingFlightNumber | 实际承运航班号 ,共享航班才有值 | String | flightInfoList.flightInfos | |
equipment | 机型类别代码 | String | flightInfoList.flightInfos | |
equipmentName | 机型类别代码 | String | flightInfoList.flightInfos | |
equipmentEnName | 机型英文名称 | String | flightInfoList.flightInfos | |
equipmentBodyName | 机型型号 | String | flightInfoList.flightInfos | |
equipmentBodyType | 机型类型 1小型、2中型、3大型 | String | flightInfoList.flightInfos | |
equipmentMaxPassengers | 机型最大载客数 | String | flightInfoList.flightInfos | |
equipmentMinPassengers | 机型最小载客数 | String | flightInfoList.flightInfos | |
equipmentType | 航班载体类型(0=飞机,1=火车,2=汽车,3=船) | String | flightInfoList.flightInfos | |
planeType | 超宽体 宽体 窄体 未知 | String | flightInfoList.flightInfos | |
duration | 飞行时间,单位为分钟 | String | flightInfoList.flightInfos | |
distance | 飞行距离,单位为KM | String | flightInfoList.flightInfos | |
depWorldRegionCode | 出发 世界区域 | String | flightInfoList.flightInfos | |
intermediateAirports | 经停信息 | Array[] | flightInfoList.flightInfos | |
clazz | 航位 | String | flightInfoList.flightInfos | |
cabin | 航等;1 经济舱 2 公务舱 3 头等舱 4 超级经济舱 | String | flightInfoList.flightInfos | |
seatNo | 座位数 | String | flightInfoList.flightInfos | |
LuggageHangingType | 行李直挂类型 1不允许直挂 2允许直挂明细规则 3未知 | String | flightInfoList.flightInfos | |
VisaType | 过境签类型 1 需要过境签 2可能需过境签 3不需要过境签 4其它 | String | flightInfoList.flightInfos | |
VisaContent | 非必输 String 过境签内容说明 | String | flightInfoList.flightInfos | |
isFood | 是否有食物 | Boolean | flightInfoList.flightInfos | |
stops | 新经停(使用这个) | Array[] | flightInfoList.flightInfos | |
airportCode | 经停机场 | String | flightInfoList.flightInfos.stops | |
airportName | 经停机场名称 | String | flightInfoList.flightInfos.stops | |
cityCode | 经停城市 | String | flightInfoList.flightInfos.stops | |
cityName | 经停名称 | String | flightInfoList.flightInfos.stops | |
duration | 经停时间 HH:mm | String | flightInfoList.flightInfos.stops | |
arrivalDate | 到达时间 格式 yyyy-MM-dd | String | flightInfoList.flightInfos.stops | |
arrivalTime | 到达时间 格式 HH:mm | String | flightInfoList.flightInfos.stops | |
departureDate | 起飞日期 格式 yyyy-MM-dd | String | flightInfoList.flightInfos.stops | |
departureTime | 起飞时间 格式 HH:mm | String | flightInfoList.flightInfos.stops | |
FlightDetailDto | 航班详细信息 | FlightDetailDto | flightInfoList.flightInfos | |
FlightProperty | 航班属性flightProperty字段枚举值说明:枚举值0-国内-国内 1-国内-国际 2-国内-地区 3-地区-国际 4-国际-国际 | String | flightInfoList.flightInfos.FlightDetailDto | |
AvgPlanDuration | 未来平均计划时间: HH:mm | String | flightInfoList.flightInfos.FlightDetailDto | |
DepAvgDelayTime | 平均出发延误时间(分钟): 15 | String | flightInfoList.flightInfos.FlightDetailDto | |
ArrAvgDelayTime | 平均到达延误时间(分钟): 10 | String | flightInfoList.flightInfos.FlightDetailDto | |
DepBridgeRate | 出港靠桥率: 80% | String | flightInfoList.flightInfos.FlightDetailDto | |
ArrBridgeRate | 进港靠桥率: 75% | String | flightInfoList.flightInfos.FlightDetailDto | |
DepOnTimeRate | 出发准点率: 90% | String | flightInfoList.flightInfos.FlightDetailDto | |
ArrOnTimeRate | 到达准点率: 85% | String | flightInfoList.flightInfos.FlightDetailDto | |
AircraftAge | 平均机龄: 5年 | String | flightInfoList.flightInfos.FlightDetailDto | |
ThemeFlight | 主题航班: 无 | String | flightInfoList.flightInfos.FlightDetailDto | |
Luggage | 行李限额描述: 免费托运20公斤 | String | flightInfoList.flightInfos.FlightDetailDto | |
Cabins | 舱位信息 | Array[] | flightInfoList.flightInfos.FlightDetailDto | |
ClassLevel | 舱等 经济舱 = 1,公务舱 = 2,头等舱 = 3,豪华经济舱 = 4 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
PerCapita | 人均碳排放量,单位:千克: 100kg | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
InTotal | 总碳排放量,单位:千克: 200kg | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
PerCapitaTree | 人均消耗树量,单位:棵: 1棵树 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
SeatWidth | 座位宽度: 17.5英寸 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
SeatTilt | 座椅倾斜度: 可调节 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
Beverage | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Beverage | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Beverage | |
Entertainment | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Entertainment | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Entertainment | |
Food | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Food | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Food | |
Power | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Power | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Power | |
Wifi | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Wifi | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Wifi | |
Layout | FlightDetailCabinLayoutDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
RowLayout | 3-3 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Layout | |
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Layout | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Layout | |
Seat | FlightDetailCabinSeatDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
Pitch | "34" | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Seat | |
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Seat | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Seat |
{
"flightInfoList":
[{
"platingCarrier":"CX", //销售航司
"flightId":0, //航程Id,新版已不使用该参数,忽略
"tripId":"173279100981c8ee7e99ecdf1d3f12c8", //PM2023084添加 新版返回tripId代替flightId
"flightInfos":
[{
"segmentId":0, //在此集合中的ID
"flightId":"1206PEKHKGCX393", //航程Id
"tripType":"0", //行程类别,0第一程(去程) 、1第二程(回程)、2第三程(多程)
"journeyIndex":"1", //行程序号(从1开始的自然数。表示第几个航程)
"departureAirport":"PEK", //出发机场
"arrivalAirport":"HKG", //目的机场
"termDep":"3", //起飞航站楼
"termArr":"1", //到达航站楼
"depAirportName":"首都国际机场", //出发机场中文名称
"arrAirportName":"香港国际机场", //到达机场中文名称
"depCity":"BJS", //出发城市三字码
"arrCity":"HKG", //到达城市三字码
"depCityName":"北京", //出发城市中文名称
"arrCityName":"中国香港", //到达城市中文名称
"departureDate":"2023-12-06", //出发日期
"departuretimeModify": "", //本航段的起飞日期修正,例如+1表示第二天
"departureTime":"18:35", //出发时间
"arrivalDate":"2023-12-06", //到达日期
"arrivaltimeModify": "", //得到本航段的到达日期修正,例如+1表示第二天
"arrivalTime":"22:25", //到达时间
"marketingAirline":"CX", //销售航司
"marketingAirlineName_CN":"国泰航空", //销售航司 中文名
"airlineAllianceCode":"STARALLIANCE", //航司联盟(STARALLIANCE=星空联盟,ONEWORLD=寰宇一家,SKYTEAM=天合联盟)
"flightNumber":"393", //航班号
"operatingCarrier": "", //实际承运航空公司,共享航班才有值
"operatingFlightNumber": "", //实际承运航班号 ,共享航班才有值
"equipment":"333", //机型类别代码
"equipmentName":"空客330", //机型类别代码
"equipmentEnName":"Airbus A330", //机型英文名称
"equipmentBodyName":"空客330", //机型型号
"equipmentBodyType":"3", //机型类型 1小型、2中型、3大型
"equipmentMaxPassengers":"100", //机型最大载客数
"equipmentMinPassengers":"30", //机型最小载客数
"equipmentType":"0", //航班载体类型(0=飞机,1=火车,2=汽车,3=船)
"planeType":"宽体", //超宽体 宽体 窄体 未知
"duration":"230", //飞行时间,单位为分钟
"distance":"1234", //飞行距离,单位为KM
"depWorldRegionCode": "", //出发 世界区域
"intermediateAirports":"null", //经停信息
"clazz":"V", //航位
"cabin":"1", //航等;1 经济舱 2 公务舱 3 头等舱 4 超级经济舱
"seatNo":"9", //座位数
"stops":
[{
"airportCode":"WUH", //经停机场
"airportName":"天河国际机场", //经停机场名称
"cityCode":"WUH", //经停城市
"cityName":"武汉", //经停名称
"duration": "", //经停时间 HH:mm
"arrivalDate": "", //到达时间 格式 yyyy-MM-dd
"arrivalTime": "", //到达时间 格式 HH:mm
"departureDate": "", //起飞日期 格式 yyyy-MM-dd
"departureTime": "", //起飞时间 格式 HH:mm
}], //新经停(使用这个)
"LuggageHangingType":"1", //行李直挂类型 1不允许直挂 2允许直挂明细规则 3未知
"VisaType":"3", //过境签类型 1 需要过境签 2可能需过境签 3不需要过境签 4其它
"VisaContent":"国际旅客无需签证即可在马来西亚过境。", //非必输 String 过境签内容说明
"isFood":true, //是否有食物
"FlightDetailDto":
{
"FlightProperty": "", //航班属性flightProperty字段枚举值说明:枚举值0-国内-国内 1-国内-国际 2-国内-地区 3-地区-国际 4-国际-国际
"AvgPlanDuration": "", //未来平均计划时间: HH:mm
"DepAvgDelayTime": "", //平均出发延误时间(分钟): 15
"ArrAvgDelayTime": "", //平均到达延误时间(分钟): 10
"DepBridgeRate": "", //出港靠桥率: 80%
"ArrBridgeRate": "", //进港靠桥率: 75%
"DepOnTimeRate": "", //出发准点率: 90%
"ArrOnTimeRate": "", //到达准点率: 85%
"AircraftAge": "", //平均机龄: 5年
"Cabins":
[{
"ClassLevel": "", //舱等 经济舱 = 1,公务舱 = 2,头等舱 = 3,豪华经济舱 = 4
"PerCapita": "", //人均碳排放量,单位:千克: 100kg
"InTotal": "", //总碳排放量,单位:千克: 200kg
"PerCapitaTree": "", //人均消耗树量,单位:棵: 1棵树
"SeatWidth": "", //座位宽度: 17.5英寸
"SeatTilt": "", //座椅倾斜度: 可调节
"Beverage":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Entertainment":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Food":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Layout":
{
"RowLayout": "", //3-3
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Power":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Seat":
{
"Pitch": "", //"34"
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Wifi":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
}], //舱位信息
"ThemeFlight": "", //主题航班: 无
"Luggage": "", //行李限额描述: 免费托运20公斤
}, //航班详细信息
}], //航班信息
"priceInfos":
[{
"Clazzs":
[{
"flightId":"9", //航班序号,对应航段信息里的flightId
"clazzNo":"9", //舱位编码; 示例:P
"classLevel":"1", //舱等;1-经济舱;2-商务舱;3-头等舱;4-豪华经济舱
"seatNo":"9", //座位数
}], //舱位信息
"solutionId":"6e151d0b039b4eeaabb59fdac2d0051c", //PM2023084添加 方案Id
"passengerType":"PASSENGER_ADULT", //乘客类型,PASSENGER_ADULT,PASSENGER_CHILD,PASSENGER_BABY,
"passengerTypeCount":"1", //乘客数量
"activeTime":"2023-12-06 12:45:00", //PM2023084添加 票价出票时限
"proofType":1, //PM2023084添加 报销凭证:1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,7=按政策设置,8=无
"baseFare":6490, //销售 -- 票面价
"tax":1356.0, //销售 - 税
"servicePriceTotal":0.0, //服务费合计
"protocolStrategryCode":"TBOrderInfo", //三方协议产品编号
"protocolShowType":0, //协议类型显示标识((0代表不显示、1代表显示协议、2代表显示美亚特惠))
"source":"IBEPLUS", //来源 (IBEPLUS航司接口;syber)
"fareType":"10", //票证类型(10 美亚BSP,20 境外票,30 B2B, 40非美亚BSP,50航司直连)
"luggageList":
[{
"flightNo": "", //航班号
"departureCityName":"北京", //出发城市名称
"arrivalCityName":"青岛", //到达城市名称
"departureCityCode":"BJS", //出发城市三字码
"arrivalCityCode":"TAO", //到达城市三字码
"checkInLuggagePieces":"2", //免费托运行李件数
"checkInLuggageWeight": "", //免费托运行李重量
"checkInLuggageDemision": "", //免费托运行李体积
"checkInLuggageText": "", //行李额描述(免费托运行李) 新增字段,长宽高文本
"handLuggagePieces":"1", //手提行李件数,允许件数(免费手提行李)
"handLuggageWeight": "", //允许重量(免费手提行李)
"handLuggageDemision": "", //体积(免费手提行李)
"handLuggageText": "", //行李额描述(免费手提行李)长宽高文本
"seatBag":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //随身物品内容
"CheckStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //托运行李结构化
"HandStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //手提行李结构化
}], //PM2024166_国际标准API搜索、更多价格接口返回值增加行李额字段
"policy":
{
"farePriceType": "", //票价类型,公有 = 0,私有 = 1,协议= 2
"isHaveTravelItinerary":false, //是否有行程单
"travelItinerary": "", //报销凭证,1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,8=无
"group":
{
"groupTag": "", //按逻辑运算符合数字拼装
"content": "", //内容,比如,此价格仅限2-9人
"structor": "", //团价结构化信息 json化
}, //团价信息
"supplierService":
{
"Issue":
{
"ServicerType":0, //服务商类型(0=美亚自营,1=供应商提供服务)
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //出票
"Change":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //改签
"Refund":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //退票
"Void":
{
"IsCanVoid":false, //是否可以废票
"VoidEffective":0, //作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认]
"VoidTicketingDeadline": "", //废票截止时间 格式 yyyy-MM-ddTHH:mm:ss
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //作废
}, //供应商服务内容
"limiting":
{
"conentHadTheme": "", //
"contents":[], //限制内容
"isRequiredCertificatePhoto":false, //是否需要证件照片
"nationalityOrArea":
{
"limitingCondition":false, //国籍限制条件:允许 true/不允许 false
"nationalityOrAreaNames":[], //国籍/地区名称
"nationalityOrAreaCodes":[], //国籍/地区二字码
"typeName": "", //类型名称
"content": "", //限制内容
}, //国家或区域限制
"certificate":
{
"limitingCondition":false, //证件类型名称限制条件:允许 true/不允许 false
"certificateTypeNames":[], //证件类型名称
"certificateTypeCodes":[], //证件类型编码
"certificateTypes":[], //证件类型
"typeName": "", //类型名称
"content": "", //限制内容
}, //证件限制
"age":
{
"minAge":0, //最小年龄
"maxAge":0, //最大年龄
"typeName": "", //类型名称
"content": "", //限制内容
}, //年龄限制
"passagerCount":
{
"minCount":0, //最小数量
"maxCount":0, //最大数量
"isMustBeEvenNumber":false, //是否必须偶数
"typeName": "", //类型名称
"content": "", //限制内容
}, //旅客人数限制
}, //限制信息
}, //差旅政策
"FrequentTravellers":
[{
"airlineCode": "", //航司二字代码
"name": "", //常旅客计划中文名
"enName": "", //常旅客计划英文名
}], //常旅客计划
"isRequireCertificate":false, //证件号是否为必填
"SupportCertificates":
[{
"certificateType": "", //证件类型
"certificateTypeName": "", //证件类型中文名
"CountryOrAreas":
[{
"code": "", //国家或国家地区代码
"name": "", //国家或国家地区中文名称
}], //国家或国家地区代码,空为不限
}], //支持的证件类型
"currency":"CNY", //结算币种
}], //价格信息
}], //
"finish":"1", //查询是否结束:0未结束可继续,1表示查询已结束无更多报价;
"asyReturnKey":"965eae861c534eb2b689f739e45e010e", //异步返回key,多次查询使用
"resultId":"965eae861c534eb2b689f739e45e010e", //ST的唯一号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
机票查询当前已选航班的舱位和价格详细信息
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
resultID | ST的唯一号 | String | 否 | |
tripId | PM2023084添加 新版返回tripId代替flightId | String | 否 |
{
"resultID":"98a99dc66b6540e2a5c69fc4f273b226", //ST的唯一号
"tripId":"b4f2337762a705f1988eff2b47cb494d", //PM2023084添加 新版返回tripId代替flightId
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
resultID | ST的唯一号 | String | ||
isTakeMoreTrip | 是否可以获取更多行程(用于异步查询更多行程) | Boolean | ||
guid | 当前请求guid | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
listTripInfo | 行程组合信息集合 | Array[] | ||
tripId | 新版返回tripId代替flightId | String | listTripInfo | |
solutionId | 当前查询航班返回结果的唯一号 | String | listTripInfo | |
isEnable | 判断航班是否4小时以内0 4小时外 1 4小时内 | Integer | listTripInfo | |
IsDirectFlight | 是否直飞 | Boolean | listTripInfo | |
policyResultList | 政策实体类(PolicyResultList (string(旅客), PolicyResult>); 如果是先航班后旅客,则取公司的基础差旅政策;旅客KEY值为:XXXXXX | Array[] | listTripInfo | |
passengerCode | 旅客编号 | String | listTripInfo.policyResultList | |
priceInfos | 价格信息 | Array[] | listTripInfo | |
passengertypecount | 乘客数量 | String | listTripInfo.priceInfos | |
accountCode | 大客户编码 | String | listTripInfo.priceInfos | |
basefare | 销售 -- 票面价 | Number | listTripInfo.priceInfos | |
basefarecurrency | 销售票面价 -- 币种 | String | listTripInfo.priceInfos | |
tax | 销售 - 税 | Number | listTripInfo.priceInfos | |
taxcurrency | 销售税 - 币种 | String | listTripInfo.priceInfos | |
servicePriceTotal | 服务费合计 = 服务费基础 + 服务费附加 | Number | listTripInfo.priceInfos | |
protocolShowType | TMC促销策略显示标识((0代表不显示、1代表显示美亚特惠,2,代表显示协议 )) | Integer | listTripInfo.priceInfos | |
farePriceType | 票价类型:公有运价 = 0,私有运价 = 1,协议价= 2 | String | listTripInfo.priceInfos | |
protocolStrategryCode | 三方协议产品编号 | String | listTripInfo.priceInfos | |
source | 来源 (1协议;2美亚特惠、3自营、4第三方、5合作商、6官网、7NDC) | String | listTripInfo.priceInfos | |
fareType | 票证类型(10 美亚BSP,20 境外票,30 B2B, 40非美亚BSP,50航司直连) | String | listTripInfo.priceInfos | |
isHaveTravelItinerary | 是否有行程单 | Boolean | listTripInfo.priceInfos | |
activeTime | 票价出票时限 | String | listTripInfo.priceInfos | |
haveTravelItinerary | 报销凭证:1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,7=按政策设置,8=无 | String | listTripInfo.priceInfos | |
productName | 品牌运价产品名称 | String | listTripInfo.priceInfos | |
Clazzs | 舱位信息 | Array[] | listTripInfo.priceInfos | |
flightId | 航班序号,对应航段信息里的flightId | String | listTripInfo.priceInfos.Clazzs | |
clazzNo | 舱位编码; 示例:P | String | listTripInfo.priceInfos.Clazzs | |
classLevel | 舱等;1-经济舱;2-商务舱;3-头等舱;4-豪华经济舱 | String | listTripInfo.priceInfos.Clazzs | |
seatNo | 座位数 | String | listTripInfo.priceInfos.Clazzs | |
policy | 政策信息 | PolicyType | listTripInfo.priceInfos | |
farePriceType | 票价类型,公有 = 0,私有 = 1,协议= 2 | String | listTripInfo.priceInfos.policy | |
isHaveTravelItinerary | 是否有行程单 | Boolean | listTripInfo.priceInfos.policy | |
travelItinerary | 报销凭证,1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,8=无 | String | listTripInfo.priceInfos.policy | |
group | 团价信息 | GroupInfo | listTripInfo.priceInfos.policy | |
groupTag | 按逻辑运算符合数字拼装 | String | listTripInfo.priceInfos.policy.group | |
content | 内容,比如,此价格仅限2-9人 | String | listTripInfo.priceInfos.policy.group | |
structor | 团价结构化信息 json化 | String | listTripInfo.priceInfos.policy.group | |
supplierService | 供应商服务内容 | PolicySupplierServiceDto | listTripInfo.priceInfos.policy | |
Change | 改签 | SupplierServiceChangeDto | listTripInfo.priceInfos.policy.supplierService | |
Content | 服务内容 | String | listTripInfo.priceInfos.policy.supplierService.Change | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | listTripInfo.priceInfos.policy.supplierService.Change | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | listTripInfo.priceInfos.policy.supplierService.Change.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | listTripInfo.priceInfos.policy.supplierService.Change.ServiceTime | |
Refund | 退票 | SupplierServiceRefundDto | listTripInfo.priceInfos.policy.supplierService | |
Content | 服务内容 | String | listTripInfo.priceInfos.policy.supplierService.Refund | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | listTripInfo.priceInfos.policy.supplierService.Refund | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | listTripInfo.priceInfos.policy.supplierService.Refund.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | listTripInfo.priceInfos.policy.supplierService.Refund.ServiceTime | |
Issue | 出票 | SupplierServiceIssueDto | listTripInfo.priceInfos.policy.supplierService | |
ServicerType | 服务商类型(0=美亚自营,1=供应商提供服务) | Integer | listTripInfo.priceInfos.policy.supplierService.Issue | |
Content | 服务内容 | String | listTripInfo.priceInfos.policy.supplierService.Issue | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | listTripInfo.priceInfos.policy.supplierService.Issue | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | listTripInfo.priceInfos.policy.supplierService.Issue.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | listTripInfo.priceInfos.policy.supplierService.Issue.ServiceTime | |
Void | 作废 | SupplierServiceVoidDto | listTripInfo.priceInfos.policy.supplierService | |
IsCanVoid | 是否可以废票 | Boolean | listTripInfo.priceInfos.policy.supplierService.Void | |
VoidEffective | 作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认] | Integer | listTripInfo.priceInfos.policy.supplierService.Void | |
VoidTicketingDeadline | 废票截止时间 格式 yyyy-MM-ddTHH:mm:ss | String | listTripInfo.priceInfos.policy.supplierService.Void | |
Content | 服务内容 | String | listTripInfo.priceInfos.policy.supplierService.Void | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | listTripInfo.priceInfos.policy.supplierService.Void | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | listTripInfo.priceInfos.policy.supplierService.Void.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | listTripInfo.priceInfos.policy.supplierService.Void.ServiceTime | |
limiting | 限制信息 | PricePolicyLimitingDto | listTripInfo.priceInfos.policy | |
conentHadTheme | String | listTripInfo.priceInfos.policy.limiting | ||
contents | 限制内容 | Array[] | listTripInfo.priceInfos.policy.limiting | |
isRequiredCertificatePhoto | 是否需要证件照片 | Boolean | listTripInfo.priceInfos.policy.limiting | |
age | 年龄限制 | LimitingAgeDto | listTripInfo.priceInfos.policy.limiting | |
minAge | 最小年龄 | Integer | listTripInfo.priceInfos.policy.limiting.age | |
maxAge | 最大年龄 | Integer | listTripInfo.priceInfos.policy.limiting.age | |
typeName | 类型名称 | String | listTripInfo.priceInfos.policy.limiting.age | |
content | 限制内容 | String | listTripInfo.priceInfos.policy.limiting.age | |
nationalityOrArea | 国家或区域限制 | LimitingNationalityOrAreaDto | listTripInfo.priceInfos.policy.limiting | |
limitingCondition | 国籍限制条件:允许 true/不允许 false | Boolean | listTripInfo.priceInfos.policy.limiting.nationalityOrArea | |
nationalityOrAreaNames | 国籍/地区名称 | Array[] | listTripInfo.priceInfos.policy.limiting.nationalityOrArea | |
nationalityOrAreaCodes | 国籍/地区二字码 | Array[] | listTripInfo.priceInfos.policy.limiting.nationalityOrArea | |
typeName | 类型名称 | String | listTripInfo.priceInfos.policy.limiting.nationalityOrArea | |
content | 限制内容 | String | listTripInfo.priceInfos.policy.limiting.nationalityOrArea | |
passagerCount | 旅客人数限制 | LimitingPassagerCountDto | listTripInfo.priceInfos.policy.limiting | |
minCount | 最小数量 | Integer | listTripInfo.priceInfos.policy.limiting.passagerCount | |
maxCount | 最大数量 | Integer | listTripInfo.priceInfos.policy.limiting.passagerCount | |
isMustBeEvenNumber | 是否必须偶数 | Boolean | listTripInfo.priceInfos.policy.limiting.passagerCount | |
typeName | 类型名称 | String | listTripInfo.priceInfos.policy.limiting.passagerCount | |
content | 限制内容 | String | listTripInfo.priceInfos.policy.limiting.passagerCount | |
certificate | 证件限制 | LimitingCertificateDto | listTripInfo.priceInfos.policy.limiting | |
limitingCondition | 证件类型名称限制条件:允许 true/不允许 false | Boolean | listTripInfo.priceInfos.policy.limiting.certificate | |
certificateTypeNames | 证件类型名称 | Array[] | listTripInfo.priceInfos.policy.limiting.certificate | |
certificateTypeCodes | 证件类型编码 | Array[] | listTripInfo.priceInfos.policy.limiting.certificate | |
certificateTypes | 证件类型 | Array[] | listTripInfo.priceInfos.policy.limiting.certificate | |
typeName | 类型名称 | String | listTripInfo.priceInfos.policy.limiting.certificate | |
content | 限制内容 | String | listTripInfo.priceInfos.policy.limiting.certificate | |
rule | 结构化退改规则 | ShoppingRule | listTripInfo.priceInfos | |
MinStay | 最短停留时间 | String | listTripInfo.priceInfos.rule | |
MaxStay | 最长停留时间 | String | listTripInfo.priceInfos.rule | |
Refund | 退票 | String | listTripInfo.priceInfos.rule | |
Change | 改签 | String | listTripInfo.priceInfos.rule | |
NoShow | 误机 | String | listTripInfo.priceInfos.rule | |
OtherInfo | 其他说明 | String | listTripInfo.priceInfos.rule | |
Structor | 结构化客规 | Structor | listTripInfo.priceInfos.rule | |
AdvanceReservation | 提前预定说明 | RuleStructAdvance | listTripInfo.priceInfos.rule.Structor | |
Unit | 提前预定时间单位 D=天,M=月,Y=年 | String | listTripInfo.priceInfos.rule.Structor.AdvanceReservation | |
Length | 提前预定时间 | String | listTripInfo.priceInfos.rule.Structor.AdvanceReservation | |
MinStay | 最短停留 | StructStay | listTripInfo.priceInfos.rule.Structor | |
Unit | 最短或最长停留单位 D=天,M=月,Y=年 | String | listTripInfo.priceInfos.rule.Structor.MinStay | |
Length | 最短或最长停留时间 | String | listTripInfo.priceInfos.rule.Structor.MinStay | |
Unlimited | 是否无限制,true表示无限制,此时不用看时长 | String | listTripInfo.priceInfos.rule.Structor.MinStay | |
Date | 最短停留日期 yyyy-MM-dd | String | listTripInfo.priceInfos.rule.Structor.MinStay | |
Text | 非必输 String 信息描述 | String | listTripInfo.priceInfos.rule.Structor.MinStay | |
MaxStay | 最长停留 | StructStay | listTripInfo.priceInfos.rule.Structor | |
Unit | 最短或最长停留单位 D=天,M=月,Y=年 | String | listTripInfo.priceInfos.rule.Structor.MaxStay | |
Length | 最短或最长停留时间 | String | listTripInfo.priceInfos.rule.Structor.MaxStay | |
Unlimited | 是否无限制,true表示无限制,此时不用看时长 | String | listTripInfo.priceInfos.rule.Structor.MaxStay | |
Date | 最短停留日期 yyyy-MM-dd | String | listTripInfo.priceInfos.rule.Structor.MaxStay | |
Text | 非必输 String 信息描述 | String | listTripInfo.priceInfos.rule.Structor.MaxStay | |
NoshowRefunds | 结构化客规误机退票 | Array[] | listTripInfo.priceInfos.rule.Structor | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | listTripInfo.priceInfos.rule.Structor.NoshowRefunds | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | listTripInfo.priceInfos.rule.Structor.NoshowRefunds | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | listTripInfo.priceInfos.rule.Structor.NoshowRefunds | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | listTripInfo.priceInfos.rule.Structor.NoshowRefunds | |
Currency | 币种 | String | listTripInfo.priceInfos.rule.Structor.NoshowRefunds | |
Text | 原文信息描述 | String | listTripInfo.priceInfos.rule.Structor.NoshowRefunds | |
NoshowChanges | 结构化客规误机改签 | Array[] | listTripInfo.priceInfos.rule.Structor | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | listTripInfo.priceInfos.rule.Structor.NoshowChanges | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | listTripInfo.priceInfos.rule.Structor.NoshowChanges | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | listTripInfo.priceInfos.rule.Structor.NoshowChanges | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | listTripInfo.priceInfos.rule.Structor.NoshowChanges | |
Currency | 币种 | String | listTripInfo.priceInfos.rule.Structor.NoshowChanges | |
Text | 原文信息描述 | String | listTripInfo.priceInfos.rule.Structor.NoshowChanges | |
Refunds | 结构化客规退票 | Array[] | listTripInfo.priceInfos.rule.Structor | |
TypeCode | 退票类型 可返值[before or after] | String | listTripInfo.priceInfos.rule.Structor.Refunds | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | listTripInfo.priceInfos.rule.Structor.Refunds | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | listTripInfo.priceInfos.rule.Structor.Refunds | |
Fee | 退票罚金 | Number | listTripInfo.priceInfos.rule.Structor.Refunds | |
Currency | 币种 | String | listTripInfo.priceInfos.rule.Structor.Refunds | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | listTripInfo.priceInfos.rule.Structor.Refunds | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | listTripInfo.priceInfos.rule.Structor.Refunds | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | listTripInfo.priceInfos.rule.Structor.Refunds | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | listTripInfo.priceInfos.rule.Structor.Refunds | |
Text | 原文信息描述 | String | listTripInfo.priceInfos.rule.Structor.Refunds | |
Changes | 结构化客规改签 | Array[] | listTripInfo.priceInfos.rule.Structor | |
TypeCode | 退票类型 可返值[before or after] | String | listTripInfo.priceInfos.rule.Structor.Changes | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | listTripInfo.priceInfos.rule.Structor.Changes | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | listTripInfo.priceInfos.rule.Structor.Changes | |
Fee | 退票罚金 | Number | listTripInfo.priceInfos.rule.Structor.Changes | |
Currency | 币种 | String | listTripInfo.priceInfos.rule.Structor.Changes | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | listTripInfo.priceInfos.rule.Structor.Changes | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | listTripInfo.priceInfos.rule.Structor.Changes | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | listTripInfo.priceInfos.rule.Structor.Changes | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | listTripInfo.priceInfos.rule.Structor.Changes | |
Text | 原文信息描述 | String | listTripInfo.priceInfos.rule.Structor.Changes | |
luggageList | PM2024166_国际标准API搜索、更多价格接口返回值增加行李额字段 | Array[] | listTripInfo.priceInfos | |
flightNo | 航班号 | String | listTripInfo.priceInfos.luggageList | |
departureCityName | 出发城市名称 | String | listTripInfo.priceInfos.luggageList | |
arrivalCityName | 到达城市名称 | String | listTripInfo.priceInfos.luggageList | |
departureCityCode | 出发城市三字码 | String | listTripInfo.priceInfos.luggageList | |
arrivalCityCode | 到达城市三字码 | String | listTripInfo.priceInfos.luggageList | |
checkInLuggagePieces | 免费托运行李件数 | String | listTripInfo.priceInfos.luggageList | |
checkInLuggageWeight | 免费托运行李重量 | String | listTripInfo.priceInfos.luggageList | |
checkInLuggageDemision | 免费托运行李体积 | String | listTripInfo.priceInfos.luggageList | |
checkInLuggageText | 行李额描述(免费托运行李) 新增字段,长宽高文本 | String | listTripInfo.priceInfos.luggageList | |
handLuggagePieces | 手提行李件数,允许件数(免费手提行李) | String | listTripInfo.priceInfos.luggageList | |
handLuggageWeight | 允许重量(免费手提行李) | String | listTripInfo.priceInfos.luggageList | |
handLuggageDemision | 体积(免费手提行李) | String | listTripInfo.priceInfos.luggageList | |
handLuggageText | 行李额描述(免费手提行李)长宽高文本 | String | listTripInfo.priceInfos.luggageList | |
seatBag | 随身物品内容 | LuaggageStructDto | listTripInfo.priceInfos.luggageList | |
Pieces | String | listTripInfo.priceInfos.luggageList.seatBag | ||
Weight | String | listTripInfo.priceInfos.luggageList.seatBag | ||
Demision | String | listTripInfo.priceInfos.luggageList.seatBag | ||
Description | String | listTripInfo.priceInfos.luggageList.seatBag | ||
CheckStruct | 托运行李结构化 | LuaggageStructDto | listTripInfo.priceInfos.luggageList | |
Pieces | String | listTripInfo.priceInfos.luggageList.CheckStruct | ||
Weight | String | listTripInfo.priceInfos.luggageList.CheckStruct | ||
Demision | String | listTripInfo.priceInfos.luggageList.CheckStruct | ||
Description | String | listTripInfo.priceInfos.luggageList.CheckStruct | ||
HandStruct | 手提行李结构化 | LuaggageStructDto | listTripInfo.priceInfos.luggageList | |
Pieces | String | listTripInfo.priceInfos.luggageList.HandStruct | ||
Weight | String | listTripInfo.priceInfos.luggageList.HandStruct | ||
Demision | String | listTripInfo.priceInfos.luggageList.HandStruct | ||
Description | String | listTripInfo.priceInfos.luggageList.HandStruct | ||
flightInfos | 航班信息 | Array[] | listTripInfo | |
FlightId | 新加唯一ID | String | listTripInfo.flightInfos | |
journeyIndex | 行程序号(从1开始的自然数。表示第几个航程) | String | listTripInfo.flightInfos | |
departureAirport | 出发机场 | String | listTripInfo.flightInfos | |
arrivalAirport | 目的机场 | String | listTripInfo.flightInfos | |
departureDate | 出发日期 | String | listTripInfo.flightInfos | |
departureTime | 出发时间 | String | listTripInfo.flightInfos | |
arrivalDate | 到达日期 | String | listTripInfo.flightInfos | |
arrivalTime | 到达时间 | String | listTripInfo.flightInfos | |
marketingAirline | 销售航司 | String | listTripInfo.flightInfos | |
marketingAirlineName_CN | 销售航司 中文名 | String | listTripInfo.flightInfos | |
airlineAllianceCode | 航司联盟(STARALLIANCE=星空联盟,ONEWORLD=寰宇一家,SKYTEAM=天合联盟) | String | listTripInfo.flightInfos | |
flightNumber | 航班号 | String | listTripInfo.flightInfos | |
operatingCarrier | 承运方航空公司,共享航班才有值 | String | listTripInfo.flightInfos | |
operatingFlightNumber | 承运航班号 ,共享航班才有值 | String | listTripInfo.flightInfos | |
equipment | 机型类别代码 | String | listTripInfo.flightInfos | |
equipmentName | 机型类别名称 | String | listTripInfo.flightInfos | |
equipmentEnName | 机型英文名称 | String | listTripInfo.flightInfos | |
equipmentBodyName | 机型型号 | String | listTripInfo.flightInfos | |
equipmentBodyType | 机型类型 1小型、2中型、3大型 | String | listTripInfo.flightInfos | |
equipmentMaxPassengers | 机型最大载客数 | String | listTripInfo.flightInfos | |
equipmentMinPassengers | 机型最小载客数 | String | listTripInfo.flightInfos | |
equipmentType | 航班载体类型(0=飞机,1=火车,2=汽车,3=船) | String | listTripInfo.flightInfos | |
planeType | 超宽体 宽体 窄体 未知 | String | listTripInfo.flightInfos | |
duration | 飞行时间,单位为分钟 | String | listTripInfo.flightInfos | |
Duration | 飞行时长 HH:mm | String | listTripInfo.flightInfos | |
distance | 飞行距离,单位为KM | String | listTripInfo.flightInfos | |
termDep | 起飞航站楼 | String | listTripInfo.flightInfos | |
termArr | 到达航站楼 | String | listTripInfo.flightInfos | |
depAirportName | 出发机场中文名称 | String | listTripInfo.flightInfos | |
depCity | 出发城市三字码 | String | listTripInfo.flightInfos | |
depCityName | 出发城市中文名称 | String | listTripInfo.flightInfos | |
arrAirportName | 到达机场中文名称 | String | listTripInfo.flightInfos | |
arrCity | 到达城市三字码 | String | listTripInfo.flightInfos | |
arrCityName | 到达城市中文名称 | String | listTripInfo.flightInfos | |
arrCountryName | 到达 国家中文名 | String | listTripInfo.flightInfos | |
intermediateAirports | 经停信息 | Array[] | listTripInfo.flightInfos | |
transferCity | 中转城市 | Array[] | listTripInfo.flightInfos | |
tripType | 行程类别,0第一程(去程) 、1第二程(回程) | String | listTripInfo.flightInfos | |
departuretimeModify | 本航段的起飞日期修正,例如1表示第二天 | String | listTripInfo.flightInfos | |
arrivaltimeModify | 得到本航段的到达日期修正,例如1表示第二天 | String | listTripInfo.flightInfos | |
clazz | 航位 | String | listTripInfo.flightInfos | |
cabin | 航等;1 经济舱 2 公务舱 3 头等舱 4 超级经济舱 | String | listTripInfo.flightInfos | |
seatNo | 座位数 | String | listTripInfo.flightInfos | |
durationStr | 增加天数 | String | listTripInfo.flightInfos | |
shortArrAirport | 到达城市 | String | listTripInfo.flightInfos | |
shortDptAirport | 离开城市 | String | listTripInfo.flightInfos | |
LuggageHangingType | 行李直挂类型 1不允许直挂 2允许直挂明细规则 3未知 | String | listTripInfo.flightInfos | |
VisaType | 过境签类型 1 需要过境签 2可能需过境签 3不需要过境签 4其它 | String | listTripInfo.flightInfos | |
VisaContent | 非必输 String 过境签内容说明 | String | listTripInfo.flightInfos | |
FlightDetailDto | 航班详细信息 | FlightDetailDto | listTripInfo.flightInfos | |
FlightProperty | 航班属性flightProperty字段枚举值说明:枚举值0-国内-国内 1-国内-国际 2-国内-地区 3-地区-国际 4-国际-国际 | String | listTripInfo.flightInfos.FlightDetailDto | |
AvgPlanDuration | 未来平均计划时间: HH:mm | String | listTripInfo.flightInfos.FlightDetailDto | |
DepAvgDelayTime | 平均出发延误时间(分钟): 15 | String | listTripInfo.flightInfos.FlightDetailDto | |
ArrAvgDelayTime | 平均到达延误时间(分钟): 10 | String | listTripInfo.flightInfos.FlightDetailDto | |
DepBridgeRate | 出港靠桥率: 80% | String | listTripInfo.flightInfos.FlightDetailDto | |
ArrBridgeRate | 进港靠桥率: 75% | String | listTripInfo.flightInfos.FlightDetailDto | |
DepOnTimeRate | 出发准点率: 90% | String | listTripInfo.flightInfos.FlightDetailDto | |
ArrOnTimeRate | 到达准点率: 85% | String | listTripInfo.flightInfos.FlightDetailDto | |
AircraftAge | 平均机龄: 5年 | String | listTripInfo.flightInfos.FlightDetailDto | |
ThemeFlight | 主题航班: 无 | String | listTripInfo.flightInfos.FlightDetailDto | |
Luggage | 行李限额描述: 免费托运20公斤 | String | listTripInfo.flightInfos.FlightDetailDto | |
Cabins | 舱位信息 | Array[] | listTripInfo.flightInfos.FlightDetailDto | |
ClassLevel | 舱等 经济舱 = 1,公务舱 = 2,头等舱 = 3,豪华经济舱 = 4 | String | listTripInfo.flightInfos.FlightDetailDto.Cabins | |
PerCapita | 人均碳排放量,单位:千克: 100kg | String | listTripInfo.flightInfos.FlightDetailDto.Cabins | |
InTotal | 总碳排放量,单位:千克: 200kg | String | listTripInfo.flightInfos.FlightDetailDto.Cabins | |
PerCapitaTree | 人均消耗树量,单位:棵: 1棵树 | String | listTripInfo.flightInfos.FlightDetailDto.Cabins | |
SeatWidth | 座位宽度: 17.5英寸 | String | listTripInfo.flightInfos.FlightDetailDto.Cabins | |
SeatTilt | 座椅倾斜度: 可调节 | String | listTripInfo.flightInfos.FlightDetailDto.Cabins | |
Beverage | FlightDetailCabinAmenitiesDto | listTripInfo.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | listTripInfo.flightInfos.FlightDetailDto.Cabins.Beverage | |
IsExist | 是否存在 | Boolean | listTripInfo.flightInfos.FlightDetailDto.Cabins.Beverage | |
Entertainment | FlightDetailCabinAmenitiesDto | listTripInfo.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | listTripInfo.flightInfos.FlightDetailDto.Cabins.Entertainment | |
IsExist | 是否存在 | Boolean | listTripInfo.flightInfos.FlightDetailDto.Cabins.Entertainment | |
Food | FlightDetailCabinAmenitiesDto | listTripInfo.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | listTripInfo.flightInfos.FlightDetailDto.Cabins.Food | |
IsExist | 是否存在 | Boolean | listTripInfo.flightInfos.FlightDetailDto.Cabins.Food | |
Power | FlightDetailCabinAmenitiesDto | listTripInfo.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | listTripInfo.flightInfos.FlightDetailDto.Cabins.Power | |
IsExist | 是否存在 | Boolean | listTripInfo.flightInfos.FlightDetailDto.Cabins.Power | |
Wifi | FlightDetailCabinAmenitiesDto | listTripInfo.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | listTripInfo.flightInfos.FlightDetailDto.Cabins.Wifi | |
IsExist | 是否存在 | Boolean | listTripInfo.flightInfos.FlightDetailDto.Cabins.Wifi | |
Layout | FlightDetailCabinLayoutDto | listTripInfo.flightInfos.FlightDetailDto.Cabins | ||
RowLayout | 3-3 | String | listTripInfo.flightInfos.FlightDetailDto.Cabins.Layout | |
DescZh | 中文描述 | String | listTripInfo.flightInfos.FlightDetailDto.Cabins.Layout | |
IsExist | 是否存在 | Boolean | listTripInfo.flightInfos.FlightDetailDto.Cabins.Layout | |
Seat | FlightDetailCabinSeatDto | listTripInfo.flightInfos.FlightDetailDto.Cabins | ||
Pitch | "34" | String | listTripInfo.flightInfos.FlightDetailDto.Cabins.Seat | |
DescZh | 中文描述 | String | listTripInfo.flightInfos.FlightDetailDto.Cabins.Seat | |
IsExist | 是否存在 | Boolean | listTripInfo.flightInfos.FlightDetailDto.Cabins.Seat |
{
"listTripInfo":
[{
"tripId": "", //新版返回tripId代替flightId
"solutionId": "", //当前查询航班返回结果的唯一号
"flightInfos":
[{
"FlightId":"0301PEKHKGCZ3040", //新加唯一ID
"journeyIndex":"1", //行程序号(从1开始的自然数。表示第几个航程)
"departureAirport":"PEK", //出发机场
"arrivalAirport":"HKG", //目的机场
"departureDate":"2023-12-06", //出发日期
"departureTime":"18:35", //出发时间
"arrivalDate":"2023-12-06", //到达日期
"arrivalTime":"22:25", //到达时间
"marketingAirline":"CX", //销售航司
"marketingAirlineName_CN":"国泰航空", //销售航司 中文名
"airlineAllianceCode":"STARALLIANCE", //航司联盟(STARALLIANCE=星空联盟,ONEWORLD=寰宇一家,SKYTEAM=天合联盟)
"flightNumber":"393", //航班号
"operatingCarrier": "", //承运方航空公司,共享航班才有值
"operatingFlightNumber": "", //承运航班号 ,共享航班才有值
"equipment":"333", //机型类别代码
"equipmentName":"空客330", //机型类别名称
"equipmentEnName":"Airbus A330", //机型英文名称
"equipmentBodyName":"空客330", //机型型号
"equipmentBodyType":"3", //机型类型 1小型、2中型、3大型
"equipmentMaxPassengers":"100", //机型最大载客数
"equipmentMinPassengers":"30", //机型最小载客数
"equipmentType":"0", //航班载体类型(0=飞机,1=火车,2=汽车,3=船)
"planeType":"宽体", //超宽体 宽体 窄体 未知
"duration":"230", //飞行时间,单位为分钟
"Duration":"03:50", //飞行时长 HH:mm
"distance":"1234", //飞行距离,单位为KM
"termDep":"3", //起飞航站楼
"termArr":"1", //到达航站楼
"depAirportName":"首都国际机场", //出发机场中文名称
"depCity":"香港国际机场", //出发城市三字码
"depCityName":"北京", //出发城市中文名称
"arrAirportName":"中国香港", //到达机场中文名称
"arrCity":"BJS", //到达城市三字码
"arrCityName":"HKG", //到达城市中文名称
"arrCountryName":"中国香港", //到达 国家中文名
"intermediateAirports":"null", //经停信息
"transferCity":"null", //中转城市
"tripType":"0", //行程类别,0第一程(去程) 、1第二程(回程)
"departuretimeModify": "", //本航段的起飞日期修正,例如1表示第二天
"arrivaltimeModify": "", //得到本航段的到达日期修正,例如1表示第二天
"clazz":"V", //航位
"cabin":"1", //航等;1 经济舱 2 公务舱 3 头等舱 4 超级经济舱
"seatNo":"9", //座位数
"durationStr": "", //增加天数
"shortArrAirport":"HKG", //到达城市
"shortDptAirport":"BJS", //离开城市
"LuggageHangingType":"1", //行李直挂类型 1不允许直挂 2允许直挂明细规则 3未知
"VisaType":"3", //过境签类型 1 需要过境签 2可能需过境签 3不需要过境签 4其它
"VisaContent":"过境需要签证", //非必输 String 过境签内容说明
"FlightDetailDto":
{
"FlightProperty": "", //航班属性flightProperty字段枚举值说明:枚举值0-国内-国内 1-国内-国际 2-国内-地区 3-地区-国际 4-国际-国际
"AvgPlanDuration": "", //未来平均计划时间: HH:mm
"DepAvgDelayTime": "", //平均出发延误时间(分钟): 15
"ArrAvgDelayTime": "", //平均到达延误时间(分钟): 10
"DepBridgeRate": "", //出港靠桥率: 80%
"ArrBridgeRate": "", //进港靠桥率: 75%
"DepOnTimeRate": "", //出发准点率: 90%
"ArrOnTimeRate": "", //到达准点率: 85%
"AircraftAge": "", //平均机龄: 5年
"Cabins":
[{
"ClassLevel": "", //舱等 经济舱 = 1,公务舱 = 2,头等舱 = 3,豪华经济舱 = 4
"PerCapita": "", //人均碳排放量,单位:千克: 100kg
"InTotal": "", //总碳排放量,单位:千克: 200kg
"PerCapitaTree": "", //人均消耗树量,单位:棵: 1棵树
"SeatWidth": "", //座位宽度: 17.5英寸
"SeatTilt": "", //座椅倾斜度: 可调节
"Beverage":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Entertainment":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Food":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Layout":
{
"RowLayout": "", //3-3
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Power":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Seat":
{
"Pitch": "", //"34"
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Wifi":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
}], //舱位信息
"ThemeFlight": "", //主题航班: 无
"Luggage": "", //行李限额描述: 免费托运20公斤
}, //航班详细信息
}], //航班信息
"priceInfos":
[{
"passengertypecount":"1", //乘客数量
"accountCode":"XJW842", //大客户编码
"basefare":1800, //销售 -- 票面价
"basefarecurrency":"CNY", //销售票面价 -- 币种
"tax":2560, //销售 - 税
"taxcurrency":"CNY", //销售税 - 币种
"servicePriceTotal":100, //服务费合计 = 服务费基础 + 服务费附加
"protocolShowType":0, //TMC促销策略显示标识((0代表不显示、1代表显示美亚特惠,2,代表显示协议 ))
"farePriceType":"2", //票价类型:公有运价 = 0,私有运价 = 1,协议价= 2
"protocolStrategryCode":"WJX28551", //三方协议产品编号
"source":"1", //来源 (1协议;2美亚特惠、3自营、4第三方、5合作商、6官网、7NDC)
"fareType":"10", //票证类型(10 美亚BSP,20 境外票,30 B2B, 40非美亚BSP,50航司直连)
"isHaveTravelItinerary":false, //是否有行程单
"activeTime":"2025-02-18 23:59:00", //票价出票时限
"haveTravelItinerary":"3", //报销凭证:1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,7=按政策设置,8=无
"productName": "", //品牌运价产品名称
"Clazzs":
[{
"flightId":"9", //航班序号,对应航段信息里的flightId
"clazzNo":"9", //舱位编码; 示例:P
"classLevel":"1", //舱等;1-经济舱;2-商务舱;3-头等舱;4-豪华经济舱
"seatNo":"9", //座位数
}], //舱位信息
"luggageList":
[{
"flightNo": "", //航班号
"departureCityName":"北京", //出发城市名称
"arrivalCityName":"青岛", //到达城市名称
"departureCityCode":"BJS", //出发城市三字码
"arrivalCityCode":"TAO", //到达城市三字码
"checkInLuggagePieces":"2", //免费托运行李件数
"checkInLuggageWeight": "", //免费托运行李重量
"checkInLuggageDemision": "", //免费托运行李体积
"checkInLuggageText": "", //行李额描述(免费托运行李) 新增字段,长宽高文本
"handLuggagePieces":"1", //手提行李件数,允许件数(免费手提行李)
"handLuggageWeight": "", //允许重量(免费手提行李)
"handLuggageDemision": "", //体积(免费手提行李)
"handLuggageText": "", //行李额描述(免费手提行李)长宽高文本
"seatBag":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //随身物品内容
"CheckStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //托运行李结构化
"HandStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //手提行李结构化
}], //PM2024166_国际标准API搜索、更多价格接口返回值增加行李额字段
"rule":
{
"MinStay": "", //最短停留时间
"MaxStay": "", //最长停留时间
"Refund": "", //退票
"Change": "", //改签
"NoShow": "", //误机
"OtherInfo": "", //其他说明
"Structor":
{
"Refunds":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //结构化客规退票
"Changes":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //结构化客规改签
"NoshowRefunds":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //结构化客规误机退票
"NoshowChanges":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //结构化客规误机改签
"MinStay":
{
"Unit": "", //最短或最长停留单位 D=天,M=月,Y=年
"Length": "", //最短或最长停留时间
"Unlimited": "", //是否无限制,true表示无限制,此时不用看时长
"Date": "", //最短停留日期 yyyy-MM-dd
"Text": "", //非必输 String 信息描述
}, //最短停留
"MaxStay":
{
"Unit": "", //最短或最长停留单位 D=天,M=月,Y=年
"Length": "", //最短或最长停留时间
"Unlimited": "", //是否无限制,true表示无限制,此时不用看时长
"Date": "", //最短停留日期 yyyy-MM-dd
"Text": "", //非必输 String 信息描述
}, //最长停留
"AdvanceReservation":
{
"Unit":"KG", //提前预定时间单位 D=天,M=月,Y=年
"Length":"KG", //提前预定时间
}, //提前预定说明
}, //结构化客规
}, //结构化退改规则
"policy":
{
"farePriceType": "", //票价类型,公有 = 0,私有 = 1,协议= 2
"isHaveTravelItinerary":false, //是否有行程单
"travelItinerary": "", //报销凭证,1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,8=无
"group":
{
"groupTag": "", //按逻辑运算符合数字拼装
"content": "", //内容,比如,此价格仅限2-9人
"structor": "", //团价结构化信息 json化
}, //团价信息
"supplierService":
{
"Issue":
{
"ServicerType":0, //服务商类型(0=美亚自营,1=供应商提供服务)
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //出票
"Change":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //改签
"Refund":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //退票
"Void":
{
"IsCanVoid":false, //是否可以废票
"VoidEffective":0, //作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认]
"VoidTicketingDeadline": "", //废票截止时间 格式 yyyy-MM-ddTHH:mm:ss
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //作废
}, //供应商服务内容
"limiting":
{
"conentHadTheme": "", //
"contents":[], //限制内容
"isRequiredCertificatePhoto":false, //是否需要证件照片
"nationalityOrArea":
{
"limitingCondition":false, //国籍限制条件:允许 true/不允许 false
"nationalityOrAreaNames":[], //国籍/地区名称
"nationalityOrAreaCodes":[], //国籍/地区二字码
"typeName": "", //类型名称
"content": "", //限制内容
}, //国家或区域限制
"certificate":
{
"limitingCondition":false, //证件类型名称限制条件:允许 true/不允许 false
"certificateTypeNames":[], //证件类型名称
"certificateTypeCodes":[], //证件类型编码
"certificateTypes":[], //证件类型
"typeName": "", //类型名称
"content": "", //限制内容
}, //证件限制
"age":
{
"minAge":0, //最小年龄
"maxAge":0, //最大年龄
"typeName": "", //类型名称
"content": "", //限制内容
}, //年龄限制
"passagerCount":
{
"minCount":0, //最小数量
"maxCount":0, //最大数量
"isMustBeEvenNumber":false, //是否必须偶数
"typeName": "", //类型名称
"content": "", //限制内容
}, //旅客人数限制
}, //限制信息
}, //政策信息
}], //价格信息
"policyResultList":
[{
"passengerCode": "", //旅客编号
}], //政策实体类(PolicyResultList (string(旅客), PolicyResult>);
如果是先航班后旅客,则取公司的基础差旅政策;旅客KEY值为:XXXXXX
"isEnable":false, //判断航班是否4小时以内0 4小时外 1 4小时内
"IsDirectFlight":false, //是否直飞
}], //行程组合信息集合
"resultID":"965eae861c534eb2b689f739e45e010e", //ST的唯一号
"isTakeMoreTrip":false, //是否可以获取更多行程(用于异步查询更多行程)
"guid":"965eae861c534eb2b689f739e45e010e", //当前请求guid
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
获取航班详细信息
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
resultId | 当前查询航班返回结果的唯一号 | String | 否 | |
tripId | 新版返回tripId代替flightId | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"resultId": "", //当前查询航班返回结果的唯一号
"tripId": "", //新版返回tripId代替flightId
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
Flights | 航班信息 | Array[] | ||
FlightId | 编号 | String | Flights | |
IsCodeShare | 是否共享航班 | Boolean | Flights | |
EquipmentCode | 机型代码 | String | Flights | |
EquipmentName | 机型中文名称 | String | Flights | |
EquipmentEnName | 机型英文名称 | String | Flights | |
EquipmentBodyType | 机型类型 1小型、2中型、3大型 | String | Flights | |
EquipmentBodyName | 机体(窄体宽体) | String | Flights | |
EquipmentMaxPassengers | 机型最大载客数 | String | Flights | |
EquipmentMinPassengers | 机型最小载客数 | String | Flights | |
EquipmentType | 航班载体类型(0=飞机,1=火车,2=汽车,3=船) | String | Flights | |
Duration | 飞行时间 HH:mm | String | Flights | |
Distance | 飞行距离,单位为KM | String | Flights | |
Marketing | 市场航司 | FlightAirlineDto | Flights | |
AirlineCode | 航司代码 | String | Flights.Marketing | |
AirlineName | 航司名称 | String | Flights.Marketing | |
AirlineEnName | 航司名称(英文) | String | Flights.Marketing | |
FlightNumber | 航班号 | String | Flights.Marketing | |
AirlineAllianceCode | 航司联盟(STARALLIANCE=星空联盟,ONEWORLD=寰宇一家,SKYTEAM=天合联盟) | String | Flights.Marketing | |
Operating | 执飞航司 | FlightAirlineDto | Flights | |
AirlineCode | 航司代码 | String | Flights.Operating | |
AirlineName | 航司名称 | String | Flights.Operating | |
AirlineEnName | 航司名称(英文) | String | Flights.Operating | |
FlightNumber | 航班号 | String | Flights.Operating | |
AirlineAllianceCode | 航司联盟(STARALLIANCE=星空联盟,ONEWORLD=寰宇一家,SKYTEAM=天合联盟) | String | Flights.Operating | |
Stops | 经停信息 | Array[] | Flights | |
AirportCode | 经停机场 | String | Flights.Stops | |
AirportName | 经停机场名称 | String | Flights.Stops | |
CityCode | 经停城市 | String | Flights.Stops | |
CityName | 经停城市名称 | String | Flights.Stops | |
Duration | 经停时长 HH:mm | String | Flights.Stops | |
Departure | 出发地 | FlightLocationTimeDto | Flights | |
AirportCode | 机场三字码 | String | Flights.Departure | |
AirportName | 机场名称 | String | Flights.Departure | |
AirportEnName | 机场名称 | String | Flights.Departure | |
CityCode | 城市三字码 | String | Flights.Departure | |
CityName | 城市名称 | String | Flights.Departure | |
CityEnName | 城市名称 | String | Flights.Departure | |
Time | 日期和时间 | String | Flights.Departure | |
Term | 航站楼 | String | Flights.Departure | |
CountryCode | 国家代码 | String | Flights.Departure | |
CountryName | 国家名称 | String | Flights.Departure | |
CountryEnName | 国家英文名称 | String | Flights.Departure | |
Arrival | 目的地 | FlightLocationTimeDto | Flights | |
AirportCode | 机场三字码 | String | Flights.Arrival | |
AirportName | 机场名称 | String | Flights.Arrival | |
AirportEnName | 机场名称 | String | Flights.Arrival | |
CityCode | 城市三字码 | String | Flights.Arrival | |
CityName | 城市名称 | String | Flights.Arrival | |
CityEnName | 城市名称 | String | Flights.Arrival | |
Time | 日期和时间 | String | Flights.Arrival | |
Term | 航站楼 | String | Flights.Arrival | |
CountryCode | 国家代码 | String | Flights.Arrival | |
CountryName | 国家名称 | String | Flights.Arrival | |
CountryEnName | 国家英文名称 | String | Flights.Arrival | |
Detail | 航班详细信息 | FlightDetailDto | Flights | |
FlightProperty | 航班属性flightProperty字段枚举值说明:枚举值0-国内-国内 1-国内-国际 2-国内-地区 3-地区-国际 4-国际-国际 | String | Flights.Detail | |
AvgPlanDuration | 未来平均计划时间: HH:mm | String | Flights.Detail | |
DepAvgDelayTime | 平均出发延误时间(分钟): 15 | String | Flights.Detail | |
ArrAvgDelayTime | 平均到达延误时间(分钟): 10 | String | Flights.Detail | |
DepBridgeRate | 出港靠桥率: 80% | String | Flights.Detail | |
ArrBridgeRate | 进港靠桥率: 75% | String | Flights.Detail | |
DepOnTimeRate | 出发准点率: 90% | String | Flights.Detail | |
ArrOnTimeRate | 到达准点率: 85% | String | Flights.Detail | |
AircraftAge | 平均机龄: 5年 | String | Flights.Detail | |
ThemeFlight | 主题航班: 无 | String | Flights.Detail | |
Luggage | 行李限额描述: 免费托运20公斤 | String | Flights.Detail | |
Cabins | 舱位信息 | Array[] | Flights.Detail | |
ClassLevel | 舱等 经济舱 = 1,公务舱 = 2,头等舱 = 3,豪华经济舱 = 4 | String | Flights.Detail.Cabins | |
PerCapita | 人均碳排放量,单位:千克: 100kg | String | Flights.Detail.Cabins | |
InTotal | 总碳排放量,单位:千克: 200kg | String | Flights.Detail.Cabins | |
PerCapitaTree | 人均消耗树量,单位:棵: 1棵树 | String | Flights.Detail.Cabins | |
SeatWidth | 座位宽度: 17.5英寸 | String | Flights.Detail.Cabins | |
SeatTilt | 座椅倾斜度: 可调节 | String | Flights.Detail.Cabins | |
Beverage | FlightDetailCabinAmenitiesDto | Flights.Detail.Cabins | ||
DescZh | 中文描述 | String | Flights.Detail.Cabins.Beverage | |
IsExist | 是否存在 | Boolean | Flights.Detail.Cabins.Beverage | |
Entertainment | FlightDetailCabinAmenitiesDto | Flights.Detail.Cabins | ||
DescZh | 中文描述 | String | Flights.Detail.Cabins.Entertainment | |
IsExist | 是否存在 | Boolean | Flights.Detail.Cabins.Entertainment | |
Food | FlightDetailCabinAmenitiesDto | Flights.Detail.Cabins | ||
DescZh | 中文描述 | String | Flights.Detail.Cabins.Food | |
IsExist | 是否存在 | Boolean | Flights.Detail.Cabins.Food | |
Power | FlightDetailCabinAmenitiesDto | Flights.Detail.Cabins | ||
DescZh | 中文描述 | String | Flights.Detail.Cabins.Power | |
IsExist | 是否存在 | Boolean | Flights.Detail.Cabins.Power | |
Wifi | FlightDetailCabinAmenitiesDto | Flights.Detail.Cabins | ||
DescZh | 中文描述 | String | Flights.Detail.Cabins.Wifi | |
IsExist | 是否存在 | Boolean | Flights.Detail.Cabins.Wifi | |
Layout | FlightDetailCabinLayoutDto | Flights.Detail.Cabins | ||
RowLayout | 3-3 | String | Flights.Detail.Cabins.Layout | |
DescZh | 中文描述 | String | Flights.Detail.Cabins.Layout | |
IsExist | 是否存在 | Boolean | Flights.Detail.Cabins.Layout | |
Seat | FlightDetailCabinSeatDto | Flights.Detail.Cabins | ||
Pitch | "34" | String | Flights.Detail.Cabins.Seat | |
DescZh | 中文描述 | String | Flights.Detail.Cabins.Seat | |
IsExist | 是否存在 | Boolean | Flights.Detail.Cabins.Seat |
{
"Flights":
[{
"FlightId": "", //编号
"Departure":
{
"AirportCode": "", //机场三字码
"AirportName": "", //机场名称
"AirportEnName": "", //机场名称
"CityCode": "", //城市三字码
"CityName": "", //城市名称
"CityEnName": "", //城市名称
"Time": "", //日期和时间
"Term": "", //航站楼
"CountryCode": "", //国家代码
"CountryName": "", //国家名称
"CountryEnName": "", //国家英文名称
}, //出发地
"Arrival":
{
"AirportCode": "", //机场三字码
"AirportName": "", //机场名称
"AirportEnName": "", //机场名称
"CityCode": "", //城市三字码
"CityName": "", //城市名称
"CityEnName": "", //城市名称
"Time": "", //日期和时间
"Term": "", //航站楼
"CountryCode": "", //国家代码
"CountryName": "", //国家名称
"CountryEnName": "", //国家英文名称
}, //目的地
"Marketing":
{
"AirlineCode": "", //航司代码
"AirlineName": "", //航司名称
"AirlineEnName": "", //航司名称(英文)
"FlightNumber": "", //航班号
"AirlineAllianceCode": "", //航司联盟(STARALLIANCE=星空联盟,ONEWORLD=寰宇一家,SKYTEAM=天合联盟)
}, //市场航司
"Operating":
{
"AirlineCode": "", //航司代码
"AirlineName": "", //航司名称
"AirlineEnName": "", //航司名称(英文)
"FlightNumber": "", //航班号
"AirlineAllianceCode": "", //航司联盟(STARALLIANCE=星空联盟,ONEWORLD=寰宇一家,SKYTEAM=天合联盟)
}, //执飞航司
"IsCodeShare":false, //是否共享航班
"EquipmentCode": "", //机型代码
"EquipmentName": "", //机型中文名称
"EquipmentEnName": "", //机型英文名称
"EquipmentBodyType": "", //机型类型 1小型、2中型、3大型
"EquipmentBodyName": "", //机体(窄体宽体)
"EquipmentMaxPassengers": "", //机型最大载客数
"EquipmentMinPassengers": "", //机型最小载客数
"EquipmentType": "", //航班载体类型(0=飞机,1=火车,2=汽车,3=船)
"Duration": "", //飞行时间 HH:mm
"Distance": "", //飞行距离,单位为KM
"Stops":
[{
"AirportCode": "", //经停机场
"AirportName": "", //经停机场名称
"CityCode": "", //经停城市
"CityName": "", //经停城市名称
"Duration": "", //经停时长 HH:mm
}], //经停信息
"Detail":
{
"FlightProperty": "", //航班属性flightProperty字段枚举值说明:枚举值0-国内-国内 1-国内-国际 2-国内-地区 3-地区-国际 4-国际-国际
"AvgPlanDuration": "", //未来平均计划时间: HH:mm
"DepAvgDelayTime": "", //平均出发延误时间(分钟): 15
"ArrAvgDelayTime": "", //平均到达延误时间(分钟): 10
"DepBridgeRate": "", //出港靠桥率: 80%
"ArrBridgeRate": "", //进港靠桥率: 75%
"DepOnTimeRate": "", //出发准点率: 90%
"ArrOnTimeRate": "", //到达准点率: 85%
"AircraftAge": "", //平均机龄: 5年
"Cabins":
[{
"ClassLevel": "", //舱等 经济舱 = 1,公务舱 = 2,头等舱 = 3,豪华经济舱 = 4
"PerCapita": "", //人均碳排放量,单位:千克: 100kg
"InTotal": "", //总碳排放量,单位:千克: 200kg
"PerCapitaTree": "", //人均消耗树量,单位:棵: 1棵树
"SeatWidth": "", //座位宽度: 17.5英寸
"SeatTilt": "", //座椅倾斜度: 可调节
"Beverage":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Entertainment":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Food":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Layout":
{
"RowLayout": "", //3-3
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Power":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Seat":
{
"Pitch": "", //"34"
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Wifi":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
}], //舱位信息
"ThemeFlight": "", //主题航班: 无
"Luggage": "", //行李限额描述: 免费托运20公斤
}, //航班详细信息
}], //航班信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
预订前核对价格
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
resultId | 当前查询航班返回结果的唯一号 | String | 是 | |
tripId | PM2023084添加 | String | 是 | |
solutionId | PM2023084添加 方案Id | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"resultId":"fb2f091a18324cf2ac4910115ca006d8", //当前查询航班返回结果的唯一号
"tripId":"0dd2390dbc444224566da481f78bed43", //PM2023084添加
"solutionId":"965eae861c534eb2b689f739e45e010e", //PM2023084添加 方案Id
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
flightInfoList | 行程信息 | IFlightInfoList | ||
platingCarrier | 销售航司 | String | flightInfoList | |
flightId | 航程Id,新版已不使用该参数,忽略 | Integer | flightInfoList | |
tripId | PM2023084添加 新版返回tripId代替flightId | String | flightInfoList | |
IsChangePrice | PM2023084添加 是否变价 | Boolean | flightInfoList | |
IsChangeCabin | PM2023084添加 是否变舱 | Boolean | flightInfoList | |
IsChangeFlight | PM2023084添加 航班信息是否变更 | Boolean | flightInfoList | |
origin | PM2023084添加 运价起点城市三字码 | String | flightInfoList | |
ctcm | PM2023084添加 CTCM,旅客联系号码 | CTCM | flightInfoList | |
isRequiredMobileAll | 旅客必须全部有手机号码 | Boolean | flightInfoList.ctcm | |
isNotRepeatMobile | 手机号码是否不能重复 | Boolean | flightInfoList.ctcm | |
isRequiredMobileOne | 必须选择手机号码有一个 | Boolean | flightInfoList.ctcm | |
priceInfos | 价格信息 | Array[] | flightInfoList | |
solutionId | PM2023084添加 方案Id | String | flightInfoList.priceInfos | |
passengerType | 乘客类型,PASSENGER_ADULT,PASSENGER_CHILD,PASSENGER_BABY, | String | flightInfoList.priceInfos | |
passengerTypeCount | 乘客数量 | String | flightInfoList.priceInfos | |
activeTime | PM2023084添加 票价出票时限 | String | flightInfoList.priceInfos | |
proofType | PM2023084添加 报销凭证:1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,7=按政策设置,8=无 | Integer | flightInfoList.priceInfos | |
baseFare | 销售 -- 票面价 | Number | flightInfoList.priceInfos | |
tax | 销售 - 税 | Number | flightInfoList.priceInfos | |
servicePriceTotal | 服务费合计 | Number | flightInfoList.priceInfos | |
protocolStrategryCode | 三方协议产品编号 | String | flightInfoList.priceInfos | |
protocolShowType | 协议类型显示标识((0代表不显示、1代表显示协议、2代表显示美亚特惠)) | Integer | flightInfoList.priceInfos | |
source | 来源 (IBEPLUS航司接口;syber) | String | flightInfoList.priceInfos | |
fareType | 票证类型(10 美亚BSP,20 境外票,30 B2B, 40非美亚BSP,50航司直连) | String | flightInfoList.priceInfos | |
isRequireCertificate | 证件号是否为必填 | Boolean | flightInfoList.priceInfos | |
currency | 结算币种 | String | flightInfoList.priceInfos | |
FrequentTravellers | 常旅客计划 | Array[] | flightInfoList.priceInfos | |
airlineCode | 航司二字代码 | String | flightInfoList.priceInfos.FrequentTravellers | |
name | 常旅客计划中文名 | String | flightInfoList.priceInfos.FrequentTravellers | |
enName | 常旅客计划英文名 | String | flightInfoList.priceInfos.FrequentTravellers | |
SupportCertificates | 支持的证件类型 | Array[] | flightInfoList.priceInfos | |
certificateType | 证件类型 | String | flightInfoList.priceInfos.SupportCertificates | |
certificateTypeName | 证件类型中文名 | String | flightInfoList.priceInfos.SupportCertificates | |
CountryOrAreas | 国家或国家地区代码,空为不限 | Array[] | flightInfoList.priceInfos.SupportCertificates | |
code | 国家或国家地区代码 | String | flightInfoList.priceInfos.SupportCertificates.CountryOrAreas | |
name | 国家或国家地区中文名称 | String | flightInfoList.priceInfos.SupportCertificates.CountryOrAreas | |
Clazzs | 舱位信息 | Array[] | flightInfoList.priceInfos | |
flightId | 航班序号,对应航段信息里的flightId | String | flightInfoList.priceInfos.Clazzs | |
clazzNo | 舱位编码; 示例:P | String | flightInfoList.priceInfos.Clazzs | |
classLevel | 舱等;1-经济舱;2-商务舱;3-头等舱;4-豪华经济舱 | String | flightInfoList.priceInfos.Clazzs | |
seatNo | 座位数 | String | flightInfoList.priceInfos.Clazzs | |
policy | 差旅政策 | PolicyType | flightInfoList.priceInfos | |
farePriceType | 票价类型,公有 = 0,私有 = 1,协议= 2 | String | flightInfoList.priceInfos.policy | |
isHaveTravelItinerary | 是否有行程单 | Boolean | flightInfoList.priceInfos.policy | |
travelItinerary | 报销凭证,1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,8=无 | String | flightInfoList.priceInfos.policy | |
group | 团价信息 | GroupInfo | flightInfoList.priceInfos.policy | |
groupTag | 按逻辑运算符合数字拼装 | String | flightInfoList.priceInfos.policy.group | |
content | 内容,比如,此价格仅限2-9人 | String | flightInfoList.priceInfos.policy.group | |
structor | 团价结构化信息 json化 | String | flightInfoList.priceInfos.policy.group | |
supplierService | 供应商服务内容 | PolicySupplierServiceDto | flightInfoList.priceInfos.policy | |
Change | 改签 | SupplierServiceChangeDto | flightInfoList.priceInfos.policy.supplierService | |
Content | 服务内容 | String | flightInfoList.priceInfos.policy.supplierService.Change | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | flightInfoList.priceInfos.policy.supplierService.Change | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | flightInfoList.priceInfos.policy.supplierService.Change.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | flightInfoList.priceInfos.policy.supplierService.Change.ServiceTime | |
Refund | 退票 | SupplierServiceRefundDto | flightInfoList.priceInfos.policy.supplierService | |
Content | 服务内容 | String | flightInfoList.priceInfos.policy.supplierService.Refund | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | flightInfoList.priceInfos.policy.supplierService.Refund | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | flightInfoList.priceInfos.policy.supplierService.Refund.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | flightInfoList.priceInfos.policy.supplierService.Refund.ServiceTime | |
Issue | 出票 | SupplierServiceIssueDto | flightInfoList.priceInfos.policy.supplierService | |
ServicerType | 服务商类型(0=美亚自营,1=供应商提供服务) | Integer | flightInfoList.priceInfos.policy.supplierService.Issue | |
Content | 服务内容 | String | flightInfoList.priceInfos.policy.supplierService.Issue | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | flightInfoList.priceInfos.policy.supplierService.Issue | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | flightInfoList.priceInfos.policy.supplierService.Issue.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | flightInfoList.priceInfos.policy.supplierService.Issue.ServiceTime | |
Void | 作废 | SupplierServiceVoidDto | flightInfoList.priceInfos.policy.supplierService | |
IsCanVoid | 是否可以废票 | Boolean | flightInfoList.priceInfos.policy.supplierService.Void | |
VoidEffective | 作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认] | Integer | flightInfoList.priceInfos.policy.supplierService.Void | |
VoidTicketingDeadline | 废票截止时间 格式 yyyy-MM-ddTHH:mm:ss | String | flightInfoList.priceInfos.policy.supplierService.Void | |
Content | 服务内容 | String | flightInfoList.priceInfos.policy.supplierService.Void | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | flightInfoList.priceInfos.policy.supplierService.Void | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | flightInfoList.priceInfos.policy.supplierService.Void.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | flightInfoList.priceInfos.policy.supplierService.Void.ServiceTime | |
limiting | 限制信息 | PricePolicyLimitingDto | flightInfoList.priceInfos.policy | |
conentHadTheme | String | flightInfoList.priceInfos.policy.limiting | ||
contents | 限制内容 | Array[] | flightInfoList.priceInfos.policy.limiting | |
isRequiredCertificatePhoto | 是否需要证件照片 | Boolean | flightInfoList.priceInfos.policy.limiting | |
age | 年龄限制 | LimitingAgeDto | flightInfoList.priceInfos.policy.limiting | |
minAge | 最小年龄 | Integer | flightInfoList.priceInfos.policy.limiting.age | |
maxAge | 最大年龄 | Integer | flightInfoList.priceInfos.policy.limiting.age | |
typeName | 类型名称 | String | flightInfoList.priceInfos.policy.limiting.age | |
content | 限制内容 | String | flightInfoList.priceInfos.policy.limiting.age | |
nationalityOrArea | 国家或区域限制 | LimitingNationalityOrAreaDto | flightInfoList.priceInfos.policy.limiting | |
limitingCondition | 国籍限制条件:允许 true/不允许 false | Boolean | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
nationalityOrAreaNames | 国籍/地区名称 | Array[] | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
nationalityOrAreaCodes | 国籍/地区二字码 | Array[] | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
typeName | 类型名称 | String | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
content | 限制内容 | String | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
passagerCount | 旅客人数限制 | LimitingPassagerCountDto | flightInfoList.priceInfos.policy.limiting | |
minCount | 最小数量 | Integer | flightInfoList.priceInfos.policy.limiting.passagerCount | |
maxCount | 最大数量 | Integer | flightInfoList.priceInfos.policy.limiting.passagerCount | |
isMustBeEvenNumber | 是否必须偶数 | Boolean | flightInfoList.priceInfos.policy.limiting.passagerCount | |
typeName | 类型名称 | String | flightInfoList.priceInfos.policy.limiting.passagerCount | |
content | 限制内容 | String | flightInfoList.priceInfos.policy.limiting.passagerCount | |
certificate | 证件限制 | LimitingCertificateDto | flightInfoList.priceInfos.policy.limiting | |
limitingCondition | 证件类型名称限制条件:允许 true/不允许 false | Boolean | flightInfoList.priceInfos.policy.limiting.certificate | |
certificateTypeNames | 证件类型名称 | Array[] | flightInfoList.priceInfos.policy.limiting.certificate | |
certificateTypeCodes | 证件类型编码 | Array[] | flightInfoList.priceInfos.policy.limiting.certificate | |
certificateTypes | 证件类型 | Array[] | flightInfoList.priceInfos.policy.limiting.certificate | |
typeName | 类型名称 | String | flightInfoList.priceInfos.policy.limiting.certificate | |
content | 限制内容 | String | flightInfoList.priceInfos.policy.limiting.certificate | |
rule | 结构化退改规则 | ShoppingRule | flightInfoList.priceInfos | |
MinStay | 最短停留时间 | String | flightInfoList.priceInfos.rule | |
MaxStay | 最长停留时间 | String | flightInfoList.priceInfos.rule | |
Refund | 退票 | String | flightInfoList.priceInfos.rule | |
Change | 改签 | String | flightInfoList.priceInfos.rule | |
NoShow | 误机 | String | flightInfoList.priceInfos.rule | |
OtherInfo | 其他说明 | String | flightInfoList.priceInfos.rule | |
Structor | 结构化客规 | Structor | flightInfoList.priceInfos.rule | |
AdvanceReservation | 提前预定说明 | RuleStructAdvance | flightInfoList.priceInfos.rule.Structor | |
Unit | 提前预定时间单位 D=天,M=月,Y=年 | String | flightInfoList.priceInfos.rule.Structor.AdvanceReservation | |
Length | 提前预定时间 | String | flightInfoList.priceInfos.rule.Structor.AdvanceReservation | |
MinStay | 最短停留 | StructStay | flightInfoList.priceInfos.rule.Structor | |
Unit | 最短或最长停留单位 D=天,M=月,Y=年 | String | flightInfoList.priceInfos.rule.Structor.MinStay | |
Length | 最短或最长停留时间 | String | flightInfoList.priceInfos.rule.Structor.MinStay | |
Unlimited | 是否无限制,true表示无限制,此时不用看时长 | String | flightInfoList.priceInfos.rule.Structor.MinStay | |
Date | 最短停留日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.MinStay | |
Text | 非必输 String 信息描述 | String | flightInfoList.priceInfos.rule.Structor.MinStay | |
MaxStay | 最长停留 | StructStay | flightInfoList.priceInfos.rule.Structor | |
Unit | 最短或最长停留单位 D=天,M=月,Y=年 | String | flightInfoList.priceInfos.rule.Structor.MaxStay | |
Length | 最短或最长停留时间 | String | flightInfoList.priceInfos.rule.Structor.MaxStay | |
Unlimited | 是否无限制,true表示无限制,此时不用看时长 | String | flightInfoList.priceInfos.rule.Structor.MaxStay | |
Date | 最短停留日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.MaxStay | |
Text | 非必输 String 信息描述 | String | flightInfoList.priceInfos.rule.Structor.MaxStay | |
NoshowRefunds | 结构化客规误机退票 | Array[] | flightInfoList.priceInfos.rule.Structor | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | flightInfoList.priceInfos.rule.Structor.NoshowRefunds | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | flightInfoList.priceInfos.rule.Structor.NoshowRefunds | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | flightInfoList.priceInfos.rule.Structor.NoshowRefunds | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | flightInfoList.priceInfos.rule.Structor.NoshowRefunds | |
Currency | 币种 | String | flightInfoList.priceInfos.rule.Structor.NoshowRefunds | |
Text | 原文信息描述 | String | flightInfoList.priceInfos.rule.Structor.NoshowRefunds | |
NoshowChanges | 结构化客规误机改签 | Array[] | flightInfoList.priceInfos.rule.Structor | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | flightInfoList.priceInfos.rule.Structor.NoshowChanges | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | flightInfoList.priceInfos.rule.Structor.NoshowChanges | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | flightInfoList.priceInfos.rule.Structor.NoshowChanges | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | flightInfoList.priceInfos.rule.Structor.NoshowChanges | |
Currency | 币种 | String | flightInfoList.priceInfos.rule.Structor.NoshowChanges | |
Text | 原文信息描述 | String | flightInfoList.priceInfos.rule.Structor.NoshowChanges | |
Refunds | 结构化客规退票 | Array[] | flightInfoList.priceInfos.rule.Structor | |
TypeCode | 退票类型 可返值[before or after] | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | flightInfoList.priceInfos.rule.Structor.Refunds | |
Fee | 退票罚金 | Number | flightInfoList.priceInfos.rule.Structor.Refunds | |
Currency | 币种 | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
Text | 原文信息描述 | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
Changes | 结构化客规改签 | Array[] | flightInfoList.priceInfos.rule.Structor | |
TypeCode | 退票类型 可返值[before or after] | String | flightInfoList.priceInfos.rule.Structor.Changes | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | flightInfoList.priceInfos.rule.Structor.Changes | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | flightInfoList.priceInfos.rule.Structor.Changes | |
Fee | 退票罚金 | Number | flightInfoList.priceInfos.rule.Structor.Changes | |
Currency | 币种 | String | flightInfoList.priceInfos.rule.Structor.Changes | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Changes | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Changes | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Changes | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Changes | |
Text | 原文信息描述 | String | flightInfoList.priceInfos.rule.Structor.Changes | |
luggageList | PM2024166_国际标准API搜索、更多价格接口返回值增加行李额字段 | Array[] | flightInfoList.priceInfos | |
flightNo | 航班号 | String | flightInfoList.priceInfos.luggageList | |
departureCityName | 出发城市名称 | String | flightInfoList.priceInfos.luggageList | |
arrivalCityName | 到达城市名称 | String | flightInfoList.priceInfos.luggageList | |
departureCityCode | 出发城市三字码 | String | flightInfoList.priceInfos.luggageList | |
arrivalCityCode | 到达城市三字码 | String | flightInfoList.priceInfos.luggageList | |
checkInLuggagePieces | 免费托运行李件数 | String | flightInfoList.priceInfos.luggageList | |
checkInLuggageWeight | 免费托运行李重量 | String | flightInfoList.priceInfos.luggageList | |
checkInLuggageDemision | 免费托运行李体积 | String | flightInfoList.priceInfos.luggageList | |
checkInLuggageText | 行李额描述(免费托运行李) 新增字段,长宽高文本 | String | flightInfoList.priceInfos.luggageList | |
handLuggagePieces | 手提行李件数,允许件数(免费手提行李) | String | flightInfoList.priceInfos.luggageList | |
handLuggageWeight | 允许重量(免费手提行李) | String | flightInfoList.priceInfos.luggageList | |
handLuggageDemision | 体积(免费手提行李) | String | flightInfoList.priceInfos.luggageList | |
handLuggageText | 行李额描述(免费手提行李)长宽高文本 | String | flightInfoList.priceInfos.luggageList | |
seatBag | 随身物品内容 | LuaggageStructDto | flightInfoList.priceInfos.luggageList | |
Pieces | String | flightInfoList.priceInfos.luggageList.seatBag | ||
Weight | String | flightInfoList.priceInfos.luggageList.seatBag | ||
Demision | String | flightInfoList.priceInfos.luggageList.seatBag | ||
Description | String | flightInfoList.priceInfos.luggageList.seatBag | ||
CheckStruct | 托运行李结构化 | LuaggageStructDto | flightInfoList.priceInfos.luggageList | |
Pieces | String | flightInfoList.priceInfos.luggageList.CheckStruct | ||
Weight | String | flightInfoList.priceInfos.luggageList.CheckStruct | ||
Demision | String | flightInfoList.priceInfos.luggageList.CheckStruct | ||
Description | String | flightInfoList.priceInfos.luggageList.CheckStruct | ||
HandStruct | 手提行李结构化 | LuaggageStructDto | flightInfoList.priceInfos.luggageList | |
Pieces | String | flightInfoList.priceInfos.luggageList.HandStruct | ||
Weight | String | flightInfoList.priceInfos.luggageList.HandStruct | ||
Demision | String | flightInfoList.priceInfos.luggageList.HandStruct | ||
Description | String | flightInfoList.priceInfos.luggageList.HandStruct | ||
flightInfos | 航班信息 | Array[] | flightInfoList | |
segmentId | 在此集合中的ID | Integer | flightInfoList.flightInfos | |
flightId | 航程Id | String | flightInfoList.flightInfos | |
tripType | 行程类别,0第一程(去程) 、1第二程(回程)、2第三程(多程) | String | flightInfoList.flightInfos | |
journeyIndex | 行程序号(从1开始的自然数。表示第几个航程) | String | flightInfoList.flightInfos | |
departureAirport | 出发机场 | String | flightInfoList.flightInfos | |
arrivalAirport | 目的机场 | String | flightInfoList.flightInfos | |
termDep | 起飞航站楼 | String | flightInfoList.flightInfos | |
termArr | 到达航站楼 | String | flightInfoList.flightInfos | |
depAirportName | 出发机场中文名称 | String | flightInfoList.flightInfos | |
arrAirportName | 到达机场中文名称 | String | flightInfoList.flightInfos | |
depCity | 出发城市三字码 | String | flightInfoList.flightInfos | |
arrCity | 到达城市三字码 | String | flightInfoList.flightInfos | |
depCityName | 出发城市中文名称 | String | flightInfoList.flightInfos | |
arrCityName | 到达城市中文名称 | String | flightInfoList.flightInfos | |
departureDate | 出发日期 | String | flightInfoList.flightInfos | |
departuretimeModify | 本航段的起飞日期修正,例如+1表示第二天 | String | flightInfoList.flightInfos | |
departureTime | 出发时间 | String | flightInfoList.flightInfos | |
arrivalDate | 到达日期 | String | flightInfoList.flightInfos | |
arrivaltimeModify | 得到本航段的到达日期修正,例如+1表示第二天 | String | flightInfoList.flightInfos | |
arrivalTime | 到达时间 | String | flightInfoList.flightInfos | |
marketingAirline | 销售航司 | String | flightInfoList.flightInfos | |
marketingAirlineName_CN | 销售航司 中文名 | String | flightInfoList.flightInfos | |
airlineAllianceCode | 航司联盟(STARALLIANCE=星空联盟,ONEWORLD=寰宇一家,SKYTEAM=天合联盟) | String | flightInfoList.flightInfos | |
flightNumber | 航班号 | String | flightInfoList.flightInfos | |
operatingCarrier | 实际承运航空公司,共享航班才有值 | String | flightInfoList.flightInfos | |
operatingFlightNumber | 实际承运航班号 ,共享航班才有值 | String | flightInfoList.flightInfos | |
equipment | 机型类别代码 | String | flightInfoList.flightInfos | |
equipmentName | 机型类别代码 | String | flightInfoList.flightInfos | |
equipmentEnName | 机型英文名称 | String | flightInfoList.flightInfos | |
equipmentBodyName | 机型型号 | String | flightInfoList.flightInfos | |
equipmentBodyType | 机型类型 1小型、2中型、3大型 | String | flightInfoList.flightInfos | |
equipmentMaxPassengers | 机型最大载客数 | String | flightInfoList.flightInfos | |
equipmentMinPassengers | 机型最小载客数 | String | flightInfoList.flightInfos | |
equipmentType | 航班载体类型(0=飞机,1=火车,2=汽车,3=船) | String | flightInfoList.flightInfos | |
planeType | 超宽体 宽体 窄体 未知 | String | flightInfoList.flightInfos | |
duration | 飞行时间,单位为分钟 | String | flightInfoList.flightInfos | |
distance | 飞行距离,单位为KM | String | flightInfoList.flightInfos | |
depWorldRegionCode | 出发 世界区域 | String | flightInfoList.flightInfos | |
intermediateAirports | 经停信息 | Array[] | flightInfoList.flightInfos | |
clazz | 航位 | String | flightInfoList.flightInfos | |
cabin | 航等;1 经济舱 2 公务舱 3 头等舱 4 超级经济舱 | String | flightInfoList.flightInfos | |
seatNo | 座位数 | String | flightInfoList.flightInfos | |
LuggageHangingType | 行李直挂类型 1不允许直挂 2允许直挂明细规则 3未知 | String | flightInfoList.flightInfos | |
VisaType | 过境签类型 1 需要过境签 2可能需过境签 3不需要过境签 4其它 | String | flightInfoList.flightInfos | |
VisaContent | 非必输 String 过境签内容说明 | String | flightInfoList.flightInfos | |
isFood | 是否有食物 | Boolean | flightInfoList.flightInfos | |
stops | 新经停(使用这个) | Array[] | flightInfoList.flightInfos | |
airportCode | 经停机场 | String | flightInfoList.flightInfos.stops | |
airportName | 经停机场名称 | String | flightInfoList.flightInfos.stops | |
cityCode | 经停城市 | String | flightInfoList.flightInfos.stops | |
cityName | 经停名称 | String | flightInfoList.flightInfos.stops | |
duration | 经停时间 HH:mm | String | flightInfoList.flightInfos.stops | |
arrivalDate | 到达时间 格式 yyyy-MM-dd | String | flightInfoList.flightInfos.stops | |
arrivalTime | 到达时间 格式 HH:mm | String | flightInfoList.flightInfos.stops | |
departureDate | 起飞日期 格式 yyyy-MM-dd | String | flightInfoList.flightInfos.stops | |
departureTime | 起飞时间 格式 HH:mm | String | flightInfoList.flightInfos.stops | |
FlightDetailDto | 航班详细信息 | FlightDetailDto | flightInfoList.flightInfos | |
FlightProperty | 航班属性flightProperty字段枚举值说明:枚举值0-国内-国内 1-国内-国际 2-国内-地区 3-地区-国际 4-国际-国际 | String | flightInfoList.flightInfos.FlightDetailDto | |
AvgPlanDuration | 未来平均计划时间: HH:mm | String | flightInfoList.flightInfos.FlightDetailDto | |
DepAvgDelayTime | 平均出发延误时间(分钟): 15 | String | flightInfoList.flightInfos.FlightDetailDto | |
ArrAvgDelayTime | 平均到达延误时间(分钟): 10 | String | flightInfoList.flightInfos.FlightDetailDto | |
DepBridgeRate | 出港靠桥率: 80% | String | flightInfoList.flightInfos.FlightDetailDto | |
ArrBridgeRate | 进港靠桥率: 75% | String | flightInfoList.flightInfos.FlightDetailDto | |
DepOnTimeRate | 出发准点率: 90% | String | flightInfoList.flightInfos.FlightDetailDto | |
ArrOnTimeRate | 到达准点率: 85% | String | flightInfoList.flightInfos.FlightDetailDto | |
AircraftAge | 平均机龄: 5年 | String | flightInfoList.flightInfos.FlightDetailDto | |
ThemeFlight | 主题航班: 无 | String | flightInfoList.flightInfos.FlightDetailDto | |
Luggage | 行李限额描述: 免费托运20公斤 | String | flightInfoList.flightInfos.FlightDetailDto | |
Cabins | 舱位信息 | Array[] | flightInfoList.flightInfos.FlightDetailDto | |
ClassLevel | 舱等 经济舱 = 1,公务舱 = 2,头等舱 = 3,豪华经济舱 = 4 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
PerCapita | 人均碳排放量,单位:千克: 100kg | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
InTotal | 总碳排放量,单位:千克: 200kg | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
PerCapitaTree | 人均消耗树量,单位:棵: 1棵树 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
SeatWidth | 座位宽度: 17.5英寸 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
SeatTilt | 座椅倾斜度: 可调节 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
Beverage | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Beverage | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Beverage | |
Entertainment | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Entertainment | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Entertainment | |
Food | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Food | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Food | |
Power | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Power | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Power | |
Wifi | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Wifi | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Wifi | |
Layout | FlightDetailCabinLayoutDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
RowLayout | 3-3 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Layout | |
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Layout | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Layout | |
Seat | FlightDetailCabinSeatDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
Pitch | "34" | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Seat | |
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Seat | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Seat | |
rules | 退改规则信息集合 | Array[] | ||
tripType | 行程类别,0第一程(去程) 、1第二程(回程) | String | rules | |
origin | 出发城市 | String | rules | |
destination | 目的城市 | String | rules | |
refund | 退票 | String | rules | |
minStay | 最短停留 | String | rules | |
noShow | 误机 | String | rules | |
maxStay | 最长停留 | String | rules | |
originalResult | 条款内容 | String | rules | |
change | 改签 | String | rules | |
luggage | 行李 | String | rules | |
ticketinginfo | 出票说明 | String | rules | |
otherInfo | 其他说明 | String | rules | |
allowPieces | 允许件数 | Integer | rules | |
allowWeight | 允许重量 | Integer | rules | |
allowWeightUnit | 重量单位 | String | rules | |
handPieces | 允许件数 | String | rules | |
handWeight | 允许重量 | String | rules |
{
"flightInfoList":
{
"platingCarrier":"CX", //销售航司
"flightId":0, //航程Id,新版已不使用该参数,忽略
"tripId":"173279100981c8ee7e99ecdf1d3f12c8", //PM2023084添加 新版返回tripId代替flightId
"IsChangePrice":false, //PM2023084添加 是否变价
"IsChangeCabin":false, //PM2023084添加 是否变舱
"IsChangeFlight":false, //PM2023084添加 航班信息是否变更
"origin": "", //PM2023084添加 运价起点城市三字码
"ctcm":"null", //PM2023084添加 CTCM,旅客联系号码
"flightInfos":
[{
"segmentId":0, //在此集合中的ID
"flightId":"1206PEKHKGCX393", //航程Id
"tripType":"0", //行程类别,0第一程(去程) 、1第二程(回程)、2第三程(多程)
"journeyIndex":"1", //行程序号(从1开始的自然数。表示第几个航程)
"departureAirport":"PEK", //出发机场
"arrivalAirport":"HKG", //目的机场
"termDep":"3", //起飞航站楼
"termArr":"1", //到达航站楼
"depAirportName":"首都国际机场", //出发机场中文名称
"arrAirportName":"香港国际机场", //到达机场中文名称
"depCity":"BJS", //出发城市三字码
"arrCity":"HKG", //到达城市三字码
"depCityName":"北京", //出发城市中文名称
"arrCityName":"中国香港", //到达城市中文名称
"departureDate":"2023-12-06", //出发日期
"departuretimeModify": "", //本航段的起飞日期修正,例如+1表示第二天
"departureTime":"18:35", //出发时间
"arrivalDate":"2023-12-06", //到达日期
"arrivaltimeModify": "", //得到本航段的到达日期修正,例如+1表示第二天
"arrivalTime":"22:25", //到达时间
"marketingAirline":"CX", //销售航司
"marketingAirlineName_CN":"国泰航空", //销售航司 中文名
"airlineAllianceCode":"STARALLIANCE", //航司联盟(STARALLIANCE=星空联盟,ONEWORLD=寰宇一家,SKYTEAM=天合联盟)
"flightNumber":"393", //航班号
"operatingCarrier": "", //实际承运航空公司,共享航班才有值
"operatingFlightNumber": "", //实际承运航班号 ,共享航班才有值
"equipment":"333", //机型类别代码
"equipmentName":"空客330", //机型类别代码
"equipmentEnName":"Airbus A330", //机型英文名称
"equipmentBodyName":"空客330", //机型型号
"equipmentBodyType":"3", //机型类型 1小型、2中型、3大型
"equipmentMaxPassengers":"100", //机型最大载客数
"equipmentMinPassengers":"30", //机型最小载客数
"equipmentType":"0", //航班载体类型(0=飞机,1=火车,2=汽车,3=船)
"planeType":"宽体", //超宽体 宽体 窄体 未知
"duration":"230", //飞行时间,单位为分钟
"distance":"1234", //飞行距离,单位为KM
"depWorldRegionCode": "", //出发 世界区域
"intermediateAirports":"null", //经停信息
"clazz":"V", //航位
"cabin":"1", //航等;1 经济舱 2 公务舱 3 头等舱 4 超级经济舱
"seatNo":"9", //座位数
"stops":
[{
"airportCode":"WUH", //经停机场
"airportName":"天河国际机场", //经停机场名称
"cityCode":"WUH", //经停城市
"cityName":"武汉", //经停名称
"duration": "", //经停时间 HH:mm
"arrivalDate": "", //到达时间 格式 yyyy-MM-dd
"arrivalTime": "", //到达时间 格式 HH:mm
"departureDate": "", //起飞日期 格式 yyyy-MM-dd
"departureTime": "", //起飞时间 格式 HH:mm
}], //新经停(使用这个)
"LuggageHangingType":"1", //行李直挂类型 1不允许直挂 2允许直挂明细规则 3未知
"VisaType":"3", //过境签类型 1 需要过境签 2可能需过境签 3不需要过境签 4其它
"VisaContent":"国际旅客无需签证即可在马来西亚过境。", //非必输 String 过境签内容说明
"isFood":true, //是否有食物
"FlightDetailDto":
{
"FlightProperty": "", //航班属性flightProperty字段枚举值说明:枚举值0-国内-国内 1-国内-国际 2-国内-地区 3-地区-国际 4-国际-国际
"AvgPlanDuration": "", //未来平均计划时间: HH:mm
"DepAvgDelayTime": "", //平均出发延误时间(分钟): 15
"ArrAvgDelayTime": "", //平均到达延误时间(分钟): 10
"DepBridgeRate": "", //出港靠桥率: 80%
"ArrBridgeRate": "", //进港靠桥率: 75%
"DepOnTimeRate": "", //出发准点率: 90%
"ArrOnTimeRate": "", //到达准点率: 85%
"AircraftAge": "", //平均机龄: 5年
"Cabins":
[{
"ClassLevel": "", //舱等 经济舱 = 1,公务舱 = 2,头等舱 = 3,豪华经济舱 = 4
"PerCapita": "", //人均碳排放量,单位:千克: 100kg
"InTotal": "", //总碳排放量,单位:千克: 200kg
"PerCapitaTree": "", //人均消耗树量,单位:棵: 1棵树
"SeatWidth": "", //座位宽度: 17.5英寸
"SeatTilt": "", //座椅倾斜度: 可调节
"Beverage":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Entertainment":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Food":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Layout":
{
"RowLayout": "", //3-3
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Power":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Seat":
{
"Pitch": "", //"34"
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Wifi":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
}], //舱位信息
"ThemeFlight": "", //主题航班: 无
"Luggage": "", //行李限额描述: 免费托运20公斤
}, //航班详细信息
}], //航班信息
"priceInfos":
[{
"Clazzs":
[{
"flightId":"9", //航班序号,对应航段信息里的flightId
"clazzNo":"9", //舱位编码; 示例:P
"classLevel":"1", //舱等;1-经济舱;2-商务舱;3-头等舱;4-豪华经济舱
"seatNo":"9", //座位数
}], //舱位信息
"solutionId":"6e151d0b039b4eeaabb59fdac2d0051c", //PM2023084添加 方案Id
"passengerType":"PASSENGER_ADULT", //乘客类型,PASSENGER_ADULT,PASSENGER_CHILD,PASSENGER_BABY,
"passengerTypeCount":"1", //乘客数量
"activeTime":"2023-12-06 12:45:00", //PM2023084添加 票价出票时限
"proofType":1, //PM2023084添加 报销凭证:1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,7=按政策设置,8=无
"baseFare":6490, //销售 -- 票面价
"tax":1356.0, //销售 - 税
"servicePriceTotal":0.0, //服务费合计
"protocolStrategryCode":"TBOrderInfo", //三方协议产品编号
"protocolShowType":0, //协议类型显示标识((0代表不显示、1代表显示协议、2代表显示美亚特惠))
"source":"IBEPLUS", //来源 (IBEPLUS航司接口;syber)
"fareType":"10", //票证类型(10 美亚BSP,20 境外票,30 B2B, 40非美亚BSP,50航司直连)
"luggageList":
[{
"flightNo": "", //航班号
"departureCityName":"北京", //出发城市名称
"arrivalCityName":"青岛", //到达城市名称
"departureCityCode":"BJS", //出发城市三字码
"arrivalCityCode":"TAO", //到达城市三字码
"checkInLuggagePieces":"2", //免费托运行李件数
"checkInLuggageWeight": "", //免费托运行李重量
"checkInLuggageDemision": "", //免费托运行李体积
"checkInLuggageText": "", //行李额描述(免费托运行李) 新增字段,长宽高文本
"handLuggagePieces":"1", //手提行李件数,允许件数(免费手提行李)
"handLuggageWeight": "", //允许重量(免费手提行李)
"handLuggageDemision": "", //体积(免费手提行李)
"handLuggageText": "", //行李额描述(免费手提行李)长宽高文本
"seatBag":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //随身物品内容
"CheckStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //托运行李结构化
"HandStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //手提行李结构化
}], //PM2024166_国际标准API搜索、更多价格接口返回值增加行李额字段
"rule":
{
"MinStay": "", //最短停留时间
"MaxStay": "", //最长停留时间
"Refund": "", //退票
"Change": "", //改签
"NoShow": "", //误机
"OtherInfo": "", //其他说明
"Structor":
{
"Refunds":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //结构化客规退票
"Changes":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //结构化客规改签
"NoshowRefunds":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //结构化客规误机退票
"NoshowChanges":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //结构化客规误机改签
"MinStay":
{
"Unit": "", //最短或最长停留单位 D=天,M=月,Y=年
"Length": "", //最短或最长停留时间
"Unlimited": "", //是否无限制,true表示无限制,此时不用看时长
"Date": "", //最短停留日期 yyyy-MM-dd
"Text": "", //非必输 String 信息描述
}, //最短停留
"MaxStay":
{
"Unit": "", //最短或最长停留单位 D=天,M=月,Y=年
"Length": "", //最短或最长停留时间
"Unlimited": "", //是否无限制,true表示无限制,此时不用看时长
"Date": "", //最短停留日期 yyyy-MM-dd
"Text": "", //非必输 String 信息描述
}, //最长停留
"AdvanceReservation":
{
"Unit":"KG", //提前预定时间单位 D=天,M=月,Y=年
"Length":"KG", //提前预定时间
}, //提前预定说明
}, //结构化客规
}, //结构化退改规则
"policy":
{
"farePriceType": "", //票价类型,公有 = 0,私有 = 1,协议= 2
"isHaveTravelItinerary":false, //是否有行程单
"travelItinerary": "", //报销凭证,1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,8=无
"group":
{
"groupTag": "", //按逻辑运算符合数字拼装
"content": "", //内容,比如,此价格仅限2-9人
"structor": "", //团价结构化信息 json化
}, //团价信息
"supplierService":
{
"Issue":
{
"ServicerType":0, //服务商类型(0=美亚自营,1=供应商提供服务)
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //出票
"Change":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //改签
"Refund":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //退票
"Void":
{
"IsCanVoid":false, //是否可以废票
"VoidEffective":0, //作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认]
"VoidTicketingDeadline": "", //废票截止时间 格式 yyyy-MM-ddTHH:mm:ss
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //作废
}, //供应商服务内容
"limiting":
{
"conentHadTheme": "", //
"contents":[], //限制内容
"isRequiredCertificatePhoto":false, //是否需要证件照片
"nationalityOrArea":
{
"limitingCondition":false, //国籍限制条件:允许 true/不允许 false
"nationalityOrAreaNames":[], //国籍/地区名称
"nationalityOrAreaCodes":[], //国籍/地区二字码
"typeName": "", //类型名称
"content": "", //限制内容
}, //国家或区域限制
"certificate":
{
"limitingCondition":false, //证件类型名称限制条件:允许 true/不允许 false
"certificateTypeNames":[], //证件类型名称
"certificateTypeCodes":[], //证件类型编码
"certificateTypes":[], //证件类型
"typeName": "", //类型名称
"content": "", //限制内容
}, //证件限制
"age":
{
"minAge":0, //最小年龄
"maxAge":0, //最大年龄
"typeName": "", //类型名称
"content": "", //限制内容
}, //年龄限制
"passagerCount":
{
"minCount":0, //最小数量
"maxCount":0, //最大数量
"isMustBeEvenNumber":false, //是否必须偶数
"typeName": "", //类型名称
"content": "", //限制内容
}, //旅客人数限制
}, //限制信息
}, //差旅政策
"FrequentTravellers":
[{
"airlineCode": "", //航司二字代码
"name": "", //常旅客计划中文名
"enName": "", //常旅客计划英文名
}], //常旅客计划
"isRequireCertificate":false, //证件号是否为必填
"SupportCertificates":
[{
"certificateType": "", //证件类型
"certificateTypeName": "", //证件类型中文名
"CountryOrAreas":
[{
"code": "", //国家或国家地区代码
"name": "", //国家或国家地区中文名称
}], //国家或国家地区代码,空为不限
}], //支持的证件类型
"currency":"CNY", //结算币种
}], //价格信息
}, //行程信息
"rules":
[{
"tripType":"0", //行程类别,0第一程(去程) 、1第二程(回程)
"origin":"BJS", //出发城市
"destination":"SEL", //目的城市
"refund": "", //退票
"minStay": "", //最短停留
"noShow": "", //误机
"maxStay": "", //最长停留
"originalResult": "", //条款内容
"change": "", //改签
"luggage": "", //行李
"ticketinginfo": "", //出票说明
"otherInfo": "", //其他说明
"allowPieces":0, //允许件数
"allowWeight":0, //允许重量
"allowWeightUnit": "", //重量单位
"handPieces": "", //允许件数
"handWeight": "", //允许重量
}], //退改规则信息集合
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
查询已选航班退改规则和行李额
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
resultId | 当前查询航班返回结果的唯一号 | String | 是 | |
tripId | PM2023084添加 新版返回tripId代替flightId | String | 否 | |
solutionId | PM2023084添加 方案Id | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"resultId":"fb2f091a18324cf2ac4910115ca006d8", //当前查询航班返回结果的唯一号
"tripId":"0dd2390dbc444224566da481f78bed43", //PM2023084添加 新版返回tripId代替flightId
"solutionId":"11c5a5d7a1234f84982a8ce2b2cae8dc", //PM2023084添加 方案Id
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
airRule | 条款 | AirRule | ||
remark | 备注 | String | airRule | |
SupplierService | 供应商服务内容 | PolicySupplierServiceDto | airRule | |
Change | 改签 | SupplierServiceChangeDto | airRule.SupplierService | |
Content | 服务内容 | String | airRule.SupplierService.Change | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | airRule.SupplierService.Change | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | airRule.SupplierService.Change.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Change.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Change.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | airRule.SupplierService.Change.ServiceTime | |
Content | 服务内容 | String | airRule.SupplierService.Change.ServiceTime.All | |
Normals | 正常时间 | Array[] | airRule.SupplierService.Change.ServiceTime.All | |
WeekDay | 星期几 ,CHoliday=其他法定节假日 | String | airRule.SupplierService.Change.ServiceTime.All.Normals | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Change.ServiceTime.All.Normals | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Change.ServiceTime.All.Normals | |
Specials | 特殊时间 | Array[] | airRule.SupplierService.Change.ServiceTime.All | |
StartDay | 开始日期(yyyy-MM-dd) | String | airRule.SupplierService.Change.ServiceTime.All.Specials | |
EndDay | 结束日期(yyyy-MM-dd) | String | airRule.SupplierService.Change.ServiceTime.All.Specials | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Change.ServiceTime.All.Specials | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Change.ServiceTime.All.Specials | |
Refund | 退票 | SupplierServiceRefundDto | airRule.SupplierService | |
Content | 服务内容 | String | airRule.SupplierService.Refund | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | airRule.SupplierService.Refund | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | airRule.SupplierService.Refund.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Refund.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Refund.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | airRule.SupplierService.Refund.ServiceTime | |
Content | 服务内容 | String | airRule.SupplierService.Refund.ServiceTime.All | |
Normals | 正常时间 | Array[] | airRule.SupplierService.Refund.ServiceTime.All | |
WeekDay | 星期几 ,CHoliday=其他法定节假日 | String | airRule.SupplierService.Refund.ServiceTime.All.Normals | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Refund.ServiceTime.All.Normals | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Refund.ServiceTime.All.Normals | |
Specials | 特殊时间 | Array[] | airRule.SupplierService.Refund.ServiceTime.All | |
StartDay | 开始日期(yyyy-MM-dd) | String | airRule.SupplierService.Refund.ServiceTime.All.Specials | |
EndDay | 结束日期(yyyy-MM-dd) | String | airRule.SupplierService.Refund.ServiceTime.All.Specials | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Refund.ServiceTime.All.Specials | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Refund.ServiceTime.All.Specials | |
Issue | 出票 | SupplierServiceIssueDto | airRule.SupplierService | |
ServicerType | 服务商类型(0=美亚自营,1=供应商提供服务) | Integer | airRule.SupplierService.Issue | |
Content | 服务内容 | String | airRule.SupplierService.Issue | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | airRule.SupplierService.Issue | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | airRule.SupplierService.Issue.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Issue.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Issue.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | airRule.SupplierService.Issue.ServiceTime | |
Content | 服务内容 | String | airRule.SupplierService.Issue.ServiceTime.All | |
Normals | 正常时间 | Array[] | airRule.SupplierService.Issue.ServiceTime.All | |
WeekDay | 星期几 ,CHoliday=其他法定节假日 | String | airRule.SupplierService.Issue.ServiceTime.All.Normals | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Issue.ServiceTime.All.Normals | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Issue.ServiceTime.All.Normals | |
Specials | 特殊时间 | Array[] | airRule.SupplierService.Issue.ServiceTime.All | |
StartDay | 开始日期(yyyy-MM-dd) | String | airRule.SupplierService.Issue.ServiceTime.All.Specials | |
EndDay | 结束日期(yyyy-MM-dd) | String | airRule.SupplierService.Issue.ServiceTime.All.Specials | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Issue.ServiceTime.All.Specials | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Issue.ServiceTime.All.Specials | |
Void | 作废 | SupplierServiceVoidDto | airRule.SupplierService | |
IsCanVoid | 是否可以废票 | Boolean | airRule.SupplierService.Void | |
VoidEffective | 作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认] | Integer | airRule.SupplierService.Void | |
VoidTicketingDeadline | 废票截止时间 格式 yyyy-MM-ddTHH:mm:ss | String | airRule.SupplierService.Void | |
Content | 服务内容 | String | airRule.SupplierService.Void | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | airRule.SupplierService.Void | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | airRule.SupplierService.Void.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Void.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Void.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | airRule.SupplierService.Void.ServiceTime | |
Content | 服务内容 | String | airRule.SupplierService.Void.ServiceTime.All | |
Normals | 正常时间 | Array[] | airRule.SupplierService.Void.ServiceTime.All | |
WeekDay | 星期几 ,CHoliday=其他法定节假日 | String | airRule.SupplierService.Void.ServiceTime.All.Normals | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Void.ServiceTime.All.Normals | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Void.ServiceTime.All.Normals | |
Specials | 特殊时间 | Array[] | airRule.SupplierService.Void.ServiceTime.All | |
StartDay | 开始日期(yyyy-MM-dd) | String | airRule.SupplierService.Void.ServiceTime.All.Specials | |
EndDay | 结束日期(yyyy-MM-dd) | String | airRule.SupplierService.Void.ServiceTime.All.Specials | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Void.ServiceTime.All.Specials | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Void.ServiceTime.All.Specials | |
airRuleList | 退改条款详情 | Array[] | airRule | |
origin | 运价起点城市三字码 | String | airRule.airRuleList | |
destination | 运价终点城市三字码 | String | airRule.airRuleList | |
minStay | 最短停留时间 | String | airRule.airRuleList | |
maxStay | 最长停留时间 | String | airRule.airRuleList | |
refund | 退票 | String | airRule.airRuleList | |
change | 改签 | String | airRule.airRuleList | |
delay | 延误 | String | airRule.airRuleList | |
luggage | 行李额 | String | airRule.airRuleList | |
NoshowRefunds | PM2023084添加 结构化退票规则 | Array[] | airRule.airRuleList | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | airRule.airRuleList.NoshowRefunds | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | airRule.airRuleList.NoshowRefunds | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | airRule.airRuleList.NoshowRefunds | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | airRule.airRuleList.NoshowRefunds | |
Currency | 币种 | String | airRule.airRuleList.NoshowRefunds | |
Text | 原文信息描述 | String | airRule.airRuleList.NoshowRefunds | |
NoshowChanges | PM2023084添加 结构化改签规则 | Array[] | airRule.airRuleList | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | airRule.airRuleList.NoshowChanges | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | airRule.airRuleList.NoshowChanges | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | airRule.airRuleList.NoshowChanges | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | airRule.airRuleList.NoshowChanges | |
Currency | 币种 | String | airRule.airRuleList.NoshowChanges | |
Text | 原文信息描述 | String | airRule.airRuleList.NoshowChanges | |
Refunds | PM2023084添加 退票规则详情 | Array[] | airRule.airRuleList | |
TypeCode | 退票类型 可返值[before or after] | String | airRule.airRuleList.Refunds | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | airRule.airRuleList.Refunds | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | airRule.airRuleList.Refunds | |
Fee | 退票罚金 | Number | airRule.airRuleList.Refunds | |
Currency | 币种 | String | airRule.airRuleList.Refunds | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | airRule.airRuleList.Refunds | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | airRule.airRuleList.Refunds | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | airRule.airRuleList.Refunds | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | airRule.airRuleList.Refunds | |
Text | 原文信息描述 | String | airRule.airRuleList.Refunds | |
Changes | PM2023084添加 改签规则详情 | Array[] | airRule.airRuleList | |
TypeCode | 退票类型 可返值[before or after] | String | airRule.airRuleList.Changes | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | airRule.airRuleList.Changes | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | airRule.airRuleList.Changes | |
Fee | 退票罚金 | Number | airRule.airRuleList.Changes | |
Currency | 币种 | String | airRule.airRuleList.Changes | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | airRule.airRuleList.Changes | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | airRule.airRuleList.Changes | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | airRule.airRuleList.Changes | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | airRule.airRuleList.Changes | |
Text | 原文信息描述 | String | airRule.airRuleList.Changes | |
luggageList | PM2023084添加 行李额 | Array[] | airRule.airRuleList | |
flightNo | 航班号 | String | airRule.airRuleList.luggageList | |
departureCityName | 出发城市名称 | String | airRule.airRuleList.luggageList | |
arrivalCityName | 到达城市名称 | String | airRule.airRuleList.luggageList | |
departureCityCode | 出发城市三字码 | String | airRule.airRuleList.luggageList | |
arrivalCityCode | 到达城市三字码 | String | airRule.airRuleList.luggageList | |
checkInLuggagePieces | 免费托运行李件数 | String | airRule.airRuleList.luggageList | |
checkInLuggageWeight | 免费托运行李重量 | String | airRule.airRuleList.luggageList | |
checkInLuggageDemision | 免费托运行李体积 | String | airRule.airRuleList.luggageList | |
checkInLuggageText | 行李额描述(免费托运行李) 新增字段,长宽高文本 | String | airRule.airRuleList.luggageList | |
handLuggagePieces | 手提行李件数,允许件数(免费手提行李) | String | airRule.airRuleList.luggageList | |
handLuggageWeight | 允许重量(免费手提行李) | String | airRule.airRuleList.luggageList | |
handLuggageDemision | 体积(免费手提行李) | String | airRule.airRuleList.luggageList | |
handLuggageText | 行李额描述(免费手提行李)长宽高文本 | String | airRule.airRuleList.luggageList | |
seatBag | 随身物品内容 | LuaggageStructDto | airRule.airRuleList.luggageList | |
Pieces | String | airRule.airRuleList.luggageList.seatBag | ||
Weight | String | airRule.airRuleList.luggageList.seatBag | ||
Demision | String | airRule.airRuleList.luggageList.seatBag | ||
Description | String | airRule.airRuleList.luggageList.seatBag | ||
CheckStruct | 托运行李结构化 | LuaggageStructDto | airRule.airRuleList.luggageList | |
Pieces | String | airRule.airRuleList.luggageList.CheckStruct | ||
Weight | String | airRule.airRuleList.luggageList.CheckStruct | ||
Demision | String | airRule.airRuleList.luggageList.CheckStruct | ||
Description | String | airRule.airRuleList.luggageList.CheckStruct | ||
HandStruct | 手提行李结构化 | LuaggageStructDto | airRule.airRuleList.luggageList | |
Pieces | String | airRule.airRuleList.luggageList.HandStruct | ||
Weight | String | airRule.airRuleList.luggageList.HandStruct | ||
Demision | String | airRule.airRuleList.luggageList.HandStruct | ||
Description | String | airRule.airRuleList.luggageList.HandStruct |
{
"airRule":
{
"airRuleList":
[{
"origin":"BJS", //运价起点城市三字码
"destination":"SEL", //运价终点城市三字码
"minStay": "", //最短停留时间
"maxStay": "", //最长停留时间
"refund":"不允许", //退票
"change":"不允许", //改签
"delay":"误机发生后退票需额外收取误机费300元。误机发生后更改需额外收取误机费300元", //延误
"luggage":"北京(BJS)-青岛(TAO):托运免费行李:件数:2;托运说明:免费托运行李:2件。手持免费行李:件数:1;手持说明:免费手提行李:1件。青岛(TAO)-首尔(SEL):托运免费行李:件数:2;托运说明:免费托运行李:2件。手持免费行李:件数:1;手持说明:免费手提行李:1件。", //行李额
"luggageList":
[{
"flightNo": "", //航班号
"departureCityName":"北京", //出发城市名称
"arrivalCityName":"青岛", //到达城市名称
"departureCityCode":"BJS", //出发城市三字码
"arrivalCityCode":"TAO", //到达城市三字码
"checkInLuggagePieces":"2", //免费托运行李件数
"checkInLuggageWeight": "", //免费托运行李重量
"checkInLuggageDemision": "", //免费托运行李体积
"checkInLuggageText": "", //行李额描述(免费托运行李) 新增字段,长宽高文本
"handLuggagePieces":"1", //手提行李件数,允许件数(免费手提行李)
"handLuggageWeight": "", //允许重量(免费手提行李)
"handLuggageDemision": "", //体积(免费手提行李)
"handLuggageText": "", //行李额描述(免费手提行李)长宽高文本
"seatBag":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //随身物品内容
"CheckStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //托运行李结构化
"HandStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //手提行李结构化
}], //PM2023084添加 行李额
"Refunds":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //PM2023084添加 退票规则详情
"Changes":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //PM2023084添加 改签规则详情
"NoshowRefunds":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //PM2023084添加 结构化退票规则
"NoshowChanges":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //PM2023084添加 结构化改签规则
}], //退改条款详情
"remark":"无", //备注
"SupplierService":
{
"Issue":
{
"ServicerType":0, //服务商类型(0=美亚自营,1=供应商提供服务)
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //出票
"Change":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //改签
"Refund":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //退票
"Void":
{
"IsCanVoid":false, //是否可以废票
"VoidEffective":0, //作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认]
"VoidTicketingDeadline": "", //废票截止时间 格式 yyyy-MM-ddTHH:mm:ss
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //作废
}, //供应商服务内容
}, //条款
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
查询已选航班的经停信息
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
resultId | 当前查询航班返回结果的唯一号 | String | 是 | |
tripId | PM2023084添加 新版返回tripId代替flightId | String | 是 | |
solutionId | PM2023084添加 方案Id | String | 是 | |
segmentId | 航段ID | Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"resultId":"fb2f091a18324cf2ac4910115ca006d8", //当前查询航班返回结果的唯一号
"tripId":"0dd2390dbc444224566da481f78bed43", //PM2023084添加 新版返回tripId代替flightId
"solutionId":"11c5a5d7a1234f84982a8ce2b2cae8dc", //PM2023084添加 方案Id
"segmentId":0, //航段ID
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
guid | 当前查询航班返回结果的唯一号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
iFlightStops | 经停信息 | Array[] | ||
airportCode | 机场编码 | String | iFlightStops | |
airportName | 机场名称 | String | iFlightStops | |
cityCode | 城市编码 | String | iFlightStops | |
cityName | 城市名称 | String | iFlightStops | |
arrivalDate | 达到日期 | String | iFlightStops | |
arrivalTime | 到达时间 | String | iFlightStops | |
departureDate | 出发日期 | String | iFlightStops | |
departureTime | 出发时间 | String | iFlightStops |
{
"guid":"0dd2390dbc444224566da481f78bed43", //当前查询航班返回结果的唯一号
"iFlightStops":
[{
"airportCode":"HKG", //机场编码
"airportName":"香港国际机场", //机场名称
"cityCode":"HKG", //城市编码
"cityName":"中国香港", //城市名称
"arrivalDate":"2023-10-25", //达到日期
"arrivalTime":"10:25", //到达时间
"departureDate":"2023-10-25", //出发日期
"departureTime":"3:50", //出发时间
}], //经停信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
创建国际机票订单
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
resultId | 当前查询航班返回结果的唯一号 | String | 是 | |
tripId | PM2023084添加 新版返回tripId代替flightId | String | 是 | |
solutionId | PM2023084添加 方案Id | String | 是 | |
opRemark | 备注 | String | 否 | |
isSubmit | 是否提交 0 仅保存 1 保存并提交 | Integer | 是 | |
receivePayType | 应收支付类型(1:在线消费 2:信用消费 3-预存款支付) | String | 是 | |
oaSerialnumber | 外部出差申请单号 | String | 否 | |
isCheckedTicketNo | 是否继续预订(已校验过旅客未使用客票); 如果预订时返回:存在未使用客票:是否继续预订? 如接受继续预订,则传true,可以保存成功,跳过验证; | Boolean | 否 | |
bookType | 0-因公 默认不传;1-因私; 目前只支持因公 | String | 是 | |
language | 非必填,默认为 ZH 中文,字段值参考:EN:英文、ZH:中国 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
contactList | 联系人 | Array[] | 是 | |
contactName | 联系人 | String | contactList | |
mobile | 手机号码 | String | contactList | |
phone | 联系电话 | String | contactList | |
电子邮件 | String | contactList | ||
applyPassenger | 制单人信息(全API 对接可以不传,默认sessionid的登录人为制单人),如需要明确制单人,则sessionid需要和传入的制单人一致;会涉及到订单的权限问题 | PassengerInfo | 是 | |
outsidePassengerId | 对接方系统的旅客编号 | String | applyPassenger | |
passengerType | 旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿) | String | applyPassenger | |
companyId | 公司编号 | String | applyPassenger | |
sex | 必传 性别:男/女;不能传其他字符 | String | applyPassenger | |
cnName | 中文姓名(中文姓名、英文姓名2选一) | String | applyPassenger | |
enName | 英文姓名(中文姓名、英文姓名2选一,格式:zhang/san) | String | applyPassenger | |
dName | 部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | applyPassenger | |
nationality | 国籍:中国填写 CN,必传 | String | applyPassenger | |
birthday | 出生日期(yyyy-MM-dd)必传 | String | applyPassenger | |
mobile | 手机号码 | String | applyPassenger | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | applyPassenger | |
电子邮箱 | String | applyPassenger | ||
phone | 固定电话 | String | applyPassenger | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | applyPassenger | |
CostList | 成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可 | Array[] | applyPassenger | |
costCenterName | 成本中心名称 | String | applyPassenger.CostList | |
certificatePhoto | 证件图片信息(只有国际机票使用,其他产品传null 或者不处理) | CertificatePhoto | applyPassenger | |
fileName | 文件名称 | String | applyPassenger.certificatePhoto | |
fileCode | 文件流 | String | applyPassenger.certificatePhoto | |
frequentTraveller | 常旅卡信息 | FrequentTraveller | applyPassenger | |
airlineCode | 航司二字码 | String | applyPassenger.frequentTraveller | |
cardName | 常旅卡名称 | String | applyPassenger.frequentTraveller | |
cardNumber | 常旅卡号 | String | applyPassenger.frequentTraveller | |
certificatesList | 证件 | Array[] | applyPassenger | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | applyPassenger.certificatesList | |
certNumber | 证件号码 | String | applyPassenger.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | applyPassenger.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | applyPassenger.certificatesList | |
passengerList | 旅客列表 | Array[] | 是 | |
outsidePassengerId | 对接方系统的旅客编号 | String | passengerList | |
passengerType | 旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿) | String | passengerList | |
companyId | 公司编号 | String | passengerList | |
sex | 必传 性别:男/女;不能传其他字符 | String | passengerList | |
cnName | 中文姓名(中文姓名、英文姓名2选一) | String | passengerList | |
enName | 英文姓名(中文姓名、英文姓名2选一,格式:zhang/san) | String | passengerList | |
dName | 部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | passengerList | |
nationality | 国籍:中国填写 CN,必传 | String | passengerList | |
birthday | 出生日期(yyyy-MM-dd)必传 | String | passengerList | |
mobile | 手机号码 | String | passengerList | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | passengerList | |
电子邮箱 | String | passengerList | ||
phone | 固定电话 | String | passengerList | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | passengerList | |
CostList | 成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可 | Array[] | passengerList | |
costCenterName | 成本中心名称 | String | passengerList.CostList | |
certificatePhoto | 证件图片信息(只有国际机票使用,其他产品传null 或者不处理) | CertificatePhoto | passengerList | |
fileName | 文件名称 | String | passengerList.certificatePhoto | |
fileCode | 文件流 | String | passengerList.certificatePhoto | |
frequentTraveller | 常旅卡信息 | FrequentTraveller | passengerList | |
airlineCode | 航司二字码 | String | passengerList.frequentTraveller | |
cardName | 常旅卡名称 | String | passengerList.frequentTraveller | |
cardNumber | 常旅卡号 | String | passengerList.frequentTraveller | |
certificatesList | 证件 | Array[] | passengerList | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | passengerList.certificatesList | |
certNumber | 证件号码 | String | passengerList.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | passengerList.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | passengerList.certificatesList |
{
"resultId":"fb2f091a18324cf2ac4910115ca006d8", //当前查询航班返回结果的唯一号
"tripId":"0dd2390dbc444224566da481f78bed43", //PM2023084添加 新版返回tripId代替flightId
"solutionId":"11c5a5d7a1234f84982a8ce2b2cae8dc", //PM2023084添加 方案Id
"opRemark":"无", //备注
"contactList":
[{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}], //联系人
"applyPassenger":"制单人信息(全API 对接可以不传,默认sessionid的登录人为制单人)", //制单人信息(全API 对接可以不传,默认sessionid的登录人为制单人),如需要明确制单人,则sessionid需要和传入的制单人一致;会涉及到订单的权限问题
"passengerList":
[{
"outsidePassengerId":"ak10002", //对接方系统的旅客编号
"passengerType":"成人", //旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿)
"companyId":"S118022", //公司编号
"sex":"男", //必传 性别:男/女;不能传其他字符
"cnName":"刘展超", //中文姓名(中文姓名、英文姓名2选一)
"enName":"liu/zhanchao", //英文姓名(中文姓名、英文姓名2选一,格式:zhang/san)
"dName":"美亚集团/旅游产品部/运营中心", //部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"nationality":"CN", //国籍:中国填写 CN,必传
"birthday":"2000-01-20", //出生日期(yyyy-MM-dd)必传
"mobile":"18628535565", //手机号码
"mobileAreaCode":"556", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"CostList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件
"phone":"020-82862903", //固定电话
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
"frequentTraveller":
{
"airlineCode":"MU", //航司二字码
"cardName":"东方明珠积分卡", //常旅卡名称
"cardNumber":"7894587775", //常旅卡号
}, //常旅卡信息
"certificatePhoto":
{
"fileName":"我的证件.jpg", //文件名称
"fileCode":"ADWHIFHWFJJSFJWFJ...", //文件流
}, //证件图片信息(只有国际机票使用,其他产品传null 或者不处理)
}], //旅客列表
"isSubmit":0, //是否提交 0 仅保存 1 保存并提交
"receivePayType":"2", //应收支付类型(1:在线消费 2:信用消费 3-预存款支付)
"oaSerialnumber":"SK9f739e45e010e", //外部出差申请单号
"isCheckedTicketNo":false, //是否继续预订(已校验过旅客未使用客票); 如果预订时返回:存在未使用客票:是否继续预订?
如接受继续预订,则传true,可以保存成功,跳过验证;
"bookType":"0", //0-因公 默认不传;1-因私; 目前只支持因公
"language":"EN", //非必填,默认为 ZH 中文,字段值参考:EN:英文、ZH:中国
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 报价单号(独立订单没有报价单号) | String | ||
orderKey | 解决方案信息 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
priceInfo | PAT信息,提交出票或者白名单下单失败则有最新价格信息 | IFlightAirfarePriceNew | ||
solutionId | 最新价,solutionId(创建订单返回6011,协议价白名单预订失败时会返回) | String | priceInfo | |
passengertype | 乘客类型,成人、儿童、婴儿 | String | priceInfo | |
basefare | 销售 -- 票面价 | Number | priceInfo | |
basefarecurrency | 结算币种 | String | priceInfo | |
tax | 销售 - 税 | Number | priceInfo | |
priceService | 服务费 | Number | priceInfo | |
psgrCount | 旅客人数 | Integer | priceInfo | |
rule | 客规和行李额数据 | AirRule | priceInfo | |
remark | 备注 | String | priceInfo.rule | |
SupplierService | 供应商服务内容 | PolicySupplierServiceDto | priceInfo.rule | |
Change | 改签 | SupplierServiceChangeDto | priceInfo.rule.SupplierService | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Change | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | priceInfo.rule.SupplierService.Change | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | priceInfo.rule.SupplierService.Change.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Change.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Change.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | priceInfo.rule.SupplierService.Change.ServiceTime | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Change.ServiceTime.All | |
Normals | 正常时间 | Array[] | priceInfo.rule.SupplierService.Change.ServiceTime.All | |
Specials | 特殊时间 | Array[] | priceInfo.rule.SupplierService.Change.ServiceTime.All | |
Refund | 退票 | SupplierServiceRefundDto | priceInfo.rule.SupplierService | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Refund | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | priceInfo.rule.SupplierService.Refund | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | priceInfo.rule.SupplierService.Refund.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Refund.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Refund.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | priceInfo.rule.SupplierService.Refund.ServiceTime | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Refund.ServiceTime.All | |
Normals | 正常时间 | Array[] | priceInfo.rule.SupplierService.Refund.ServiceTime.All | |
Specials | 特殊时间 | Array[] | priceInfo.rule.SupplierService.Refund.ServiceTime.All | |
Issue | 出票 | SupplierServiceIssueDto | priceInfo.rule.SupplierService | |
ServicerType | 服务商类型(0=美亚自营,1=供应商提供服务) | Integer | priceInfo.rule.SupplierService.Issue | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Issue | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | priceInfo.rule.SupplierService.Issue | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | priceInfo.rule.SupplierService.Issue.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Issue.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Issue.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | priceInfo.rule.SupplierService.Issue.ServiceTime | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Issue.ServiceTime.All | |
Normals | 正常时间 | Array[] | priceInfo.rule.SupplierService.Issue.ServiceTime.All | |
Specials | 特殊时间 | Array[] | priceInfo.rule.SupplierService.Issue.ServiceTime.All | |
Void | 作废 | SupplierServiceVoidDto | priceInfo.rule.SupplierService | |
IsCanVoid | 是否可以废票 | Boolean | priceInfo.rule.SupplierService.Void | |
VoidEffective | 作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认] | Integer | priceInfo.rule.SupplierService.Void | |
VoidTicketingDeadline | 废票截止时间 格式 yyyy-MM-ddTHH:mm:ss | String | priceInfo.rule.SupplierService.Void | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Void | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | priceInfo.rule.SupplierService.Void | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | priceInfo.rule.SupplierService.Void.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Void.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Void.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | priceInfo.rule.SupplierService.Void.ServiceTime | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Void.ServiceTime.All | |
Normals | 正常时间 | Array[] | priceInfo.rule.SupplierService.Void.ServiceTime.All | |
Specials | 特殊时间 | Array[] | priceInfo.rule.SupplierService.Void.ServiceTime.All | |
airRuleList | 退改条款详情 | Array[] | priceInfo.rule | |
origin | 运价起点城市三字码 | String | priceInfo.rule.airRuleList | |
destination | 运价终点城市三字码 | String | priceInfo.rule.airRuleList | |
minStay | 最短停留时间 | String | priceInfo.rule.airRuleList | |
maxStay | 最长停留时间 | String | priceInfo.rule.airRuleList | |
refund | 退票 | String | priceInfo.rule.airRuleList | |
change | 改签 | String | priceInfo.rule.airRuleList | |
delay | 延误 | String | priceInfo.rule.airRuleList | |
luggage | 行李额 | String | priceInfo.rule.airRuleList | |
NoshowRefunds | PM2023084添加 结构化退票规则 | Array[] | priceInfo.rule.airRuleList | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | priceInfo.rule.airRuleList.NoshowRefunds | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | priceInfo.rule.airRuleList.NoshowRefunds | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | priceInfo.rule.airRuleList.NoshowRefunds | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | priceInfo.rule.airRuleList.NoshowRefunds | |
Currency | 币种 | String | priceInfo.rule.airRuleList.NoshowRefunds | |
Text | 原文信息描述 | String | priceInfo.rule.airRuleList.NoshowRefunds | |
NoshowChanges | PM2023084添加 结构化改签规则 | Array[] | priceInfo.rule.airRuleList | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | priceInfo.rule.airRuleList.NoshowChanges | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | priceInfo.rule.airRuleList.NoshowChanges | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | priceInfo.rule.airRuleList.NoshowChanges | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | priceInfo.rule.airRuleList.NoshowChanges | |
Currency | 币种 | String | priceInfo.rule.airRuleList.NoshowChanges | |
Text | 原文信息描述 | String | priceInfo.rule.airRuleList.NoshowChanges | |
Refunds | PM2023084添加 退票规则详情 | Array[] | priceInfo.rule.airRuleList | |
TypeCode | 退票类型 可返值[before or after] | String | priceInfo.rule.airRuleList.Refunds | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | priceInfo.rule.airRuleList.Refunds | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | priceInfo.rule.airRuleList.Refunds | |
Fee | 退票罚金 | Number | priceInfo.rule.airRuleList.Refunds | |
Currency | 币种 | String | priceInfo.rule.airRuleList.Refunds | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Refunds | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Refunds | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Refunds | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Refunds | |
Text | 原文信息描述 | String | priceInfo.rule.airRuleList.Refunds | |
Changes | PM2023084添加 改签规则详情 | Array[] | priceInfo.rule.airRuleList | |
TypeCode | 退票类型 可返值[before or after] | String | priceInfo.rule.airRuleList.Changes | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | priceInfo.rule.airRuleList.Changes | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | priceInfo.rule.airRuleList.Changes | |
Fee | 退票罚金 | Number | priceInfo.rule.airRuleList.Changes | |
Currency | 币种 | String | priceInfo.rule.airRuleList.Changes | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Changes | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Changes | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Changes | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Changes | |
Text | 原文信息描述 | String | priceInfo.rule.airRuleList.Changes | |
luggageList | PM2023084添加 行李额 | Array[] | priceInfo.rule.airRuleList | |
flightNo | 航班号 | String | priceInfo.rule.airRuleList.luggageList | |
departureCityName | 出发城市名称 | String | priceInfo.rule.airRuleList.luggageList | |
arrivalCityName | 到达城市名称 | String | priceInfo.rule.airRuleList.luggageList | |
departureCityCode | 出发城市三字码 | String | priceInfo.rule.airRuleList.luggageList | |
arrivalCityCode | 到达城市三字码 | String | priceInfo.rule.airRuleList.luggageList | |
checkInLuggagePieces | 免费托运行李件数 | String | priceInfo.rule.airRuleList.luggageList | |
checkInLuggageWeight | 免费托运行李重量 | String | priceInfo.rule.airRuleList.luggageList | |
checkInLuggageDemision | 免费托运行李体积 | String | priceInfo.rule.airRuleList.luggageList | |
checkInLuggageText | 行李额描述(免费托运行李) 新增字段,长宽高文本 | String | priceInfo.rule.airRuleList.luggageList | |
handLuggagePieces | 手提行李件数,允许件数(免费手提行李) | String | priceInfo.rule.airRuleList.luggageList | |
handLuggageWeight | 允许重量(免费手提行李) | String | priceInfo.rule.airRuleList.luggageList | |
handLuggageDemision | 体积(免费手提行李) | String | priceInfo.rule.airRuleList.luggageList | |
handLuggageText | 行李额描述(免费手提行李)长宽高文本 | String | priceInfo.rule.airRuleList.luggageList | |
seatBag | 随身物品内容 | LuaggageStructDto | priceInfo.rule.airRuleList.luggageList | |
Pieces | String | priceInfo.rule.airRuleList.luggageList.seatBag | ||
Weight | String | priceInfo.rule.airRuleList.luggageList.seatBag | ||
Demision | String | priceInfo.rule.airRuleList.luggageList.seatBag | ||
Description | String | priceInfo.rule.airRuleList.luggageList.seatBag | ||
CheckStruct | 托运行李结构化 | LuaggageStructDto | priceInfo.rule.airRuleList.luggageList | |
Pieces | String | priceInfo.rule.airRuleList.luggageList.CheckStruct | ||
Weight | String | priceInfo.rule.airRuleList.luggageList.CheckStruct | ||
Demision | String | priceInfo.rule.airRuleList.luggageList.CheckStruct | ||
Description | String | priceInfo.rule.airRuleList.luggageList.CheckStruct | ||
HandStruct | 手提行李结构化 | LuaggageStructDto | priceInfo.rule.airRuleList.luggageList | |
Pieces | String | priceInfo.rule.airRuleList.luggageList.HandStruct | ||
Weight | String | priceInfo.rule.airRuleList.luggageList.HandStruct | ||
Demision | String | priceInfo.rule.airRuleList.luggageList.HandStruct | ||
Description | String | priceInfo.rule.airRuleList.luggageList.HandStruct |
{
"orderNo":"QT2300115286", //报价单号(独立订单没有报价单号)
"orderKey":"fb2f091a18324cf2ac4910115ca006d8_0dd2390dbc444224566da481f78bed43_11c5a5d7a1234f84982a8ce2b2cae8dc", //解决方案信息
"priceInfo":
{
"solutionId":"11c5a5d7a1234f84982a8ce2b2cae8dc", //最新价,solutionId(创建订单返回6011,协议价白名单预订失败时会返回)
"passengertype":"成人", //乘客类型,成人、儿童、婴儿
"basefare":2500, //销售 -- 票面价
"basefarecurrency":"CNY", //结算币种
"tax":1200, //销售 - 税
"priceService":100, //服务费
"psgrCount":1, //旅客人数
"rule":
{
"airRuleList":
[{
"origin":"BJS", //运价起点城市三字码
"destination":"SEL", //运价终点城市三字码
"minStay": "", //最短停留时间
"maxStay": "", //最长停留时间
"refund":"不允许", //退票
"change":"不允许", //改签
"delay":"误机发生后退票需额外收取误机费300元。误机发生后更改需额外收取误机费300元", //延误
"luggage":"北京(BJS)-青岛(TAO):托运免费行李:件数:2;托运说明:免费托运行李:2件。手持免费行李:件数:1;手持说明:免费手提行李:1件。青岛(TAO)-首尔(SEL):托运免费行李:件数:2;托运说明:免费托运行李:2件。手持免费行李:件数:1;手持说明:免费手提行李:1件。", //行李额
"luggageList":
[{
"flightNo": "", //航班号
"departureCityName":"北京", //出发城市名称
"arrivalCityName":"青岛", //到达城市名称
"departureCityCode":"BJS", //出发城市三字码
"arrivalCityCode":"TAO", //到达城市三字码
"checkInLuggagePieces":"2", //免费托运行李件数
"checkInLuggageWeight": "", //免费托运行李重量
"checkInLuggageDemision": "", //免费托运行李体积
"checkInLuggageText": "", //行李额描述(免费托运行李) 新增字段,长宽高文本
"handLuggagePieces":"1", //手提行李件数,允许件数(免费手提行李)
"handLuggageWeight": "", //允许重量(免费手提行李)
"handLuggageDemision": "", //体积(免费手提行李)
"handLuggageText": "", //行李额描述(免费手提行李)长宽高文本
"seatBag":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //随身物品内容
"CheckStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //托运行李结构化
"HandStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //手提行李结构化
}], //PM2023084添加 行李额
"Refunds":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //PM2023084添加 退票规则详情
"Changes":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //PM2023084添加 改签规则详情
"NoshowRefunds":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //PM2023084添加 结构化退票规则
"NoshowChanges":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //PM2023084添加 结构化改签规则
}], //退改条款详情
"remark":"无", //备注
"SupplierService":
{
"Issue":
{
"ServicerType":0, //服务商类型(0=美亚自营,1=供应商提供服务)
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //出票
"Change":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //改签
"Refund":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //退票
"Void":
{
"IsCanVoid":false, //是否可以废票
"VoidEffective":0, //作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认]
"VoidTicketingDeadline": "", //废票截止时间 格式 yyyy-MM-ddTHH:mm:ss
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //作废
}, //供应商服务内容
}, //客规和行李额数据
}, //PAT信息,提交出票或者白名单下单失败则有最新价格信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
出票前校验价格
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单号 | String | 是 | |
confirmPriceKey | 变价后且接受新价格,再次验价有值,非变价提交该参数不传 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"QT2300115286", //订单号
"confirmPriceKey": "", //变价后且接受新价格,再次验价有值,非变价提交该参数不传
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
isChangePrice | 是否变价 | Boolean | ||
isNoSeat | 是否没有座位 | Boolean | ||
newPrice | 新价格或新升舱费 | String | ||
oldPrice | 原价格或原升舱费 | String | ||
newTktDiffAmount | 新改签手续费 | String | ||
oldTktDiffAmount | 原改签手续费 | String | ||
newTax | 新税费 | String | ||
oldTax | 原税费 | String | ||
isChangeRule | 是否发生条款变更(国际机票有可能价格不变,退改条款发生变化,也需要用户确认) | Boolean | ||
newRule | 新条款 | String | ||
confirmPriceKey | 用于确认价格的key | String | ||
isInsurance | 是否有保险 | Boolean | ||
insuranceOrderNo | 保险单号 | Array[] | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"isChangePrice":false, //是否变价
"isNoSeat":false, //是否没有座位
"newPrice": "", //新价格或新升舱费
"oldPrice": "", //原价格或原升舱费
"newTktDiffAmount": "", //新改签手续费
"oldTktDiffAmount": "", //原改签手续费
"newTax": "", //新税费
"oldTax": "", //原税费
"isChangeRule":false, //是否发生条款变更(国际机票有可能价格不变,退改条款发生变化,也需要用户确认)
"newRule": "", //新条款
"confirmPriceKey": "", //用于确认价格的key
"isInsurance":false, //是否有保险
"insuranceOrderNo":[], //保险单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
改签问询,2025-03-20添加
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
QuotationNo | 报价单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"QuotationNo":"QT250001458", //报价单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
ChangeInquiryId | 改签id | String | ||
IsChangeAll | 所有航段是否必须一起改 | Boolean | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
SegmentPassengers | 航段+旅客 | Array[] | ||
IsUsed | 是否已使用 | Boolean | SegmentPassengers | |
IsFlightChange | 是否航变 | Boolean | SegmentPassengers | |
Changeable | 是否可改签 | ChangeInquirySegmentPassengerChangeableDto | SegmentPassengers | |
IsCanChange | 是否可改签 | Boolean | SegmentPassengers.Changeable | |
CannotChangeReasonCode | 不可改签原因 0: 允许 1:已退票 2:已使用 3: 不允许退票 4: 票无效 5: 已值机 6: 已改签 7:已升舱 8:其他 | Integer | SegmentPassengers.Changeable | |
CannotChangeReasonText | 不可改签原因文本 | String | SegmentPassengers.Changeable | |
Segment | 航段信息 | ChangeInquirySegmentDto | SegmentPassengers | |
FlightNo | 航班号 | String | SegmentPassengers.Segment | |
DepartureDate | 出发日期 yyyy-MM-dd | String | SegmentPassengers.Segment | |
Sequence | 航段序号 | Integer | SegmentPassengers.Segment | |
JourneyIndex | 行程序号(从1开始的自然数。表示第几个航程) | Integer | SegmentPassengers.Segment | |
Details | 改签明细 | Array[] | SegmentPassengers | |
ChangeType |
改签类型(1=自愿,2=非自愿)
添加日期: 2025-03-25 |
Integer | SegmentPassengers.Details | |
ChangeFeeType |
改签费用类型(1: 费用待确认 2: 费用已确认)
添加日期: 2025-03-25 |
Integer | SegmentPassengers.Details | |
ChangeFee |
改签罚金
添加日期: 2025-03-25 |
Number | SegmentPassengers.Details | |
ChangeFlightDateFrom | 可改航变范围开始时间 格式:YYYY-MM-DD | String | SegmentPassengers.Details | |
ChangeFlightDateTo | 可改航变范围结束时间 格式:YYYY-MM-DD | String | SegmentPassengers.Details | |
Passenger | 旅客 | ChangeInquiryPassengerDto | SegmentPassengers | |
PassengerCode |
旅客编号
添加日期: 2025-03-25 |
String | SegmentPassengers.Passenger | |
PassengerName |
旅客名称
添加日期: 2025-03-25 |
String | SegmentPassengers.Passenger | |
OutsidePassengerCode |
外部客户旅客编号
添加日期: 2025-03-27 |
String | SegmentPassengers.Passenger | |
CertificateType |
旅客证件号
添加日期: 2025-03-27 |
String | SegmentPassengers.Passenger | |
CertificateID |
旅客证件号
添加日期: 2025-03-27 |
String | SegmentPassengers.Passenger | |
TicketNo |
客票
添加日期: 2025-03-25 |
String | SegmentPassengers.Passenger |
{
"ChangeInquiryId":"MU55689288521", //改签id
"SegmentPassengers":
[{
"Segment":
{
"FlightNo":"MU556", //航班号
"DepartureDate":"2025-05-25", //出发日期 yyyy-MM-dd
"Sequence":1, //航段序号
"JourneyIndex":1, //行程序号(从1开始的自然数。表示第几个航程)
}, //航段信息
"Passenger":
{
"PassengerCode":"8992373", //旅客编号
"PassengerName":"Lin/xueyang", //旅客名称
"OutsidePassengerCode":"8955825512", //外部客户旅客编号
"CertificateType":"护照", //旅客证件号
"CertificateID":"EB2453424", //旅客证件号
"TicketNo":"85066658711", //客票
}, //旅客
"IsUsed":false, //是否已使用
"IsFlightChange":false, //是否航变
"Details":
[{
"ChangeType":1, //改签类型(1=自愿,2=非自愿)
"ChangeFeeType":1, //改签费用类型(1: 费用待确认 2: 费用已确认)
"ChangeFee":500, //改签罚金
"ChangeFlightDateFrom":"2025-05-25", //可改航变范围开始时间 格式:YYYY-MM-DD
"ChangeFlightDateTo":"2025-05-26", //可改航变范围结束时间 格式:YYYY-MM-DD
}], //改签明细
"Changeable":
{
"IsCanChange":false, //是否可改签
"CannotChangeReasonCode":8, //不可改签原因 0: 允许 1:已退票 2:已使用 3: 不允许退票 4: 票无效 5: 已值机 6: 已改签 7:已升舱 8:其他
"CannotChangeReasonText":"MU556不可改签,只可退票", //不可改签原因文本
}, //是否可改签
}], //航段+旅客
"IsChangeAll":true, //所有航段是否必须一起改
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国际机票改签航班查询
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
originalOrderNo | 原单号 | String | 是 | |
passengerList | 原单旅客外部编号 | Array[] | 是 | |
isFirstDirectFlight | 是否直飞优先 | Boolean | 否 | |
involuntary | 变更类型(1=自愿,2=非自愿) | String | 是 | |
classLevels | 舱等(经济舱 = 1,公务舱 = 2,头等舱 = 3,豪华经济舱 = 4) | Array[] | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
oldSegmentInfo | 原航班信息 | Array[] | 是 | |
journeyIndex | 行程序号(订单详细获取) | String | oldSegmentInfo | |
originDestinations | 需要改签的行程信息 | Array[] | 是 | |
journeyIndex | 行程序号(订单详细获取) | String | originDestinations | |
departureDate | 出发日期 yyyy-MM-dd | String | originDestinations |
{
"originalOrderNo": "",
"passengerList":[],
"oldSegmentInfo":
[{
"journeyIndex": ""
}],
"isFirstDirectFlight":false,
"involuntary": "",
"classLevels":[],
"originDestinations":
[{
"journeyIndex": "",
"departureDate": ""
}],
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
searchId | 搜索Id | String | ||
isOnLineChange | 是否支持在线改签 | Boolean | ||
isNotOnLineDescription | 不可在线改签原因 | String | ||
involuntary | 更类型限制(1=自愿,2=非自愿,其他为不限) | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
trips | 行程组合 | Array[] | ||
tripId | 行程组合ID | String | trips | |
isDirectFlight | 是否直飞 | Boolean | trips | |
platingCarrier | 销售航司 | String | trips | |
journeys | 行程;单程只有一个journeys,往返程两个journeys,多程会有多个journeys。 | Array[] | trips | |
journeyIndex | 行程序号(从1开始的自然数。表示第几个航程) | String | trips.journeys | |
journeyType | 行程类型,(1=去程,2=回程) | String | trips.journeys | |
flights | 航班 | Array[] | trips.journeys | |
flightId | 航班id | String | trips.journeys.flights | |
departureModifyDays | 本航段的起飞日期修正,例如+1表示第二天 | String | trips.journeys.flights | |
arrivalModifyDays | 得到本航段的到达日期修正,例如+1表示第二天 | String | trips.journeys.flights | |
visaType | 过境签类型 1 需要过境签 2可能需过境签 3不需要过境签 4其它 | String | trips.journeys.flights | |
visaContent | 非必输 String 过境签内容说明 | String | trips.journeys.flights | |
luggageHangingType | 行李直挂类型 1不允许直挂 2允许直挂明细规则 3未知 | String | trips.journeys.flights | |
stops | 经停信息 | Array[] | trips.journeys.flights | |
airportCode | 经停机场 | String | trips.journeys.flights.stops | |
visaType | 过境签类型 1 需要过境签 2可能需过境签 3不需要过境签 4其它 | String | trips.journeys.flights.stops | |
visaContent | 非必输 String 过境签内容说明 | String | trips.journeys.flights.stops | |
luggageHangingType | 行李直挂类型 1不允许直挂 2允许直挂明细规则 3未知 | String | trips.journeys.flights.stops | |
amenities | 机上设施 | Array[] | trips.journeys.flights | |
classLevel | 舱等 | String | trips.journeys.flights.amenities | |
beverageId | 当前航班酒水饮料信息关联ID | String | trips.journeys.flights.amenities | |
entertainmentId | 当前航班娱乐信息关联ID | String | trips.journeys.flights.amenities | |
foodId | 当前航班餐食信息关联ID | String | trips.journeys.flights.amenities | |
layoutId | 当前航班座位位置信息关联ID | String | trips.journeys.flights.amenities | |
powerId | 当前航班电源信息关联ID | String | trips.journeys.flights.amenities | |
seatId | 当前航班座位空间信息关联ID | String | trips.journeys.flights.amenities | |
wifiId | 当前航班wifi信息关联ID | String | trips.journeys.flights.amenities | |
solutions | 新的方案信息 | Array[] | trips | |
solutionId | 解决方案Id | String | trips.solutions | |
solutionName | 解决方案名称(例如,灵活、标准、经济舱、经济舱+公务舱等) | String | trips.solutions | |
ticketTimeLimit | 出票时间限制(yyyy-MM-dd HH:mm:ss) | String | trips.solutions | |
isNeedPricing | 是否验价 | Boolean | trips.solutions | |
travelPolicyProcessType | 差旅政策处理结果; 0=符合政策,1=违反建议性政策,2=违反强制性政策,3=未设置政策,空=不显示差旅政策 | String | trips.solutions | |
travelPolicyPayType | 差标指定支付类型 1:在线消费 空不指定 | String | trips.solutions | |
prices | 解决方案价格,按旅客类型划分(暂时只有一个,类型为成人) | Array[] | trips.solutions | |
passengerTypeCode | 旅客类型(ADT/CHD/INF) | String | trips.solutions.prices | |
sell | 销售价 | ApiIntairTicketBookingChangeTripSolutionPriceSellDto | trips.solutions.prices | |
currency | 结算币种 | String | trips.solutions.prices.sell | |
currencyRate | 汇率 | Number | trips.solutions.prices.sell | |
baseFare | 票面价 | Number | trips.solutions.prices.sell | |
tax | 税 | Number | trips.solutions.prices.sell | |
serviceFee | 服务费 | Number | trips.solutions.prices.sell | |
upgradeFee | 升舱费 | Number | trips.solutions.prices.sell | |
taxMargin | 税差 | Number | trips.solutions.prices.sell | |
changeFee | 改期手续费 | Number | trips.solutions.prices.sell | |
total | 合计 | Number | trips.solutions.prices.sell | |
clazzs | 舱位信息 | Array[] | trips.solutions | |
flightId | 航班id | String | trips.solutions.clazzs | |
clazzNo | 舱位 | String | trips.solutions.clazzs | |
classLevel | 舱等 | String | trips.solutions.clazzs | |
seatNo | 座位数 | String | trips.solutions.clazzs | |
fareBasisCode | fareBasisCode | String | trips.solutions.clazzs | |
flights | 航班信息 | Array[] | ||
flightId | 航班id | String | flights | |
isCodeShare | 是否共享航班 | Boolean | flights | |
equipmentCode | 机型代码 | String | flights | |
equipmentName | 机型类别名称 | String | flights | |
equipmentBodyName | 机体(窄体宽体) | String | flights | |
equipmentType | 航班载体类型(0=飞机,1=火车,2=汽车,3=船) | String | flights | |
duration | 飞行时间 HH:mm | String | flights | |
distance | 飞行距离,单位为KM | String | flights | |
marketing | 市场航司 | ApiIntairTicketBookingFlightAirlineDto | flights | |
airlineCode | 航司代码 | String | flights.marketing | |
airlineName | 航司名称 | String | flights.marketing | |
flightNumber | 航班号 | String | flights.marketing | |
operating | 执飞航司 | ApiIntairTicketBookingFlightAirlineDto | flights | |
airlineCode | 航司代码 | String | flights.operating | |
airlineName | 航司名称 | String | flights.operating | |
flightNumber | 航班号 | String | flights.operating | |
stops | 经停信息 | Array[] | flights | |
airportCode | 经停机场 | String | flights.stops | |
airportName | 经停机场名称 | String | flights.stops | |
cityCode | 经停城市 | String | flights.stops | |
cityName | 经停城市名称 | String | flights.stops | |
duration | 经停时长 HH:mm | String | flights.stops | |
departure | 出发地 | ApiIntairTicketBookingFlightLocationTimeDto | flights | |
airportCode | 机场三字码 | String | flights.departure | |
airportName | 机场名称 | String | flights.departure | |
cityCode | 城市三字码 | String | flights.departure | |
cityName | 城市名称 | String | flights.departure | |
time | 日期和时间 | String | flights.departure | |
term | 航站楼 | String | flights.departure | |
arrival | 目的地 | ApiIntairTicketBookingFlightLocationTimeDto | flights | |
airportCode | 机场三字码 | String | flights.arrival | |
airportName | 机场名称 | String | flights.arrival | |
cityCode | 城市三字码 | String | flights.arrival | |
cityName | 城市名称 | String | flights.arrival | |
time | 日期和时间 | String | flights.arrival | |
term | 航站楼 | String | flights.arrival |
{
"searchId": "",
"isOnLineChange":false,
"isNotOnLineDescription": "",
"involuntary": "",
"flights":
[{
"flightId": "",
"departure":
{
"airportCode": "",
"airportName": "",
"cityCode": "",
"cityName": "",
"time": "",
"term": ""
},
"arrival":
{
"airportCode": "",
"airportName": "",
"cityCode": "",
"cityName": "",
"time": "",
"term": ""
},
"marketing":
{
"airlineCode": "",
"airlineName": "",
"flightNumber": ""
},
"operating":
{
"airlineCode": "",
"airlineName": "",
"flightNumber": ""
},
"isCodeShare":false,
"equipmentCode": "",
"equipmentName": "",
"equipmentBodyName": "",
"equipmentType": "",
"duration": "",
"distance": "",
"stops":
[{
"airportCode": "",
"airportName": "",
"cityCode": "",
"cityName": "",
"duration": ""
}]
}],
"trips":
[{
"tripId": "",
"journeys":
[{
"journeyIndex": "",
"journeyType": "",
"flights":
[{
"flightId": "",
"amenities":
[{
"classLevel": "",
"beverageId": "",
"entertainmentId": "",
"foodId": "",
"layoutId": "",
"powerId": "",
"seatId": "",
"wifiId": ""
}],
"departureModifyDays": "",
"arrivalModifyDays": "",
"visaType": "",
"visaContent": "",
"luggageHangingType": "",
"stops":
[{
"airportCode": "",
"visaType": "",
"visaContent": "",
"luggageHangingType": ""
}]
}]
}],
"solutions":
[{
"solutionId": "",
"solutionName": "",
"ticketTimeLimit": "",
"isNeedPricing":false,
"travelPolicyProcessType": "",
"travelPolicyPayType": "",
"prices":
[{
"passengerTypeCode": "",
"sell":
{
"currency": "",
"currencyRate":0,
"baseFare":0,
"tax":0,
"serviceFee":0,
"upgradeFee":0,
"taxMargin":0,
"changeFee":0,
"total":0
}
}],
"clazzs":
[{
"flightId": "",
"clazzNo": "",
"classLevel": "",
"seatNo": "",
"fareBasisCode": ""
}]
}],
"isDirectFlight":false,
"platingCarrier": ""
}],
"code":"10000",
"description":"请求成功"
}
国际机票获取改签条款
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
searchId | 搜索Id 改签航班查询返回 | String | 是 | |
tripId | 行程组合ID 改签航班查询返回 | String | 是 | |
solutionId | 解决方案Id 改签航班查询返回 | String | 是 | |
isGetCompareRule | 是否获取比对条款 | Boolean | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"searchId": "",
"tripId": "",
"solutionId": "",
"isGetCompareRule":false,
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
ruleTags | 条款标记,可退票/不可退票/允许退票/可变更/不可变更/允许变更 | Array[] | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
fares | 运价 | Array[] | ||
journeyIndexs | 行程序号(存在多个) | Array[] | fares | |
journeyType | 行程类型,(1=去程,2=回程) | String | fares | |
departureCityName | 出发城市名称 | String | fares | |
arrivalCityName | 目的城市名称 | String | fares | |
departureCode | 出发地三字码 | String | fares | |
arrivalCode | 目的地三字码 | String | fares | |
rule | 条款信息 | ApiIntairTicketBookingSolutionRuleDto | fares | |
refund | 退票 | String | fares.rule | |
change | 改签 | String | fares.rule | |
noShow | 误机 | String | fares.rule | |
minStay | 最短停留 | String | fares.rule | |
maxStay | 最长停留 | String | fares.rule | |
otherInfo | 其他说明 | String | fares.rule | |
compareRule | 比对条款 | ApiIntairTicketBookingSolutionRuleDto | fares | |
refund | 退票 | String | fares.compareRule | |
change | 改签 | String | fares.compareRule | |
noShow | 误机 | String | fares.compareRule | |
minStay | 最短停留 | String | fares.compareRule | |
maxStay | 最长停留 | String | fares.compareRule | |
otherInfo | 其他说明 | String | fares.compareRule | |
flights | 运价航班信息(行李额) | Array[] | fares | |
flightId | String | fares.flights | ||
flightNo | 航班号 | String | fares.flights | |
departureCityName | 出发城市名称 | String | fares.flights | |
arrivalCityName | 目的城市名称 | String | fares.flights | |
departureCityCode | 出发城市三字码 | String | fares.flights | |
arrivalCityCode | 目的城市三字码 | String | fares.flights | |
visaType | 过境签类型 1 需要过境签 2可能需过境签 3不需要过境签 4其它 | String | fares.flights | |
visaContent | 非必输 String 过境签内容说明 | String | fares.flights | |
luggageHangingType | 行李直挂类型 1不允许直挂 2允许直挂明细规则 3未知 | String | fares.flights | |
luaggage | 行李信息 | ApiIntairTicketBookingLuaggageDto | fares.flights | |
checkContent | 托运行李内容 | String | fares.flights.luaggage | |
handContent | 手提行李内容 | String | fares.flights.luaggage | |
checkStruct | 托运行李结构化 | ApiIntairTicketBookingLuaggageStructDto | fares.flights.luaggage | |
pieces | 手持免费行李件数 | String | fares.flights.luaggage.checkStruct | |
weight | 手持免费行李重量 | String | fares.flights.luaggage.checkStruct | |
demision | 手持免费行李体积 | String | fares.flights.luaggage.checkStruct | |
description | 手持免费行李描述 | String | fares.flights.luaggage.checkStruct | |
handStruct | 手提行李结构化 | ApiIntairTicketBookingLuaggageStructDto | fares.flights.luaggage | |
pieces | 手持免费行李件数 | String | fares.flights.luaggage.handStruct | |
weight | 手持免费行李重量 | String | fares.flights.luaggage.handStruct | |
demision | 手持免费行李体积 | String | fares.flights.luaggage.handStruct | |
description | 手持免费行李描述 | String | fares.flights.luaggage.handStruct |
{
"fares":
[{
"journeyIndexs":[],
"journeyType": "",
"departureCityName": "",
"arrivalCityName": "",
"departureCode": "",
"arrivalCode": "",
"rule":
{
"refund": "",
"change": "",
"noShow": "",
"minStay": "",
"maxStay": "",
"otherInfo": ""
},
"flights":
[{
"flightId": "",
"flightNo": "",
"departureCityName": "",
"arrivalCityName": "",
"departureCityCode": "",
"arrivalCityCode": "",
"luaggage":
{
"checkContent": "",
"handContent": "",
"checkStruct":
{
"pieces": "",
"weight": "",
"demision": "",
"description": ""
},
"handStruct":
{
"pieces": "",
"weight": "",
"demision": "",
"description": ""
}
},
"visaType": "",
"visaContent": "",
"luggageHangingType": ""
}],
"compareRule":
{
"refund": "",
"change": "",
"noShow": "",
"minStay": "",
"maxStay": "",
"otherInfo": ""
}
}],
"ruleTags":[],
"code":"10000",
"description":"请求成功"
}
国际机票改签验价
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
searchId | 搜索Id 改签航班查询返回 | String | 是 | |
tripId | 行程组合ID 改签航班查询返回 | String | 是 | |
solutionId | 解决方案Id 改签航班查询返回 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"searchId": "",
"tripId": "",
"solutionId": "",
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
isChangePrice | 是否变价 | Boolean | ||
isChangeCabin | 是否变舱 | Boolean | ||
isChangeFlight | 航班信息是否变更 | Boolean | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
solution | 新的方案信息 | ApiIntairTicketBookingChangeTripSolutionDto | ||
solutionId | 解决方案Id | String | solution | |
solutionName | 解决方案名称(例如,灵活、标准、经济舱、经济舱+公务舱等) | String | solution | |
ticketTimeLimit | 出票时间限制(yyyy-MM-dd HH:mm:ss) | String | solution | |
isNeedPricing | 是否验价 | Boolean | solution | |
travelPolicyProcessType | 差旅政策处理结果; 0=符合政策,1=违反建议性政策,2=违反强制性政策,3=未设置政策,空=不显示差旅政策 | String | solution | |
travelPolicyPayType | 差标指定支付类型 1:在线消费 空不指定 | String | solution | |
prices | 解决方案价格,按旅客类型划分(暂时只有一个,类型为成人) | Array[] | solution | |
passengerTypeCode | 旅客类型(ADT/CHD/INF) | String | solution.prices | |
sell | 销售价 | ApiIntairTicketBookingChangeTripSolutionPriceSellDto | solution.prices | |
currency | 结算币种 | String | solution.prices.sell | |
currencyRate | 汇率 | Number | solution.prices.sell | |
baseFare | 票面价 | Number | solution.prices.sell | |
tax | 税 | Number | solution.prices.sell | |
serviceFee | 服务费 | Number | solution.prices.sell | |
upgradeFee | 升舱费 | Number | solution.prices.sell | |
taxMargin | 税差 | Number | solution.prices.sell | |
changeFee | 改期手续费 | Number | solution.prices.sell | |
total | 合计 | Number | solution.prices.sell | |
clazzs | 舱位信息 | Array[] | solution | |
flightId | 航班id | String | solution.clazzs | |
clazzNo | 舱位 | String | solution.clazzs | |
classLevel | 舱等 | String | solution.clazzs | |
seatNo | 座位数 | String | solution.clazzs | |
fareBasisCode | fareBasisCode | String | solution.clazzs | |
flights | 最新航班信息 | Array[] | ||
flightId | 航班id | String | flights | |
isCodeShare | 是否共享航班 | Boolean | flights | |
equipmentCode | 机型代码 | String | flights | |
equipmentName | 机型类别名称 | String | flights | |
equipmentBodyName | 机体(窄体宽体) | String | flights | |
equipmentType | 航班载体类型(0=飞机,1=火车,2=汽车,3=船) | String | flights | |
duration | 飞行时间 HH:mm | String | flights | |
distance | 飞行距离,单位为KM | String | flights | |
marketing | 市场航司 | ApiIntairTicketBookingFlightAirlineDto | flights | |
airlineCode | 航司代码 | String | flights.marketing | |
airlineName | 航司名称 | String | flights.marketing | |
flightNumber | 航班号 | String | flights.marketing | |
operating | 执飞航司 | ApiIntairTicketBookingFlightAirlineDto | flights | |
airlineCode | 航司代码 | String | flights.operating | |
airlineName | 航司名称 | String | flights.operating | |
flightNumber | 航班号 | String | flights.operating | |
stops | 经停信息 | Array[] | flights | |
airportCode | 经停机场 | String | flights.stops | |
airportName | 经停机场名称 | String | flights.stops | |
cityCode | 经停城市 | String | flights.stops | |
cityName | 经停城市名称 | String | flights.stops | |
duration | 经停时长 HH:mm | String | flights.stops | |
departure | 出发地 | ApiIntairTicketBookingFlightLocationTimeDto | flights | |
airportCode | 机场三字码 | String | flights.departure | |
airportName | 机场名称 | String | flights.departure | |
cityCode | 城市三字码 | String | flights.departure | |
cityName | 城市名称 | String | flights.departure | |
time | 日期和时间 | String | flights.departure | |
term | 航站楼 | String | flights.departure | |
arrival | 目的地 | ApiIntairTicketBookingFlightLocationTimeDto | flights | |
airportCode | 机场三字码 | String | flights.arrival | |
airportName | 机场名称 | String | flights.arrival | |
cityCode | 城市三字码 | String | flights.arrival | |
cityName | 城市名称 | String | flights.arrival | |
time | 日期和时间 | String | flights.arrival | |
term | 航站楼 | String | flights.arrival |
{
"isChangePrice":false,
"isChangeCabin":false,
"isChangeFlight":false,
"solution":
{
"solutionId": "",
"solutionName": "",
"ticketTimeLimit": "",
"isNeedPricing":false,
"travelPolicyProcessType": "",
"travelPolicyPayType": "",
"prices":
[{
"passengerTypeCode": "",
"sell":
{
"currency": "",
"currencyRate":0,
"baseFare":0,
"tax":0,
"serviceFee":0,
"upgradeFee":0,
"taxMargin":0,
"changeFee":0,
"total":0
}
}],
"clazzs":
[{
"flightId": "",
"clazzNo": "",
"classLevel": "",
"seatNo": "",
"fareBasisCode": ""
}]
},
"flights":
[{
"flightId": "",
"departure":
{
"airportCode": "",
"airportName": "",
"cityCode": "",
"cityName": "",
"time": "",
"term": ""
},
"arrival":
{
"airportCode": "",
"airportName": "",
"cityCode": "",
"cityName": "",
"time": "",
"term": ""
},
"marketing":
{
"airlineCode": "",
"airlineName": "",
"flightNumber": ""
},
"operating":
{
"airlineCode": "",
"airlineName": "",
"flightNumber": ""
},
"isCodeShare":false,
"equipmentCode": "",
"equipmentName": "",
"equipmentBodyName": "",
"equipmentType": "",
"duration": "",
"distance": "",
"stops":
[{
"airportCode": "",
"airportName": "",
"cityCode": "",
"cityName": "",
"duration": ""
}]
}],
"code":"10000",
"description":"请求成功"
}
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsideOrderNo | 外部订单号 | String | 是 | |
originalOrderNo | 美亚原订购单号 | String | 是 | |
opRemark | 备注 | String | 否 | |
passengerList | 旅客列表 | Array[] | 是 | |
receivePayType | 应收支付类型(1:在线消费 2:信用消费);3-预存款支付(2023-09-25加) | String | 否 | |
searchId |
航班Id
改签航班查询返回字段
添加日期: 2025-03-03 |
String | 否 | |
tripId |
行程组合Id
改签航班查询返回字段
添加日期: 2025-03-03 |
String | 否 | |
solutionId |
解决方案Id
改签航班查询返回字段
添加日期: 2025-03-03 |
String | 否 | |
involuntary |
变更类型(1=自愿,2=非自愿)默认 1
添加日期: 2025-04-10 |
String | 否 | |
reasonText |
变更原因(长度150以内)
添加日期: 2025-04-10 |
String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
contactInfo | 联系人信息 | ContactInfo | 是 | |
contactName | 联系人 | String | contactInfo | |
mobile | 手机号码 | String | contactInfo | |
phone | 联系电话 | String | contactInfo | |
电子邮件 | String | contactInfo | ||
flightList | 需要改签的航班 | Array[] | 是 | |
journeyIndex | 行程序号(订单详细获取) 优先传这个,剩下可以不传 | String | flightList | |
segmentNo | 航段序号,如果序号有传,下面其他参数可不传; 2022-11-30生效 优先使用 journeyIndex | Integer | flightList | |
departureDate | 出发日期 格式:yyyy-MM-dd | String | flightList | |
departureTime | 出发时间 格式:HH:mm | String | flightList | |
flightNo | 航班号 | String | flightList | |
originCityCode | 出发城市三字码 | String | flightList | |
destinationCityCode | 到达城市三字码 | String | flightList | |
passengerChargeList |
费用信息
添加日期: 2025-03-03 |
Array[] | 否 | |
outsidePassengerId | 旅客编号是指对接方系统的旅客编号 | String | passengerChargeList | |
passengerType | 旅客类型 | String | passengerChargeList | |
upgradeCharge | 升舱费(单人费用) | Number | passengerChargeList | |
changeCharge | 变更手续费(单人费用) | Number | passengerChargeList | |
taxDifference | 税差(单人费用) | Number | passengerChargeList | |
serviceCharge | 服务费(单人费用) | Number | passengerChargeList | |
totalCharge | 合计费用(全部旅客费用合计) | Number | passengerChargeList |
{
"outsideOrderNo":"1125925467140981", //外部订单号
"originalOrderNo":"QT2300113295", //美亚原订购单号
"opRemark":"无", //备注
"flightList":
[{
"journeyIndex": "", //行程序号(订单详细获取)
优先传这个,剩下可以不传
"segmentNo":0, //航段序号,如果序号有传,下面其他参数可不传; 2022-11-30生效
优先使用 journeyIndex
"departureDate":"2023-10-28", //出发日期 格式:yyyy-MM-dd
"departureTime":"23:30", //出发时间 格式:HH:mm
"flightNo":"MU5070", //航班号
"originCityCode":"CGK", //出发城市三字码
"destinationCityCode":"PVG", //到达城市三字码
}], //需要改签的航班
"passengerList":"[“P4386785”]", //旅客列表
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"receivePayType":"2", //应收支付类型(1:在线消费 2:信用消费);3-预存款支付(2023-09-25加)
"passengerChargeList":
[{
"outsidePassengerId": "", //旅客编号是指对接方系统的旅客编号
"passengerType": "", //旅客类型
"upgradeCharge":0, //升舱费(单人费用)
"changeCharge":0, //变更手续费(单人费用)
"taxDifference":0, //税差(单人费用)
"serviceCharge":0, //服务费(单人费用)
"totalCharge":0, //合计费用(全部旅客费用合计)
}], //费用信息
"searchId": "", //航班Id
改签航班查询返回字段
"tripId": "", //行程组合Id
改签航班查询返回字段
"solutionId": "", //解决方案Id
改签航班查询返回字段
"involuntary": "", //变更类型(1=自愿,2=非自愿)默认 1
"reasonText": "", //变更原因(长度150以内)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 订单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo":"QC2300005286", //订单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
退票问询,2025-03-20添加
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
QuotationNo | 报价单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"QuotationNo":"QT250001458", //报价单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
RefundInquiryId | 退票id | String | ||
IsRefundAll | 所有航段是否必须一起退 | Boolean | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
SegmentPassengers | 退票航段+旅客 | Array[] | ||
IsUsed | 是否已使用 | Boolean | SegmentPassengers | |
IsFlightChange | 是否航变 | Boolean | SegmentPassengers | |
Passenger | 旅客 | RefundInquiryPassengerDto | SegmentPassengers | |
PassengerCode | 旅客编号 | String | SegmentPassengers.Passenger | |
PassengerName | 旅客名称 | String | SegmentPassengers.Passenger | |
TicketNo | 客票 | String | SegmentPassengers.Passenger | |
Refundable | 是否可退 | RefundInquirySegmentPassengerRefundableDto | SegmentPassengers | |
IsCanRefund | 是否可退 | Boolean | SegmentPassengers.Refundable | |
CannotRefundReasonCode | 不可退票原因 0: 允许 1:已退票 2:已使用 3: 不允许退票 4: 票无效 5: 已值机 6: 已改签 7:已升舱 8:其他 | Integer | SegmentPassengers.Refundable | |
CannotRefundReasonText | 不可退票原因文本 | String | SegmentPassengers.Refundable | |
Segment | 航段信息 | RefundInquirySegmentDto | SegmentPassengers | |
FlightNo | 航班号 | String | SegmentPassengers.Segment | |
DepartureDate | 出发日期 yyyy-MM-dd | String | SegmentPassengers.Segment | |
Sequence | 航段序号 | Integer | SegmentPassengers.Segment | |
JourneyIndex | 行程序号(从1开始的自然数。表示第几个航程) | Integer | SegmentPassengers.Segment | |
Details | 退票明细 | Array[] | SegmentPassengers | |
RefundType | 退票类型(1=自愿,2=非自愿) | Integer | SegmentPassengers.Details | |
RefundChangeFeeType | 退改费用类型(1: 费用待确认 2: 费用已确认) | Integer | SegmentPassengers.Details | |
currency | 结算币种 | String | SegmentPassengers.Details | |
Fee | 费用 | RefundInquiryDetailFee | SegmentPassengers.Details | |
Sell | 收入 | GetRefundFeePriceSellDto | SegmentPassengers.Details.Fee | |
Currency | 币种 | String | SegmentPassengers.Details.Fee.Sell | |
RefundCommission | 退票手续费 | Number | SegmentPassengers.Details.Fee.Sell | |
ServiceFee | 服务费 | Number | SegmentPassengers.Details.Fee.Sell | |
UseSegmentFee | 已使用航段费 | Number | SegmentPassengers.Details.Fee.Sell | |
UsedTax | 已使用税费 | Number | SegmentPassengers.Details.Fee.Sell | |
UsedBaseFare | 已使用票价 | Number | SegmentPassengers.Details.Fee.Sell | |
RefundAmount | 可退金额 | Number | SegmentPassengers.Details.Fee.Sell |
{
"RefundInquiryId":"111284485844", //退票id
"SegmentPassengers":
[{
"Segment":
{
"FlightNo":"MU560", //航班号
"DepartureDate":"2025-05-08", //出发日期 yyyy-MM-dd
"Sequence":1, //航段序号
"JourneyIndex":1, //行程序号(从1开始的自然数。表示第几个航程)
}, //航段信息
"Passenger":
{
"PassengerCode":"887594122", //旅客编号
"PassengerName":"Lin/xueyang", //旅客名称
"TicketNo":"85066855874", //客票
}, //旅客
"IsUsed":false, //是否已使用
"IsFlightChange":false, //是否航变
"Details":
[{
"RefundType":1, //退票类型(1=自愿,2=非自愿)
"RefundChangeFeeType":2, //退改费用类型(1: 费用待确认 2: 费用已确认)
"Fee":
{
"Sell":
{
"Currency":"CNY", //币种
"RefundCommission":850, //退票手续费
"ServiceFee":0, //服务费
"UseSegmentFee":0, //已使用航段费
"UsedTax":0, //已使用税费
"UsedBaseFare":0, //已使用票价
"RefundAmount":850, //可退金额
}, //收入
}, //费用
"currency":"CNY", //结算币种
}], //退票明细
"Refundable":
{
"IsCanRefund":true, //是否可退
"CannotRefundReasonCode":0, //不可退票原因 0: 允许 1:已退票 2:已使用 3: 不允许退票 4: 票无效 5: 已值机 6: 已改签 7:已升舱 8:其他
"CannotRefundReasonText":"不可退票原因,航司规定该舱位不可退", //不可退票原因文本
}, //是否可退
}], //退票航段+旅客
"IsRefundAll":true, //所有航段是否必须一起退
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
获取退票费
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
originalOrderNo | 原单号 | String | 否 | |
passengerList | 原单旅客外部编号 | Array[] | 否 | |
involuntary | 退票类型(1=自愿,2=非自愿) | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
segments | 退票申请航段 | Array[] | 否 | |
journeyIndex | 行程序号(订单详细获取) | String | segments |
{
"originalOrderNo": "", //原单号
"segments":
[{
"journeyIndex": "", //行程序号(订单详细获取)
}], //退票申请航段
"passengerList":[], //原单旅客外部编号
"involuntary": "", //退票类型(1=自愿,2=非自愿)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
refundPricingId | 退票费用id | String | ||
refundAmount | 应退金额 | Number | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
canRefundResult | 校验退票结果 | ApiIntairTicketBookingIsCanRefundResult | ||
isCanRefund | 是否可退票 | Boolean | canRefundResult | |
cannotOnlineRefundReason | 不可在线变更原因 | String | canRefundResult | |
involuntary | 退票类型限制(1=自愿,2=非自愿,其他为不限) | String | canRefundResult | |
prices | 价格 | Array[] | ||
passengerTypeCode | 旅客类型(ADT/CHD/INF) | String | prices | |
tax | 应退税 | ApiIntairTicketBookingGetRefundFeeTaxDto | prices | |
totalTaxCurrency | 币种 | String | prices.tax | |
totalTaxAmount | 金额 | Number | prices.tax | |
items | 税项 | Array[] | prices.tax | |
currency | 币种 | String | prices.tax.items | |
code | 税费类型 | String | prices.tax.items | |
amount | 金额 | Number | prices.tax.items | |
sell | 收入 | ApiIntairTicketBookingGetRefundFeePriceSellDto | prices | |
currency | 结算币种 | String | prices.sell | |
refundCommission | 退票手续费 | Number | prices.sell | |
serviceFee | 服务费 | Number | prices.sell | |
useSegmentFee | 已使用航段费 | Number | prices.sell | |
usedTax | 已使用税费 | Number | prices.sell | |
usedBaseFare | 已使用票价 | Number | prices.sell | |
refundAmount | 可退金额 | Number | prices.sell |
{
"refundPricingId": "", //退票费用id
"canRefundResult":
{
"isCanRefund":false, //是否可退票
"cannotOnlineRefundReason": "", //不可在线变更原因
"involuntary": "", //退票类型限制(1=自愿,2=非自愿,其他为不限)
}, //校验退票结果
"prices":
[{
"passengerTypeCode": "", //旅客类型(ADT/CHD/INF)
"sell":
{
"currency": "", //结算币种
"refundCommission":0, //退票手续费
"serviceFee":0, //服务费
"useSegmentFee":0, //已使用航段费
"usedTax":0, //已使用税费
"usedBaseFare":0, //已使用票价
"refundAmount":0, //可退金额
}, //收入
"tax":
{
"items":
[{
"currency": "", //币种
"code": "", //税费类型
"amount":0, //金额
}], //税项
"totalTaxCurrency": "", //币种
"totalTaxAmount":0, //金额
}, //应退税
}], //价格
"refundAmount":0, //应退金额
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsideOrderNo | 外部订单号 | String | 否 | |
originalOrderNo | 美亚原订购单号 | String | 是 | |
opRemark | 备注 | String | 否 | |
passengerList | 旅客列表 | Array[] | 是 | |
refundPricingId |
退票费用id
退票费查询接口返回
添加日期: 2025-03-03 |
String | 否 | |
involuntary |
变更类型(1=自愿,2=非自愿)默认 1
添加日期: 2025-04-10 |
String | 否 | |
reasonText |
变更原因(长度150以内)
添加日期: 2025-04-10 |
String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
contactInfo | 联系人信息 | ContactInfo | 是 | |
contactName | 联系人 | String | contactInfo | |
mobile | 手机号码 | String | contactInfo | |
phone | 联系电话 | String | contactInfo | |
电子邮件 | String | contactInfo | ||
flightList | 需要改签的航班 | Array[] | 是 | |
journeyIndex | 行程序号(订单详细获取) 优先传这个,剩下可以不传 | String | flightList | |
segmentNo | 航段序号,如果序号有传,下面其他参数可不传; 2022-11-30生效 优先使用 journeyIndex | Integer | flightList | |
departureDate | 出发日期 格式:yyyy-MM-dd | String | flightList | |
departureTime | 出发时间 格式:HH:mm | String | flightList | |
flightNo | 航班号 | String | flightList | |
originCityCode | 出发城市三字码 | String | flightList | |
destinationCityCode | 到达城市三字码 | String | flightList |
{
"outsideOrderNo":"1125925467140981", //外部订单号
"originalOrderNo":"QT2300011545", //美亚原订购单号
"opRemark":"无", //备注
"flightList":
[{
"journeyIndex": "", //行程序号(订单详细获取)
优先传这个,剩下可以不传
"segmentNo":0, //航段序号,如果序号有传,下面其他参数可不传; 2022-11-30生效
优先使用 journeyIndex
"departureDate":"2023-10-28", //出发日期 格式:yyyy-MM-dd
"departureTime":"23:30", //出发时间 格式:HH:mm
"flightNo":"MU5070", //航班号
"originCityCode":"CGK", //出发城市三字码
"destinationCityCode":"PVG", //到达城市三字码
}], //需要改签的航班
"passengerList":"[“P4386785”]", //旅客列表
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"refundPricingId": "", //退票费用id
退票费查询接口返回
"involuntary": "", //变更类型(1=自愿,2=非自愿)默认 1
"reasonText": "", //变更原因(长度150以内)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 退票订单编号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo":"QR2300004286", //退票订单编号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
根据订单号进行取消,取消订单,订退改都适用
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单编号, 共用的实体,订单号展示只做示例 | String | 是 | |
cancelReasonId | Integer | 否 | ||
cancelReason | 取消原因 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //订单编号, 共用的实体,订单号展示只做示例
"cancelReasonId":0, //
"cancelReason": "", //取消原因
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
根据订单号进行取消,提交出票,订退改都适用
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单号 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
newPrice | 非变价提交该参数不传,变价后提交需传接口返回的(priceInfo)最新价格 | IFlightAirfarePriceNew | 否 | |
solutionId | 最新价,solutionId(创建订单返回6011,协议价白名单预订失败时会返回) | String | newPrice | |
passengertype | 乘客类型,成人、儿童、婴儿 | String | newPrice | |
basefare | 销售 -- 票面价 | Number | newPrice | |
basefarecurrency | 结算币种 | String | newPrice | |
tax | 销售 - 税 | Number | newPrice | |
priceService | 服务费 | Number | newPrice | |
psgrCount | 旅客人数 | Integer | newPrice | |
rule | 客规和行李额数据 | AirRule | newPrice | |
remark | 备注 | String | newPrice.rule | |
SupplierService | 供应商服务内容 | PolicySupplierServiceDto | newPrice.rule | |
Change | 改签 | SupplierServiceChangeDto | newPrice.rule.SupplierService | |
Change | 服务内容 | String | newPrice.rule.SupplierService.Change | |
Change | 服务费时间 | SupplierServiceTimeDto | newPrice.rule.SupplierService.Change | |
Refund | 退票 | SupplierServiceRefundDto | newPrice.rule.SupplierService | |
Refund | 服务内容 | String | newPrice.rule.SupplierService.Refund | |
Refund | 服务费时间 | SupplierServiceTimeDto | newPrice.rule.SupplierService.Refund | |
Issue | 出票 | SupplierServiceIssueDto | newPrice.rule.SupplierService | |
Issue | 服务商类型(0=美亚自营,1=供应商提供服务) | Integer | newPrice.rule.SupplierService.Issue | |
Issue | 服务内容 | String | newPrice.rule.SupplierService.Issue | |
Issue | 服务时间 | SupplierServiceTimeDto | newPrice.rule.SupplierService.Issue | |
Void | 作废 | SupplierServiceVoidDto | newPrice.rule.SupplierService | |
Void | 是否可以废票 | Boolean | newPrice.rule.SupplierService.Void | |
Void | 作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认] | Integer | newPrice.rule.SupplierService.Void | |
Void | 废票截止时间 格式 yyyy-MM-ddTHH:mm:ss | String | newPrice.rule.SupplierService.Void | |
Void | 服务内容 | String | newPrice.rule.SupplierService.Void | |
Void | 服务时间 | SupplierServiceTimeDto | newPrice.rule.SupplierService.Void | |
airRuleList | 退改条款详情 | Array[] | newPrice.rule | |
origin | 运价起点城市三字码 | String | newPrice.rule.airRuleList | |
destination | 运价终点城市三字码 | String | newPrice.rule.airRuleList | |
minStay | 最短停留时间 | String | newPrice.rule.airRuleList | |
maxStay | 最长停留时间 | String | newPrice.rule.airRuleList | |
refund | 退票 | String | newPrice.rule.airRuleList | |
change | 改签 | String | newPrice.rule.airRuleList | |
delay | 延误 | String | newPrice.rule.airRuleList | |
luggage | 行李额 | String | newPrice.rule.airRuleList | |
NoshowRefunds | PM2023084添加 结构化退票规则 | Array[] | newPrice.rule.airRuleList | |
NoshowRefunds | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | newPrice.rule.airRuleList.NoshowRefunds | |
NoshowRefunds | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | newPrice.rule.airRuleList.NoshowRefunds | |
NoshowRefunds | 起飞前多少小时算noshow 默认给0 | Integer | newPrice.rule.airRuleList.NoshowRefunds | |
NoshowRefunds | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | newPrice.rule.airRuleList.NoshowRefunds | |
NoshowRefunds | 币种 | String | newPrice.rule.airRuleList.NoshowRefunds | |
NoshowRefunds | 原文信息描述 | String | newPrice.rule.airRuleList.NoshowRefunds | |
NoshowChanges | PM2023084添加 结构化改签规则 | Array[] | newPrice.rule.airRuleList | |
NoshowChanges | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | newPrice.rule.airRuleList.NoshowChanges | |
NoshowChanges | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | newPrice.rule.airRuleList.NoshowChanges | |
NoshowChanges | 起飞前多少小时算noshow 默认给0 | Integer | newPrice.rule.airRuleList.NoshowChanges | |
NoshowChanges | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | newPrice.rule.airRuleList.NoshowChanges | |
NoshowChanges | 币种 | String | newPrice.rule.airRuleList.NoshowChanges | |
NoshowChanges | 原文信息描述 | String | newPrice.rule.airRuleList.NoshowChanges | |
Refunds | PM2023084添加 退票规则详情 | Array[] | newPrice.rule.airRuleList | |
Refunds | 退票类型 可返值[before or after] | String | newPrice.rule.airRuleList.Refunds | |
Refunds | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | newPrice.rule.airRuleList.Refunds | |
Refunds | 起飞前或者起飞后多少小时 默认给0 | Integer | newPrice.rule.airRuleList.Refunds | |
Refunds | 退票罚金 | Number | newPrice.rule.airRuleList.Refunds | |
Refunds | 币种 | String | newPrice.rule.airRuleList.Refunds | |
Refunds | 旅行有效期起始日期 yyyy-MM-dd | String | newPrice.rule.airRuleList.Refunds | |
Refunds | 旅行有效期截止日期 yyyy-MM-dd | String | newPrice.rule.airRuleList.Refunds | |
Refunds | Ticket有效期起始日期 yyyy-MM-dd | String | newPrice.rule.airRuleList.Refunds | |
Refunds | Ticket有效期截止日期 yyyy-MM-dd | String | newPrice.rule.airRuleList.Refunds | |
Refunds | 原文信息描述 | String | newPrice.rule.airRuleList.Refunds | |
Changes | PM2023084添加 改签规则详情 | Array[] | newPrice.rule.airRuleList | |
Changes | 退票类型 可返值[before or after] | String | newPrice.rule.airRuleList.Changes | |
Changes | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | newPrice.rule.airRuleList.Changes | |
Changes | 起飞前或者起飞后多少小时 默认给0 | Integer | newPrice.rule.airRuleList.Changes | |
Changes | 退票罚金 | Number | newPrice.rule.airRuleList.Changes | |
Changes | 币种 | String | newPrice.rule.airRuleList.Changes | |
Changes | 旅行有效期起始日期 yyyy-MM-dd | String | newPrice.rule.airRuleList.Changes | |
Changes | 旅行有效期截止日期 yyyy-MM-dd | String | newPrice.rule.airRuleList.Changes | |
Changes | Ticket有效期起始日期 yyyy-MM-dd | String | newPrice.rule.airRuleList.Changes | |
Changes | Ticket有效期截止日期 yyyy-MM-dd | String | newPrice.rule.airRuleList.Changes | |
Changes | 原文信息描述 | String | newPrice.rule.airRuleList.Changes | |
luggageList | PM2023084添加 行李额 | Array[] | newPrice.rule.airRuleList | |
luggageList | 航班号 | String | newPrice.rule.airRuleList.luggageList | |
luggageList | 出发城市名称 | String | newPrice.rule.airRuleList.luggageList | |
luggageList | 到达城市名称 | String | newPrice.rule.airRuleList.luggageList | |
luggageList | 出发城市三字码 | String | newPrice.rule.airRuleList.luggageList | |
luggageList | 到达城市三字码 | String | newPrice.rule.airRuleList.luggageList | |
luggageList | 免费托运行李件数 | String | newPrice.rule.airRuleList.luggageList | |
luggageList | 免费托运行李重量 | String | newPrice.rule.airRuleList.luggageList | |
luggageList | 免费托运行李体积 | String | newPrice.rule.airRuleList.luggageList | |
luggageList | 行李额描述(免费托运行李) 新增字段,长宽高文本 | String | newPrice.rule.airRuleList.luggageList | |
luggageList | 手提行李件数,允许件数(免费手提行李) | String | newPrice.rule.airRuleList.luggageList | |
luggageList | 允许重量(免费手提行李) | String | newPrice.rule.airRuleList.luggageList | |
luggageList | 体积(免费手提行李) | String | newPrice.rule.airRuleList.luggageList | |
luggageList | 行李额描述(免费手提行李)长宽高文本 | String | newPrice.rule.airRuleList.luggageList | |
luggageList | 随身物品内容 | LuaggageStructDto | newPrice.rule.airRuleList.luggageList | |
luggageList | 托运行李结构化 | LuaggageStructDto | newPrice.rule.airRuleList.luggageList | |
luggageList | 手提行李结构化 | LuaggageStructDto | newPrice.rule.airRuleList.luggageList |
{
"orderNo":"QT2300115286", //订单号
"newPrice":
{
"solutionId":"11c5a5d7a1234f84982a8ce2b2cae8dc", //最新价,solutionId(创建订单返回6011,协议价白名单预订失败时会返回)
"passengertype":"成人", //乘客类型,成人、儿童、婴儿
"basefare":2500, //销售 -- 票面价
"basefarecurrency":"CNY", //结算币种
"tax":1200, //销售 - 税
"priceService":100, //服务费
"psgrCount":1, //旅客人数
"rule":
{
"airRuleList":
[{
"origin":"BJS", //运价起点城市三字码
"destination":"SEL", //运价终点城市三字码
"minStay": "", //最短停留时间
"maxStay": "", //最长停留时间
"refund":"不允许", //退票
"change":"不允许", //改签
"delay":"误机发生后退票需额外收取误机费300元。误机发生后更改需额外收取误机费300元", //延误
"luggage":"北京(BJS)-青岛(TAO):托运免费行李:件数:2;托运说明:免费托运行李:2件。手持免费行李:件数:1;手持说明:免费手提行李:1件。青岛(TAO)-首尔(SEL):托运免费行李:件数:2;托运说明:免费托运行李:2件。手持免费行李:件数:1;手持说明:免费手提行李:1件。", //行李额
"luggageList":
[{
"flightNo": "", //航班号
"departureCityName":"北京", //出发城市名称
"arrivalCityName":"青岛", //到达城市名称
"departureCityCode":"BJS", //出发城市三字码
"arrivalCityCode":"TAO", //到达城市三字码
"checkInLuggagePieces":"2", //免费托运行李件数
"checkInLuggageWeight": "", //免费托运行李重量
"checkInLuggageDemision": "", //免费托运行李体积
"checkInLuggageText": "", //行李额描述(免费托运行李) 新增字段,长宽高文本
"handLuggagePieces":"1", //手提行李件数,允许件数(免费手提行李)
"handLuggageWeight": "", //允许重量(免费手提行李)
"handLuggageDemision": "", //体积(免费手提行李)
"handLuggageText": "", //行李额描述(免费手提行李)长宽高文本
"seatBag":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //随身物品内容
"CheckStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //托运行李结构化
"HandStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //手提行李结构化
}], //PM2023084添加 行李额
"Refunds":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //PM2023084添加 退票规则详情
"Changes":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //PM2023084添加 改签规则详情
"NoshowRefunds":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //PM2023084添加 结构化退票规则
"NoshowChanges":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //PM2023084添加 结构化改签规则
}], //退改条款详情
"remark":"无", //备注
"SupplierService":
{
"Issue":
{
"ServicerType":0, //服务商类型(0=美亚自营,1=供应商提供服务)
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //出票
"Change":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //改签
"Refund":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //退票
"Void":
{
"IsCanVoid":false, //是否可以废票
"VoidEffective":0, //作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认]
"VoidTicketingDeadline": "", //废票截止时间 格式 yyyy-MM-ddTHH:mm:ss
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //作废
}, //供应商服务内容
}, //客规和行李额数据
}, //非变价提交该参数不传,变价后提交需传接口返回的(priceInfo)最新价格
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
priceInfo | 变价返回的最新价格信息 | IFlightAirfarePriceNew | ||
solutionId | 最新价,solutionId(创建订单返回6011,协议价白名单预订失败时会返回) | String | priceInfo | |
passengertype | 乘客类型,成人、儿童、婴儿 | String | priceInfo | |
basefare | 销售 -- 票面价 | Number | priceInfo | |
basefarecurrency | 结算币种 | String | priceInfo | |
tax | 销售 - 税 | Number | priceInfo | |
priceService | 服务费 | Number | priceInfo | |
psgrCount | 旅客人数 | Integer | priceInfo | |
rule | 客规和行李额数据 | AirRule | priceInfo | |
remark | 备注 | String | priceInfo.rule | |
SupplierService | 供应商服务内容 | PolicySupplierServiceDto | priceInfo.rule | |
Change | 改签 | SupplierServiceChangeDto | priceInfo.rule.SupplierService | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Change | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | priceInfo.rule.SupplierService.Change | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | priceInfo.rule.SupplierService.Change.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Change.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Change.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | priceInfo.rule.SupplierService.Change.ServiceTime | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Change.ServiceTime.All | |
Normals | 正常时间 | Array[] | priceInfo.rule.SupplierService.Change.ServiceTime.All | |
Specials | 特殊时间 | Array[] | priceInfo.rule.SupplierService.Change.ServiceTime.All | |
Refund | 退票 | SupplierServiceRefundDto | priceInfo.rule.SupplierService | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Refund | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | priceInfo.rule.SupplierService.Refund | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | priceInfo.rule.SupplierService.Refund.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Refund.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Refund.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | priceInfo.rule.SupplierService.Refund.ServiceTime | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Refund.ServiceTime.All | |
Normals | 正常时间 | Array[] | priceInfo.rule.SupplierService.Refund.ServiceTime.All | |
Specials | 特殊时间 | Array[] | priceInfo.rule.SupplierService.Refund.ServiceTime.All | |
Issue | 出票 | SupplierServiceIssueDto | priceInfo.rule.SupplierService | |
ServicerType | 服务商类型(0=美亚自营,1=供应商提供服务) | Integer | priceInfo.rule.SupplierService.Issue | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Issue | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | priceInfo.rule.SupplierService.Issue | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | priceInfo.rule.SupplierService.Issue.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Issue.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Issue.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | priceInfo.rule.SupplierService.Issue.ServiceTime | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Issue.ServiceTime.All | |
Normals | 正常时间 | Array[] | priceInfo.rule.SupplierService.Issue.ServiceTime.All | |
Specials | 特殊时间 | Array[] | priceInfo.rule.SupplierService.Issue.ServiceTime.All | |
Void | 作废 | SupplierServiceVoidDto | priceInfo.rule.SupplierService | |
IsCanVoid | 是否可以废票 | Boolean | priceInfo.rule.SupplierService.Void | |
VoidEffective | 作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认] | Integer | priceInfo.rule.SupplierService.Void | |
VoidTicketingDeadline | 废票截止时间 格式 yyyy-MM-ddTHH:mm:ss | String | priceInfo.rule.SupplierService.Void | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Void | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | priceInfo.rule.SupplierService.Void | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | priceInfo.rule.SupplierService.Void.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Void.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | priceInfo.rule.SupplierService.Void.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | priceInfo.rule.SupplierService.Void.ServiceTime | |
Content | 服务内容 | String | priceInfo.rule.SupplierService.Void.ServiceTime.All | |
Normals | 正常时间 | Array[] | priceInfo.rule.SupplierService.Void.ServiceTime.All | |
Specials | 特殊时间 | Array[] | priceInfo.rule.SupplierService.Void.ServiceTime.All | |
airRuleList | 退改条款详情 | Array[] | priceInfo.rule | |
origin | 运价起点城市三字码 | String | priceInfo.rule.airRuleList | |
destination | 运价终点城市三字码 | String | priceInfo.rule.airRuleList | |
minStay | 最短停留时间 | String | priceInfo.rule.airRuleList | |
maxStay | 最长停留时间 | String | priceInfo.rule.airRuleList | |
refund | 退票 | String | priceInfo.rule.airRuleList | |
change | 改签 | String | priceInfo.rule.airRuleList | |
delay | 延误 | String | priceInfo.rule.airRuleList | |
luggage | 行李额 | String | priceInfo.rule.airRuleList | |
NoshowRefunds | PM2023084添加 结构化退票规则 | Array[] | priceInfo.rule.airRuleList | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | priceInfo.rule.airRuleList.NoshowRefunds | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | priceInfo.rule.airRuleList.NoshowRefunds | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | priceInfo.rule.airRuleList.NoshowRefunds | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | priceInfo.rule.airRuleList.NoshowRefunds | |
Currency | 币种 | String | priceInfo.rule.airRuleList.NoshowRefunds | |
Text | 原文信息描述 | String | priceInfo.rule.airRuleList.NoshowRefunds | |
NoshowChanges | PM2023084添加 结构化改签规则 | Array[] | priceInfo.rule.airRuleList | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | priceInfo.rule.airRuleList.NoshowChanges | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | priceInfo.rule.airRuleList.NoshowChanges | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | priceInfo.rule.airRuleList.NoshowChanges | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | priceInfo.rule.airRuleList.NoshowChanges | |
Currency | 币种 | String | priceInfo.rule.airRuleList.NoshowChanges | |
Text | 原文信息描述 | String | priceInfo.rule.airRuleList.NoshowChanges | |
Refunds | PM2023084添加 退票规则详情 | Array[] | priceInfo.rule.airRuleList | |
TypeCode | 退票类型 可返值[before or after] | String | priceInfo.rule.airRuleList.Refunds | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | priceInfo.rule.airRuleList.Refunds | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | priceInfo.rule.airRuleList.Refunds | |
Fee | 退票罚金 | Number | priceInfo.rule.airRuleList.Refunds | |
Currency | 币种 | String | priceInfo.rule.airRuleList.Refunds | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Refunds | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Refunds | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Refunds | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Refunds | |
Text | 原文信息描述 | String | priceInfo.rule.airRuleList.Refunds | |
Changes | PM2023084添加 改签规则详情 | Array[] | priceInfo.rule.airRuleList | |
TypeCode | 退票类型 可返值[before or after] | String | priceInfo.rule.airRuleList.Changes | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | priceInfo.rule.airRuleList.Changes | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | priceInfo.rule.airRuleList.Changes | |
Fee | 退票罚金 | Number | priceInfo.rule.airRuleList.Changes | |
Currency | 币种 | String | priceInfo.rule.airRuleList.Changes | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Changes | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Changes | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Changes | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | priceInfo.rule.airRuleList.Changes | |
Text | 原文信息描述 | String | priceInfo.rule.airRuleList.Changes | |
luggageList | PM2023084添加 行李额 | Array[] | priceInfo.rule.airRuleList | |
flightNo | 航班号 | String | priceInfo.rule.airRuleList.luggageList | |
departureCityName | 出发城市名称 | String | priceInfo.rule.airRuleList.luggageList | |
arrivalCityName | 到达城市名称 | String | priceInfo.rule.airRuleList.luggageList | |
departureCityCode | 出发城市三字码 | String | priceInfo.rule.airRuleList.luggageList | |
arrivalCityCode | 到达城市三字码 | String | priceInfo.rule.airRuleList.luggageList | |
checkInLuggagePieces | 免费托运行李件数 | String | priceInfo.rule.airRuleList.luggageList | |
checkInLuggageWeight | 免费托运行李重量 | String | priceInfo.rule.airRuleList.luggageList | |
checkInLuggageDemision | 免费托运行李体积 | String | priceInfo.rule.airRuleList.luggageList | |
checkInLuggageText | 行李额描述(免费托运行李) 新增字段,长宽高文本 | String | priceInfo.rule.airRuleList.luggageList | |
handLuggagePieces | 手提行李件数,允许件数(免费手提行李) | String | priceInfo.rule.airRuleList.luggageList | |
handLuggageWeight | 允许重量(免费手提行李) | String | priceInfo.rule.airRuleList.luggageList | |
handLuggageDemision | 体积(免费手提行李) | String | priceInfo.rule.airRuleList.luggageList | |
handLuggageText | 行李额描述(免费手提行李)长宽高文本 | String | priceInfo.rule.airRuleList.luggageList | |
seatBag | 随身物品内容 | LuaggageStructDto | priceInfo.rule.airRuleList.luggageList | |
Pieces | String | priceInfo.rule.airRuleList.luggageList.seatBag | ||
Weight | String | priceInfo.rule.airRuleList.luggageList.seatBag | ||
Demision | String | priceInfo.rule.airRuleList.luggageList.seatBag | ||
Description | String | priceInfo.rule.airRuleList.luggageList.seatBag | ||
CheckStruct | 托运行李结构化 | LuaggageStructDto | priceInfo.rule.airRuleList.luggageList | |
Pieces | String | priceInfo.rule.airRuleList.luggageList.CheckStruct | ||
Weight | String | priceInfo.rule.airRuleList.luggageList.CheckStruct | ||
Demision | String | priceInfo.rule.airRuleList.luggageList.CheckStruct | ||
Description | String | priceInfo.rule.airRuleList.luggageList.CheckStruct | ||
HandStruct | 手提行李结构化 | LuaggageStructDto | priceInfo.rule.airRuleList.luggageList | |
Pieces | String | priceInfo.rule.airRuleList.luggageList.HandStruct | ||
Weight | String | priceInfo.rule.airRuleList.luggageList.HandStruct | ||
Demision | String | priceInfo.rule.airRuleList.luggageList.HandStruct | ||
Description | String | priceInfo.rule.airRuleList.luggageList.HandStruct |
{
"priceInfo":
{
"solutionId":"11c5a5d7a1234f84982a8ce2b2cae8dc", //最新价,solutionId(创建订单返回6011,协议价白名单预订失败时会返回)
"passengertype":"成人", //乘客类型,成人、儿童、婴儿
"basefare":2500, //销售 -- 票面价
"basefarecurrency":"CNY", //结算币种
"tax":1200, //销售 - 税
"priceService":100, //服务费
"psgrCount":1, //旅客人数
"rule":
{
"airRuleList":
[{
"origin":"BJS", //运价起点城市三字码
"destination":"SEL", //运价终点城市三字码
"minStay": "", //最短停留时间
"maxStay": "", //最长停留时间
"refund":"不允许", //退票
"change":"不允许", //改签
"delay":"误机发生后退票需额外收取误机费300元。误机发生后更改需额外收取误机费300元", //延误
"luggage":"北京(BJS)-青岛(TAO):托运免费行李:件数:2;托运说明:免费托运行李:2件。手持免费行李:件数:1;手持说明:免费手提行李:1件。青岛(TAO)-首尔(SEL):托运免费行李:件数:2;托运说明:免费托运行李:2件。手持免费行李:件数:1;手持说明:免费手提行李:1件。", //行李额
"luggageList":
[{
"flightNo": "", //航班号
"departureCityName":"北京", //出发城市名称
"arrivalCityName":"青岛", //到达城市名称
"departureCityCode":"BJS", //出发城市三字码
"arrivalCityCode":"TAO", //到达城市三字码
"checkInLuggagePieces":"2", //免费托运行李件数
"checkInLuggageWeight": "", //免费托运行李重量
"checkInLuggageDemision": "", //免费托运行李体积
"checkInLuggageText": "", //行李额描述(免费托运行李) 新增字段,长宽高文本
"handLuggagePieces":"1", //手提行李件数,允许件数(免费手提行李)
"handLuggageWeight": "", //允许重量(免费手提行李)
"handLuggageDemision": "", //体积(免费手提行李)
"handLuggageText": "", //行李额描述(免费手提行李)长宽高文本
"seatBag":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //随身物品内容
"CheckStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //托运行李结构化
"HandStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //手提行李结构化
}], //PM2023084添加 行李额
"Refunds":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //PM2023084添加 退票规则详情
"Changes":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //PM2023084添加 改签规则详情
"NoshowRefunds":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //PM2023084添加 结构化退票规则
"NoshowChanges":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //PM2023084添加 结构化改签规则
}], //退改条款详情
"remark":"无", //备注
"SupplierService":
{
"Issue":
{
"ServicerType":0, //服务商类型(0=美亚自营,1=供应商提供服务)
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //出票
"Change":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //改签
"Refund":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //退票
"Void":
{
"IsCanVoid":false, //是否可以废票
"VoidEffective":0, //作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认]
"VoidTicketingDeadline": "", //废票截止时间 格式 yyyy-MM-ddTHH:mm:ss
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //作废
}, //供应商服务内容
}, //客规和行李额数据
}, //变价返回的最新价格信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
根据订单号查询国际机票订单详细(新)
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订购单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"QT2300045878", //美亚订购单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderType |
订单类型
1:国内机票订购单; 2:国内机票改签单; 3:国内机票退票单; 11:国际机票订购单; 12:国际机票改签单; 13:国际机票退票单 |
Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
data | 订单信息(国内国际机票通用) | FlightOrderPush | ||
changeType |
变更/改签类型
0:未知
100:自愿
200:非自愿
添加日期: 2018-11-22 |
Integer | data | |
changeReason |
变更/改签原因
添加日期: 2018-11-22 |
String | data | |
status |
订单状态
国际机票只包含:40,70,80 5 :待提交 10 :审批中 20 :待收款 25 :待付款 30 :出票中 35 :紧急处理 40 :已出票 50 :已取消 60 :待核对 70 :处理中 75 :紧急处理 80 :已处理 200:待审核 |
Integer | data | |
isUatpPay |
是否uatp出票(1:是)
添加日期: 2019-11-06 |
Integer | data | |
uatpCardNo |
uatp卡号(isUatpPay=1时有值)
添加日期: 2019-11-06 |
String | data | |
uatpSupplier |
uatp公司(isUatpPay=1时有值)
添加日期: 2019-11-06 |
String | data | |
customerCode |
大客户编号
添加日期: 2021-11-19 |
String | data | |
officeCode |
出票Office PM2024113 API接口-订单推送接口增加出票office字段
添加日期: 2024-04-15 |
String | data | |
pnrBigCode |
航司大编码 PM2024123 添加
添加日期: 2024-04-25 |
String | data | |
quotationLugage |
报价币种行李额费用
添加日期: 2025-03-25 |
Number | data | |
settlementServiceFee |
结算币种行程单服务费
添加日期: 2025-03-25 |
Number | data | |
settlementLugage |
结算币种行李额费用
添加日期: 2025-03-25 |
Number | data | |
quotationServiceFee |
报价币种行程单服务费
添加日期: 2025-03-25 |
Number | data | |
quotationAmountSaved |
报价币种三方协议节省金额 暂无实际数据
添加日期: 2025-03-25 |
Number | data | |
settlementAmountSaved |
结算币种三方协议节省金额 暂无实际数据
添加日期: 2025-03-25 |
Number | data | |
ticketCounter |
票台信息 暂无实际数据
添加日期: 2025-03-25 |
String | data | |
subOrderNo |
辅营子单号 暂无实际数据
添加日期: 2025-03-25 |
String | data | |
exchangeRate |
国际机票,结算汇率,多币种结算才使用 暂无实际数据 默认1
添加日期: 2025-03-25 |
Number | data | |
CNYToQuotationExchangeRate |
国际机票,汇率(CNY-报价):取人民币转报价币种的汇率,多币种结算才使用 暂无实际数据 默认1
添加日期: 2025-03-25 |
Number | data | |
CNYToSettlementExchangeRate |
国际机票,汇率(CNY-结算):取人民币转结算币种的汇率,多币种结算才使用 暂无实际数据 默认1
添加日期: 2025-03-25 |
Number | data | |
deadLineTime | 价格有效期(改签单和退票单时,订单需在价格有效期内提交订单,过了有效期会提交订单失败) | String | data | |
tripId | 行程编号 | String | data | |
companyId | 公司编号 | String | data | |
failureReason | 订单失败原因 | String | data | |
oaOtherInfo | 其他信息,个性化客户需要(比如:中奖码) | String | data | |
firstOrderNo | 美亚原购单号 | String | data | |
orderSource | 订单来源 | Integer | data | |
receivePayType |
支付方式
月结 现结 预存卡 |
String | data | |
affiliateBusinessName | 供应商 | String | data | |
pnr | pnr | String | data | |
StaffPayExcess |
个人承担费用,=true 为存在个人承担,false
添加日期: 2024-04-03 |
Boolean | data | |
PolicyExcessAmount |
StaffPayExcess=true 时需要关注,个人承担的金额,否则为 0;
添加日期: 2024-04-03 |
Number | data | |
CompanyExcessAmount |
StaffPayExcess=true 时需要关注,公司承担的金额;
添加日期: 2024-04-03 |
Number | data | |
c_TextField_2401 | 客户自定义字段1 | String | data | |
c_TextField_2402 | 客户自定义字段2 | String | data | |
c_TextField_2403 | 客户自定义字段3 | String | data | |
c_TextField_2404 | 客户自定义字段4 | String | data | |
c_TextField_2405 | 客户自定义字段5 | String | data | |
c_TextField_2406 | 客户自定义字段6 | String | data | |
c_TextField_2407 | 客户自定义字段7 | String | data | |
c_TextField_2408 | 客户自定义字段8 | String | data | |
totalPrice | 当前订单总金额 | Number | data | |
opId | 制单人旅客编号 | String | data | |
onBusiness | 订单类型(1:因公;0:因私) 注意:如果因私订单不需要的,记得接收时过滤掉 | Integer | data | |
orderRemark | 订单备注 | String | data | |
outsideOrderNo | 客户订单号 | String | data | |
orderNo | 美亚订单号 | String | data | |
originalOrderNo | 美亚原订单号 | String | data | |
opStaffCode | 客户制单人工号 | String | data | |
opName | 客户制单人 | String | data | |
opDate | 下单时间(yyyy-MM-dd HH:mm:ss) | String | data | |
statusText | 订单状态(名称) | String | data | |
issueDate | 出票日期(yyyy-MM-dd HH:mm:ss) | String | data | |
oaSerialnumber | 客户出差申请单号 | String | data | |
stApplyOrderNo | 美亚出差申请单号 | String | data | |
contactInfo | 联系人信息 | OrderPushContactinfo | data | |
contactName | 联系人姓名 | String | data.contactInfo | |
mobile | 手机号 | String | data.contactInfo | |
phone | 固定电话 | String | data.contactInfo | |
邮箱 | String | data.contactInfo | ||
policyList | 出差政策列表 | Array[] | data | |
passengerCode | 旅客编号 | String | data.policyList | |
staffCode | 旅客编号 | String | data.policyList | |
passengerName | 旅客姓名 | String | data.policyList | |
policyName | 政策名称 | String | data.policyList | |
policyProperty | 属性(建议/强制) | String | data.policyList | |
policyType | 基础/分类/个人/附加 | String | data.policyList | |
costList | 成本中心 | Array[] | data | |
remark | 备注 | String | data.costList | |
staffCode | 员工工号 | String | data.costList | |
passengerCode | 旅客编号 | String | data.costList | |
passengerName | 旅客名称 | String | data.costList | |
costId | 成本中心编号 | Integer | data.costList | |
costCenterName | 成本中心名称 | String | data.costList | |
amount | 成本金额 | Number | data.costList | |
priceList | 价格信息 | Array[] | data | |
passengerType | 旅客类型 | String | data.priceList | |
ticketPrice | 机票票面价格(改签时为升舱费) | Number | data.priceList | |
tax | 机场建设费;国际机票税费 | Number | data.priceList | |
oilFee | 燃油附加费;国际机票无 | Number | data.priceList | |
servicePrice | 服务费 | Number | data.priceList | |
discount | 折扣(8.0折进值为80);国际机票无 | Number | data.priceList | |
serviceCommission | 改签/退票手续费 | Number | data.priceList | |
usedFlight | 已使用航段费 | Number | data.priceList | |
orderSurcharge | 退票详情里的 单据附加费 | Number | data.priceList | |
passengerCode | 旅客编号 | String | data.priceList | |
passengerName | 旅客姓名 | String | data.priceList | |
staffCode | 员工工号 | String | data.priceList | |
currency | 结算币种 | String | data.priceList | |
quotationCurrency | 报价币种(预留,暂返回空) | String | data.priceList | |
QuotationPrice | 国际机票,报价价格,多币种报价结算时才使用 暂无实际数据 | QuotationPriceMode | data.priceList | |
quotationTicketPrice | 机票票面价格(改签时为升舱费) | Number | data.priceList.QuotationPrice | |
quotationTax | 机场建设费 | Number | data.priceList.QuotationPrice | |
quotationServicePrice | 服务费 | Number | data.priceList.QuotationPrice | |
quotationServiceCommission | 改签/退票手续费 | Number | data.priceList.QuotationPrice | |
quotationSellIticketChangefee | 国际改签单改签手续费 | Number | data.priceList.QuotationPrice | |
passengerList | 旅客信息 | Array[] | data | |
reasonId | 差旅政策违反原因序号 | Integer | data.passengerList | |
reasonRemark | 差旅政策违反原因 | String | data.passengerList | |
errorMessage | 退票失败原因(订单为火车票时有值) | String | data.passengerList | |
returnStatus | 出票状况(订单为火车票时有值) | String | data.passengerList | |
seatNo | 座席号(订单为火车票时有值) | String | data.passengerList | |
originalTicketNo | 机票/火车票原票号(改签单时有值) | String | data.passengerList | |
belongToProject |
归属项目
添加日期: 2023-11-21 |
String | data.passengerList | |
travelPurpose |
出行目的
添加日期: 2023-11-21 |
String | data.passengerList | |
passengerNo | 旅客排序号(从1开始递增) | Integer | data.passengerList | |
passengerCode | 旅客编号 | String | data.passengerList | |
passengerName | 旅客姓名 | String | data.passengerList | |
certificateType | 证件类型 | String | data.passengerList | |
certificateId | 证件号码 | String | data.passengerList | |
passengerType | 旅客类型(成人/儿童/婴儿) | String | data.passengerList | |
ticketNo | 机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系) | String | data.passengerList | |
staffCode | 员工工号 | String | data.passengerList | |
mobile | 旅客手机号码 | String | data.passengerList | |
旅客邮箱,国际机票使用 | String | data.passengerList | ||
statusDesc | 客票状态描述 | String | data.passengerList | |
ticketStatus | 票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到 | String | data.passengerList | |
depName |
部门名称,用/分隔(列表返回最后一级,详细返回全级)
添加日期: 2018-10-18 |
String | data.passengerList | |
belongToCenter |
归属中心
添加日期: 2023-11-21 |
Array[] | data.passengerList | |
centerNo |
序号
添加日期: 2023-11-21 |
Integer | data.passengerList.belongToCenter | |
centerTitle |
归属中心标题
添加日期: 2023-11-21 |
String | data.passengerList.belongToCenter | |
centerName |
归属成本中心选项值
添加日期: 2023-11-21 |
String | data.passengerList.belongToCenter | |
segmentList | 航段信息 | Array[] | data | |
cabin |
舱位等级(1/2/3/4)
1 经济舱 2 公务舱 3 头等舱 4 豪华经济舱 |
String | data.segmentList | |
clazz | 小舱位(如:Y/Z/...) | String | data.segmentList | |
clazzName | 舱位名称 | String | data.segmentList | |
planeType | 机型 | String | data.segmentList | |
airlineCode | 销售航司编号(如:HU) | String | data.segmentList | |
segmentNo | 航段序号(从1开始) | Integer | data.segmentList | |
flightNumber | 销售航班号 | String | data.segmentList | |
originName | 出发机场名称 | String | data.segmentList | |
originCountryName | 出发地区或国家名称 | String | data.segmentList | |
originCountryCode | 出发地区或国家二字码 | String | data.segmentList | |
destinationName | 到达机场名称 | String | data.segmentList | |
destinationCountryName | 到达地区或国家名称 | String | data.segmentList | |
destinationCountryCode | 到达地区或国家二字码 | String | data.segmentList | |
departureDate | 出发日期 | String | data.segmentList | |
departureTime | 出发时间 | String | data.segmentList | |
arrivalDate | 到达日期 | String | data.segmentList | |
arrivalTime | 到达时间 | String | data.segmentList | |
flyTime | 飞行时间(分钟) | String | data.segmentList | |
carrier | 实际承运航班号(如果销售航班号是共享航班号,那么实际承运航班号才有值的) | String | data.segmentList | |
stopItem | 经停信息(格式:经停城市|到达时间|起飞时间)(如:上饶|2018-04-23 18:05|2018-04-23 18:55) | String | data.segmentList | |
originCityCode | 出发机场编码 | String | data.segmentList | |
destinationCityCode | 到达机场编码 | String | data.segmentList | |
origincityName | 出发城市名称 | String | data.segmentList | |
destinationCityName | 到达城市名称 | String | data.segmentList | |
depTerminal | 出发航站楼 | String | data.segmentList | |
arrTerminal | 到达航站楼(不详时传 --) | String | data.segmentList | |
airlineName | 航司名称 | String | data.segmentList | |
remark | 备注 | String | data.segmentList | |
ruleInfo | 航班退改规则; | String | data.segmentList | |
amount | 公布运价;(国际机票无公布运价) | Number | data.segmentList | |
fAmount | 头等舱标准价;(国际机票无头等舱标准价) | Number | data.segmentList | |
cAmount | 公务舱标准价;(国际机票无公务舱标准价) | Number | data.segmentList | |
yAmount | 经济舱标准价(国际机票无经济舱标准价) | Number | data.segmentList | |
mileage |
里程
添加日期: 2024-04-25 |
Number | data.segmentList | |
isProtocolPrice |
协议类型:0非协议票,1三方协议,2两方协议
添加日期: 2024-04-25 |
Integer | data.segmentList | |
destinationCityNameEn |
到达城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
destinationNameEng |
到达机场英文名 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
origincityNameEn |
出发城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
originNameEng |
出发机场英文名 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
stopType |
有无经停 0无 1有
添加日期: 2024-04-25 |
Integer | data.segmentList | |
stopCityName |
停留城市名称 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
stopCityNameEn |
停留城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
meal |
有无餐食:0 无 1 有 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
airlineNameEng |
航司英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
JourneyIndex |
行程序号 1-第一程;2-第二程;3-第三程
添加日期: 2024-05-07 |
String | data.segmentList | |
refundRuleInfo | 退票规则内容 | String | data.segmentList | |
changeRuleInfo | 改签规则内容 | String | data.segmentList | |
transferRuleInfo | 签转规则内容 | String | data.segmentList | |
segmentIndex |
航段序号(1开始,展示用)
添加日期: 2025-02-12 |
Integer | data.segmentList | |
departureDiffHour | 出发地时差 正负数值 2025-03-21之前下单的数据为空值 null | Number | data.segmentList | |
arrivalDiffHour |
出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
添加日期: 2025-02-21 |
Number | data.segmentList | |
originProvinceCN | 出发国家省州中文名 | String | data.segmentList | |
originProvinceEN | 出发国家省州英文名 | String | data.segmentList | |
originContinentCN | 出发机场所属大洲中文名 | String | data.segmentList | |
originContinentEN | 出发机场所属大洲英文名 | String | data.segmentList | |
destinationContinentCN | 到达机场所属大洲中文名 | String | data.segmentList | |
destinationContinentEN | 到达机场所属大洲英文名 | String | data.segmentList | |
departureTimeZone | 到达时区 | String | data.segmentList | |
originTimeZone | 出发时区 | String | data.segmentList | |
originCountryNameEN | 出发国家英文名称 | String | data.segmentList | |
destinationCountryNameEN | 到达国家英文名称 | String | data.segmentList | |
routeType | 航线类型,长航线-短航线 暂无实际数据 | String | data.segmentList | |
ticketLuggageRule | 行李额 | TicketLuggageRule | data.segmentList | |
checkRuleInfo | 托运行李规则内容(托运汇总内容) | String | data.segmentList.ticketLuggageRule | |
handRuleInfo | 手提行李规则内容(手提汇总内容) | String | data.segmentList.ticketLuggageRule | |
freeCheckCount | 免费托运行李数量 | String | data.segmentList.ticketLuggageRule | |
freeCheckUnit | 免费托运行李单位 KG=公斤 PC=件 | String | data.segmentList.ticketLuggageRule | |
freeCheckLuggage | 免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”) | String | data.segmentList.ticketLuggageRule | |
checkDescription | 托运行李说明 | String | data.segmentList.ticketLuggageRule | |
freeHandCount | 免费手提行李数量 | String | data.segmentList.ticketLuggageRule | |
freeHandUnit | 免费手提行李单位 KG=公斤 PC=件 | String | data.segmentList.ticketLuggageRule | |
freeHandLuggage | 免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”) | String | data.segmentList.ticketLuggageRule | |
handDescription | 手提行李说明 | String | data.segmentList.ticketLuggageRule | |
refundFees | 退票规则费用计算 | Array[] | data.segmentList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | data.segmentList.refundFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | data.segmentList.refundFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | data.segmentList.refundFees | |
fee | 运算后的退改费用(元) | Number | data.segmentList.refundFees | |
baseFee | 运算基数 | Number | data.segmentList.refundFees | |
feePercent | 费用百分比 | Number | data.segmentList.refundFees | |
minimumFee | 保底费用(元) | Number | data.segmentList.refundFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | data.segmentList.refundFees | |
timingCount | 计时数量 | Integer | data.segmentList.refundFees | |
timingUnit | 计时单位:H 小时、D 天 | String | data.segmentList.refundFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | data.segmentList.refundFees | |
changeFees | 改签规则费用计算 | Array[] | data.segmentList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | data.segmentList.changeFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | data.segmentList.changeFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | data.segmentList.changeFees | |
fee | 运算后的退改费用(元) | Number | data.segmentList.changeFees | |
baseFee | 运算基数 | Number | data.segmentList.changeFees | |
feePercent | 费用百分比 | Number | data.segmentList.changeFees | |
minimumFee | 保底费用(元) | Number | data.segmentList.changeFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | data.segmentList.changeFees | |
timingCount | 计时数量 | Integer | data.segmentList.changeFees | |
timingUnit | 计时单位:H 小时、D 天 | String | data.segmentList.changeFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | data.segmentList.changeFees |
{
"data":
{
"segmentList":
[{
"cabin":"1", //舱位等级(1/2/3/4)
"clazz":"V", //小舱位(如:Y/Z/...)
"clazzName":"经济舱", //舱位名称
"planeType":"波音737", //机型
"airlineCode":"MF", //销售航司编号(如:HU)
"segmentNo":1, //航段序号(从1开始)
"flightNumber":"MF8969", //销售航班号
"originName":"虹桥国际机场", //出发机场名称
"originCountryName":"中国", //出发地区或国家名称
"originCountryCode":"CN", //出发地区或国家二字码
"destinationName":"经济舱", //到达机场名称
"destinationCountryName":"中国", //到达地区或国家名称
"destinationCountryCode":"CN", //到达地区或国家二字码
"departureDate":"2023-10-23", //出发日期
"departureTime":"14:00", //出发时间
"arrivalDate":"2023-10-23", //到达日期
"arrivalTime":"16:30", //到达时间
"flyTime":"150", //飞行时间(分钟)
"carrier": "", //实际承运航班号(如果销售航班号是共享航班号,那么实际承运航班号才有值的)
"stopItem": "", //经停信息(格式:经停城市|到达时间|起飞时间)(如:上饶|2018-04-23 18:05|2018-04-23 18:55)
"originCityCode":"SHA", //出发机场编码
"destinationCityCode":"SZX", //到达机场编码
"origincityName":"上海", //出发城市名称
"destinationCityName":"深圳", //到达城市名称
"depTerminal":"T1", //出发航站楼
"arrTerminal":"T3", //到达航站楼(不详时传 --)
"airlineName":"厦门航空", //航司名称
"remark":"无", //备注
"ruleInfo":"退票规则:航班预计离站时间之前168小时(含)前,收取20 % 退票费.航班预计离站时间之前48小时(含)前,收取40 % 退票费.航班预计离站时间之前4小时(含)前,收取70 % 退票费.航班预计离站之前4小时(不含)后,收取90 % 退票费.
变更规则:航班预计离站时间之前168小时(含)前,收取10 % 改期费.航班预计离站时间之前48小时(含)前,收取30 % 改期费.航班预计离站时间之前4小时(含)前,收取50 % 改期费.航班预计离站之前4小时(不含)后,收取70 % 改期费.
签转规则:不允许
免费托运行李:每件20KG,每人1件,每件体积不超过40×60×100厘米。
免费手提行李:每件5KG,每人1件,每件体积不超过20×40×55厘米。
", //航班退改规则;
"amount":1100.00, //公布运价;(国际机票无公布运价)
"fAmount":5080.00, //头等舱标准价;(国际机票无头等舱标准价)
"cAmount":2030.00, //公务舱标准价;(国际机票无公务舱标准价)
"yAmount":2030.00, //经济舱标准价(国际机票无经济舱标准价)
"mileage":1324, //里程
"isProtocolPrice":1, //协议类型:0非协议票,1三方协议,2两方协议
"destinationCityNameEn":"BeiJing", //到达城市英文名 PM2024123 添加
"destinationNameEng":"BeiJing DaXing AirPort", //到达机场英文名 PM2024123 2024-04-25 添加
"origincityNameEn":"Amsterdam", //出发城市英文名 PM2024123 添加
"originNameEng":"Amsterdam AirPort", //出发机场英文名 PM2024123 2024-04-25 添加
"stopType":1, //有无经停 0无 1有
"stopCityName":"伦敦", //停留城市名称 PM2024123 添加
"stopCityNameEn":"London", //停留城市英文名 PM2024123 添加
"meal":"1", //有无餐食:0 无 1 有 PM2024123 2024-04-25 添加
"airlineNameEng":"China Southern Airlines", //航司英文名 PM2024123 添加
"JourneyIndex":"1", //行程序号 1-第一程;2-第二程;3-第三程
"refundFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //退票规则费用计算
"changeFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //改签规则费用计算
"ticketLuggageRule":
{
"checkRuleInfo": "", //托运行李规则内容(托运汇总内容)
"handRuleInfo": "", //手提行李规则内容(手提汇总内容)
"freeCheckCount":"1", //免费托运行李数量
"freeCheckUnit":"PC", //免费托运行李单位 KG=公斤 PC=件
"freeCheckLuggage":"1PC", //免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”)
"checkDescription":"1件", //托运行李说明
"freeHandCount": "", //免费手提行李数量
"freeHandUnit": "", //免费手提行李单位 KG=公斤 PC=件
"freeHandLuggage": "", //免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”)
"handDescription": "", //手提行李说明
}, //行李额
"refundRuleInfo": "", //退票规则内容
"changeRuleInfo": "", //改签规则内容
"transferRuleInfo": "", //签转规则内容
"segmentIndex":1, //航段序号(1开始,展示用)
"departureDiffHour":0, //出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
"arrivalDiffHour":0, //出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
"originProvinceCN": "", //出发国家省州中文名
"originProvinceEN": "", //出发国家省州英文名
"originContinentCN": "", //出发机场所属大洲中文名
"originContinentEN": "", //出发机场所属大洲英文名
"destinationContinentCN": "", //到达机场所属大洲中文名
"destinationContinentEN": "", //到达机场所属大洲英文名
"departureTimeZone": "", //到达时区
"originTimeZone": "", //出发时区
"originCountryNameEN": "", //出发国家英文名称
"destinationCountryNameEN": "", //到达国家英文名称
"routeType": "", //航线类型,长航线-短航线 暂无实际数据
}], //航段信息
"priceList":
[{
"passengerType":"成人", //旅客类型
"ticketPrice":1100, //机票票面价格(改签时为升舱费)
"tax":50, //机场建设费;国际机票税费
"oilFee":130, //燃油附加费;国际机票无
"servicePrice":10, //服务费
"discount":80, //折扣(8.0折进值为80);国际机票无
"serviceCommission":0, //改签/退票手续费
"usedFlight":0, //已使用航段费
"orderSurcharge":0, //退票详情里的 单据附加费
"passengerCode":"P3510651", //旅客编号
"passengerName":"刘晓东", //旅客姓名
"staffCode":"EMP2110131EAJFM1I", //员工工号
"currency": "", //结算币种
"quotationCurrency":"CNY", //报价币种(预留,暂返回空)
"QuotationPrice":
{
"quotationTicketPrice":0, //机票票面价格(改签时为升舱费)
"quotationTax":0, //机场建设费
"quotationServicePrice":0, //服务费
"quotationServiceCommission":0, //改签/退票手续费
"quotationSellIticketChangefee":0, //国际改签单改签手续费
}, //国际机票,报价价格,多币种报价结算时才使用 暂无实际数据
}], //价格信息
"changeType":0, //变更/改签类型
0:未知
100:自愿
200:非自愿
"changeReason": "", //变更/改签原因
"status":3, //订单状态
"isUatpPay":1, //是否uatp出票(1:是)
"uatpCardNo": "", //uatp卡号(isUatpPay=1时有值)
"uatpSupplier": "", //uatp公司(isUatpPay=1时有值)
"customerCode": "", //大客户编号
"officeCode":"CAN623", //出票Office PM2024113 API接口-订单推送接口增加出票office字段
"pnrBigCode":"KWX1DX", //航司大编码 PM2024123 添加
"quotationLugage":350.00, //报价币种行李额费用
"settlementServiceFee":350.00, //结算币种行程单服务费
"settlementLugage":350.00, //结算币种行李额费用
"quotationServiceFee":350.00, //报价币种行程单服务费
"quotationAmountSaved":350.00, //报价币种三方协议节省金额 暂无实际数据
"settlementAmountSaved":350.00, //结算币种三方协议节省金额 暂无实际数据
"ticketCounter":"美亚国际旅行社", //票台信息 暂无实际数据
"subOrderNo":"TQ255588744", //辅营子单号 暂无实际数据
"exchangeRate":1, //国际机票,结算汇率,多币种结算才使用 暂无实际数据 默认1
"CNYToQuotationExchangeRate":1, //国际机票,汇率(CNY-报价):取人民币转报价币种的汇率,多币种结算才使用 暂无实际数据 默认1
"CNYToSettlementExchangeRate":1, //国际机票,汇率(CNY-结算):取人民币转结算币种的汇率,多币种结算才使用 暂无实际数据 默认1
"deadLineTime":"2023/11/25 0:00:00", //价格有效期(改签单和退票单时,订单需在价格有效期内提交订单,过了有效期会提交订单失败)
"tripId": "", //行程编号
"companyId":"S117955", //公司编号
"failureReason": "", //订单失败原因
"oaOtherInfo":"zjm485215588", //其他信息,个性化客户需要(比如:中奖码)
"firstOrderNo":"TB2024000154", //美亚原购单号
"orderSource":3, //订单来源
"receivePayType":"月结", //支付方式
"affiliateBusinessName":"广东美亚商旅科技有限公司", //供应商
"pnr": "", //pnr
"passengerList":
[{
"reasonId":0, //差旅政策违反原因序号
"reasonRemark": "", //差旅政策违反原因
"errorMessage": "", //退票失败原因(订单为火车票时有值)
"returnStatus": "", //出票状况(订单为火车票时有值)
"seatNo": "", //座席号(订单为火车票时有值)
"originalTicketNo": "", //机票/火车票原票号(改签单时有值)
"belongToCenter":
[{
"centerNo":0, //序号
"centerTitle": "", //归属中心标题
"centerName": "", //归属成本中心选项值
}], //归属中心
"belongToProject": "", //归属项目
"travelPurpose": "", //出行目的
"passengerNo":1, //旅客排序号(从1开始递增)
"passengerCode":"P827827", //旅客编号
"passengerName":"张宇宇", //旅客姓名
"certificateType":"因公护照", //证件类型
"certificateId":"562233", //证件号码
"passengerType":"成人", //旅客类型(成人/儿童/婴儿)
"ticketNo":"2", //机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系)
"staffCode":"WBDDH002", //员工工号
"mobile": "", //旅客手机号码
"email": "", //旅客邮箱,国际机票使用
"statusDesc": "", //客票状态描述
"ticketStatus": "", //票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到
"depName":"0922部门/0922", //部门名称,用/分隔(列表返回最后一级,详细返回全级)
}], //旅客信息
"costList":
[{
"remark": "", //备注
"staffCode": "", //员工工号
"passengerCode":"P409149", //旅客编号
"passengerName":"陈军凤", //旅客名称
"costId":163939, //成本中心编号
"costCenterName":"董事会", //成本中心名称
"amount":240.00, //成本金额
}], //成本中心
"contactInfo":
{
"contactName":"张宇宇", //联系人姓名
"mobile":"15617929598", //手机号
"phone": "", //固定电话
"email":"St87875@meiya.com", //邮箱
}, //联系人信息
"policyList":
[{
"passengerCode":"P415090", //旅客编号
"staffCode":"董事会", //旅客编号
"passengerName":"WBDDH001", //旅客姓名
"policyName":"机票差旅政策一", //政策名称
"policyProperty":"强制", //属性(建议/强制)
"policyType":"基础", //基础/分类/个人/附加
}], //出差政策列表
"StaffPayExcess":false, //个人承担费用,=true 为存在个人承担,false
"PolicyExcessAmount":0.0, //StaffPayExcess=true 时需要关注,个人承担的金额,否则为 0;
"CompanyExcessAmount":818, //StaffPayExcess=true 时需要关注,公司承担的金额;
"c_TextField_2401": "", //客户自定义字段1
"c_TextField_2402": "", //客户自定义字段2
"c_TextField_2403": "", //客户自定义字段3
"c_TextField_2404": "", //客户自定义字段4
"c_TextField_2405": "", //客户自定义字段5
"c_TextField_2406": "", //客户自定义字段6
"c_TextField_2407": "", //客户自定义字段7
"c_TextField_2408": "", //客户自定义字段8
"totalPrice":818.00, //当前订单总金额
"opId": "", //制单人旅客编号
"onBusiness":0, //订单类型(1:因公;0:因私) 注意:如果因私订单不需要的,记得接收时过滤掉
"orderRemark":"订单备注", //订单备注
"outsideOrderNo":"jd20231011022", //客户订单号
"orderNo":"HB2300004135", //美亚订单号
"originalOrderNo": "", //美亚原订单号
"opStaffCode":"WBDDH001", //客户制单人工号
"opName":"张宇宇", //客户制单人
"opDate":"2023-10-20 11:24:26", //下单时间(yyyy-MM-dd HH:mm:ss)
"statusText":"处理成功", //订单状态(名称)
"issueDate":"zjm485215588", //出票日期(yyyy-MM-dd HH:mm:ss)
"oaSerialnumber":"SL58445577484", //客户出差申请单号
"stApplyOrderNo":"EC230005785", //美亚出差申请单号
}, //订单信息(国内国际机票通用)
"orderType":0, //订单类型
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
根据条件查询国际机票订单列表,订退改都适用
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderType |
订单类型
国内机票 0:全部; 1:国内机票订购单; 2:国内机票改签单; 3:国内机票退票单 国际机票 0:全部; 11:国际机票订购单; 12:国际机票改签单; 13:国际机票退票单 |
Integer | 否 | |
originalOrderNo | 美亚原订购单号 | String | 否 | |
staffCode | 制单人的外部系统编号 | String | 否 | |
orderNo | 订单号,单个查则传订单号 | String | 否 | |
departureCity | 出发机场 三字码(如:CAN) | String | 否 | |
arrivalCity | 到达机场 三字码(如:CAN) | String | 否 | |
startTime | 制单时间范围(开始),大于 2023-10-23 00:00:00 | String | 否 | |
endTime | 制单时间范围(结束),小于 2023-10-24 00:00:00 | String | 否 | |
startDepartureTime | 出发时间范围(开始),大于 2023-10-25 00:00:00 | String | 否 | |
endDepartureTime | 出发时间范围(结束),小于 2023-10-28 00:00:00 | String | 否 | |
orderStatus |
订单状态(国际机票只包含:0、40,70,80)
0:全部 5 :待提交 10 :审批中 20 :待收款 25 :待付款 30 :出票中 35 :紧急处理 40 :已出票 50 :已取消 60 :待核对 70 :处理中 75 :紧急处理 80 :已处理 200:待审核 |
Integer | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数(最大50) | Integer | 否 | |
bookType | 0因公 1因私 其他数字查全部(2023-09-25加) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderType":0, //订单类型
"originalOrderNo": "", //美亚原订购单号
"staffCode": "", //制单人的外部系统编号
"orderNo": "", //订单号,单个查则传订单号
"departureCity": "", //出发机场 三字码(如:CAN)
"arrivalCity": "", //到达机场 三字码(如:CAN)
"startTime":"2023-10-23", //制单时间范围(开始),大于 2023-10-23 00:00:00
"endTime":"2023-10-23", //制单时间范围(结束),小于 2023-10-24 00:00:00
"startDepartureTime":"2023-10-25", //出发时间范围(开始),大于 2023-10-25 00:00:00
"endDepartureTime":"2023-10-28", //出发时间范围(结束),小于 2023-10-28 00:00:00
"orderStatus":0, //订单状态(国际机票只包含:0、40,70,80)
"pageIndex":1, //页码
"pageSize":50, //每页记录数(最大50)
"bookType":0, //0因公 1因私 其他数字查全部(2023-09-25加)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
totalCount | 总记录数 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
orderList | 订单信息 | Array[] | ||
companyId | 公司编号 | String | orderList | |
companyName | 公司名称 | String | orderList | |
orderNo | 美亚订单号 | String | orderList | |
originalOrderNo | 原订单编号 改签、退票、废票单的原单编号,订购单时为空 | String | orderList | |
opDate | 建单时间 | String | orderList | |
opId | 建单人 | String | orderList | |
opStaffCode | 建单人员工工号 | String | orderList | |
opName | 客户制单人 | String | orderList | |
onBusiness | 订单类型(1:因公;0:因私) | Integer | orderList | |
receivePayType | 返回字符串,支付方式:月结 或 现结 | String | orderList | |
statusText | 订单状态(中文) | String | orderList | |
status |
订单状态(国际机票只包含:40,70,80)
5 :待提交 10 :审批中 20 :待收款 25 :待付款 30 :出票中 35 :紧急处理 40 :已出票 50 :已取消 60 :待核对 70 :处理中 75 :紧急处理 80 :已处理 200:待审核 |
Integer | orderList | |
orderType |
订单类型
1:国内机票订购单; 2:国内机票改签单; 3:国内机票退票单; 11:国际机票订购单; 12:国际机票改签单; 13:国际机票退票单 |
Integer | orderList | |
oaSerialnumber | 出差申请单号,外部系统关联单号会放这里返回 | String | orderList | |
totalPrice | 订单总金额 | Number | orderList | |
passengerList | 旅客信息 | Array[] | orderList | |
passengerNo | 旅客排序号(从1开始递增) | Integer | orderList.passengerList | |
passengerCode | 旅客编号 | String | orderList.passengerList | |
passengerName | 旅客姓名 | String | orderList.passengerList | |
certificateType | 证件类型 | String | orderList.passengerList | |
certificateId | 证件号码 | String | orderList.passengerList | |
passengerType | 旅客类型(成人/儿童/婴儿) | String | orderList.passengerList | |
ticketNo | 机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系) | String | orderList.passengerList | |
staffCode | 员工工号 | String | orderList.passengerList | |
mobile | 旅客手机号码 | String | orderList.passengerList | |
旅客邮箱,国际机票使用 | String | orderList.passengerList | ||
statusDesc | 客票状态描述 | String | orderList.passengerList | |
ticketStatus | 票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到 | String | orderList.passengerList | |
depName |
部门名称,用/分隔(列表返回最后一级,详细返回全级)
添加日期: 2018-10-18 |
String | orderList.passengerList | |
segmentList | 航段信息 | Array[] | orderList | |
cabin |
舱位等级(1/2/3/4)
1 经济舱 2 公务舱 3 头等舱 4 豪华经济舱 |
String | orderList.segmentList | |
clazz | 小舱位(如:Y/Z/...) | String | orderList.segmentList | |
clazzName | 舱位名称 | String | orderList.segmentList | |
planeType | 机型 | String | orderList.segmentList | |
airlineCode | 销售航司编号(如:HU) | String | orderList.segmentList | |
segmentNo | 航段序号(从1开始) | Integer | orderList.segmentList | |
flightNumber | 销售航班号 | String | orderList.segmentList | |
originName | 出发机场名称 | String | orderList.segmentList | |
originCountryName | 出发地区或国家名称 | String | orderList.segmentList | |
originCountryCode | 出发地区或国家二字码 | String | orderList.segmentList | |
destinationName | 到达机场名称 | String | orderList.segmentList | |
destinationCountryName | 到达地区或国家名称 | String | orderList.segmentList | |
destinationCountryCode | 到达地区或国家二字码 | String | orderList.segmentList | |
departureDate | 出发日期 | String | orderList.segmentList | |
departureTime | 出发时间 | String | orderList.segmentList | |
arrivalDate | 到达日期 | String | orderList.segmentList | |
arrivalTime | 到达时间 | String | orderList.segmentList | |
flyTime | 飞行时间(分钟) | String | orderList.segmentList | |
carrier | 实际承运航班号(如果销售航班号是共享航班号,那么实际承运航班号才有值的) | String | orderList.segmentList | |
stopItem | 经停信息(格式:经停城市|到达时间|起飞时间)(如:上饶|2018-04-23 18:05|2018-04-23 18:55) | String | orderList.segmentList | |
originCityCode | 出发机场编码 | String | orderList.segmentList | |
destinationCityCode | 到达机场编码 | String | orderList.segmentList | |
origincityName | 出发城市名称 | String | orderList.segmentList | |
destinationCityName | 到达城市名称 | String | orderList.segmentList | |
depTerminal | 出发航站楼 | String | orderList.segmentList | |
arrTerminal | 到达航站楼(不详时传 --) | String | orderList.segmentList | |
airlineName | 航司名称 | String | orderList.segmentList | |
remark | 备注 | String | orderList.segmentList | |
ruleInfo | 航班退改规则; | String | orderList.segmentList | |
amount | 公布运价;(国际机票无公布运价) | Number | orderList.segmentList | |
fAmount | 头等舱标准价;(国际机票无头等舱标准价) | Number | orderList.segmentList | |
cAmount | 公务舱标准价;(国际机票无公务舱标准价) | Number | orderList.segmentList | |
yAmount | 经济舱标准价(国际机票无经济舱标准价) | Number | orderList.segmentList | |
mileage |
里程
添加日期: 2024-04-25 |
Number | orderList.segmentList | |
isProtocolPrice |
协议类型:0非协议票,1三方协议,2两方协议
添加日期: 2024-04-25 |
Integer | orderList.segmentList | |
destinationCityNameEn |
到达城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
destinationNameEng |
到达机场英文名 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
origincityNameEn |
出发城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
originNameEng |
出发机场英文名 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
stopType |
有无经停 0无 1有
添加日期: 2024-04-25 |
Integer | orderList.segmentList | |
stopCityName |
停留城市名称 PM2024123 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
stopCityNameEn |
停留城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
meal |
有无餐食:0 无 1 有 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
airlineNameEng |
航司英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | orderList.segmentList | |
JourneyIndex |
行程序号 1-第一程;2-第二程;3-第三程
添加日期: 2024-05-07 |
String | orderList.segmentList | |
refundRuleInfo | 退票规则内容 | String | orderList.segmentList | |
changeRuleInfo | 改签规则内容 | String | orderList.segmentList | |
transferRuleInfo | 签转规则内容 | String | orderList.segmentList | |
segmentIndex |
航段序号(1开始,展示用)
添加日期: 2025-02-12 |
Integer | orderList.segmentList | |
departureDiffHour | 出发地时差 正负数值 2025-03-21之前下单的数据为空值 null | Number | orderList.segmentList | |
arrivalDiffHour |
出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
添加日期: 2025-02-21 |
Number | orderList.segmentList | |
originProvinceCN | 出发国家省州中文名 | String | orderList.segmentList | |
originProvinceEN | 出发国家省州英文名 | String | orderList.segmentList | |
originContinentCN | 出发机场所属大洲中文名 | String | orderList.segmentList | |
originContinentEN | 出发机场所属大洲英文名 | String | orderList.segmentList | |
destinationContinentCN | 到达机场所属大洲中文名 | String | orderList.segmentList | |
destinationContinentEN | 到达机场所属大洲英文名 | String | orderList.segmentList | |
departureTimeZone | 到达时区 | String | orderList.segmentList | |
originTimeZone | 出发时区 | String | orderList.segmentList | |
originCountryNameEN | 出发国家英文名称 | String | orderList.segmentList | |
destinationCountryNameEN | 到达国家英文名称 | String | orderList.segmentList | |
routeType | 航线类型,长航线-短航线 暂无实际数据 | String | orderList.segmentList | |
ticketLuggageRule | 行李额 | TicketLuggageRule | orderList.segmentList | |
checkRuleInfo | 托运行李规则内容(托运汇总内容) | String | orderList.segmentList.ticketLuggageRule | |
handRuleInfo | 手提行李规则内容(手提汇总内容) | String | orderList.segmentList.ticketLuggageRule | |
freeCheckCount | 免费托运行李数量 | String | orderList.segmentList.ticketLuggageRule | |
freeCheckUnit | 免费托运行李单位 KG=公斤 PC=件 | String | orderList.segmentList.ticketLuggageRule | |
freeCheckLuggage | 免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”) | String | orderList.segmentList.ticketLuggageRule | |
checkDescription | 托运行李说明 | String | orderList.segmentList.ticketLuggageRule | |
freeHandCount | 免费手提行李数量 | String | orderList.segmentList.ticketLuggageRule | |
freeHandUnit | 免费手提行李单位 KG=公斤 PC=件 | String | orderList.segmentList.ticketLuggageRule | |
freeHandLuggage | 免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”) | String | orderList.segmentList.ticketLuggageRule | |
handDescription | 手提行李说明 | String | orderList.segmentList.ticketLuggageRule | |
refundFees | 退票规则费用计算 | Array[] | orderList.segmentList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | orderList.segmentList.refundFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | orderList.segmentList.refundFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | orderList.segmentList.refundFees | |
fee | 运算后的退改费用(元) | Number | orderList.segmentList.refundFees | |
baseFee | 运算基数 | Number | orderList.segmentList.refundFees | |
feePercent | 费用百分比 | Number | orderList.segmentList.refundFees | |
minimumFee | 保底费用(元) | Number | orderList.segmentList.refundFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | orderList.segmentList.refundFees | |
timingCount | 计时数量 | Integer | orderList.segmentList.refundFees | |
timingUnit | 计时单位:H 小时、D 天 | String | orderList.segmentList.refundFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | orderList.segmentList.refundFees | |
changeFees | 改签规则费用计算 | Array[] | orderList.segmentList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | orderList.segmentList.changeFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | orderList.segmentList.changeFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | orderList.segmentList.changeFees | |
fee | 运算后的退改费用(元) | Number | orderList.segmentList.changeFees | |
baseFee | 运算基数 | Number | orderList.segmentList.changeFees | |
feePercent | 费用百分比 | Number | orderList.segmentList.changeFees | |
minimumFee | 保底费用(元) | Number | orderList.segmentList.changeFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | orderList.segmentList.changeFees | |
timingCount | 计时数量 | Integer | orderList.segmentList.changeFees | |
timingUnit | 计时单位:H 小时、D 天 | String | orderList.segmentList.changeFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | orderList.segmentList.changeFees |
{
"totalCount":21, //总记录数
"orderList":
[{
"companyId":"S118022", //公司编号
"companyName":"美亚测试股份有限公司", //公司名称
"orderNo":"TB2301738728", //美亚订单号
"originalOrderNo": "", //原订单编号 改签、退票、废票单的原单编号,订购单时为空
"opDate":"2023-10-23 21:46:49", //建单时间
"opId":"P3637330", //建单人
"opStaffCode":"ak10002", //建单人员工工号
"opName":"刘展超", //客户制单人
"onBusiness":1, //订单类型(1:因公;0:因私)
"receivePayType":"月结", //返回字符串,支付方式:月结 或 现结
"statusText":"已出票", //订单状态(中文)
"status":40, //订单状态(国际机票只包含:40,70,80)
"orderType":1, //订单类型
"oaSerialnumber":"SL445885212", //出差申请单号,外部系统关联单号会放这里返回
"totalPrice":1640.00, //订单总金额
"passengerList":
[{
"passengerNo":1, //旅客排序号(从1开始递增)
"passengerCode":"P827827", //旅客编号
"passengerName":"张宇宇", //旅客姓名
"certificateType":"因公护照", //证件类型
"certificateId":"562233", //证件号码
"passengerType":"成人", //旅客类型(成人/儿童/婴儿)
"ticketNo":"2", //机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系)
"staffCode":"WBDDH002", //员工工号
"mobile": "", //旅客手机号码
"email": "", //旅客邮箱,国际机票使用
"statusDesc": "", //客票状态描述
"ticketStatus": "", //票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到
"depName":"0922部门/0922", //部门名称,用/分隔(列表返回最后一级,详细返回全级)
}], //旅客信息
"segmentList":
[{
"cabin":"1", //舱位等级(1/2/3/4)
"clazz":"V", //小舱位(如:Y/Z/...)
"clazzName":"经济舱", //舱位名称
"planeType":"波音737", //机型
"airlineCode":"MF", //销售航司编号(如:HU)
"segmentNo":1, //航段序号(从1开始)
"flightNumber":"MF8969", //销售航班号
"originName":"虹桥国际机场", //出发机场名称
"originCountryName":"中国", //出发地区或国家名称
"originCountryCode":"CN", //出发地区或国家二字码
"destinationName":"经济舱", //到达机场名称
"destinationCountryName":"中国", //到达地区或国家名称
"destinationCountryCode":"CN", //到达地区或国家二字码
"departureDate":"2023-10-23", //出发日期
"departureTime":"14:00", //出发时间
"arrivalDate":"2023-10-23", //到达日期
"arrivalTime":"16:30", //到达时间
"flyTime":"150", //飞行时间(分钟)
"carrier": "", //实际承运航班号(如果销售航班号是共享航班号,那么实际承运航班号才有值的)
"stopItem": "", //经停信息(格式:经停城市|到达时间|起飞时间)(如:上饶|2018-04-23 18:05|2018-04-23 18:55)
"originCityCode":"SHA", //出发机场编码
"destinationCityCode":"SZX", //到达机场编码
"origincityName":"上海", //出发城市名称
"destinationCityName":"深圳", //到达城市名称
"depTerminal":"T1", //出发航站楼
"arrTerminal":"T3", //到达航站楼(不详时传 --)
"airlineName":"厦门航空", //航司名称
"remark":"无", //备注
"ruleInfo":"退票规则:航班预计离站时间之前168小时(含)前,收取20 % 退票费.航班预计离站时间之前48小时(含)前,收取40 % 退票费.航班预计离站时间之前4小时(含)前,收取70 % 退票费.航班预计离站之前4小时(不含)后,收取90 % 退票费.
变更规则:航班预计离站时间之前168小时(含)前,收取10 % 改期费.航班预计离站时间之前48小时(含)前,收取30 % 改期费.航班预计离站时间之前4小时(含)前,收取50 % 改期费.航班预计离站之前4小时(不含)后,收取70 % 改期费.
签转规则:不允许
免费托运行李:每件20KG,每人1件,每件体积不超过40×60×100厘米。
免费手提行李:每件5KG,每人1件,每件体积不超过20×40×55厘米。
", //航班退改规则;
"amount":1100.00, //公布运价;(国际机票无公布运价)
"fAmount":5080.00, //头等舱标准价;(国际机票无头等舱标准价)
"cAmount":2030.00, //公务舱标准价;(国际机票无公务舱标准价)
"yAmount":2030.00, //经济舱标准价(国际机票无经济舱标准价)
"mileage":1324, //里程
"isProtocolPrice":1, //协议类型:0非协议票,1三方协议,2两方协议
"destinationCityNameEn":"BeiJing", //到达城市英文名 PM2024123 添加
"destinationNameEng":"BeiJing DaXing AirPort", //到达机场英文名 PM2024123 2024-04-25 添加
"origincityNameEn":"Amsterdam", //出发城市英文名 PM2024123 添加
"originNameEng":"Amsterdam AirPort", //出发机场英文名 PM2024123 2024-04-25 添加
"stopType":1, //有无经停 0无 1有
"stopCityName":"伦敦", //停留城市名称 PM2024123 添加
"stopCityNameEn":"London", //停留城市英文名 PM2024123 添加
"meal":"1", //有无餐食:0 无 1 有 PM2024123 2024-04-25 添加
"airlineNameEng":"China Southern Airlines", //航司英文名 PM2024123 添加
"JourneyIndex":"1", //行程序号 1-第一程;2-第二程;3-第三程
"refundFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //退票规则费用计算
"changeFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //改签规则费用计算
"ticketLuggageRule":
{
"checkRuleInfo": "", //托运行李规则内容(托运汇总内容)
"handRuleInfo": "", //手提行李规则内容(手提汇总内容)
"freeCheckCount":"1", //免费托运行李数量
"freeCheckUnit":"PC", //免费托运行李单位 KG=公斤 PC=件
"freeCheckLuggage":"1PC", //免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”)
"checkDescription":"1件", //托运行李说明
"freeHandCount": "", //免费手提行李数量
"freeHandUnit": "", //免费手提行李单位 KG=公斤 PC=件
"freeHandLuggage": "", //免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”)
"handDescription": "", //手提行李说明
}, //行李额
"refundRuleInfo": "", //退票规则内容
"changeRuleInfo": "", //改签规则内容
"transferRuleInfo": "", //签转规则内容
"segmentIndex":1, //航段序号(1开始,展示用)
"departureDiffHour":0, //出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
"arrivalDiffHour":0, //出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
"originProvinceCN": "", //出发国家省州中文名
"originProvinceEN": "", //出发国家省州英文名
"originContinentCN": "", //出发机场所属大洲中文名
"originContinentEN": "", //出发机场所属大洲英文名
"destinationContinentCN": "", //到达机场所属大洲中文名
"destinationContinentEN": "", //到达机场所属大洲英文名
"departureTimeZone": "", //到达时区
"originTimeZone": "", //出发时区
"originCountryNameEN": "", //出发国家英文名称
"destinationCountryNameEN": "", //到达国家英文名称
"routeType": "", //航线类型,长航线-短航线 暂无实际数据
}], //航段信息
}], //订单信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国际机票航变动态
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
beginDateTime | 进Q 开始时间 | String | 否 | |
endDateTime | 进Q 结束时间 | String | 否 | |
flightChangeType | 航变类型:1、取消 2、变更 99、未知 | Integer | 否 | |
orderNo | 订单号 国际报价单号 | String | 否 | |
pnr | pnr | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"beginDateTime":"2023-10-24 11:50:00", //进Q 开始时间
"endDateTime":"2023-10-24 23:25:00", //进Q 结束时间
"flightChangeType":0, //航变类型:1、取消 2、变更 99、未知
"orderNo": "", //订单号 国际报价单号
"pnr": "", //pnr
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
noticeList | 动态数据集 | Array[] | ||
orderNo | 订单号,返回报价单号 | String | noticeList | |
pnr | pnr | String | noticeList | |
noticeId | 航变动态ID | String | noticeList | |
flightChangeType | 航变类型:1、取消 2、变更 99、未知 | Integer | noticeList | |
qContext | Q信息内容:取值RTC的文本信息内容 | String | noticeList | |
oldIFlight | 原航班信息 | IFlightSeg | noticeList | |
flightNo | 航班号 | String | noticeList.oldIFlight | |
cabin | 舱等 (1:经济舱 2:公务舱 3:头等舱 4:豪华经济舱) | String | noticeList.oldIFlight | |
departureDate | 计划起飞时间:必填,格式:日期+时间 | String | noticeList.oldIFlight | |
arrivalDate | 计划到达时间:必填,格式:日期+时间 | String | noticeList.oldIFlight | |
departureCity | 始发城市:必填 | String | noticeList.oldIFlight | |
arrivalCity | 目的城市:必填 | String | noticeList.oldIFlight | |
departureAirportName | 始发地机场名称:必填 | String | noticeList.oldIFlight | |
arrivalAirportName | 目的地机场名称:必填 | String | noticeList.oldIFlight | |
departureAirportCode | 始发地机场三字码:必填 | String | noticeList.oldIFlight | |
arrivalAirportCode | 目的地机场三字码:必填 | String | noticeList.oldIFlight | |
depAirportTerminal | 始发地航站楼:非必填 | String | noticeList.oldIFlight | |
arrAirportTerminal | 目的地航站楼:非必填 | String | noticeList.oldIFlight | |
newIFlight | 保护航班信息 | IFlightSeg | noticeList | |
flightNo | 航班号 | String | noticeList.newIFlight | |
cabin | 舱等 (1:经济舱 2:公务舱 3:头等舱 4:豪华经济舱) | String | noticeList.newIFlight | |
departureDate | 计划起飞时间:必填,格式:日期+时间 | String | noticeList.newIFlight | |
arrivalDate | 计划到达时间:必填,格式:日期+时间 | String | noticeList.newIFlight | |
departureCity | 始发城市:必填 | String | noticeList.newIFlight | |
arrivalCity | 目的城市:必填 | String | noticeList.newIFlight | |
departureAirportName | 始发地机场名称:必填 | String | noticeList.newIFlight | |
arrivalAirportName | 目的地机场名称:必填 | String | noticeList.newIFlight | |
departureAirportCode | 始发地机场三字码:必填 | String | noticeList.newIFlight | |
arrivalAirportCode | 目的地机场三字码:必填 | String | noticeList.newIFlight | |
depAirportTerminal | 始发地航站楼:非必填 | String | noticeList.newIFlight | |
arrAirportTerminal | 目的地航站楼:非必填 | String | noticeList.newIFlight |
{
"noticeList":
[{
"orderNo":"QT2300114871", //订单号,返回报价单号
"pnr":"JXKD0L", //pnr
"noticeId":"7810198433", //航变动态ID
"flightChangeType":99, //航变类型:1、取消 2、变更 99、未知
"qContext":" **ELECTRONIC TICKET PNR**
007 HDQCA 9983 1004 24OCT
1.SHEN/WEIJUN(001) JXKD0L
001 2. FM815 T SU05NOV SHAHND HK1 0905 1230 E T13
NN(001) DK(001) HK(001)
001 3.CAN/T CAN/T 020-28260407/GUANGDONG MEIYA BUSINESS TRAVEL TECHNOLOGY
CO., LTD/RAY
001 4.15652060677
005 5.T
003 6.SSR OTHS 1E KK1 FM0815TSHAHND05NOV23 SHAHND SHAHND
004 7.SSR ADTK 1E BY CAN27OCT23/1800 OR CXL FM815 T05NOV
007 8.SSR TKNE FM HK1 SHAHND 815 T05NOV 7812661863687/1/P1 +
001 9.SSR DOCS FM HK1 P/CN/EK0160169/CN/16JUL81/M/01MAR33/SHEN/WEIJUN/P1 -
HK(001)
001 10.SSR CTCE FM HK1 YOKI//MEIYA.COM/P1
HK(001)
001 11.OSI FM CTCT18814144359
001 12.OSI FM CTCM17610527952/P1
005 13.RMK TJ CAN623
001 14.RMK CHANNEL TMC/API
001 15.RMK AGENT S126161/S126161
001 16.RMK SERVICE YOKI/22000068/18814144359
001 17.RMK EMAIL YOKI//MEIYA.COM
002 18.RMK CA/PXKR0S +
005 19.FN/A/FCNY1670.00/SCNY1670.00/C4.00/XCNY405.00/TCNY90.00CN/TCNY315.00YQ/ -
ACNY2075.00
005 20.TN/781-2661863687/P1
005 21.FP/CASH,CNY
001 22.CAN623 +
", //Q信息内容:取值RTC的文本信息内容
"oldIFlight":
{
"flightNo": "", //航班号
"cabin": "", //舱等 (1:经济舱 2:公务舱 3:头等舱 4:豪华经济舱)
"departureDate": "", //计划起飞时间:必填,格式:日期+时间
"arrivalDate": "", //计划到达时间:必填,格式:日期+时间
"departureCity": "", //始发城市:必填
"arrivalCity": "", //目的城市:必填
"departureAirportName": "", //始发地机场名称:必填
"arrivalAirportName": "", //目的地机场名称:必填
"departureAirportCode": "", //始发地机场三字码:必填
"arrivalAirportCode": "", //目的地机场三字码:必填
"depAirportTerminal": "", //始发地航站楼:非必填
"arrAirportTerminal": "", //目的地航站楼:非必填
}, //原航班信息
"newIFlight":
{
"flightNo": "", //航班号
"cabin": "", //舱等 (1:经济舱 2:公务舱 3:头等舱 4:豪华经济舱)
"departureDate": "", //计划起飞时间:必填,格式:日期+时间
"arrivalDate": "", //计划到达时间:必填,格式:日期+时间
"departureCity": "", //始发城市:必填
"arrivalCity": "", //目的城市:必填
"departureAirportName": "", //始发地机场名称:必填
"arrivalAirportName": "", //目的地机场名称:必填
"departureAirportCode": "", //始发地机场三字码:必填
"arrivalAirportCode": "", //目的地机场三字码:必填
"depAirportTerminal": "", //始发地航站楼:非必填
"arrAirportTerminal": "", //目的地航站楼:非必填
}, //保护航班信息
}], //动态数据集
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
departureCity | 出发城市三字码 | String | 是 | |
arrivalCity | 达到城市三字码 | String | 是 | |
departureDate | 离开日期 | String | 是 | |
arrivalDate | 返回日期,非必填,往返才需要 | String | 否 | |
tripType | 行程类型;1:单程 2:往返 3:多程() | String | 是 | |
isDFO | 是否仅直飞 T是 F否 | String | 是 | |
airline | 航司二字码 | String | 否 | |
cabinClass | 舱位等级,必传 1-经济舱,2-公务舱,3-头等舱,4-豪华经济舱;暂不支持全舱位查询 | String | 否 | |
passengerList | 非必填,如果传了旅客外部编号时,多个旅客用逗号间隔,为空时仅可会获取产品类型是协议、自营产品 | Array[] | 否 | |
receivePayType | 0-信用付 ;1-即付 | String | 是 | |
mixClass | PM2023084添加 是否允许混舱:0.不允许 1.允许 默认不允许 | String | 否 | |
checkInLuggage | PM2023084添加 免费托运行李:1.不限免费托运行李 2.仅查免费托运行李,默认1 | String | 否 | |
isRefund | PM2023084添加 是否可退票:1.不限 2.仅查可退票,默认1 | String | 否 | |
isChange | PM2023084添加 是否可改期:1.不限 2.仅查可改期,默认1 | String | 否 | |
asynchronousReturn | PM2023084添加是否异步加载:1. 同步 2.异步,默认1 | Integer | 否 | |
asyReturnKey | PM2023084添加异步返回key,多次查询使用 | String | 否 | |
userName | 账号名称(美亚提供) | String | 是 | |
timeStamp | 请求时间(北京时间),10分钟有效,超出范围认为时间过期 格式:yyyyMMddHHmmss | String | 是 | |
password | Md5(companyId+userName+timeStamp+signkey), utf8编码加密后32位小写字母 signkey 由美亚提供 | String | 是 | |
companyId | 公司编号 | String | 是 | |
passengerTypeAndNumber | PM2023084添加旅客人数,必填默认1 | Array[] | 否 | |
type | 旅客类型;成人,儿童,婴儿 | String | passengerTypeAndNumber | |
count | 数量 | Integer | passengerTypeAndNumber | |
journeys | 多程时,journeys 必传(目前只支持新版国际机票(2023-09-25加)) | Array[] | 否 | |
departureCityCode | 出发城市三字码 | String | journeys | |
arrivalCityCode | 到达城市三字码 | String | journeys | |
departureDate | 出发日期 | String | journeys |
{
"departureCity":"SHA", //出发城市三字码
"arrivalCity":"CAN", //达到城市三字码
"departureDate":"2023-10-25", //离开日期
"arrivalDate":"2023-10-29", //返回日期,非必填,往返才需要
"tripType":"1", //行程类型;1:单程 2:往返 3:多程()
"isDFO":"F", //是否仅直飞 T是 F否
"airline":"CA", //航司二字码
"cabinClass":"1", //舱位等级,必传 1-经济舱,2-公务舱,3-头等舱,4-豪华经济舱;暂不支持全舱位查询
"passengerList":"[ak10002,ak10003]", //非必填,如果传了旅客外部编号时,多个旅客用逗号间隔,为空时仅可会获取产品类型是协议、自营产品
"receivePayType":"0", //0-信用付 ;1-即付
"mixClass":"0", //PM2023084添加 是否允许混舱:0.不允许 1.允许 默认不允许
"checkInLuggage":"1", //PM2023084添加 免费托运行李:1.不限免费托运行李 2.仅查免费托运行李,默认1
"isRefund":"1", //PM2023084添加 是否可退票:1.不限 2.仅查可退票,默认1
"isChange":"1", //PM2023084添加 是否可改期:1.不限 2.仅查可改期,默认1
"passengerTypeAndNumber":
[{
"type":"成人", //旅客类型;成人,儿童,婴儿
"count":1, //数量
}], //PM2023084添加旅客人数,必填默认1
"asynchronousReturn":1, //PM2023084添加是否异步加载:1. 同步 2.异步,默认1
"asyReturnKey":"1", //PM2023084添加异步返回key,多次查询使用
"journeys":
[{
"departureCityCode":"SHA", //出发城市三字码
"arrivalCityCode":"CAN", //到达城市三字码
"departureDate":"1", //出发日期
}], //多程时,journeys 必传(目前只支持新版国际机票(2023-09-25加))
"userName": "", //账号名称(美亚提供)
"timeStamp": "", //请求时间(北京时间),10分钟有效,超出范围认为时间过期
格式:yyyyMMddHHmmss
"password": "", //Md5(companyId+userName+timeStamp+signkey), utf8编码加密后32位小写字母
signkey 由美亚提供
"companyId":"S118022", //公司编号
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
finish | 查询是否结束:0未结束可继续,1表示查询已结束无更多报价; | String | ||
asyReturnKey | 异步返回key,多次查询使用 | String | ||
resultId | ST的唯一号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
flightInfoList | Array[] | |||
platingCarrier | 销售航司 | String | flightInfoList | |
flightId | 航程Id,新版已不使用该参数,忽略 | Integer | flightInfoList | |
tripId | PM2023084添加 新版返回tripId代替flightId | String | flightInfoList | |
IsChangePrice | PM2023084添加 是否变价 | Boolean | flightInfoList | |
IsChangeCabin | PM2023084添加 是否变舱 | Boolean | flightInfoList | |
IsChangeFlight | PM2023084添加 航班信息是否变更 | Boolean | flightInfoList | |
origin | PM2023084添加 运价起点城市三字码 | String | flightInfoList | |
ctcm | PM2023084添加 CTCM,旅客联系号码 | CTCM | flightInfoList | |
isRequiredMobileAll | 旅客必须全部有手机号码 | Boolean | flightInfoList.ctcm | |
isNotRepeatMobile | 手机号码是否不能重复 | Boolean | flightInfoList.ctcm | |
isRequiredMobileOne | 必须选择手机号码有一个 | Boolean | flightInfoList.ctcm | |
priceInfos | 价格信息 | Array[] | flightInfoList | |
solutionId | PM2023084添加 方案Id | String | flightInfoList.priceInfos | |
passengerType | 乘客类型,PASSENGER_ADULT,PASSENGER_CHILD,PASSENGER_BABY, | String | flightInfoList.priceInfos | |
passengerTypeCount | 乘客数量 | String | flightInfoList.priceInfos | |
activeTime | PM2023084添加 票价出票时限 | String | flightInfoList.priceInfos | |
proofType | PM2023084添加 报销凭证:1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,7=按政策设置,8=无 | Integer | flightInfoList.priceInfos | |
baseFare | 销售 -- 票面价 | Number | flightInfoList.priceInfos | |
tax | 销售 - 税 | Number | flightInfoList.priceInfos | |
servicePriceTotal | 服务费合计 | Number | flightInfoList.priceInfos | |
protocolStrategryCode | 三方协议产品编号 | String | flightInfoList.priceInfos | |
protocolShowType | 协议类型显示标识((0代表不显示、1代表显示协议、2代表显示美亚特惠)) | Integer | flightInfoList.priceInfos | |
source | 来源 (IBEPLUS航司接口;syber) | String | flightInfoList.priceInfos | |
fareType | 票证类型(10 美亚BSP,20 境外票,30 B2B, 40非美亚BSP,50航司直连) | String | flightInfoList.priceInfos | |
isRequireCertificate | 证件号是否为必填 | Boolean | flightInfoList.priceInfos | |
currency | 结算币种 | String | flightInfoList.priceInfos | |
FrequentTravellers | 常旅客计划 | Array[] | flightInfoList.priceInfos | |
airlineCode | 航司二字代码 | String | flightInfoList.priceInfos.FrequentTravellers | |
name | 常旅客计划中文名 | String | flightInfoList.priceInfos.FrequentTravellers | |
enName | 常旅客计划英文名 | String | flightInfoList.priceInfos.FrequentTravellers | |
SupportCertificates | 支持的证件类型 | Array[] | flightInfoList.priceInfos | |
certificateType | 证件类型 | String | flightInfoList.priceInfos.SupportCertificates | |
certificateTypeName | 证件类型中文名 | String | flightInfoList.priceInfos.SupportCertificates | |
CountryOrAreas | 国家或国家地区代码,空为不限 | Array[] | flightInfoList.priceInfos.SupportCertificates | |
code | 国家或国家地区代码 | String | flightInfoList.priceInfos.SupportCertificates.CountryOrAreas | |
name | 国家或国家地区中文名称 | String | flightInfoList.priceInfos.SupportCertificates.CountryOrAreas | |
Clazzs | 舱位信息 | Array[] | flightInfoList.priceInfos | |
flightId | 航班序号,对应航段信息里的flightId | String | flightInfoList.priceInfos.Clazzs | |
clazzNo | 舱位编码; 示例:P | String | flightInfoList.priceInfos.Clazzs | |
classLevel | 舱等;1-经济舱;2-商务舱;3-头等舱;4-豪华经济舱 | String | flightInfoList.priceInfos.Clazzs | |
seatNo | 座位数 | String | flightInfoList.priceInfos.Clazzs | |
policy | 差旅政策 | PolicyType | flightInfoList.priceInfos | |
farePriceType | 票价类型,公有 = 0,私有 = 1,协议= 2 | String | flightInfoList.priceInfos.policy | |
isHaveTravelItinerary | 是否有行程单 | Boolean | flightInfoList.priceInfos.policy | |
travelItinerary | 报销凭证,1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,8=无 | String | flightInfoList.priceInfos.policy | |
group | 团价信息 | GroupInfo | flightInfoList.priceInfos.policy | |
groupTag | 按逻辑运算符合数字拼装 | String | flightInfoList.priceInfos.policy.group | |
content | 内容,比如,此价格仅限2-9人 | String | flightInfoList.priceInfos.policy.group | |
structor | 团价结构化信息 json化 | String | flightInfoList.priceInfos.policy.group | |
supplierService | 供应商服务内容 | PolicySupplierServiceDto | flightInfoList.priceInfos.policy | |
Change | 改签 | SupplierServiceChangeDto | flightInfoList.priceInfos.policy.supplierService | |
Content | 服务内容 | String | flightInfoList.priceInfos.policy.supplierService.Change | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | flightInfoList.priceInfos.policy.supplierService.Change | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | flightInfoList.priceInfos.policy.supplierService.Change.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | flightInfoList.priceInfos.policy.supplierService.Change.ServiceTime | |
Refund | 退票 | SupplierServiceRefundDto | flightInfoList.priceInfos.policy.supplierService | |
Content | 服务内容 | String | flightInfoList.priceInfos.policy.supplierService.Refund | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | flightInfoList.priceInfos.policy.supplierService.Refund | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | flightInfoList.priceInfos.policy.supplierService.Refund.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | flightInfoList.priceInfos.policy.supplierService.Refund.ServiceTime | |
Issue | 出票 | SupplierServiceIssueDto | flightInfoList.priceInfos.policy.supplierService | |
ServicerType | 服务商类型(0=美亚自营,1=供应商提供服务) | Integer | flightInfoList.priceInfos.policy.supplierService.Issue | |
Content | 服务内容 | String | flightInfoList.priceInfos.policy.supplierService.Issue | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | flightInfoList.priceInfos.policy.supplierService.Issue | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | flightInfoList.priceInfos.policy.supplierService.Issue.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | flightInfoList.priceInfos.policy.supplierService.Issue.ServiceTime | |
Void | 作废 | SupplierServiceVoidDto | flightInfoList.priceInfos.policy.supplierService | |
IsCanVoid | 是否可以废票 | Boolean | flightInfoList.priceInfos.policy.supplierService.Void | |
VoidEffective | 作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认] | Integer | flightInfoList.priceInfos.policy.supplierService.Void | |
VoidTicketingDeadline | 废票截止时间 格式 yyyy-MM-ddTHH:mm:ss | String | flightInfoList.priceInfos.policy.supplierService.Void | |
Content | 服务内容 | String | flightInfoList.priceInfos.policy.supplierService.Void | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | flightInfoList.priceInfos.policy.supplierService.Void | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | flightInfoList.priceInfos.policy.supplierService.Void.ServiceTime | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | flightInfoList.priceInfos.policy.supplierService.Void.ServiceTime | |
limiting | 限制信息 | PricePolicyLimitingDto | flightInfoList.priceInfos.policy | |
conentHadTheme | String | flightInfoList.priceInfos.policy.limiting | ||
contents | 限制内容 | Array[] | flightInfoList.priceInfos.policy.limiting | |
isRequiredCertificatePhoto | 是否需要证件照片 | Boolean | flightInfoList.priceInfos.policy.limiting | |
age | 年龄限制 | LimitingAgeDto | flightInfoList.priceInfos.policy.limiting | |
minAge | 最小年龄 | Integer | flightInfoList.priceInfos.policy.limiting.age | |
maxAge | 最大年龄 | Integer | flightInfoList.priceInfos.policy.limiting.age | |
typeName | 类型名称 | String | flightInfoList.priceInfos.policy.limiting.age | |
content | 限制内容 | String | flightInfoList.priceInfos.policy.limiting.age | |
nationalityOrArea | 国家或区域限制 | LimitingNationalityOrAreaDto | flightInfoList.priceInfos.policy.limiting | |
limitingCondition | 国籍限制条件:允许 true/不允许 false | Boolean | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
nationalityOrAreaNames | 国籍/地区名称 | Array[] | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
nationalityOrAreaCodes | 国籍/地区二字码 | Array[] | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
typeName | 类型名称 | String | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
content | 限制内容 | String | flightInfoList.priceInfos.policy.limiting.nationalityOrArea | |
passagerCount | 旅客人数限制 | LimitingPassagerCountDto | flightInfoList.priceInfos.policy.limiting | |
minCount | 最小数量 | Integer | flightInfoList.priceInfos.policy.limiting.passagerCount | |
maxCount | 最大数量 | Integer | flightInfoList.priceInfos.policy.limiting.passagerCount | |
isMustBeEvenNumber | 是否必须偶数 | Boolean | flightInfoList.priceInfos.policy.limiting.passagerCount | |
typeName | 类型名称 | String | flightInfoList.priceInfos.policy.limiting.passagerCount | |
content | 限制内容 | String | flightInfoList.priceInfos.policy.limiting.passagerCount | |
certificate | 证件限制 | LimitingCertificateDto | flightInfoList.priceInfos.policy.limiting | |
limitingCondition | 证件类型名称限制条件:允许 true/不允许 false | Boolean | flightInfoList.priceInfos.policy.limiting.certificate | |
certificateTypeNames | 证件类型名称 | Array[] | flightInfoList.priceInfos.policy.limiting.certificate | |
certificateTypeCodes | 证件类型编码 | Array[] | flightInfoList.priceInfos.policy.limiting.certificate | |
certificateTypes | 证件类型 | Array[] | flightInfoList.priceInfos.policy.limiting.certificate | |
typeName | 类型名称 | String | flightInfoList.priceInfos.policy.limiting.certificate | |
content | 限制内容 | String | flightInfoList.priceInfos.policy.limiting.certificate | |
rule | 结构化退改规则 | ShoppingRule | flightInfoList.priceInfos | |
MinStay | 最短停留时间 | String | flightInfoList.priceInfos.rule | |
MaxStay | 最长停留时间 | String | flightInfoList.priceInfos.rule | |
Refund | 退票 | String | flightInfoList.priceInfos.rule | |
Change | 改签 | String | flightInfoList.priceInfos.rule | |
NoShow | 误机 | String | flightInfoList.priceInfos.rule | |
OtherInfo | 其他说明 | String | flightInfoList.priceInfos.rule | |
Structor | 结构化客规 | Structor | flightInfoList.priceInfos.rule | |
AdvanceReservation | 提前预定说明 | RuleStructAdvance | flightInfoList.priceInfos.rule.Structor | |
Unit | 提前预定时间单位 D=天,M=月,Y=年 | String | flightInfoList.priceInfos.rule.Structor.AdvanceReservation | |
Length | 提前预定时间 | String | flightInfoList.priceInfos.rule.Structor.AdvanceReservation | |
MinStay | 最短停留 | StructStay | flightInfoList.priceInfos.rule.Structor | |
Unit | 最短或最长停留单位 D=天,M=月,Y=年 | String | flightInfoList.priceInfos.rule.Structor.MinStay | |
Length | 最短或最长停留时间 | String | flightInfoList.priceInfos.rule.Structor.MinStay | |
Unlimited | 是否无限制,true表示无限制,此时不用看时长 | String | flightInfoList.priceInfos.rule.Structor.MinStay | |
Date | 最短停留日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.MinStay | |
Text | 非必输 String 信息描述 | String | flightInfoList.priceInfos.rule.Structor.MinStay | |
MaxStay | 最长停留 | StructStay | flightInfoList.priceInfos.rule.Structor | |
Unit | 最短或最长停留单位 D=天,M=月,Y=年 | String | flightInfoList.priceInfos.rule.Structor.MaxStay | |
Length | 最短或最长停留时间 | String | flightInfoList.priceInfos.rule.Structor.MaxStay | |
Unlimited | 是否无限制,true表示无限制,此时不用看时长 | String | flightInfoList.priceInfos.rule.Structor.MaxStay | |
Date | 最短停留日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.MaxStay | |
Text | 非必输 String 信息描述 | String | flightInfoList.priceInfos.rule.Structor.MaxStay | |
NoshowRefunds | 结构化客规误机退票 | Array[] | flightInfoList.priceInfos.rule.Structor | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | flightInfoList.priceInfos.rule.Structor.NoshowRefunds | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | flightInfoList.priceInfos.rule.Structor.NoshowRefunds | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | flightInfoList.priceInfos.rule.Structor.NoshowRefunds | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | flightInfoList.priceInfos.rule.Structor.NoshowRefunds | |
Currency | 币种 | String | flightInfoList.priceInfos.rule.Structor.NoshowRefunds | |
Text | 原文信息描述 | String | flightInfoList.priceInfos.rule.Structor.NoshowRefunds | |
NoshowChanges | 结构化客规误机改签 | Array[] | flightInfoList.priceInfos.rule.Structor | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | flightInfoList.priceInfos.rule.Structor.NoshowChanges | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | flightInfoList.priceInfos.rule.Structor.NoshowChanges | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | flightInfoList.priceInfos.rule.Structor.NoshowChanges | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | flightInfoList.priceInfos.rule.Structor.NoshowChanges | |
Currency | 币种 | String | flightInfoList.priceInfos.rule.Structor.NoshowChanges | |
Text | 原文信息描述 | String | flightInfoList.priceInfos.rule.Structor.NoshowChanges | |
Refunds | 结构化客规退票 | Array[] | flightInfoList.priceInfos.rule.Structor | |
TypeCode | 退票类型 可返值[before or after] | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | flightInfoList.priceInfos.rule.Structor.Refunds | |
Fee | 退票罚金 | Number | flightInfoList.priceInfos.rule.Structor.Refunds | |
Currency | 币种 | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
Text | 原文信息描述 | String | flightInfoList.priceInfos.rule.Structor.Refunds | |
Changes | 结构化客规改签 | Array[] | flightInfoList.priceInfos.rule.Structor | |
TypeCode | 退票类型 可返值[before or after] | String | flightInfoList.priceInfos.rule.Structor.Changes | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | flightInfoList.priceInfos.rule.Structor.Changes | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | flightInfoList.priceInfos.rule.Structor.Changes | |
Fee | 退票罚金 | Number | flightInfoList.priceInfos.rule.Structor.Changes | |
Currency | 币种 | String | flightInfoList.priceInfos.rule.Structor.Changes | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Changes | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Changes | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Changes | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | flightInfoList.priceInfos.rule.Structor.Changes | |
Text | 原文信息描述 | String | flightInfoList.priceInfos.rule.Structor.Changes | |
luggageList | PM2024166_国际标准API搜索、更多价格接口返回值增加行李额字段 | Array[] | flightInfoList.priceInfos | |
flightNo | 航班号 | String | flightInfoList.priceInfos.luggageList | |
departureCityName | 出发城市名称 | String | flightInfoList.priceInfos.luggageList | |
arrivalCityName | 到达城市名称 | String | flightInfoList.priceInfos.luggageList | |
departureCityCode | 出发城市三字码 | String | flightInfoList.priceInfos.luggageList | |
arrivalCityCode | 到达城市三字码 | String | flightInfoList.priceInfos.luggageList | |
checkInLuggagePieces | 免费托运行李件数 | String | flightInfoList.priceInfos.luggageList | |
checkInLuggageWeight | 免费托运行李重量 | String | flightInfoList.priceInfos.luggageList | |
checkInLuggageDemision | 免费托运行李体积 | String | flightInfoList.priceInfos.luggageList | |
checkInLuggageText | 行李额描述(免费托运行李) 新增字段,长宽高文本 | String | flightInfoList.priceInfos.luggageList | |
handLuggagePieces | 手提行李件数,允许件数(免费手提行李) | String | flightInfoList.priceInfos.luggageList | |
handLuggageWeight | 允许重量(免费手提行李) | String | flightInfoList.priceInfos.luggageList | |
handLuggageDemision | 体积(免费手提行李) | String | flightInfoList.priceInfos.luggageList | |
handLuggageText | 行李额描述(免费手提行李)长宽高文本 | String | flightInfoList.priceInfos.luggageList | |
seatBag | 随身物品内容 | LuaggageStructDto | flightInfoList.priceInfos.luggageList | |
Pieces | String | flightInfoList.priceInfos.luggageList.seatBag | ||
Weight | String | flightInfoList.priceInfos.luggageList.seatBag | ||
Demision | String | flightInfoList.priceInfos.luggageList.seatBag | ||
Description | String | flightInfoList.priceInfos.luggageList.seatBag | ||
CheckStruct | 托运行李结构化 | LuaggageStructDto | flightInfoList.priceInfos.luggageList | |
Pieces | String | flightInfoList.priceInfos.luggageList.CheckStruct | ||
Weight | String | flightInfoList.priceInfos.luggageList.CheckStruct | ||
Demision | String | flightInfoList.priceInfos.luggageList.CheckStruct | ||
Description | String | flightInfoList.priceInfos.luggageList.CheckStruct | ||
HandStruct | 手提行李结构化 | LuaggageStructDto | flightInfoList.priceInfos.luggageList | |
Pieces | String | flightInfoList.priceInfos.luggageList.HandStruct | ||
Weight | String | flightInfoList.priceInfos.luggageList.HandStruct | ||
Demision | String | flightInfoList.priceInfos.luggageList.HandStruct | ||
Description | String | flightInfoList.priceInfos.luggageList.HandStruct | ||
flightInfos | 航班信息 | Array[] | flightInfoList | |
segmentId | 在此集合中的ID | Integer | flightInfoList.flightInfos | |
flightId | 航程Id | String | flightInfoList.flightInfos | |
tripType | 行程类别,0第一程(去程) 、1第二程(回程)、2第三程(多程) | String | flightInfoList.flightInfos | |
journeyIndex | 行程序号(从1开始的自然数。表示第几个航程) | String | flightInfoList.flightInfos | |
departureAirport | 出发机场 | String | flightInfoList.flightInfos | |
arrivalAirport | 目的机场 | String | flightInfoList.flightInfos | |
termDep | 起飞航站楼 | String | flightInfoList.flightInfos | |
termArr | 到达航站楼 | String | flightInfoList.flightInfos | |
depAirportName | 出发机场中文名称 | String | flightInfoList.flightInfos | |
arrAirportName | 到达机场中文名称 | String | flightInfoList.flightInfos | |
depCity | 出发城市三字码 | String | flightInfoList.flightInfos | |
arrCity | 到达城市三字码 | String | flightInfoList.flightInfos | |
depCityName | 出发城市中文名称 | String | flightInfoList.flightInfos | |
arrCityName | 到达城市中文名称 | String | flightInfoList.flightInfos | |
departureDate | 出发日期 | String | flightInfoList.flightInfos | |
departuretimeModify | 本航段的起飞日期修正,例如+1表示第二天 | String | flightInfoList.flightInfos | |
departureTime | 出发时间 | String | flightInfoList.flightInfos | |
arrivalDate | 到达日期 | String | flightInfoList.flightInfos | |
arrivaltimeModify | 得到本航段的到达日期修正,例如+1表示第二天 | String | flightInfoList.flightInfos | |
arrivalTime | 到达时间 | String | flightInfoList.flightInfos | |
marketingAirline | 销售航司 | String | flightInfoList.flightInfos | |
marketingAirlineName_CN | 销售航司 中文名 | String | flightInfoList.flightInfos | |
airlineAllianceCode | 航司联盟(STARALLIANCE=星空联盟,ONEWORLD=寰宇一家,SKYTEAM=天合联盟) | String | flightInfoList.flightInfos | |
flightNumber | 航班号 | String | flightInfoList.flightInfos | |
operatingCarrier | 实际承运航空公司,共享航班才有值 | String | flightInfoList.flightInfos | |
operatingFlightNumber | 实际承运航班号 ,共享航班才有值 | String | flightInfoList.flightInfos | |
equipment | 机型类别代码 | String | flightInfoList.flightInfos | |
equipmentName | 机型类别代码 | String | flightInfoList.flightInfos | |
equipmentEnName | 机型英文名称 | String | flightInfoList.flightInfos | |
equipmentBodyName | 机型型号 | String | flightInfoList.flightInfos | |
equipmentBodyType | 机型类型 1小型、2中型、3大型 | String | flightInfoList.flightInfos | |
equipmentMaxPassengers | 机型最大载客数 | String | flightInfoList.flightInfos | |
equipmentMinPassengers | 机型最小载客数 | String | flightInfoList.flightInfos | |
equipmentType | 航班载体类型(0=飞机,1=火车,2=汽车,3=船) | String | flightInfoList.flightInfos | |
planeType | 超宽体 宽体 窄体 未知 | String | flightInfoList.flightInfos | |
duration | 飞行时间,单位为分钟 | String | flightInfoList.flightInfos | |
distance | 飞行距离,单位为KM | String | flightInfoList.flightInfos | |
depWorldRegionCode | 出发 世界区域 | String | flightInfoList.flightInfos | |
intermediateAirports | 经停信息 | Array[] | flightInfoList.flightInfos | |
clazz | 航位 | String | flightInfoList.flightInfos | |
cabin | 航等;1 经济舱 2 公务舱 3 头等舱 4 超级经济舱 | String | flightInfoList.flightInfos | |
seatNo | 座位数 | String | flightInfoList.flightInfos | |
LuggageHangingType | 行李直挂类型 1不允许直挂 2允许直挂明细规则 3未知 | String | flightInfoList.flightInfos | |
VisaType | 过境签类型 1 需要过境签 2可能需过境签 3不需要过境签 4其它 | String | flightInfoList.flightInfos | |
VisaContent | 非必输 String 过境签内容说明 | String | flightInfoList.flightInfos | |
isFood | 是否有食物 | Boolean | flightInfoList.flightInfos | |
stops | 新经停(使用这个) | Array[] | flightInfoList.flightInfos | |
airportCode | 经停机场 | String | flightInfoList.flightInfos.stops | |
airportName | 经停机场名称 | String | flightInfoList.flightInfos.stops | |
cityCode | 经停城市 | String | flightInfoList.flightInfos.stops | |
cityName | 经停名称 | String | flightInfoList.flightInfos.stops | |
duration | 经停时间 HH:mm | String | flightInfoList.flightInfos.stops | |
arrivalDate | 到达时间 格式 yyyy-MM-dd | String | flightInfoList.flightInfos.stops | |
arrivalTime | 到达时间 格式 HH:mm | String | flightInfoList.flightInfos.stops | |
departureDate | 起飞日期 格式 yyyy-MM-dd | String | flightInfoList.flightInfos.stops | |
departureTime | 起飞时间 格式 HH:mm | String | flightInfoList.flightInfos.stops | |
FlightDetailDto | 航班详细信息 | FlightDetailDto | flightInfoList.flightInfos | |
FlightProperty | 航班属性flightProperty字段枚举值说明:枚举值0-国内-国内 1-国内-国际 2-国内-地区 3-地区-国际 4-国际-国际 | String | flightInfoList.flightInfos.FlightDetailDto | |
AvgPlanDuration | 未来平均计划时间: HH:mm | String | flightInfoList.flightInfos.FlightDetailDto | |
DepAvgDelayTime | 平均出发延误时间(分钟): 15 | String | flightInfoList.flightInfos.FlightDetailDto | |
ArrAvgDelayTime | 平均到达延误时间(分钟): 10 | String | flightInfoList.flightInfos.FlightDetailDto | |
DepBridgeRate | 出港靠桥率: 80% | String | flightInfoList.flightInfos.FlightDetailDto | |
ArrBridgeRate | 进港靠桥率: 75% | String | flightInfoList.flightInfos.FlightDetailDto | |
DepOnTimeRate | 出发准点率: 90% | String | flightInfoList.flightInfos.FlightDetailDto | |
ArrOnTimeRate | 到达准点率: 85% | String | flightInfoList.flightInfos.FlightDetailDto | |
AircraftAge | 平均机龄: 5年 | String | flightInfoList.flightInfos.FlightDetailDto | |
ThemeFlight | 主题航班: 无 | String | flightInfoList.flightInfos.FlightDetailDto | |
Luggage | 行李限额描述: 免费托运20公斤 | String | flightInfoList.flightInfos.FlightDetailDto | |
Cabins | 舱位信息 | Array[] | flightInfoList.flightInfos.FlightDetailDto | |
ClassLevel | 舱等 经济舱 = 1,公务舱 = 2,头等舱 = 3,豪华经济舱 = 4 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
PerCapita | 人均碳排放量,单位:千克: 100kg | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
InTotal | 总碳排放量,单位:千克: 200kg | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
PerCapitaTree | 人均消耗树量,单位:棵: 1棵树 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
SeatWidth | 座位宽度: 17.5英寸 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
SeatTilt | 座椅倾斜度: 可调节 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins | |
Beverage | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Beverage | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Beverage | |
Entertainment | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Entertainment | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Entertainment | |
Food | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Food | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Food | |
Power | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Power | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Power | |
Wifi | FlightDetailCabinAmenitiesDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Wifi | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Wifi | |
Layout | FlightDetailCabinLayoutDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
RowLayout | 3-3 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Layout | |
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Layout | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Layout | |
Seat | FlightDetailCabinSeatDto | flightInfoList.flightInfos.FlightDetailDto.Cabins | ||
Pitch | "34" | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Seat | |
DescZh | 中文描述 | String | flightInfoList.flightInfos.FlightDetailDto.Cabins.Seat | |
IsExist | 是否存在 | Boolean | flightInfoList.flightInfos.FlightDetailDto.Cabins.Seat |
{
"flightInfoList":
[{
"platingCarrier":"CX", //销售航司
"flightId":0, //航程Id,新版已不使用该参数,忽略
"tripId":"173279100981c8ee7e99ecdf1d3f12c8", //PM2023084添加 新版返回tripId代替flightId
"IsChangePrice":false, //PM2023084添加 是否变价
"IsChangeCabin":false, //PM2023084添加 是否变舱
"IsChangeFlight":false, //PM2023084添加 航班信息是否变更
"origin": "", //PM2023084添加 运价起点城市三字码
"ctcm":"null", //PM2023084添加 CTCM,旅客联系号码
"flightInfos":
[{
"segmentId":0, //在此集合中的ID
"flightId":"1206PEKHKGCX393", //航程Id
"tripType":"0", //行程类别,0第一程(去程) 、1第二程(回程)、2第三程(多程)
"journeyIndex":"1", //行程序号(从1开始的自然数。表示第几个航程)
"departureAirport":"PEK", //出发机场
"arrivalAirport":"HKG", //目的机场
"termDep":"3", //起飞航站楼
"termArr":"1", //到达航站楼
"depAirportName":"首都国际机场", //出发机场中文名称
"arrAirportName":"香港国际机场", //到达机场中文名称
"depCity":"BJS", //出发城市三字码
"arrCity":"HKG", //到达城市三字码
"depCityName":"北京", //出发城市中文名称
"arrCityName":"中国香港", //到达城市中文名称
"departureDate":"2023-12-06", //出发日期
"departuretimeModify": "", //本航段的起飞日期修正,例如+1表示第二天
"departureTime":"18:35", //出发时间
"arrivalDate":"2023-12-06", //到达日期
"arrivaltimeModify": "", //得到本航段的到达日期修正,例如+1表示第二天
"arrivalTime":"22:25", //到达时间
"marketingAirline":"CX", //销售航司
"marketingAirlineName_CN":"国泰航空", //销售航司 中文名
"airlineAllianceCode":"STARALLIANCE", //航司联盟(STARALLIANCE=星空联盟,ONEWORLD=寰宇一家,SKYTEAM=天合联盟)
"flightNumber":"393", //航班号
"operatingCarrier": "", //实际承运航空公司,共享航班才有值
"operatingFlightNumber": "", //实际承运航班号 ,共享航班才有值
"equipment":"333", //机型类别代码
"equipmentName":"空客330", //机型类别代码
"equipmentEnName":"Airbus A330", //机型英文名称
"equipmentBodyName":"空客330", //机型型号
"equipmentBodyType":"3", //机型类型 1小型、2中型、3大型
"equipmentMaxPassengers":"100", //机型最大载客数
"equipmentMinPassengers":"30", //机型最小载客数
"equipmentType":"0", //航班载体类型(0=飞机,1=火车,2=汽车,3=船)
"planeType":"宽体", //超宽体 宽体 窄体 未知
"duration":"230", //飞行时间,单位为分钟
"distance":"1234", //飞行距离,单位为KM
"depWorldRegionCode": "", //出发 世界区域
"intermediateAirports":"null", //经停信息
"clazz":"V", //航位
"cabin":"1", //航等;1 经济舱 2 公务舱 3 头等舱 4 超级经济舱
"seatNo":"9", //座位数
"stops":
[{
"airportCode":"WUH", //经停机场
"airportName":"天河国际机场", //经停机场名称
"cityCode":"WUH", //经停城市
"cityName":"武汉", //经停名称
"duration": "", //经停时间 HH:mm
"arrivalDate": "", //到达时间 格式 yyyy-MM-dd
"arrivalTime": "", //到达时间 格式 HH:mm
"departureDate": "", //起飞日期 格式 yyyy-MM-dd
"departureTime": "", //起飞时间 格式 HH:mm
}], //新经停(使用这个)
"LuggageHangingType":"1", //行李直挂类型 1不允许直挂 2允许直挂明细规则 3未知
"VisaType":"3", //过境签类型 1 需要过境签 2可能需过境签 3不需要过境签 4其它
"VisaContent":"国际旅客无需签证即可在马来西亚过境。", //非必输 String 过境签内容说明
"isFood":true, //是否有食物
"FlightDetailDto":
{
"FlightProperty": "", //航班属性flightProperty字段枚举值说明:枚举值0-国内-国内 1-国内-国际 2-国内-地区 3-地区-国际 4-国际-国际
"AvgPlanDuration": "", //未来平均计划时间: HH:mm
"DepAvgDelayTime": "", //平均出发延误时间(分钟): 15
"ArrAvgDelayTime": "", //平均到达延误时间(分钟): 10
"DepBridgeRate": "", //出港靠桥率: 80%
"ArrBridgeRate": "", //进港靠桥率: 75%
"DepOnTimeRate": "", //出发准点率: 90%
"ArrOnTimeRate": "", //到达准点率: 85%
"AircraftAge": "", //平均机龄: 5年
"Cabins":
[{
"ClassLevel": "", //舱等 经济舱 = 1,公务舱 = 2,头等舱 = 3,豪华经济舱 = 4
"PerCapita": "", //人均碳排放量,单位:千克: 100kg
"InTotal": "", //总碳排放量,单位:千克: 200kg
"PerCapitaTree": "", //人均消耗树量,单位:棵: 1棵树
"SeatWidth": "", //座位宽度: 17.5英寸
"SeatTilt": "", //座椅倾斜度: 可调节
"Beverage":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Entertainment":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Food":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Layout":
{
"RowLayout": "", //3-3
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Power":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Seat":
{
"Pitch": "", //"34"
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
"Wifi":
{
"DescZh": "", //中文描述
"IsExist":false, //是否存在
}, //
}], //舱位信息
"ThemeFlight": "", //主题航班: 无
"Luggage": "", //行李限额描述: 免费托运20公斤
}, //航班详细信息
}], //航班信息
"priceInfos":
[{
"Clazzs":
[{
"flightId":"9", //航班序号,对应航段信息里的flightId
"clazzNo":"9", //舱位编码; 示例:P
"classLevel":"1", //舱等;1-经济舱;2-商务舱;3-头等舱;4-豪华经济舱
"seatNo":"9", //座位数
}], //舱位信息
"solutionId":"6e151d0b039b4eeaabb59fdac2d0051c", //PM2023084添加 方案Id
"passengerType":"PASSENGER_ADULT", //乘客类型,PASSENGER_ADULT,PASSENGER_CHILD,PASSENGER_BABY,
"passengerTypeCount":"1", //乘客数量
"activeTime":"2023-12-06 12:45:00", //PM2023084添加 票价出票时限
"proofType":1, //PM2023084添加 报销凭证:1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,7=按政策设置,8=无
"baseFare":6490, //销售 -- 票面价
"tax":1356.0, //销售 - 税
"servicePriceTotal":0.0, //服务费合计
"protocolStrategryCode":"TBOrderInfo", //三方协议产品编号
"protocolShowType":0, //协议类型显示标识((0代表不显示、1代表显示协议、2代表显示美亚特惠))
"source":"IBEPLUS", //来源 (IBEPLUS航司接口;syber)
"fareType":"10", //票证类型(10 美亚BSP,20 境外票,30 B2B, 40非美亚BSP,50航司直连)
"luggageList":
[{
"flightNo": "", //航班号
"departureCityName":"北京", //出发城市名称
"arrivalCityName":"青岛", //到达城市名称
"departureCityCode":"BJS", //出发城市三字码
"arrivalCityCode":"TAO", //到达城市三字码
"checkInLuggagePieces":"2", //免费托运行李件数
"checkInLuggageWeight": "", //免费托运行李重量
"checkInLuggageDemision": "", //免费托运行李体积
"checkInLuggageText": "", //行李额描述(免费托运行李) 新增字段,长宽高文本
"handLuggagePieces":"1", //手提行李件数,允许件数(免费手提行李)
"handLuggageWeight": "", //允许重量(免费手提行李)
"handLuggageDemision": "", //体积(免费手提行李)
"handLuggageText": "", //行李额描述(免费手提行李)长宽高文本
"seatBag":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //随身物品内容
"CheckStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //托运行李结构化
"HandStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //手提行李结构化
}], //PM2024166_国际标准API搜索、更多价格接口返回值增加行李额字段
"rule":
{
"MinStay": "", //最短停留时间
"MaxStay": "", //最长停留时间
"Refund": "", //退票
"Change": "", //改签
"NoShow": "", //误机
"OtherInfo": "", //其他说明
"Structor":
{
"Refunds":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //结构化客规退票
"Changes":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //结构化客规改签
"NoshowRefunds":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //结构化客规误机退票
"NoshowChanges":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //结构化客规误机改签
"MinStay":
{
"Unit": "", //最短或最长停留单位 D=天,M=月,Y=年
"Length": "", //最短或最长停留时间
"Unlimited": "", //是否无限制,true表示无限制,此时不用看时长
"Date": "", //最短停留日期 yyyy-MM-dd
"Text": "", //非必输 String 信息描述
}, //最短停留
"MaxStay":
{
"Unit": "", //最短或最长停留单位 D=天,M=月,Y=年
"Length": "", //最短或最长停留时间
"Unlimited": "", //是否无限制,true表示无限制,此时不用看时长
"Date": "", //最短停留日期 yyyy-MM-dd
"Text": "", //非必输 String 信息描述
}, //最长停留
"AdvanceReservation":
{
"Unit":"KG", //提前预定时间单位 D=天,M=月,Y=年
"Length":"KG", //提前预定时间
}, //提前预定说明
}, //结构化客规
}, //结构化退改规则
"policy":
{
"farePriceType": "", //票价类型,公有 = 0,私有 = 1,协议= 2
"isHaveTravelItinerary":false, //是否有行程单
"travelItinerary": "", //报销凭证,1=普通行程单,2=中性行程单,3=普通+中性行程单,4=境外电子凭证,5=电子发票,6=纸质发票,8=无
"group":
{
"groupTag": "", //按逻辑运算符合数字拼装
"content": "", //内容,比如,此价格仅限2-9人
"structor": "", //团价结构化信息 json化
}, //团价信息
"supplierService":
{
"Issue":
{
"ServicerType":0, //服务商类型(0=美亚自营,1=供应商提供服务)
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //出票
"Change":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //改签
"Refund":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //退票
"Void":
{
"IsCanVoid":false, //是否可以废票
"VoidEffective":0, //作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认]
"VoidTicketingDeadline": "", //废票截止时间 格式 yyyy-MM-ddTHH:mm:ss
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //作废
}, //供应商服务内容
"limiting":
{
"conentHadTheme": "", //
"contents":[], //限制内容
"isRequiredCertificatePhoto":false, //是否需要证件照片
"nationalityOrArea":
{
"limitingCondition":false, //国籍限制条件:允许 true/不允许 false
"nationalityOrAreaNames":[], //国籍/地区名称
"nationalityOrAreaCodes":[], //国籍/地区二字码
"typeName": "", //类型名称
"content": "", //限制内容
}, //国家或区域限制
"certificate":
{
"limitingCondition":false, //证件类型名称限制条件:允许 true/不允许 false
"certificateTypeNames":[], //证件类型名称
"certificateTypeCodes":[], //证件类型编码
"certificateTypes":[], //证件类型
"typeName": "", //类型名称
"content": "", //限制内容
}, //证件限制
"age":
{
"minAge":0, //最小年龄
"maxAge":0, //最大年龄
"typeName": "", //类型名称
"content": "", //限制内容
}, //年龄限制
"passagerCount":
{
"minCount":0, //最小数量
"maxCount":0, //最大数量
"isMustBeEvenNumber":false, //是否必须偶数
"typeName": "", //类型名称
"content": "", //限制内容
}, //旅客人数限制
}, //限制信息
}, //差旅政策
"FrequentTravellers":
[{
"airlineCode": "", //航司二字代码
"name": "", //常旅客计划中文名
"enName": "", //常旅客计划英文名
}], //常旅客计划
"isRequireCertificate":false, //证件号是否为必填
"SupportCertificates":
[{
"certificateType": "", //证件类型
"certificateTypeName": "", //证件类型中文名
"CountryOrAreas":
[{
"code": "", //国家或国家地区代码
"name": "", //国家或国家地区中文名称
}], //国家或国家地区代码,空为不限
}], //支持的证件类型
"currency":"CNY", //结算币种
}], //价格信息
}], //
"finish":"1", //查询是否结束:0未结束可继续,1表示查询已结束无更多报价;
"asyReturnKey":"965eae861c534eb2b689f739e45e010e", //异步返回key,多次查询使用
"resultId":"965eae861c534eb2b689f739e45e010e", //ST的唯一号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
resultId | 当前查询航班返回结果的唯一号 | String | 是 | |
tripId | PM2023084添加 新版返回tripId代替flightId | String | 否 | |
solutionId | PM2023084添加 方案Id | String | 否 | |
userName | 账号名称(美亚提供) | String | 是 | |
timeStamp | 请求时间(北京时间),10分钟有效,超出范围认为时间过期 格式:yyyyMMddHHmmss | String | 是 | |
password | Md5(companyId+userName+timeStamp+signkey), utf8编码加密后32位小写字母 signkey 由美亚提供 | String | 是 | |
companyId | 公司编号 | String | 是 |
{
"resultId":"fb2f091a18324cf2ac4910115ca006d8", //当前查询航班返回结果的唯一号
"tripId":"0dd2390dbc444224566da481f78bed43", //PM2023084添加 新版返回tripId代替flightId
"solutionId":"11c5a5d7a1234f84982a8ce2b2cae8dc", //PM2023084添加 方案Id
"userName": "", //账号名称(美亚提供)
"timeStamp": "", //请求时间(北京时间),10分钟有效,超出范围认为时间过期
格式:yyyyMMddHHmmss
"password": "", //Md5(companyId+userName+timeStamp+signkey), utf8编码加密后32位小写字母
signkey 由美亚提供
"companyId":"S118022", //公司编号
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
airRule | 条款 | AirRule | ||
remark | 备注 | String | airRule | |
SupplierService | 供应商服务内容 | PolicySupplierServiceDto | airRule | |
Change | 改签 | SupplierServiceChangeDto | airRule.SupplierService | |
Content | 服务内容 | String | airRule.SupplierService.Change | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | airRule.SupplierService.Change | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | airRule.SupplierService.Change.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Change.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Change.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | airRule.SupplierService.Change.ServiceTime | |
Content | 服务内容 | String | airRule.SupplierService.Change.ServiceTime.All | |
Normals | 正常时间 | Array[] | airRule.SupplierService.Change.ServiceTime.All | |
WeekDay | 星期几 ,CHoliday=其他法定节假日 | String | airRule.SupplierService.Change.ServiceTime.All.Normals | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Change.ServiceTime.All.Normals | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Change.ServiceTime.All.Normals | |
Specials | 特殊时间 | Array[] | airRule.SupplierService.Change.ServiceTime.All | |
StartDay | 开始日期(yyyy-MM-dd) | String | airRule.SupplierService.Change.ServiceTime.All.Specials | |
EndDay | 结束日期(yyyy-MM-dd) | String | airRule.SupplierService.Change.ServiceTime.All.Specials | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Change.ServiceTime.All.Specials | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Change.ServiceTime.All.Specials | |
Refund | 退票 | SupplierServiceRefundDto | airRule.SupplierService | |
Content | 服务内容 | String | airRule.SupplierService.Refund | |
ServiceTime | 服务费时间 | SupplierServiceTimeDto | airRule.SupplierService.Refund | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | airRule.SupplierService.Refund.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Refund.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Refund.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | airRule.SupplierService.Refund.ServiceTime | |
Content | 服务内容 | String | airRule.SupplierService.Refund.ServiceTime.All | |
Normals | 正常时间 | Array[] | airRule.SupplierService.Refund.ServiceTime.All | |
WeekDay | 星期几 ,CHoliday=其他法定节假日 | String | airRule.SupplierService.Refund.ServiceTime.All.Normals | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Refund.ServiceTime.All.Normals | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Refund.ServiceTime.All.Normals | |
Specials | 特殊时间 | Array[] | airRule.SupplierService.Refund.ServiceTime.All | |
StartDay | 开始日期(yyyy-MM-dd) | String | airRule.SupplierService.Refund.ServiceTime.All.Specials | |
EndDay | 结束日期(yyyy-MM-dd) | String | airRule.SupplierService.Refund.ServiceTime.All.Specials | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Refund.ServiceTime.All.Specials | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Refund.ServiceTime.All.Specials | |
Issue | 出票 | SupplierServiceIssueDto | airRule.SupplierService | |
ServicerType | 服务商类型(0=美亚自营,1=供应商提供服务) | Integer | airRule.SupplierService.Issue | |
Content | 服务内容 | String | airRule.SupplierService.Issue | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | airRule.SupplierService.Issue | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | airRule.SupplierService.Issue.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Issue.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Issue.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | airRule.SupplierService.Issue.ServiceTime | |
Content | 服务内容 | String | airRule.SupplierService.Issue.ServiceTime.All | |
Normals | 正常时间 | Array[] | airRule.SupplierService.Issue.ServiceTime.All | |
WeekDay | 星期几 ,CHoliday=其他法定节假日 | String | airRule.SupplierService.Issue.ServiceTime.All.Normals | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Issue.ServiceTime.All.Normals | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Issue.ServiceTime.All.Normals | |
Specials | 特殊时间 | Array[] | airRule.SupplierService.Issue.ServiceTime.All | |
StartDay | 开始日期(yyyy-MM-dd) | String | airRule.SupplierService.Issue.ServiceTime.All.Specials | |
EndDay | 结束日期(yyyy-MM-dd) | String | airRule.SupplierService.Issue.ServiceTime.All.Specials | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Issue.ServiceTime.All.Specials | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Issue.ServiceTime.All.Specials | |
Void | 作废 | SupplierServiceVoidDto | airRule.SupplierService | |
IsCanVoid | 是否可以废票 | Boolean | airRule.SupplierService.Void | |
VoidEffective | 作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认] | Integer | airRule.SupplierService.Void | |
VoidTicketingDeadline | 废票截止时间 格式 yyyy-MM-ddTHH:mm:ss | String | airRule.SupplierService.Void | |
Content | 服务内容 | String | airRule.SupplierService.Void | |
ServiceTime | 服务时间 | SupplierServiceTimeDto | airRule.SupplierService.Void | |
Today | 今日服务费时间 | SupplierServiceTimeTodayDto | airRule.SupplierService.Void.ServiceTime | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Void.ServiceTime.Today | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Void.ServiceTime.Today | |
All | 全部服务费时间 | SupplierServiceTimeAllDto | airRule.SupplierService.Void.ServiceTime | |
Content | 服务内容 | String | airRule.SupplierService.Void.ServiceTime.All | |
Normals | 正常时间 | Array[] | airRule.SupplierService.Void.ServiceTime.All | |
WeekDay | 星期几 ,CHoliday=其他法定节假日 | String | airRule.SupplierService.Void.ServiceTime.All.Normals | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Void.ServiceTime.All.Normals | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Void.ServiceTime.All.Normals | |
Specials | 特殊时间 | Array[] | airRule.SupplierService.Void.ServiceTime.All | |
StartDay | 开始日期(yyyy-MM-dd) | String | airRule.SupplierService.Void.ServiceTime.All.Specials | |
EndDay | 结束日期(yyyy-MM-dd) | String | airRule.SupplierService.Void.ServiceTime.All.Specials | |
StartTime | 开始时间(HH:mm:ss) | String | airRule.SupplierService.Void.ServiceTime.All.Specials | |
EndTime | 结束时间(HH:mm:ss) | String | airRule.SupplierService.Void.ServiceTime.All.Specials | |
airRuleList | 退改条款详情 | Array[] | airRule | |
origin | 运价起点城市三字码 | String | airRule.airRuleList | |
destination | 运价终点城市三字码 | String | airRule.airRuleList | |
minStay | 最短停留时间 | String | airRule.airRuleList | |
maxStay | 最长停留时间 | String | airRule.airRuleList | |
refund | 退票 | String | airRule.airRuleList | |
change | 改签 | String | airRule.airRuleList | |
delay | 延误 | String | airRule.airRuleList | |
luggage | 行李额 | String | airRule.airRuleList | |
NoshowRefunds | PM2023084添加 结构化退票规则 | Array[] | airRule.airRuleList | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | airRule.airRuleList.NoshowRefunds | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | airRule.airRuleList.NoshowRefunds | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | airRule.airRuleList.NoshowRefunds | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | airRule.airRuleList.NoshowRefunds | |
Currency | 币种 | String | airRule.airRuleList.NoshowRefunds | |
Text | 原文信息描述 | String | airRule.airRuleList.NoshowRefunds | |
NoshowChanges | PM2023084添加 结构化改签规则 | Array[] | airRule.airRuleList | |
IsAllowed | NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许 | String | airRule.airRuleList.NoshowChanges | |
IsAppend | NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否 | String | airRule.airRuleList.NoshowChanges | |
Condition | 起飞前多少小时算noshow 默认给0 | Integer | airRule.airRuleList.NoshowChanges | |
Fee | NoshowRefunds:退票罚金;NoshowChanges:改签罚金 | Number | airRule.airRuleList.NoshowChanges | |
Currency | 币种 | String | airRule.airRuleList.NoshowChanges | |
Text | 原文信息描述 | String | airRule.airRuleList.NoshowChanges | |
Refunds | PM2023084添加 退票规则详情 | Array[] | airRule.airRuleList | |
TypeCode | 退票类型 可返值[before or after] | String | airRule.airRuleList.Refunds | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | airRule.airRuleList.Refunds | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | airRule.airRuleList.Refunds | |
Fee | 退票罚金 | Number | airRule.airRuleList.Refunds | |
Currency | 币种 | String | airRule.airRuleList.Refunds | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | airRule.airRuleList.Refunds | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | airRule.airRuleList.Refunds | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | airRule.airRuleList.Refunds | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | airRule.airRuleList.Refunds | |
Text | 原文信息描述 | String | airRule.airRuleList.Refunds | |
Changes | PM2023084添加 改签规则详情 | Array[] | airRule.airRuleList | |
TypeCode | 退票类型 可返值[before or after] | String | airRule.airRuleList.Changes | |
StatusCode | 退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用 | String | airRule.airRuleList.Changes | |
Condition | 起飞前或者起飞后多少小时 默认给0 | Integer | airRule.airRuleList.Changes | |
Fee | 退票罚金 | Number | airRule.airRuleList.Changes | |
Currency | 币种 | String | airRule.airRuleList.Changes | |
TravelDateFrom | 旅行有效期起始日期 yyyy-MM-dd | String | airRule.airRuleList.Changes | |
TravelDateTo | 旅行有效期截止日期 yyyy-MM-dd | String | airRule.airRuleList.Changes | |
TicketDateFrom | Ticket有效期起始日期 yyyy-MM-dd | String | airRule.airRuleList.Changes | |
TicketDateTo | Ticket有效期截止日期 yyyy-MM-dd | String | airRule.airRuleList.Changes | |
Text | 原文信息描述 | String | airRule.airRuleList.Changes | |
luggageList | PM2023084添加 行李额 | Array[] | airRule.airRuleList | |
flightNo | 航班号 | String | airRule.airRuleList.luggageList | |
departureCityName | 出发城市名称 | String | airRule.airRuleList.luggageList | |
arrivalCityName | 到达城市名称 | String | airRule.airRuleList.luggageList | |
departureCityCode | 出发城市三字码 | String | airRule.airRuleList.luggageList | |
arrivalCityCode | 到达城市三字码 | String | airRule.airRuleList.luggageList | |
checkInLuggagePieces | 免费托运行李件数 | String | airRule.airRuleList.luggageList | |
checkInLuggageWeight | 免费托运行李重量 | String | airRule.airRuleList.luggageList | |
checkInLuggageDemision | 免费托运行李体积 | String | airRule.airRuleList.luggageList | |
checkInLuggageText | 行李额描述(免费托运行李) 新增字段,长宽高文本 | String | airRule.airRuleList.luggageList | |
handLuggagePieces | 手提行李件数,允许件数(免费手提行李) | String | airRule.airRuleList.luggageList | |
handLuggageWeight | 允许重量(免费手提行李) | String | airRule.airRuleList.luggageList | |
handLuggageDemision | 体积(免费手提行李) | String | airRule.airRuleList.luggageList | |
handLuggageText | 行李额描述(免费手提行李)长宽高文本 | String | airRule.airRuleList.luggageList | |
seatBag | 随身物品内容 | LuaggageStructDto | airRule.airRuleList.luggageList | |
Pieces | String | airRule.airRuleList.luggageList.seatBag | ||
Weight | String | airRule.airRuleList.luggageList.seatBag | ||
Demision | String | airRule.airRuleList.luggageList.seatBag | ||
Description | String | airRule.airRuleList.luggageList.seatBag | ||
CheckStruct | 托运行李结构化 | LuaggageStructDto | airRule.airRuleList.luggageList | |
Pieces | String | airRule.airRuleList.luggageList.CheckStruct | ||
Weight | String | airRule.airRuleList.luggageList.CheckStruct | ||
Demision | String | airRule.airRuleList.luggageList.CheckStruct | ||
Description | String | airRule.airRuleList.luggageList.CheckStruct | ||
HandStruct | 手提行李结构化 | LuaggageStructDto | airRule.airRuleList.luggageList | |
Pieces | String | airRule.airRuleList.luggageList.HandStruct | ||
Weight | String | airRule.airRuleList.luggageList.HandStruct | ||
Demision | String | airRule.airRuleList.luggageList.HandStruct | ||
Description | String | airRule.airRuleList.luggageList.HandStruct |
{
"airRule":
{
"airRuleList":
[{
"origin":"BJS", //运价起点城市三字码
"destination":"SEL", //运价终点城市三字码
"minStay": "", //最短停留时间
"maxStay": "", //最长停留时间
"refund":"不允许", //退票
"change":"不允许", //改签
"delay":"误机发生后退票需额外收取误机费300元。误机发生后更改需额外收取误机费300元", //延误
"luggage":"北京(BJS)-青岛(TAO):托运免费行李:件数:2;托运说明:免费托运行李:2件。手持免费行李:件数:1;手持说明:免费手提行李:1件。青岛(TAO)-首尔(SEL):托运免费行李:件数:2;托运说明:免费托运行李:2件。手持免费行李:件数:1;手持说明:免费手提行李:1件。", //行李额
"luggageList":
[{
"flightNo": "", //航班号
"departureCityName":"北京", //出发城市名称
"arrivalCityName":"青岛", //到达城市名称
"departureCityCode":"BJS", //出发城市三字码
"arrivalCityCode":"TAO", //到达城市三字码
"checkInLuggagePieces":"2", //免费托运行李件数
"checkInLuggageWeight": "", //免费托运行李重量
"checkInLuggageDemision": "", //免费托运行李体积
"checkInLuggageText": "", //行李额描述(免费托运行李) 新增字段,长宽高文本
"handLuggagePieces":"1", //手提行李件数,允许件数(免费手提行李)
"handLuggageWeight": "", //允许重量(免费手提行李)
"handLuggageDemision": "", //体积(免费手提行李)
"handLuggageText": "", //行李额描述(免费手提行李)长宽高文本
"seatBag":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //随身物品内容
"CheckStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //托运行李结构化
"HandStruct":
{
"Pieces": "", //
"Weight": "", //
"Demision": "", //
"Description": "", //
}, //手提行李结构化
}], //PM2023084添加 行李额
"Refunds":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //PM2023084添加 退票规则详情
"Changes":
[{
"TypeCode": "", //退票类型 可返值[before or after]
"StatusCode":"T", //退票标识 T:不可退 H:有条件退 F:允许,免费 P:允许,可能收取费用
"Condition":0, //起飞前或者起飞后多少小时 默认给0
"Fee":0, //退票罚金
"Currency": "", //币种
"TravelDateFrom": "", //旅行有效期起始日期 yyyy-MM-dd
"TravelDateTo": "", //旅行有效期截止日期 yyyy-MM-dd
"TicketDateFrom": "", //Ticket有效期起始日期 yyyy-MM-dd
"TicketDateTo": "", //Ticket有效期截止日期 yyyy-MM-dd
"Text": "", //原文信息描述
}], //PM2023084添加 改签规则详情
"NoshowRefunds":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //PM2023084添加 结构化退票规则
"NoshowChanges":
[{
"IsAllowed":"F", //NoshowRefunds:是否允许退 F=允许 T=不允许;NoshowChanges:是否允许改 F=允许 T=不允许
"IsAppend":"F", //NoshowRefunds:误机时退票是否叠加误机费 F=是 T=否;NoshowChanges:误机时改签是否叠加误机费 F=是 T=否
"Condition":0, //起飞前多少小时算noshow 默认给0
"Fee":300.0, //NoshowRefunds:退票罚金;NoshowChanges:改签罚金
"Currency":"CNY", //币种
"Text": "", //原文信息描述
}], //PM2023084添加 结构化改签规则
}], //退改条款详情
"remark":"无", //备注
"SupplierService":
{
"Issue":
{
"ServicerType":0, //服务商类型(0=美亚自营,1=供应商提供服务)
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //出票
"Change":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //改签
"Refund":
{
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务费时间
"Content": "", //服务内容
}, //退票
"Void":
{
"IsCanVoid":false, //是否可以废票
"VoidEffective":0, //作废时效 [1=按北京时间当天,2=按出票地时间当天,3=需供应商确认]
"VoidTicketingDeadline": "", //废票截止时间 格式 yyyy-MM-ddTHH:mm:ss
"ServiceTime":
{
"Today":
{
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}, //今日服务费时间
"All":
{
"Normals":
[{
"WeekDay": "", //星期几 ,CHoliday=其他法定节假日
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //正常时间
"Specials":
[{
"StartDay": "", //开始日期(yyyy-MM-dd)
"EndDay": "", //结束日期(yyyy-MM-dd)
"StartTime": "", //开始时间(HH:mm:ss)
"EndTime": "", //结束时间(HH:mm:ss)
}], //特殊时间
"Content": "", //服务内容
}, //全部服务费时间
}, //服务时间
"Content": "", //服务内容
}, //作废
}, //供应商服务内容
}, //条款
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
resultId | 当前查询航班返回结果的唯一号 | String | 是 | |
tripId | PM2023084添加 新版返回tripId代替flightId | String | 是 | |
solutionId | PM2023084添加 方案Id | String | 是 | |
segmentId | 航段ID | Integer | 是 | |
userName | 账号名称(美亚提供) | String | 是 | |
timeStamp | 请求时间(北京时间),10分钟有效,超出范围认为时间过期 格式:yyyyMMddHHmmss | String | 是 | |
password | Md5(companyId+userName+timeStamp+signkey), utf8编码加密后32位小写字母 signkey 由美亚提供 | String | 是 | |
companyId | 公司编号 | String | 是 |
{
"resultId":"fb2f091a18324cf2ac4910115ca006d8", //当前查询航班返回结果的唯一号
"tripId":"0dd2390dbc444224566da481f78bed43", //PM2023084添加 新版返回tripId代替flightId
"solutionId":"11c5a5d7a1234f84982a8ce2b2cae8dc", //PM2023084添加 方案Id
"segmentId":0, //航段ID
"userName": "", //账号名称(美亚提供)
"timeStamp": "", //请求时间(北京时间),10分钟有效,超出范围认为时间过期
格式:yyyyMMddHHmmss
"password": "", //Md5(companyId+userName+timeStamp+signkey), utf8编码加密后32位小写字母
signkey 由美亚提供
"companyId":"S118022", //公司编号
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
guid | 当前查询航班返回结果的唯一号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
iFlightStops | 经停信息 | Array[] | ||
airportCode | 机场编码 | String | iFlightStops | |
airportName | 机场名称 | String | iFlightStops | |
cityCode | 城市编码 | String | iFlightStops | |
cityName | 城市名称 | String | iFlightStops | |
arrivalDate | 达到日期 | String | iFlightStops | |
arrivalTime | 到达时间 | String | iFlightStops | |
departureDate | 出发日期 | String | iFlightStops | |
departureTime | 出发时间 | String | iFlightStops |
{
"guid":"0dd2390dbc444224566da481f78bed43", //当前查询航班返回结果的唯一号
"iFlightStops":
[{
"airportCode":"HKG", //机场编码
"airportName":"香港国际机场", //机场名称
"cityCode":"HKG", //城市编码
"cityName":"中国香港", //城市名称
"arrivalDate":"2023-10-25", //达到日期
"arrivalTime":"10:25", //到达时间
"departureDate":"2023-10-25", //出发日期
"departureTime":"3:50", //出发时间
}], //经停信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
askPriceOrderNo | 询价单号 | String | 否 | |
opPhone | 制单人电话 | String | 是 | |
opName | 制单人姓名 | String | 是 | |
outsideOpId | 制单人工号 | String | 是 | |
deadLineTime | 截止时间(格式yyyy-MM-dd HH:mm:ss) | String | 是 | |
outAskPriceOrderNo | 外部询价单号 | String | 是 | |
tripType | 行程类型 -1不限 0 单程 1 往返 2 多段 | Integer | 是 | |
classLevel | 舱位等级 -1不限 0 经济 1 公务 2 头等 3豪华经济舱 | Integer | 是 | |
isDirectFlight | 是否直飞( -1不限 0 否 1 是) | Integer | 是 | |
budgetPrice | 预算费用 | String | 是 | |
companyRemark | 客户备注 | String | 是 | |
receivePayType | 应收支付类型(1:在线消费 2:信用消费);3-预存款支付 | String | 是 | |
bookType | 0-因公 默认不传;1-因私; | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
passengerTypes | 询价单旅客类型 | Array[] | 是 | |
passengerType | 类型 0成人 1儿童 2婴儿 | String | passengerTypes | |
count | 数量 | Integer | passengerTypes | |
contactList | 联系人 | Array[] | 是 | |
contactName | 联系人 | String | contactList | |
mobile | 手机号码 | String | contactList | |
phone | 联系电话 | String | contactList | |
电子邮件 | String | contactList | ||
segments | 询价单行程 | Array[] | 是 | |
departureCode | 出发城市/机场三字码 | String | segments | |
transferCode | 中转城市/机场三字码 | String | segments | |
arrivalCode | 到达城市/机场三字码 | String | segments | |
departureTimeStart | 出发日期 开始(格式yyyy-MM-dd) | String | segments | |
arrivalTimeStart | 到达日期 开始(格式yyyy-MM-dd) | String | segments | |
departureTimeEnd | 出发日期 结束(格式yyyy-MM-dd) | String | segments | |
arrivalTimeEnd | 到达日期 结束(格式yyyy-MM-dd) | String | segments | |
passengerList | 旅客列表 | Array[] | 是 | |
uatpCardNameList | uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
uatpCardNumberList | uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
passengerJruisdictions | 拥有的权限列表(根据passengerJruisdictionType决定) | Array[] | passengerList | |
passengerJruisdictionType | passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理 | Integer | passengerList | |
outsidePassengerId | 对接方系统的旅客编号 | String | passengerList | |
passengerId | 美亚旅客编号(不用传) | String | passengerList | |
passengerName | 乘机人姓名 | String | passengerList | |
passengerType | 旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿) | String | passengerList | |
companyId | 公司编号 | String | passengerList | |
sex | 必传 性别:男/女;不能传其他字符 | String | passengerList | |
cnName | 中文姓名(中文姓名、英文姓名2选一) | String | passengerList | |
enName | 英文姓名(中文姓名、英文姓名2选一,格式:zhang/san) | String | passengerList | |
userName | 登录用户名 | String | passengerList | |
dId | 部门ID(不传) | Integer | passengerList | |
dName | 部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | passengerList | |
nationality | 国籍:中国填写 CN,必传 | String | passengerList | |
birthday | 出生日期(yyyy-MM-dd)必传 | String | passengerList | |
mobile | 手机号码 | String | passengerList | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | passengerList | |
电子邮箱 | String | passengerList | ||
defaultRoleId | 默认角色 | String | passengerList | |
holderId | 职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值 | String | passengerList | |
postID | 职位ID | String | passengerList | |
approvalOutsideId | 审批人的外部系统编号 | String | passengerList | |
SuperVip | 0:非VIP 1VIP | Integer | passengerList | |
phone | 固定电话 | String | passengerList | |
policyId | 差旅政策ID;如果是非正常职等差标满足不了的,则使用policyId传美亚差标ID,进行跨职等差标预订;例如旅客配领导享受领导差标; | String | passengerList | |
staffId | 员工工号 | String | passengerList | |
chooseSeatNo | 在线选座(火车票)如:1A | String | passengerList | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | passengerList | |
CostList | 成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可 | Array[] | passengerList | |
costCenterName | 成本中心名称 | String | passengerList.CostList | |
insuranceList | 保险产品信息 | Array[] | passengerList | |
insuranceId | 保险产品编号(联系美亚获取) | Integer | passengerList.insuranceList | |
insuranceCount | 保险份数(一般最大是两份) | Integer | passengerList.insuranceList | |
certificatePhoto | 证件图片信息(只有国际机票使用,其他产品传null 或者不处理) | CertificatePhoto | passengerList | |
fileName | 文件名称 | String | passengerList.certificatePhoto | |
fileCode | 文件流 | String | passengerList.certificatePhoto | |
frequentTraveller | 常旅卡信息 | FrequentTraveller | passengerList | |
airlineCode | 航司二字码 | String | passengerList.frequentTraveller | |
cardName | 常旅卡名称 | String | passengerList.frequentTraveller | |
cardNumber | 常旅卡号 | String | passengerList.frequentTraveller | |
certificatesList | 证件 | Array[] | passengerList | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | passengerList.certificatesList | |
certNumber | 证件号码 | String | passengerList.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | passengerList.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | passengerList.certificatesList |
{
"askPriceOrderNo":"QU2300003415", //询价单号
"opPhone":"18562855252", //制单人电话
"opName":"刘展超", //制单人姓名
"outsideOpId":"ak10002", //制单人工号
"deadLineTime":"2023-10-30 18:02:05", //截止时间(格式yyyy-MM-dd HH:mm:ss)
"outAskPriceOrderNo":"1111697772465253", //外部询价单号
"tripType":1, //行程类型 -1不限 0 单程 1 往返 2 多段
"classLevel":-1, //舱位等级 -1不限 0 经济 1 公务 2 头等 3豪华经济舱
"isDirectFlight":-1, //是否直飞( -1不限 0 否 1 是)
"budgetPrice":"20000", //预算费用
"companyRemark":"三位乘机人均需要行李额", //客户备注
"receivePayType":"2", //应收支付类型(1:在线消费 2:信用消费);3-预存款支付
"bookType":"0", //0-因公 默认不传;1-因私;
"segments":
[{
"departureCode":"SZX", //出发城市/机场三字码
"transferCode": "", //中转城市/机场三字码
"arrivalCode":"PAR", //到达城市/机场三字码
"departureTimeStart":"2023-11-04", //出发日期 开始(格式yyyy-MM-dd)
"arrivalTimeStart":"2023-11-12", //到达日期 开始(格式yyyy-MM-dd)
"departureTimeEnd":"2023-11-06", //出发日期 结束(格式yyyy-MM-dd)
"arrivalTimeEnd":"2023-11-15", //到达日期 结束(格式yyyy-MM-dd)
}], //询价单行程
"passengerTypes":
[{
"passengerType":"0", //类型 0成人 1儿童 2婴儿
"count":1, //数量
}], //询价单旅客类型
"contactList":
[{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}], //联系人
"passengerList":
[{
"uatpCardNameList":"null", //uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理)
"uatpCardNumberList":"null", //uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理)
"passengerJruisdictions":"null", //拥有的权限列表(根据passengerJruisdictionType决定)
"passengerJruisdictionType":0, //passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理
"outsidePassengerId":"ak10002", //对接方系统的旅客编号
"passengerId": "", //美亚旅客编号(不用传)
"passengerName":"刘展超", //乘机人姓名
"passengerType":"成人", //旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿)
"companyId":"S118022", //公司编号
"sex":"男", //必传 性别:男/女;不能传其他字符
"cnName":"刘展超", //中文姓名(中文姓名、英文姓名2选一)
"enName":"liu/zhanchao", //英文姓名(中文姓名、英文姓名2选一,格式:zhang/san)
"userName":"AK_liuzhanchao", //登录用户名
"dId":0, //部门ID(不传)
"dName":"美亚集团/旅游产品部/运营中心", //部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"nationality":"CN", //国籍:中国填写 CN,必传
"birthday":"2000-01-20", //出生日期(yyyy-MM-dd)必传
"mobile":"18628535565", //手机号码
"mobileAreaCode":"556", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"CostList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件
"defaultRoleId": "", //默认角色
"holderId":"M1", //职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值
"postID":"一厂经理", //职位ID
"approvalOutsideId": "", //审批人的外部系统编号
"SuperVip":0, //0:非VIP 1VIP
"phone":"020-82862903", //固定电话
"policyId": "", //差旅政策ID;如果是非正常职等差标满足不了的,则使用policyId传美亚差标ID,进行跨职等差标预订;例如旅客配领导享受领导差标;
"staffId": "", //员工工号
"insuranceList":
[{
"insuranceId":0, //保险产品编号(联系美亚获取)
"insuranceCount":0, //保险份数(一般最大是两份)
}], //保险产品信息
"chooseSeatNo": "", //在线选座(火车票)如:1A
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
"frequentTraveller":
{
"airlineCode":"MU", //航司二字码
"cardName":"东方明珠积分卡", //常旅卡名称
"cardNumber":"7894587775", //常旅卡号
}, //常旅卡信息
"certificatePhoto":
{
"fileName":"我的证件.jpg", //文件名称
"fileCode":"ADWHIFHWFJJSFJWFJ...", //文件流
}, //证件图片信息(只有国际机票使用,其他产品传null 或者不处理)
}], //旅客列表
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
AskPriceOrderNo | 订单编号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"AskPriceOrderNo":"QU2300003415", //订单编号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
预订前取消询价单,预订后不可取消
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
askPriceOrderNo | 美亚询价单编号 | String | 是 | |
outAskPriceOrderNo | 客户系统询价单编号 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"askPriceOrderNo":"QU2300003415", //美亚询价单编号
"outAskPriceOrderNo":"1111697772465253", //客户系统询价单编号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
更新询价单信息
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
askPriceOrderNo | 询价单号 | String | 是 | |
opPhone | 制单人电话 | String | 是 | |
opName | 制单人姓名 | String | 是 | |
outsideOpId | 制单人工号 | String | 是 | |
deadLineTime | 截止时间(格式yyyy-MM-dd HH:mm:ss) | String | 是 | |
outAskPriceOrderNo | 外部询价单号 | String | 是 | |
tripType | 行程类型 -1不限 0 单程 1 往返 2 多段 | Integer | 是 | |
classLevel | 舱位等级 -1不限 0 经济 1 公务 2 头等 3豪华经济舱 | Integer | 是 | |
isDirectFlight | 是否直飞( -1不限 0 否 1 是) | Integer | 是 | |
budgetPrice | 预算费用 | String | 是 | |
companyRemark | 客户备注 | String | 是 | |
receivePayType | 应收支付类型(1:在线消费 2:信用消费);3-预存款支付 | String | 是 | |
bookType | 0-因公 默认不传;1-因私; | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
passengerTypes | 询价单旅客类型 | Array[] | 是 | |
passengerType | 类型 0成人 1儿童 2婴儿 | String | passengerTypes | |
count | 数量 | Integer | passengerTypes | |
contactList | 联系人 | Array[] | 是 | |
contactName | 联系人 | String | contactList | |
mobile | 手机号码 | String | contactList | |
phone | 联系电话 | String | contactList | |
电子邮件 | String | contactList | ||
segments | 询价单行程 | Array[] | 是 | |
departureCode | 出发城市/机场三字码 | String | segments | |
transferCode | 中转城市/机场三字码 | String | segments | |
arrivalCode | 到达城市/机场三字码 | String | segments | |
departureTimeStart | 出发日期 开始(格式yyyy-MM-dd) | String | segments | |
arrivalTimeStart | 到达日期 开始(格式yyyy-MM-dd) | String | segments | |
departureTimeEnd | 出发日期 结束(格式yyyy-MM-dd) | String | segments | |
arrivalTimeEnd | 到达日期 结束(格式yyyy-MM-dd) | String | segments | |
passengerList | 旅客列表 | Array[] | 是 | |
uatpCardNameList | uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
uatpCardNumberList | uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
passengerJruisdictions | 拥有的权限列表(根据passengerJruisdictionType决定) | Array[] | passengerList | |
passengerJruisdictionType | passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理 | Integer | passengerList | |
outsidePassengerId | 对接方系统的旅客编号 | String | passengerList | |
passengerId | 美亚旅客编号(不用传) | String | passengerList | |
passengerName | 乘机人姓名 | String | passengerList | |
passengerType | 旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿) | String | passengerList | |
companyId | 公司编号 | String | passengerList | |
sex | 必传 性别:男/女;不能传其他字符 | String | passengerList | |
cnName | 中文姓名(中文姓名、英文姓名2选一) | String | passengerList | |
enName | 英文姓名(中文姓名、英文姓名2选一,格式:zhang/san) | String | passengerList | |
userName | 登录用户名 | String | passengerList | |
dId | 部门ID(不传) | Integer | passengerList | |
dName | 部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | passengerList | |
nationality | 国籍:中国填写 CN,必传 | String | passengerList | |
birthday | 出生日期(yyyy-MM-dd)必传 | String | passengerList | |
mobile | 手机号码 | String | passengerList | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | passengerList | |
电子邮箱 | String | passengerList | ||
defaultRoleId | 默认角色 | String | passengerList | |
holderId | 职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值 | String | passengerList | |
postID | 职位ID | String | passengerList | |
approvalOutsideId | 审批人的外部系统编号 | String | passengerList | |
SuperVip | 0:非VIP 1VIP | Integer | passengerList | |
phone | 固定电话 | String | passengerList | |
policyId | 差旅政策ID;如果是非正常职等差标满足不了的,则使用policyId传美亚差标ID,进行跨职等差标预订;例如旅客配领导享受领导差标; | String | passengerList | |
staffId | 员工工号 | String | passengerList | |
chooseSeatNo | 在线选座(火车票)如:1A | String | passengerList | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | passengerList | |
CostList | 成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可 | Array[] | passengerList | |
costCenterName | 成本中心名称 | String | passengerList.CostList | |
insuranceList | 保险产品信息 | Array[] | passengerList | |
insuranceId | 保险产品编号(联系美亚获取) | Integer | passengerList.insuranceList | |
insuranceCount | 保险份数(一般最大是两份) | Integer | passengerList.insuranceList | |
certificatePhoto | 证件图片信息(只有国际机票使用,其他产品传null 或者不处理) | CertificatePhoto | passengerList | |
fileName | 文件名称 | String | passengerList.certificatePhoto | |
fileCode | 文件流 | String | passengerList.certificatePhoto | |
frequentTraveller | 常旅卡信息 | FrequentTraveller | passengerList | |
airlineCode | 航司二字码 | String | passengerList.frequentTraveller | |
cardName | 常旅卡名称 | String | passengerList.frequentTraveller | |
cardNumber | 常旅卡号 | String | passengerList.frequentTraveller | |
certificatesList | 证件 | Array[] | passengerList | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | passengerList.certificatesList | |
certNumber | 证件号码 | String | passengerList.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | passengerList.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | passengerList.certificatesList |
{
"askPriceOrderNo":"QU2300003415", //询价单号
"opPhone":"18562855252", //制单人电话
"opName":"刘展超", //制单人姓名
"outsideOpId":"ak10002", //制单人工号
"deadLineTime":"2023-10-30 18:02:05", //截止时间(格式yyyy-MM-dd HH:mm:ss)
"outAskPriceOrderNo":"1111697772465253", //外部询价单号
"tripType":1, //行程类型 -1不限 0 单程 1 往返 2 多段
"classLevel":-1, //舱位等级 -1不限 0 经济 1 公务 2 头等 3豪华经济舱
"isDirectFlight":-1, //是否直飞( -1不限 0 否 1 是)
"budgetPrice":"20000", //预算费用
"companyRemark":"三位乘机人均需要行李额", //客户备注
"receivePayType":"2", //应收支付类型(1:在线消费 2:信用消费);3-预存款支付
"bookType":"0", //0-因公 默认不传;1-因私;
"segments":
[{
"departureCode":"SZX", //出发城市/机场三字码
"transferCode": "", //中转城市/机场三字码
"arrivalCode":"PAR", //到达城市/机场三字码
"departureTimeStart":"2023-11-04", //出发日期 开始(格式yyyy-MM-dd)
"arrivalTimeStart":"2023-11-12", //到达日期 开始(格式yyyy-MM-dd)
"departureTimeEnd":"2023-11-06", //出发日期 结束(格式yyyy-MM-dd)
"arrivalTimeEnd":"2023-11-15", //到达日期 结束(格式yyyy-MM-dd)
}], //询价单行程
"passengerTypes":
[{
"passengerType":"0", //类型 0成人 1儿童 2婴儿
"count":1, //数量
}], //询价单旅客类型
"contactList":
[{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}], //联系人
"passengerList":
[{
"uatpCardNameList":"null", //uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理)
"uatpCardNumberList":"null", //uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理)
"passengerJruisdictions":"null", //拥有的权限列表(根据passengerJruisdictionType决定)
"passengerJruisdictionType":0, //passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理
"outsidePassengerId":"ak10002", //对接方系统的旅客编号
"passengerId": "", //美亚旅客编号(不用传)
"passengerName":"刘展超", //乘机人姓名
"passengerType":"成人", //旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿)
"companyId":"S118022", //公司编号
"sex":"男", //必传 性别:男/女;不能传其他字符
"cnName":"刘展超", //中文姓名(中文姓名、英文姓名2选一)
"enName":"liu/zhanchao", //英文姓名(中文姓名、英文姓名2选一,格式:zhang/san)
"userName":"AK_liuzhanchao", //登录用户名
"dId":0, //部门ID(不传)
"dName":"美亚集团/旅游产品部/运营中心", //部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"nationality":"CN", //国籍:中国填写 CN,必传
"birthday":"2000-01-20", //出生日期(yyyy-MM-dd)必传
"mobile":"18628535565", //手机号码
"mobileAreaCode":"556", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"CostList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件
"defaultRoleId": "", //默认角色
"holderId":"M1", //职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值
"postID":"一厂经理", //职位ID
"approvalOutsideId": "", //审批人的外部系统编号
"SuperVip":0, //0:非VIP 1VIP
"phone":"020-82862903", //固定电话
"policyId": "", //差旅政策ID;如果是非正常职等差标满足不了的,则使用policyId传美亚差标ID,进行跨职等差标预订;例如旅客配领导享受领导差标;
"staffId": "", //员工工号
"insuranceList":
[{
"insuranceId":0, //保险产品编号(联系美亚获取)
"insuranceCount":0, //保险份数(一般最大是两份)
}], //保险产品信息
"chooseSeatNo": "", //在线选座(火车票)如:1A
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
"frequentTraveller":
{
"airlineCode":"MU", //航司二字码
"cardName":"东方明珠积分卡", //常旅卡名称
"cardNumber":"7894587775", //常旅卡号
}, //常旅卡信息
"certificatePhoto":
{
"fileName":"我的证件.jpg", //文件名称
"fileCode":"ADWHIFHWFJJSFJWFJ...", //文件流
}, //证件图片信息(只有国际机票使用,其他产品传null 或者不处理)
}], //旅客列表
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
AskPriceOrderNo | 订单编号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"AskPriceOrderNo":"QU2300003415", //订单编号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
对报价方案重新报价
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
askPriceOrderNo | 美亚询价单号 | String | 是 | |
outAskPriceOrderNo | 客户系统询价单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"askPriceOrderNo":"QU2300003415", //美亚询价单号
"outAskPriceOrderNo":"1111697772465253", //客户系统询价单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
确认报价方案
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
solutionNo | 解决方案编号 | String | 是 | |
totalPrice | 总价 | String | 是 | |
quotationSplitType | QT拆单类型(不拆分 = 0,UATP = 1,旅客 = 2,外部单号 = 3) | Integer | 否 | |
isSumitIssue | 是否提交出票 | Boolean | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
costs | 询价单成本中心信息 | Array[] | 否 | |
costName | 成本中心名称 | String | costs | |
passengers | 旅客信息 | Array[] | costs | |
Code | 旅客编号 | String | costs.passengers | |
Name | 旅客姓名 | String | costs.passengers | |
passengerTypes | 询价单旅客类型 | Array[] | 是 | |
passengerType | 类型 0成人 1儿童 2婴儿 | String | passengerTypes | |
count | 数量 | Integer | passengerTypes | |
contactList | 联系人 | Array[] | 是 | |
contactName | 联系人 | String | contactList | |
mobile | 手机号码 | String | contactList | |
phone | 联系电话 | String | contactList | |
电子邮件 | String | contactList | ||
prices | 解决方案价格信息 | Array[] | 是 | |
passengerType | 旅客类型,成人、婴儿、儿童 | String | prices | |
passengerNum | 旅客人数 | Integer | prices | |
ticketPrice | 票价 | Number | prices | |
tax | 税费(每人) | Number | prices | |
serviceFee | 服务费(每人) | Number | prices | |
singleTotal | 单价(每人) | Number | prices | |
total | 总计 | Number | prices | |
passengerList | 旅客列表 | Array[] | 是 | |
uatpCardNameList | uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
uatpCardNumberList | uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
passengerJruisdictions | 拥有的权限列表(根据passengerJruisdictionType决定) | Array[] | passengerList | |
passengerJruisdictionType | passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理 | Integer | passengerList | |
outsidePassengerId | 对接方系统的旅客编号 | String | passengerList | |
passengerId | 美亚旅客编号(不用传) | String | passengerList | |
passengerName | 乘机人姓名 | String | passengerList | |
passengerType | 旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿) | String | passengerList | |
companyId | 公司编号 | String | passengerList | |
sex | 必传 性别:男/女;不能传其他字符 | String | passengerList | |
cnName | 中文姓名(中文姓名、英文姓名2选一) | String | passengerList | |
enName | 英文姓名(中文姓名、英文姓名2选一,格式:zhang/san) | String | passengerList | |
userName | 登录用户名 | String | passengerList | |
dId | 部门ID(不传) | Integer | passengerList | |
dName | 部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | passengerList | |
nationality | 国籍:中国填写 CN,必传 | String | passengerList | |
birthday | 出生日期(yyyy-MM-dd)必传 | String | passengerList | |
mobile | 手机号码 | String | passengerList | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | passengerList | |
电子邮箱 | String | passengerList | ||
defaultRoleId | 默认角色 | String | passengerList | |
holderId | 职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值 | String | passengerList | |
postID | 职位ID | String | passengerList | |
approvalOutsideId | 审批人的外部系统编号 | String | passengerList | |
SuperVip | 0:非VIP 1VIP | Integer | passengerList | |
phone | 固定电话 | String | passengerList | |
policyId | 差旅政策ID;如果是非正常职等差标满足不了的,则使用policyId传美亚差标ID,进行跨职等差标预订;例如旅客配领导享受领导差标; | String | passengerList | |
staffId | 员工工号 | String | passengerList | |
chooseSeatNo | 在线选座(火车票)如:1A | String | passengerList | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | passengerList | |
CostList | 成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可 | Array[] | passengerList | |
costCenterName | 成本中心名称 | String | passengerList.CostList | |
insuranceList | 保险产品信息 | Array[] | passengerList | |
insuranceId | 保险产品编号(联系美亚获取) | Integer | passengerList.insuranceList | |
insuranceCount | 保险份数(一般最大是两份) | Integer | passengerList.insuranceList | |
certificatePhoto | 证件图片信息(只有国际机票使用,其他产品传null 或者不处理) | CertificatePhoto | passengerList | |
fileName | 文件名称 | String | passengerList.certificatePhoto | |
fileCode | 文件流 | String | passengerList.certificatePhoto | |
frequentTraveller | 常旅卡信息 | FrequentTraveller | passengerList | |
airlineCode | 航司二字码 | String | passengerList.frequentTraveller | |
cardName | 常旅卡名称 | String | passengerList.frequentTraveller | |
cardNumber | 常旅卡号 | String | passengerList.frequentTraveller | |
certificatesList | 证件 | Array[] | passengerList | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | passengerList.certificatesList | |
certNumber | 证件号码 | String | passengerList.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | passengerList.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | passengerList.certificatesList |
{
"solutionNo":"QU2300003415-1", //解决方案编号
"prices":
[{
"passengerType":"0", //旅客类型,成人、婴儿、儿童
"passengerNum":1, //旅客人数
"ticketPrice":4900, //票价
"tax":2500, //税费(每人)
"serviceFee":100, //服务费(每人)
"singleTotal":7500, //单价(每人)
"total":7500, //总计
}], //解决方案价格信息
"totalPrice":"12000", //总价
"costs":
[{
"passengers":
[{
"Code":"ak10002", //旅客编号
"Name":"刘展超", //旅客姓名
}], //旅客信息
"costName":"研发部", //成本中心名称
}], //询价单成本中心信息
"quotationSplitType":0, //QT拆单类型(不拆分 = 0,UATP = 1,旅客 = 2,外部单号 = 3)
"isSumitIssue":false, //是否提交出票
"passengerTypes":
[{
"passengerType":"0", //类型 0成人 1儿童 2婴儿
"count":1, //数量
}], //询价单旅客类型
"contactList":
[{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}], //联系人
"passengerList":
[{
"uatpCardNameList":"null", //uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理)
"uatpCardNumberList":"null", //uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理)
"passengerJruisdictions":"null", //拥有的权限列表(根据passengerJruisdictionType决定)
"passengerJruisdictionType":0, //passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理
"outsidePassengerId":"ak10002", //对接方系统的旅客编号
"passengerId": "", //美亚旅客编号(不用传)
"passengerName":"刘展超", //乘机人姓名
"passengerType":"成人", //旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿)
"companyId":"S118022", //公司编号
"sex":"男", //必传 性别:男/女;不能传其他字符
"cnName":"刘展超", //中文姓名(中文姓名、英文姓名2选一)
"enName":"liu/zhanchao", //英文姓名(中文姓名、英文姓名2选一,格式:zhang/san)
"userName":"AK_liuzhanchao", //登录用户名
"dId":0, //部门ID(不传)
"dName":"美亚集团/旅游产品部/运营中心", //部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"nationality":"CN", //国籍:中国填写 CN,必传
"birthday":"2000-01-20", //出生日期(yyyy-MM-dd)必传
"mobile":"18628535565", //手机号码
"mobileAreaCode":"556", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"CostList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件
"defaultRoleId": "", //默认角色
"holderId":"M1", //职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值
"postID":"一厂经理", //职位ID
"approvalOutsideId": "", //审批人的外部系统编号
"SuperVip":0, //0:非VIP 1VIP
"phone":"020-82862903", //固定电话
"policyId": "", //差旅政策ID;如果是非正常职等差标满足不了的,则使用policyId传美亚差标ID,进行跨职等差标预订;例如旅客配领导享受领导差标;
"staffId": "", //员工工号
"insuranceList":
[{
"insuranceId":0, //保险产品编号(联系美亚获取)
"insuranceCount":0, //保险份数(一般最大是两份)
}], //保险产品信息
"chooseSeatNo": "", //在线选座(火车票)如:1A
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
"frequentTraveller":
{
"airlineCode":"MU", //航司二字码
"cardName":"东方明珠积分卡", //常旅卡名称
"cardNumber":"7894587775", //常旅卡号
}, //常旅卡信息
"certificatePhoto":
{
"fileName":"我的证件.jpg", //文件名称
"fileCode":"ADWHIFHWFJJSFJWFJ...", //文件流
}, //证件图片信息(只有国际机票使用,其他产品传null 或者不处理)
}], //旅客列表
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
quotationNo | 订单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
quotations | 订单信息 | Array[] | ||
quotationNo | 订单号 | String | quotations | |
statusMark | 状态 | Integer | quotations | |
outsideNo | 外部订单号 | String | quotations | |
passengers | 旅客信息 | Array[] | quotations | |
Code | 旅客编号 | String | quotations.passengers | |
Name | 旅客姓名 | String | quotations.passengers |
{
"quotationNo":"QT2300112936", //订单号
"quotations":
[{
"quotationNo":"QT2300112936", //订单号
"statusMark":QT2300112936, //状态
"passengers":
[{
"Code":"ak10002", //旅客编号
"Name":"刘展超", //旅客姓名
}], //旅客信息
"outsideNo":"1111697772465253", //外部订单号
}], //订单信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
取消解决方案订单
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
solutionNo | 解决方案编号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"solutionNo":"QU2300003415-1", //解决方案编号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
查询询价单详细信息
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
askPriceOrderNo | 美亚系统询价单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"askPriceOrderNo":"QU2300003415", //美亚系统询价单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
isCanChangePrice | 是否允许变价 | Boolean | ||
isReAskPrice | 是否允许更新价格 | Boolean | ||
opPhone | 预订人电话号码 | String | ||
opName | 预订人姓名 | String | ||
opId | 预订人工号 | String | ||
companyRemark | 客户备注 | String | ||
budgetPrice | 预算金额 | String | ||
isDirectFlight | 是否直飞( -1不限 0 否 1 是) | Integer | ||
classLevel | 舱位等级 -1不限 0 经济 1 公务 2 头等 3豪华经济舱 | Integer | ||
tripType | 行程类型 -1不限 0 单程 1 往返 2 多段 | Integer | ||
createTime | 创建日期 | String | ||
outAskPriceOrderNo | 外部询价单编号 | String | ||
deadLineTime | 有效日期 | String | ||
companyName | 公司名称 | String | ||
companyID | 公司编号 | String | ||
askPriceOrderType | 类型(正常 = 0,候补 = 1) | Integer | ||
askPriceOrderState | 状态(待报价 = 0,已报价 = 1,已取消 = 2,) | Integer | ||
askPriceOrderNo | 询价单号 | String | ||
isSumitIssue | 是否确认后直接出票 | Boolean | ||
isCheckTripNo | 是否校验行程编号 | Boolean | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
passengerTypes | 旅客类型 | Array[] | ||
passengerType | 类型 0成人 1儿童 2婴儿 | String | passengerTypes | |
count | 数量 | Integer | passengerTypes | |
uatps | UATP信息 | Array[] | ||
creditCardName | uatp卡名称 | String | uatps | |
creditCardID | uatp卡号 | String | uatps | |
passengers | 旅客信息 | Array[] | uatps | |
Code | 旅客编号 | String | uatps.passengers | |
Name | 旅客姓名 | String | uatps.passengers | |
contacters | 联系人信息 | Array[] | ||
name | 姓名 | String | contacters | |
cellphoneNumber | 手机号码 | String | contacters | |
telephoneNumber | 电话号码 | String | contacters | |
邮箱 | String | contacters | ||
fax | 传真 | String | contacters | |
remarks | 备注信息 | Array[] | ||
type | 0内部备注 | Integer | remarks | |
createUserId | 创建人编号 | String | remarks | |
createUserName | 创建人名称 | String | remarks | |
createDate | 创建日期 | String | remarks | |
content | 内容 | String | remarks | |
segments | 行程信息 | Array[] | ||
departureCode | 出发城市/机场三字码 | String | segments | |
transferCode | 中转城市/机场三字码 | String | segments | |
arrivalCode | 到达城市/机场三字码 | String | segments | |
departureTimeStart | 出发日期 开始(格式yyyy-MM-dd) | String | segments | |
arrivalTimeStart | 到达日期 开始(格式yyyy-MM-dd) | String | segments | |
departureTimeEnd | 出发日期 结束(格式yyyy-MM-dd) | String | segments | |
arrivalTimeEnd | 到达日期 结束(格式yyyy-MM-dd) | String | segments | |
passengers | 旅客信息 | Array[] | ||
name | 名称 | String | passengers | |
gender | 性别(不限 = -1,男 = 0,女 = 1) | Integer | passengers | |
birthDay | 出生日期(格式yyyy-MM-dd) | String | passengers | |
nationality | 国籍 | String | passengers | |
certType | 证件类型 | String | passengers | |
certNo | 证件号 | String | passengers | |
certNationality | 证件签发国 | String | passengers | |
certEffectiveDate | 证件有效期(格式yyyy-MM-dd) | String | passengers | |
outCode | 旅客工号 | String | passengers | |
outsidePassengerId | 对接方系统的旅客编号 | String | passengers | |
solution | 解决方案信息 | Array[] | ||
serviceOpName | 处理人姓名 | String | solution | |
serviceOpId | 处理人旅客编号 | String | solution | |
isSumitIssue | 是否提交出票 | Boolean | solution | |
opDate | 预订日期 | String | solution | |
companyName | 公司名称 | String | solution | |
companyID | 公司编码 | String | solution | |
deadLineTime | 有效期 | String | solution | |
outOrderNo | 客户系统订单号 | String | solution | |
askPriceOrderNo | 询价单号 | String | solution | |
quotationNo | 订单号 | String | solution | |
solutionState | 解决方案状态 待发送 = 0,已发送 = 1,已确认 = 2,已取消 = 5,已过期 = 6,已处理 = 7 | Integer | solution | |
solutionNo | 解决方案号 | String | solution | |
isCanChangePrice | 是否允许变价 | Boolean | solution | |
isCheckTripNo | 校验行程编码 | Boolean | solution | |
costs | 成本中心 | Array[] | solution | |
costName | 成本中心名称 | String | solution.costs | |
passengers | 旅客信息 | Array[] | solution.costs | |
Code | 旅客编号 | String | solution.costs.passengers | |
Name | 旅客姓名 | String | solution.costs.passengers | |
uatps | UATP信息 | Array[] | solution | |
creditCardName | uatp卡名称 | String | solution.uatps | |
creditCardID | uatp卡号 | String | solution.uatps | |
passengers | 旅客信息 | Array[] | solution.uatps | |
Code | 旅客编号 | String | solution.uatps.passengers | |
Name | 旅客姓名 | String | solution.uatps.passengers | |
pnrs | PNR信息 | Array[] | solution | |
pnr | PNR | String | solution.pnrs | |
content | 说明 | String | solution.pnrs | |
gds | GDS | Integer | solution.pnrs | |
SolutionQuotations | 解决方案订单 | Array[] | solution | |
quotationNo | 订单号 | String | solution.SolutionQuotations | |
statusMark | 状态 | Integer | solution.SolutionQuotations | |
outsideNo | 外部订单号 | String | solution.SolutionQuotations | |
passengers | 旅客信息 | Array[] | solution.SolutionQuotations | |
Code | 旅客编号 | String | solution.SolutionQuotations.passengers | |
Name | 旅客姓名 | String | solution.SolutionQuotations.passengers | |
remarks | 备注 | Array[] | solution | |
type | 0内部备注 | Integer | solution.remarks | |
createUserId | 创建人编号 | String | solution.remarks | |
createUserName | 创建人名称 | String | solution.remarks | |
createDate | 创建日期 | String | solution.remarks | |
content | 内容 | String | solution.remarks | |
contacters | 联系人信息 | Array[] | solution | |
name | 姓名 | String | solution.contacters | |
cellphoneNumber | 手机号码 | String | solution.contacters | |
telephoneNumber | 电话号码 | String | solution.contacters | |
邮箱 | String | solution.contacters | ||
fax | 传真 | String | solution.contacters | |
prices | 价格信息 | Array[] | solution | |
passengerType | 旅客类型,成人、婴儿、儿童 | String | solution.prices | |
passengerNum | 旅客人数 | Integer | solution.prices | |
ticketPrice | 票价 | Number | solution.prices | |
tax | 税费(每人) | Number | solution.prices | |
serviceFee | 服务费(每人) | Number | solution.prices | |
singleTotal | 单价(每人) | Number | solution.prices | |
total | 总计 | Number | solution.prices | |
rule | 航司规则 | SolutionRuleDto | solution | |
refundCN | 退票规则 | String | solution.rule | |
changeCN | 改签规则 | String | solution.rule | |
baggageCN | 行李规则 | String | solution.rule | |
stayValidityType | 停留有效期 0-单程 1-往返 | Integer | solution.rule | |
stayValidity | 停留有效期 | String | solution.rule | |
stayValidityUnit | 停留有效期单位(天/月) | Integer | solution.rule | |
minimumStayValidity | 最短停留有效期 | String | solution.rule | |
minimumStayValidityUnit | 最短停留有效期单位(天/月) | Integer | solution.rule | |
longestStayValidity | 最长停留有效期 | String | solution.rule | |
longestStayUnit | 最长停留有效期单位(天/月) | Integer | solution.rule | |
passengers | 旅客信息 | Array[] | solution | |
name | 名称 | String | solution.passengers | |
gender | 性别(不限 = -1,男 = 0,女 = 1) | Integer | solution.passengers | |
birthDay | 出生日期(格式yyyy-MM-dd) | String | solution.passengers | |
nationality | 国籍 | String | solution.passengers | |
certType | 证件类型 | String | solution.passengers | |
certNo | 证件号 | String | solution.passengers | |
certNationality | 证件签发国 | String | solution.passengers | |
certEffectiveDate | 证件有效期(格式yyyy-MM-dd) | String | solution.passengers | |
outCode | 旅客工号 | String | solution.passengers | |
outsidePassengerId | 对接方系统的旅客编号 | String | solution.passengers | |
segments | 航段信息 | Array[] | solution | |
airlineName | 航司名称 | String | solution.segments | |
airlineCode | 航司编码 | String | solution.segments | |
arrivalCityName | 到达城市名称 | String | solution.segments | |
arrivalCityCode | 到达城市码 | String | solution.segments | |
arrivalAirportName | 到达机场名称 | String | solution.segments | |
departureCityName | 出发城市名称 | String | solution.segments | |
departureCityCode | 出发城市编码 | String | solution.segments | |
departureAirportName | 出发机场名称 | String | solution.segments | |
segmentType | 航段类型 (0去程,1-返程) | Integer | solution.segments | |
planeType | 机型 | String | solution.segments | |
tripNo | 行程编号 | Integer | solution.segments | |
arrivalTerminal | 到达航站楼 | String | solution.segments | |
flyTime | 飞行时长,分钟 | String | solution.segments | |
arrivalTime | 到达时间 | String | solution.segments | |
departureTime | 出发时间 | String | solution.segments | |
cabin | 舱等 | String | solution.segments | |
classLevel | 舱位等级 -1不限 0 经济 1 公务 2 头等 3豪华经济舱 | Integer | solution.segments | |
arrivalAirportCode | 到达机场码 | String | solution.segments | |
departureAirportCode | 出发机场码 | String | solution.segments | |
carrierFlightNo | 共享航班号 | String | solution.segments | |
flightNo | 航班号 | String | solution.segments | |
departureTerminal | 出发机场航站楼 | String | solution.segments | |
tripSegmentno | 航段号 | Integer | solution.segments | |
stops | 经停信息 | Array[] | solution.segments | |
cityCode | 经停城市码 | String | solution.segments.stops | |
cityName | 经停城市= | String | solution.segments.stops | |
stayTime | 停留时长,分钟 | String | solution.segments.stops |
{
"isCanChangePrice":true, //是否允许变价
"isReAskPrice":true, //是否允许更新价格
"opPhone":"18655488456", //预订人电话号码
"opName":"刘展超", //预订人姓名
"opId":"P154265", //预订人工号
"uatps":
[{
"passengers":
[{
"Code":"ak10002", //旅客编号
"Name":"刘展超", //旅客姓名
}], //旅客信息
"creditCardName":"卡一", //uatp卡名称
"creditCardID":"15845658445858", //uatp卡号
}], //UATP信息
"solution":
[{
"SolutionQuotations":
[{
"quotationNo":"QT2300112936", //订单号
"statusMark":QT2300112936, //状态
"passengers":
[{
"Code":"ak10002", //旅客编号
"Name":"刘展超", //旅客姓名
}], //旅客信息
"outsideNo":"1111697772465253", //外部订单号
}], //解决方案订单
"costs":
[{
"passengers":
[{
"Code":"ak10002", //旅客编号
"Name":"刘展超", //旅客姓名
}], //旅客信息
"costName":"研发部", //成本中心名称
}], //成本中心
"uatps":
[{
"passengers":
[{
"Code":"ak10002", //旅客编号
"Name":"刘展超", //旅客姓名
}], //旅客信息
"creditCardName":"卡一", //uatp卡名称
"creditCardID":"15845658445858", //uatp卡号
}], //UATP信息
"remarks":
[{
"type":0, //0内部备注
"createUserId":"20160024", //创建人编号
"createUserName":"黄嘉华", //创建人名称
"createDate":"2023-10-10 07:05", //创建日期
"content":"特殊说明:要退改便宜的", //内容
}], //备注
"rule":
{
"refundCN":"退票收500元", //退票规则
"changeCN":"同等舱位改期收100元", //改签规则
"baggageCN":"福州-巴黎 托运行李:免费托运行李:1件,23KG,158CM 手提行李:免费手提行李:1件,5KG,115CM", //行李规则
"stayValidityType":0, //停留有效期 0-单程 1-往返
"stayValidity": "", //停留有效期
"stayValidityUnit":0, //停留有效期单位(天/月)
"minimumStayValidity": "", //最短停留有效期
"minimumStayValidityUnit":0, //最短停留有效期单位(天/月)
"longestStayValidity": "", //最长停留有效期
"longestStayUnit":0, //最长停留有效期单位(天/月)
}, //航司规则
"prices":
[{
"passengerType":"0", //旅客类型,成人、婴儿、儿童
"passengerNum":1, //旅客人数
"ticketPrice":4900, //票价
"tax":2500, //税费(每人)
"serviceFee":100, //服务费(每人)
"singleTotal":7500, //单价(每人)
"total":7500, //总计
}], //价格信息
"segments":
[{
"airlineName":"中国国航", //航司名称
"airlineCode":"CA", //航司编码
"arrivalCityName":"北京", //到达城市名称
"arrivalCityCode":"BJS", //到达城市码
"arrivalAirportName":"首都国际机场", //到达机场名称
"departureCityName":"福州", //出发城市名称
"departureCityCode":"FOC", //出发城市编码
"departureAirportName":"长乐国际机场", //出发机场名称
"segmentType":0, //航段类型 (0去程,1-返程)
"planeType":"73K", //机型
"tripNo":1, //行程编号
"arrivalTerminal":"T3", //到达航站楼
"stops":
[{
"cityCode":"HKG", //经停城市码
"cityName":"香港", //经停城市=
"stayTime":"120", //停留时长,分钟
}], //经停信息
"flyTime":"175", //飞行时长,分钟
"arrivalTime":"2023-11-04 09:40:00", //到达时间
"departureTime":"2023-11-04 07:30:50", //出发时间
"cabin":"B", //舱等
"classLevel":0, //舱位等级 -1不限 0 经济 1 公务 2 头等 3豪华经济舱
"arrivalAirportCode":"PAR", //到达机场码
"departureAirportCode":"SZX", //出发机场码
"carrierFlightNo": "", //共享航班号
"flightNo":"MU5332", //航班号
"departureTerminal":"T1", //出发机场航站楼
"tripSegmentno":1, //航段号
}], //航段信息
"contacters":
[{
"name":"刘展超", //姓名
"cellphoneNumber":"18623516025", //手机号码
"telephoneNumber":"202-65686525", //电话号码
"email":"liuzhanchao@meiya.com", //邮箱
"fax":"liuzhanchao@meiya.com", //传真
}], //联系人信息
"passengers":
[{
"name": "", //名称
"gender":0, //性别(不限 = -1,男 = 0,女 = 1)
"birthDay": "", //出生日期(格式yyyy-MM-dd)
"nationality": "", //国籍
"certType": "", //证件类型
"certNo": "", //证件号
"certNationality": "", //证件签发国
"certEffectiveDate": "", //证件有效期(格式yyyy-MM-dd)
"outCode": "", //旅客工号
"outsidePassengerId": "", //对接方系统的旅客编号
}], //旅客信息
"pnrs":
[{
"pnr":"SZXPVG", //PNR
"content":"无说明", //说明
"gds":0, //GDS
}], //PNR信息
"serviceOpName":"黄嘉华", //处理人姓名
"serviceOpId":"20160024", //处理人旅客编号
"isSumitIssue":false, //是否提交出票
"opDate":"2023-10-09 16:05", //预订日期
"companyName":"美亚测试公司", //公司名称
"companyID":"S118022", //公司编码
"deadLineTime":"2023-11-25 16:05", //有效期
"outOrderNo":"1711288003119874050", //客户系统订单号
"askPriceOrderNo":"QU2300000451", //询价单号
"quotationNo": "", //订单号
"solutionState":1, //解决方案状态 待发送 = 0,已发送 = 1,已确认 = 2,已取消 = 5,已过期 = 6,已处理 = 7
"solutionNo":"QU2300000451-1", //解决方案号
"isCanChangePrice":true, //是否允许变价
"isCheckTripNo":true, //校验行程编码
}], //解决方案信息
"contacters":
[{
"name":"刘展超", //姓名
"cellphoneNumber":"18623516025", //手机号码
"telephoneNumber":"202-65686525", //电话号码
"email":"liuzhanchao@meiya.com", //邮箱
"fax":"liuzhanchao@meiya.com", //传真
}], //联系人信息
"remarks":
[{
"type":0, //0内部备注
"createUserId":"20160024", //创建人编号
"createUserName":"黄嘉华", //创建人名称
"createDate":"2023-10-10 07:05", //创建日期
"content":"特殊说明:要退改便宜的", //内容
}], //备注信息
"passengers":
[{
"name": "", //名称
"gender":0, //性别(不限 = -1,男 = 0,女 = 1)
"birthDay": "", //出生日期(格式yyyy-MM-dd)
"nationality": "", //国籍
"certType": "", //证件类型
"certNo": "", //证件号
"certNationality": "", //证件签发国
"certEffectiveDate": "", //证件有效期(格式yyyy-MM-dd)
"outCode": "", //旅客工号
"outsidePassengerId": "", //对接方系统的旅客编号
}], //旅客信息
"passengerTypes":
[{
"passengerType":"0", //类型 0成人 1儿童 2婴儿
"count":1, //数量
}], //旅客类型
"segments":
[{
"departureCode":"SZX", //出发城市/机场三字码
"transferCode": "", //中转城市/机场三字码
"arrivalCode":"PAR", //到达城市/机场三字码
"departureTimeStart":"2023-11-04", //出发日期 开始(格式yyyy-MM-dd)
"arrivalTimeStart":"2023-11-12", //到达日期 开始(格式yyyy-MM-dd)
"departureTimeEnd":"2023-11-06", //出发日期 结束(格式yyyy-MM-dd)
"arrivalTimeEnd":"2023-11-15", //到达日期 结束(格式yyyy-MM-dd)
}], //行程信息
"companyRemark":"三位乘机人均需要行李额", //客户备注
"budgetPrice":"25000", //预算金额
"isDirectFlight":0, //是否直飞( -1不限 0 否 1 是)
"classLevel":-1, //舱位等级 -1不限 0 经济 1 公务 2 头等 3豪华经济舱
"tripType":0, //行程类型 -1不限 0 单程 1 往返 2 多段
"createTime":"2023-10-20", //创建日期
"outAskPriceOrderNo":"1111697772465253", //外部询价单编号
"deadLineTime":"2023-10-25", //有效日期
"companyName":"美亚商旅测试公司", //公司名称
"companyID":"S118022", //公司编号
"askPriceOrderType":0, //类型(正常 = 0,候补 = 1)
"askPriceOrderState":0, //状态(待报价 = 0,已报价 = 1,已取消 = 2,)
"askPriceOrderNo":"QU2300003415", //询价单号
"isSumitIssue":false, //是否确认后直接出票
"isCheckTripNo":true, //是否校验行程编号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
sessionId | sessionId,login接口返回 | String | 是 |
{
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
cityList | 城市数据集合 | Array[] | ||
py | 拼音 | String | cityList | |
cn | 城市中文名称 | String | cityList | |
cityCode | 城市三字码 | String | cityList | |
en | 城市英文名称 | String | cityList | |
stateName | 省/州中文名 | String | cityList | |
countryName | 国家中文名 | String | cityList | |
code | 机场三字码 | String | cityList | |
airportCnName | 机场中文名称 | String | cityList | |
airportEgName | 机场英文名称 | String | cityList | |
stationName | 站点名称(火车票的) | String | cityList | |
dataDistrictName | 关联的区县名称(酒店的数据) | String | cityList | |
dataDistrictAreaCode | 关联的区县行政代码(酒店的数据) | String | cityList | |
cityType | 0默认值,1直辖市、2地级市、3县级市、4行政区(酒店的数据,非酒店数据都默认0) | Integer | cityList | |
dataCityName | 关联的城市名称(酒店的数据) | String | cityList | |
dataCityCode | 关联的城市三字码(酒店的数据) | String | cityList |
{
"cityList":
[{
"py":"GuangZhou", //拼音
"cn":"广州", //城市中文名称
"cityCode":"CAN", //城市三字码
"en":"GuangZhou", //城市英文名称
"stateName":"广东", //省/州中文名
"countryName":"中国", //国家中文名
"code":"CAN", //机场三字码
"airportCnName":"白云国际机场", //机场中文名称
"airportEgName":"baiyunguojijichang", //机场英文名称
"stationName": "", //站点名称(火车票的)
"dataDistrictName": "", //关联的区县名称(酒店的数据)
"dataDistrictAreaCode": "", //关联的区县行政代码(酒店的数据)
"cityType":0, //0默认值,1直辖市、2地级市、3县级市、4行政区(酒店的数据,非酒店数据都默认0)
"dataCityName": "", //关联的城市名称(酒店的数据)
"dataCityCode": "", //关联的城市三字码(酒店的数据)
}], //城市数据集合
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
hotelCode | 酒店编号 | String | 是 | |
roomCode | 房型编号 | String | 是 | |
ratePlanID | 房价计划编号 | String | 是 | |
supplierCode | 供应商代号 | String | 是 | |
roomNum | 房间数量 | Integer | 是 | |
checkInDate | 入住日期,格式:yyyy-MM-dd | String | 是 | |
checkOutDate | 退房日期,格式:yyyy-MM-dd | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
priceList | 房价计划每日价格列表 | Array[] | 是 | |
sellDate | 日期,格式:yyyy-MM-dd | String | priceList | |
price | 每日售价 | Number | priceList | |
priceRebate | 收入返现,(每间夜价格) 正数 | Number | priceList | |
priceServiceAmount | 服务费 | Number | priceList |
{
"hotelCode": "", //酒店编号
"roomCode": "", //房型编号
"ratePlanID": "", //房价计划编号
"supplierCode": "", //供应商代号
"roomNum":0, //房间数量
"checkInDate": "", //入住日期,格式:yyyy-MM-dd
"checkOutDate": "", //退房日期,格式:yyyy-MM-dd
"priceList":
[{
"sellDate": "", //日期,格式:yyyy-MM-dd
"price":0, //每日售价
"priceRebate":0, //收入返现,(每间夜价格) 正数
"priceServiceAmount":0, //服务费
}], //房价计划每日价格列表
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
totalServiceAmount | 总服务费 | Number | ||
totalAmount | 订单总费用 | Number | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
priceList | 新房价计划每日价格列表 | Array[] | ||
sellDate | 日期,格式:yyyy-MM-dd | String | priceList | |
price | 每日售价 | Number | priceList | |
priceRebate | 收入返现,(每间夜价格) 正数 | Number | priceList | |
priceServiceAmount | 服务费 | Number | priceList |
{
"priceList":
[{
"sellDate": "", //日期,格式:yyyy-MM-dd
"price":0, //每日售价
"priceRebate":0, //收入返现,(每间夜价格) 正数
"priceServiceAmount":0, //服务费
}], //新房价计划每日价格列表
"totalServiceAmount":0, //总服务费
"totalAmount":0, //订单总费用
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
hotelCode | 酒店编号 | String | 是 | |
roomCode | 房型编号 | String | 是 | |
ratePlanID | 房价计划编号 | String | 是 | |
supplierCode | 供应商代号 | String | 是 | |
roomCount | 订房数量 | Integer | 是 | |
checkInDate | 入住日期 格式:yyyy-MM-dd | String | 是 | |
checkOutDate | 退房日期 格式:yyyy-MM-dd | String | 是 | |
latestCheckInTime | 最晚到店时间 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"hotelCode": "", //酒店编号
"roomCode": "", //房型编号
"ratePlanID": "", //房价计划编号
"supplierCode": "", //供应商代号
"roomCount":0, //订房数量
"checkInDate": "", //入住日期 格式:yyyy-MM-dd
"checkOutDate": "", //退房日期 格式:yyyy-MM-dd
"latestCheckInTime": "", //最晚到店时间
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
cardNo | 信用卡号 | String | 否 | |
supplierCode | 供应商代号 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"cardNo": "", //信用卡号
"supplierCode": "", //供应商代号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
isNeedCVV | 是否需要提供CVV码 True:需要,false:不需要 | Boolean | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"isNeedCVV":false, //是否需要提供CVV码 True:需要,false:不需要
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
hotelCode | 酒店编号 | String | 是 | |
roomCode | 房型编号 | String | 是 | |
ratePlanID | 房价计划编号 | String | 是 | |
supplierCode | 供应商代号 | String | 是 | |
roomCount | 订房数量 | Integer | 是 | |
checkInDate | 入住日期 格式:yyyy-MM-dd | String | 是 | |
checkOutDate | 退房日期 格式:yyyy-MM-dd | String | 是 | |
latestCheckInTime | 最晚到店时间 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"hotelCode": "", //酒店编号
"roomCode": "", //房型编号
"ratePlanID": "", //房价计划编号
"supplierCode": "", //供应商代号
"roomCount":0, //订房数量
"checkInDate": "", //入住日期 格式:yyyy-MM-dd
"checkOutDate": "", //退房日期 格式:yyyy-MM-dd
"latestCheckInTime": "", //最晚到店时间
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
IsVouch | 是否需要担保 | Boolean | ||
VouchType | 担保类型,1 首晚担保、2 合额担保 3:峰时担保;4:超时担保;5:一律担保;6:手机担保 | String | ||
AssureAmount | 担保金额 | Number | ||
Description | 担保中文描述 | String | ||
LastCancelTime | 最晚取消变更时间 :担保订单可取消的时间,如果返回的时间小于当前时间,则代表此订单不可变更取消 | String |
{
"IsVouch":false, //是否需要担保
"VouchType": "", //担保类型,1 首晚担保、2 合额担保 3:峰时担保;4:超时担保;5:一律担保;6:手机担保
"AssureAmount":0, //担保金额
"Description": "", //担保中文描述
"LastCancelTime": "", //最晚取消变更时间 :担保订单可取消的时间,如果返回的时间小于当前时间,则代表此订单不可变更取消
}
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
cityCode | 入住城市编号(必填) | String | 是 | |
checkInDate | 入住时间 格式:yyyy-MM-dd | String | 是 | |
checkOutDate | 退房时间 格式:yyyy-MM-dd | String | 是 | |
hotelName | 酒店名称 | String | 否 | |
hotelCodeList | 酒店编号 | Array[] | 否 | |
longitude | 经度 | String | 否 | |
latitude | 纬度 | String | 否 | |
payType | 支付类型 1-预付,2-现付 | String | 否 | |
districtId | 行政区域编号 | String | 否 | |
kilometrage | 距离指定经纬度坐标(即参数longitude和latitude)公里数 | Integer | 否 | |
priceRange | 价格范围 格式:最小值-最大值 | String | 否 | |
starCode | 星级 | Array[] | 否 | |
brandID | 品牌编号 | String | 否 | |
bookingType | 预订类型 0为因公 1 为因私 | Integer | 否 | |
agreementType | 协议类型:-2全部,-1 非协议价,-3 会员酒店(非协议酒店、美亚自采购酒店、外放酒店),0 外放协议价,1美亚自采购协议价,2 适用协议价 | Integer | 否 | |
orderByCode |
排序类型
1、默认排序:坐标、orderByCode都为null (优先运算美亚酒店推荐(值越大越往后排)【接着是旅客旅客推荐率由高到底】) 2、默认排序(协议置顶):坐标为空、orderByCode为distance 3、优先最低价排序:orderByCode的值为HotelMinPrice (【接着按距离排序(当选择地标或经纬度时)】) 4、优先按距离排序(协议价置顶): 坐标不为空且orderByCode为空 有坐标,但orderByCode为空,会根据坐标筛选出酒店(协议置顶) 5、优先按距离排序:orderByCode为distance 有坐标,orderByCode为'distance',会根据orderTypeCode排序 注明/解释: a.坐标,这里代指请求参数的longitude和latitude字段。 |
String | 否 | |
orderTypeCode | 排序顺序(空(默认为desc)、asc、desc) , | String | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageCount | 页大小 | Integer | 否 | |
hotelService |
设施列表
2,大床; 3,双床; 4,5,免费网络; 9,健身房; 12,接机服务; 13,餐厅; 11,会议设施; |
Array[] | 否 | |
includeBreakfast | 是否只查含早 默认否 | Boolean | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"cityCode": "", //入住城市编号(必填)
"checkInDate": "", //入住时间 格式:yyyy-MM-dd
"checkOutDate": "", //退房时间 格式:yyyy-MM-dd
"hotelName": "", //酒店名称
"hotelCodeList":[], //酒店编号
"longitude": "", //经度
"latitude": "", //纬度
"payType": "", //支付类型 1-预付,2-现付
"districtId": "", //行政区域编号
"kilometrage":0, //距离指定经纬度坐标(即参数longitude和latitude)公里数
"priceRange": "", //价格范围 格式:最小值-最大值
"starCode":[0], //星级
"brandID": "", //品牌编号
"bookingType":0, //预订类型 0为因公 1 为因私
"agreementType":0, //协议类型:-2全部,-1 非协议价,-3 会员酒店(非协议酒店、美亚自采购酒店、外放酒店),0 外放协议价,1美亚自采购协议价,2 适用协议价
"orderByCode": "", //排序类型
"orderTypeCode": "", //排序顺序(空(默认为desc)、asc、desc) ,
"pageIndex":0, //页码
"pageCount":0, //页大小
"hotelService":[], //设施列表
"includeBreakfast":false, //是否只查含早 默认否
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
count | Integer | |||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
hotelInfoList | Array[] | |||
hotelCode | 酒店编号 | String | hotelInfoList | |
hotelCNName | 酒店中文名 | String | hotelInfoList | |
hotelENName | 酒店英文名 | String | hotelInfoList | |
otherName | 酒店曾用名 | String | hotelInfoList | |
hotelUrl | 酒店官网地址 | String | hotelInfoList | |
hotelAddress | 酒店地址 | String | hotelInfoList | |
hotelOpeningTime | 开业时间 返回格式:1999 | String | hotelInfoList | |
starCode | 酒店星级编码:5-五星/豪华,4-四星/高档,3-三星/舒适,2-经济/客栈 | Integer | hotelInfoList | |
hotelDecorationTime | 装修时间 返回格式:1999 | String | hotelInfoList | |
RecommendCode | 推荐系数 1-推荐,2-热门,3-好评,4-促销 | String | hotelInfoList | |
hotelBusinessCircle | 所属城市区域 商圈区域 | String | hotelInfoList | |
areaName | 区域名称 | String | hotelInfoList | |
postalCode | 邮编 | String | hotelInfoList | |
longitude | 经度 | String | hotelInfoList | |
latitude | 纬度 | String | hotelInfoList | |
hotelPhone | 前台电话 | String | hotelInfoList | |
hotelFax | 前台传真 | String | hotelInfoList | |
groupName | 所属酒店集团,酒店集团名称 | String | hotelInfoList | |
generalAmenities | 服务设施 | String | hotelInfoList | |
roomAmenities | 房间设施 | String | hotelInfoList | |
recreationAmenities | 休闲设施 | String | hotelInfoList | |
conferenceAmenities | 会议设施 | String | hotelInfoList | |
diningAmenities | 餐饮设施 | String | hotelInfoList | |
description | 酒店简介 | String | hotelInfoList | |
location | 地理信息 | String | hotelInfoList | |
hotelMinPrice | 最低价 | String | hotelInfoList | |
strHotelTrafficInformation | 交通信息 add by linda | String | hotelInfoList | |
distanceLandmarkLength | 距离地标长度 | Integer | hotelInfoList | |
invoiceType | 支持开发票类型 | String | hotelInfoList | |
roomState | 酒店房态,0售完,大于0可以预订,(目前只有0和1) | Integer | hotelInfoList | |
cityCode | 城市编码 | String | hotelInfoList | |
cityName | 城市名称 | String | hotelInfoList | |
countryName | 国家名称 | String | hotelInfoList | |
ProvinceName | 省份名称 | String | hotelInfoList | |
helptips | 提示 | String | hotelInfoList | |
hotelServices | 附加服务 | Array[] | hotelInfoList | |
supportCARDSCodeList | 支持的银行卡 多个时用,隔开 | Array[] | hotelInfoList | |
SupportCARDSCode | 支持卡类编码 | String | hotelInfoList.supportCARDSCodeList | |
SupportCARDSName | 支持卡类名称 | String | hotelInfoList.supportCARDSCodeList | |
hotelPictureList | 酒店图片 | Array[] | hotelInfoList | |
hotelCode | 酒店编码 | String | hotelInfoList.hotelPictureList | |
imageName | 图片名称 | String | hotelInfoList.hotelPictureList | |
isMain | 酒店主图片 是否酒店主图片:0-是,1-否 | String | hotelInfoList.hotelPictureList | |
url | 图片url | String | hotelInfoList.hotelPictureList | |
description | 图片描述 | String | hotelInfoList.hotelPictureList | |
hotelBrand | 酒店品牌 | HotelBrandInfo | hotelInfoList | |
brandID | 品牌ID | String | hotelInfoList.hotelBrand | |
brandNameCN | 品牌中文名称 | String | hotelInfoList.hotelBrand | |
brandNameEN | 品牌英文名称 | String | hotelInfoList.hotelBrand | |
logoUrl | 品牌LOGO | String | hotelInfoList.hotelBrand | |
description | 品牌简介 | String | hotelInfoList.hotelBrand | |
hotelRoomList | 房型列表(酒店信息查询接口没有房型列表,酒店价格详情信息房型列表) | Array[] | hotelInfoList | |
roomCode | 房型代码 | String | hotelInfoList.hotelRoomList | |
roomName | 房型名称 | String | hotelInfoList.hotelRoomList | |
fooler | 所在楼层 | String | hotelInfoList.hotelRoomList | |
acre | 房间面积 | String | hotelInfoList.hotelRoomList | |
bedType | 床型 | String | hotelInfoList.hotelRoomList | |
intent | 宽带标识 有/无/免费/收费 | String | hotelInfoList.hotelRoomList | |
hasWindows | 是否有窗 0:无窗,1:有窗,2:天窗,3:部分有窗,4:内窗 | Integer | hotelInfoList.hotelRoomList | |
WindowDesc | 窗型描述 | String | hotelInfoList.hotelRoomList | |
status | 房间状态 0-启用,1-停用 | String | hotelInfoList.hotelRoomList | |
extra | 是够可加床 是/否 | String | hotelInfoList.hotelRoomList | |
facilities | 房间设施 | String | hotelInfoList.hotelRoomList | |
description | 房间描述 | String | hotelInfoList.hotelRoomList | |
remark | 房间备注 | String | hotelInfoList.hotelRoomList | |
roomImgUrls | 房型图片 | Array[] | hotelInfoList.hotelRoomList | |
hotelPriceList | 价格信息列表 | Array[] | hotelInfoList.hotelRoomList | |
ratePlanID | 房价计划编号 | String | hotelInfoList.hotelRoomList.hotelPriceList | |
ratePlanName | 房价计划名称 | String | hotelInfoList.hotelRoomList.hotelPriceList | |
supplierCode | 供应商代号 | String | hotelInfoList.hotelRoomList.hotelPriceList | |
payType | 付款方式 1-预付,2-现付 | String | hotelInfoList.hotelRoomList.hotelPriceList | |
hasBreakfast |
早餐类型
未知,含早,无早,单早, 双早,三早, 多早,不含早, 含零早,含单早,含双早, 含三早,含四早,含五早, 含六早,含七早,含八早, 含单双早,床位早,含床位早, 双早+午餐/晚餐,不含早餐, 无餐/无早,一份早餐, 两份早餐,床位早餐, 床位中餐,床位晚餐,儿童早, 三份早餐,四份早餐, 五份早餐,六份早餐, 七份早餐,八份早餐, 九份早餐,十份早餐, 2大1小早餐,2大1小晚餐, 双早双晚 |
String | hotelInfoList.hotelRoomList.hotelPriceList | |
priceType | 价格类型 1-平日价,2-周末价 | String | hotelInfoList.hotelRoomList.hotelPriceList | |
currency | 币种 没有值时默认为0 | String | hotelInfoList.hotelRoomList.hotelPriceList | |
priceRebate | 返现 | Number | hotelInfoList.hotelRoomList.hotelPriceList | |
isGaranteeRule | 是否需要担保 True=是,false=否 | Boolean | hotelInfoList.hotelRoomList.hotelPriceList | |
garanteeDescription | 担保说明 | String | hotelInfoList.hotelRoomList.hotelPriceList | |
termCancelDescription | 取消条款 | String | hotelInfoList.hotelRoomList.hotelPriceList | |
invStatus | 是否满房 True:满房-不可预订 False:正常-可以预订 | Boolean | hotelInfoList.hotelRoomList.hotelPriceList | |
isAgreement | 是否协议协议 | Boolean | hotelInfoList.hotelRoomList.hotelPriceList | |
ratePlanRemark | 价格计划备注 | String | hotelInfoList.hotelRoomList.hotelPriceList | |
agreementContent | 协议内容 | String | hotelInfoList.hotelRoomList.hotelPriceList | |
agreementUrl | 协议内容Url | String | hotelInfoList.hotelRoomList.hotelPriceList | |
pricePlanType | 价格计划性质 | String | hotelInfoList.hotelRoomList.hotelPriceList | |
cancelType | 取消类型 0-免费取消 1-不可取消 2-限时取消 | Integer | hotelInfoList.hotelRoomList.hotelPriceList | |
freeCancelTime | 免费取消时间 yyyy-MM-dd HH:mm | String | hotelInfoList.hotelRoomList.hotelPriceList | |
prepayRule | 预付规则 | String | hotelInfoList.hotelRoomList.hotelPriceList | |
roomsAvailCount | 可预订数量 | Integer | hotelInfoList.hotelRoomList.hotelPriceList | |
occupancy | 入住人数 | Integer | hotelInfoList.hotelRoomList.hotelPriceList | |
priceList | 美亚销售价 | Array[] | hotelInfoList.hotelRoomList.hotelPriceList | |
sellDate | 日期,格式:yyyy-MM-dd | String | hotelInfoList.hotelRoomList.hotelPriceList.priceList | |
price | 每日售价 | Number | hotelInfoList.hotelRoomList.hotelPriceList.priceList | |
priceRebate | 收入返现,(每间夜价格) 正数 | Number | hotelInfoList.hotelRoomList.hotelPriceList.priceList | |
priceServiceAmount | 服务费 | Number | hotelInfoList.hotelRoomList.hotelPriceList.priceList | |
serviceStrategy | 服务费策略 | ServiceStrategy | hotelInfoList.hotelRoomList.hotelPriceList | |
billingUnit | 计费单位 0 无服务费 1按订单 2按间晚 3按房间 | Integer | hotelInfoList.hotelRoomList.hotelPriceList.serviceStrategy | |
percent | 服务费比例 | Number | hotelInfoList.hotelRoomList.hotelPriceList.serviceStrategy | |
quota | 服务费定额 | Number | hotelInfoList.hotelRoomList.hotelPriceList.serviceStrategy | |
desc |
服务费计算公式描述(四舍五入取整)
billingUnit=0:服务费是0; billingUnit=1:总房费*percent+quota; billingUnit=2:(总房费/间晚数*percent+quota)*晚数*间数; billingUnit=3:(总房费/间数*percent+quota)*间数 温馨提示:每间晚均价保留两位小数,服务费金额取整,四舍五入 |
String | hotelInfoList.hotelRoomList.hotelPriceList.serviceStrategy | |
guranteeRule | 供应商担保规则 | GuranteeRuleEntity | hotelInfoList.hotelRoomList.hotelPriceList | |
isTimeGuarantee | 是否到店时间担保,若isTimeGuarantee和isAmountGuarantee都为false,则为强制担保 | Boolean | hotelInfoList.hotelRoomList.hotelPriceList.guranteeRule | |
isAmountGuarantee | 是否房量担保,若isTimeGuarantee和isAmountGuarantee都为false,则为强制担保 | Boolean | hotelInfoList.hotelRoomList.hotelPriceList.guranteeRule | |
startTime | 到店担保开始时间 | String | hotelInfoList.hotelRoomList.hotelPriceList.guranteeRule | |
endTime | 到店担保结束时间 | String | hotelInfoList.hotelRoomList.hotelPriceList.guranteeRule | |
amount | 预订几间房及以上要担保 | Integer | hotelInfoList.hotelRoomList.hotelPriceList.guranteeRule | |
guaranteeType | 担保类型: FirstNightCost-首晚房费;FullNightCost-全额房费 | String | hotelInfoList.hotelRoomList.hotelPriceList.guranteeRule | |
cancelTime | 免费取消时间 | String | hotelInfoList.hotelRoomList.hotelPriceList.guranteeRule | |
RatePlanPolicy | 价格计划控制政策(可预订日期跨度,每订单最大可预订间数,提前预订天数) | RatePlanPolicy | hotelInfoList.hotelRoomList.hotelPriceList | |
MaxBookingDay | 最大预定天数 | Integer | hotelInfoList.hotelRoomList.hotelPriceList.RatePlanPolicy | |
MinBookingDay | 最小预定天数 | Integer | hotelInfoList.hotelRoomList.hotelPriceList.RatePlanPolicy | |
MaxBookingNum | 每订单最大可预订间数 | Integer | hotelInfoList.hotelRoomList.hotelPriceList.RatePlanPolicy | |
AdvanceDays | 提前预订天数 | Integer | hotelInfoList.hotelRoomList.hotelPriceList.RatePlanPolicy | |
MaxAdvanceDays | 最大提前预订天数 | Integer | hotelInfoList.hotelRoomList.hotelPriceList.RatePlanPolicy | |
customerTypeId | 宾客类型Id | Integer | hotelInfoList.hotelRoomList.hotelPriceList.RatePlanPolicy | |
customerTypeName | 宾客类型名称 | String | hotelInfoList.hotelRoomList.hotelPriceList.RatePlanPolicy | |
everyCheckInNum | 连住天数 | Integer | hotelInfoList.hotelRoomList.hotelPriceList.RatePlanPolicy | |
minBookingRoomNum | 最小预订间数 | Integer | hotelInfoList.hotelRoomList.hotelPriceList.RatePlanPolicy | |
detail | 特惠价描述 | String | hotelInfoList.hotelRoomList.hotelPriceList.RatePlanPolicy |
{
"count":0, //
"hotelInfoList":
[{
"hotelCode": "", //酒店编号
"hotelCNName": "", //酒店中文名
"hotelENName": "", //酒店英文名
"otherName": "", //酒店曾用名
"hotelUrl": "", //酒店官网地址
"hotelAddress": "", //酒店地址
"hotelOpeningTime": "", //开业时间 返回格式:1999
"starCode":0, //酒店星级编码:5-五星/豪华,4-四星/高档,3-三星/舒适,2-经济/客栈
"hotelDecorationTime": "", //装修时间 返回格式:1999
"RecommendCode": "", //推荐系数 1-推荐,2-热门,3-好评,4-促销
"hotelBusinessCircle": "", //所属城市区域 商圈区域
"areaName": "", //区域名称
"hotelPictureList":
[{
"hotelCode": "", //酒店编码
"imageName": "", //图片名称
"isMain": "", //酒店主图片 是否酒店主图片:0-是,1-否
"url": "", //图片url
"description": "", //图片描述
}], //酒店图片
"postalCode": "", //邮编
"longitude": "", //经度
"latitude": "", //纬度
"hotelPhone": "", //前台电话
"hotelFax": "", //前台传真
"groupName": "", //所属酒店集团,酒店集团名称
"hotelBrand":
{
"brandID": "", //品牌ID
"brandNameCN": "", //品牌中文名称
"brandNameEN": "", //品牌英文名称
"logoUrl": "", //品牌LOGO
"description": "", //品牌简介
}, //酒店品牌
"supportCARDSCodeList":
[{
"SupportCARDSCode": "", //支持卡类编码
"SupportCARDSName": "", //支持卡类名称
}], //支持的银行卡 多个时用,隔开
"generalAmenities": "", //服务设施
"roomAmenities": "", //房间设施
"recreationAmenities": "", //休闲设施
"conferenceAmenities": "", //会议设施
"diningAmenities": "", //餐饮设施
"description": "", //酒店简介
"location": "", //地理信息
"hotelMinPrice": "", //最低价
"hotelRoomList":
[{
"roomCode": "", //房型代码
"roomName": "", //房型名称
"fooler": "", //所在楼层
"acre": "", //房间面积
"bedType": "", //床型
"intent": "", //宽带标识 有/无/免费/收费
"hasWindows":0, //是否有窗 0:无窗,1:有窗,2:天窗,3:部分有窗,4:内窗
"WindowDesc": "", //窗型描述
"status": "", //房间状态 0-启用,1-停用
"extra": "", //是够可加床 是/否
"facilities": "", //房间设施
"description": "", //房间描述
"remark": "", //房间备注
"roomImgUrls":[], //房型图片
"hotelPriceList":
[{
"ratePlanID": "", //房价计划编号
"ratePlanName": "", //房价计划名称
"supplierCode": "", //供应商代号
"payType": "", //付款方式 1-预付,2-现付
"hasBreakfast": "", //早餐类型
"priceType": "", //价格类型 1-平日价,2-周末价
"currency": "", //币种 没有值时默认为0
"priceList":
[{
"sellDate": "", //日期,格式:yyyy-MM-dd
"price":0, //每日售价
"priceRebate":0, //收入返现,(每间夜价格) 正数
"priceServiceAmount":0, //服务费
}], //美亚销售价
"priceRebate":0, //返现
"isGaranteeRule":false, //是否需要担保 True=是,false=否
"garanteeDescription": "", //担保说明
"guranteeRule":
{
"isTimeGuarantee":false, //是否到店时间担保,若isTimeGuarantee和isAmountGuarantee都为false,则为强制担保
"isAmountGuarantee":false, //是否房量担保,若isTimeGuarantee和isAmountGuarantee都为false,则为强制担保
"startTime": "", //到店担保开始时间
"endTime": "", //到店担保结束时间
"amount":0, //预订几间房及以上要担保
"guaranteeType": "", //担保类型:
FirstNightCost-首晚房费;FullNightCost-全额房费
"cancelTime": "", //免费取消时间
}, //供应商担保规则
"termCancelDescription": "", //取消条款
"invStatus":false, //是否满房 True:满房-不可预订 False:正常-可以预订
"isAgreement":false, //是否协议协议
"ratePlanRemark": "", //价格计划备注
"agreementContent": "", //协议内容
"agreementUrl": "", //协议内容Url
"pricePlanType": "", //价格计划性质
"RatePlanPolicy":
{
"MaxBookingDay":0, //最大预定天数
"MinBookingDay":0, //最小预定天数
"MaxBookingNum":0, //每订单最大可预订间数
"AdvanceDays":0, //提前预订天数
"MaxAdvanceDays":0, //最大提前预订天数
"customerTypeId":0, //宾客类型Id
"customerTypeName": "", //宾客类型名称
"everyCheckInNum":0, //连住天数
"minBookingRoomNum":0, //最小预订间数
"detail": "", //特惠价描述
}, //价格计划控制政策(可预订日期跨度,每订单最大可预订间数,提前预订天数)
"cancelType":0, //取消类型 0-免费取消 1-不可取消 2-限时取消
"freeCancelTime": "", //免费取消时间 yyyy-MM-dd HH:mm
"prepayRule": "", //预付规则
"roomsAvailCount":0, //可预订数量
"occupancy":0, //入住人数
"serviceStrategy":
{
"billingUnit":0, //计费单位 0 无服务费 1按订单 2按间晚 3按房间
"percent":0, //服务费比例
"quota":0, //服务费定额
"desc": "", //服务费计算公式描述(四舍五入取整)
}, //服务费策略
}], //价格信息列表
}], //房型列表(酒店信息查询接口没有房型列表,酒店价格详情信息房型列表)
"strHotelTrafficInformation": "", //交通信息 add by linda
"distanceLandmarkLength":0, //距离地标长度
"invoiceType": "", //支持开发票类型
"roomState":0, //酒店房态,0售完,大于0可以预订,(目前只有0和1)
"cityCode": "", //城市编码
"cityName": "", //城市名称
"countryName": "", //国家名称
"ProvinceName": "", //省份名称
"helptips": "", //提示
"hotelServices":[], //附加服务
}], //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
hotelCode | 酒店编号 | String | 是 | |
checkInDate | 入住日期 | String | 是 | |
checkOutDate | 退房日期 | String | 是 | |
bedType | 床型:0为大床,1为双床,不传则取全部 , | Integer | 否 | |
hasFreeInternet | 是否宽带是否免费,1为免费,0为收费,不传则取全部 | Integer | 否 | |
hasBreakfast | 是否含早,1为含早,0为不含早,不传则取全部 , | Integer | 否 | |
isAgreementPrice | 是否协议价,1为是,0为否,不传则取全部 , | Integer | 否 | |
maxPrice | 最高价 | Number | 否 | |
minPrice | 最低价 | Number | 否 | |
paymentType | 支付方式,26为预付,24为现付,不传则取全部 , | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"hotelCode": "", //酒店编号
"checkInDate": "", //入住日期
"checkOutDate": "", //退房日期
"bedType":0, //床型:0为大床,1为双床,不传则取全部 ,
"hasFreeInternet":0, //是否宽带是否免费,1为免费,0为收费,不传则取全部
"hasBreakfast":0, //是否含早,1为含早,0为不含早,不传则取全部 ,
"isAgreementPrice":0, //是否协议价,1为是,0为否,不传则取全部 ,
"maxPrice":0, //最高价
"minPrice":0, //最低价
"paymentType":0, //支付方式,26为预付,24为现付,不传则取全部 ,
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
hotelInfo | 酒店详情 | HotelInfo | ||
hotelCode | 酒店编号 | String | hotelInfo | |
hotelCNName | 酒店中文名 | String | hotelInfo | |
hotelENName | 酒店英文名 | String | hotelInfo | |
otherName | 酒店曾用名 | String | hotelInfo | |
hotelUrl | 酒店官网地址 | String | hotelInfo | |
hotelAddress | 酒店地址 | String | hotelInfo | |
hotelOpeningTime | 开业时间 返回格式:1999 | String | hotelInfo | |
starCode | 酒店星级编码:5-五星/豪华,4-四星/高档,3-三星/舒适,2-经济/客栈 | Integer | hotelInfo | |
hotelDecorationTime | 装修时间 返回格式:1999 | String | hotelInfo | |
RecommendCode | 推荐系数 1-推荐,2-热门,3-好评,4-促销 | String | hotelInfo | |
hotelBusinessCircle | 所属城市区域 商圈区域 | String | hotelInfo | |
areaName | 区域名称 | String | hotelInfo | |
postalCode | 邮编 | String | hotelInfo | |
longitude | 经度 | String | hotelInfo | |
latitude | 纬度 | String | hotelInfo | |
hotelPhone | 前台电话 | String | hotelInfo | |
hotelFax | 前台传真 | String | hotelInfo | |
groupName | 所属酒店集团,酒店集团名称 | String | hotelInfo | |
generalAmenities | 服务设施 | String | hotelInfo | |
roomAmenities | 房间设施 | String | hotelInfo | |
recreationAmenities | 休闲设施 | String | hotelInfo | |
conferenceAmenities | 会议设施 | String | hotelInfo | |
diningAmenities | 餐饮设施 | String | hotelInfo | |
description | 酒店简介 | String | hotelInfo | |
location | 地理信息 | String | hotelInfo | |
hotelMinPrice | 最低价 | String | hotelInfo | |
strHotelTrafficInformation | 交通信息 add by linda | String | hotelInfo | |
distanceLandmarkLength | 距离地标长度 | Integer | hotelInfo | |
invoiceType | 支持开发票类型 | String | hotelInfo | |
roomState | 酒店房态,0售完,大于0可以预订,(目前只有0和1) | Integer | hotelInfo | |
cityCode | 城市编码 | String | hotelInfo | |
cityName | 城市名称 | String | hotelInfo | |
countryName | 国家名称 | String | hotelInfo | |
ProvinceName | 省份名称 | String | hotelInfo | |
helptips | 提示 | String | hotelInfo | |
hotelServices | 附加服务 | Array[] | hotelInfo | |
supportCARDSCodeList | 支持的银行卡 多个时用,隔开 | Array[] | hotelInfo | |
SupportCARDSCode | 支持卡类编码 | String | hotelInfo.supportCARDSCodeList | |
SupportCARDSName | 支持卡类名称 | String | hotelInfo.supportCARDSCodeList | |
hotelPictureList | 酒店图片 | Array[] | hotelInfo | |
hotelCode | 酒店编码 | String | hotelInfo.hotelPictureList | |
imageName | 图片名称 | String | hotelInfo.hotelPictureList | |
isMain | 酒店主图片 是否酒店主图片:0-是,1-否 | String | hotelInfo.hotelPictureList | |
url | 图片url | String | hotelInfo.hotelPictureList | |
description | 图片描述 | String | hotelInfo.hotelPictureList | |
hotelBrand | 酒店品牌 | HotelBrandInfo | hotelInfo | |
brandID | 品牌ID | String | hotelInfo.hotelBrand | |
brandNameCN | 品牌中文名称 | String | hotelInfo.hotelBrand | |
brandNameEN | 品牌英文名称 | String | hotelInfo.hotelBrand | |
logoUrl | 品牌LOGO | String | hotelInfo.hotelBrand | |
description | 品牌简介 | String | hotelInfo.hotelBrand | |
hotelRoomList | 房型列表(酒店信息查询接口没有房型列表,酒店价格详情信息房型列表) | Array[] | hotelInfo | |
roomCode | 房型代码 | String | hotelInfo.hotelRoomList | |
roomName | 房型名称 | String | hotelInfo.hotelRoomList | |
fooler | 所在楼层 | String | hotelInfo.hotelRoomList | |
acre | 房间面积 | String | hotelInfo.hotelRoomList | |
bedType | 床型 | String | hotelInfo.hotelRoomList | |
intent | 宽带标识 有/无/免费/收费 | String | hotelInfo.hotelRoomList | |
hasWindows | 是否有窗 0:无窗,1:有窗,2:天窗,3:部分有窗,4:内窗 | Integer | hotelInfo.hotelRoomList | |
WindowDesc | 窗型描述 | String | hotelInfo.hotelRoomList | |
status | 房间状态 0-启用,1-停用 | String | hotelInfo.hotelRoomList | |
extra | 是够可加床 是/否 | String | hotelInfo.hotelRoomList | |
facilities | 房间设施 | String | hotelInfo.hotelRoomList | |
description | 房间描述 | String | hotelInfo.hotelRoomList | |
remark | 房间备注 | String | hotelInfo.hotelRoomList | |
roomImgUrls | 房型图片 | Array[] | hotelInfo.hotelRoomList | |
hotelPriceList | 价格信息列表 | Array[] | hotelInfo.hotelRoomList | |
ratePlanID | 房价计划编号 | String | hotelInfo.hotelRoomList.hotelPriceList | |
ratePlanName | 房价计划名称 | String | hotelInfo.hotelRoomList.hotelPriceList | |
supplierCode | 供应商代号 | String | hotelInfo.hotelRoomList.hotelPriceList | |
payType | 付款方式 1-预付,2-现付 | String | hotelInfo.hotelRoomList.hotelPriceList | |
hasBreakfast |
早餐类型
未知,含早,无早,单早, 双早,三早, 多早,不含早, 含零早,含单早,含双早, 含三早,含四早,含五早, 含六早,含七早,含八早, 含单双早,床位早,含床位早, 双早+午餐/晚餐,不含早餐, 无餐/无早,一份早餐, 两份早餐,床位早餐, 床位中餐,床位晚餐,儿童早, 三份早餐,四份早餐, 五份早餐,六份早餐, 七份早餐,八份早餐, 九份早餐,十份早餐, 2大1小早餐,2大1小晚餐, 双早双晚 |
String | hotelInfo.hotelRoomList.hotelPriceList | |
priceType | 价格类型 1-平日价,2-周末价 | String | hotelInfo.hotelRoomList.hotelPriceList | |
currency | 币种 没有值时默认为0 | String | hotelInfo.hotelRoomList.hotelPriceList | |
priceRebate | 返现 | Number | hotelInfo.hotelRoomList.hotelPriceList | |
isGaranteeRule | 是否需要担保 True=是,false=否 | Boolean | hotelInfo.hotelRoomList.hotelPriceList | |
garanteeDescription | 担保说明 | String | hotelInfo.hotelRoomList.hotelPriceList | |
termCancelDescription | 取消条款 | String | hotelInfo.hotelRoomList.hotelPriceList | |
invStatus | 是否满房 True:满房-不可预订 False:正常-可以预订 | Boolean | hotelInfo.hotelRoomList.hotelPriceList | |
isAgreement | 是否协议协议 | Boolean | hotelInfo.hotelRoomList.hotelPriceList | |
ratePlanRemark | 价格计划备注 | String | hotelInfo.hotelRoomList.hotelPriceList | |
agreementContent | 协议内容 | String | hotelInfo.hotelRoomList.hotelPriceList | |
agreementUrl | 协议内容Url | String | hotelInfo.hotelRoomList.hotelPriceList | |
pricePlanType | 价格计划性质 | String | hotelInfo.hotelRoomList.hotelPriceList | |
cancelType | 取消类型 0-免费取消 1-不可取消 2-限时取消 | Integer | hotelInfo.hotelRoomList.hotelPriceList | |
freeCancelTime | 免费取消时间 yyyy-MM-dd HH:mm | String | hotelInfo.hotelRoomList.hotelPriceList | |
prepayRule | 预付规则 | String | hotelInfo.hotelRoomList.hotelPriceList | |
roomsAvailCount | 可预订数量 | Integer | hotelInfo.hotelRoomList.hotelPriceList | |
occupancy | 入住人数 | Integer | hotelInfo.hotelRoomList.hotelPriceList | |
priceList | 美亚销售价 | Array[] | hotelInfo.hotelRoomList.hotelPriceList | |
sellDate | 日期,格式:yyyy-MM-dd | String | hotelInfo.hotelRoomList.hotelPriceList.priceList | |
price | 每日售价 | Number | hotelInfo.hotelRoomList.hotelPriceList.priceList | |
priceRebate | 收入返现,(每间夜价格) 正数 | Number | hotelInfo.hotelRoomList.hotelPriceList.priceList | |
priceServiceAmount | 服务费 | Number | hotelInfo.hotelRoomList.hotelPriceList.priceList | |
serviceStrategy | 服务费策略 | ServiceStrategy | hotelInfo.hotelRoomList.hotelPriceList | |
billingUnit | 计费单位 0 无服务费 1按订单 2按间晚 3按房间 | Integer | hotelInfo.hotelRoomList.hotelPriceList.serviceStrategy | |
percent | 服务费比例 | Number | hotelInfo.hotelRoomList.hotelPriceList.serviceStrategy | |
quota | 服务费定额 | Number | hotelInfo.hotelRoomList.hotelPriceList.serviceStrategy | |
desc |
服务费计算公式描述(四舍五入取整)
billingUnit=0:服务费是0; billingUnit=1:总房费*percent+quota; billingUnit=2:(总房费/间晚数*percent+quota)*晚数*间数; billingUnit=3:(总房费/间数*percent+quota)*间数 温馨提示:每间晚均价保留两位小数,服务费金额取整,四舍五入 |
String | hotelInfo.hotelRoomList.hotelPriceList.serviceStrategy | |
guranteeRule | 供应商担保规则 | GuranteeRuleEntity | hotelInfo.hotelRoomList.hotelPriceList | |
isTimeGuarantee | 是否到店时间担保,若isTimeGuarantee和isAmountGuarantee都为false,则为强制担保 | Boolean | hotelInfo.hotelRoomList.hotelPriceList.guranteeRule | |
isAmountGuarantee | 是否房量担保,若isTimeGuarantee和isAmountGuarantee都为false,则为强制担保 | Boolean | hotelInfo.hotelRoomList.hotelPriceList.guranteeRule | |
startTime | 到店担保开始时间 | String | hotelInfo.hotelRoomList.hotelPriceList.guranteeRule | |
endTime | 到店担保结束时间 | String | hotelInfo.hotelRoomList.hotelPriceList.guranteeRule | |
amount | 预订几间房及以上要担保 | Integer | hotelInfo.hotelRoomList.hotelPriceList.guranteeRule | |
guaranteeType | 担保类型: FirstNightCost-首晚房费;FullNightCost-全额房费 | String | hotelInfo.hotelRoomList.hotelPriceList.guranteeRule | |
cancelTime | 免费取消时间 | String | hotelInfo.hotelRoomList.hotelPriceList.guranteeRule | |
RatePlanPolicy | 价格计划控制政策(可预订日期跨度,每订单最大可预订间数,提前预订天数) | RatePlanPolicy | hotelInfo.hotelRoomList.hotelPriceList | |
MaxBookingDay | 最大预定天数 | Integer | hotelInfo.hotelRoomList.hotelPriceList.RatePlanPolicy | |
MinBookingDay | 最小预定天数 | Integer | hotelInfo.hotelRoomList.hotelPriceList.RatePlanPolicy | |
MaxBookingNum | 每订单最大可预订间数 | Integer | hotelInfo.hotelRoomList.hotelPriceList.RatePlanPolicy | |
AdvanceDays | 提前预订天数 | Integer | hotelInfo.hotelRoomList.hotelPriceList.RatePlanPolicy | |
MaxAdvanceDays | 最大提前预订天数 | Integer | hotelInfo.hotelRoomList.hotelPriceList.RatePlanPolicy | |
customerTypeId | 宾客类型Id | Integer | hotelInfo.hotelRoomList.hotelPriceList.RatePlanPolicy | |
customerTypeName | 宾客类型名称 | String | hotelInfo.hotelRoomList.hotelPriceList.RatePlanPolicy | |
everyCheckInNum | 连住天数 | Integer | hotelInfo.hotelRoomList.hotelPriceList.RatePlanPolicy | |
minBookingRoomNum | 最小预订间数 | Integer | hotelInfo.hotelRoomList.hotelPriceList.RatePlanPolicy | |
detail | 特惠价描述 | String | hotelInfo.hotelRoomList.hotelPriceList.RatePlanPolicy |
{
"hotelInfo":
{
"hotelCode": "", //酒店编号
"hotelCNName": "", //酒店中文名
"hotelENName": "", //酒店英文名
"otherName": "", //酒店曾用名
"hotelUrl": "", //酒店官网地址
"hotelAddress": "", //酒店地址
"hotelOpeningTime": "", //开业时间 返回格式:1999
"starCode":0, //酒店星级编码:5-五星/豪华,4-四星/高档,3-三星/舒适,2-经济/客栈
"hotelDecorationTime": "", //装修时间 返回格式:1999
"RecommendCode": "", //推荐系数 1-推荐,2-热门,3-好评,4-促销
"hotelBusinessCircle": "", //所属城市区域 商圈区域
"areaName": "", //区域名称
"hotelPictureList":
[{
"hotelCode": "", //酒店编码
"imageName": "", //图片名称
"isMain": "", //酒店主图片 是否酒店主图片:0-是,1-否
"url": "", //图片url
"description": "", //图片描述
}], //酒店图片
"postalCode": "", //邮编
"longitude": "", //经度
"latitude": "", //纬度
"hotelPhone": "", //前台电话
"hotelFax": "", //前台传真
"groupName": "", //所属酒店集团,酒店集团名称
"hotelBrand":
{
"brandID": "", //品牌ID
"brandNameCN": "", //品牌中文名称
"brandNameEN": "", //品牌英文名称
"logoUrl": "", //品牌LOGO
"description": "", //品牌简介
}, //酒店品牌
"supportCARDSCodeList":
[{
"SupportCARDSCode": "", //支持卡类编码
"SupportCARDSName": "", //支持卡类名称
}], //支持的银行卡 多个时用,隔开
"generalAmenities": "", //服务设施
"roomAmenities": "", //房间设施
"recreationAmenities": "", //休闲设施
"conferenceAmenities": "", //会议设施
"diningAmenities": "", //餐饮设施
"description": "", //酒店简介
"location": "", //地理信息
"hotelMinPrice": "", //最低价
"hotelRoomList":
[{
"roomCode": "", //房型代码
"roomName": "", //房型名称
"fooler": "", //所在楼层
"acre": "", //房间面积
"bedType": "", //床型
"intent": "", //宽带标识 有/无/免费/收费
"hasWindows":0, //是否有窗 0:无窗,1:有窗,2:天窗,3:部分有窗,4:内窗
"WindowDesc": "", //窗型描述
"status": "", //房间状态 0-启用,1-停用
"extra": "", //是够可加床 是/否
"facilities": "", //房间设施
"description": "", //房间描述
"remark": "", //房间备注
"roomImgUrls":[], //房型图片
"hotelPriceList":
[{
"ratePlanID": "", //房价计划编号
"ratePlanName": "", //房价计划名称
"supplierCode": "", //供应商代号
"payType": "", //付款方式 1-预付,2-现付
"hasBreakfast": "", //早餐类型
"priceType": "", //价格类型 1-平日价,2-周末价
"currency": "", //币种 没有值时默认为0
"priceList":
[{
"sellDate": "", //日期,格式:yyyy-MM-dd
"price":0, //每日售价
"priceRebate":0, //收入返现,(每间夜价格) 正数
"priceServiceAmount":0, //服务费
}], //美亚销售价
"priceRebate":0, //返现
"isGaranteeRule":false, //是否需要担保 True=是,false=否
"garanteeDescription": "", //担保说明
"guranteeRule":
{
"isTimeGuarantee":false, //是否到店时间担保,若isTimeGuarantee和isAmountGuarantee都为false,则为强制担保
"isAmountGuarantee":false, //是否房量担保,若isTimeGuarantee和isAmountGuarantee都为false,则为强制担保
"startTime": "", //到店担保开始时间
"endTime": "", //到店担保结束时间
"amount":0, //预订几间房及以上要担保
"guaranteeType": "", //担保类型:
FirstNightCost-首晚房费;FullNightCost-全额房费
"cancelTime": "", //免费取消时间
}, //供应商担保规则
"termCancelDescription": "", //取消条款
"invStatus":false, //是否满房 True:满房-不可预订 False:正常-可以预订
"isAgreement":false, //是否协议协议
"ratePlanRemark": "", //价格计划备注
"agreementContent": "", //协议内容
"agreementUrl": "", //协议内容Url
"pricePlanType": "", //价格计划性质
"RatePlanPolicy":
{
"MaxBookingDay":0, //最大预定天数
"MinBookingDay":0, //最小预定天数
"MaxBookingNum":0, //每订单最大可预订间数
"AdvanceDays":0, //提前预订天数
"MaxAdvanceDays":0, //最大提前预订天数
"customerTypeId":0, //宾客类型Id
"customerTypeName": "", //宾客类型名称
"everyCheckInNum":0, //连住天数
"minBookingRoomNum":0, //最小预订间数
"detail": "", //特惠价描述
}, //价格计划控制政策(可预订日期跨度,每订单最大可预订间数,提前预订天数)
"cancelType":0, //取消类型 0-免费取消 1-不可取消 2-限时取消
"freeCancelTime": "", //免费取消时间 yyyy-MM-dd HH:mm
"prepayRule": "", //预付规则
"roomsAvailCount":0, //可预订数量
"occupancy":0, //入住人数
"serviceStrategy":
{
"billingUnit":0, //计费单位 0 无服务费 1按订单 2按间晚 3按房间
"percent":0, //服务费比例
"quota":0, //服务费定额
"desc": "", //服务费计算公式描述(四舍五入取整)
}, //服务费策略
}], //价格信息列表
}], //房型列表(酒店信息查询接口没有房型列表,酒店价格详情信息房型列表)
"strHotelTrafficInformation": "", //交通信息 add by linda
"distanceLandmarkLength":0, //距离地标长度
"invoiceType": "", //支持开发票类型
"roomState":0, //酒店房态,0售完,大于0可以预订,(目前只有0和1)
"cityCode": "", //城市编码
"cityName": "", //城市名称
"countryName": "", //国家名称
"ProvinceName": "", //省份名称
"helptips": "", //提示
"hotelServices":[], //附加服务
}, //酒店详情
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outSideOrderNo | 外部订单号 | String | 是 | |
hotelCode | 酒店编号 | String | 是 | |
roomCode | 房型编号 | String | 否 | |
ratePlanID | 房价计划编号 | String | 否 | |
supplierCode | 供应商代号 | String | 否 | |
checkInDate | 入住日期 格式:yyyy-MM-dd | String | 是 | |
checkOutDate | 离店日期 格式:yyyy-MM-dd | String | 是 | |
payType | 付款方式 可选值:1-预付,2-现付 | Integer | 是 | |
roomNum | 房间数量 | Integer | 是 | |
passengerNum | 客人数量 | Integer | 否 | |
firstArriveTime | 最早到店时间 yyyy-MM-dd HH:mm | String | 是 | |
lastArriveTime | 最晚到店时间 yyyy-MM-dd HH:mm | String | 是 | |
remark | 给美亚的备注 | String | 否 | |
oaSerialnumber | 出差申请单号 | String | 否 | |
TotalServiceAmount | 订单总服务费(四舍五入取整) | Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
contactInfo | 联系人信息 | ContactInfo | 是 | |
contactName | 联系人 | String | contactInfo | |
mobile | 手机号码 | String | contactInfo | |
phone | 联系电话 | String | contactInfo | |
电子邮件 | String | contactInfo | ||
datePriceList | 每日价格明细 | Array[] | 否 | |
sellDate | 日期,格式:yyyy-MM-dd | String | datePriceList | |
price | 每日售价 | Number | datePriceList | |
priceRebate | 收入返现,(每间夜价格) 正数 | Number | datePriceList | |
priceServiceAmount | 服务费 | Number | datePriceList | |
creditInfo | 信用卡信息 需要担保时不可为空 | OrderCredit | 否 | |
cardNo | 卡号 | String | creditInfo | |
CardType |
信用卡种类
信用卡卡种 1001,招商银行 1002,中国银行 1003,中国工商银行 1004,中国建设银行 1005,中信银行 1006,广发银行 1007,深圳发展银行 1008,兴业银行 1009,中国光大银行 1010,交通银行 1011,VISA 1012,MASTERCARD 1013,AMEX 1015,JCB 1021,中国民生银行 1022,上海浦东发展银行 1023,平安银行 1024,北京银行 1025,华夏银行 1026,上海银行 1027,中国邮政储蓄银行 1028,中国农业银行 1029,宁波银行 携程酒店信用卡卡种 1,中国银行 2,工商银行 3,交通银行 4,农业银行 5,中国建设银行 6,万事达(Master) 7,威士(VISA) 8,运通(AMEX) 10,JCB 11,招商银行 13,广发银行 15,光大银行 16,民生银行 17,中信银行 18,浦发银行 20,兴业银行 21,上海银行 22,平安银行 24,华夏银行 26,东亚银行 27,北京银行 501,邮政储蓄银行 502,北京农商银行 515,广州银行 516,广州农村商业银行 536,上海农商银行 569,东亚银行 572,花旗银行 |
Integer | creditInfo | |
cvv | CVV码 需要CVV码的信用卡不许为空 | String | creditInfo | |
expirationYear | 有效期-年 例如:2020 | Integer | creditInfo | |
expirationMonth | 有效期-月 | Integer | creditInfo | |
holderName | 持卡人姓名 | String | creditInfo | |
idType | 证件类型 1:身份证,2:护照,3:其它 | Integer | creditInfo | |
idNo | 证件号码 | String | creditInfo | |
passengerList | 旅客信息 | Array[] | 是 | |
uatpCardNameList | uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
uatpCardNumberList | uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
passengerJruisdictions | 拥有的权限列表(根据passengerJruisdictionType决定) | Array[] | passengerList | |
passengerJruisdictionType | passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理 | Integer | passengerList | |
outsidePassengerId | 对接方系统的旅客编号 | String | passengerList | |
passengerId | 美亚旅客编号(不用传) | String | passengerList | |
passengerName | 乘机人姓名 | String | passengerList | |
passengerType | 旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿) | String | passengerList | |
companyId | 公司编号 | String | passengerList | |
sex | 必传 性别:男/女;不能传其他字符 | String | passengerList | |
cnName | 中文姓名(中文姓名、英文姓名2选一) | String | passengerList | |
enName | 英文姓名(中文姓名、英文姓名2选一,格式:zhang/san) | String | passengerList | |
userName | 登录用户名 | String | passengerList | |
dId | 部门ID(不传) | Integer | passengerList | |
dName | 部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | passengerList | |
nationality | 国籍:中国填写 CN,必传 | String | passengerList | |
birthday | 出生日期(yyyy-MM-dd)必传 | String | passengerList | |
mobile | 手机号码 | String | passengerList | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | passengerList | |
电子邮箱 | String | passengerList | ||
defaultRoleId | 默认角色 | String | passengerList | |
holderId | 职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值 | String | passengerList | |
postID | 职位ID | String | passengerList | |
approvalOutsideId | 审批人的外部系统编号 | String | passengerList | |
SuperVip | 0:非VIP 1VIP | Integer | passengerList | |
phone | 固定电话 | String | passengerList | |
policyId | 差旅政策ID;如果是非正常职等差标满足不了的,则使用policyId传美亚差标ID,进行跨职等差标预订;例如旅客配领导享受领导差标; | String | passengerList | |
staffId | 员工工号 | String | passengerList | |
chooseSeatNo | 在线选座(火车票)如:1A | String | passengerList | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | passengerList | |
CostList | 成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可 | Array[] | passengerList | |
costCenterName | 成本中心名称 | String | passengerList.CostList | |
insuranceList | 保险产品信息 | Array[] | passengerList | |
insuranceId | 保险产品编号(联系美亚获取) | Integer | passengerList.insuranceList | |
insuranceCount | 保险份数(一般最大是两份) | Integer | passengerList.insuranceList | |
certificatePhoto | 证件图片信息(只有国际机票使用,其他产品传null 或者不处理) | CertificatePhoto | passengerList | |
fileName | 文件名称 | String | passengerList.certificatePhoto | |
fileCode | 文件流 | String | passengerList.certificatePhoto | |
frequentTraveller | 常旅卡信息 | FrequentTraveller | passengerList | |
airlineCode | 航司二字码 | String | passengerList.frequentTraveller | |
cardName | 常旅卡名称 | String | passengerList.frequentTraveller | |
cardNumber | 常旅卡号 | String | passengerList.frequentTraveller | |
certificatesList | 证件 | Array[] | passengerList | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | passengerList.certificatesList | |
certNumber | 证件号码 | String | passengerList.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | passengerList.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | passengerList.certificatesList |
{
"outSideOrderNo": "", //外部订单号
"hotelCode": "", //酒店编号
"roomCode": "", //房型编号
"ratePlanID": "", //房价计划编号
"supplierCode": "", //供应商代号
"checkInDate": "", //入住日期 格式:yyyy-MM-dd
"checkOutDate": "", //离店日期 格式:yyyy-MM-dd
"passengerList":
[{
"uatpCardNameList":"null", //uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理)
"uatpCardNumberList":"null", //uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理)
"passengerJruisdictions":"null", //拥有的权限列表(根据passengerJruisdictionType决定)
"passengerJruisdictionType":0, //passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理
"outsidePassengerId":"ak10002", //对接方系统的旅客编号
"passengerId": "", //美亚旅客编号(不用传)
"passengerName":"刘展超", //乘机人姓名
"passengerType":"成人", //旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿)
"companyId":"S118022", //公司编号
"sex":"男", //必传 性别:男/女;不能传其他字符
"cnName":"刘展超", //中文姓名(中文姓名、英文姓名2选一)
"enName":"liu/zhanchao", //英文姓名(中文姓名、英文姓名2选一,格式:zhang/san)
"userName":"AK_liuzhanchao", //登录用户名
"dId":0, //部门ID(不传)
"dName":"美亚集团/旅游产品部/运营中心", //部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"nationality":"CN", //国籍:中国填写 CN,必传
"birthday":"2000-01-20", //出生日期(yyyy-MM-dd)必传
"mobile":"18628535565", //手机号码
"mobileAreaCode":"556", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"CostList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件
"defaultRoleId": "", //默认角色
"holderId":"M1", //职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值
"postID":"一厂经理", //职位ID
"approvalOutsideId": "", //审批人的外部系统编号
"SuperVip":0, //0:非VIP 1VIP
"phone":"020-82862903", //固定电话
"policyId": "", //差旅政策ID;如果是非正常职等差标满足不了的,则使用policyId传美亚差标ID,进行跨职等差标预订;例如旅客配领导享受领导差标;
"staffId": "", //员工工号
"insuranceList":
[{
"insuranceId":0, //保险产品编号(联系美亚获取)
"insuranceCount":0, //保险份数(一般最大是两份)
}], //保险产品信息
"chooseSeatNo": "", //在线选座(火车票)如:1A
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
"frequentTraveller":
{
"airlineCode":"MU", //航司二字码
"cardName":"东方明珠积分卡", //常旅卡名称
"cardNumber":"7894587775", //常旅卡号
}, //常旅卡信息
"certificatePhoto":
{
"fileName":"我的证件.jpg", //文件名称
"fileCode":"ADWHIFHWFJJSFJWFJ...", //文件流
}, //证件图片信息(只有国际机票使用,其他产品传null 或者不处理)
}], //旅客信息
"payType":0, //付款方式 可选值:1-预付,2-现付
"roomNum":0, //房间数量
"passengerNum":0, //客人数量
"firstArriveTime": "", //最早到店时间 yyyy-MM-dd HH:mm
"lastArriveTime": "", //最晚到店时间 yyyy-MM-dd HH:mm
"remark": "", //给美亚的备注
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"creditInfo":
{
"cardNo": "", //卡号
"CardType":0, //信用卡种类
"cvv": "", //CVV码 需要CVV码的信用卡不许为空
"expirationYear":0, //有效期-年 例如:2020
"expirationMonth":0, //有效期-月
"holderName": "", //持卡人姓名
"idType":0, //证件类型 1:身份证,2:护照,3:其它
"idNo": "", //证件号码
}, //信用卡信息 需要担保时不可为空
"datePriceList":
[{
"sellDate": "", //日期,格式:yyyy-MM-dd
"price":0, //每日售价
"priceRebate":0, //收入返现,(每间夜价格) 正数
"priceServiceAmount":0, //服务费
}], //每日价格明细
"oaSerialnumber": "", //出差申请单号
"TotalServiceAmount":0, //订单总服务费(四舍五入取整)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 订单号 | String | ||
serviceFee | 总服务费 | Number | ||
totalAmount | 订单总金额 | Number | ||
priceRebate | 总返现 | Number | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo": "", //订单号
"serviceFee":0, //总服务费
"totalAmount":0, //订单总金额
"priceRebate":0, //总返现
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
OrderNo | 订单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"OrderNo": "", //订单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
OrderNo | 美亚订购单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"OrderNo": "", //美亚订购单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单编号 | String | 否 | |
outSideOrderNo | 客户订单号 | String | 否 | |
startDate | 制单开始时间 | String | 否 | |
endDate | 制单截止时间 | String | 否 | |
hotelName | 酒店名称 | String | 否 | |
checkInDateStart | 入住开始日期 | String | 否 | |
checkOutDateEnd | 入住截止时间 | String | 否 | |
passengerName | 旅客姓名 | String | 否 | |
orderStatus | 订单状态 | Integer | 否 | |
submitName | 客户制单人 | String | 否 | |
payType | 付款方式 | Integer | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageCount | 每页显示条数 | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo": "", //订单编号
"outSideOrderNo": "", //客户订单号
"startDate": "", //制单开始时间
"endDate": "", //制单截止时间
"hotelName": "", //酒店名称
"checkInDateStart": "", //入住开始日期
"checkOutDateEnd": "", //入住截止时间
"passengerName": "", //旅客姓名
"orderStatus":0, //订单状态
"submitName": "", //客户制单人
"payType":0, //付款方式
"pageIndex":0, //页码
"pageCount":0, //每页显示条数
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
count | 订单总数 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
orderInfoList | 订单列表信息 | Array[] | ||
orderNo | 美亚订单号 | String | orderInfoList | |
outsideOrderNo | 外部订单号 | String | orderInfoList | |
hotelCode | 酒店编号 | String | orderInfoList | |
hotelName | 酒店名称 | String | orderInfoList | |
roomCode | 房型编号 | String | orderInfoList | |
roomName | 房型名称 | String | orderInfoList | |
city | 城市 | String | orderInfoList | |
checkInDate | 入住日期 | String | orderInfoList | |
checkOutDate | 离店日期 | String | orderInfoList | |
orderStatus | 订单状态 : 不限 = 0,暂缓订单 = 1,审批中 = 2, 预订中 = 3,欠款暂停 = 4,已订房 = 5,过期未住 = 6,已成交 = 7,已取消 = 8 | Integer | orderInfoList | |
checkInStatus | 入住状态:待入住=0,已入住=10,已离店=20,未同步状态=30 | Integer | orderInfoList | |
passengerCount | 旅客人数 | Integer | orderInfoList | |
payType | 付款方式 | Integer | orderInfoList | |
nightCount | 预订晚数 | Integer | orderInfoList | |
roomCount | 预订间数 | Integer | orderInfoList | |
rooms | 预订间晚数 | Integer | orderInfoList | |
firstArriveTime | 最早到店时间 | String | orderInfoList | |
lastArriveTime | 最晚到店时间 | String | orderInfoList | |
currency | 货币类型 | String | orderInfoList | |
amount | 订单总价 | Number | orderInfoList | |
stRemark | 给美亚的备注 | String | orderInfoList | |
submitName | 客户制单人 | String | orderInfoList | |
submitTime | 制单时间 | String | orderInfoList | |
canCancel | 当前是否可取消 | Boolean | orderInfoList | |
CreditCardNo | 信用卡卡号 | String | orderInfoList | |
holderName | 信用卡持卡人 | String | orderInfoList | |
garanteeRule | 担保规则 | String | orderInfoList | |
payRule | 预付规则 | String | orderInfoList | |
serviceFee | 服务费 | Number | orderInfoList | |
rebateFee | 返现 | Number | orderInfoList | |
priceService | 实际服务费 | Number | orderInfoList | |
priceRebate | 实际返现 | Number | orderInfoList | |
costList | 成本中心信息 | Array[] | orderInfoList | |
costCenterName | 成本中心名称 | String | orderInfoList.costList | |
contactInfo | 联系人信息 | Array[] | orderInfoList | |
contactName | 联系人 | String | orderInfoList.contactInfo | |
mobile | 手机号码 | String | orderInfoList.contactInfo | |
phone | 联系电话 | String | orderInfoList.contactInfo | |
电子邮件 | String | orderInfoList.contactInfo | ||
priceList | 每日价格明细 | Array[] | orderInfoList | |
sellDate | 日期,格式:yyyy-MM-dd | String | orderInfoList.priceList | |
price | 每日售价 | Number | orderInfoList.priceList | |
priceRebate | 收入返现,(每间夜价格) 正数 | Number | orderInfoList.priceList | |
priceServiceAmount | 服务费 | Number | orderInfoList.priceList | |
auditInfoList | 订单审批信息 | Array[] | orderInfoList | |
actName | 环节 | String | orderInfoList.auditInfoList | |
opName | 操作人 | String | orderInfoList.auditInfoList | |
opResult | 处理结果 | String | orderInfoList.auditInfoList | |
opTime | 操作时间 | String | orderInfoList.auditInfoList | |
remark | 备注 | String | orderInfoList.auditInfoList | |
passengerList | 旅客信息 | Array[] | orderInfoList | |
orderNo | String | orderInfoList.passengerList | ||
num | Integer | orderInfoList.passengerList | ||
passengerCode | String | orderInfoList.passengerList | ||
passengerName | String | orderInfoList.passengerList | ||
sex | String | orderInfoList.passengerList | ||
nationality | String | orderInfoList.passengerList | ||
idType | String | orderInfoList.passengerList | ||
idNo | String | orderInfoList.passengerList | ||
birthday | String | orderInfoList.passengerList | ||
passengerType | String | orderInfoList.passengerList | ||
mobile | String | orderInfoList.passengerList | ||
reasonID | Integer | orderInfoList.passengerList | ||
reasonRemark | String | orderInfoList.passengerList | ||
TicketNo | 酒店房间编号 | String | orderInfoList.passengerList |
{
"count":0, //订单总数
"orderInfoList":
[{
"orderNo": "", //美亚订单号
"outsideOrderNo": "", //外部订单号
"hotelCode": "", //酒店编号
"hotelName": "", //酒店名称
"roomCode": "", //房型编号
"roomName": "", //房型名称
"city": "", //城市
"checkInDate": "", //入住日期
"checkOutDate": "", //离店日期
"orderStatus":0, //订单状态 : 不限 = 0,暂缓订单 = 1,审批中 = 2, 预订中 = 3,欠款暂停 = 4,已订房 = 5,过期未住 = 6,已成交 = 7,已取消 = 8
"checkInStatus":0, //入住状态:待入住=0,已入住=10,已离店=20,未同步状态=30
"passengerCount":0, //旅客人数
"passengerList":
[{
"orderNo": "", //
"num":0, //
"passengerCode": "", //
"passengerName": "", //
"sex": "", //
"nationality": "", //
"idType": "", //
"idNo": "", //
"birthday": "", //
"passengerType": "", //
"mobile": "", //
"reasonID":0, //
"reasonRemark": "", //
"TicketNo": "", //酒店房间编号
}], //旅客信息
"payType":0, //付款方式
"nightCount":0, //预订晚数
"roomCount":0, //预订间数
"rooms":0, //预订间晚数
"firstArriveTime": "", //最早到店时间
"lastArriveTime": "", //最晚到店时间
"currency": "", //货币类型
"amount":0, //订单总价
"stRemark": "", //给美亚的备注
"submitName": "", //客户制单人
"submitTime": "", //制单时间
"canCancel":false, //当前是否可取消
"contactInfo":
[{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}], //联系人信息
"CreditCardNo": "", //信用卡卡号
"holderName": "", //信用卡持卡人
"priceList":
[{
"sellDate": "", //日期,格式:yyyy-MM-dd
"price":0, //每日售价
"priceRebate":0, //收入返现,(每间夜价格) 正数
"priceServiceAmount":0, //服务费
}], //每日价格明细
"garanteeRule": "", //担保规则
"payRule": "", //预付规则
"costList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心信息
"serviceFee":0, //服务费
"rebateFee":0, //返现
"priceService":0, //实际服务费
"priceRebate":0, //实际返现
"auditInfoList":
[{
"actName": "", //环节
"opName": "", //操作人
"opResult": "", //处理结果
"opTime": "", //操作时间
"remark": "", //备注
}], //订单审批信息
}], //订单列表信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
OrderNo | 美亚订购单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"OrderNo": "", //美亚订购单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
orderInfo | 酒店订单基本信息 | HBOrderInfo | ||
orderNo | 美亚订单号 | String | orderInfo | |
outsideOrderNo | 外部订单号 | String | orderInfo | |
hotelCode | 酒店编号 | String | orderInfo | |
hotelName | 酒店名称 | String | orderInfo | |
roomCode | 房型编号 | String | orderInfo | |
roomName | 房型名称 | String | orderInfo | |
city | 城市 | String | orderInfo | |
checkInDate | 入住日期 | String | orderInfo | |
checkOutDate | 离店日期 | String | orderInfo | |
orderStatus | 订单状态 : 不限 = 0,暂缓订单 = 1,审批中 = 2, 预订中 = 3,欠款暂停 = 4,已订房 = 5,过期未住 = 6,已成交 = 7,已取消 = 8 | Integer | orderInfo | |
checkInStatus | 入住状态:待入住=0,已入住=10,已离店=20,未同步状态=30 | Integer | orderInfo | |
passengerCount | 旅客人数 | Integer | orderInfo | |
payType | 付款方式 | Integer | orderInfo | |
nightCount | 预订晚数 | Integer | orderInfo | |
roomCount | 预订间数 | Integer | orderInfo | |
rooms | 预订间晚数 | Integer | orderInfo | |
firstArriveTime | 最早到店时间 | String | orderInfo | |
lastArriveTime | 最晚到店时间 | String | orderInfo | |
currency | 货币类型 | String | orderInfo | |
amount | 订单总价 | Number | orderInfo | |
stRemark | 给美亚的备注 | String | orderInfo | |
submitName | 客户制单人 | String | orderInfo | |
submitTime | 制单时间 | String | orderInfo | |
canCancel | 当前是否可取消 | Boolean | orderInfo | |
CreditCardNo | 信用卡卡号 | String | orderInfo | |
holderName | 信用卡持卡人 | String | orderInfo | |
garanteeRule | 担保规则 | String | orderInfo | |
payRule | 预付规则 | String | orderInfo | |
serviceFee | 服务费 | Number | orderInfo | |
rebateFee | 返现 | Number | orderInfo | |
priceService | 实际服务费 | Number | orderInfo | |
priceRebate | 实际返现 | Number | orderInfo | |
costList | 成本中心信息 | Array[] | orderInfo | |
costCenterName | 成本中心名称 | String | orderInfo.costList | |
contactInfo | 联系人信息 | Array[] | orderInfo | |
contactName | 联系人 | String | orderInfo.contactInfo | |
mobile | 手机号码 | String | orderInfo.contactInfo | |
phone | 联系电话 | String | orderInfo.contactInfo | |
电子邮件 | String | orderInfo.contactInfo | ||
priceList | 每日价格明细 | Array[] | orderInfo | |
sellDate | 日期,格式:yyyy-MM-dd | String | orderInfo.priceList | |
price | 每日售价 | Number | orderInfo.priceList | |
priceRebate | 收入返现,(每间夜价格) 正数 | Number | orderInfo.priceList | |
priceServiceAmount | 服务费 | Number | orderInfo.priceList | |
auditInfoList | 订单审批信息 | Array[] | orderInfo | |
actName | 环节 | String | orderInfo.auditInfoList | |
opName | 操作人 | String | orderInfo.auditInfoList | |
opResult | 处理结果 | String | orderInfo.auditInfoList | |
opTime | 操作时间 | String | orderInfo.auditInfoList | |
remark | 备注 | String | orderInfo.auditInfoList | |
passengerList | 旅客信息 | Array[] | orderInfo | |
orderNo | String | orderInfo.passengerList | ||
num | Integer | orderInfo.passengerList | ||
passengerCode | String | orderInfo.passengerList | ||
passengerName | String | orderInfo.passengerList | ||
sex | String | orderInfo.passengerList | ||
nationality | String | orderInfo.passengerList | ||
idType | String | orderInfo.passengerList | ||
idNo | String | orderInfo.passengerList | ||
birthday | String | orderInfo.passengerList | ||
passengerType | String | orderInfo.passengerList | ||
mobile | String | orderInfo.passengerList | ||
reasonID | Integer | orderInfo.passengerList | ||
reasonRemark | String | orderInfo.passengerList | ||
TicketNo | 酒店房间编号 | String | orderInfo.passengerList |
{
"orderInfo":
{
"orderNo": "", //美亚订单号
"outsideOrderNo": "", //外部订单号
"hotelCode": "", //酒店编号
"hotelName": "", //酒店名称
"roomCode": "", //房型编号
"roomName": "", //房型名称
"city": "", //城市
"checkInDate": "", //入住日期
"checkOutDate": "", //离店日期
"orderStatus":0, //订单状态 : 不限 = 0,暂缓订单 = 1,审批中 = 2, 预订中 = 3,欠款暂停 = 4,已订房 = 5,过期未住 = 6,已成交 = 7,已取消 = 8
"checkInStatus":0, //入住状态:待入住=0,已入住=10,已离店=20,未同步状态=30
"passengerCount":0, //旅客人数
"passengerList":
[{
"orderNo": "", //
"num":0, //
"passengerCode": "", //
"passengerName": "", //
"sex": "", //
"nationality": "", //
"idType": "", //
"idNo": "", //
"birthday": "", //
"passengerType": "", //
"mobile": "", //
"reasonID":0, //
"reasonRemark": "", //
"TicketNo": "", //酒店房间编号
}], //旅客信息
"payType":0, //付款方式
"nightCount":0, //预订晚数
"roomCount":0, //预订间数
"rooms":0, //预订间晚数
"firstArriveTime": "", //最早到店时间
"lastArriveTime": "", //最晚到店时间
"currency": "", //货币类型
"amount":0, //订单总价
"stRemark": "", //给美亚的备注
"submitName": "", //客户制单人
"submitTime": "", //制单时间
"canCancel":false, //当前是否可取消
"contactInfo":
[{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}], //联系人信息
"CreditCardNo": "", //信用卡卡号
"holderName": "", //信用卡持卡人
"priceList":
[{
"sellDate": "", //日期,格式:yyyy-MM-dd
"price":0, //每日售价
"priceRebate":0, //收入返现,(每间夜价格) 正数
"priceServiceAmount":0, //服务费
}], //每日价格明细
"garanteeRule": "", //担保规则
"payRule": "", //预付规则
"costList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心信息
"serviceFee":0, //服务费
"rebateFee":0, //返现
"priceService":0, //实际服务费
"priceRebate":0, //实际返现
"auditInfoList":
[{
"actName": "", //环节
"opName": "", //操作人
"opResult": "", //处理结果
"opTime": "", //操作时间
"remark": "", //备注
}], //订单审批信息
}, //酒店订单基本信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订购单号 | String | 否 | |
outsideOrderNo | 外部退房单号 | String | 否 | |
remark | 申退备注 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
returRoomInfoList | 申退房间信息 | Array[] | 否 | |
returnDate | 退房日期 格式:yyyy-MM-dd | String | returRoomInfoList | |
roomCount | 退房数量,当申退项目里有room是必须大于0 | Integer | returRoomInfoList | |
returnPassengerList | 退房旅客ID,兼容外部旅客ID和商旅网旅客ID,必填 | Array[] | returRoomInfoList | |
returnItemList | 申退项目 room,bed,food,必填 | Array[] | returRoomInfoList | |
contactInfo | 联系人信息 | ContactInfo | 否 | |
contactName | 联系人 | String | contactInfo | |
mobile | 手机号码 | String | contactInfo | |
phone | 联系电话 | String | contactInfo | |
电子邮件 | String | contactInfo |
{
"orderNo": "", //美亚订购单号
"outsideOrderNo": "", //外部退房单号
"returRoomInfoList":
[{
"returnDate": "", //退房日期 格式:yyyy-MM-dd
"roomCount":0, //退房数量,当申退项目里有room是必须大于0
"returnPassengerList":[], //退房旅客ID,兼容外部旅客ID和商旅网旅客ID,必填
"returnItemList":[], //申退项目 room,bed,food,必填
}], //申退房间信息
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"remark": "", //申退备注
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 美亚退房单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo": "", //美亚退房单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
OrderNo | 美亚订购单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"OrderNo": "", //美亚订购单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
OrderNo | 美亚退房单号 | String | 否 | |
RebackOrderNo | 美亚订购单号 | String | 否 | |
OutsideOrderNo | 外部退房单号 | String | 否 | |
Status | 退单状态 | Integer | 否 | |
SubmitName | 退单制单人 | String | 否 | |
HotelName | 酒店名称 | String | 否 | |
PassengerName | 退单旅客名称 | String | 否 | |
StartsubmitTime | 退单制单开始时间 | String | 否 | |
EndsubmitTime | 退单制单截止时间 | String | 否 | |
PageIndex | 页码 | Integer | 否 | |
PageCount | 页数 | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"OrderNo": "", //美亚退房单号
"RebackOrderNo": "", //美亚订购单号
"OutsideOrderNo": "", //外部退房单号
"Status":0, //退单状态
"SubmitName": "", //退单制单人
"HotelName": "", //酒店名称
"PassengerName": "", //退单旅客名称
"StartsubmitTime": "", //退单制单开始时间
"EndsubmitTime": "", //退单制单截止时间
"PageIndex":0, //页码
"PageCount":0, //页数
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
Count | 退订单总数 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
HrOrderInfoList | 退订单列表 | Array[] | ||
OrderNo | 美亚退房单号 | String | HrOrderInfoList | |
OutsideOrderNo | 外部退房单号 | String | HrOrderInfoList | |
Status | 退单状态 | Integer | HrOrderInfoList | |
StatusText | 退单状态 | String | HrOrderInfoList | |
Charge | 应扣金额 | Number | HrOrderInfoList | |
ReturnAmount | 应退金额 | Number | HrOrderInfoList | |
Currency | 货币类型 | String | HrOrderInfoList | |
HotelCode | 酒店编码 | String | HrOrderInfoList | |
HotelName | 酒店名称 | String | HrOrderInfoList | |
RoomCode | 房型 | String | HrOrderInfoList | |
OrderTatal | 酒店订购单订单总价 | Number | HrOrderInfoList | |
PayType | 酒店订购单支付方式 | Integer | HrOrderInfoList | |
ItemCode | 退单项目 | Array[] | HrOrderInfoList | |
StartReturnDate | 退房日期 | Array[] | HrOrderInfoList | |
PassengerName | 退单旅客姓名 | String | HrOrderInfoList | |
CompanyName | 客户名称 | String | HrOrderInfoList | |
Remark | 退房备注 | String | HrOrderInfoList | |
RebackOrderNo | 酒店订购单号 | String | HrOrderInfoList | |
SubmitTime | 退单制单人时间 | String | HrOrderInfoList | |
SubmitName | 退单制单人 | String | HrOrderInfoList |
{
"Count":0, //退订单总数
"HrOrderInfoList":
[{
"OrderNo": "", //美亚退房单号
"OutsideOrderNo": "", //外部退房单号
"Status":0, //退单状态
"StatusText": "", //退单状态
"Charge":0, //应扣金额
"ReturnAmount":0, //应退金额
"Currency": "", //货币类型
"HotelCode": "", //酒店编码
"HotelName": "", //酒店名称
"RoomCode": "", //房型
"OrderTatal":0, //酒店订购单订单总价
"PayType":0, //酒店订购单支付方式
"ItemCode":[], //退单项目
"StartReturnDate":[], //退房日期
"PassengerName": "", //退单旅客姓名
"CompanyName": "", //客户名称
"Remark": "", //退房备注
"RebackOrderNo": "", //酒店订购单号
"SubmitTime": "", //退单制单人时间
"SubmitName": "", //退单制单人
}], //退订单列表
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
OrderNo | 美亚订购单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"OrderNo": "", //美亚订购单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
HrOrderInfo | 美亚退房单详情 | HROrderInfo | ||
OrderNo | 美亚退房单号 | String | HrOrderInfo | |
OutsideOrderNo | 外部退房单号 | String | HrOrderInfo | |
Status | 退单状态 | Integer | HrOrderInfo | |
StatusText | 退单状态 | String | HrOrderInfo | |
Charge | 应扣金额 | Number | HrOrderInfo | |
ReturnAmount | 应退金额 | Number | HrOrderInfo | |
Currency | 货币类型 | String | HrOrderInfo | |
HotelCode | 酒店编码 | String | HrOrderInfo | |
HotelName | 酒店名称 | String | HrOrderInfo | |
RoomCode | 房型 | String | HrOrderInfo | |
OrderTatal | 酒店订购单订单总价 | Number | HrOrderInfo | |
PayType | 酒店订购单支付方式 | Integer | HrOrderInfo | |
ItemCode | 退单项目 | Array[] | HrOrderInfo | |
StartReturnDate | 退房日期 | Array[] | HrOrderInfo | |
PassengerName | 退单旅客姓名 | String | HrOrderInfo | |
CompanyName | 客户名称 | String | HrOrderInfo | |
Remark | 退房备注 | String | HrOrderInfo | |
RebackOrderNo | 酒店订购单号 | String | HrOrderInfo | |
SubmitTime | 退单制单人时间 | String | HrOrderInfo | |
SubmitName | 退单制单人 | String | HrOrderInfo |
{
"HrOrderInfo":
{
"OrderNo": "", //美亚退房单号
"OutsideOrderNo": "", //外部退房单号
"Status":0, //退单状态
"StatusText": "", //退单状态
"Charge":0, //应扣金额
"ReturnAmount":0, //应退金额
"Currency": "", //货币类型
"HotelCode": "", //酒店编码
"HotelName": "", //酒店名称
"RoomCode": "", //房型
"OrderTatal":0, //酒店订购单订单总价
"PayType":0, //酒店订购单支付方式
"ItemCode":[], //退单项目
"StartReturnDate":[], //退房日期
"PassengerName": "", //退单旅客姓名
"CompanyName": "", //客户名称
"Remark": "", //退房备注
"RebackOrderNo": "", //酒店订购单号
"SubmitTime": "", //退单制单人时间
"SubmitName": "", //退单制单人
}, //美亚退房单详情
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
cityNameOrCode | 国家(名称模糊,编码精准) | String | 否 | |
countryNameOrCode | 城市(名称模糊,编码精准) | String | 否 | |
pageIndex | 当前页 | Integer | 否 | |
pageSize | 每页记录数 | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"cityNameOrCode": "", //国家(名称模糊,编码精准)
"countryNameOrCode": "", //城市(名称模糊,编码精准)
"pageIndex":0, //当前页
"pageSize":0, //每页记录数
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
totalCount | Integer | |||
totalPage | Integer | |||
pageSize | Integer | |||
pageIndex | Integer | |||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
data | Array[] | |||
countryName | 国家名称 | String | data | |
countryNameEn | String | data | ||
countryCode | String | data | ||
cityName | 城市名称 | String | data | |
cityNameEn | 城市名称 | String | data | |
cityCode | 城市编码 | String | data | |
cityCharCode | 城市三字码 | String | data |
{
"data":
[{
"countryName": "", //国家名称
"countryNameEn": "", //
"countryCode": "", //
"cityName": "", //城市名称
"cityNameEn": "", //城市名称
"cityCode": "", //城市编码
"cityCharCode": "", //城市三字码
}], //
"totalCount":0, //
"totalPage":0, //
"pageSize":0, //
"pageIndex":0, //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
checkInDate | 入住时间(YYYY-mm-DD) | String | 是 | |
checkOutDate | 退房日期(YYYY-mm-DD) | String | 是 | |
cityCode | 城市编码 | String | 否 | |
adultsNum | 入住人数(成人) | Integer | 否 | |
roomNum | *预定房间间数 | Integer | 是 | |
minPrice | 最低价 | String | 否 | |
maxPrice | 最高价 | String | 否 | |
hotelName | 酒店名称 | String | 否 | |
hotelCode | 酒店编码 | String | 否 | |
longitude | 经度 | String | 否 | |
latitude | 纬度 | String | 否 | |
distance | 经纬度辐射范围(单位:公里) | String | 否 | |
paymentType | 付款方式 0:预付;1:到店付 | String | 否 | |
hotelStars | 酒店星级 | Array[] | 否 | |
brandCodes | 品牌编码集合List | Array[] | 否 | |
hotelGroupCode | 酒店集团编码 | String | 否 | |
orderByField | 排序字段 ;支持:price 价格,stars 星级,distance 距离,score 评分 ;距离只有从近到远 | String | 否 | |
orderBy | 排序方式;desc 降序、asc 升序。默认为星级降序 | String | 否 | |
isBreakfast | 是否含有早餐(true 含早餐) | String | 否 | |
pageIndex | 当前页 | Integer | 否 | |
pageSize | 每页记录数 | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"checkInDate": "", //入住时间(YYYY-mm-DD)
"checkOutDate": "", //退房日期(YYYY-mm-DD)
"cityCode": "", //城市编码
"adultsNum":0, //入住人数(成人)
"roomNum":0, //*预定房间间数
"minPrice": "", //最低价
"maxPrice": "", //最高价
"hotelName": "", //酒店名称
"hotelCode": "", //酒店编码
"longitude": "", //经度
"latitude": "", //纬度
"distance": "", //经纬度辐射范围(单位:公里)
"paymentType": "", //付款方式 0:预付;1:到店付
"hotelStars":[], //酒店星级
"brandCodes":[], //品牌编码集合List
"hotelGroupCode": "", //酒店集团编码
"orderByField": "", //排序字段
;支持:price 价格,stars 星级,distance 距离,score 评分
;距离只有从近到远
"orderBy": "", //排序方式;desc 降序、asc 升序。默认为星级降序
"isBreakfast": "", //是否含有早餐(true 含早餐)
"pageIndex":0, //当前页
"pageSize":0, //每页记录数
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
totalCount | Integer | |||
totalPage | Integer | |||
pageSize | Integer | |||
pageIndex | Integer | |||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
data | Array[] | |||
hotelCode | 酒店编码 | String | data | |
hotelName | 酒店名称 | String | data | |
hotelNameEn | 酒店英文名称 | String | data | |
hotelScore | 酒店评分 | String | data | |
brand | 品牌编码 | String | data | |
brandName | 品牌名称 | String | data | |
hotelGrade | 酒店档次编码 | String | data | |
hotelGradeName | 酒店档次名称 | String | data | |
hotelTypeName | 酒店类型(住宿类型)中文名称 | String | data | |
hotelTypeNameEn | 酒店类型(住宿类型)英文名称 | String | data | |
coverPicture | 封面图 | String | data | |
latitude | 维度 | String | data | |
longitude | 经度 | String | data | |
stars | 星级 | String | data | |
inclusive | 房价,总价=单价*间数*天数 | Number | data | |
surchargesInclusive | 到店附加费 | Number | data | |
onlineInclusive | 线上附加费 | Number | data | |
isChineseSelect | 是否中国人优选 (true:是) | Boolean | data | |
openDate | 开业日期($date-time) | String | data | |
isNewOpen | 是否新店开业 (true:是)半年内 | Boolean | data | |
renovationDate | 装修日期($date-time) | String | data | |
isNewRenovation | 是否新装修 (true:是)半年内 | Boolean | data | |
hotelGroup | 酒店集团 | String | data | |
hotelGroupName | 酒店集团名称 | String | data | |
address | 详细地址 | String | data | |
addressEn | 详细地址(英文) | String | data | |
addressLocal | 详细地址(当地语言) | String | data | |
nation | 国家 | String | data | |
nationEn | 国家(英文名) | String | data | |
nationLocal | 国家(本地语言) | String | data | |
nationCode | 国家区域代码 | String | data | |
province | 省/州 | String | data | |
city | 城市 | String | data | |
cityEn | 城市(英文名) | String | data | |
cityLocal | 城市(本地语言) | String | data | |
cityCode | 美亚城市编码 | String | data | |
area | 区域 | String | data | |
areaCode | 地区(区域)编码 | String | data | |
areaEn | 区域/地区(英文) | String | data | |
areaLocal | 区域/地区(本地语言) | String | data | |
hotelType | 酒店类型(住宿类型) | String | data | |
extraInclusiveTotal | 总价(Inclusive+ExtraTotal) | Number | data | |
fcilityList | 设施服务列表 | Array[] | data | |
serviceItemCode | 设施服务项编码 | String | data.fcilityList | |
serviceItem | 设施服务项(名称) | String | data.fcilityList | |
serviceItemEn | 设施服务项(英文名称) | String | data.fcilityList | |
serviceItemIcon | 设施服务项icon | String | data.fcilityList | |
serviceType | 设施服务类型(ihotel_meiya_dictionary.meiya_dictionary_code) | String | data.fcilityList | |
serviceTypeNameCn | 设施服务类型中文名称 | String | data.fcilityList | |
serviceTypeNameEn | 设施服务类型英文名称 | String | data.fcilityList | |
charge | 是否收费:1:不收费 2:收费 | Integer | data.fcilityList | |
chargeDescription | 收费描述 | String | data.fcilityList |
{
"data":
[{
"hotelCode": "", //酒店编码
"hotelName": "", //酒店名称
"hotelNameEn": "", //酒店英文名称
"hotelScore": "", //酒店评分
"brand": "", //品牌编码
"brandName": "", //品牌名称
"hotelGrade": "", //酒店档次编码
"hotelGradeName": "", //酒店档次名称
"hotelTypeName": "", //酒店类型(住宿类型)中文名称
"hotelTypeNameEn": "", //酒店类型(住宿类型)英文名称
"coverPicture": "", //封面图
"latitude": "", //维度
"longitude": "", //经度
"stars": "", //星级
"inclusive":0, //房价,总价=单价*间数*天数
"surchargesInclusive":0, //到店附加费
"onlineInclusive":0, //线上附加费
"isChineseSelect":false, //是否中国人优选 (true:是)
"openDate": "", //开业日期($date-time)
"isNewOpen":false, //是否新店开业 (true:是)半年内
"renovationDate": "", //装修日期($date-time)
"isNewRenovation":false, //是否新装修 (true:是)半年内
"hotelGroup": "", //酒店集团
"hotelGroupName": "", //酒店集团名称
"address": "", //详细地址
"addressEn": "", //详细地址(英文)
"addressLocal": "", //详细地址(当地语言)
"nation": "", //国家
"nationEn": "", //国家(英文名)
"nationLocal": "", //国家(本地语言)
"nationCode": "", //国家区域代码
"province": "", //省/州
"city": "", //城市
"cityEn": "", //城市(英文名)
"cityLocal": "", //城市(本地语言)
"cityCode": "", //美亚城市编码
"area": "", //区域
"areaCode": "", //地区(区域)编码
"areaEn": "", //区域/地区(英文)
"areaLocal": "", //区域/地区(本地语言)
"fcilityList":
[{
"serviceItemCode": "", //设施服务项编码
"serviceItem": "", //设施服务项(名称)
"serviceItemEn": "", //设施服务项(英文名称)
"serviceItemIcon": "", //设施服务项icon
"serviceType": "", //设施服务类型(ihotel_meiya_dictionary.meiya_dictionary_code)
"serviceTypeNameCn": "", //设施服务类型中文名称
"serviceTypeNameEn": "", //设施服务类型英文名称
"charge":0, //是否收费:1:不收费 2:收费
"chargeDescription": "", //收费描述
}], //设施服务列表
"hotelType": "", //酒店类型(住宿类型)
"extraInclusiveTotal":0, //总价(Inclusive+ExtraTotal)
}], //
"totalCount":0, //
"totalPage":0, //
"pageSize":0, //
"pageIndex":0, //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
hotelCode | 酒店编码 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"hotelCode": "", //酒店编码
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
hotelCn | 中文 | ApiIntairHotelDetail | ||
hotelCode | 酒店编码 | String | hotelCn | |
hotelName | 酒店名称 | String | hotelCn | |
hotelNameEn | 酒店英文名称 | String | hotelCn | |
hotelOverview | 酒店概述 | String | hotelCn | |
hotelDetails | 酒店介绍 | String | hotelCn | |
hotelType | 酒店类型(住宿类型) | String | hotelCn | |
hotelTypeName | 酒店类型(住宿类型)中文名称 | String | hotelCn | |
hotelTypeNameEn | 酒店类型(住宿类型)英文名称 | String | hotelCn | |
hotelUrl | 酒店预定地址 | String | hotelCn | |
hotelScore | 美亚酒店评分 | String | hotelCn | |
floorNum | 楼层数 | Integer | hotelCn | |
roomNum | 客房数量 | Integer | hotelCn | |
isChineseSelect | 是否中国人优选 (true:是) | Boolean | hotelCn | |
openDate | 开业日期($date-time) | String | hotelCn | |
isNewOpen | 是否新店开业 (true:是)半年内 | Boolean | hotelCn | |
renovationDate | 装修日期($date-time) | String | hotelCn | |
isNewRenovation | 是否新装修 (true:是)半年内 | Boolean | hotelCn | |
landlineCode | 座机区域码 | String | hotelCn | |
landlineNumber | 座机号 | String | hotelCn | |
phoneNumber | 手机号 | String | hotelCn | |
邮箱 | String | hotelCn | ||
currency | 币种 | String | hotelCn | |
nation | 国家 | String | hotelCn | |
nationLocal | 国家(本地语言) | String | hotelCn | |
nationCode | 国家区域代码 | String | hotelCn | |
province | 省/州 | String | hotelCn | |
city | 城市 | String | hotelCn | |
cityLocal | 城市(本地语言) | String | hotelCn | |
cityCode | 城市编码 | String | hotelCn | |
area | 区域/地区 | String | hotelCn | |
areaLocal | 区域/地区(本地语言) | String | hotelCn | |
areaCode | 地区(区域)编码 | String | hotelCn | |
address | 详细地址 | String | hotelCn | |
addressLocal | 详细地址(当地语言) | String | hotelCn | |
postCode | 邮编 | String | hotelCn | |
latitude | 纬度 | String | hotelCn | |
longitude | 经度 | String | hotelCn | |
mapSoftware | 对应地图软件 | String | hotelCn | |
businessDistrict | 商圈 | String | hotelCn | |
hotelGroup | 酒店集团 | String | hotelCn | |
hotelGroupName | 酒店集团名称 | String | hotelCn | |
brand | 品牌 | String | hotelCn | |
brandName | 品牌名称 | String | hotelCn | |
hotelGrade | 酒店档次 | String | hotelCn | |
hotelGradeName | 酒店档次名称 | String | hotelCn | |
stars | 星级 | String | hotelCn | |
readList | 美亚酒店政策须知 | Array[] | hotelCn | |
readCode | 须知编码 | String | hotelCn.readList | |
title | 标题 | String | hotelCn.readList | |
content | 内容 | String | hotelCn.readList | |
aroundList | 美亚酒店周边 | Array[] | hotelCn | |
poiCode | POI编码 | String | hotelCn.aroundList | |
poiName | POI名称 | String | hotelCn.aroundList | |
poiType | POI类型 | String | hotelCn.aroundList | |
distance | 距离 | String | hotelCn.aroundList | |
unit | 单位 | String | hotelCn.aroundList | |
picList | 美亚酒店照片 | Array[] | hotelCn | |
roomCode | 房间编号 | String | hotelCn.picList | |
compressedPic | 缩略图 | String | hotelCn.picList | |
isCoverImg | 是否为封面图:1否 2是 | Integer | hotelCn.picList | |
losslessPic | 完整图 | String | hotelCn.picList | |
picType | 0:封面图;1:外观 2:客房 3:餐饮 4:设施 5:周边 -1:其它 | Integer | hotelCn.picList | |
type | 图片分类 | String | hotelCn.picList | |
bedList | 美亚酒店儿童床 | Array[] | hotelCn | |
number | 序号 | Integer | hotelCn.bedList | |
addBedType | 加床类型,0:使用现有床铺,1:加婴儿床,2:加床,3:未知 | Integer | hotelCn.bedList | |
ageType | 年龄类型:1 婴儿;2 儿童;3 成人 | Integer | hotelCn.bedList | |
charge | 是否收费:1不收费 2收费 | Integer | hotelCn.bedList | |
chargeDescription | 收费说明 | String | hotelCn.bedList | |
maxAge | 最大年龄 | Integer | hotelCn.bedList | |
minAge | 最小年龄 | Integer | hotelCn.bedList | |
facilityList | 美亚酒店设施 | Array[] | hotelCn | |
serviceItemCode | 设施服务项编码 | String | hotelCn.facilityList | |
serviceItemIcon | 设施服务项icon | String | hotelCn.facilityList | |
serviceItem | 设施服务项(名称) | String | hotelCn.facilityList | |
serviceItemEn | 设施服务项(名称) | String | hotelCn.facilityList | |
serviceType | 设施服务类型(ihotel_meiya_dictionary.meiya_dictionary_code) | String | hotelCn.facilityList | |
serviceTypeNameCn | 设施服务类型中文名称 | String | hotelCn.facilityList | |
serviceTypeNameEn | 设施服务类型英文名称 | String | hotelCn.facilityList | |
charge | 是否收费:1:不收费 2:收费 | Integer | hotelCn.facilityList | |
chargeDescription | 收费描述 | String | hotelCn.facilityList | |
policy | 美亚酒店政策 | ApiIntairHotelDetailPolicy | hotelCn | |
paymentType | 付款方式 () | Array[] | hotelCn.policy | |
breakfast | 是否有早餐:1没有 2有 3未知 | Integer | hotelCn.policy | |
breakfastBusinessHours | 早餐营业时间 | String | hotelCn.policy | |
breakfastDescribe | 早餐收费描述 | String | hotelCn.policy | |
breakfastType | 早餐菜单类型1:自助餐;2:中餐;3:西餐;4:未知 | Integer | hotelCn.policy | |
checkInTime | 入住时间 | String | hotelCn.policy | |
checkOutTime | 退房时间 | String | hotelCn.policy | |
childAddBedDescribe | 儿童及加床其他说明 | String | hotelCn.policy | |
childAddBedPolicy | 儿童及加床政策内容 | String | hotelCn.policy | |
parkingLot | 停车场:1没有 2有 | Integer | hotelCn.policy | |
parkingLotCharge | 停车收费:1不收费 2收费 | Integer | hotelCn.policy | |
parkingLotChargeDescribe | 停车收费说明 | String | hotelCn.policy | |
petsAllow | 是否可以带宠物:1不可以 2可以 | Integer | hotelCn.policy | |
petsCharge | 带宠物是否收费:1不收费 2收费 | Integer | hotelCn.policy | |
petsChargeDescribe | 宠物收费描述 | String | hotelCn.policy | |
hotelEn | 英文 | ApiIntairHotelDetail | ||
hotelCode | 酒店编码 | String | hotelEn | |
hotelName | 酒店名称 | String | hotelEn | |
hotelNameEn | 酒店英文名称 | String | hotelEn | |
hotelOverview | 酒店概述 | String | hotelEn | |
hotelDetails | 酒店介绍 | String | hotelEn | |
hotelType | 酒店类型(住宿类型) | String | hotelEn | |
hotelTypeName | 酒店类型(住宿类型)中文名称 | String | hotelEn | |
hotelTypeNameEn | 酒店类型(住宿类型)英文名称 | String | hotelEn | |
hotelUrl | 酒店预定地址 | String | hotelEn | |
hotelScore | 美亚酒店评分 | String | hotelEn | |
floorNum | 楼层数 | Integer | hotelEn | |
roomNum | 客房数量 | Integer | hotelEn | |
isChineseSelect | 是否中国人优选 (true:是) | Boolean | hotelEn | |
openDate | 开业日期($date-time) | String | hotelEn | |
isNewOpen | 是否新店开业 (true:是)半年内 | Boolean | hotelEn | |
renovationDate | 装修日期($date-time) | String | hotelEn | |
isNewRenovation | 是否新装修 (true:是)半年内 | Boolean | hotelEn | |
landlineCode | 座机区域码 | String | hotelEn | |
landlineNumber | 座机号 | String | hotelEn | |
phoneNumber | 手机号 | String | hotelEn | |
邮箱 | String | hotelEn | ||
currency | 币种 | String | hotelEn | |
nation | 国家 | String | hotelEn | |
nationLocal | 国家(本地语言) | String | hotelEn | |
nationCode | 国家区域代码 | String | hotelEn | |
province | 省/州 | String | hotelEn | |
city | 城市 | String | hotelEn | |
cityLocal | 城市(本地语言) | String | hotelEn | |
cityCode | 城市编码 | String | hotelEn | |
area | 区域/地区 | String | hotelEn | |
areaLocal | 区域/地区(本地语言) | String | hotelEn | |
areaCode | 地区(区域)编码 | String | hotelEn | |
address | 详细地址 | String | hotelEn | |
addressLocal | 详细地址(当地语言) | String | hotelEn | |
postCode | 邮编 | String | hotelEn | |
latitude | 纬度 | String | hotelEn | |
longitude | 经度 | String | hotelEn | |
mapSoftware | 对应地图软件 | String | hotelEn | |
businessDistrict | 商圈 | String | hotelEn | |
hotelGroup | 酒店集团 | String | hotelEn | |
hotelGroupName | 酒店集团名称 | String | hotelEn | |
brand | 品牌 | String | hotelEn | |
brandName | 品牌名称 | String | hotelEn | |
hotelGrade | 酒店档次 | String | hotelEn | |
hotelGradeName | 酒店档次名称 | String | hotelEn | |
stars | 星级 | String | hotelEn | |
readList | 美亚酒店政策须知 | Array[] | hotelEn | |
readCode | 须知编码 | String | hotelEn.readList | |
title | 标题 | String | hotelEn.readList | |
content | 内容 | String | hotelEn.readList | |
aroundList | 美亚酒店周边 | Array[] | hotelEn | |
poiCode | POI编码 | String | hotelEn.aroundList | |
poiName | POI名称 | String | hotelEn.aroundList | |
poiType | POI类型 | String | hotelEn.aroundList | |
distance | 距离 | String | hotelEn.aroundList | |
unit | 单位 | String | hotelEn.aroundList | |
picList | 美亚酒店照片 | Array[] | hotelEn | |
roomCode | 房间编号 | String | hotelEn.picList | |
compressedPic | 缩略图 | String | hotelEn.picList | |
isCoverImg | 是否为封面图:1否 2是 | Integer | hotelEn.picList | |
losslessPic | 完整图 | String | hotelEn.picList | |
picType | 0:封面图;1:外观 2:客房 3:餐饮 4:设施 5:周边 -1:其它 | Integer | hotelEn.picList | |
type | 图片分类 | String | hotelEn.picList | |
bedList | 美亚酒店儿童床 | Array[] | hotelEn | |
number | 序号 | Integer | hotelEn.bedList | |
addBedType | 加床类型,0:使用现有床铺,1:加婴儿床,2:加床,3:未知 | Integer | hotelEn.bedList | |
ageType | 年龄类型:1 婴儿;2 儿童;3 成人 | Integer | hotelEn.bedList | |
charge | 是否收费:1不收费 2收费 | Integer | hotelEn.bedList | |
chargeDescription | 收费说明 | String | hotelEn.bedList | |
maxAge | 最大年龄 | Integer | hotelEn.bedList | |
minAge | 最小年龄 | Integer | hotelEn.bedList | |
facilityList | 美亚酒店设施 | Array[] | hotelEn | |
serviceItemCode | 设施服务项编码 | String | hotelEn.facilityList | |
serviceItemIcon | 设施服务项icon | String | hotelEn.facilityList | |
serviceItem | 设施服务项(名称) | String | hotelEn.facilityList | |
serviceItemEn | 设施服务项(名称) | String | hotelEn.facilityList | |
serviceType | 设施服务类型(ihotel_meiya_dictionary.meiya_dictionary_code) | String | hotelEn.facilityList | |
serviceTypeNameCn | 设施服务类型中文名称 | String | hotelEn.facilityList | |
serviceTypeNameEn | 设施服务类型英文名称 | String | hotelEn.facilityList | |
charge | 是否收费:1:不收费 2:收费 | Integer | hotelEn.facilityList | |
chargeDescription | 收费描述 | String | hotelEn.facilityList | |
policy | 美亚酒店政策 | ApiIntairHotelDetailPolicy | hotelEn | |
paymentType | 付款方式 () | Array[] | hotelEn.policy | |
breakfast | 是否有早餐:1没有 2有 3未知 | Integer | hotelEn.policy | |
breakfastBusinessHours | 早餐营业时间 | String | hotelEn.policy | |
breakfastDescribe | 早餐收费描述 | String | hotelEn.policy | |
breakfastType | 早餐菜单类型1:自助餐;2:中餐;3:西餐;4:未知 | Integer | hotelEn.policy | |
checkInTime | 入住时间 | String | hotelEn.policy | |
checkOutTime | 退房时间 | String | hotelEn.policy | |
childAddBedDescribe | 儿童及加床其他说明 | String | hotelEn.policy | |
childAddBedPolicy | 儿童及加床政策内容 | String | hotelEn.policy | |
parkingLot | 停车场:1没有 2有 | Integer | hotelEn.policy | |
parkingLotCharge | 停车收费:1不收费 2收费 | Integer | hotelEn.policy | |
parkingLotChargeDescribe | 停车收费说明 | String | hotelEn.policy | |
petsAllow | 是否可以带宠物:1不可以 2可以 | Integer | hotelEn.policy | |
petsCharge | 带宠物是否收费:1不收费 2收费 | Integer | hotelEn.policy | |
petsChargeDescribe | 宠物收费描述 | String | hotelEn.policy |
{
"hotelCn":
{
"hotelCode": "", //酒店编码
"hotelName": "", //酒店名称
"hotelNameEn": "", //酒店英文名称
"hotelOverview": "", //酒店概述
"hotelDetails": "", //酒店介绍
"hotelType": "", //酒店类型(住宿类型)
"hotelTypeName": "", //酒店类型(住宿类型)中文名称
"hotelTypeNameEn": "", //酒店类型(住宿类型)英文名称
"hotelUrl": "", //酒店预定地址
"hotelScore": "", //美亚酒店评分
"floorNum":0, //楼层数
"roomNum":0, //客房数量
"isChineseSelect":false, //是否中国人优选 (true:是)
"openDate": "", //开业日期($date-time)
"isNewOpen":false, //是否新店开业 (true:是)半年内
"renovationDate": "", //装修日期($date-time)
"isNewRenovation":false, //是否新装修 (true:是)半年内
"landlineCode": "", //座机区域码
"landlineNumber": "", //座机号
"phoneNumber": "", //手机号
"email": "", //邮箱
"currency": "", //币种
"nation": "", //国家
"nationLocal": "", //国家(本地语言)
"nationCode": "", //国家区域代码
"province": "", //省/州
"city": "", //城市
"cityLocal": "", //城市(本地语言)
"cityCode": "", //城市编码
"area": "", //区域/地区
"areaLocal": "", //区域/地区(本地语言)
"areaCode": "", //地区(区域)编码
"address": "", //详细地址
"addressLocal": "", //详细地址(当地语言)
"postCode": "", //邮编
"latitude": "", //纬度
"longitude": "", //经度
"mapSoftware": "", //对应地图软件
"businessDistrict": "", //商圈
"hotelGroup": "", //酒店集团
"hotelGroupName": "", //酒店集团名称
"brand": "", //品牌
"brandName": "", //品牌名称
"hotelGrade": "", //酒店档次
"hotelGradeName": "", //酒店档次名称
"stars": "", //星级
"policy":
{
"paymentType":[0], //付款方式 ()
"breakfast":0, //是否有早餐:1没有 2有 3未知
"breakfastBusinessHours": "", //早餐营业时间
"breakfastDescribe": "", //早餐收费描述
"breakfastType":0, //早餐菜单类型1:自助餐;2:中餐;3:西餐;4:未知
"checkInTime": "", //入住时间
"checkOutTime": "", //退房时间
"childAddBedDescribe": "", //儿童及加床其他说明
"childAddBedPolicy": "", //儿童及加床政策内容
"parkingLot":0, //停车场:1没有 2有
"parkingLotCharge":0, //停车收费:1不收费 2收费
"parkingLotChargeDescribe": "", //停车收费说明
"petsAllow":0, //是否可以带宠物:1不可以 2可以
"petsCharge":0, //带宠物是否收费:1不收费 2收费
"petsChargeDescribe": "", //宠物收费描述
}, //美亚酒店政策
"readList":
[{
"readCode": "", //须知编码
"title": "", //标题
"content": "", //内容
}], //美亚酒店政策须知
"picList":
[{
"roomCode": "", //房间编号
"compressedPic": "", //缩略图
"isCoverImg":0, //是否为封面图:1否 2是
"losslessPic": "", //完整图
"picType":0, //0:封面图;1:外观 2:客房 3:餐饮 4:设施 5:周边 -1:其它
"type": "", //图片分类
}], //美亚酒店照片
"facilityList":
[{
"serviceItemCode": "", //设施服务项编码
"serviceItemIcon": "", //设施服务项icon
"serviceItem": "", //设施服务项(名称)
"serviceItemEn": "", //设施服务项(名称)
"serviceType": "", //设施服务类型(ihotel_meiya_dictionary.meiya_dictionary_code)
"serviceTypeNameCn": "", //设施服务类型中文名称
"serviceTypeNameEn": "", //设施服务类型英文名称
"charge":0, //是否收费:1:不收费 2:收费
"chargeDescription": "", //收费描述
}], //美亚酒店设施
"aroundList":
[{
"poiCode": "", //POI编码
"poiName": "", //POI名称
"poiType": "", //POI类型
"distance": "", //距离
"unit": "", //单位
}], //美亚酒店周边
"bedList":
[{
"number":0, //序号
"addBedType":0, //加床类型,0:使用现有床铺,1:加婴儿床,2:加床,3:未知
"ageType":0, //年龄类型:1 婴儿;2 儿童;3 成人
"charge":0, //是否收费:1不收费 2收费
"chargeDescription": "", //收费说明
"maxAge":0, //最大年龄
"minAge":0, //最小年龄
}], //美亚酒店儿童床
}, //中文
"hotelEn":
{
"hotelCode": "", //酒店编码
"hotelName": "", //酒店名称
"hotelNameEn": "", //酒店英文名称
"hotelOverview": "", //酒店概述
"hotelDetails": "", //酒店介绍
"hotelType": "", //酒店类型(住宿类型)
"hotelTypeName": "", //酒店类型(住宿类型)中文名称
"hotelTypeNameEn": "", //酒店类型(住宿类型)英文名称
"hotelUrl": "", //酒店预定地址
"hotelScore": "", //美亚酒店评分
"floorNum":0, //楼层数
"roomNum":0, //客房数量
"isChineseSelect":false, //是否中国人优选 (true:是)
"openDate": "", //开业日期($date-time)
"isNewOpen":false, //是否新店开业 (true:是)半年内
"renovationDate": "", //装修日期($date-time)
"isNewRenovation":false, //是否新装修 (true:是)半年内
"landlineCode": "", //座机区域码
"landlineNumber": "", //座机号
"phoneNumber": "", //手机号
"email": "", //邮箱
"currency": "", //币种
"nation": "", //国家
"nationLocal": "", //国家(本地语言)
"nationCode": "", //国家区域代码
"province": "", //省/州
"city": "", //城市
"cityLocal": "", //城市(本地语言)
"cityCode": "", //城市编码
"area": "", //区域/地区
"areaLocal": "", //区域/地区(本地语言)
"areaCode": "", //地区(区域)编码
"address": "", //详细地址
"addressLocal": "", //详细地址(当地语言)
"postCode": "", //邮编
"latitude": "", //纬度
"longitude": "", //经度
"mapSoftware": "", //对应地图软件
"businessDistrict": "", //商圈
"hotelGroup": "", //酒店集团
"hotelGroupName": "", //酒店集团名称
"brand": "", //品牌
"brandName": "", //品牌名称
"hotelGrade": "", //酒店档次
"hotelGradeName": "", //酒店档次名称
"stars": "", //星级
"policy":
{
"paymentType":[0], //付款方式 ()
"breakfast":0, //是否有早餐:1没有 2有 3未知
"breakfastBusinessHours": "", //早餐营业时间
"breakfastDescribe": "", //早餐收费描述
"breakfastType":0, //早餐菜单类型1:自助餐;2:中餐;3:西餐;4:未知
"checkInTime": "", //入住时间
"checkOutTime": "", //退房时间
"childAddBedDescribe": "", //儿童及加床其他说明
"childAddBedPolicy": "", //儿童及加床政策内容
"parkingLot":0, //停车场:1没有 2有
"parkingLotCharge":0, //停车收费:1不收费 2收费
"parkingLotChargeDescribe": "", //停车收费说明
"petsAllow":0, //是否可以带宠物:1不可以 2可以
"petsCharge":0, //带宠物是否收费:1不收费 2收费
"petsChargeDescribe": "", //宠物收费描述
}, //美亚酒店政策
"readList":
[{
"readCode": "", //须知编码
"title": "", //标题
"content": "", //内容
}], //美亚酒店政策须知
"picList":
[{
"roomCode": "", //房间编号
"compressedPic": "", //缩略图
"isCoverImg":0, //是否为封面图:1否 2是
"losslessPic": "", //完整图
"picType":0, //0:封面图;1:外观 2:客房 3:餐饮 4:设施 5:周边 -1:其它
"type": "", //图片分类
}], //美亚酒店照片
"facilityList":
[{
"serviceItemCode": "", //设施服务项编码
"serviceItemIcon": "", //设施服务项icon
"serviceItem": "", //设施服务项(名称)
"serviceItemEn": "", //设施服务项(名称)
"serviceType": "", //设施服务类型(ihotel_meiya_dictionary.meiya_dictionary_code)
"serviceTypeNameCn": "", //设施服务类型中文名称
"serviceTypeNameEn": "", //设施服务类型英文名称
"charge":0, //是否收费:1:不收费 2:收费
"chargeDescription": "", //收费描述
}], //美亚酒店设施
"aroundList":
[{
"poiCode": "", //POI编码
"poiName": "", //POI名称
"poiType": "", //POI类型
"distance": "", //距离
"unit": "", //单位
}], //美亚酒店周边
"bedList":
[{
"number":0, //序号
"addBedType":0, //加床类型,0:使用现有床铺,1:加婴儿床,2:加床,3:未知
"ageType":0, //年龄类型:1 婴儿;2 儿童;3 成人
"charge":0, //是否收费:1不收费 2收费
"chargeDescription": "", //收费说明
"maxAge":0, //最大年龄
"minAge":0, //最小年龄
}], //美亚酒店儿童床
}, //英文
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
priceType | 是否协议价(1协议价,2预付价) 默认:2 | Integer | 否 | |
privateType | 出差性质(0因公,1因私) 默认:0 | Integer | 否 | |
hotelCode | *美亚酒店编号 | String | 是 | |
checkInDate | *入住时间(YYYY-MM-DD) | String | 是 | |
checkOutDate | *退房日期(YYYY-MM-DD) | String | 是 | |
roomNum | *预定房间间数 | Integer | 是 | |
adultsNum | *成人人数 | Integer | 是 | |
minPrice | 最低价 0 不限 | Number | 否 | |
maxPrice | 最高价 0 不限 | Number | 否 | |
breakfastType | 早餐类型:1不含早、2含早、3单份早、4双份早(BreakfastTypeEnum) | Integer | 否 | |
paymentModel | 支付方式:预付 online,到店付 offline 默认 全部 | String | 否 | |
nationality | 国籍 国家二字码,如CN | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"priceType":0, //是否协议价(1协议价,2预付价)
默认:2
"privateType":0, //出差性质(0因公,1因私)
默认:0
"hotelCode": "", //*美亚酒店编号
"checkInDate": "", //*入住时间(YYYY-MM-DD)
"checkOutDate": "", //*退房日期(YYYY-MM-DD)
"roomNum":0, //*预定房间间数
"adultsNum":0, //*成人人数
"minPrice":0, //最低价 0 不限
"maxPrice":0, //最高价 0 不限
"breakfastType":0, //早餐类型:1不含早、2含早、3单份早、4双份早(BreakfastTypeEnum)
"paymentModel": "", //支付方式:预付 online,到店付 offline
默认 全部
"nationality": "", //国籍 国家二字码,如CN
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
prices | Array[] | |||
cacheId | 缓存Id | String | prices | |
checkInDate | 入住时间(YYYY-MM-DD) | String | prices | |
checkOutDate | 退房日期(YYYY-MM-DD) | String | prices | |
roomNum | 预订房间数 | Integer | prices | |
adultsNum | 入住成年人数 | Integer | prices | |
hotelCode | 酒店编码 | String | prices | |
roomCode | 美亚房型编号 | String | prices | |
roomName | 美亚房型名称 | String | prices | |
roomNameEn | 房型英文名称 | String | prices | |
roomTypeDescription | 房型介绍 | String | prices | |
roomNumber | 美亚房间数 | Integer | prices | |
maxAddBedNumber | 最大加床数(参考值) | Integer | prices | |
maxBabyNumber | 最大婴儿数 | Integer | prices | |
maxGuestNumber | 最大入住人数(参考值) | Integer | prices | |
bedType | 床型 | String | prices | |
bedTypeName | 床型名称 | String | prices | |
bedTypeNameEn | 床型名称 英文 | String | prices | |
bedTypeDescription | 床型说明 | String | prices | |
storey | 所在楼层 | Integer | prices | |
area | 面积 | String | prices | |
balcony | 是否带阳台 | Boolean | prices | |
windowType | 窗户类型 | String | prices | |
windowTypeName | 窗户类型名称 | String | prices | |
windowTypeNameEn | 窗户类型名称 英文 | String | prices | |
windowDescription | 窗户说明 | String | prices | |
toilet | 可否公共卫生间 | Boolean | prices | |
enableSmoking | 可否吸烟:true 可吸烟 | Boolean | prices | |
provideWifi | 提供wifi | Boolean | prices | |
importantInformation | 重要信息 | String | prices | |
picList | 美亚酒店房型照片 | Array[] | prices | |
picCode | 图片编码 | String | prices.picList | |
compressedPic | 缩略图地址 | String | prices.picList | |
losslessPic | 大图地址 | String | prices.picList | |
isCoverImg | 是否为封面图:1否 2是 | Integer | prices.picList | |
picType | 0:封面图;1:外观 2:客房 3:餐饮 4:设施 5:周边 -1:其它 | Integer | prices.picList | |
type | 图片类型昵称 | String | prices.picList | |
roomFacilityList | 美亚酒店房型设施 | Array[] | prices | |
charge | 是否收费:1:不收费 2:收费 | Integer | prices.roomFacilityList | |
chargeDescription | 收费描述 | String | prices.roomFacilityList | |
serviceItem | 设施服务项中文名称 | String | prices.roomFacilityList | |
serviceItemCode | 设施服务项编码 | String | prices.roomFacilityList | |
serviceItemEn | 设施服务项英文名称 | String | prices.roomFacilityList | |
serviceItemIcon | 设施服务项icon | String | prices.roomFacilityList | |
serviceType | 设施服务类型(字典) | String | prices.roomFacilityList | |
serviceTypeNameCn | 设施服务类型中文名称 | String | prices.roomFacilityList | |
serviceTypeNameEn | 设施服务类型英文名称 | String | prices.roomFacilityList | |
priceList | 房型价格信息 | Array[] | prices | |
blockId | 价格编号 | String | prices.priceList | |
remainingRooms | 剩余房量(字符串,为空时表示充足) | String | prices.priceList | |
freeCancellation | true:限时取消 false:不可取消 | Boolean | prices.priceList | |
freeCancellationDate | 免费取消日期 | String | prices.priceList | |
extraBeds | 最大加床数(实际值) | Integer | prices.priceList | |
normalBedding | 最大入住人数(实际值) | Integer | prices.priceList | |
freeBreakfast | true:含有早餐 false:不含早餐 | Boolean | prices.priceList | |
breakfastNum | 早餐份数 | Integer | prices.priceList | |
freeWifi | 免费wifi | Boolean | prices.priceList | |
immediateConfirm | 是否立即确认 | Boolean | prices.priceList | |
paymentModel | 支付方式,预付 online,到店付 offline | String | prices.priceList | |
currency | 货币 | String | prices.priceList | |
totalFrontCharges | 线下附加费总金额 | Number | prices.priceList | |
totalOnlineChargesCeiling | 线上附加费总金额,向上取整(取 OnlineSurcharges.InclusiveCeiling 的合计) | Number | prices.priceList | |
totalVatCeiling | 总增值税,向上取整 | Number | prices.priceList | |
extraInclusiveTotal | 总房费(DailyRate的的 ExtraInclusivePer x 间数 x 天数 的合计) | Number | prices.priceList | |
extraInclusiveAverage | 向上取整(ExtraInclusiveTotal / 天数 / 间数) | Number | prices.priceList | |
cancelPolicyType | 取消政策类型(免费取消/不可取消) | String | prices.priceList | |
stFee | 商旅服务费 | ApiIntairHotelRoomFee | prices.priceList | |
fee | 总服务费,向上取整 | Number | prices.priceList.stFee | |
onlineSurcharges | 酒店线上付款明细信息 | Array[] | prices.priceList | |
name | 额外费用名称 | String | prices.priceList.onlineSurcharges | |
inclusiveCeiling | 总费用(向上取整 Ceiling(Inclusive) ) | Number | prices.priceList.onlineSurcharges | |
surcharges | 酒店前台额外收款明细信息 | Array[] | prices.priceList | |
name | 额外费用名称 | String | prices.priceList.surcharges | |
inclusiveCeiling | 总费用(向上取整 Ceiling(Inclusive) ) | Number | prices.priceList.surcharges | |
dailyRate | 每日价格信息 | Array[] | prices.priceList | |
date | 日期 | String | prices.priceList.dailyRate | |
extraInclusivePer | 单价 | Number | prices.priceList.dailyRate | |
benefits | 免费服务项 | Array[] | prices.priceList | |
id | Integer | prices.priceList.benefits | ||
benefitName | 福利名称 | String | prices.priceList.benefits | |
translatedBenefitName | 翻译福利名称 | String | prices.priceList.benefits |
{
"prices":
[{
"cacheId": "", //缓存Id
"checkInDate": "", //入住时间(YYYY-MM-DD)
"checkOutDate": "", //退房日期(YYYY-MM-DD)
"roomNum":0, //预订房间数
"adultsNum":0, //入住成年人数
"hotelCode": "", //酒店编码
"roomCode": "", //美亚房型编号
"roomName": "", //美亚房型名称
"roomNameEn": "", //房型英文名称
"roomTypeDescription": "", //房型介绍
"roomNumber":0, //美亚房间数
"maxAddBedNumber":0, //最大加床数(参考值)
"maxBabyNumber":0, //最大婴儿数
"maxGuestNumber":0, //最大入住人数(参考值)
"bedType": "", //床型
"bedTypeName": "", //床型名称
"bedTypeNameEn": "", //床型名称 英文
"bedTypeDescription": "", //床型说明
"storey":0, //所在楼层
"area": "", //面积
"balcony":false, //是否带阳台
"windowType": "", //窗户类型
"windowTypeName": "", //窗户类型名称
"windowTypeNameEn": "", //窗户类型名称 英文
"windowDescription": "", //窗户说明
"toilet":false, //可否公共卫生间
"enableSmoking":false, //可否吸烟:true 可吸烟
"provideWifi":false, //提供wifi
"importantInformation": "", //重要信息
"picList":
[{
"picCode": "", //图片编码
"compressedPic": "", //缩略图地址
"losslessPic": "", //大图地址
"isCoverImg":0, //是否为封面图:1否 2是
"picType":0, //0:封面图;1:外观 2:客房 3:餐饮 4:设施 5:周边 -1:其它
"type": "", //图片类型昵称
}], //美亚酒店房型照片
"roomFacilityList":
[{
"charge":0, //是否收费:1:不收费 2:收费
"chargeDescription": "", //收费描述
"serviceItem": "", //设施服务项中文名称
"serviceItemCode": "", //设施服务项编码
"serviceItemEn": "", //设施服务项英文名称
"serviceItemIcon": "", //设施服务项icon
"serviceType": "", //设施服务类型(字典)
"serviceTypeNameCn": "", //设施服务类型中文名称
"serviceTypeNameEn": "", //设施服务类型英文名称
}], //美亚酒店房型设施
"priceList":
[{
"blockId": "", //价格编号
"remainingRooms": "", //剩余房量(字符串,为空时表示充足)
"freeCancellation":false, //true:限时取消 false:不可取消
"freeCancellationDate": "", //免费取消日期
"extraBeds":0, //最大加床数(实际值)
"normalBedding":0, //最大入住人数(实际值)
"freeBreakfast":false, //true:含有早餐 false:不含早餐
"breakfastNum":0, //早餐份数
"freeWifi":false, //免费wifi
"immediateConfirm":false, //是否立即确认
"benefits":
[{
"id":0, //
"benefitName": "", //福利名称
"translatedBenefitName": "", //翻译福利名称
}], //免费服务项
"onlineSurcharges":
[{
"name": "", //额外费用名称
"inclusiveCeiling":0, //总费用(向上取整 Ceiling(Inclusive) )
}], //酒店线上付款明细信息
"surcharges":
[{
"name": "", //额外费用名称
"inclusiveCeiling":0, //总费用(向上取整 Ceiling(Inclusive) )
}], //酒店前台额外收款明细信息
"dailyRate":
[{
"date": "", //日期
"extraInclusivePer":0, //单价
}], //每日价格信息
"paymentModel": "", //支付方式,预付 online,到店付 offline
"currency": "", //货币
"totalFrontCharges":0, //线下附加费总金额
"totalOnlineChargesCeiling":0, //线上附加费总金额,向上取整(取 OnlineSurcharges.InclusiveCeiling 的合计)
"totalVatCeiling":0, //总增值税,向上取整
"extraInclusiveTotal":0, //总房费(DailyRate的的 ExtraInclusivePer x 间数 x 天数 的合计)
"extraInclusiveAverage":0, //向上取整(ExtraInclusiveTotal / 天数 / 间数)
"cancelPolicyType": "", //取消政策类型(免费取消/不可取消)
"stFee":
{
"fee":0, //总服务费,向上取整
}, //商旅服务费
}], //房型价格信息
}], //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
hotelCode | 美亚酒店编号 | String | 是 | |
roomCode | 美亚房型编号 | String | 是 | |
blockId | 价格编号(房型价格信息返回) | String | 是 | |
checkInDate | 入住时间(YYYY-MM-DD) | String | 是 | |
checkOutDate | 退房日期(YYYY-MM-DD) | String | 是 | |
roomNum | 预定房间间数 | Integer | 是 | |
adultsNum | 成人人数 | Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
roomDailyRate | 每日价格 | Array[] | 是 | |
date | 日期 | String | roomDailyRate | |
extraInclusivePer | 单价 | Number | roomDailyRate |
{
"hotelCode": "", //美亚酒店编号
"roomCode": "", //美亚房型编号
"blockId": "", //价格编号(房型价格信息返回)
"checkInDate": "", //入住时间(YYYY-MM-DD)
"checkOutDate": "", //退房日期(YYYY-MM-DD)
"roomNum":0, //预定房间间数
"adultsNum":0, //成人人数
"roomDailyRate":
[{
"date": "", //日期
"extraInclusivePer":0, //单价
}], //每日价格
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
status | 200:预订检查成功,501:触发变价流程,-1:停售,-2:其他/网络或技术错误 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"status":0, //200:预订检查成功,501:触发变价流程,-1:停售,-2:其他/网络或技术错误
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
sessionId | sessionId,login接口返回 | String | 是 | |
baseInfo | 基础信息 | ApiIntairHotelOrderInfo | 是 | |
oaSerialnumber | 出差申请单号 | String | baseInfo | |
isAutoSubmit | 创建订单类型 false=订单保存 true=订单保存并提交 | Boolean | baseInfo | |
clientRemark | 客户备注 | String | baseInfo | |
specialRequirements | 特殊要求 | String | baseInfo | |
contactInfo | 联系人信息 | ContactInfo | 是 | |
contactName | 联系人 | String | contactInfo | |
mobile | 手机号码 | String | contactInfo | |
phone | 联系电话 | String | contactInfo | |
电子邮件 | String | contactInfo | ||
hotelInfo | 酒店信息 | ApiIntairHotelHotelInfo | 是 | |
hotelCode | 酒店编码 | String | hotelInfo | |
roomCode | 美亚房型编号 | String | hotelInfo | |
blockId | 价格编号(房型价格信息返回) | String | hotelInfo | |
checkInDate | 入住日期(格式:yyyy-MM-dd,必填) | String | hotelInfo | |
checkOutDate | 离店日期(格式:yyyy-MM-dd,必填) | String | hotelInfo | |
roomNum | 预定房间间数 | Integer | hotelInfo | |
roomDailyRate | 每日价格 | Array[] | hotelInfo | |
date | 日期 | String | hotelInfo.roomDailyRate | |
extraInclusivePer | 单价 | Number | hotelInfo.roomDailyRate | |
passengerList | 旅客信息 | Array[] | 是 | |
outsidePassengerId | 对接方系统的旅客编号 | String | passengerList | |
passengerName | 乘机人姓名 | String | passengerList | |
passengerType | 旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿) | String | passengerList | |
companyId | 公司编号 | String | passengerList | |
sex | 必传 性别:男/女;不能传其他字符 | String | passengerList | |
cnName | 中文姓名(中文姓名、英文姓名2选一) | String | passengerList | |
enName | 英文姓名(中文姓名、英文姓名2选一,格式:zhang/san) | String | passengerList | |
dName | 部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | passengerList | |
nationality | 国籍:中国填写 CN,必传 | String | passengerList | |
birthday | 出生日期(yyyy-MM-dd)必传 | String | passengerList | |
mobile | 手机号码 | String | passengerList | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | passengerList | |
电子邮箱 | String | passengerList | ||
phone | 固定电话 | String | passengerList | |
staffId | 员工工号 | String | passengerList | |
CostList | 成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可 | Array[] | passengerList | |
costCenterName | 成本中心名称 | String | passengerList.CostList | |
certificatePhoto | 证件图片信息(只有国际机票使用,其他产品传null 或者不处理) | CertificatePhoto | passengerList | |
fileName | 文件名称 | String | passengerList.certificatePhoto | |
fileCode | 文件流 | String | passengerList.certificatePhoto | |
frequentTraveller | 常旅卡信息 | FrequentTraveller | passengerList | |
airlineCode | 航司二字码 | String | passengerList.frequentTraveller | |
cardName | 常旅卡名称 | String | passengerList.frequentTraveller | |
cardNumber | 常旅卡号 | String | passengerList.frequentTraveller | |
certificatesList | 证件 | Array[] | passengerList | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | passengerList.certificatesList | |
certNumber | 证件号码 | String | passengerList.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | passengerList.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | passengerList.certificatesList |
{
"baseInfo":
{
"oaSerialnumber": "", //出差申请单号
"isAutoSubmit":false, //创建订单类型
false=订单保存
true=订单保存并提交
"clientRemark": "", //客户备注
"specialRequirements": "", //特殊要求
}, //基础信息
"passengerList":
[{
"outsidePassengerId":"ak10002", //对接方系统的旅客编号
"passengerName":"刘展超", //乘机人姓名
"passengerType":"成人", //旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿)
"companyId":"S118022", //公司编号
"sex":"男", //必传 性别:男/女;不能传其他字符
"cnName":"刘展超", //中文姓名(中文姓名、英文姓名2选一)
"enName":"liu/zhanchao", //英文姓名(中文姓名、英文姓名2选一,格式:zhang/san)
"dName":"美亚集团/旅游产品部/运营中心", //部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"nationality":"CN", //国籍:中国填写 CN,必传
"birthday":"2000-01-20", //出生日期(yyyy-MM-dd)必传
"mobile":"18628535565", //手机号码
"mobileAreaCode":"556", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"CostList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件
"phone":"020-82862903", //固定电话
"staffId": "", //员工工号
"frequentTraveller":
{
"airlineCode":"MU", //航司二字码
"cardName":"东方明珠积分卡", //常旅卡名称
"cardNumber":"7894587775", //常旅卡号
}, //常旅卡信息
"certificatePhoto":
{
"fileName":"我的证件.jpg", //文件名称
"fileCode":"ADWHIFHWFJJSFJWFJ...", //文件流
}, //证件图片信息(只有国际机票使用,其他产品传null 或者不处理)
}], //旅客信息
"hotelInfo":
{
"hotelCode": "", //酒店编码
"roomCode": "", //美亚房型编号
"blockId": "", //价格编号(房型价格信息返回)
"checkInDate": "", //入住日期(格式:yyyy-MM-dd,必填)
"checkOutDate": "", //离店日期(格式:yyyy-MM-dd,必填)
"roomNum":0, //预定房间间数
"roomDailyRate":
[{
"date": "", //日期
"extraInclusivePer":0, //单价
}], //每日价格
}, //酒店信息
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 订单编号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo": "", //订单编号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单号,单个查则传订单号 | String | 否 | |
originalOrderNo | 美亚原订房单号 | String | 否 | |
orderType | 0 全部 15:订房单;16:退房单 | Integer | 否 | |
payType | 付款方式 | Integer | 否 | |
checkInDate | 入住时间(YYYY-MM-DD) | String | 否 | |
staffCode | 制单人的外部系统编号 | String | 否 | |
opId | 制单人旅客编号 | String | 否 | |
checkOutDate | 退房日期(YYYY-MM-DD) | String | 否 | |
startTime | 制单时间范围(开始) | String | 否 | |
endTime | 制单时间范围(结束) | String | 否 | |
orderStatus |
订单状态
0:全部 40:已处理(订房单已成交,退房单已退房 ) 50:已取消 70:处理中(即排除40,50的订单) |
Integer | 否 | |
hoteName | 酒店名称 | String | 否 | |
pageIndex | 当前页 | Integer | 否 | |
pageSize | 每页记录数 | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo": "", //订单号,单个查则传订单号
"originalOrderNo": "", //美亚原订房单号
"orderType":0, //0 全部 15:订房单;16:退房单
"payType":0, //付款方式
"checkInDate": "", //入住时间(YYYY-MM-DD)
"staffCode": "", //制单人的外部系统编号
"opId": "", //制单人旅客编号
"checkOutDate": "", //退房日期(YYYY-MM-DD)
"startTime": "", //制单时间范围(开始)
"endTime": "", //制单时间范围(结束)
"orderStatus":3, //订单状态
"hoteName": "", //酒店名称
"pageIndex":0, //当前页
"pageSize":0, //每页记录数
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
totalCount | Integer | |||
totalPage | Integer | |||
pageSize | Integer | |||
pageIndex | Integer | |||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
orderList | Array[] | |||
companyId | 公司编号 | String | orderList | |
companyName | 公司名称 | String | orderList | |
orderNo | 美亚订单号 | String | orderList | |
originalOrderNo | 原订单编号 退房单的原单编号,订购单时为空 | String | orderList | |
opDate | 建单时间 | String | orderList | |
opId | 建单人 | String | orderList | |
onBusiness | 订单类型(1:因公;0:因私) | Integer | orderList | |
opStaffCode | 建单人员工工号 | String | orderList | |
opName | 客户制单人 | String | orderList | |
statusText | 订单状态(中文) | String | orderList | |
status |
订单状态
5:待提交 20:待支付 40:已处理 50:已取消 70:处理中 |
Integer | orderList | |
orderType |
订单类型
15:订房单 16:退房单 |
Integer | orderList | |
oaSerialnumber | 出差申请单号 | String | orderList | |
totalPrice | 订单总金额(包含服务费) | Number | orderList | |
totalPriceService | 服务费总额 | Number | orderList | |
hotelCNName | 酒店中文名称 | String | orderList | |
hotelENName | 酒店英文名称 | String | orderList | |
hotelCode | 酒店编码 | String | orderList | |
hotelAddress | 酒店地址 | String | orderList | |
roomTypeName | 房型名称 | String | orderList | |
roomCode | 房型编码,请使用该字段的值,而不是RoomTypeCode | String | orderList | |
cancelDeadline | 最晚取消时间 | String | orderList | |
checkInTime | 入店日期 | String | orderList | |
checkOutTime | 离店日期 | String | orderList | |
realityCheckInTime | 实际入住日期 | String | orderList | |
realityCheckOutTime | 实际离店日期 | String | orderList | |
rooms | 间晚数 | Integer | orderList | |
nightCount | 晚数 | Integer | orderList | |
roomCount | 间数 | Integer | orderList |
{
"orderList":
[{
"companyId": "", //公司编号
"companyName": "", //公司名称
"orderNo": "", //美亚订单号
"originalOrderNo": "", //原订单编号 退房单的原单编号,订购单时为空
"opDate": "", //建单时间
"opId": "", //建单人
"onBusiness":0, //订单类型(1:因公;0:因私)
"opStaffCode": "", //建单人员工工号
"opName": "", //客户制单人
"statusText": "", //订单状态(中文)
"status":5, //订单状态
"orderType":15, //订单类型
"oaSerialnumber": "", //出差申请单号
"totalPrice":0, //订单总金额(包含服务费)
"totalPriceService":0, //服务费总额
"hotelCNName": "", //酒店中文名称
"hotelENName": "", //酒店英文名称
"hotelCode": "", //酒店编码
"hotelAddress": "", //酒店地址
"roomTypeName": "", //房型名称
"roomCode": "", //房型编码,请使用该字段的值,而不是RoomTypeCode
"cancelDeadline": "", //最晚取消时间
"checkInTime": "", //入店日期
"checkOutTime": "", //离店日期
"realityCheckInTime": "", //实际入住日期
"realityCheckOutTime": "", //实际离店日期
"rooms":0, //间晚数
"nightCount":0, //晚数
"roomCount":0, //间数
}], //
"totalCount":0, //
"totalPage":0, //
"pageSize":0, //
"pageIndex":0, //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderType | 订单类型 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
data | 订单信息 | HotelOrderPush | ||
totalServicePrice | 当前订单总服务费 | Number | data | |
StaffPayExcess | 个人承担费用,=true 为存在个人承担,false | Boolean | data | |
PolicyExcessAmount | StaffPayExcess=true 时需要关注,个人承担的金额,否则为 0; | Number | data | |
CompanyExcessAmount | StaffPayExcess=true 时需要关注,公司承担的金额; | Number | data | |
status | 订单状态 | Integer | data | |
deadLineTime | 价格有效期(改签单和退票单时,订单需在价格有效期内提交订单,过了有效期会提交订单失败) | String | data | |
tripId | 行程编号 | String | data | |
companyId | 公司编号 | String | data | |
failureReason | 订单失败原因 | String | data | |
oaOtherInfo | 其他信息,个性化客户需要(比如:中奖码) | String | data | |
firstOrderNo | 美亚原购单号 | String | data | |
orderSource | 订单来源 | Integer | data | |
receivePayType |
支付方式
月结 现结 预存卡 |
String | data | |
affiliateBusinessName | 供应商 | String | data | |
pnr | pnr | String | data | |
c_TextField_2401 | 客户自定义字段1 | String | data | |
c_TextField_2402 | 客户自定义字段2 | String | data | |
c_TextField_2403 | 客户自定义字段3 | String | data | |
c_TextField_2404 | 客户自定义字段4 | String | data | |
c_TextField_2405 | 客户自定义字段5 | String | data | |
c_TextField_2406 | 客户自定义字段6 | String | data | |
c_TextField_2407 | 客户自定义字段7 | String | data | |
c_TextField_2408 | 客户自定义字段8 | String | data | |
totalPrice | 当前订单总金额 | Number | data | |
opId | 制单人旅客编号 | String | data | |
onBusiness | 订单类型(1:因公;0:因私) 注意:如果因私订单不需要的,记得接收时过滤掉 | Integer | data | |
orderRemark | 订单备注 | String | data | |
outsideOrderNo | 客户订单号 | String | data | |
orderNo | 美亚订单号 | String | data | |
originalOrderNo | 美亚原订单号 | String | data | |
opStaffCode | 客户制单人工号 | String | data | |
opName | 客户制单人 | String | data | |
opDate | 下单时间(yyyy-MM-dd HH:mm:ss) | String | data | |
statusText | 订单状态(名称) | String | data | |
issueDate | 出票日期(yyyy-MM-dd HH:mm:ss) | String | data | |
oaSerialnumber | 客户出差申请单号 | String | data | |
stApplyOrderNo | 美亚出差申请单号 | String | data | |
contactInfo | 联系人信息 | OrderPushContactinfo | data | |
contactName | 联系人姓名 | String | data.contactInfo | |
mobile | 手机号 | String | data.contactInfo | |
phone | 固定电话 | String | data.contactInfo | |
邮箱 | String | data.contactInfo | ||
policyList | 出差政策列表 | Array[] | data | |
passengerCode | 旅客编号 | String | data.policyList | |
staffCode | 旅客编号 | String | data.policyList | |
passengerName | 旅客姓名 | String | data.policyList | |
policyName | 政策名称 | String | data.policyList | |
policyProperty | 属性(建议/强制) | String | data.policyList | |
policyType | 基础/分类/个人/附加 | String | data.policyList | |
costList | 成本中心 | Array[] | data | |
remark | 备注 | String | data.costList | |
staffCode | 员工工号 | String | data.costList | |
passengerCode | 旅客编号 | String | data.costList | |
passengerName | 旅客名称 | String | data.costList | |
costId | 成本中心编号 | Integer | data.costList | |
costCenterName | 成本中心名称 | String | data.costList | |
amount | 成本金额 | Number | data.costList | |
priceList | 价格信息 | Array[] | data | |
sellDate | 日期(yyyy-MM-dd) | String | data.priceList | |
roomCount | 预订/退房间数 | Integer | data.priceList | |
roomPrice | 房价 | Number | data.priceList | |
foodPrice | 餐费 | Number | data.priceList | |
bedPrice | 加床费 | Number | data.priceList | |
servicePrice | 服务费(间晚/天) | Number | data.priceList | |
rebatePrice | 返现 | Number | data.priceList | |
commissionPrice | 手续费(退房时可能有值) | Number | data.priceList | |
passengerList | 旅客信息 | Array[] | data | |
reasonId | 差旅政策违反原因序号 | Integer | data.passengerList | |
reasonRemark | 差旅政策违反原因 | String | data.passengerList | |
errorMessage | 退票失败原因(订单为火车票时有值) | String | data.passengerList | |
returnStatus | 出票状况(订单为火车票时有值) | String | data.passengerList | |
seatNo | 座席号(订单为火车票时有值) | String | data.passengerList | |
originalTicketNo | 机票/火车票原票号(改签单时有值) | String | data.passengerList | |
belongToProject |
归属项目
添加日期: 2023-11-21 |
String | data.passengerList | |
travelPurpose |
出行目的
添加日期: 2023-11-21 |
String | data.passengerList | |
passengerNo | 旅客排序号(从1开始递增) | Integer | data.passengerList | |
passengerCode | 旅客编号 | String | data.passengerList | |
passengerName | 旅客姓名 | String | data.passengerList | |
certificateType | 证件类型 | String | data.passengerList | |
certificateId | 证件号码 | String | data.passengerList | |
passengerType | 旅客类型(成人/儿童/婴儿) | String | data.passengerList | |
ticketNo | 机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系) | String | data.passengerList | |
staffCode | 员工工号 | String | data.passengerList | |
mobile | 旅客手机号码 | String | data.passengerList | |
旅客邮箱,国际机票使用 | String | data.passengerList | ||
statusDesc | 客票状态描述 | String | data.passengerList | |
ticketStatus | 票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到 | String | data.passengerList | |
depName |
部门名称,用/分隔(列表返回最后一级,详细返回全级)
添加日期: 2018-10-18 |
String | data.passengerList | |
belongToCenter |
归属中心
添加日期: 2023-11-21 |
Array[] | data.passengerList | |
centerNo |
序号
添加日期: 2023-11-21 |
Integer | data.passengerList.belongToCenter | |
centerTitle |
归属中心标题
添加日期: 2023-11-21 |
String | data.passengerList.belongToCenter | |
centerName |
归属成本中心选项值
添加日期: 2023-11-21 |
String | data.passengerList.belongToCenter | |
hotelProduct | 酒店信息 | OrerPushHotelProduct | data | |
hotelCode | 酒店编号 | String | data.hotelProduct | |
hotelName | 酒店名称 | String | data.hotelProduct | |
roomCode | 房型编号 | String | data.hotelProduct | |
roomName | 房型名称 | String | data.hotelProduct | |
cityCode | 城市编号 | String | data.hotelProduct | |
cityName | 城市名称 | String | data.hotelProduct | |
checkInDate | 入住日期 | String | data.hotelProduct | |
checkOutDate | 离店日期 | String | data.hotelProduct | |
actualCheckOutDate | 实际离店日期 | String | data.hotelProduct | |
payType | 付款方式(24:前台支付--面付 26 :预付) | Integer | data.hotelProduct | |
garanteeRule | 担保规则 | Object | data.hotelProduct | |
payRule | 预付规则 | String | data.hotelProduct | |
hotelAddress | 酒店地址 | String | data.hotelProduct | |
cancelDeadline | 最晚取消时间 | String | data.hotelProduct | |
phone | 酒店电话 | String | data.hotelProduct | |
lastArriveTime | 最晚到达时间,格式:yyyy-MM-dd HH:mm | String | data.hotelProduct | |
nightCount | 晚数 | Integer | data.hotelProduct | |
rooms | 间晚数 | Integer | data.hotelProduct | |
roomCount | 间数 | Integer | data.hotelProduct | |
assureAmount | 担保金额 | Number | data.hotelProduct | |
assureDescription | 担保条款 | String | data.hotelProduct | |
hotelStarLevel | 星级 | String | data.hotelProduct | |
breakFastType |
早餐类型
未知,含早,无早,单早, 双早,三早, 多早,不含早, 含零早,含单早,含双早, 含三早,含四早,含五早, 含六早,含七早,含八早, 含单双早,床位早,含床位早, 双早+午餐/晚餐,不含早餐, 无餐/无早,一份早餐, 两份早餐,床位早餐, 床位中餐,床位晚餐,儿童早, 三份早餐,四份早餐, 五份早餐,六份早餐, 七份早餐,八份早餐, 九份早餐,十份早餐, 2大1小早餐,2大1小晚餐, 双早双晚 |
String | data.hotelProduct | |
hasBreakfast | 早餐: 含早 ; 不含早 | Boolean | data.hotelProduct | |
isProtocolPrice | 是否协议价,是/否/空(国际酒店为空) | String | data.hotelProduct | |
hotelCountry | 国家名称 中国/空(国外为空) | String | data.hotelProduct | |
hotelProvince | 省份名称 国内有值,国外为空 | String | data.hotelProduct | |
ClientInvoiceType | 客户发票类型 0:无,1:普票,2:专票,3:无票 | Integer | data.hotelProduct |
{
"data":
{
"totalServicePrice":10, //当前订单总服务费
"StaffPayExcess":false, //个人承担费用,=true 为存在个人承担,false
"PolicyExcessAmount":0.0, //StaffPayExcess=true 时需要关注,个人承担的金额,否则为 0;
"CompanyExcessAmount":818, //StaffPayExcess=true 时需要关注,公司承担的金额;
"priceList":
[{
"sellDate":"2023-11-08", //日期(yyyy-MM-dd)
"roomCount":2, //预订/退房间数
"roomPrice":409.00, //房价
"foodPrice":0.00, //餐费
"bedPrice":0.00, //加床费
"servicePrice":0.00, //服务费(间晚/天)
"rebatePrice":0.00, //返现
"commissionPrice":0.0, //手续费(退房时可能有值)
}], //价格信息
"hotelProduct":
{
"hotelCode":"10006739819", //酒店编号
"hotelName":"凤悦轻尚酒店(广州白云机场店)", //酒店名称
"roomCode":"HR10002241890", //房型编号
"roomName":"悦享巨幕意境大床房", //房型名称
"cityCode":"c11127", //城市编号
"cityName":"广州", //城市名称
"checkInDate":"2023-11-07", //入住日期
"checkOutDate":"2023-11-08", //离店日期
"actualCheckOutDate":"2023-11-08", //实际离店日期
"payType":26, //付款方式(24:前台支付--面付 26 :预付)
"garanteeRule":"null", //担保规则
"payRule": "", //预付规则
"hotelAddress":"人和镇鹤龙七路1号4-5层", //酒店地址
"cancelDeadline":"2023-11-07 17:00:00", //最晚取消时间
"phone":"020-86606115", //酒店电话
"lastArriveTime":"2023-11-07 18:00:00", //最晚到达时间,格式:yyyy-MM-dd HH:mm
"nightCount":1, //晚数
"rooms":2, //间晚数
"roomCount":2, //间数
"assureAmount":0, //担保金额
"assureDescription": "", //担保条款
"hotelStarLevel":"4", //星级
"breakFastType":"双早", //早餐类型
"hasBreakfast":true, //早餐: 含早 ; 不含早
"isProtocolPrice":"否", //是否协议价,是/否/空(国际酒店为空)
"hotelCountry":"中国", //国家名称 中国/空(国外为空)
"hotelProvince":"广东省", //省份名称 国内有值,国外为空
"ClientInvoiceType":0, //客户发票类型 0:无,1:普票,2:专票,3:无票
}, //酒店信息
"status":3, //订单状态
"deadLineTime":"2023/11/25 0:00:00", //价格有效期(改签单和退票单时,订单需在价格有效期内提交订单,过了有效期会提交订单失败)
"tripId": "", //行程编号
"companyId":"S117955", //公司编号
"failureReason": "", //订单失败原因
"oaOtherInfo":"zjm485215588", //其他信息,个性化客户需要(比如:中奖码)
"firstOrderNo":"TB2024000154", //美亚原购单号
"orderSource":3, //订单来源
"receivePayType":"月结", //支付方式
"affiliateBusinessName":"广东美亚商旅科技有限公司", //供应商
"pnr": "", //pnr
"passengerList":
[{
"reasonId":0, //差旅政策违反原因序号
"reasonRemark": "", //差旅政策违反原因
"errorMessage": "", //退票失败原因(订单为火车票时有值)
"returnStatus": "", //出票状况(订单为火车票时有值)
"seatNo": "", //座席号(订单为火车票时有值)
"originalTicketNo": "", //机票/火车票原票号(改签单时有值)
"belongToCenter":
[{
"centerNo":0, //序号
"centerTitle": "", //归属中心标题
"centerName": "", //归属成本中心选项值
}], //归属中心
"belongToProject": "", //归属项目
"travelPurpose": "", //出行目的
"passengerNo":1, //旅客排序号(从1开始递增)
"passengerCode":"P827827", //旅客编号
"passengerName":"张宇宇", //旅客姓名
"certificateType":"因公护照", //证件类型
"certificateId":"562233", //证件号码
"passengerType":"成人", //旅客类型(成人/儿童/婴儿)
"ticketNo":"2", //机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系)
"staffCode":"WBDDH002", //员工工号
"mobile": "", //旅客手机号码
"email": "", //旅客邮箱,国际机票使用
"statusDesc": "", //客票状态描述
"ticketStatus": "", //票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到
"depName":"0922部门/0922", //部门名称,用/分隔(列表返回最后一级,详细返回全级)
}], //旅客信息
"costList":
[{
"remark": "", //备注
"staffCode": "", //员工工号
"passengerCode":"P409149", //旅客编号
"passengerName":"陈军凤", //旅客名称
"costId":163939, //成本中心编号
"costCenterName":"董事会", //成本中心名称
"amount":240.00, //成本金额
}], //成本中心
"contactInfo":
{
"contactName":"张宇宇", //联系人姓名
"mobile":"15617929598", //手机号
"phone": "", //固定电话
"email":"St87875@meiya.com", //邮箱
}, //联系人信息
"policyList":
[{
"passengerCode":"P415090", //旅客编号
"staffCode":"董事会", //旅客编号
"passengerName":"WBDDH001", //旅客姓名
"policyName":"机票差旅政策一", //政策名称
"policyProperty":"强制", //属性(建议/强制)
"policyType":"基础", //基础/分类/个人/附加
}], //出差政策列表
"c_TextField_2401": "", //客户自定义字段1
"c_TextField_2402": "", //客户自定义字段2
"c_TextField_2403": "", //客户自定义字段3
"c_TextField_2404": "", //客户自定义字段4
"c_TextField_2405": "", //客户自定义字段5
"c_TextField_2406": "", //客户自定义字段6
"c_TextField_2407": "", //客户自定义字段7
"c_TextField_2408": "", //客户自定义字段8
"totalPrice":818.00, //当前订单总金额
"opId": "", //制单人旅客编号
"onBusiness":0, //订单类型(1:因公;0:因私) 注意:如果因私订单不需要的,记得接收时过滤掉
"orderRemark":"订单备注", //订单备注
"outsideOrderNo":"jd20231011022", //客户订单号
"orderNo":"HB2300004135", //美亚订单号
"originalOrderNo": "", //美亚原订单号
"opStaffCode":"WBDDH001", //客户制单人工号
"opName":"张宇宇", //客户制单人
"opDate":"2023-10-20 11:24:26", //下单时间(yyyy-MM-dd HH:mm:ss)
"statusText":"处理成功", //订单状态(名称)
"issueDate":"zjm485215588", //出票日期(yyyy-MM-dd HH:mm:ss)
"oaSerialnumber":"SL58445577484", //客户出差申请单号
"stApplyOrderNo":"EC230005785", //美亚出差申请单号
}, //订单信息
"orderType":0, //订单类型
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单编号, 共用的实体,订单号展示只做示例 | String | 是 | |
cancelReasonId | Integer | 否 | ||
cancelReason | 取消原因 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //订单编号, 共用的实体,订单号展示只做示例
"cancelReasonId":0, //
"cancelReason": "", //取消原因
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 原订购单编号 | String | 是 | |
outsideOrderNo | 外部订单号 | String | 否 | |
oaSerialnumber | 出差申请单号 | String | 否 | |
reason | 退房原因 | String | 否 | |
remark | String | 否 | ||
isReturnAll | 是否整单退 | Boolean | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
refurnRoomDates | 退房房间详细 isRefundAll=ture 忽略 ,isRefundAll=false必填 | Array[] | 否 | |
checkInDate | 入住日期 | String | refurnRoomDates | |
roomInfos | 房间信息 | Array[] | refurnRoomDates | |
roomNo | 房间房号 | String | refurnRoomDates.roomInfos | |
passengerNames | 退房旅客姓名 | Array[] | refurnRoomDates.roomInfos | |
contactInfo | 联系人信息 如果不传则取原单 | ContactInfo | 否 | |
contactName | 联系人 | String | contactInfo | |
mobile | 手机号码 | String | contactInfo | |
phone | 联系电话 | String | contactInfo | |
电子邮件 | String | contactInfo |
{
"orderNo": "", //原订购单编号
"outsideOrderNo": "", //外部订单号
"oaSerialnumber": "", //出差申请单号
"reason": "", //退房原因
"remark": "", //
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息 如果不传则取原单
"isReturnAll":false, //是否整单退
"refurnRoomDates":
[{
"checkInDate": "", //入住日期
"roomInfos":
[{
"roomNo": "", //房间房号
"passengerNames":[], //退房旅客姓名
}], //房间信息
}], //退房房间详细 isRefundAll=ture 忽略 ,isRefundAll=false必填
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | String | |||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo": "", //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
captchaCode | 验证码 | String | 否 | |
isDigit |
身份证后4位
添加日期: 2023-08-08 |
String | 是 | |
userName | 12306 账号 | String | 是 | |
password | 12306 密码 | String | 是 |
{
"captchaCode":"904472", //验证码
"isDigit": "", //身份证后4位
"userName":"liuzhanchao@163.com", //12306 账号
"password":"liuzhanchao123456", //12306 密码
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
mobileStatus | 手机核验状态,0:未知,-1:未通过核验, -2:需要进行核验,1或为空null:已通过核验 | String | ||
verifyStatus | 核验状态 0:未知 -1:待核验 -2:已核验,未通过 1或为空null:已核验,已通过 | String | ||
code |
返回代码,10000=成功,其他为错误
111 账号登录异常,需要进行人脸核验 666 需要手机短信验证 234069 该账号需要进行短信验证 |
String | ||
description | 执行结果描述 | String |
{
"mobileStatus": "", //手机核验状态,0:未知,-1:未通过核验, -2:需要进行核验,1或为空null:已通过核验
"verifyStatus": "", //核验状态 0:未知 -1:待核验 -2:已核验,未通过 1或为空null:已核验,已通过
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
sessionId | sessionId,login接口返回 | String | 是 |
{
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
stationInfo | Array[] | |||
stationId | ID | String | stationInfo | |
shortName | 站点缩写名称 | String | stationInfo | |
stationName | 站点名称 | String | stationInfo | |
enName | 站点拼音名称 | String | stationInfo | |
cityName | 城市名称 | String | stationInfo | |
cityCode | 城市码 | String | stationInfo | |
stationCode | 站点代码 | String | stationInfo |
{
"stationInfo":
[{
"stationId":"699", //ID
"shortName":"gzb", //站点缩写名称
"stationName":"广州北", //站点名称
"enName":"guangzhoubei", //站点拼音名称
"cityName":"广州", //城市名称
"cityCode":"CAN", //城市码
"stationCode":"GBQ", //站点代码
}], //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
fromStationName | 出发站名称(出发站三字码和出发站名称必须有一个有值) | String | 是 | |
toStationName | 到达站名称(到达站三字码和到达站名称必须有一个有值) | String | 是 | |
fromStationCode | 出发站三字码 | String | 否 | |
toStationCode | 到达站三字码 | String | 否 | |
departureDate | 发车日期(yyyy-MM-dd) | String | 是 | |
ticketType | 票种类型 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"fromStationName":"广州", //出发站名称(出发站三字码和出发站名称必须有一个有值)
"toStationName":"深圳", //到达站名称(到达站三字码和到达站名称必须有一个有值)
"fromStationCode": "", //出发站三字码
"toStationCode": "", //到达站三字码
"departureDate":"2023-10-28", //发车日期(yyyy-MM-dd)
"ticketType": "", //票种类型
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
queryKey | 查询key | String | ||
serviceFee | 服务费 | Number | ||
serviceFeeChange | 改签服务费 | Number | ||
serviceFeeRefund | 退票服务费 | Number | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
trainInfos | Array[] | |||
TrainInternalNo | 车编号(12306系统内部车次号) | String | trainInfos | |
TrainNumber | 车次号 K528 | String | trainInfos | |
TrainTypeName | 火车类型名称 | String | trainInfos | |
UseIDCard | K528 中的 K 可以从TrainNumber截取第一个字符 | String | trainInfos | |
FromStationName | 开始站点 | String | trainInfos | |
FromStationCode | 开始站点code | String | trainInfos | |
ToStationName | 目的站点 | String | trainInfos | |
ToStationCode | 目的地站点code | String | trainInfos | |
FromTime | 开始时间 09:30 | String | trainInfos | |
FromTimeLong | 开始时间 yyyy-MM-dd 09:30 | String | trainInfos | |
ToTime | 到达时间 10:30 | String | trainInfos | |
ToTimeLong | 到达时间 yyyy-MM-dd 10:30 | String | trainInfos | |
FromPassingType | 开始站点类型 出发:iStart 途径:iPass 终点:iEnd | String | trainInfos | |
ToPassingType | 到达站点类型 出发:iStart 途径:iPass 终点:iEnd | String | trainInfos | |
RunTime | 耗时 小时-分钟 | String | trainInfos | |
RunTimeMin | 耗时 分钟 | Integer | trainInfos | |
sub_train_number | 出发车次号 | String | trainInfos | |
SaleTime | String | trainInfos | ||
ControlDay | String | trainInfos | ||
CanWebBuy | 能否网上预订 Y/N | String | trainInfos | |
SeatBookAbleOrder | 能否预订座位 0/1 | String | trainInfos | |
ToDay | 到达时间 yyyy-MM-dd | String | trainInfos | |
SpendDay | 途经站经过天数0为当天 | String | trainInfos | |
SupplierNo | 供应商编号 | String | trainInfos | |
SupplierName | 供应商名称 | String | trainInfos | |
ProductNoConfig | 产品编号 -- 配置产品 | String | trainInfos | |
PlatformSupplierNo | 平台供应商编号;使用的是哪一家的产品 | String | trainInfos | |
PurchaseType | 购票模式(0:代购 1:自购 2:不限) | Integer | trainInfos | |
StartStationName | 始发站(只有航天华友会有值) | String | trainInfos | |
EndStationName | 终点站(只有航天华友会有值) | String | trainInfos | |
Seats | 座位信息 | Array[] | trainInfos | |
SeatID | 座位ID | String | trainInfos.Seats | |
SeatPrice | 价格 | Number | trainInfos.Seats | |
SeatName | 座位名称 软座/硬座等 | String | trainInfos.Seats | |
SeatBookAble | 为0,或者1,分别表示不可预订与可预订 ; | String | trainInfos.Seats | |
SeatYuPiao | 余票数量 | String | trainInfos.Seats |
{
"queryKey":"GZQSZQ2023-10-28", //查询key
"trainInfos":
[{
"TrainInternalNo":"62000K92170V", //车编号(12306系统内部车次号)
"TrainNumber":"K9217", //车次号 K528
"TrainTypeName": "", //火车类型名称
"UseIDCard":"K", //K528 中的 K 可以从TrainNumber截取第一个字符
"FromStationName":"广州北", //开始站点
"FromStationCode":"GBQ", //开始站点code
"ToStationName":"深圳东", //目的站点
"ToStationCode":"BJQ", //目的地站点code
"FromTime":"00:00", //开始时间 09:30
"FromTimeLong":"2023-10-28 00:00", //开始时间 yyyy-MM-dd 09:30
"ToTime":"03:59", //到达时间 10:30
"ToTimeLong":"2023-10-28 03:59", //到达时间 yyyy-MM-dd 10:30
"FromPassingType":"iPass", //开始站点类型 出发:iStart 途径:iPass 终点:iEnd
"ToPassingType":"iEnd", //到达站点类型 出发:iStart 途径:iPass 终点:iEnd
"RunTime":"3小时59分钟", //耗时 小时-分钟
"RunTimeMin":239, //耗时 分钟
"sub_train_number":"K9217", //出发车次号
"SaleTime": "", //
"ControlDay": "", //
"CanWebBuy":"N", //能否网上预订 Y/N
"SeatBookAbleOrder":"0", //能否预订座位 0/1
"ToDay":"2023-10-28", //到达时间 yyyy-MM-dd
"SpendDay":"0", //途经站经过天数0为当天
"Seats":
[{
"SeatID":"H10", //座位ID
"SeatPrice":85, //价格
"SeatName":"软座", //座位名称 软座/硬座等
"SeatBookAble":"1", //为0,或者1,分别表示不可预订与可预订 ;
"SeatYuPiao":"100", //余票数量
}], //座位信息
"SupplierNo":"SP2021005944", //供应商编号
"SupplierName":"青岛景行科技有限公司", //供应商名称
"ProductNoConfig":"SLR2200000001", //产品编号 -- 配置产品
"PlatformSupplierNo":"PTSH000000", //平台供应商编号;使用的是哪一家的产品
"PurchaseType":1, //购票模式(0:代购 1:自购 2:不限)
"StartStationName":"广州北", //始发站(只有航天华友会有值)
"EndStationName":"深圳东", //终点站(只有航天华友会有值)
}], //
"serviceFee":10.00, //服务费
"serviceFeeChange":0.00, //改签服务费
"serviceFeeRefund":0.00, //退票服务费
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无调用日志数据,不做初始数据填充
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
trainNumber | 车次号 | String | 是 | |
startDate | 发车日期(yyyy-MM-dd) | String | 是 | |
fromStationName | 出发站名称 | String | 是 | |
toStationName | 到达站名称 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"trainNumber": "", //车次号
"startDate": "", //发车日期(yyyy-MM-dd)
"fromStationName": "", //出发站名称
"toStationName": "", //到达站名称
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
passings | Array[] | |||
stationId | 站点ID | String | passings | |
stationNum | 站点编号 1,2,3,4,5 等 | String | passings | |
toStationName | 站点名称 | String | passings | |
toTime | 到达时间 | String | passings | |
fromTime | 出发时间 | String | passings | |
stopTime | 停留时间 分钟 | String | passings | |
subTrainNum | 途径 车次号 | String | passings | |
km | 公里 | String | passings | |
day | 经过天数(当天到达标识为1,其他类推,铁友特有) | Integer | passings |
{
"passings":
[{
"stationId":"IOQ", //站点ID
"stationNum":"3", //站点编号 1,2,3,4,5 等
"toStationName":"深圳北", //站点名称
"toTime":"2023-10-25 10:50", //到达时间
"fromTime":"2023-10-25 8:50", //出发时间
"stopTime":"10", //停留时间 分钟
"subTrainNum":"K78", //途径 车次号
"km":"350", //公里
"day":0, //经过天数(当天到达标识为1,其他类推,铁友特有)
}], //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
常用联系人查询
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
userName | 12306 账号 | String | 是 | |
password | 12306 密码 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"userName":"liuzhanchao@163.com", //12306 账号
"password":"liuzhanchao123456", //12306 密码
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
passengers | Array[] | |||
name | 姓名 | String | passengers | |
isUserSelf | 是否是账号本人(是、否) | String | passengers | |
passengerType | 旅客类型(成人、儿童、学生、残军) | String | passengers | |
mobilePhone | 手机号码(打码:157****3074) | String | passengers | |
identy | 证件号码(打码:4509***********941) | String | passengers | |
identyType | 证件类型(身份证、护照、外国人民居住证、港澳台居民居住证、港澳通行证、台胞通行证、外国人永久居留身份证) | String | passengers | |
checkStatus | 身份是否校验通过(待校验 校验通过) | String | passengers | |
mobilePhoneCheckStatus | 手机是否校验通过 (待校验 校验通过) | String | passengers | |
sex | 性别 (男 女 未知) | String | passengers | |
birthday | 出生年月日(打码:****-**-**) | String | passengers | |
country | 国家(CN,简码) | String | passengers | |
address | 地址 | String | passengers | |
邮件 | String | passengers | ||
fixedPhone | 固话号码 | String | passengers |
{
"passengers":
[{
"name":"刘展超", //姓名
"isUserSelf":"是", //是否是账号本人(是、否)
"passengerType":"成人", //旅客类型(成人、儿童、学生、残军)
"mobilePhone":"157****3074", //手机号码(打码:157****3074)
"identy":"4509***********941", //证件号码(打码:4509***********941)
"identyType":"身份证", //证件类型(身份证、护照、外国人民居住证、港澳台居民居住证、港澳通行证、台胞通行证、外国人永久居留身份证)
"checkStatus":"校验通过", //身份是否校验通过(待校验 校验通过)
"mobilePhoneCheckStatus":"校验通过", //手机是否校验通过 (待校验 校验通过)
"sex":"男", //性别 (男 女 未知)
"birthday":"****-**-**", //出生年月日(打码:****-**-**)
"country":"CN", //国家(CN,简码)
"address": "", //地址
"email":"liuzhanchao@163.com", //邮件
"fixedPhone": "", //固话号码
}], //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
trainNumber | 车次号 | String | 否 | |
startDate | 发车日期(yyyy-MM-dd) | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"trainNumber":"K9217", //车次号
"startDate":"2023-10-25", //发车日期(yyyy-MM-dd)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
passings | Array[] | |||
stationId | 站点ID | String | passings | |
stationNum | 站点编号 1,2,3,4,5 等 | String | passings | |
toStationName | 站点名称 | String | passings | |
toTime | 到达时间 | String | passings | |
fromTime | 出发时间 | String | passings | |
stopTime | 停留时间 分钟 | String | passings | |
subTrainNum | 途径 车次号 | String | passings | |
km | 公里 | String | passings | |
day | 经过天数(当天到达标识为1,其他类推,铁友特有) | Integer | passings |
{
"passings":
[{
"stationId":"IOQ", //站点ID
"stationNum":"3", //站点编号 1,2,3,4,5 等
"toStationName":"深圳北", //站点名称
"toTime":"2023-10-25 10:50", //到达时间
"fromTime":"2023-10-25 8:50", //出发时间
"stopTime":"10", //停留时间 分钟
"subTrainNum":"K78", //途径 车次号
"km":"350", //公里
"day":0, //经过天数(当天到达标识为1,其他类推,铁友特有)
}], //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
purchaseType | 0 代购 1自购 | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"purchaseType":0, //0 代购 1自购
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
HandlingFee | 手续费 | Number | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"HandlingFee":5.00, //手续费
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outSideOrderNo | 外部订购单号 | String | 否 | |
oaSerialnumber | 出差申请单号 | String | 否 | |
trainNumber | 车次号 | String | 是 | |
trainType | 预订车型 | String | 否 | |
fromStationName | 出发站 | String | 是 | |
fromStationCode | 出发站 | String | 否 | |
startDate | 出发日期 | String | 是 | |
startTime | 出发时间 | String | 是 | |
toStationCode | 到达站 | String | 否 | |
toStationName | 到达站 | String | 是 | |
arrivalDate | 到达日期 | String | 是 | |
arrivalTime | 到达时间 | String | 是 | |
bookType | 预订类型 | String | 否 | |
queryKey | queryKey 查询返回 | String | 是 | |
isSubmit | 是否同时提交 | Boolean | 否 | |
issueType | 出票方式(0=占座出票合并,1=占座出票拆开) | Integer | 否 | |
splitOrder | 是否按旅客拆单 | Boolean | 否 | |
userName | 12306 账号 | String | 是 | |
password | 12306 密码 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
seatInfo | 席位信息 | ApiTrainSeatInfo | 是 | |
seatPrice | 席位参考票价 | Number | seatInfo | |
seatName | 座位名称 软座/硬座等 | String | seatInfo | |
invoiceInfo | 是否需要发票 | InvoiceInfo | 否 | |
InvoiceAddress | 发票邮寄地址 | String | invoiceInfo | |
InvoiceRecipients | 发票收件人 | String | invoiceInfo | |
InvoicePostCode | 发票邮编 | String | invoiceInfo | |
contactList | 联系人信息 | Array[] | 是 | |
contactName | 联系人 | String | contactList | |
mobile | 手机号码 | String | contactList | |
phone | 联系电话 | String | contactList | |
电子邮件 | String | contactList | ||
passengerList | 旅客信息 | Array[] | 是 | |
uatpCardNameList | uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
uatpCardNumberList | uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
passengerJruisdictions | 拥有的权限列表(根据passengerJruisdictionType决定) | Array[] | passengerList | |
passengerJruisdictionType | passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理 | Integer | passengerList | |
outsidePassengerId | 对接方系统的旅客编号 | String | passengerList | |
passengerId | 美亚旅客编号(不用传) | String | passengerList | |
passengerName | 乘机人姓名 | String | passengerList | |
passengerType | 旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿) | String | passengerList | |
companyId | 公司编号 | String | passengerList | |
sex | 必传 性别:男/女;不能传其他字符 | String | passengerList | |
cnName | 中文姓名(中文姓名、英文姓名2选一) | String | passengerList | |
enName | 英文姓名(中文姓名、英文姓名2选一,格式:zhang/san) | String | passengerList | |
userName | 登录用户名 | String | passengerList | |
dId | 部门ID(不传) | Integer | passengerList | |
dName | 部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | passengerList | |
nationality | 国籍:中国填写 CN,必传 | String | passengerList | |
birthday | 出生日期(yyyy-MM-dd)必传 | String | passengerList | |
mobile | 手机号码 | String | passengerList | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | passengerList | |
电子邮箱 | String | passengerList | ||
defaultRoleId | 默认角色 | String | passengerList | |
holderId | 职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值 | String | passengerList | |
postID | 职位ID | String | passengerList | |
approvalOutsideId | 审批人的外部系统编号 | String | passengerList | |
SuperVip | 0:非VIP 1VIP | Integer | passengerList | |
phone | 固定电话 | String | passengerList | |
policyId | 差旅政策ID;如果是非正常职等差标满足不了的,则使用policyId传美亚差标ID,进行跨职等差标预订;例如旅客配领导享受领导差标; | String | passengerList | |
staffId | 员工工号 | String | passengerList | |
chooseSeatNo | 在线选座(火车票)如:1A | String | passengerList | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | passengerList | |
CostList | 成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可 | Array[] | passengerList | |
costCenterName | 成本中心名称 | String | passengerList.CostList | |
insuranceList | 保险产品信息 | Array[] | passengerList | |
insuranceId | 保险产品编号(联系美亚获取) | Integer | passengerList.insuranceList | |
insuranceCount | 保险份数(一般最大是两份) | Integer | passengerList.insuranceList | |
certificatePhoto | 证件图片信息(只有国际机票使用,其他产品传null 或者不处理) | CertificatePhoto | passengerList | |
fileName | 文件名称 | String | passengerList.certificatePhoto | |
fileCode | 文件流 | String | passengerList.certificatePhoto | |
frequentTraveller | 常旅卡信息 | FrequentTraveller | passengerList | |
airlineCode | 航司二字码 | String | passengerList.frequentTraveller | |
cardName | 常旅卡名称 | String | passengerList.frequentTraveller | |
cardNumber | 常旅卡号 | String | passengerList.frequentTraveller | |
certificatesList | 证件 | Array[] | passengerList | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | passengerList.certificatesList | |
certNumber | 证件号码 | String | passengerList.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | passengerList.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | passengerList.certificatesList |
{
"outSideOrderNo":"HCP23001004", //外部订购单号
"oaSerialnumber":"HCP23001004", //出差申请单号
"trainNumber":"G7236", //车次号
"trainType": "", //预订车型
"fromStationName":"上海", //出发站
"fromStationCode":"SHH", //出发站
"startDate":"2023-10-30", //出发日期
"startTime":"10:28", //出发时间
"toStationCode":"NKH", //到达站
"toStationName":"南京南", //到达站
"arrivalDate":"2023-10-30", //到达日期
"arrivalTime":"12:38", //到达时间
"seatInfo":
{
"seatPrice":157.00, //席位参考票价
"seatName":"二等座", //座位名称 软座/硬座等
}, //席位信息
"passengerList":
[{
"uatpCardNameList":"null", //uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理)
"uatpCardNumberList":"null", //uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理)
"passengerJruisdictions":"null", //拥有的权限列表(根据passengerJruisdictionType决定)
"passengerJruisdictionType":0, //passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理
"outsidePassengerId":"ak10002", //对接方系统的旅客编号
"passengerId": "", //美亚旅客编号(不用传)
"passengerName":"刘展超", //乘机人姓名
"passengerType":"成人", //旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿)
"companyId":"S118022", //公司编号
"sex":"男", //必传 性别:男/女;不能传其他字符
"cnName":"刘展超", //中文姓名(中文姓名、英文姓名2选一)
"enName":"liu/zhanchao", //英文姓名(中文姓名、英文姓名2选一,格式:zhang/san)
"userName":"AK_liuzhanchao", //登录用户名
"dId":0, //部门ID(不传)
"dName":"美亚集团/旅游产品部/运营中心", //部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"nationality":"CN", //国籍:中国填写 CN,必传
"birthday":"2000-01-20", //出生日期(yyyy-MM-dd)必传
"mobile":"18628535565", //手机号码
"mobileAreaCode":"556", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"CostList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件
"defaultRoleId": "", //默认角色
"holderId":"M1", //职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值
"postID":"一厂经理", //职位ID
"approvalOutsideId": "", //审批人的外部系统编号
"SuperVip":0, //0:非VIP 1VIP
"phone":"020-82862903", //固定电话
"policyId": "", //差旅政策ID;如果是非正常职等差标满足不了的,则使用policyId传美亚差标ID,进行跨职等差标预订;例如旅客配领导享受领导差标;
"staffId": "", //员工工号
"insuranceList":
[{
"insuranceId":0, //保险产品编号(联系美亚获取)
"insuranceCount":0, //保险份数(一般最大是两份)
}], //保险产品信息
"chooseSeatNo": "", //在线选座(火车票)如:1A
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
"frequentTraveller":
{
"airlineCode":"MU", //航司二字码
"cardName":"东方明珠积分卡", //常旅卡名称
"cardNumber":"7894587775", //常旅卡号
}, //常旅卡信息
"certificatePhoto":
{
"fileName":"我的证件.jpg", //文件名称
"fileCode":"ADWHIFHWFJJSFJWFJ...", //文件流
}, //证件图片信息(只有国际机票使用,其他产品传null 或者不处理)
}], //旅客信息
"contactList":
[{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}], //联系人信息
"invoiceInfo":
{
"InvoiceAddress": "", //发票邮寄地址
"InvoiceRecipients": "", //发票收件人
"InvoicePostCode": "", //发票邮编
}, //是否需要发票
"bookType": "", //预订类型
"queryKey":"f66a058d3571479d82b625626aaf7092", //queryKey 查询返回
"isSubmit":true, //是否同时提交
"issueType":1, //出票方式(0=占座出票合并,1=占座出票拆开)
"splitOrder":false, //是否按旅客拆单
"userName":"liuzhanchao@163.com", //12306 账号
"password":"liuzhanchao123456", //12306 密码
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
orderItems | 订单信息 | Array[] | ||
orderNo | 订单号 | String | orderItems |
{
"orderItems":
[{
"orderNo":"RB2300194719", //订单号
}], //订单信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单编号, 共用的实体,订单号展示只做示例 | String | 是 | |
cancelReasonId | Integer | 否 | ||
cancelReason | 取消原因 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //订单编号, 共用的实体,订单号展示只做示例
"cancelReasonId":0, //
"cancelReason": "", //取消原因
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderType |
订单类型
0:全部; 70:订购单; 80:退票单; 90:改签单; |
Integer | 否 | |
originalOrderNo | 美亚原订购单号 | String | 否 | |
staffCode | 制单人的外部系统编号 | String | 否 | |
opId | 制单人的旅客编号, | String | 否 | |
orderNo | 订单号 | String | 否 | |
departureCity | 出发城市 | String | 否 | |
arrivalCity | 到达城 | String | 否 | |
startTime | 制单时间范围(开始) | String | 否 | |
endTime | 制单时间范围(结束) | String | 否 | |
startDepartureTime | 出发时间范围(开始) | String | 否 | |
endDepartureTime | 出发时间范围(结束) | String | 否 | |
orderStatus | 订单状态 | Integer | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数(最大50) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderType":0, //订单类型
"originalOrderNo": "", //美亚原订购单号
"staffCode":"ak10002", //制单人的外部系统编号
"opId":"P578541", //制单人的旅客编号,
"orderNo":"RB2300047878", //订单号
"departureCity":"广州", //出发城市
"arrivalCity":"深圳", //到达城
"startTime":"2023-10-01", //制单时间范围(开始)
"endTime":"2023-10-25", //制单时间范围(结束)
"startDepartureTime":"2023-10-01 00:00:00", //出发时间范围(开始)
"endDepartureTime":"2023-10-25 00:00:00", //出发时间范围(结束)
"orderStatus":0, //订单状态
"pageIndex":1, //页码
"pageSize":50, //每页记录数(最大50)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
totalCount | 总记录数 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
orderList | 订单信息 | Array[] | ||
companyId | 公司编号 | String | orderList | |
companyName | 公司名称 | String | orderList | |
orderNo | 美亚订单号 | String | orderList | |
originalOrderNo | 原订单编号 改签、退票、废票单的原单编号,订购单时为空 | String | orderList | |
opDate | 建单时间 | String | orderList | |
opId | 建单人 | String | orderList | |
opStaffCode | 建单人员工工号 | String | orderList | |
opName | 客户制单人 | String | orderList | |
statusText | 订单状态(中文) | String | orderList | |
status |
订单状态(建议只关注 80,50)
5 :待提交 10 :审批中 20 :待收款 25 :待付款 30 :出票中 35 :紧急处理 40 :已出票 50 :已取消 60 :待核对 70 :处理中 75 :紧急处理 80 :已处理 200:待审核 |
Integer | orderList | |
orderType |
订单类型
70:订购单; 80:退票单; 90:改签单; |
Integer | orderList | |
oaSerialnumber | 出差申请单号 | String | orderList | |
totalPrice | 订单总金额 | Number | orderList | |
trainNumber | 车次号 | String | orderList | |
trainType | 车次类型 | String | orderList | |
origincityName | 出发城市 | String | orderList | |
destinationCityName | 到达城市 | String | orderList | |
departureDate | 出发日期(格式:yyyy-MM-dd) | String | orderList | |
departureTime | 出发时间(格式:00:00) | String | orderList | |
arrivalDate | 到达日期(格式:yyyy-MM-dd) | String | orderList | |
arrivalTime | 到达时间(格式:00:00) | String | orderList | |
seatLevel | 座位等级 | String | orderList | |
passengerList | 旅客信息 | Array[] | orderList | |
errorMessage | 退票失败原因 | String | orderList.passengerList | |
returnStatus | 出票状况 | String | orderList.passengerList | |
seatNo | 座席号 | String | orderList.passengerList | |
violationPolicy | 1:违反差旅政策;0:不违反 | Integer | orderList.passengerList | |
policyName | 差旅政策名称 | String | orderList.passengerList | |
policyProperty | 差旅政策 分类 | String | orderList.passengerList | |
policyReason | 违反原因 | String | orderList.passengerList | |
policyType | 基础/分类/个人/附加 | String | orderList.passengerList | |
passengerNo | 旅客排序号(从1开始递增) | Integer | orderList.passengerList | |
passengerCode | 旅客编号 | String | orderList.passengerList | |
passengerName | 旅客姓名 | String | orderList.passengerList | |
certificateType | 证件类型 | String | orderList.passengerList | |
certificateId | 证件号码 | String | orderList.passengerList | |
passengerType | 旅客类型(成人/儿童/婴儿) | String | orderList.passengerList | |
ticketNo | 机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系) | String | orderList.passengerList | |
staffCode | 员工工号 | String | orderList.passengerList | |
mobile | 旅客手机号码 | String | orderList.passengerList | |
旅客邮箱,国际机票使用 | String | orderList.passengerList | ||
statusDesc | 客票状态描述 | String | orderList.passengerList | |
ticketStatus | 票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到 | String | orderList.passengerList | |
depName |
部门名称,用/分隔(列表返回最后一级,详细返回全级)
添加日期: 2018-10-18 |
String | orderList.passengerList |
{
"totalCount":0, //总记录数
"orderList":
[{
"companyId": "", //公司编号
"companyName": "", //公司名称
"orderNo": "", //美亚订单号
"originalOrderNo": "", //原订单编号 改签、退票、废票单的原单编号,订购单时为空
"opDate": "", //建单时间
"opId": "", //建单人
"opStaffCode": "", //建单人员工工号
"opName": "", //客户制单人
"statusText": "", //订单状态(中文)
"status":0, //订单状态(建议只关注 80,50)
"orderType":0, //订单类型
"oaSerialnumber": "", //出差申请单号
"totalPrice":0, //订单总金额
"passengerList":
[{
"errorMessage": "", //退票失败原因
"returnStatus": "", //出票状况
"seatNo": "", //座席号
"violationPolicy":0, //1:违反差旅政策;0:不违反
"policyName":"机票基础差标", //差旅政策名称
"policyProperty":"基础", //差旅政策 分类
"policyReason": "", //违反原因
"policyType":"基础", //基础/分类/个人/附加
"passengerNo":1, //旅客排序号(从1开始递增)
"passengerCode":"P827827", //旅客编号
"passengerName":"张宇宇", //旅客姓名
"certificateType":"因公护照", //证件类型
"certificateId":"562233", //证件号码
"passengerType":"成人", //旅客类型(成人/儿童/婴儿)
"ticketNo":"2", //机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系)
"staffCode":"WBDDH002", //员工工号
"mobile": "", //旅客手机号码
"email": "", //旅客邮箱,国际机票使用
"statusDesc": "", //客票状态描述
"ticketStatus": "", //票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到
"depName":"0922部门/0922", //部门名称,用/分隔(列表返回最后一级,详细返回全级)
}], //旅客信息
"trainNumber": "", //车次号
"trainType": "", //车次类型
"origincityName": "", //出发城市
"destinationCityName": "", //到达城市
"departureDate": "", //出发日期(格式:yyyy-MM-dd)
"departureTime": "", //出发时间(格式:00:00)
"arrivalDate": "", //到达日期(格式:yyyy-MM-dd)
"arrivalTime": "", //到达时间(格式:00:00)
"seatLevel": "", //座位等级
}], //订单信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderType | 订单类型 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
data | 订单信息 | TrainOrderPush | ||
StaffPayExcess |
个人承担费用,=true 为存在个人承担,false
添加日期: 2024-04-03 |
Boolean | data | |
PolicyExcessAmount |
StaffPayExcess=true 时需要关注,个人承担的金额,否则为 0;
添加日期: 2024-04-03 |
Number | data | |
CompanyExcessAmount |
StaffPayExcess=true 时需要关注,公司承担的金额;
添加日期: 2024-04-03 |
Number | data | |
status | 订单状态 | Integer | data | |
deadLineTime | 价格有效期(改签单和退票单时,订单需在价格有效期内提交订单,过了有效期会提交订单失败) | String | data | |
tripId | 行程编号 | String | data | |
companyId | 公司编号 | String | data | |
failureReason | 订单失败原因 | String | data | |
oaOtherInfo | 其他信息,个性化客户需要(比如:中奖码) | String | data | |
firstOrderNo | 美亚原购单号 | String | data | |
orderSource | 订单来源 | Integer | data | |
receivePayType |
支付方式
月结 现结 预存卡 |
String | data | |
affiliateBusinessName | 供应商 | String | data | |
pnr | pnr | String | data | |
c_TextField_2401 | 客户自定义字段1 | String | data | |
c_TextField_2402 | 客户自定义字段2 | String | data | |
c_TextField_2403 | 客户自定义字段3 | String | data | |
c_TextField_2404 | 客户自定义字段4 | String | data | |
c_TextField_2405 | 客户自定义字段5 | String | data | |
c_TextField_2406 | 客户自定义字段6 | String | data | |
c_TextField_2407 | 客户自定义字段7 | String | data | |
c_TextField_2408 | 客户自定义字段8 | String | data | |
totalPrice | 当前订单总金额 | Number | data | |
opId | 制单人旅客编号 | String | data | |
onBusiness | 订单类型(1:因公;0:因私) 注意:如果因私订单不需要的,记得接收时过滤掉 | Integer | data | |
orderRemark | 订单备注 | String | data | |
outsideOrderNo | 客户订单号 | String | data | |
orderNo | 美亚订单号 | String | data | |
originalOrderNo | 美亚原订单号 | String | data | |
opStaffCode | 客户制单人工号 | String | data | |
opName | 客户制单人 | String | data | |
opDate | 下单时间(yyyy-MM-dd HH:mm:ss) | String | data | |
statusText | 订单状态(名称) | String | data | |
issueDate | 出票日期(yyyy-MM-dd HH:mm:ss) | String | data | |
oaSerialnumber | 客户出差申请单号 | String | data | |
stApplyOrderNo | 美亚出差申请单号 | String | data | |
contactInfo | 联系人信息 | OrderPushContactinfo | data | |
contactName | 联系人姓名 | String | data.contactInfo | |
mobile | 手机号 | String | data.contactInfo | |
phone | 固定电话 | String | data.contactInfo | |
邮箱 | String | data.contactInfo | ||
policyList | 出差政策列表 | Array[] | data | |
passengerCode | 旅客编号 | String | data.policyList | |
staffCode | 旅客编号 | String | data.policyList | |
passengerName | 旅客姓名 | String | data.policyList | |
policyName | 政策名称 | String | data.policyList | |
policyProperty | 属性(建议/强制) | String | data.policyList | |
policyType | 基础/分类/个人/附加 | String | data.policyList | |
costList | 成本中心 | Array[] | data | |
remark | 备注 | String | data.costList | |
staffCode | 员工工号 | String | data.costList | |
passengerCode | 旅客编号 | String | data.costList | |
passengerName | 旅客名称 | String | data.costList | |
costId | 成本中心编号 | Integer | data.costList | |
costCenterName | 成本中心名称 | String | data.costList | |
amount | 成本金额 | Number | data.costList | |
priceList | 价格信息 | Array[] | data | |
ticketPrice | 票价 | Number | data.priceList | |
priceDifferential | (新-旧)差价 | Number | data.priceList | |
changeReturnPrice |
改签差额退费费
添加日期: 2024-05-08 |
Number | data.priceList | |
servicePrice | 服务费 | Number | data.priceList | |
commissionPrice | 改签/退票手续费 | Number | data.priceList | |
passengerCode | 旅客编号 | String | data.priceList | |
passengerName | 旅客姓名 | String | data.priceList | |
staffCode | 员工工号 | String | data.priceList | |
ExcessFee | 超额部分 | Number | data.priceList | |
passengerNo |
旅客排序号(跟passengerList的对应)
添加日期: 2025-03-26 |
Integer | data.priceList | |
trainInfo | 火车票信息 | OrderPushTrainInfo | data | |
trainNo |
火车票车次排序号(以1开头)
中转时用到
添加日期: 2025-03-26 |
Integer | data.trainInfo | |
trainNumber | 车次号 | String | data.trainInfo | |
fromStation | 出发站 | String | data.trainInfo | |
toStation | 到达站 | String | data.trainInfo | |
departureTime | 出发时间(yyyy-MM-dd HH:mm) | String | data.trainInfo | |
arriveTime | 到达时间(yyyy-MM-dd HH:mm) | String | data.trainInfo | |
trainType | 列车类型 | String | data.trainInfo | |
seatLevel | 席位类型(如:二等座) | String | data.trainInfo | |
ticketGate |
检票口
添加日期: 2022-08-23 |
String | data.trainInfo | |
fromCityName | 出发城市 | String | data.trainInfo | |
toCityName | 到达城市 | String | data.trainInfo | |
trainInfoList | 火车票信息列表 | Array[] | data | |
trainNo |
火车票车次排序号(以1开头)
中转时用到
添加日期: 2025-03-26 |
Integer | data.trainInfoList | |
trainNumber | 车次号 | String | data.trainInfoList | |
fromStation | 出发站 | String | data.trainInfoList | |
toStation | 到达站 | String | data.trainInfoList | |
departureTime | 出发时间(yyyy-MM-dd HH:mm) | String | data.trainInfoList | |
arriveTime | 到达时间(yyyy-MM-dd HH:mm) | String | data.trainInfoList | |
trainType | 列车类型 | String | data.trainInfoList | |
seatLevel | 席位类型(如:二等座) | String | data.trainInfoList | |
ticketGate |
检票口
添加日期: 2022-08-23 |
String | data.trainInfoList | |
fromCityName | 出发城市 | String | data.trainInfoList | |
toCityName | 到达城市 | String | data.trainInfoList | |
passengerList | 旅客信息 | Array[] | data | |
reasonId | 差旅政策违反原因序号 | Integer | data.passengerList | |
reasonRemark | 差旅政策违反原因 | String | data.passengerList | |
errorMessage | 退票失败原因(订单为火车票时有值) | String | data.passengerList | |
returnStatus | 出票状况(订单为火车票时有值) | String | data.passengerList | |
seatNo | 座席号(订单为火车票时有值) | String | data.passengerList | |
originalTicketNo | 机票/火车票原票号(改签单时有值) | String | data.passengerList | |
belongToProject |
归属项目
添加日期: 2023-11-21 |
String | data.passengerList | |
travelPurpose |
出行目的
添加日期: 2023-11-21 |
String | data.passengerList | |
passengerNo | 旅客排序号(从1开始递增) | Integer | data.passengerList | |
passengerCode | 旅客编号 | String | data.passengerList | |
passengerName | 旅客姓名 | String | data.passengerList | |
certificateType | 证件类型 | String | data.passengerList | |
certificateId | 证件号码 | String | data.passengerList | |
passengerType | 旅客类型(成人/儿童/婴儿) | String | data.passengerList | |
ticketNo | 机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系) | String | data.passengerList | |
staffCode | 员工工号 | String | data.passengerList | |
mobile | 旅客手机号码 | String | data.passengerList | |
旅客邮箱,国际机票使用 | String | data.passengerList | ||
statusDesc | 客票状态描述 | String | data.passengerList | |
ticketStatus | 票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到 | String | data.passengerList | |
depName |
部门名称,用/分隔(列表返回最后一级,详细返回全级)
添加日期: 2018-10-18 |
String | data.passengerList | |
belongToCenter |
归属中心
添加日期: 2023-11-21 |
Array[] | data.passengerList | |
centerNo |
序号
添加日期: 2023-11-21 |
Integer | data.passengerList.belongToCenter | |
centerTitle |
归属中心标题
添加日期: 2023-11-21 |
String | data.passengerList.belongToCenter | |
centerName |
归属成本中心选项值
添加日期: 2023-11-21 |
String | data.passengerList.belongToCenter |
{
"data":
{
"StaffPayExcess":false, //个人承担费用,=true 为存在个人承担,false
"PolicyExcessAmount":0.0, //StaffPayExcess=true 时需要关注,个人承担的金额,否则为 0;
"CompanyExcessAmount":818, //StaffPayExcess=true 时需要关注,公司承担的金额;
"trainInfo":
{
"trainNo":0, //火车票车次排序号(以1开头)
中转时用到
"trainNumber":"C8001", //车次号
"fromStation":"广州东", //出发站
"toStation":"深圳", //到达站
"departureTime":"2023-10-21 07:00", //出发时间(yyyy-MM-dd HH:mm)
"arriveTime":"2023-10-21 08:06", //到达时间(yyyy-MM-dd HH:mm)
"trainType":"C", //列车类型
"seatLevel":"二等座", //席位类型(如:二等座)
"ticketGate":"检票口B6", //检票口
"fromCityName":"广州", //出发城市
"toCityName":"深圳", //到达城市
}, //火车票信息
"trainInfoList":
[{
"trainNo":0, //火车票车次排序号(以1开头)
中转时用到
"trainNumber":"C8001", //车次号
"fromStation":"广州东", //出发站
"toStation":"深圳", //到达站
"departureTime":"2023-10-21 07:00", //出发时间(yyyy-MM-dd HH:mm)
"arriveTime":"2023-10-21 08:06", //到达时间(yyyy-MM-dd HH:mm)
"trainType":"C", //列车类型
"seatLevel":"二等座", //席位类型(如:二等座)
"ticketGate":"检票口B6", //检票口
"fromCityName":"广州", //出发城市
"toCityName":"深圳", //到达城市
}], //火车票信息列表
"priceList":
[{
"ticketPrice":80, //票价
"priceDifferential":0, //(新-旧)差价
"changeReturnPrice":0, //改签差额退费费
"servicePrice":12, //服务费
"commissionPrice":0, //改签/退票手续费
"passengerCode":"P839920", //旅客编号
"passengerName":"金常诺", //旅客姓名
"staffCode":"AL35885", //员工工号
"ExcessFee":10, //超额部分
"passengerNo":0, //旅客排序号(跟passengerList的对应)
}], //价格信息
"status":5, //订单状态
"deadLineTime":"2023/11/25 0:00:00", //价格有效期(改签单和退票单时,订单需在价格有效期内提交订单,过了有效期会提交订单失败)
"tripId": "", //行程编号
"companyId":"S117955", //公司编号
"failureReason": "", //订单失败原因
"oaOtherInfo":"zjm485215588", //其他信息,个性化客户需要(比如:中奖码)
"firstOrderNo":"TB2024000154", //美亚原购单号
"orderSource":3, //订单来源
"receivePayType":"月结", //支付方式
"affiliateBusinessName":"广东美亚商旅科技有限公司", //供应商
"pnr": "", //pnr
"passengerList":
[{
"reasonId":0, //差旅政策违反原因序号
"reasonRemark": "", //差旅政策违反原因
"errorMessage": "", //退票失败原因(订单为火车票时有值)
"returnStatus": "", //出票状况(订单为火车票时有值)
"seatNo": "", //座席号(订单为火车票时有值)
"originalTicketNo": "", //机票/火车票原票号(改签单时有值)
"belongToCenter":
[{
"centerNo":0, //序号
"centerTitle": "", //归属中心标题
"centerName": "", //归属成本中心选项值
}], //归属中心
"belongToProject": "", //归属项目
"travelPurpose": "", //出行目的
"passengerNo":1, //旅客排序号(从1开始递增)
"passengerCode":"P827827", //旅客编号
"passengerName":"张宇宇", //旅客姓名
"certificateType":"因公护照", //证件类型
"certificateId":"562233", //证件号码
"passengerType":"成人", //旅客类型(成人/儿童/婴儿)
"ticketNo":"2", //机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系)
"staffCode":"WBDDH002", //员工工号
"mobile": "", //旅客手机号码
"email": "", //旅客邮箱,国际机票使用
"statusDesc": "", //客票状态描述
"ticketStatus": "", //票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到
"depName":"0922部门/0922", //部门名称,用/分隔(列表返回最后一级,详细返回全级)
}], //旅客信息
"costList":
[{
"remark": "", //备注
"staffCode": "", //员工工号
"passengerCode":"P409149", //旅客编号
"passengerName":"陈军凤", //旅客名称
"costId":163939, //成本中心编号
"costCenterName":"董事会", //成本中心名称
"amount":240.00, //成本金额
}], //成本中心
"contactInfo":
{
"contactName":"张宇宇", //联系人姓名
"mobile":"15617929598", //手机号
"phone": "", //固定电话
"email":"St87875@meiya.com", //邮箱
}, //联系人信息
"policyList":
[{
"passengerCode":"P415090", //旅客编号
"staffCode":"董事会", //旅客编号
"passengerName":"WBDDH001", //旅客姓名
"policyName":"机票差旅政策一", //政策名称
"policyProperty":"强制", //属性(建议/强制)
"policyType":"基础", //基础/分类/个人/附加
}], //出差政策列表
"c_TextField_2401": "", //客户自定义字段1
"c_TextField_2402": "", //客户自定义字段2
"c_TextField_2403": "", //客户自定义字段3
"c_TextField_2404": "", //客户自定义字段4
"c_TextField_2405": "", //客户自定义字段5
"c_TextField_2406": "", //客户自定义字段6
"c_TextField_2407": "", //客户自定义字段7
"c_TextField_2408": "", //客户自定义字段8
"totalPrice":818.00, //当前订单总金额
"opId": "", //制单人旅客编号
"onBusiness":0, //订单类型(1:因公;0:因私) 注意:如果因私订单不需要的,记得接收时过滤掉
"orderRemark":"订单备注", //订单备注
"outsideOrderNo":"jd20231011022", //客户订单号
"orderNo":"HB2300004135", //美亚订单号
"originalOrderNo": "", //美亚原订单号
"opStaffCode":"WBDDH001", //客户制单人工号
"opName":"张宇宇", //客户制单人
"opDate":"2023-10-20 11:24:26", //下单时间(yyyy-MM-dd HH:mm:ss)
"statusText":"处理成功", //订单状态(名称)
"issueDate":"zjm485215588", //出票日期(yyyy-MM-dd HH:mm:ss)
"oaSerialnumber":"SL58445577484", //客户出差申请单号
"stApplyOrderNo":"EC230005785", //美亚出差申请单号
}, //订单信息
"orderType":70, //订单类型
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
originalOrderNo | 美亚订购单号 | String | 否 | |
outsideReturnOrderNo | 外部退票单号 | String | 否 | |
reason | 退票原因 | String | 否 | |
userName | 12306 账号 | String | 是 | |
password | 12306 密码 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
passengerList | 旅客列表 | Array[] | 否 | |
passengerName | 姓名 | String | passengerList | |
passengerCertNo | 证件号码 | String | passengerList | |
passengerCertType | 证件类型 | String | passengerList | |
chooseSeatNo | 在线选座--改签有值 | String | passengerList | |
contactInfo | 退票单联系人信息 | ContactInfo | 否 | |
contactName | 联系人 | String | contactInfo | |
mobile | 手机号码 | String | contactInfo | |
phone | 联系电话 | String | contactInfo | |
电子邮件 | String | contactInfo |
{
"originalOrderNo":"RB230055154", //美亚订购单号
"outsideReturnOrderNo":"HCP230005145", //外部退票单号
"passengerList":
[{
"passengerName":"刘展超", //姓名
"passengerCertNo":"440183********0225", //证件号码
"passengerCertType":"身份证", //证件类型
"chooseSeatNo": "", //在线选座--改签有值
}], //旅客列表
"reason":"个人原因,取消行程", //退票原因
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //退票单联系人信息
"userName":"liuzhanchao@163.com", //12306 账号
"password":"liuzhanchao123456", //12306 密码
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 退票单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo":"RR2300001542", //退票单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单编号, 共用的实体,订单号展示只做示例 | String | 是 | |
cancelReasonId | Integer | 否 | ||
cancelReason | 取消原因 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //订单编号, 共用的实体,订单号展示只做示例
"cancelReasonId":0, //
"cancelReason": "", //取消原因
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
originalOrderNo | 原订单号 | String | 否 | |
outSideOrderNo | 外部订购单号 | String | 否 | |
oaSerialnumber | 出差申请单号 | String | 否 | |
trainNumber | 车次号 | String | 否 | |
trainType | 预订车型 | String | 否 | |
fromStationName | 出发站 | String | 否 | |
fromStationCode | 出发站 | String | 否 | |
startDate | 出发日期 | String | 否 | |
startTime | 出发时间 | String | 否 | |
toStationCode | 到达站 | String | 否 | |
toStationName | 到达站 | String | 否 | |
arrivalDate | 到达日期 | String | 否 | |
arrivalTime | 到达时间 | String | 否 | |
bookType | 预订类型 | String | 否 | |
queryKey | queryKey | String | 否 | |
isSubmit | 是否同时提交 | Boolean | 否 | |
reason | 改签原因 | String | 否 | |
userName | 12306 账号 | String | 是 | |
password | 12306 密码 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
seatInfo | 席位信息 | ApiTrainSeatInfo | 否 | |
seatPrice | 席位参考票价 | Number | seatInfo | |
seatName | 座位名称 软座/硬座等 | String | seatInfo | |
passengerList | 旅客信息 | Array[] | 否 | |
passengerName | 姓名 | String | passengerList | |
passengerCertNo | 证件号码 | String | passengerList | |
passengerCertType | 证件类型 | String | passengerList | |
chooseSeatNo | 在线选座--改签有值 | String | passengerList | |
contactInfo | 联系人信息 | ContactInfo | 否 | |
contactName | 联系人 | String | contactInfo | |
mobile | 手机号码 | String | contactInfo | |
phone | 联系电话 | String | contactInfo | |
电子邮件 | String | contactInfo |
{
"originalOrderNo":"RB230004574", //原订单号
"outSideOrderNo":"HCP23005440", //外部订购单号
"oaSerialnumber":"HCP23005440", //出差申请单号
"trainNumber":"K78", //车次号
"trainType": "", //预订车型
"fromStationName":"广州南", //出发站
"fromStationCode": "", //出发站
"startDate":"2023-10-25", //出发日期
"startTime":"10:28", //出发时间
"toStationCode": "", //到达站
"toStationName":"深圳北", //到达站
"arrivalDate":"2023-10-25", //到达日期
"arrivalTime":"12:38", //到达时间
"seatInfo":
{
"seatPrice":157.00, //席位参考票价
"seatName":"二等座", //座位名称 软座/硬座等
}, //席位信息
"passengerList":
[{
"passengerName":"刘展超", //姓名
"passengerCertNo":"440183********0225", //证件号码
"passengerCertType":"身份证", //证件类型
"chooseSeatNo": "", //在线选座--改签有值
}], //旅客信息
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"bookType": "", //预订类型
"queryKey":"f66a058d3571479d82b625626aaf7092", //queryKey
"isSubmit":false, //是否同时提交
"reason":"开会时间变更", //改签原因
"userName":"liuzhanchao@163.com", //12306 账号
"password":"liuzhanchao123456", //12306 密码
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 改签单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo":"RC230000125", //改签单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单编号, 共用的实体,订单号展示只做示例 | String | 是 | |
cancelReasonId | Integer | 否 | ||
cancelReason | 取消原因 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //订单编号, 共用的实体,订单号展示只做示例
"cancelReasonId":0, //
"cancelReason": "", //取消原因
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号 | String | 否 | |
trainNumber | 改签车次号 | String | 否 | |
startDate | 改签车次出发日期 | String | 否 | |
seatName | 改签车次座位名称 软座/硬座等 | String | 否 | |
toStationName | 到达站 | String | 否 | |
fromStationName | 出发站 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo": "", //美亚订单号
"trainNumber": "", //改签车次号
"startDate": "", //改签车次出发日期
"seatName": "", //改签车次座位名称 软座/硬座等
"toStationName": "", //到达站
"fromStationName": "", //出发站
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
totalChangeCost | 总 改签手续费, | Number | ||
totalChangeDiffReturnCost | 总 改签退票费 | Number | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
priceDetail | 费用详细 | Array[] | ||
ticketNo | 票号 | String | priceDetail | |
passengersName | 旅客姓名 | String | priceDetail | |
outsidePassengerId | 旅客编号是指对接方系统的旅客编号 | String | priceDetail | |
changeCost | 改签手续费, | Number | priceDetail | |
changeDiffReturnCost | 改签退票费, | Number | priceDetail |
{
"totalChangeCost":0, //总 改签手续费,
"totalChangeDiffReturnCost":0, //总 改签退票费
"priceDetail":
[{
"ticketNo": "", //票号
"passengersName": "", //旅客姓名
"outsidePassengerId": "", //旅客编号是指对接方系统的旅客编号
"changeCost":0, //改签手续费,
"changeDiffReturnCost":0, //改签退票费,
}], //费用详细
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
用车订单列表
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单号 | String | 否 | |
contactName | 用车人(全名) | String | 否 | |
phone | 用车人手机号 | String | 否 | |
startTime | 制单时间范围(开始) yyyy-MM-dd HH:mm:ss | String | 否 | |
endTime | 制单时间范围(结束) yyyy-MM-dd HH:mm:ss | String | 否 | |
startIssueTime | 处理时间范围(开始) yyyy-MM-dd HH:mm:ss | String | 否 | |
endIssueTime | 处理时间范围(结束) yyyy-MM-dd HH:mm:ss | String | 否 | |
orderStatus |
订单状态
0 全部 40 已处理 50 已取消 10 处理中 |
Integer | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数(最大50) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"OO2300025008", //订单号
"contactName":"刘展超", //用车人(全名)
"phone":"18652554855", //用车人手机号
"startTime":"2023-10-11", //制单时间范围(开始) yyyy-MM-dd HH:mm:ss
"endTime":"2023-10-13", //制单时间范围(结束) yyyy-MM-dd HH:mm:ss
"startIssueTime": "", //处理时间范围(开始) yyyy-MM-dd HH:mm:ss
"endIssueTime": "", //处理时间范围(结束) yyyy-MM-dd HH:mm:ss
"orderStatus":OO2300025008, //订单状态
"pageIndex":1, //页码
"pageSize":100, //每页记录数(最大50)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
totalCount | 总记录数 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
orderList | Array[] | |||
companyId | 公司编号 | String | orderList | |
orderNo | 订单编号 | String | orderList | |
totalPrice | 当前订单总金额 | Number | orderList | |
status | 订单状态 | String | orderList | |
productTypeName | 产品类型 | String | orderList | |
productSubTypeName | 产品子类型 | String | orderList | |
productName | 产品名称 | String | orderList | |
opId | 制单人旅客编号 | String | orderList | |
opName | 客户制单人 | String | orderList | |
opDate | 制单时间 | String | orderList | |
issueDate | 处理时间 | String | orderList | |
oaSerialnumber | 客户出差申请单号 | String | orderList | |
cityName | 出发城市 | String | orderList | |
origincityName | 出发城市名称 | String | orderList | |
destinationCity | 目的地城市 | String | orderList | |
destinationCityName | 目的地城市名称 | String | orderList | |
onBusiness | 订单类型(1:因公;0:因私) | String | orderList | |
receivePayType | 月结/现付,0-月结,1-现付 | String | orderList | |
productDetail | 产品信息 | String | orderList | |
staffCode | 员工工号 | String | orderList | |
depName | 部门名称 | String | orderList | |
priceInfo | ApiCarOrderPriceInfo | orderList | ||
totalPrice | 用车费用(元) | Number | orderList.priceInfo | |
servicePirce | 服务费 | Number | orderList.priceInfo | |
contactInfo | 联系人信息 | OrderPushContactinfo | orderList | |
contactName | 联系人姓名 | String | orderList.contactInfo | |
mobile | 手机号 | String | orderList.contactInfo | |
phone | 固定电话 | String | orderList.contactInfo | |
邮箱 | String | orderList.contactInfo | ||
tripInfo | 行程信息 | ApiCarOrderTripInfo | orderList | |
startAddress | 出发地 | String | orderList.tripInfo | |
endAddress | 目的地 | String | orderList.tripInfo | |
iReason | 用车事由 | String | orderList.tripInfo | |
customerRemark | 用车事由备注 | String | orderList.tripInfo | |
status | 用车状态(名称) | String | orderList.tripInfo | |
supplierName | 服务商(名称) | String | orderList.tripInfo | |
startServiceTime | 出发时间 | String | orderList.tripInfo | |
endServiceTime | 到达时间 | String | orderList.tripInfo | |
cancelTime | 取消时间 | String | orderList.tripInfo | |
distanceKM | 全程距离(KM) | String | orderList.tripInfo | |
durationMin | 全程时长(分钟) | String | orderList.tripInfo | |
totalPrice | 用车费用(元) | Number | orderList.tripInfo | |
vehicleInfo | 车辆信息 | String | orderList.tripInfo | |
vehicleName | 车型 | String | orderList.tripInfo |
{
"totalCount":82, //总记录数
"orderList":
[{
"companyId":"S117969", //公司编号
"orderNo":"OO2300007760", //订单编号
"totalPrice":22.32, //当前订单总金额
"status":"已处理", //订单状态
"productTypeName":"用车", //产品类型
"productSubTypeName":"国内用车", //产品子类型
"productName":"实时用车", //产品名称
"opId":"P157455", //制单人旅客编号
"opName":"刘展超", //客户制单人
"opDate":"2023-10-19 13:54:56", //制单时间
"issueDate":"2023-10-19 14:46:34", //处理时间
"oaSerialnumber":"YC07760", //客户出差申请单号
"cityName":"上海", //出发城市
"origincityName": "", //出发城市名称
"destinationCity": "", //目的地城市
"destinationCityName": "", //目的地城市名称
"onBusiness":"1", //订单类型(1:因公;0:因私)
"receivePayType":"1", //月结/现付,0-月结,1-现付
"productDetail":"2023-10-19 13:54 重庆南路227号-南京东路20号,实时用车", //产品信息
"staffCode":"CS1213", //员工工号
"depName":"综合计划部", //部门名称
"contactInfo":
{
"contactName":"张宇宇", //联系人姓名
"mobile":"15617929598", //手机号
"phone": "", //固定电话
"email":"St87875@meiya.com", //邮箱
}, //联系人信息
"tripInfo":
{
"startAddress":"重庆南路227号", //出发地
"endAddress":"南京东路20号", //目的地
"iReason": "", //用车事由
"customerRemark": "", //用车事由备注
"status":"已成交", //用车状态(名称)
"supplierName":"享道出行", //服务商(名称)
"startServiceTime":"2023-10-19 14:01:10", //出发时间
"endServiceTime":"2023-10-19 14:01:36", //到达时间
"cancelTime": "", //取消时间
"distanceKM":"4.4", //全程距离(KM)
"durationMin":"0", //全程时长(分钟)
"totalPrice":22.32, //用车费用(元)
"vehicleInfo":"经济型", //车辆信息
"vehicleName":"经济型|桂DTL219 棕色 名爵6", //车型
}, //行程信息
"priceInfo":
{
"totalPrice":22.32, //用车费用(元)
"servicePirce":0.00, //服务费
}, //
}], //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
酒店账单查询
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
settleSerialNo | 结算批次号(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
settletTimeStart | 结算时间-开始((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
settletTimeEnd | 结算时间-结束((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
purchaseTimeStart | 消费时间-开始((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
purchaseTimeEnd | 消费时间-结束(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
orderNo | 订单编号 | String | 否 | |
productType |
产品类型:默认 DH
DH 国内酒店 IH 海外(国际)酒店 |
String | 否 | |
recordIds | 消费记录编号(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | Array[] | 否 | |
billingPeriod | 账期,如 202401 (消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数(最大500) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"settleSerialNo": "",
"settletTimeStart":"2023-09-27",
"settletTimeEnd":"2023-10-27",
"purchaseTimeStart":"2023-09-27",
"purchaseTimeEnd":"2023-10-27",
"orderNo": "",
"productType": "",
"recordIds":"[“AA”,“BB”]",
"billingPeriod": "",
"pageIndex":1,
"pageSize":200,
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
IsSucceed | 是否成功查询 | Boolean | ||
ErrorMsgID | 错误信息标志号 0-正常 | Integer | ||
ErrorMsg | 错误信息 | String | ||
TotalCount | Integer | |||
PageIndex | 页面索引 | Integer | ||
PageSize | 页大小 | Integer | ||
HotelSettleInfoList | Array[] | |||
RecordId | 消费记录编号 | String | HotelSettleInfoList | |
OrderNo | 订单编号 | String | HotelSettleInfoList | |
CompanyId | 客户编码 | String | HotelSettleInfoList | |
CompanyName | 客户名称 | String | HotelSettleInfoList | |
GroupId | 集团编码 | String | HotelSettleInfoList | |
GroupName | 集团名称 | String | HotelSettleInfoList | |
OaSerialNumber | 出差申请单号 | String | HotelSettleInfoList | |
PayType | 消费支付类型:1:信用消费2:即付消费 | Integer | HotelSettleInfoList | |
CardId | 信用卡号 | String | HotelSettleInfoList | |
CardIdLast | 信用卡号末4位 | String | HotelSettleInfoList | |
SettleSerialNo | 结算批次号 | String | HotelSettleInfoList | |
SettleStatus | 对账状态:待核对-1 待推送-2 推送中-3 待确认(推送成功)-4 已确认-5 推送失败-6 关账-7 | Integer | HotelSettleInfoList | |
BillBeginning | 账单起始日期 | String | HotelSettleInfoList | |
BillDeadLine | 账单截止日期 | String | HotelSettleInfoList | |
BillDate | 出账日期 | String | HotelSettleInfoList | |
ExpireDate | 到期还款日 | String | HotelSettleInfoList | |
CustomerRemark | 客户备注 | String | HotelSettleInfoList | |
SettleTime | 结算生成时间 | String | HotelSettleInfoList | |
RebackOrderNo | 关联单号 | String | HotelSettleInfoList | |
OpDate | 预订时间 | String | HotelSettleInfoList | |
ProcessTime | 处理时间 | String | HotelSettleInfoList | |
OrderType | 订单类型 1订购单、2变更单、3退订单、4调整单、5积分单、102计费单 报价单订单类型 11报价订购单 12报价变更单 13报价退订单 | Integer | HotelSettleInfoList | |
BookingType | 出差性质 -1 无 0是因公 1是因私 | Integer | HotelSettleInfoList | |
OrderSource | 订单来源 | String | HotelSettleInfoList | |
BookingChannelName | 预订渠道 | String | HotelSettleInfoList | |
OpId | 客户制单人Id | String | HotelSettleInfoList | |
OpName | 客户制单人名称 | String | HotelSettleInfoList | |
OpDepartment | 客户制单人部门 | String | HotelSettleInfoList | |
OpOrganization | 客户制单人组织架构 | String | HotelSettleInfoList | |
CustomerCreatorEmployeeNo | 客户制单人员工工号 | String | HotelSettleInfoList | |
TimeSubmissionAapproval | 提交审批时间 | String | HotelSettleInfoList | |
Currency | 结算币种 | String | HotelSettleInfoList | |
FinalJudge | 终审人 | String | HotelSettleInfoList | |
FinalReviewTime | 终审时间 | String | HotelSettleInfoList | |
CommentsBehalfApproval | 代审批备注 | String | HotelSettleInfoList | |
UnitRoomPrice | 房费单价 | String | HotelSettleInfoList | |
ProductSubType | 酒店类型 | Integer | HotelSettleInfoList | |
ProductSubTypeName | 酒店类型名称 | String | HotelSettleInfoList | |
ProductName | 酒店名称(中文) | String | HotelSettleInfoList | |
ProductNameEn | 酒店名称(英文) | String | HotelSettleInfoList | |
ProductNature | 酒店性质 | String | HotelSettleInfoList | |
ProductPaymentMethod | 酒店支付类型 | String | HotelSettleInfoList | |
ProductLevel | 星级 | String | HotelSettleInfoList | |
RoomType | 房型 | String | HotelSettleInfoList | |
BreakFast | 早餐 | String | HotelSettleInfoList | |
WorldRegion | 区域 | String | HotelSettleInfoList | |
VisaCountry | 国家/地区 | String | HotelSettleInfoList | |
StateProvince | 省份/州 | String | HotelSettleInfoList | |
DepartureCity | 酒店所在城市(中文) | String | HotelSettleInfoList | |
PlaceDepartureCityEn | 酒店所在城市(英文) | String | HotelSettleInfoList | |
ReceivableFee | 应收 | Number | HotelSettleInfoList | |
TOrderNo | 订购单号 | String | HotelSettleInfoList | |
TRType | 退票类型 NF:改期退票拆分不是第一条数据(需要将旅客中间表金额字段处理为0,再返回数据给客户) | String | HotelSettleInfoList | |
RecordIdMin | 改期退票最小消费记录编号 | String | HotelSettleInfoList | |
MergePayAmountRmb | 合并后消费金额(CNY)(国内机票退票单多条消费记录) | Number | HotelSettleInfoList | |
VersionNumber | 版本号 | Integer | HotelSettleInfoList | |
CustomerFields1 | 客户字段1 c_TextField_2401 | String | HotelSettleInfoList | |
CustomerFields2 | 客户字段2 c_TextField_2402 | String | HotelSettleInfoList | |
CustomerFields3 | 客户字段3 c_TextField_2403 | String | HotelSettleInfoList | |
CustomerFields4 | 客户字段4 c_TextField_2404 | String | HotelSettleInfoList | |
CustomerFields5 | 客户字段5 c_TextField_2405 | String | HotelSettleInfoList | |
CustomerFields6 | 客户字段6 c_TextField_2406 | String | HotelSettleInfoList | |
CustomerFields7 | 客户字段7 c_TextField_2407 | String | HotelSettleInfoList | |
CustomerFields8 | 客户字段8 c_TextField_2408 | String | HotelSettleInfoList | |
HotelSettlePsngrList | 结算明细关联旅客列表 | Array[] | HotelSettleInfoList | |
RecordId | 消费记录编号 | String | HotelSettleInfoList.HotelSettlePsngrList | |
OrderNo | 订单编号 | String | HotelSettleInfoList.HotelSettlePsngrList | |
PassengerNo | 旅客编号 | String | HotelSettleInfoList.HotelSettlePsngrList | |
FaceValuePrice | 房费总额 | Number | HotelSettleInfoList.HotelSettlePsngrList | |
TaxationFee | 税费 | Number | HotelSettleInfoList.HotelSettlePsngrList | |
ExtrabedFee | 加床费 | Number | HotelSettleInfoList.HotelSettlePsngrList | |
MealCost | 餐费 | Number | HotelSettleInfoList.HotelSettlePsngrList | |
ServiceCharge | 服务费 | Number | HotelSettleInfoList.HotelSettlePsngrList | |
CancellationFee | 退房手续费 | Number | HotelSettleInfoList.HotelSettlePsngrList | |
CashbackAmount | 返现 | Number | HotelSettleInfoList.HotelSettlePsngrList | |
OverStandardIndividualCommitment | 个人承担金额 | Number | HotelSettleInfoList.HotelSettlePsngrList | |
DepartTime | 实际入住日期 | String | HotelSettleInfoList.HotelSettlePsngrList | |
ArriveTime | 实际离店日期 | String | HotelSettleInfoList.HotelSettlePsngrList | |
ActualRoomsNumber | 实际入住间数 | Integer | HotelSettleInfoList.HotelSettlePsngrList | |
ActualNights | 实际入住晚数 | Integer | HotelSettleInfoList.HotelSettlePsngrList | |
ActualRoomNights | 实际入住间晚数 | Integer | HotelSettleInfoList.HotelSettlePsngrList | |
TravelPolicyViolations | 违反差旅政策项目 | String | HotelSettleInfoList.HotelSettlePsngrList | |
ReasonsViolatingTravelPolicy | 违反差旅政策原因 | String | HotelSettleInfoList.HotelSettlePsngrList | |
PassengerName | 旅客姓名 | String | HotelSettleInfoList.HotelSettlePsngrList | |
PassengerNameCn | 旅客中文名 | String | HotelSettleInfoList.HotelSettlePsngrList | |
PassengerStaffNo | 旅客员工工号 | String | HotelSettleInfoList.HotelSettlePsngrList | |
PassengerCertificateNo | 旅客证件号 | String | HotelSettleInfoList.HotelSettlePsngrList | |
PassengerOrganizational | 旅客组织架构 | String | HotelSettleInfoList.HotelSettlePsngrList | |
PassengerCostCenterCode | 成本中心编号 | String | HotelSettleInfoList.HotelSettlePsngrList | |
PassengerCostCenter | 成本中心名称 | String | HotelSettleInfoList.HotelSettlePsngrList | |
PassengerCostCenterRemark | 成本中心备注 | String | HotelSettleInfoList.HotelSettlePsngrList | |
PassengerCostCenterPrice | 旅客成本中心金额 | Number | HotelSettleInfoList.HotelSettlePsngrList | |
PassengerType | 旅客类型 | String | HotelSettleInfoList.HotelSettlePsngrList | |
PassengerCostCenterFullLevel | 成本中心(全级) | String | HotelSettleInfoList.HotelSettlePsngrList |
{
"HotelSettleInfoList":
[{
"HotelSettlePsngrList":
[{
"RecordId":"XF230000030505",
"OrderNo":"HR2300001378",
"PassengerNo":"P852494",
"FaceValuePrice":-256.00,
"TaxationFee":0.00,
"ExtrabedFee":0.00,
"MealCost":0.00,
"ServiceCharge":0.00,
"CancellationFee":0.00,
"CashbackAmount":0.00,
"OverStandardIndividualCommitment":0.00,
"DepartTime":"2023-10-12T00:00:00",
"ArriveTime":"2023-10-13T00:00:00",
"ActualRoomsNumber":1,
"ActualNights":1,
"ActualRoomNights":1,
"TravelPolicyViolations": "",
"ReasonsViolatingTravelPolicy": "",
"PassengerName":"邱宝萍",
"PassengerNameCn":"邱宝萍",
"PassengerStaffNo":"60245",
"PassengerCertificateNo": "",
"PassengerOrganizational":"部门",
"PassengerCostCenterCode": "",
"PassengerCostCenter": "",
"PassengerCostCenterRemark": "",
"PassengerCostCenterPrice":0,
"PassengerType":"成人",
"PassengerCostCenterFullLevel": ""
}],
"RecordId":"XF230000030505",
"OrderNo":"HR2300001378",
"CompanyId":"S118022",
"CompanyName":"美亚测试股份有限公司",
"GroupId":"G112178",
"GroupName":"OA对接专用集团",
"OaSerialNumber":"无",
"PayType":1,
"CardId":"CC220000011",
"CardIdLast":"0011",
"SettleSerialNo": "",
"SettleStatus":0,
"BillBeginning":"0001-01-01T00:00:00",
"BillDeadLine":"0001-01-01T00:00:00",
"BillDate":"0001-01-01T00:00:00",
"ExpireDate":"0001-01-01T00:00:00",
"CustomerRemark": "",
"SettleTime":"2023-10-09T18:05:21",
"RebackOrderNo":"HB2300003883",
"OpDate":"2023-10-09T18:05:18",
"ProcessTime":"2023-10-09T18:05:21",
"OrderType":3,
"BookingType":0,
"OrderSource":"在线预订",
"BookingChannelName":"PC端对接",
"OpId":"P767609",
"OpName":"东方不败",
"OpDepartment":"部门",
"OpOrganization":"部门",
"CustomerCreatorEmployeeNo":"123456",
"TimeSubmissionAapproval":"2023-10-09T18:05:20",
"Currency":"CNY",
"FinalJudge":"系统自动",
"FinalReviewTime":"0001-01-01T00: 00:00",
"CommentsBehalfApproval": "",
"UnitRoomPrice": "",
"ProductSubType":3,
"ProductSubTypeName":"国内酒店",
"ProductName":"广州骏业酒店(科学城佳大店)",
"ProductNameEn": "",
"ProductNature":"外采产品",
"ProductPaymentMethod":"预付",
"ProductLevel":"四星级/高档型",
"RoomType":"特惠大床房",
"BreakFast":"无早",
"WorldRegion":"中国大陆",
"VisaCountry":"中国",
"StateProvince":"广东省",
"DepartureCity":"广州",
"PlaceDepartureCityEn":"GuangZhou",
"ReceivableFee":-256.00,
"TOrderNo":"HB2300003883",
"TRType": "",
"RecordIdMin":"XF230000030505",
"MergePayAmountRmb":-256.00,
"VersionNumber":8446315,
"CustomerFields1": "",
"CustomerFields2": "",
"CustomerFields3": "",
"CustomerFields4": "",
"CustomerFields5": "",
"CustomerFields6": "",
"CustomerFields7": "",
"CustomerFields8": ""
}],
"IsSucceed":false,
"ErrorMsgID":0,
"ErrorMsg": "",
"TotalCount":0,
"PageIndex":0,
"PageSize":0
}
国内机票账单查询
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
settleSerialNo | 结算批次号(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
settletTimeStart | 结算时间-开始((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
settletTimeEnd | 结算时间-结束((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
purchaseTimeStart | 消费时间-开始((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
purchaseTimeEnd | 消费时间-结束(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
orderNo | 订单编号 | String | 否 | |
recordIds | 消费记录编号(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | Array[] | 否 | |
billingPeriod | 账期,如 202401 (消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数(最大500) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"settleSerialNo": "",
"settletTimeStart":"2023-09-27",
"settletTimeEnd":"2023-10-27",
"purchaseTimeStart":"2023-09-27",
"purchaseTimeEnd":"2023-10-27",
"orderNo": "",
"recordIds":"[“AA”,“BB”]",
"billingPeriod": "",
"pageIndex":1,
"pageSize":200,
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
IsSucceed | 是否成功查询 | Boolean | ||
ErrorMsgID | 错误信息标志号 0-正常 | Integer | ||
ErrorMsg | 错误信息 | String | ||
TotalCount | Integer | |||
PageIndex | 页面索引 | Integer | ||
PageSize | 页大小 | Integer | ||
TicketSettleInfoList | Array[] | |||
RecordId | 消费记录编号 | String | TicketSettleInfoList | |
OrderNo | 订单编号 | String | TicketSettleInfoList | |
CompanyId | 客户编码 | String | TicketSettleInfoList | |
CompanyName | 客户名称 | String | TicketSettleInfoList | |
GroupId | 集团编码 | String | TicketSettleInfoList | |
GroupName | 集团名称 | String | TicketSettleInfoList | |
OaSerialNumber | 出差申请单号 | String | TicketSettleInfoList | |
PayType | 消费支付类型:1:信用消费2:即付消费 | Integer | TicketSettleInfoList | |
CardId | 信用卡号 | String | TicketSettleInfoList | |
CardIdLast | 信用卡号末4位 | String | TicketSettleInfoList | |
SettleSerialNo | 结算批次号 | String | TicketSettleInfoList | |
SettleStatus | 对账状态:待核对-1 待推送-2 推送中-3 待确认(推送成功)-4 已确认-5 推送失败-6 关账-7 | Integer | TicketSettleInfoList | |
BillBeginning | 账单起始日期 | String | TicketSettleInfoList | |
BillDeadLine | 账单截止日期 | String | TicketSettleInfoList | |
BillDate | 出账日期 | String | TicketSettleInfoList | |
ExpireDate | 到期还款日 | String | TicketSettleInfoList | |
CustomerRemark | 客户备注 | String | TicketSettleInfoList | |
SettleTime | 结算生成时间 | String | TicketSettleInfoList | |
RebackOrderNo | 关联单号 | String | TicketSettleInfoList | |
OpDate | 预订时间 | String | TicketSettleInfoList | |
ProcessTime | 处理时间 | String | TicketSettleInfoList | |
OrderType | 订单类型 1订购单、2变更单、3退订单、4调整单、5积分单、102计费单 报价单订单类型 11报价订购单 12报价变更单 13报价退订单 | Integer | TicketSettleInfoList | |
BookingType | 出差性质 -1 无 0是因公 1是因私 | Integer | TicketSettleInfoList | |
OrderSource | 订单来源 | String | TicketSettleInfoList | |
BookingChannelName | 预订渠道 | String | TicketSettleInfoList | |
OpId | 客户制单人Id | String | TicketSettleInfoList | |
OpName | 客户制单人名称 | String | TicketSettleInfoList | |
OpDepartment | 客户制单人部门 | String | TicketSettleInfoList | |
OpOrganization | 客户制单人组织架构 | String | TicketSettleInfoList | |
CustomerCreatorEmployeeNo | 客户制单人员工工号 | String | TicketSettleInfoList | |
ProductSubType | 机票类型 | Integer | TicketSettleInfoList | |
ProductSubTypeName | 机票类型名称 | String | TicketSettleInfoList | |
ProductNature | 产品性质 | String | TicketSettleInfoList | |
EndorsementType | 改签类型 | String | TicketSettleInfoList | |
ReasonChange | 改签原因 | String | TicketSettleInfoList | |
RefundType | 退票类型 | String | TicketSettleInfoList | |
ReasonRefund | 退票原因 | String | TicketSettleInfoList | |
TimeSubmissionAapproval | 提交审批时间 | String | TicketSettleInfoList | |
FinalJudge | 终审人 | String | TicketSettleInfoList | |
FinalReviewTime | 终审时间 | String | TicketSettleInfoList | |
CommentsBehalfApproval | 代审批备注 | String | TicketSettleInfoList | |
AdvanceBookingDays | 提前预订天数 | Integer | TicketSettleInfoList | |
MinimumFlightPriceDday | 当天最低航班价格 | Number | TicketSettleInfoList | |
LowestPriceFlightDay | 当天最低价航班 | String | TicketSettleInfoList | |
DepartureTimeCheapestFlightDay | 当天最低价航班起飞时间 | String | TicketSettleInfoList | |
Pnr | PNR | String | TicketSettleInfoList | |
AgreementNature | 协议性质 | String | TicketSettleInfoList | |
Uatp | UATP(Y/N) | String | TicketSettleInfoList | |
UATPcardNumber | UATP卡号 | String | TicketSettleInfoList | |
ReceivableFee | 应收 | Number | TicketSettleInfoList | |
Currency | 结算币种 | String | TicketSettleInfoList | |
TOrderNo | 原始订购单号 | String | TicketSettleInfoList | |
TRType | 退票类型 NF:改期退票拆分不是第一条数据(需要将旅客中间表金额字段处理为0,再返回数据给客户) | String | TicketSettleInfoList | |
RecordIdMin | 改期退票最小消费记录编号 | String | TicketSettleInfoList | |
MergePayAmountRmb | 合并后消费金额(CNY)(国内机票退票单多条消费记录) | Number | TicketSettleInfoList | |
VersionNumber | 版本号 | Integer | TicketSettleInfoList | |
CustomerFields1 | 客户字段1 c_TextField_2401 | String | TicketSettleInfoList | |
CustomerFields2 | 客户字段2 c_TextField_2402 | String | TicketSettleInfoList | |
CustomerFields3 | 客户字段3 c_TextField_2403 | String | TicketSettleInfoList | |
CustomerFields4 | 客户字段4 c_TextField_2404 | String | TicketSettleInfoList | |
CustomerFields5 | 客户字段5 c_TextField_2405 | String | TicketSettleInfoList | |
CustomerFields6 | 客户字段6 c_TextField_2406 | String | TicketSettleInfoList | |
CustomerFields7 | 客户字段7 c_TextField_2407 | String | TicketSettleInfoList | |
CustomerFields8 | 客户字段8 c_TextField_2408 | String | TicketSettleInfoList | |
TicketSettlePsngrList | 结算明细关联旅客信息 | Array[] | TicketSettleInfoList | |
RecordId | 消费记录编号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
OrderNo | 订单编号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerNo | 旅客编号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
FaceValuePrice | 票价 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
TaxationFee | 税费 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
UpgradeFee | 升舱费 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
EndorsementFee | 改签费 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
ServiceCharge | 服务费 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
CancellationFee | 退订手续费 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
UsedSegmentFee | 已使用航段费 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
ElectronicOrderNumber | 票号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerName | 旅客姓名 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerNameCn | 旅客中文名 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerStaffNo | 旅客员工工号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerCertificateNo | 旅客证件号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerOrganizational | 旅客组织架构 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerCostCenterCode | 成本中心编号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerCostCenter | 成本中心名称 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerCostCenterFullLevel | 成本中心(全级) | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerCostCenterRemark | 成本中心备注 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerType | 旅客类型 | String | TicketSettleInfoList.TicketSettlePsngrList | |
TravelPolicyViolations | 违反差旅政策项目 | String | TicketSettleInfoList.TicketSettlePsngrList | |
ReasonsViolatingTravelPolicy | 违反差旅政策原因 | String | TicketSettleInfoList.TicketSettlePsngrList | |
MinimumFlightWithinPrice | 比价范围内最低航班价格 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
LowestPriceFlightsWithinPrice | 比价范围内最低价航班 | String | TicketSettleInfoList.TicketSettlePsngrList | |
DepartureTimeflightWithinPrice | 比价范围内最低价航班起飞时间 | String | TicketSettleInfoList.TicketSettlePsngrList | |
AirportConstructionFee | 机建费/税一 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
FuelChargeFee | 燃油费/税二 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
OriginTicketNo | 原票号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
TopTicketNo | 原始票号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
TravelOrderNumber | 行程单号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerCostCenterPrice | 旅客成本中心金额 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
TravelImageUrl | 行程单影像资料 | String | TicketSettleInfoList.TicketSettlePsngrList | |
TicketSettlePsngrSegment | 旅客关联航段 | Array[] | TicketSettleInfoList.TicketSettlePsngrList | |
RecordId | 消费记录编号 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
OrderNo | 订单编号 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
PassengerNo | 旅客编号 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
SegmentNo | 航段序号 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
CabinCn | 舱等(中文) | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
CabinEn | 舱等(英文) | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
ShippingSpace | 舱位 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DepartureCityCn | 出发城市中文 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DepartureCityEn | 出发城市英文 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DepartureAirportCode | 出发机场代码 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DepartureTime | 起飞时间 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DecCityCn | 到达城市中文 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DecCityEn | 到达城市英文 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DecAirportCode | 到达机场代码 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
ArrivalTime | 到达时间 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
FlightNumber | 航班号 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
RouteCn | 行程-城市中文名 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
RouteEn | 行程-城市英文名 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
RouteairportCode | 行程-机场代码 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
SegmentProperties | 航段属性 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
AirlinesCn | 航空公司中文 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
AirlineCode | 航空公司代码 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
FlightDuration | 飞行时长 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
FlightModel | 机型 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
Mileage | 里程 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
FaceAirTicketsPrice | 机票票面价 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
EconomyClassFullPrice | 经济舱全价 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
FullNusinessClassPrice | 商务舱全价 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
FirstClassFullPrice | 头等舱全价 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
Discount | 折扣 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
PercentageDiscount | 百分比折扣 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
PublishedShippingRate | 舱位公布运价 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
AnnounceRateDiscount | 公布运价折扣 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
TicketUsageStatus | 客票使用状态 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DepartureCityCode | 出发城市(代码) | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DepartureAirportName | 出发机场名称 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DecCityCode | 到达城市代码 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DecAirportName | 到达机场名称 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment |
{
"TicketSettleInfoList":
[{
"TicketSettlePsngrList":
[{
"TicketSettlePsngrSegment":
[{
"RecordId": "",
"OrderNo": "",
"PassengerNo": "",
"SegmentNo": "",
"CabinCn": "",
"CabinEn": "",
"ShippingSpace": "",
"DepartureCityCn": "",
"DepartureCityEn": "",
"DepartureAirportCode": "",
"DepartureTime": "",
"DecCityCn": "",
"DecCityEn": "",
"DecAirportCode": "",
"ArrivalTime": "",
"FlightNumber": "",
"RouteCn": "",
"RouteEn": "",
"RouteairportCode": "",
"SegmentProperties": "",
"AirlinesCn": "",
"AirlineCode": "",
"FlightDuration": "",
"FlightModel": "",
"Mileage":0,
"FaceAirTicketsPrice":0,
"EconomyClassFullPrice":0,
"FullNusinessClassPrice":0,
"FirstClassFullPrice":0,
"Discount":0,
"PercentageDiscount":0,
"PublishedShippingRate":0,
"AnnounceRateDiscount":0,
"TicketUsageStatus": "",
"DepartureCityCode": "",
"DepartureAirportName": "",
"DecCityCode": "",
"DecAirportName": ""
}],
"RecordId":"XF230000030513",
"OrderNo":"TB2300010347",
"PassengerNo":"P852494",
"FaceValuePrice":600.00,
"TaxationFee":180.00,
"UpgradeFee":0.00,
"EndorsementFee":0.00,
"ServiceCharge":0.00,
"CancellationFee":0.00,
"UsedSegmentFee":0.00,
"ElectronicOrderNumber":"222-4154303486",
"PassengerName":"邱宝萍",
"PassengerNameCn":"邱宝萍",
"PassengerStaffNo":"60245",
"PassengerCertificateNo":"60245602456024560245",
"PassengerOrganizational":"部门",
"PassengerCostCenterCode": "",
"PassengerCostCenter": "",
"PassengerCostCenterFullLevel": "",
"PassengerCostCenterRemark": "",
"PassengerType":"成人",
"TravelPolicyViolations": "",
"ReasonsViolatingTravelPolicy": "",
"MinimumFlightWithinPrice":0,
"LowestPriceFlightsWithinPrice": "",
"DepartureTimeflightWithinPrice": "",
"AirportConstructionFee":50.00,
"FuelChargeFee":130.00,
"OriginTicketNo": "",
"TopTicketNo": "",
"TravelOrderNumber": "",
"PassengerCostCenterPrice":0.00,
"TravelImageUrl": ""
}],
"RecordId":"XF230000030513",
"OrderNo":"TB2300010347",
"CompanyId":"S118022",
"CompanyName":"美亚测试股份有限公司",
"GroupId":"G112178",
"GroupName":"OA对接专用集团",
"OaSerialNumber":"CLYD23100002",
"PayType":1,
"CardId":"CC220000011",
"CardIdLast":"0011",
"SettleSerialNo": "",
"SettleStatus":0,
"BillBeginning":"0001-01-01T00:00:00",
"BillDeadLine":"0001-01-01T00:00:00",
"BillDate":"0001-01-01T00:00:00",
"ExpireDate":"0001-01-01T00:00:00",
"CustomerRemark": "",
"SettleTime":"2023-10-09T18:19:41",
"RebackOrderNo": "",
"OpDate":"2023-10-09T18:19:10",
"ProcessTime":"2023-10-09T18:19:41",
"OrderType":1,
"BookingType":0,
"OrderSource":"在线预订",
"BookingChannelName":"PC端对接",
"OpId":"P767609",
"OpName":"东方不败",
"OpDepartment":"部门",
"OpOrganization":"部门",
"CustomerCreatorEmployeeNo":"123456",
"ProductSubType":1,
"ProductSubTypeName":"国内机票",
"ProductNature":"BSP",
"EndorsementType": "",
"ReasonChange": "",
"RefundType": "",
"ReasonRefund": "",
"TimeSubmissionAapproval":"2023-10-09T18:19:15",
"FinalJudge":"系统自动",
"FinalReviewTime":"2023-10-09T18:19:17",
"CommentsBehalfApproval": "",
"AdvanceBookingDays":37,
"MinimumFlightPriceDday":600.00,
"LowestPriceFlightDay":"CZ8955",
"DepartureTimeCheapestFlightDay":"2023/11/15 9:45:00",
"Pnr":"KMY67F",
"AgreementNature":"非协议",
"Uatp":"N",
"UATPcardNumber": "",
"ReceivableFee":780,
"Currency":"CNY",
"TOrderNo":"TB2300010347",
"TRType": "",
"RecordIdMin":"XF230000030513",
"MergePayAmountRmb":780,
"VersionNumber":8446343,
"CustomerFields1": "",
"CustomerFields2": "",
"CustomerFields3": "",
"CustomerFields4": "",
"CustomerFields5": "",
"CustomerFields6": "",
"CustomerFields7": "",
"CustomerFields8": ""
}],
"IsSucceed":false,
"ErrorMsgID":0,
"ErrorMsg": "",
"TotalCount":0,
"PageIndex":0,
"PageSize":0
}
国际机票账单查询
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
settleSerialNo | 结算批次号(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
settletTimeStart | 结算时间-开始((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
settletTimeEnd | 结算时间-结束((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
purchaseTimeStart | 消费时间-开始((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
purchaseTimeEnd | 消费时间-结束(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
orderNo | 订单编号 | String | 否 | |
recordIds | 消费记录编号(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | Array[] | 否 | |
billingPeriod | 账期,如 202401 (消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数(最大500) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"settleSerialNo": "",
"settletTimeStart":"2023-09-27",
"settletTimeEnd":"2023-10-27",
"purchaseTimeStart":"2023-09-27",
"purchaseTimeEnd":"2023-10-27",
"orderNo": "",
"recordIds":"[“AA”,“BB”]",
"billingPeriod": "",
"pageIndex":1,
"pageSize":200,
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
IsSucceed | 是否成功查询 | Boolean | ||
ErrorMsgID | 错误信息标志号 0-正常 | Integer | ||
ErrorMsg | 错误信息 | String | ||
TotalCount | Integer | |||
PageIndex | 页面索引 | Integer | ||
PageSize | 页大小 | Integer | ||
TicketSettleInfoList | Array[] | |||
RecordId | 消费记录编号 | String | TicketSettleInfoList | |
OrderNo | 订单编号 | String | TicketSettleInfoList | |
CompanyId | 客户编码 | String | TicketSettleInfoList | |
CompanyName | 客户名称 | String | TicketSettleInfoList | |
GroupId | 集团编码 | String | TicketSettleInfoList | |
GroupName | 集团名称 | String | TicketSettleInfoList | |
OaSerialNumber | 出差申请单号 | String | TicketSettleInfoList | |
PayType | 消费支付类型:1:信用消费2:即付消费 | Integer | TicketSettleInfoList | |
CardId | 信用卡号 | String | TicketSettleInfoList | |
CardIdLast | 信用卡号末4位 | String | TicketSettleInfoList | |
SettleSerialNo | 结算批次号 | String | TicketSettleInfoList | |
SettleStatus | 对账状态:待核对-1 待推送-2 推送中-3 待确认(推送成功)-4 已确认-5 推送失败-6 关账-7 | Integer | TicketSettleInfoList | |
BillBeginning | 账单起始日期 | String | TicketSettleInfoList | |
BillDeadLine | 账单截止日期 | String | TicketSettleInfoList | |
BillDate | 出账日期 | String | TicketSettleInfoList | |
ExpireDate | 到期还款日 | String | TicketSettleInfoList | |
CustomerRemark | 客户备注 | String | TicketSettleInfoList | |
SettleTime | 结算生成时间 | String | TicketSettleInfoList | |
RebackOrderNo | 关联单号 | String | TicketSettleInfoList | |
OpDate | 预订时间 | String | TicketSettleInfoList | |
ProcessTime | 处理时间 | String | TicketSettleInfoList | |
OrderType | 订单类型 1订购单、2变更单、3退订单、4调整单、5积分单、102计费单 报价单订单类型 11报价订购单 12报价变更单 13报价退订单 | Integer | TicketSettleInfoList | |
BookingType | 出差性质 -1 无 0是因公 1是因私 | Integer | TicketSettleInfoList | |
OrderSource | 订单来源 | String | TicketSettleInfoList | |
BookingChannelName | 预订渠道 | String | TicketSettleInfoList | |
OpId | 客户制单人Id | String | TicketSettleInfoList | |
OpName | 客户制单人名称 | String | TicketSettleInfoList | |
OpDepartment | 客户制单人部门 | String | TicketSettleInfoList | |
OpOrganization | 客户制单人组织架构 | String | TicketSettleInfoList | |
CustomerCreatorEmployeeNo | 客户制单人员工工号 | String | TicketSettleInfoList | |
ProductSubType | 机票类型 | Integer | TicketSettleInfoList | |
ProductSubTypeName | 机票类型名称 | String | TicketSettleInfoList | |
ProductNature | 产品性质 | String | TicketSettleInfoList | |
EndorsementType | 改签类型 | String | TicketSettleInfoList | |
ReasonChange | 改签原因 | String | TicketSettleInfoList | |
RefundType | 退票类型 | String | TicketSettleInfoList | |
ReasonRefund | 退票原因 | String | TicketSettleInfoList | |
TimeSubmissionAapproval | 提交审批时间 | String | TicketSettleInfoList | |
FinalJudge | 终审人 | String | TicketSettleInfoList | |
FinalReviewTime | 终审时间 | String | TicketSettleInfoList | |
CommentsBehalfApproval | 代审批备注 | String | TicketSettleInfoList | |
AdvanceBookingDays | 提前预订天数 | Integer | TicketSettleInfoList | |
MinimumFlightPriceDday | 当天最低航班价格 | Number | TicketSettleInfoList | |
LowestPriceFlightDay | 当天最低价航班 | String | TicketSettleInfoList | |
DepartureTimeCheapestFlightDay | 当天最低价航班起飞时间 | String | TicketSettleInfoList | |
Pnr | PNR | String | TicketSettleInfoList | |
AgreementNature | 协议性质 | String | TicketSettleInfoList | |
Uatp | UATP(Y/N) | String | TicketSettleInfoList | |
UATPcardNumber | UATP卡号 | String | TicketSettleInfoList | |
ReceivableFee | 应收 | Number | TicketSettleInfoList | |
Currency | 结算币种 | String | TicketSettleInfoList | |
TOrderNo | 原始订购单号 | String | TicketSettleInfoList | |
TRType | 退票类型 NF:改期退票拆分不是第一条数据(需要将旅客中间表金额字段处理为0,再返回数据给客户) | String | TicketSettleInfoList | |
RecordIdMin | 改期退票最小消费记录编号 | String | TicketSettleInfoList | |
MergePayAmountRmb | 合并后消费金额(CNY)(国内机票退票单多条消费记录) | Number | TicketSettleInfoList | |
VersionNumber | 版本号 | Integer | TicketSettleInfoList | |
CustomerFields1 | 客户字段1 c_TextField_2401 | String | TicketSettleInfoList | |
CustomerFields2 | 客户字段2 c_TextField_2402 | String | TicketSettleInfoList | |
CustomerFields3 | 客户字段3 c_TextField_2403 | String | TicketSettleInfoList | |
CustomerFields4 | 客户字段4 c_TextField_2404 | String | TicketSettleInfoList | |
CustomerFields5 | 客户字段5 c_TextField_2405 | String | TicketSettleInfoList | |
CustomerFields6 | 客户字段6 c_TextField_2406 | String | TicketSettleInfoList | |
CustomerFields7 | 客户字段7 c_TextField_2407 | String | TicketSettleInfoList | |
CustomerFields8 | 客户字段8 c_TextField_2408 | String | TicketSettleInfoList | |
TicketSettlePsngrList | 结算明细关联旅客信息 | Array[] | TicketSettleInfoList | |
RecordId | 消费记录编号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
OrderNo | 订单编号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerNo | 旅客编号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
FaceValuePrice | 票价 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
TaxationFee | 税费 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
UpgradeFee | 升舱费 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
EndorsementFee | 改签费 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
ServiceCharge | 服务费 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
CancellationFee | 退订手续费 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
UsedSegmentFee | 已使用航段费 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
ElectronicOrderNumber | 票号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerName | 旅客姓名 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerNameCn | 旅客中文名 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerStaffNo | 旅客员工工号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerCertificateNo | 旅客证件号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerOrganizational | 旅客组织架构 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerCostCenterCode | 成本中心编号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerCostCenter | 成本中心名称 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerCostCenterFullLevel | 成本中心(全级) | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerCostCenterRemark | 成本中心备注 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerType | 旅客类型 | String | TicketSettleInfoList.TicketSettlePsngrList | |
TravelPolicyViolations | 违反差旅政策项目 | String | TicketSettleInfoList.TicketSettlePsngrList | |
ReasonsViolatingTravelPolicy | 违反差旅政策原因 | String | TicketSettleInfoList.TicketSettlePsngrList | |
AirportConstructionFee | 机建费/税一 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
FuelChargeFee | 燃油费/税二 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
OriginTicketNo | 原票号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
TopTicketNo | 原始票号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
TravelOrderNumber | 行程单号 | String | TicketSettleInfoList.TicketSettlePsngrList | |
PassengerCostCenterPrice | 旅客成本中心金额 | Number | TicketSettleInfoList.TicketSettlePsngrList | |
SalesRevenue | 销售收入(CNY) | Number | TicketSettleInfoList.TicketSettlePsngrList | |
TravelImageUrl | 行程单影像资料 | String | TicketSettleInfoList.TicketSettlePsngrList | |
TicketSettlePsngrSegment | 旅客关联航段 | Array[] | TicketSettleInfoList.TicketSettlePsngrList | |
RecordId | 消费记录编号 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
OrderNo | 订单编号 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
PassengerNo | 旅客编号 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
SegmentNo | 航段序号 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
CabinCn | 舱等(中文) | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
CabinEn | 舱等(英文) | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
ShippingSpace | 舱位 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DepartureCityCn | 出发城市中文 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DepartureCityEn | 出发城市英文 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DepartureAirportCode | 出发机场代码 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DepartureTime | 起飞时间 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DecCityCn | 到达城市中文 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DecCityEn | 到达城市英文 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DecAirportCode | 到达机场代码 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
ArrivalTime | 到达时间 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
FlightNumber | 航班号 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
RouteCn | 行程-城市中文名 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
RouteEn | 行程-城市英文名 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
RouteairportCode | 行程-机场代码 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
SegmentProperties | 航段属性 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
AirlinesCn | 航空公司中文 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
AirlineCode | 航空公司代码 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
FlightDuration | 飞行时长 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
FlightModel | 机型 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
Mileage | 里程 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
FaceAirTicketsPrice | 机票票面价 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
EconomyClassFullPrice | 经济舱全价 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
FullNusinessClassPrice | 商务舱全价 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
FirstClassFullPrice | 头等舱全价 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
Discount | 折扣 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
PercentageDiscount | 百分比折扣 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
PublishedShippingRate | 舱位公布运价 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
AnnounceRateDiscount | 公布运价折扣 | Number | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
TicketUsageStatus | 客票使用状态 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DepartureCityCode | 出发城市(代码) | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DepartureAirportName | 出发机场名称 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DecCityCode | 到达城市代码 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment | |
DecAirportName | 到达机场名称 | String | TicketSettleInfoList.TicketSettlePsngrList.TicketSettlePsngrSegment |
{
"TicketSettleInfoList":
[{
"TicketSettlePsngrList":
[{
"TicketSettlePsngrSegment":
[{
"RecordId":"XF230000031330",
"OrderNo":"QC2300000384",
"PassengerNo":"P891569",
"SegmentNo":"1",
"CabinCn":"经济舱",
"CabinEn":"Economy",
"ShippingSpace":"M",
"DepartureCityCn":"巴黎",
"DepartureCityEn":"Paris",
"DepartureAirportCode":"CDG",
"DepartureTime":"2023-11-03T11:40:00",
"DecCityCn":"香港",
"DecCityEn":"Hong Kong",
"DecAirportCode":"HKG",
"ArrivalTime":"2023-11-04T07:00:00",
"FlightNumber":"CX260",
"RouteCn":"巴黎-香港",
"RouteEn":"Paris-Hong Kong",
"RouteairportCode":"CDG-HKG",
"SegmentProperties":"国际",
"AirlinesCn":"国泰航空",
"AirlineCode":"CX",
"FlightDuration":"12:20",
"FlightModel":"波音777",
"Mileage":9589,
"FaceAirTicketsPrice":0,
"EconomyClassFullPrice":0,
"FullNusinessClassPrice":0,
"FirstClassFullPrice":0,
"Discount":0,
"PercentageDiscount":0,
"PublishedShippingRate":0,
"AnnounceRateDiscount":0,
"TicketUsageStatus": "",
"DepartureCityCode":"PAR",
"DepartureAirportName":"查尔斯-戴高乐机场",
"DecCityCode":"HKG",
"DecAirportName":"香港国际机场"
}],
"RecordId":"XF230000031330",
"OrderNo":"QC2300000384",
"PassengerNo":"P891569",
"FaceValuePrice":0,
"TaxationFee":0,
"UpgradeFee":0,
"EndorsementFee":0,
"ServiceCharge":0,
"CancellationFee":0,
"UsedSegmentFee":0,
"ElectronicOrderNumber":"123-7894561231",
"PassengerName":"DENG/YUTONG",
"PassengerNameCn":"邓宇彤",
"PassengerStaffNo":"dengyutong",
"PassengerCertificateNo":"P19835767",
"PassengerOrganizational":"部门",
"PassengerCostCenterCode":"1000336",
"PassengerCostCenter":"美亚测试股份有限公司",
"PassengerCostCenterFullLevel":"美亚测试股份有限公司/技术中心",
"PassengerCostCenterRemark": "",
"PassengerType":"成人",
"TravelPolicyViolations": "",
"ReasonsViolatingTravelPolicy": "",
"AirportConstructionFee":0,
"FuelChargeFee":0,
"OriginTicketNo":"222-0000000285",
"TopTicketNo":"222-0000000285",
"TravelOrderNumber": "",
"PassengerCostCenterPrice":0,
"SalesRevenue":0,
"TravelImageUrl": ""
}],
"RecordId":"XF230000031330",
"OrderNo":"QC2300000384",
"CompanyId":"S118022",
"CompanyName":"美亚测试股份有限公司",
"GroupId":"G101572",
"GroupName":"OA对接集团",
"OaSerialNumber": "",
"PayType":1,
"CardId":"CC230000031",
"CardIdLast":"0031",
"SettleSerialNo": "",
"SettleStatus":0,
"BillBeginning":"0001-01-01T00:00:00",
"BillDeadLine":"0001-01-01T00:00:00",
"BillDate":"0001-01-01T00:00:00",
"ExpireDate":"0001-01-01T00:00:00",
"CustomerRemark": "",
"SettleTime":"2023-10-23T12:02:20",
"RebackOrderNo":"QT2300003010",
"OpDate":"2023-10-17T09:17:28",
"ProcessTime":"2023-10-23T12:02:20",
"OrderType":12,
"BookingType":0,
"OrderSource":"在线预订",
"BookingChannelName":"移动H5",
"OpId":"P891569",
"OpName":"邓彤",
"OpDepartment":"部门",
"OpOrganization":"部门",
"CustomerCreatorEmployeeNo":"dengyutong",
"ProductSubType":2,
"ProductSubTypeName":"国际机票",
"ProductNature": "",
"EndorsementType": "",
"ReasonChange":"手机端测试改签",
"RefundType": "",
"ReasonRefund": "",
"TimeSubmissionAapproval":"2023-10-17T11:11:24",
"FinalJudge":"系统自动",
"FinalReviewTime":"2023-10-17T11:11:25",
"CommentsBehalfApproval": "",
"AdvanceBookingDays":17,
"MinimumFlightPriceDday":0,
"LowestPriceFlightDay": "",
"DepartureTimeCheapestFlightDay": "",
"Pnr":"XXXXXX",
"AgreementNature":"非协议",
"Uatp":"N",
"UATPcardNumber": "",
"ReceivableFee":0,
"Currency":"CNY",
"TOrderNo":"QT2300003010",
"TRType": "",
"RecordIdMin":"XF230000031330",
"MergePayAmountRmb":0,
"VersionNumber":8480779,
"CustomerFields1": "",
"CustomerFields2": "",
"CustomerFields3": "",
"CustomerFields4": "",
"CustomerFields5": "",
"CustomerFields6": "",
"CustomerFields7": "",
"CustomerFields8": ""
}],
"IsSucceed":false,
"ErrorMsgID":0,
"ErrorMsg": "",
"TotalCount":0,
"PageIndex":0,
"PageSize":0
}
火车票账单查询
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
settleSerialNo | 结算批次号(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
settletTimeStart | 结算时间-开始((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
settletTimeEnd | 结算时间-结束((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
purchaseTimeStart | 消费时间-开始((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
purchaseTimeEnd | 消费时间-结束(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
orderNo | 订单编号 | String | 否 | |
recordIds | 消费记录编号(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | Array[] | 否 | |
billingPeriod | 账期,如 202401 (消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数(最大500) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"settleSerialNo": "",
"settletTimeStart":"2023-09-27",
"settletTimeEnd":"2023-10-27",
"purchaseTimeStart":"2023-09-27",
"purchaseTimeEnd":"2023-10-27",
"orderNo": "",
"recordIds":"[“AA”,“BB”]",
"billingPeriod": "",
"pageIndex":1,
"pageSize":200,
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
IsSucceed | 是否成功查询 | Boolean | ||
ErrorMsgID | 错误信息标志号 0-正常 | Integer | ||
ErrorMsg | 错误信息 | String | ||
TotalCount | Integer | |||
PageIndex | 页面索引 | Integer | ||
PageSize | 页大小 | Integer | ||
TrainSettleInfoList | Array[] | |||
RecordId | 消费记录编号 | String | TrainSettleInfoList | |
OrderNo | 订单编号 | String | TrainSettleInfoList | |
CompanyId | 客户编码 | String | TrainSettleInfoList | |
CompanyName | 客户名称 | String | TrainSettleInfoList | |
GroupId | 集团编码 | String | TrainSettleInfoList | |
GroupName | 集团名称 | String | TrainSettleInfoList | |
OaSerialNumber | 出差申请单号 | String | TrainSettleInfoList | |
PayType | 消费支付类型:1:信用消费2:即付消费 | Integer | TrainSettleInfoList | |
CardId | 信用卡号 | String | TrainSettleInfoList | |
CardIdLast | 信用卡号末4位 | String | TrainSettleInfoList | |
SettleSerialNo | 结算批次号 | String | TrainSettleInfoList | |
SettleStatus | 对账状态:待核对-1 待推送-2 推送中-3 待确认(推送成功)-4 已确认-5 推送失败-6 关账-7 | Integer | TrainSettleInfoList | |
BillBeginning | 账单起始日期 | String | TrainSettleInfoList | |
BillDeadLine | 账单截止日期 | String | TrainSettleInfoList | |
BillDate | 出账日期 | String | TrainSettleInfoList | |
ExpireDate | 到期还款日 | String | TrainSettleInfoList | |
CustomerRemark | 客户备注 | String | TrainSettleInfoList | |
SettleTime | 结算生成时间 | String | TrainSettleInfoList | |
RebackOrderNo | 关联单号 | String | TrainSettleInfoList | |
OpDate | 预订时间 | String | TrainSettleInfoList | |
ProcessTime | 处理时间 | String | TrainSettleInfoList | |
OrderType | 订单类型 1订购单、2变更单、3退订单、4调整单、5积分单、102计费单 报价单订单类型 11报价订购单 12报价变更单 13报价退订单 | Integer | TrainSettleInfoList | |
BookingType | 出差性质 -1 无 0是因公 1是因私 | Integer | TrainSettleInfoList | |
OrderSource | 订单来源 | String | TrainSettleInfoList | |
BookingChannelName | 预订渠道 | String | TrainSettleInfoList | |
OpId | 客户制单人Id | String | TrainSettleInfoList | |
OpName | 客户制单人名称 | String | TrainSettleInfoList | |
OpDepartment | 客户制单人部门 | String | TrainSettleInfoList | |
OpOrganization | 客户制单人组织架构 | String | TrainSettleInfoList | |
CustomerCreatorEmployeeNo | 客户制单人员工工号 | String | TrainSettleInfoList | |
ProductSubType | 产品类型 | Integer | TrainSettleInfoList | |
ProductSubTypeName | 产品类型名称 | String | TrainSettleInfoList | |
ProductNature | 产品性质 | String | TrainSettleInfoList | |
EndorsementType | 改签类型 | String | TrainSettleInfoList | |
ReasonChange | 改签原因 | String | TrainSettleInfoList | |
RefundType | 退票类型 | String | TrainSettleInfoList | |
ReasonRefund | 退票原因 | String | TrainSettleInfoList | |
TimeSubmissionAapproval | 提交审批时间 | String | TrainSettleInfoList | |
Uatp | UATP(Y/N) | String | TrainSettleInfoList | |
UATPcardNumber | UATP卡号 | String | TrainSettleInfoList | |
FinalJudge | 终审人 | String | TrainSettleInfoList | |
FinalReviewTime | 终审时间 | String | TrainSettleInfoList | |
CommentsBehalfApproval | 代审批备注 | String | TrainSettleInfoList | |
TravelNumber | 车次 | String | TrainSettleInfoList | |
DepartureCity | 出发站-中文 | String | TrainSettleInfoList | |
PlaceDepartureCityEn | 出发站-英文 | String | TrainSettleInfoList | |
PlaceDepartureCityCodeEn | 出发站代码 | String | TrainSettleInfoList | |
TimeOfDeparture | 出发时间 | String | TrainSettleInfoList | |
ArrivalCity | 到达站-中文 | String | TrainSettleInfoList | |
DestinationEn | 到达站-英文 | String | TrainSettleInfoList | |
ArrivalAirportStationCode | 到达站代码 | String | TrainSettleInfoList | |
TimeOfArrival | 到达时间 | String | TrainSettleInfoList | |
ProductGradeEn | 席位类别-英文 | String | TrainSettleInfoList | |
ProductLevel | 席位类别-中文 | String | TrainSettleInfoList | |
ReceivableFee | 应收 | Number | TrainSettleInfoList | |
Currency | 结算币种 | String | TrainSettleInfoList | |
TOrderNo | 原始订购单号 | String | TrainSettleInfoList | |
TRType | 退票类型 NF:改期退票拆分不是第一条数据(需要将旅客中间表金额字段处理为0,再返回数据给客户) | String | TrainSettleInfoList | |
RecordIdMin | 改期退票最小消费记录编号 | String | TrainSettleInfoList | |
MergePayAmountRmb | 合并后消费金额(CNY)(国内机票退票单多条消费记录) | Number | TrainSettleInfoList | |
VersionNumber | 版本号 | Integer | TrainSettleInfoList | |
CustomerFields1 | 客户字段1 c_TextField_2401 | String | TrainSettleInfoList | |
CustomerFields2 | 客户字段2 c_TextField_2402 | String | TrainSettleInfoList | |
CustomerFields3 | 客户字段3 c_TextField_2403 | String | TrainSettleInfoList | |
CustomerFields4 | 客户字段4 c_TextField_2404 | String | TrainSettleInfoList | |
CustomerFields5 | 客户字段5 c_TextField_2405 | String | TrainSettleInfoList | |
CustomerFields6 | 客户字段6 c_TextField_2406 | String | TrainSettleInfoList | |
CustomerFields7 | 客户字段7 c_TextField_2407 | String | TrainSettleInfoList | |
CustomerFields8 | 客户字段8 c_TextField_2408 | String | TrainSettleInfoList | |
TrainSettlePsngrList | 结算明细关联旅客信息 | Array[] | TrainSettleInfoList | |
RecordId | 消费记录编号 | String | TrainSettleInfoList.TrainSettlePsngrList | |
OrderNo | 订单编号 | String | TrainSettleInfoList.TrainSettlePsngrList | |
PassengerNo | 旅客编号 | String | TrainSettleInfoList.TrainSettlePsngrList | |
FaceValuePrice | 票价 | Number | TrainSettleInfoList.TrainSettlePsngrList | |
TaxationFee | 税费 | Number | TrainSettleInfoList.TrainSettlePsngrList | |
UpgradeFee | 升舱费 | Number | TrainSettleInfoList.TrainSettlePsngrList | |
EndorsementFee | 改签费 | Number | TrainSettleInfoList.TrainSettlePsngrList | |
ServiceCharge | 服务费 | Number | TrainSettleInfoList.TrainSettlePsngrList | |
CancellationFee | 退票费 | Number | TrainSettleInfoList.TrainSettlePsngrList | |
ElectronicOrderNumber | 电子订单号 | String | TrainSettleInfoList.TrainSettlePsngrList | |
PassengerName | 旅客姓名 | String | TrainSettleInfoList.TrainSettlePsngrList | |
PassengerNameCn | 旅客中文名 | String | TrainSettleInfoList.TrainSettlePsngrList | |
PassengerStaffNo | 旅客员工工号 | String | TrainSettleInfoList.TrainSettlePsngrList | |
PassengerCertificateNo | 旅客证件号 | String | TrainSettleInfoList.TrainSettlePsngrList | |
PassengerOrganizational | 旅客组织架构 | String | TrainSettleInfoList.TrainSettlePsngrList | |
PassengerCostCenterCode | 成本中心编号 | String | TrainSettleInfoList.TrainSettlePsngrList | |
PassengerCostCenter | 成本中心名称 | String | TrainSettleInfoList.TrainSettlePsngrList | |
PassengerCostCenterFullLevel | 成本中心(全级) | String | TrainSettleInfoList.TrainSettlePsngrList | |
PassengerCostCenterRemark | 成本中心备注 | String | TrainSettleInfoList.TrainSettlePsngrList | |
PassengerType | 旅客类型 | String | TrainSettleInfoList.TrainSettlePsngrList | |
TravelPolicyViolations | 违反差旅政策项目 | String | TrainSettleInfoList.TrainSettlePsngrList | |
ReasonsViolatingTravelPolicy | 违反差旅政策原因 | String | TrainSettleInfoList.TrainSettlePsngrList | |
PassengerCostCenterPrice | 旅客成本中心金额 | Number | TrainSettleInfoList.TrainSettlePsngrList | |
ShippingSpace | 席位 | String | TrainSettleInfoList.TrainSettlePsngrList | |
TravelImageUrl | 行程单影像资料 | String | TrainSettleInfoList.TrainSettlePsngrList | |
TrainSettlePsngrSegmentList | 旅客行程列表 | Array[] | TrainSettleInfoList.TrainSettlePsngrList | |
RecordId | 消费记录编号 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
OrderNo | 订单编号 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
PassengerNo | 旅客编号 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
SegmentNo | 航段序号 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
FlightNumber | 车次 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
DepartureAirportName | 出发站-中文 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
PlaceDepartureCityEn | 出发站-英文 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
DepartureAirportCode | 出发站代码 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
DepartureTime | 出发时间 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
DecAirportName | 到达站-中文 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
DestinationEn | 到达站-英文 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
DecAirportCode | 到达站代码 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
ArrivalTime | 到达时间 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
CabinEn | 席位类别-英文 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
CabinCn | 席位类别-中文 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
ShippingSpace | 席位 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList | |
TravelImageUrl | 行程单影像资料 | String | TrainSettleInfoList.TrainSettlePsngrList.TrainSettlePsngrSegmentList |
{
"TrainSettleInfoList":
[{
"TrainSettlePsngrList":
[{
"RecordId":"XF230000030513",
"OrderNo":"RB230004587",
"PassengerNo":"P852494",
"FaceValuePrice":85,
"TaxationFee":0,
"UpgradeFee":0,
"EndorsementFee":0,
"ServiceCharge":8,
"CancellationFee":0,
"ElectronicOrderNumber":"22-41543034",
"PassengerName":"刘展超",
"PassengerNameCn":"刘展超",
"PassengerStaffNo":"ak1002",
"PassengerCertificateNo":"440183198612054555",
"PassengerOrganizational": "",
"PassengerCostCenterCode": "",
"PassengerCostCenter": "",
"PassengerCostCenterFullLevel": "",
"PassengerCostCenterRemark": "",
"PassengerType":"成人",
"TravelPolicyViolations": "",
"ReasonsViolatingTravelPolicy": "",
"PassengerCostCenterPrice":0,
"ShippingSpace": "",
"TravelImageUrl": "",
"TrainSettlePsngrSegmentList":
[{
"RecordId": "",
"OrderNo": "",
"PassengerNo": "",
"SegmentNo": "",
"FlightNumber": "",
"DepartureAirportName": "",
"PlaceDepartureCityEn": "",
"DepartureAirportCode": "",
"DepartureTime": "",
"DecAirportName": "",
"DestinationEn": "",
"DecAirportCode": "",
"ArrivalTime": "",
"CabinEn": "",
"CabinCn": "",
"ShippingSpace": "",
"TravelImageUrl": ""
}]
}],
"RecordId":"XF230000030513",
"OrderNo":"RB230004587",
"CompanyId":"S118022",
"CompanyName":"美亚测试股份有限公司",
"GroupId":"G112178",
"GroupName":"OA对接专用集团",
"OaSerialNumber":"SL230075845",
"PayType":1,
"CardId":"CC220000011",
"CardIdLast":"0011",
"SettleSerialNo": "",
"SettleStatus":0,
"BillBeginning":"0001-01-01",
"BillDeadLine":"0001-01-01",
"BillDate":"0001-01-01",
"ExpireDate":"0001-01-01",
"CustomerRemark": "",
"SettleTime":"2023-10-09",
"RebackOrderNo":"RB230004587",
"OpDate": "",
"ProcessTime":"2023-10-09",
"OrderType":1,
"BookingType":0,
"OrderSource":"在线预订",
"BookingChannelName":"PC端对接",
"OpId":"P767609",
"OpName":"东方不败",
"OpDepartment":"部门",
"OpOrganization":"部门",
"CustomerCreatorEmployeeNo":"123456",
"ProductSubType":2023-10-09T18:05:20,
"ProductSubTypeName":"国内火车票",
"ProductNature": "",
"EndorsementType": "",
"ReasonChange": "",
"RefundType": "",
"ReasonRefund": "",
"TimeSubmissionAapproval":"2023-10-09",
"Uatp":"N",
"UATPcardNumber": "",
"FinalJudge":"系统自动",
"FinalReviewTime":"2023-10-09",
"CommentsBehalfApproval": "",
"TravelNumber":"1",
"DepartureCity":"广州南",
"PlaceDepartureCityEn":"guangzhounan",
"PlaceDepartureCityCodeEn":"IZQ",
"TimeOfDeparture":"2023-10-09 10:20:00",
"ArrivalCity":"深圳北",
"DestinationEn":"shenzhenbei",
"ArrivalAirportStationCode":"IOQ",
"TimeOfArrival":"2023-10-09 12:20:00",
"ProductGradeEn": "",
"ProductLevel":"一等座",
"ReceivableFee":85,
"Currency":"CNY",
"TOrderNo": "",
"TRType": "",
"RecordIdMin": "",
"MergePayAmountRmb":0,
"VersionNumber":0,
"CustomerFields1": "",
"CustomerFields2": "",
"CustomerFields3": "",
"CustomerFields4": "",
"CustomerFields5": "",
"CustomerFields6": "",
"CustomerFields7": "",
"CustomerFields8": ""
}],
"IsSucceed":false,
"ErrorMsgID":0,
"ErrorMsg": "",
"TotalCount":0,
"PageIndex":0,
"PageSize":0
}
结算信息汇总接口(按产品类型汇总)
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
recordIds | 记录编号列表 最多100条,结算批次号、账单编号最多10条 | Array[] | 否 | |
recordType | 记录类型 1消费记录编号2 订单编号 3 结算批次号4 账单编号 | String | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数(最大500) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"recordIds":[],
"recordType": "",
"pageIndex":1,
"pageSize":200,
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
IsSucceed | 是否成功查询 | Boolean | ||
ErrorMsgID | 错误信息标志号 0-正常 | Integer | ||
ErrorMsg | 错误信息 | String | ||
TotalCount | Integer | |||
PageIndex | 页面索引 | Integer | ||
PageSize | 页大小 | Integer | ||
SettleSumDtos | Array[] | |||
ProductType |
产品类型
DT 国内机票 IT 国际机票 DH 国内酒店 IH 国际酒店 TT 火车票 |
String | SettleSumDtos | |
AmountType |
费用类型
1 服务费 2 退票手续费 3 改签手续费 4 票款 5 房费 6 保费 7 金额 8 消费金额 15 旅客表房费 18 旅客表应收 |
String | SettleSumDtos | |
Amount | 费用 | Number | SettleSumDtos |
{
"SettleSumDtos":
[{
"ProductType": "",
"AmountType": "",
"Amount":0
}],
"IsSucceed":false,
"ErrorMsgID":0,
"ErrorMsg": "",
"TotalCount":0,
"PageIndex":0,
"PageSize":0
}
分页获取账单结算影像资料列表
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
settleSerialNo | 结算批次号(结算批次号(只查发票) | String | 否 | |
recordIds | 账单编号列表/认领记录编号 | Array[] | 否 | |
SettleSerialNos | 结算批次号列表(根据InvoiceType 查询对应关联订单的行程单或者火车票) | Array[] | 否 | |
invoiceType |
发票类型
1 火车票 2 行程单 3 发票 4 签章文件 |
String | 是 | |
yiCodes |
票号/序列号/发票号码 编号列表
添加日期: 2024-08-27 |
Array[] | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数(最大500) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"settleSerialNo": "",
"recordIds":[],
"SettleSerialNos":"[“AA”,“BB”]",
"invoiceType": "",
"yiCodes":[],
"pageIndex":1,
"pageSize":200,
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
IsSucceed | 是否成功查询 | Boolean | ||
ErrorMsgID | 错误信息标志号 0-正常 | Integer | ||
ErrorMsg | 错误信息 | String | ||
TotalCount | Integer | |||
PageIndex | 页面索引 | Integer | ||
PageSize | 页大小 | Integer | ||
BillSettleImageInfoList | Array[] | |||
ImageCode | 影像编号 | String | BillSettleImageInfoList | |
BuyerName | 购方名称 | String | BillSettleImageInfoList | |
BuyerTaxNumber | 购方税号 | String | BillSettleImageInfoList | |
BuyerAddressTel | 购方地址电话 | String | BillSettleImageInfoList | |
BuyerBankAccount | 购方开户行账户 | String | BillSettleImageInfoList | |
SaleName | 销方名称 | String | BillSettleImageInfoList | |
SaleTaxNumber | 销方税号 | String | BillSettleImageInfoList | |
SaleAddressTel | 销方地址及电话 | String | BillSettleImageInfoList | |
SaleBankAccount | 销方开户行及账户 | String | BillSettleImageInfoList | |
InvoiceType |
发票类型
1:火车票 2:行程单 3:发票 4:签章文件 |
Integer | BillSettleImageInfoList | |
InvoiceSubType |
发票子类型
1 增值税专用发票 2 增值税普通发票 3 增值税普通发票(电子) 4 增值税普通发票(卷式) 5 增值税电子专用发票 6 电子发票(全电专票) 7 航空运输电子客票行程单 8 火车票 9 电子发票(全电普票) 12 电子发票(航空运输电子客票行程单) 91 全电纸票(增值税专用发票) |
Integer | BillSettleImageInfoList | |
TsiCode | 发票代码 | String | BillSettleImageInfoList | |
YiCode | 发票号码 | String | BillSettleImageInfoList | |
Jym | 校验码 | String | BillSettleImageInfoList | |
MachineCode | 机器编码 | String | BillSettleImageInfoList | |
Area | 所属行政区名称 | String | BillSettleImageInfoList | |
Remark | 备注 | String | BillSettleImageInfoList | |
ImageUrl | 影像地址 | String | BillSettleImageInfoList | |
InvoiceStatus | 发票状态 1:正常 2:已作废 | Integer | BillSettleImageInfoList | |
FaceValue | 票面金额 | Number | BillSettleImageInfoList | |
FaceValueUp | 票面金额(大写) | String | BillSettleImageInfoList | |
HjseAmount | 合计税额(抵扣税额) | Number | BillSettleImageInfoList | |
BillingDate | 开票日期 | String | BillSettleImageInfoList | |
Amount | 不含税金额 | Number | BillSettleImageInfoList | |
FuelSurtax | 燃油附加税 | Number | BillSettleImageInfoList | |
SjhjAmount | 价税合计(票价) | Number | BillSettleImageInfoList | |
TicketFaceValue | 机票票面价 | Number | BillSettleImageInfoList | |
CivilAviationDevelopmentFund | 民航发展基金 | Number | BillSettleImageInfoList | |
InvoiceApplySubList |
关联ia单订单明细
添加日期: 2024-02-05 |
Array[] | BillSettleImageInfoList | |
InvoiceApplySubCode | 发票申请单订单明细编号 | String | BillSettleImageInfoList.InvoiceApplySubList | |
InvoiceApplyCode | 发票申请单编号 | String | BillSettleImageInfoList.InvoiceApplySubList | |
OrderNo | 订单号 | String | BillSettleImageInfoList.InvoiceApplySubList | |
TotalAmount | 开票金额 | Number | BillSettleImageInfoList.InvoiceApplySubList | |
ImageDetailsList | 货物明细列表 | Array[] | BillSettleImageInfoList | |
ImageDetailsCode | 影像明细编号 | String | BillSettleImageInfoList.ImageDetailsList | |
ImageCode | 影像编号 | String | BillSettleImageInfoList.ImageDetailsList | |
GoodsTaxableServicesName | 货物或应税劳务名称 | String | BillSettleImageInfoList.ImageDetailsList | |
InvoiceSpecifications | 规格型号 | String | BillSettleImageInfoList.ImageDetailsList | |
InvoiceUnit | 单位 | String | BillSettleImageInfoList.ImageDetailsList | |
InvoiceCount | 数量 | String | BillSettleImageInfoList.ImageDetailsList | |
Price | 单价 | Number | BillSettleImageInfoList.ImageDetailsList | |
Amount | 金额 | Number | BillSettleImageInfoList.ImageDetailsList | |
TaxRate | 税率 | String | BillSettleImageInfoList.ImageDetailsList | |
JeAmount | 税额 | Number | BillSettleImageInfoList.ImageDetailsList | |
ImageClaimRecordList | 认领列表 | Array[] | BillSettleImageInfoList | |
RecordId | 消费记录编号 | String | BillSettleImageInfoList.ImageClaimRecordList | |
ImageClaimCode | 影像认领编号 | String | BillSettleImageInfoList.ImageClaimRecordList | |
ImageCode | 影像编号 | String | BillSettleImageInfoList.ImageClaimRecordList | |
OrderNo | 业务单号 | String | BillSettleImageInfoList.ImageClaimRecordList | |
PsngrId | 旅客编码 | String | BillSettleImageInfoList.ImageClaimRecordList | |
BusinessOrderType | 业务单据类型 1:账单 2订单 3:结算批次号 | Integer | BillSettleImageInfoList.ImageClaimRecordList | |
Claimant | 认领人 | String | BillSettleImageInfoList.ImageClaimRecordList | |
ClaimantCode | 认领人编码 | String | BillSettleImageInfoList.ImageClaimRecordList | |
ClaimTime | 认领时间 | String | BillSettleImageInfoList.ImageClaimRecordList | |
StaffCode | 旅客工号/外部旅客编号 | String | BillSettleImageInfoList.ImageClaimRecordList | |
PassengerName | 旅客姓名 | String | BillSettleImageInfoList.ImageClaimRecordList |
{
"BillSettleImageInfoList":
[{
"ImageCode": "",
"BuyerName": "",
"BuyerTaxNumber": "",
"BuyerAddressTel": "",
"BuyerBankAccount": "",
"SaleName": "",
"SaleTaxNumber": "",
"SaleAddressTel": "",
"SaleBankAccount": "",
"InvoiceType":0,
"InvoiceSubType":0,
"TsiCode": "",
"YiCode": "",
"Jym": "",
"MachineCode": "",
"Area": "",
"Remark": "",
"ImageUrl": "",
"InvoiceStatus":0,
"FaceValue":0,
"FaceValueUp": "",
"HjseAmount":0,
"BillingDate": "",
"Amount":0,
"FuelSurtax":0,
"SjhjAmount":0,
"TicketFaceValue":0,
"CivilAviationDevelopmentFund":0,
"ImageDetailsList":
[{
"ImageDetailsCode": "",
"ImageCode": "",
"GoodsTaxableServicesName": "",
"InvoiceSpecifications": "",
"InvoiceUnit": "",
"InvoiceCount": "",
"Price":0,
"Amount":0,
"TaxRate": "",
"JeAmount":0
}],
"ImageClaimRecordList":
[{
"RecordId": "",
"ImageClaimCode": "",
"ImageCode": "",
"OrderNo": "",
"PsngrId": "",
"BusinessOrderType":0,
"Claimant": "",
"ClaimantCode": "",
"ClaimTime": "",
"StaffCode": "",
"PassengerName": ""
}],
"InvoiceApplySubList":
[{
"InvoiceApplySubCode": "",
"InvoiceApplyCode": "",
"OrderNo": "",
"TotalAmount":0
}]
}],
"IsSucceed":false,
"ErrorMsgID":0,
"ErrorMsg": "",
"TotalCount":0,
"PageIndex":0,
"PageSize":0
}
分页获取账单结算影像资料列表
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
settleSerialNo | 结算批次号(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
settletTimeStart | 结算时间-开始((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
settletTimeEnd | 结算时间-结束((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
purchaseTimeStart | 消费时间-开始((消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
purchaseTimeEnd | 消费时间-结束(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
orderNo | 订单编号 | String | 否 | |
recordIds | 消费记录编号(消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | Array[] | 否 | |
billingPeriod | 账期,如 202401 (消费时间/结算时间、settleSerialNo、recordIds、billingPeriod至少1项必填) | String | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数(最大500) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"settleSerialNo": "",
"settletTimeStart":"2023-09-27",
"settletTimeEnd":"2023-10-27",
"purchaseTimeStart":"2023-09-27",
"purchaseTimeEnd":"2023-10-27",
"orderNo": "",
"recordIds":"[“AA”,“BB”]",
"billingPeriod": "",
"pageIndex":1,
"pageSize":200,
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
IsSucceed | 是否成功查询 | Boolean | ||
ErrorMsgID | 错误信息标志号 0-正常 | Integer | ||
ErrorMsg | 错误信息 | String | ||
TotalCount | Integer | |||
PageIndex | 页面索引 | Integer | ||
PageSize | 页大小 | Integer | ||
UCSettleInfoList | Array[] | |||
RecordId | 消费记录编号 | String | UCSettleInfoList | |
OrderNo | 订单编号 | String | UCSettleInfoList | |
CompanyId | 客户编码 | String | UCSettleInfoList | |
CompanyName | 客户名称 | String | UCSettleInfoList | |
GroupId | 集团编码 | String | UCSettleInfoList | |
GroupName | 集团名称 | String | UCSettleInfoList | |
OaSerialNumber | 出差申请单号 | String | UCSettleInfoList | |
PayType | 消费支付类型:1:信用消费2:即付消费 | Integer | UCSettleInfoList | |
CardId | 信用卡号 | String | UCSettleInfoList | |
CardIdLast | 信用卡号末4位 | String | UCSettleInfoList | |
SettleSerialNo | 结算批次号 | String | UCSettleInfoList | |
SettleStatus | 对账状态:待核对-1 待推送-2 推送中-3 待确认(推送成功)-4 已确认-5 推送失败-6 关账-7 | Integer | UCSettleInfoList | |
BillId | 账单编号 | String | UCSettleInfoList | |
BillBeginning | 账单起始日期 | String | UCSettleInfoList | |
BillDeadLine | 账单截止日期 | String | UCSettleInfoList | |
BillDate | 出账日期 | String | UCSettleInfoList | |
ExpireDate | 到期还款日 | String | UCSettleInfoList | |
CustomerRemark | 客户备注 | String | UCSettleInfoList | |
SettleTime | 结算生成时间 | String | UCSettleInfoList | |
RebackOrderNo | 关联单号 | String | UCSettleInfoList | |
OpDate | 预订时间 | String | UCSettleInfoList | |
ProcessTime | 处理时间 | String | UCSettleInfoList | |
OrderType | 订单类型 1订购单、2变更单、3退订单、4调整单、5积分单、102计费单 报价单订单类型 11报价订购单 12报价变更单 13报价退订单 | Integer | UCSettleInfoList | |
BookingType | 出差性质 -1 无 0是因公 1是因私 | Integer | UCSettleInfoList | |
OrderSource | 订单来源 | String | UCSettleInfoList | |
BookingChannelName | 预订渠道 | String | UCSettleInfoList | |
OpId | 客户制单人Id | String | UCSettleInfoList | |
OpName | 客户制单人名称 | String | UCSettleInfoList | |
OpDepartment | 客户制单人部门 | String | UCSettleInfoList | |
OpOrganization | 客户制单人组织架构 | String | UCSettleInfoList | |
CustomerCreatorEmployeeNo | 客户制单人员工工号 | String | UCSettleInfoList | |
FlightTravelTime | 飞行/出行时长 | String | UCSettleInfoList | |
Mileage | 里程 | Number | UCSettleInfoList | |
TripSummary | 出行摘要 | String | UCSettleInfoList | |
ReceivableFee | 应收 | Number | UCSettleInfoList | |
VersionNumber | 版本号 | Integer | UCSettleInfoList | |
ProductSubType | 产品子类型 | Integer | UCSettleInfoList | |
ProductSubTypeName | 产品子类型名称 | String | UCSettleInfoList | |
Currency | 结算币种 | String | UCSettleInfoList | |
ServiceFee | 服务费收入 | Number | UCSettleInfoList | |
PassengerName | 旅客姓名 | String | UCSettleInfoList | |
PassengerChineseName | 旅客中文姓名 | String | UCSettleInfoList | |
PassengerOrganization | 旅客组织架构 | String | UCSettleInfoList | |
DepartureCity | 出发地 | String | UCSettleInfoList | |
ActualPlaceDepartureDetails | 实际出发地(详情) | String | UCSettleInfoList | |
TimeOfDeparture | 出发时间 | String | UCSettleInfoList | |
ArrivalCity | 到达地 | String | UCSettleInfoList | |
ActualDestinationDetails | 实际到达地(详情) | String | UCSettleInfoList | |
TimeOfArrival | 到达时间 | String | UCSettleInfoList | |
ProductLevel | 产品等级 | String | UCSettleInfoList |
{
"UCSettleInfoList":
[{
"RecordId": "",
"OrderNo": "",
"CompanyId": "",
"CompanyName": "",
"GroupId": "",
"GroupName": "",
"OaSerialNumber": "",
"PayType":0,
"CardId": "",
"CardIdLast": "",
"SettleSerialNo": "",
"SettleStatus":0,
"BillId": "",
"BillBeginning": "",
"BillDeadLine": "",
"BillDate": "",
"ExpireDate": "",
"CustomerRemark": "",
"SettleTime": "",
"RebackOrderNo": "",
"OpDate": "",
"ProcessTime": "",
"OrderType":0,
"BookingType":0,
"OrderSource": "",
"BookingChannelName": "",
"OpId": "",
"OpName": "",
"OpDepartment": "",
"OpOrganization": "",
"CustomerCreatorEmployeeNo": "",
"FlightTravelTime": "",
"Mileage":0,
"TripSummary": "",
"ReceivableFee":0,
"VersionNumber":0,
"ProductSubType":0,
"ProductSubTypeName": "",
"Currency": "",
"ServiceFee":0,
"PassengerName": "",
"PassengerChineseName": "",
"PassengerOrganization": "",
"DepartureCity": "",
"ActualPlaceDepartureDetails": "",
"TimeOfDeparture": "",
"ArrivalCity": "",
"ActualDestinationDetails": "",
"TimeOfArrival": "",
"ProductLevel": ""
}],
"IsSucceed":false,
"ErrorMsgID":0,
"ErrorMsg": "",
"TotalCount":0,
"PageIndex":0,
"PageSize":0
}
线上确认账单,申请开票据
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
companyCode | 公司编号* | String | 否 | |
invoiceTitle | 若按成本中心开票,则传成本中心即可 若按组织架构开票,则传组织架构即可 若按项目开票,则传项目号即可 主要用于区分 当前是谁为票 | String | 否 | |
documentType |
单据编号依据
0、settlementBatchNumber 为 结算批次号 1、settlementBatchNumber 为 消费记录编号 2、settlementBatchNumber 为 订单编号 |
Integer | 否 | |
settlementBatchNumber |
单号值 根据 documentType 值决定,
documentType=0 结算批次号 documentType=1 消费记录编号 documentType=2 订单编号 |
Array[] | 否 | |
confirmedAmount | 确认金额(多批次号总金额)* | Number | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数(最大500) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
invoice | 发票信息* | ConfirmBillApplyInvoiceInfo | 否 | |
invoiceTitle | 发票抬头* | String | invoice | |
taxpayerNumber | 纳税人识别号* | String | invoice | |
addressAndPhone | 地址电话 | String | invoice | |
bankAccount | 开户行及账号 | String | invoice | |
invoiceRemarks | 发票备注 | String | invoice | |
specificationModel | 规格型号 | String | invoice | |
unit | 单位 张/项 默认:项 | String | invoice | |
contactPersonName | 联系人-姓名* | String | invoice | |
contactPersonPhone | 联系人-电话/手机号 | String | invoice | |
deliveryAddress | 配送地址 用于配送纸质发票/行程单 | String | invoice | |
邮箱* 用于接收发票 | String | invoice |
{
"companyCode":"S118022",
"invoiceTitle": "",
"documentType":0,
"settlementBatchNumber":":['MY_ZD21','MY_ZD22']",
"invoice":
{
"invoiceTitle":"美亚营销有限公司",
"taxpayerNumber":"91320191MA1MNRW1X7",
"addressAndPhone":"开发区025-12358088",
"bankAccount":"ABC支行8258521013300112255",
"invoiceRemarks":"无",
"specificationModel":"无",
"unit":"无",
"contactPersonName":"刘展超",
"contactPersonPhone":"13115011234",
"deliveryAddress":"广州大道北520",
"email":"abcef@meiya.com"
},
"confirmedAmount":56255.00,
"pageIndex":1,
"pageSize":200,
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
isSucceed | 接口处理成功与否的唯一标识 True:接口成功 False:接口失败 | Boolean | ||
code | 错误码 200:成功 500:系统异常 401:授权验证失败 | String | ||
errmsg | 错误信息 | String | ||
invoiceNumber | 编号 接收成功时,返回 开票申请管理列表的 编号 | String | ||
confirmedAmount | 确认金额 确认失败的返回美亚的账单总金额 | Number |
{
"isSucceed":true,
"code":"200",
"errmsg": "",
"invoiceNumber":"["MY_ZD230002433005_hotel_20230901","MY_ZD230002433005_flight_20230901"]",
"confirmedAmount":329.00
}
确认账单
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
settleSerialNos | 结算批次号 | Array[] | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"settleSerialNos":[],
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000",
"description":"请求成功"
}
确认消费记录(账单)
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
recordIds | 消费记录编号,最多支持 100 | Array[] | 是 | |
result |
确认结果
5 确认正常 51 确认异常 4 逆向待确认 |
Integer | 是 | |
remark | result=51 确认异常时,传异常原因 result=4 逆向待确认,传原因 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"recordIds":[],
"result":0,
"remark": "",
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000",
"description":"请求成功"
}
申请发票
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
documentType |
单据编号依据
0、documentNumber 为 结算批次号 1、documentNumber 为 消费记录编号 2、documentNumber 为 订单编号 |
Integer | 是 | |
documentNumber | 单号值 根据 documentType 值决定 最多支持 5000 | Array[] | 是 | |
applyNo | 客户开票申请单号 | String | 是 | |
applyAmount | 申请金额(最多2位小数) | Number | 是 | |
applyProduct |
开票产品
机票/酒店/火车票/保险/签证
机票 酒店 火车票 保险 签证 |
String | 是 | |
applyProductSubType |
产品子类型 applyProduct=机票/酒店 有用
国内机票 国际机票 国内酒店 国际酒店 添加日期: 2024-08-27 |
String | 是 | |
applyBasis |
开票依据
- 表示 减号
服务费 手续费 票面价 房费 总金额 手续费+服务费 超标个人承担金额 总金额-超标个付 总金额-服务费-超标个付 |
String | 是 | |
contactsName | 联系人-姓名 | String | 是 | |
邮箱 | String | 否 | ||
contactsPhone | 联系人-电话/手机号 | String | 否 | |
invoiceTitle | 发票抬头* | String | 是 | |
taxpayerNumber | 纳税人识别号* | String | 是 | |
addressTel | 地址电话 | String | 否 | |
bankAccount | 开户行及账号 | String | 否 | |
invoiceRemarks | 发票备注 | String | 否 | |
specificationModel | 规格型号 | String | 否 | |
unit | 单位 张/项 默认:项 | String | 否 | |
deliveryAddress | 配送地址 用于配送纸质发票/行程单 | String | 否 | |
invoiceType |
开具单据类型 默认 1
1 发票 2 INVOICE 添加日期: 2025-05-03 |
Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"documentType":0,
"documentNumber":[],
"applyNo": "",
"applyAmount":0,
"applyProduct": "",
"applyProductSubType": "",
"applyBasis": "",
"contactsName": "",
"email": "",
"contactsPhone": "",
"invoiceTitle": "",
"taxpayerNumber": "",
"addressTel": "",
"bankAccount": "",
"invoiceRemarks": "",
"specificationModel": "",
"unit": "",
"deliveryAddress": "",
"invoiceType":0,
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000",
"description":"请求成功"
}
查询发票详细
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsideApplyNo | 客户开票申请单号 客户、美亚开票申请单号 二选一 | String | 否 | |
invoiceNo | 美亚开票申请单号 客户、美亚开票申请单号 二选一 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"outsideApplyNo": "",
"invoiceNo": "",
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
data | ApiInvoicePush | |||
companyId | 公司编号 | String | data | |
applyNoCustomer | 客户开票申请单号 | String | data | |
invoiceNoMeiYa | 美亚开票申请单号 | String | data | |
invoiceStatus | 申请单状态 3 处理成功 4 处理失败 0 创建订单 | Integer | data | |
invoiceStatusName | 申请单状态名称 处理成功、处理失败、创建订单 | String | data | |
opDate | 制单时间 | String | data | |
issueDate | 处理时间 | String | data | |
invoiceNature | 开票性质 1 公司发票 2 个人发票 , | Integer | data | |
invoiceType | 发票类型 | String | data | |
invoiceTypeId | 发票类型ID | Integer | data | |
invoiceTitle | 发票抬头 | String | data | |
taxpayerNumber | 纳税人识别号 | String | data | |
bankAccount | 开户行及账号 | String | data | |
addressAndPhone | 地址电话 | String | data | |
invoiceContent | 发票内容 | String | data | |
taxTypeName | 税收分类名称 | String | data | |
specificationModel | 规格型号 | String | data | |
quantity | 数量 | Integer | data | |
unit | 单位 | Integer | data | |
invoiceRemarks | 发票备注 | String | data | |
totalAmount | 申请开票总金额 | Number | data | |
invoiceBasisId | 开票依据 Id | Integer | data | |
invoiceBasis | 开票依据 | String | data | |
invoiceContact | 发票联系人 | ApiQueryInvoiceContact | data | |
name | 姓名 | String | data.invoiceContact | |
mobile | 手机 | String | data.invoiceContact | |
邮箱 | String | data.invoiceContact | ||
invoiceInfos | 发票信息列表 | Array[] | data | |
invoiceNumber | 发票号码 | String | data.invoiceInfos | |
invoiceCode | 发票代码 | String | data.invoiceInfos | |
invoiceAddressXML | 发票地址XML | String | data.invoiceInfos | |
invoiceAddressOFD | 发票地址OFD | String | data.invoiceInfos | |
invoiceAddressPDF | 发票地址PDF | String | data.invoiceInfos | |
invoiceDate | 开票日期 | String | data.invoiceInfos | |
amount | 发票金额 | String | data.invoiceInfos |
{
"data":
{
"companyId": "",
"applyNoCustomer": "",
"invoiceNoMeiYa": "",
"invoiceStatus":0,
"invoiceStatusName": "",
"opDate": "",
"issueDate": "",
"invoiceNature":0,
"invoiceType": "",
"invoiceTypeId":0,
"invoiceTitle": "",
"taxpayerNumber": "",
"bankAccount": "",
"addressAndPhone": "",
"invoiceContent": "",
"taxTypeName": "",
"specificationModel": "",
"quantity":0,
"unit":0,
"invoiceRemarks": "",
"totalAmount":0,
"invoiceBasisId":0,
"invoiceBasis": "",
"invoiceInfos":
[{
"invoiceNumber": "",
"invoiceCode": "",
"invoiceAddressXML": "",
"invoiceAddressOFD": "",
"invoiceAddressPDF": "",
"invoiceDate": "",
"amount": ""
}],
"invoiceContact":
{
"name": "",
"mobile": "",
"email": ""
}
},
"code":"10000",
"description":"请求成功"
}
国内机票电子行程单 开具申请
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
title | 公司发票抬头 | String | 是 | |
taxNo | 税号 | String | 是 | |
invoicingMethod | 开票方式 0=拆分开具 1 =合并开具 不传值时默认拆分开具。 | Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
ticketList | 票号列表 (单次请求不超过100个票号,国内/国际机票请分开请求) | Array[] | 是 | |
orderNo | 订单编号(非必填,国内如:TB2300000008,国际不用传值) | String | ticketList | |
ticketNo | 票号 (必填 如:111-1234567890) | String | ticketList | |
passengerName | 乘机人姓名(非必填,传值则校验订单中旅客姓名) | String | ticketList |
{
"title":"AAA公司", //公司发票抬头
"taxNo":"0000001", //税号
"ticketList":
[{
"orderNo":"TB2300000008", //订单编号(非必填,国内如:TB2300000008,国际不用传值)
"ticketNo":"111-1234567890", //票号 (必填 如:111-1234567890)
"passengerName":"张三", //乘机人姓名(非必填,传值则校验订单中旅客姓名)
}], //票号列表 (单次请求不超过100个票号,国内/国际机票请分开请求)
"invoicingMethod":0, //开票方式 0=拆分开具 1 =合并开具 不传值时默认拆分开具。
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
ticketList | 电子行程单列表 | Array[] | ||
ticketNo | 票号 | String | ticketList | |
type | 申请结果 0 = 申请成功 1 = 申请失败 | Integer | ticketList | |
errCode | 失败原因编号 (默认=0) 1 = 客票已开具电子行程单不能重复申请(开具成功) 2 = 客票已申请,开具中,不能重复申请 3 = 查无此票号或票号校验异常 4 = 已申请纸质电子行程单,不可申请电子行程单 5 = 客票费用为0,不支持开具电子行程单。 6 = 客票发生改期,合并申请电子行程单需要使用改期后的客票号申请,或者改用拆分申请。 7 = 客票已退票或非已使用状态,不符合电子行程单开具规则 8 = 客户不在可开具电子行程单范围内 9 = 客票不在可开具电子行程单范围内 10 = 接口异常 11 = 其它 | Integer | ticketList | |
message | 原因描述(成功单号或失败原因) | String | ticketList |
{
"ticketList":
[{
"ticketNo": "", //票号
"type":0, //申请结果
0 = 申请成功
1 = 申请失败
"errCode":0, //失败原因编号 (默认=0)
1 = 客票已开具电子行程单不能重复申请(开具成功)
2 = 客票已申请,开具中,不能重复申请
3 = 查无此票号或票号校验异常
4 = 已申请纸质电子行程单,不可申请电子行程单
5 = 客票费用为0,不支持开具电子行程单。
6 = 客票发生改期,合并申请电子行程单需要使用改期后的客票号申请,或者改用拆分申请。
7 = 客票已退票或非已使用状态,不符合电子行程单开具规则
8 = 客户不在可开具电子行程单范围内
9 = 客票不在可开具电子行程单范围内
10 = 接口异常
11 = 其它
"message": "", //原因描述(成功单号或失败原因)
}], //电子行程单列表
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票电子行程单 作废申请
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
sessionId | sessionId,login接口返回 | String | 是 | |
ticketList | 票号列表 (单次请求不超过100个票号,国内/国际机票请分开请求) | Array[] | 是 | |
itineraryNumber | 行程单号(票号和行程单号二者其中一个必填) | String | ticketList | |
ticketNo | 票号 (票号和行程单号二者其中一个必填) | String | ticketList | |
passengerName | 乘机人姓名(非必填,传值则校验订单中旅客姓名) | String | ticketList |
{
"ticketList":
[{
"itineraryNumber":"01234567890123456789", //行程单号(票号和行程单号二者其中一个必填)
"ticketNo":"111-1234567890", //票号 (票号和行程单号二者其中一个必填)
"passengerName":"张三", //乘机人姓名(非必填,传值则校验订单中旅客姓名)
}], //票号列表 (单次请求不超过100个票号,国内/国际机票请分开请求)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
ticketList | 电子行程单列表 | Array[] | ||
ticketNo | 票号 | String | ticketList | |
type | 申请结果 0 = 申请成功 1 = 申请失败 | Integer | ticketList | |
errCode | 失败原因编号 (默认=0) 1 = 已作废,不能重复作废 2 = 作废处理中,不能重复作废 3 = 已申请纸质作废单,不能重复作废 4 = 纸质行程单暂时不支持在线申请 5 = 查找不到对应客票/行程单 6 = 乘机人姓名匹配失败 10 = 接口异常 11 = 其它 | Integer | ticketList | |
message | 失败原因 | String | ticketList |
{
"ticketList":
[{
"ticketNo": "", //票号
"type":0, //申请结果
0 = 申请成功
1 = 申请失败
"errCode":0, //失败原因编号 (默认=0)
1 = 已作废,不能重复作废
2 = 作废处理中,不能重复作废
3 = 已申请纸质作废单,不能重复作废
4 = 纸质行程单暂时不支持在线申请
5 = 查找不到对应客票/行程单
6 = 乘机人姓名匹配失败
10 = 接口异常
11 = 其它
"message": "", //失败原因
}], //电子行程单列表
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
查询国内机票行程单 开具/作废结果
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
numberType | 行程单类型 0=蓝单(开具),1=红单(作废), 不填默认蓝单 =0 | Integer | 是 | |
itineraryNumber | 行程单号 纸质/电子行程单号(开具)/(作废)冲红行程单号 如:12345678901234567890 (纸质/电子行程单号 或 票号 至少一个必填) | String | 否 | |
ticketNo | 票号 如:111-1234567890 (纸质/电子行程单 行程单号 或 票号 至少一个必填) | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"numberType":0, //行程单类型
0=蓝单(开具),1=红单(作废),
不填默认蓝单 =0
"itineraryNumber":"12345678901234567890", //行程单号
纸质/电子行程单号(开具)/(作废)冲红行程单号 如:12345678901234567890
(纸质/电子行程单号 或 票号 至少一个必填)
"ticketNo":"111-1234567890", //票号 如:111-1234567890
(纸质/电子行程单 行程单号 或 票号 至少一个必填)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
ofdBase64String | 电子行程单ofd文件 对应的 base64编码字符 | String | ||
fileName | 电子行程单ofd文件名 | String | ||
ticketNo | 票号 | String | ||
itineraryType | 行程类型 0=纸质行程单 1=电子行程单号 | Integer | ||
msg | 开具结果: "未查找到行程单申请开具记录","处理中","开具成功","开具失败" ,"作废成功","作废失败" | String | ||
itineraryNumber | 行程单号 纸质行程单号 2021000005 电子行程单号 22228882211000066666 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"ofdBase64String":"UEsDBBQAAAAIACtOllgq6qh3PQEAALoCAAAHAAAAT0ZELnhtbG2S0W6CMBSG75fsHZrej7asbkgA40ZMlsUs2dxuF4GDuig1UMd8tl3skfYKHlDEigkp6df......", //电子行程单ofd文件 对应的 base64编码字符
"fileName":"******.ofd", //电子行程单ofd文件名
"ticketNo":"666-01234566666", //票号
"itineraryType":0, //行程类型
0=纸质行程单 1=电子行程单号
"msg":"开具成功", //开具结果:
"未查找到行程单申请开具记录","处理中","开具成功","开具失败" ,"作废成功","作废失败"
"itineraryNumber":"2021000005", //行程单号
纸质行程单号 2021000005 电子行程单号 22228882211000066666
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
查询电子行程单开具结果(开发中)
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
ticketNumber | 票号 7813406797921 | String | 是 | |
orderNo | 美亚订单号 | String | 是 | |
orgCode | 航信提供的企业编码 | String | 是 | |
requestId | 票号对应的上传批次号(授权通知推送的批次号) | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"ticketNumber": "", //票号 7813406797921
"orderNo": "", //美亚订单号
"orgCode": "", //航信提供的企业编码
"requestId": "", //票号对应的上传批次号(授权通知推送的批次号)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
data | 开具结果 | Array[] | ||
requestId | 请求批次号 | String | data | |
ticketNumber | 机票票号 | String | data | |
itineraryNumber | 电子行程单号 | String | data | |
message | 开具结果信息 | String | data | |
issueStatus | 开具结果状态(0=未开具,1=开具成功,2=开具失败,3=开具中,4=未知) | String | data | |
issueTime | 开具时间(yyyy-MM-dd HH:mm:ss) | String | data |
{
"data":
[{
"requestId": "", //请求批次号
"ticketNumber": "", //机票票号
"itineraryNumber": "", //电子行程单号
"message": "", //开具结果信息
"issueStatus": "", //开具结果状态(0=未开具,1=开具成功,2=开具失败,3=开具中,4=未知)
"issueTime": "", //开具时间(yyyy-MM-dd HH:mm:ss)
}], //开具结果
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
行程单开具作废换开(石化)
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
applyType | 申请类型 MI:开具 VI:作废 RI:换开 | String | 否 | |
sessionId | 内部为空(内部系统还是用header验证) 外部系统使用登录接口返回 sessionId | String | 否 | |
invoiceInfos | 开票信息集合 | Array[] | 否 | |
ticketNo | 票号 999-00000000000 | String | invoiceInfos | |
taxbuyerId | 企业税号 | String | invoiceInfos | |
taxbuyerName | 企业名称 | String | invoiceInfos | |
remarkMsg | 换开备注 临时传参 | String | invoiceInfos |
{
"applyType": "", //申请类型
MI:开具 VI:作废 RI:换开
"invoiceInfos":
[{
"ticketNo": "", //票号
999-00000000000
"taxbuyerId": "", //企业税号
"taxbuyerName": "", //企业名称
"remarkMsg": "", //换开备注 临时传参
}], //开票信息集合
"sessionId": "", //内部为空(内部系统还是用header验证) 外部系统使用登录接口返回 sessionId
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
state | 提交状态 true:接受成功 false:接受失败 | Boolean | ||
msg | 描述信息 | String |
{
"state":false, //提交状态
true:接受成功 false:接受失败
"msg": "", //描述信息
}
线上创建改签单(含改签费用)
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsideOrderNo | 外部订单号 | String | 否 | |
originalOrderNo | 美亚原订购单号 | String | 否 | |
opRemark | 备注 | String | 否 | |
ticketNo | 客票号 | Array[] | 否 | |
changeType | 改签类型 自愿改签 = 100, 非自愿改签 = 200 | Integer | 否 | |
changeReason | 改签原因 | String | 否 | |
pnr | 新PNR | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
onlineChangePrice | 改签费用 | Array[] | 否 | |
passType | 旅客类型 成人/儿童/婴儿 | String | onlineChangePrice | |
personNum | 人数 | Integer | onlineChangePrice | |
upgradeFee | 升舱费 | Number | onlineChangePrice | |
sellAmount | 变更手续费 | Number | onlineChangePrice | |
airPortFee | 机建费 | Number | onlineChangePrice | |
oilFee | 燃油费 | Number | onlineChangePrice | |
servicePrice | 服务费 | Number | onlineChangePrice | |
total | 费用合计(单人) | Number | onlineChangePrice | |
flightList | 航段列表 | Array[] | 否 | |
flightID | 航班ID(从查询航班返回获取) | String | flightList | |
departureCity | 出发城市(三字码) | String | flightList | |
arrivalCity | 达到城市(三字码) | String | flightList | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList | |
airline | 航空二字码,如 MU | String | flightList | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList | |
secondFlight | 预订多程中转航班时需要必传; | FlightInfoForCreateBase | flightList | |
flightID | 航班ID(从查询航班返回获取) | String | flightList.secondFlight | |
departureCity | 出发城市(三字码) | String | flightList.secondFlight | |
arrivalCity | 达到城市(三字码) | String | flightList.secondFlight | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList.secondFlight | |
airline | 航空二字码,如 MU | String | flightList.secondFlight | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList.secondFlight | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList.secondFlight | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList.secondFlight |
{
"outsideOrderNo": "", //外部订单号
"originalOrderNo":"TB2301733006", //美亚原订购单号
"opRemark": "", //备注
"flightList":
[{
"secondFlight":
{
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}, //预订多程中转航班时需要必传;
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}], //航段列表
"ticketNo":"[“999 - 3102966118”]", //客票号
"onlineChangePrice":
[{
"passType":"成人", //旅客类型
成人/儿童/婴儿
"personNum":1, //人数
"upgradeFee":320.0, //升舱费
"sellAmount":120.0, //变更手续费
"airPortFee":0.0, //机建费
"oilFee":0.0, //燃油费
"servicePrice":10, //服务费
"total":450.0, //费用合计(单人)
}], //改签费用
"changeType":100, //改签类型 自愿改签 = 100,
非自愿改签 = 200
"changeReason": "", //改签原因
"pnr":"KDL0N7", //新PNR
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 订单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo":"TB2301733006", //订单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
线上退票创建退票单
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订购单号 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
changePrice | 改签费用信息 | Array[] | 否 | |
passType | 旅客类型 成人/儿童/婴儿 | String | changePrice | |
personNum | 人数 | Integer | changePrice | |
upgradeFee | 升舱费 | Number | changePrice | |
sellAmount | 变更手续费 | Number | changePrice | |
airPortFee | 机建费 | Number | changePrice | |
oilFee | 燃油费 | Number | changePrice | |
servicePrice | 服务费 | Number | changePrice | |
total | 费用合计(单人) | Number | changePrice |
{
"orderNo": "", //美亚订购单号
"changePrice":
[{
"passType":"成人", //旅客类型
成人/儿童/婴儿
"personNum":1, //人数
"upgradeFee":320.0, //升舱费
"sellAmount":120.0, //变更手续费
"airPortFee":0.0, //机建费
"oilFee":0.0, //燃油费
"servicePrice":10, //服务费
"total":450.0, //费用合计(单人)
}], //改签费用信息
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票获取订单详情
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订购单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB230004581", //美亚订购单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
orderInfo | 返回结果 | TBOrderInfo | ||
costList | 成本中心 | Array[] | orderInfo | |
costCenterName | 成本中心名称 | String | orderInfo.costList | |
contactInfo | 联系信息 | ContactInfo | orderInfo | |
contactName | 联系人 | String | orderInfo.contactInfo | |
mobile | 手机号码 | String | orderInfo.contactInfo | |
phone | 联系电话 | String | orderInfo.contactInfo | |
电子邮件 | String | orderInfo.contactInfo | ||
priceList | 机票价格 | Array[] | orderInfo | |
orderNo | 订单编号 | String | orderInfo.priceList | |
passengerType | 旅客类型 | String | orderInfo.priceList | |
price | 价格 | Number | orderInfo.priceList | |
returnprice | 退还费用 | Number | orderInfo.priceList | |
tax | 税费 | Number | orderInfo.priceList | |
serviceAmount | 服务费 | Number | orderInfo.priceList | |
discount | 折扣 | Number | orderInfo.priceList | |
baseInfo | 订单基本信息 | OrderBaseInfo | orderInfo | |
pnr | String | orderInfo.baseInfo | ||
outsideOrderNo | 外部订单编号 | String | orderInfo.baseInfo | |
orderNo | 美亚订单号 | String | orderInfo.baseInfo | |
originalOrderNo | 原订单编号 改签、退票、废票单的原单编号,订购单时为空 | String | orderInfo.baseInfo | |
opDate | 建单时间 | String | orderInfo.baseInfo | |
opName | 客户制单人 | String | orderInfo.baseInfo | |
statusText | 订单状态(中文) | String | orderInfo.baseInfo | |
status | 订单状态 | Integer | orderInfo.baseInfo | |
orderType | 订单类型(1->国内订购单,2->国内改签单,3->国内退票单) | Integer | orderInfo.baseInfo | |
productType | 产品类型 产品子类型 1-机票 | Integer | orderInfo.baseInfo | |
issueDate | 出票时间 | String | orderInfo.baseInfo | |
oaSerialnumber | 出差申请单号 | String | orderInfo.baseInfo | |
TotalPay | 订单总金额 | Number | orderInfo.baseInfo | |
opRemark | 操作备注 | String | orderInfo.baseInfo | |
passengerList | 乘机人 | Array[] | orderInfo | |
orderNo | 订单编号 | String | orderInfo.passengerList | |
passengerNo | 订单乘机人编号 | Integer | orderInfo.passengerList | |
passengerCode | 乘机人编码 | String | orderInfo.passengerList | |
passengerName | 乘机人名称 | String | orderInfo.passengerList | |
gender | 性别 | String | orderInfo.passengerList | |
nationality | 国籍 | String | orderInfo.passengerList | |
certificateType | 证件类型 | String | orderInfo.passengerList | |
certificateID | 证件号码 | String | orderInfo.passengerList | |
passengerType | 乘机人类型 | String | orderInfo.passengerList | |
birthday | 生日 | String | orderInfo.passengerList | |
reasonID | 差旅政策违反原因 | Integer | orderInfo.passengerList | |
reasonRemark | 差旅政策违反原因 | String | orderInfo.passengerList | |
ticketNo | 在国内、国际酒店中代表房间号,从1开始 | String | orderInfo.passengerList | |
OutsidePsngrId | 外部旅客编号 add 2017-04-06 jiayi | String | orderInfo.passengerList | |
segmentList | 航班信息 | Array[] | orderInfo | |
orderNo | 订单编码 | String | orderInfo.segmentList | |
cabin | 大舱位 | String | orderInfo.segmentList | |
clazz | 小舱位 | String | orderInfo.segmentList | |
planeType | 机型 | String | orderInfo.segmentList | |
airlineCode | 行司代码 | String | orderInfo.segmentList | |
segmentNo | 行段序号 | Integer | orderInfo.segmentList | |
flightNo | 航班号 | String | orderInfo.segmentList | |
originName | 出发机场名称 | String | orderInfo.segmentList | |
destinationName | 终点机场名称 | String | orderInfo.segmentList | |
departureDate | 出发日期 | String | orderInfo.segmentList | |
departureTime | 出发时间 | String | orderInfo.segmentList | |
arrivalDate | 到达日期 | String | orderInfo.segmentList | |
arrivalTime | 到达时间 | String | orderInfo.segmentList | |
flyTime | 飞行时间 | String | orderInfo.segmentList | |
carrier | 共享航班号 | String | orderInfo.segmentList | |
stopItem | 经停 | String | orderInfo.segmentList | |
originCityCode | 出发城市编号 | String | orderInfo.segmentList | |
destinationCityCode | 到达城市编号 | String | orderInfo.segmentList | |
origincityName | 出发城市名称 | String | orderInfo.segmentList | |
destinationCityName | 到达城市名称 | String | orderInfo.segmentList | |
depTerminal | 开始航站楼 | String | orderInfo.segmentList | |
arrTerminal | 到达航站楼 | String | orderInfo.segmentList | |
airlineName | 航司名称 | String | orderInfo.segmentList | |
remark | 备注 | String | orderInfo.segmentList |
{
"orderInfo":
{
"baseInfo":
{
"pnr":"HR8RV4", //
"outsideOrderNo":"SL445885212", //外部订单编号
"orderNo":"TB2301732275", //美亚订单号
"originalOrderNo":"HR8RV4", //原订单编号 改签、退票、废票单的原单编号,订购单时为空
"opDate":"2023-10-23 09:35", //建单时间
"opName":"刘展超", //客户制单人
"statusText":"已出票", //订单状态(中文)
"status":40, //订单状态
"orderType":1, //订单类型(1->国内订购单,2->国内改签单,3->国内退票单)
"productType":1, //产品类型 产品子类型 1-机票
"issueDate":"2023-10-23 09:36", //出票时间
"oaSerialnumber":"SL445885212", //出差申请单号
"TotalPay":1500, //订单总金额
"opRemark":"无", //操作备注
}, //订单基本信息
"segmentList":
[{
"orderNo": "", //订单编码
"cabin": "", //大舱位
"clazz": "", //小舱位
"planeType": "", //机型
"airlineCode": "", //行司代码
"segmentNo":0, //行段序号
"flightNo": "", //航班号
"originName": "", //出发机场名称
"destinationName": "", //终点机场名称
"departureDate": "", //出发日期
"departureTime": "", //出发时间
"arrivalDate": "", //到达日期
"arrivalTime": "", //到达时间
"flyTime": "", //飞行时间
"carrier": "", //共享航班号
"stopItem": "", //经停
"originCityCode": "", //出发城市编号
"destinationCityCode": "", //到达城市编号
"origincityName": "", //出发城市名称
"destinationCityName": "", //到达城市名称
"depTerminal": "", //开始航站楼
"arrTerminal": "", //到达航站楼
"airlineName": "", //航司名称
"remark": "", //备注
}], //航班信息
"priceList":
[{
"orderNo": "", //订单编号
"passengerType": "", //旅客类型
"price":0, //价格
"returnprice":0, //退还费用
"tax":0, //税费
"serviceAmount":0, //服务费
"discount":0, //折扣
}], //机票价格
"passengerList":
[{
"orderNo": "", //订单编号
"passengerNo":0, //订单乘机人编号
"passengerCode": "", //乘机人编码
"passengerName": "", //乘机人名称
"gender": "", //性别
"nationality": "", //国籍
"certificateType": "", //证件类型
"certificateID": "", //证件号码
"passengerType": "", //乘机人类型
"birthday": "", //生日
"reasonID":0, //差旅政策违反原因
"reasonRemark": "", //差旅政策违反原因
"ticketNo": "", //在国内、国际酒店中代表房间号,从1开始
"OutsidePsngrId": "", //外部旅客编号
add 2017-04-06 jiayi
}], //乘机人
"costList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系信息
}, //返回结果
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票查询退票单详情
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
returnOrderInfo | 退单信息 | TROrderInfo | ||
contactInfo | 联系信息 | ContactInfo | returnOrderInfo | |
contactName | 联系人 | String | returnOrderInfo.contactInfo | |
mobile | 手机号码 | String | returnOrderInfo.contactInfo | |
phone | 联系电话 | String | returnOrderInfo.contactInfo | |
电子邮件 | String | returnOrderInfo.contactInfo | ||
returnPriceList | 改签单价格信息 | Array[] | returnOrderInfo | |
orderNo | 退票单编号 | String | returnOrderInfo.returnPriceList | |
passengerType | 旅客类型 | String | returnOrderInfo.returnPriceList | |
passengerNum | 旅客人数 | Integer | returnOrderInfo.returnPriceList | |
sellAmount | 金额 | Number | returnOrderInfo.returnPriceList | |
sellTax | 税 | Number | returnOrderInfo.returnPriceList | |
sellReturnCommission | 退票手续费 | Number | returnOrderInfo.returnPriceList | |
sellUsedFlight | 已使用航段费 | Number | returnOrderInfo.returnPriceList | |
sellServiceFee | 服务费 | Number | returnOrderInfo.returnPriceList | |
baseInfo | 订单基本信息 | OrderBaseInfo | returnOrderInfo | |
pnr | String | returnOrderInfo.baseInfo | ||
outsideOrderNo | 外部订单编号 | String | returnOrderInfo.baseInfo | |
orderNo | 美亚订单号 | String | returnOrderInfo.baseInfo | |
originalOrderNo | 原订单编号 改签、退票、废票单的原单编号,订购单时为空 | String | returnOrderInfo.baseInfo | |
opDate | 建单时间 | String | returnOrderInfo.baseInfo | |
opName | 客户制单人 | String | returnOrderInfo.baseInfo | |
statusText | 订单状态(中文) | String | returnOrderInfo.baseInfo | |
status | 订单状态 | Integer | returnOrderInfo.baseInfo | |
orderType | 订单类型(1->国内订购单,2->国内改签单,3->国内退票单) | Integer | returnOrderInfo.baseInfo | |
productType | 产品类型 产品子类型 1-机票 | Integer | returnOrderInfo.baseInfo | |
issueDate | 出票时间 | String | returnOrderInfo.baseInfo | |
oaSerialnumber | 出差申请单号 | String | returnOrderInfo.baseInfo | |
TotalPay | 订单总金额 | Number | returnOrderInfo.baseInfo | |
opRemark | 操作备注 | String | returnOrderInfo.baseInfo | |
passengerList | 乘机人 | Array[] | returnOrderInfo | |
orderNo | 订单编号 | String | returnOrderInfo.passengerList | |
passengerNo | 订单乘机人编号 | Integer | returnOrderInfo.passengerList | |
passengerCode | 乘机人编码 | String | returnOrderInfo.passengerList | |
passengerName | 乘机人名称 | String | returnOrderInfo.passengerList | |
gender | 性别 | String | returnOrderInfo.passengerList | |
nationality | 国籍 | String | returnOrderInfo.passengerList | |
certificateType | 证件类型 | String | returnOrderInfo.passengerList | |
certificateID | 证件号码 | String | returnOrderInfo.passengerList | |
passengerType | 乘机人类型 | String | returnOrderInfo.passengerList | |
birthday | 生日 | String | returnOrderInfo.passengerList | |
reasonID | 差旅政策违反原因 | Integer | returnOrderInfo.passengerList | |
reasonRemark | 差旅政策违反原因 | String | returnOrderInfo.passengerList | |
ticketNo | 在国内、国际酒店中代表房间号,从1开始 | String | returnOrderInfo.passengerList | |
OutsidePsngrId | 外部旅客编号 add 2017-04-06 jiayi | String | returnOrderInfo.passengerList | |
segmentList | 航班信息 | Array[] | returnOrderInfo | |
orderNo | 订单编码 | String | returnOrderInfo.segmentList | |
cabin | 大舱位 | String | returnOrderInfo.segmentList | |
clazz | 小舱位 | String | returnOrderInfo.segmentList | |
planeType | 机型 | String | returnOrderInfo.segmentList | |
airlineCode | 行司代码 | String | returnOrderInfo.segmentList | |
segmentNo | 行段序号 | Integer | returnOrderInfo.segmentList | |
flightNo | 航班号 | String | returnOrderInfo.segmentList | |
originName | 出发机场名称 | String | returnOrderInfo.segmentList | |
destinationName | 终点机场名称 | String | returnOrderInfo.segmentList | |
departureDate | 出发日期 | String | returnOrderInfo.segmentList | |
departureTime | 出发时间 | String | returnOrderInfo.segmentList | |
arrivalDate | 到达日期 | String | returnOrderInfo.segmentList | |
arrivalTime | 到达时间 | String | returnOrderInfo.segmentList | |
flyTime | 飞行时间 | String | returnOrderInfo.segmentList | |
carrier | 共享航班号 | String | returnOrderInfo.segmentList | |
stopItem | 经停 | String | returnOrderInfo.segmentList | |
originCityCode | 出发城市编号 | String | returnOrderInfo.segmentList | |
destinationCityCode | 到达城市编号 | String | returnOrderInfo.segmentList | |
origincityName | 出发城市名称 | String | returnOrderInfo.segmentList | |
destinationCityName | 到达城市名称 | String | returnOrderInfo.segmentList | |
depTerminal | 开始航站楼 | String | returnOrderInfo.segmentList | |
arrTerminal | 到达航站楼 | String | returnOrderInfo.segmentList | |
airlineName | 航司名称 | String | returnOrderInfo.segmentList | |
remark | 备注 | String | returnOrderInfo.segmentList |
{
"returnOrderInfo":
{
"baseInfo":
{
"pnr":"HR8RV4", //
"outsideOrderNo":"SL445885212", //外部订单编号
"orderNo":"TB2301732275", //美亚订单号
"originalOrderNo":"HR8RV4", //原订单编号 改签、退票、废票单的原单编号,订购单时为空
"opDate":"2023-10-23 09:35", //建单时间
"opName":"刘展超", //客户制单人
"statusText":"已出票", //订单状态(中文)
"status":40, //订单状态
"orderType":1, //订单类型(1->国内订购单,2->国内改签单,3->国内退票单)
"productType":1, //产品类型 产品子类型 1-机票
"issueDate":"2023-10-23 09:36", //出票时间
"oaSerialnumber":"SL445885212", //出差申请单号
"TotalPay":1500, //订单总金额
"opRemark":"无", //操作备注
}, //订单基本信息
"segmentList":
[{
"orderNo": "", //订单编码
"cabin": "", //大舱位
"clazz": "", //小舱位
"planeType": "", //机型
"airlineCode": "", //行司代码
"segmentNo":0, //行段序号
"flightNo": "", //航班号
"originName": "", //出发机场名称
"destinationName": "", //终点机场名称
"departureDate": "", //出发日期
"departureTime": "", //出发时间
"arrivalDate": "", //到达日期
"arrivalTime": "", //到达时间
"flyTime": "", //飞行时间
"carrier": "", //共享航班号
"stopItem": "", //经停
"originCityCode": "", //出发城市编号
"destinationCityCode": "", //到达城市编号
"origincityName": "", //出发城市名称
"destinationCityName": "", //到达城市名称
"depTerminal": "", //开始航站楼
"arrTerminal": "", //到达航站楼
"airlineName": "", //航司名称
"remark": "", //备注
}], //航班信息
"returnPriceList":
[{
"orderNo": "", //退票单编号
"passengerType": "", //旅客类型
"passengerNum":0, //旅客人数
"sellAmount":0, //金额
"sellTax":0, //税
"sellReturnCommission":0, //退票手续费
"sellUsedFlight":0, //已使用航段费
"sellServiceFee":0, //服务费
}], //改签单价格信息
"passengerList":
[{
"orderNo": "", //订单编号
"passengerNo":0, //订单乘机人编号
"passengerCode": "", //乘机人编码
"passengerName": "", //乘机人名称
"gender": "", //性别
"nationality": "", //国籍
"certificateType": "", //证件类型
"certificateID": "", //证件号码
"passengerType": "", //乘机人类型
"birthday": "", //生日
"reasonID":0, //差旅政策违反原因
"reasonRemark": "", //差旅政策违反原因
"ticketNo": "", //在国内、国际酒店中代表房间号,从1开始
"OutsidePsngrId": "", //外部旅客编号
add 2017-04-06 jiayi
}], //乘机人
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系信息
}, //退单信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票退票单列表查询
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
originalOrderNo | 美亚原订购单号 | String | 否 | |
opId | 制单人编号 | String | 否 | |
outsideOpId | 制单人的外部系统编号 | String | 否 | |
orderNo | 退票单号 | String | 否 | |
departureCity | 出发城市 三字码(如:CAN) | String | 否 | |
arrivalCity | 到达城市 三字码(如:CAN) | String | 否 | |
startTime | 制单时间范围(开始) | String | 否 | |
endTime | 制单时间范围(结束) | String | 否 | |
startDepartureTime | 出发时间范围(开始) | String | 否 | |
endDepartureTime | 出发时间范围(结束) | String | 否 | |
status | 订单状态 | Integer | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数 | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"originalOrderNo": "", //美亚原订购单号
"opId": "", //制单人编号
"outsideOpId": "", //制单人的外部系统编号
"orderNo": "", //退票单号
"departureCity": "", //出发城市 三字码(如:CAN)
"arrivalCity": "", //到达城市 三字码(如:CAN)
"startTime": "", //制单时间范围(开始)
"endTime": "", //制单时间范围(结束)
"startDepartureTime": "", //出发时间范围(开始)
"endDepartureTime": "", //出发时间范围(结束)
"status":0, //订单状态
"pageIndex":0, //页码
"pageSize":0, //每页记录数
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
totalCount | 订单总数 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
returnOrderList | 退票单列表 | Array[] | ||
contactInfo | 联系信息 | ContactInfo | returnOrderList | |
contactName | 联系人 | String | returnOrderList.contactInfo | |
mobile | 手机号码 | String | returnOrderList.contactInfo | |
phone | 联系电话 | String | returnOrderList.contactInfo | |
电子邮件 | String | returnOrderList.contactInfo | ||
returnPriceList | 改签单价格信息 | Array[] | returnOrderList | |
orderNo | 退票单编号 | String | returnOrderList.returnPriceList | |
passengerType | 旅客类型 | String | returnOrderList.returnPriceList | |
passengerNum | 旅客人数 | Integer | returnOrderList.returnPriceList | |
sellAmount | 金额 | Number | returnOrderList.returnPriceList | |
sellTax | 税 | Number | returnOrderList.returnPriceList | |
sellReturnCommission | 退票手续费 | Number | returnOrderList.returnPriceList | |
sellUsedFlight | 已使用航段费 | Number | returnOrderList.returnPriceList | |
sellServiceFee | 服务费 | Number | returnOrderList.returnPriceList | |
baseInfo | 订单基本信息 | OrderBaseInfo | returnOrderList | |
pnr | String | returnOrderList.baseInfo | ||
outsideOrderNo | 外部订单编号 | String | returnOrderList.baseInfo | |
orderNo | 美亚订单号 | String | returnOrderList.baseInfo | |
originalOrderNo | 原订单编号 改签、退票、废票单的原单编号,订购单时为空 | String | returnOrderList.baseInfo | |
opDate | 建单时间 | String | returnOrderList.baseInfo | |
opName | 客户制单人 | String | returnOrderList.baseInfo | |
statusText | 订单状态(中文) | String | returnOrderList.baseInfo | |
status | 订单状态 | Integer | returnOrderList.baseInfo | |
orderType | 订单类型(1->国内订购单,2->国内改签单,3->国内退票单) | Integer | returnOrderList.baseInfo | |
productType | 产品类型 产品子类型 1-机票 | Integer | returnOrderList.baseInfo | |
issueDate | 出票时间 | String | returnOrderList.baseInfo | |
oaSerialnumber | 出差申请单号 | String | returnOrderList.baseInfo | |
TotalPay | 订单总金额 | Number | returnOrderList.baseInfo | |
opRemark | 操作备注 | String | returnOrderList.baseInfo | |
passengerList | 乘机人 | Array[] | returnOrderList | |
orderNo | 订单编号 | String | returnOrderList.passengerList | |
passengerNo | 订单乘机人编号 | Integer | returnOrderList.passengerList | |
passengerCode | 乘机人编码 | String | returnOrderList.passengerList | |
passengerName | 乘机人名称 | String | returnOrderList.passengerList | |
gender | 性别 | String | returnOrderList.passengerList | |
nationality | 国籍 | String | returnOrderList.passengerList | |
certificateType | 证件类型 | String | returnOrderList.passengerList | |
certificateID | 证件号码 | String | returnOrderList.passengerList | |
passengerType | 乘机人类型 | String | returnOrderList.passengerList | |
birthday | 生日 | String | returnOrderList.passengerList | |
reasonID | 差旅政策违反原因 | Integer | returnOrderList.passengerList | |
reasonRemark | 差旅政策违反原因 | String | returnOrderList.passengerList | |
ticketNo | 在国内、国际酒店中代表房间号,从1开始 | String | returnOrderList.passengerList | |
OutsidePsngrId | 外部旅客编号 add 2017-04-06 jiayi | String | returnOrderList.passengerList | |
segmentList | 航班信息 | Array[] | returnOrderList | |
orderNo | 订单编码 | String | returnOrderList.segmentList | |
cabin | 大舱位 | String | returnOrderList.segmentList | |
clazz | 小舱位 | String | returnOrderList.segmentList | |
planeType | 机型 | String | returnOrderList.segmentList | |
airlineCode | 行司代码 | String | returnOrderList.segmentList | |
segmentNo | 行段序号 | Integer | returnOrderList.segmentList | |
flightNo | 航班号 | String | returnOrderList.segmentList | |
originName | 出发机场名称 | String | returnOrderList.segmentList | |
destinationName | 终点机场名称 | String | returnOrderList.segmentList | |
departureDate | 出发日期 | String | returnOrderList.segmentList | |
departureTime | 出发时间 | String | returnOrderList.segmentList | |
arrivalDate | 到达日期 | String | returnOrderList.segmentList | |
arrivalTime | 到达时间 | String | returnOrderList.segmentList | |
flyTime | 飞行时间 | String | returnOrderList.segmentList | |
carrier | 共享航班号 | String | returnOrderList.segmentList | |
stopItem | 经停 | String | returnOrderList.segmentList | |
originCityCode | 出发城市编号 | String | returnOrderList.segmentList | |
destinationCityCode | 到达城市编号 | String | returnOrderList.segmentList | |
origincityName | 出发城市名称 | String | returnOrderList.segmentList | |
destinationCityName | 到达城市名称 | String | returnOrderList.segmentList | |
depTerminal | 开始航站楼 | String | returnOrderList.segmentList | |
arrTerminal | 到达航站楼 | String | returnOrderList.segmentList | |
airlineName | 航司名称 | String | returnOrderList.segmentList | |
remark | 备注 | String | returnOrderList.segmentList |
{
"returnOrderList":
[{
"baseInfo":
{
"pnr":"HR8RV4", //
"outsideOrderNo":"SL445885212", //外部订单编号
"orderNo":"TB2301732275", //美亚订单号
"originalOrderNo":"HR8RV4", //原订单编号 改签、退票、废票单的原单编号,订购单时为空
"opDate":"2023-10-23 09:35", //建单时间
"opName":"刘展超", //客户制单人
"statusText":"已出票", //订单状态(中文)
"status":40, //订单状态
"orderType":1, //订单类型(1->国内订购单,2->国内改签单,3->国内退票单)
"productType":1, //产品类型 产品子类型 1-机票
"issueDate":"2023-10-23 09:36", //出票时间
"oaSerialnumber":"SL445885212", //出差申请单号
"TotalPay":1500, //订单总金额
"opRemark":"无", //操作备注
}, //订单基本信息
"segmentList":
[{
"orderNo": "", //订单编码
"cabin": "", //大舱位
"clazz": "", //小舱位
"planeType": "", //机型
"airlineCode": "", //行司代码
"segmentNo":0, //行段序号
"flightNo": "", //航班号
"originName": "", //出发机场名称
"destinationName": "", //终点机场名称
"departureDate": "", //出发日期
"departureTime": "", //出发时间
"arrivalDate": "", //到达日期
"arrivalTime": "", //到达时间
"flyTime": "", //飞行时间
"carrier": "", //共享航班号
"stopItem": "", //经停
"originCityCode": "", //出发城市编号
"destinationCityCode": "", //到达城市编号
"origincityName": "", //出发城市名称
"destinationCityName": "", //到达城市名称
"depTerminal": "", //开始航站楼
"arrTerminal": "", //到达航站楼
"airlineName": "", //航司名称
"remark": "", //备注
}], //航班信息
"returnPriceList":
[{
"orderNo": "", //退票单编号
"passengerType": "", //旅客类型
"passengerNum":0, //旅客人数
"sellAmount":0, //金额
"sellTax":0, //税
"sellReturnCommission":0, //退票手续费
"sellUsedFlight":0, //已使用航段费
"sellServiceFee":0, //服务费
}], //改签单价格信息
"passengerList":
[{
"orderNo": "", //订单编号
"passengerNo":0, //订单乘机人编号
"passengerCode": "", //乘机人编码
"passengerName": "", //乘机人名称
"gender": "", //性别
"nationality": "", //国籍
"certificateType": "", //证件类型
"certificateID": "", //证件号码
"passengerType": "", //乘机人类型
"birthday": "", //生日
"reasonID":0, //差旅政策违反原因
"reasonRemark": "", //差旅政策违反原因
"ticketNo": "", //在国内、国际酒店中代表房间号,从1开始
"OutsidePsngrId": "", //外部旅客编号
add 2017-04-06 jiayi
}], //乘机人
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系信息
}], //退票单列表
"totalCount":0, //订单总数
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票查询改签单详情
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订单号,共用的实体,订单号展示只做示例 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301739858", //美亚订单号,共用的实体,订单号展示只做示例
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
changeOrderInfo | 改签单 | TCOrderInfo | ||
contactInfo | 联系信息 | ContactInfo | changeOrderInfo | |
contactName | 联系人 | String | changeOrderInfo.contactInfo | |
mobile | 手机号码 | String | changeOrderInfo.contactInfo | |
phone | 联系电话 | String | changeOrderInfo.contactInfo | |
电子邮件 | String | changeOrderInfo.contactInfo | ||
priceList | 改签单价格信息 | Array[] | changeOrderInfo | |
orderNo | 改签单编号 | String | changeOrderInfo.priceList | |
passengerType | 旅客类型 | String | changeOrderInfo.priceList | |
passengerNum | 旅客人数 | Integer | changeOrderInfo.priceList | |
sellAmount | 金额 | Number | changeOrderInfo.priceList | |
sellServiceFee | 服务费 | Number | changeOrderInfo.priceList | |
sellTax | 税费 | Number | changeOrderInfo.priceList | |
baseInfo | 订单基本信息 | OrderBaseInfo | changeOrderInfo | |
pnr | String | changeOrderInfo.baseInfo | ||
outsideOrderNo | 外部订单编号 | String | changeOrderInfo.baseInfo | |
orderNo | 美亚订单号 | String | changeOrderInfo.baseInfo | |
originalOrderNo | 原订单编号 改签、退票、废票单的原单编号,订购单时为空 | String | changeOrderInfo.baseInfo | |
opDate | 建单时间 | String | changeOrderInfo.baseInfo | |
opName | 客户制单人 | String | changeOrderInfo.baseInfo | |
statusText | 订单状态(中文) | String | changeOrderInfo.baseInfo | |
status | 订单状态 | Integer | changeOrderInfo.baseInfo | |
orderType | 订单类型(1->国内订购单,2->国内改签单,3->国内退票单) | Integer | changeOrderInfo.baseInfo | |
productType | 产品类型 产品子类型 1-机票 | Integer | changeOrderInfo.baseInfo | |
issueDate | 出票时间 | String | changeOrderInfo.baseInfo | |
oaSerialnumber | 出差申请单号 | String | changeOrderInfo.baseInfo | |
TotalPay | 订单总金额 | Number | changeOrderInfo.baseInfo | |
opRemark | 操作备注 | String | changeOrderInfo.baseInfo | |
passengerList | 乘机人 | Array[] | changeOrderInfo | |
orderNo | 订单编号 | String | changeOrderInfo.passengerList | |
passengerNo | 订单乘机人编号 | Integer | changeOrderInfo.passengerList | |
passengerCode | 乘机人编码 | String | changeOrderInfo.passengerList | |
passengerName | 乘机人名称 | String | changeOrderInfo.passengerList | |
gender | 性别 | String | changeOrderInfo.passengerList | |
nationality | 国籍 | String | changeOrderInfo.passengerList | |
certificateType | 证件类型 | String | changeOrderInfo.passengerList | |
certificateID | 证件号码 | String | changeOrderInfo.passengerList | |
passengerType | 乘机人类型 | String | changeOrderInfo.passengerList | |
birthday | 生日 | String | changeOrderInfo.passengerList | |
reasonID | 差旅政策违反原因 | Integer | changeOrderInfo.passengerList | |
reasonRemark | 差旅政策违反原因 | String | changeOrderInfo.passengerList | |
ticketNo | 在国内、国际酒店中代表房间号,从1开始 | String | changeOrderInfo.passengerList | |
OutsidePsngrId | 外部旅客编号 add 2017-04-06 jiayi | String | changeOrderInfo.passengerList | |
segmentList | 航班信息 | Array[] | changeOrderInfo | |
orderNo | 订单编码 | String | changeOrderInfo.segmentList | |
cabin | 大舱位 | String | changeOrderInfo.segmentList | |
clazz | 小舱位 | String | changeOrderInfo.segmentList | |
planeType | 机型 | String | changeOrderInfo.segmentList | |
airlineCode | 行司代码 | String | changeOrderInfo.segmentList | |
segmentNo | 行段序号 | Integer | changeOrderInfo.segmentList | |
flightNo | 航班号 | String | changeOrderInfo.segmentList | |
originName | 出发机场名称 | String | changeOrderInfo.segmentList | |
destinationName | 终点机场名称 | String | changeOrderInfo.segmentList | |
departureDate | 出发日期 | String | changeOrderInfo.segmentList | |
departureTime | 出发时间 | String | changeOrderInfo.segmentList | |
arrivalDate | 到达日期 | String | changeOrderInfo.segmentList | |
arrivalTime | 到达时间 | String | changeOrderInfo.segmentList | |
flyTime | 飞行时间 | String | changeOrderInfo.segmentList | |
carrier | 共享航班号 | String | changeOrderInfo.segmentList | |
stopItem | 经停 | String | changeOrderInfo.segmentList | |
originCityCode | 出发城市编号 | String | changeOrderInfo.segmentList | |
destinationCityCode | 到达城市编号 | String | changeOrderInfo.segmentList | |
origincityName | 出发城市名称 | String | changeOrderInfo.segmentList | |
destinationCityName | 到达城市名称 | String | changeOrderInfo.segmentList | |
depTerminal | 开始航站楼 | String | changeOrderInfo.segmentList | |
arrTerminal | 到达航站楼 | String | changeOrderInfo.segmentList | |
airlineName | 航司名称 | String | changeOrderInfo.segmentList | |
remark | 备注 | String | changeOrderInfo.segmentList |
{
"changeOrderInfo":
{
"baseInfo":
{
"pnr":"HR8RV4", //
"outsideOrderNo":"SL445885212", //外部订单编号
"orderNo":"TB2301732275", //美亚订单号
"originalOrderNo":"HR8RV4", //原订单编号 改签、退票、废票单的原单编号,订购单时为空
"opDate":"2023-10-23 09:35", //建单时间
"opName":"刘展超", //客户制单人
"statusText":"已出票", //订单状态(中文)
"status":40, //订单状态
"orderType":1, //订单类型(1->国内订购单,2->国内改签单,3->国内退票单)
"productType":1, //产品类型 产品子类型 1-机票
"issueDate":"2023-10-23 09:36", //出票时间
"oaSerialnumber":"SL445885212", //出差申请单号
"TotalPay":1500, //订单总金额
"opRemark":"无", //操作备注
}, //订单基本信息
"segmentList":
[{
"orderNo": "", //订单编码
"cabin": "", //大舱位
"clazz": "", //小舱位
"planeType": "", //机型
"airlineCode": "", //行司代码
"segmentNo":0, //行段序号
"flightNo": "", //航班号
"originName": "", //出发机场名称
"destinationName": "", //终点机场名称
"departureDate": "", //出发日期
"departureTime": "", //出发时间
"arrivalDate": "", //到达日期
"arrivalTime": "", //到达时间
"flyTime": "", //飞行时间
"carrier": "", //共享航班号
"stopItem": "", //经停
"originCityCode": "", //出发城市编号
"destinationCityCode": "", //到达城市编号
"origincityName": "", //出发城市名称
"destinationCityName": "", //到达城市名称
"depTerminal": "", //开始航站楼
"arrTerminal": "", //到达航站楼
"airlineName": "", //航司名称
"remark": "", //备注
}], //航班信息
"priceList":
[{
"orderNo": "", //改签单编号
"passengerType": "", //旅客类型
"passengerNum":0, //旅客人数
"sellAmount":0, //金额
"sellServiceFee":0, //服务费
"sellTax":0, //税费
}], //改签单价格信息
"passengerList":
[{
"orderNo": "", //订单编号
"passengerNo":0, //订单乘机人编号
"passengerCode": "", //乘机人编码
"passengerName": "", //乘机人名称
"gender": "", //性别
"nationality": "", //国籍
"certificateType": "", //证件类型
"certificateID": "", //证件号码
"passengerType": "", //乘机人类型
"birthday": "", //生日
"reasonID":0, //差旅政策违反原因
"reasonRemark": "", //差旅政策违反原因
"ticketNo": "", //在国内、国际酒店中代表房间号,从1开始
"OutsidePsngrId": "", //外部旅客编号
add 2017-04-06 jiayi
}], //乘机人
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系信息
}, //改签单
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票改签单列表查询
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
originalOrderNo | 美亚原订购单号 | String | 否 | |
opId | 制单人编号 | String | 否 | |
outsideOpId | 制单人的外部系统编号 | String | 否 | |
orderNo | 改签单编号 | String | 否 | |
departureCity | 出发城市 三字码(如:CAN) | String | 否 | |
arrivalCity | 到达城市 三字码(如:CAN) | String | 否 | |
startTime | 制单时间范围(开始) | String | 否 | |
endTime | 制单时间范围(结束) | String | 否 | |
startDepartureTime | 出发时间范围(开始) | String | 否 | |
endDepartureTime | 出发时间范围(结束) | String | 否 | |
status | 订单状态 | Integer | 否 | |
pageIndex | 页码 | Integer | 否 | |
pageSize | 每页记录数 | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"originalOrderNo": "", //美亚原订购单号
"opId": "", //制单人编号
"outsideOpId": "", //制单人的外部系统编号
"orderNo": "", //改签单编号
"departureCity": "", //出发城市 三字码(如:CAN)
"arrivalCity": "", //到达城市 三字码(如:CAN)
"startTime": "", //制单时间范围(开始)
"endTime": "", //制单时间范围(结束)
"startDepartureTime": "", //出发时间范围(开始)
"endDepartureTime": "", //出发时间范围(结束)
"status":0, //订单状态
"pageIndex":0, //页码
"pageSize":0, //每页记录数
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
totalCount | 订单总数 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
changeOrderList | 改签单列表 | Array[] | ||
contactInfo | 联系信息 | ContactInfo | changeOrderList | |
contactName | 联系人 | String | changeOrderList.contactInfo | |
mobile | 手机号码 | String | changeOrderList.contactInfo | |
phone | 联系电话 | String | changeOrderList.contactInfo | |
电子邮件 | String | changeOrderList.contactInfo | ||
priceList | 改签单价格信息 | Array[] | changeOrderList | |
orderNo | 改签单编号 | String | changeOrderList.priceList | |
passengerType | 旅客类型 | String | changeOrderList.priceList | |
passengerNum | 旅客人数 | Integer | changeOrderList.priceList | |
sellAmount | 金额 | Number | changeOrderList.priceList | |
sellServiceFee | 服务费 | Number | changeOrderList.priceList | |
sellTax | 税费 | Number | changeOrderList.priceList | |
baseInfo | 订单基本信息 | OrderBaseInfo | changeOrderList | |
pnr | String | changeOrderList.baseInfo | ||
outsideOrderNo | 外部订单编号 | String | changeOrderList.baseInfo | |
orderNo | 美亚订单号 | String | changeOrderList.baseInfo | |
originalOrderNo | 原订单编号 改签、退票、废票单的原单编号,订购单时为空 | String | changeOrderList.baseInfo | |
opDate | 建单时间 | String | changeOrderList.baseInfo | |
opName | 客户制单人 | String | changeOrderList.baseInfo | |
statusText | 订单状态(中文) | String | changeOrderList.baseInfo | |
status | 订单状态 | Integer | changeOrderList.baseInfo | |
orderType | 订单类型(1->国内订购单,2->国内改签单,3->国内退票单) | Integer | changeOrderList.baseInfo | |
productType | 产品类型 产品子类型 1-机票 | Integer | changeOrderList.baseInfo | |
issueDate | 出票时间 | String | changeOrderList.baseInfo | |
oaSerialnumber | 出差申请单号 | String | changeOrderList.baseInfo | |
TotalPay | 订单总金额 | Number | changeOrderList.baseInfo | |
opRemark | 操作备注 | String | changeOrderList.baseInfo | |
passengerList | 乘机人 | Array[] | changeOrderList | |
orderNo | 订单编号 | String | changeOrderList.passengerList | |
passengerNo | 订单乘机人编号 | Integer | changeOrderList.passengerList | |
passengerCode | 乘机人编码 | String | changeOrderList.passengerList | |
passengerName | 乘机人名称 | String | changeOrderList.passengerList | |
gender | 性别 | String | changeOrderList.passengerList | |
nationality | 国籍 | String | changeOrderList.passengerList | |
certificateType | 证件类型 | String | changeOrderList.passengerList | |
certificateID | 证件号码 | String | changeOrderList.passengerList | |
passengerType | 乘机人类型 | String | changeOrderList.passengerList | |
birthday | 生日 | String | changeOrderList.passengerList | |
reasonID | 差旅政策违反原因 | Integer | changeOrderList.passengerList | |
reasonRemark | 差旅政策违反原因 | String | changeOrderList.passengerList | |
ticketNo | 在国内、国际酒店中代表房间号,从1开始 | String | changeOrderList.passengerList | |
OutsidePsngrId | 外部旅客编号 add 2017-04-06 jiayi | String | changeOrderList.passengerList | |
segmentList | 航班信息 | Array[] | changeOrderList | |
orderNo | 订单编码 | String | changeOrderList.segmentList | |
cabin | 大舱位 | String | changeOrderList.segmentList | |
clazz | 小舱位 | String | changeOrderList.segmentList | |
planeType | 机型 | String | changeOrderList.segmentList | |
airlineCode | 行司代码 | String | changeOrderList.segmentList | |
segmentNo | 行段序号 | Integer | changeOrderList.segmentList | |
flightNo | 航班号 | String | changeOrderList.segmentList | |
originName | 出发机场名称 | String | changeOrderList.segmentList | |
destinationName | 终点机场名称 | String | changeOrderList.segmentList | |
departureDate | 出发日期 | String | changeOrderList.segmentList | |
departureTime | 出发时间 | String | changeOrderList.segmentList | |
arrivalDate | 到达日期 | String | changeOrderList.segmentList | |
arrivalTime | 到达时间 | String | changeOrderList.segmentList | |
flyTime | 飞行时间 | String | changeOrderList.segmentList | |
carrier | 共享航班号 | String | changeOrderList.segmentList | |
stopItem | 经停 | String | changeOrderList.segmentList | |
originCityCode | 出发城市编号 | String | changeOrderList.segmentList | |
destinationCityCode | 到达城市编号 | String | changeOrderList.segmentList | |
origincityName | 出发城市名称 | String | changeOrderList.segmentList | |
destinationCityName | 到达城市名称 | String | changeOrderList.segmentList | |
depTerminal | 开始航站楼 | String | changeOrderList.segmentList | |
arrTerminal | 到达航站楼 | String | changeOrderList.segmentList | |
airlineName | 航司名称 | String | changeOrderList.segmentList | |
remark | 备注 | String | changeOrderList.segmentList |
{
"changeOrderList":
[{
"baseInfo":
{
"pnr":"HR8RV4", //
"outsideOrderNo":"SL445885212", //外部订单编号
"orderNo":"TB2301732275", //美亚订单号
"originalOrderNo":"HR8RV4", //原订单编号 改签、退票、废票单的原单编号,订购单时为空
"opDate":"2023-10-23 09:35", //建单时间
"opName":"刘展超", //客户制单人
"statusText":"已出票", //订单状态(中文)
"status":40, //订单状态
"orderType":1, //订单类型(1->国内订购单,2->国内改签单,3->国内退票单)
"productType":1, //产品类型 产品子类型 1-机票
"issueDate":"2023-10-23 09:36", //出票时间
"oaSerialnumber":"SL445885212", //出差申请单号
"TotalPay":1500, //订单总金额
"opRemark":"无", //操作备注
}, //订单基本信息
"segmentList":
[{
"orderNo": "", //订单编码
"cabin": "", //大舱位
"clazz": "", //小舱位
"planeType": "", //机型
"airlineCode": "", //行司代码
"segmentNo":0, //行段序号
"flightNo": "", //航班号
"originName": "", //出发机场名称
"destinationName": "", //终点机场名称
"departureDate": "", //出发日期
"departureTime": "", //出发时间
"arrivalDate": "", //到达日期
"arrivalTime": "", //到达时间
"flyTime": "", //飞行时间
"carrier": "", //共享航班号
"stopItem": "", //经停
"originCityCode": "", //出发城市编号
"destinationCityCode": "", //到达城市编号
"origincityName": "", //出发城市名称
"destinationCityName": "", //到达城市名称
"depTerminal": "", //开始航站楼
"arrTerminal": "", //到达航站楼
"airlineName": "", //航司名称
"remark": "", //备注
}], //航班信息
"priceList":
[{
"orderNo": "", //改签单编号
"passengerType": "", //旅客类型
"passengerNum":0, //旅客人数
"sellAmount":0, //金额
"sellServiceFee":0, //服务费
"sellTax":0, //税费
}], //改签单价格信息
"passengerList":
[{
"orderNo": "", //订单编号
"passengerNo":0, //订单乘机人编号
"passengerCode": "", //乘机人编码
"passengerName": "", //乘机人名称
"gender": "", //性别
"nationality": "", //国籍
"certificateType": "", //证件类型
"certificateID": "", //证件号码
"passengerType": "", //乘机人类型
"birthday": "", //生日
"reasonID":0, //差旅政策违反原因
"reasonRemark": "", //差旅政策违反原因
"ticketNo": "", //在国内、国际酒店中代表房间号,从1开始
"OutsidePsngrId": "", //外部旅客编号
add 2017-04-06 jiayi
}], //乘机人
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系信息
}], //改签单列表
"totalCount":0, //订单总数
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsideOrderNo | 外部订单号 | String | 否 | |
originalOrderNo | 原订购单编号 | String | 是 | |
rebackType |
退票类型(自愿 100;非自愿:200)
添加日期: 2020-05-26 |
Integer | 否 | |
refundReason |
退票原因
添加日期: 2020-05-26 |
String | 否 | |
isSubmit |
是否提交退票(true时不用再调用SubmitReturnOrder,同一个公司需要统传值)
添加日期: 2020-05-26 |
Boolean | 否 | |
opRemark | 备注 | String | 否 | |
segmentList | 航段信息(从订单详细获取segmentNo) | Array[] | 是 | |
passengerList | 旅客列表(美亚美亚旅客编号或对接方旅客编号) | Array[] | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
contactList | 联系信息 | ContactInfo | 是 | |
contactName | 联系人 | String | contactList | |
mobile | 手机号码 | String | contactList | |
phone | 联系电话 | String | contactList | |
电子邮件 | String | contactList |
{
"outsideOrderNo": "", //外部订单号
"originalOrderNo": "", //原订购单编号
"rebackType":0, //退票类型(自愿 100;非自愿:200)
"refundReason": "", //退票原因
"isSubmit":false, //是否提交退票(true时不用再调用SubmitReturnOrder,同一个公司需要统传值)
"opRemark": "", //备注
"segmentList":[0], //航段信息(从订单详细获取segmentNo)
"passengerList":[], //旅客列表(美亚美亚旅客编号或对接方旅客编号)
"contactList":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系信息
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 退票订单编号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo": "", //退票订单编号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票改签单创建退票单
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsideOrderNo | 外部订单号 | String | 否 | |
originalOrderNo | 原订购单编号 | String | 是 | |
rebackType |
退票类型(自愿 100;非自愿:200)
添加日期: 2020-05-26 |
Integer | 否 | |
refundReason |
退票原因
添加日期: 2020-05-26 |
String | 否 | |
isSubmit |
是否提交退票(true时不用再调用SubmitReturnOrder,同一个公司需要统传值)
添加日期: 2020-05-26 |
Boolean | 否 | |
opRemark | 备注 | String | 否 | |
segmentList | 航段信息(从订单详细获取segmentNo) | Array[] | 是 | |
passengerList | 旅客列表(美亚美亚旅客编号或对接方旅客编号) | Array[] | 是 | |
sessionId | sessionId,login接口返回 | String | 是 | |
contactList | 联系信息 | ContactInfo | 是 | |
contactName | 联系人 | String | contactList | |
mobile | 手机号码 | String | contactList | |
phone | 联系电话 | String | contactList | |
电子邮件 | String | contactList |
{
"outsideOrderNo": "", //外部订单号
"originalOrderNo": "", //原订购单编号
"rebackType":0, //退票类型(自愿 100;非自愿:200)
"refundReason": "", //退票原因
"isSubmit":false, //是否提交退票(true时不用再调用SubmitReturnOrder,同一个公司需要统传值)
"opRemark": "", //备注
"segmentList":[0], //航段信息(从订单详细获取segmentNo)
"passengerList":[], //旅客列表(美亚美亚旅客编号或对接方旅客编号)
"contactList":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系信息
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNoList | 退票订单编号 | Array[] | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNoList":[], //退票订单编号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsideOrderNo | 外部订单号 | String | 否 | |
originalOrderNo | 美亚原订购单号 | String | 否 | |
opRemark | 备注(改签原因) | String | 否 | |
passengerList | 旅客列表 | Array[] | 否 | |
changeType |
改签类型(自愿 100;非自愿:200)
添加日期: 2020-01-15 |
Integer | 否 | |
isSubmit |
是否提交改签出票(true时不用再调用SubmitChangeOrder,同一个公司需要统传值)
添加日期: 2020-05-26 |
Boolean | 否 | |
changeReason |
改签原因
添加日期: 2020-05-26 |
String | 否 | |
InvoiceType | 客户所需发票类型 默认=0 ( 0=纸质行程单 1=电子行程单 ) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
contactList | 联系人信息 | ContactInfo | 否 | |
contactName | 联系人 | String | contactList | |
mobile | 手机号码 | String | contactList | |
phone | 联系电话 | String | contactList | |
电子邮件 | String | contactList | ||
flightList | 航段列表 | Array[] | 否 | |
flightID | 航班ID(从查询航班返回获取) | String | flightList | |
departureCity | 出发城市(三字码) | String | flightList | |
arrivalCity | 达到城市(三字码) | String | flightList | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList | |
airline | 航空二字码,如 MU | String | flightList | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList | |
secondFlight | 预订多程中转航班时需要必传; | FlightInfoForCreateBase | flightList | |
flightID | 航班ID(从查询航班返回获取) | String | flightList.secondFlight | |
departureCity | 出发城市(三字码) | String | flightList.secondFlight | |
arrivalCity | 达到城市(三字码) | String | flightList.secondFlight | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList.secondFlight | |
airline | 航空二字码,如 MU | String | flightList.secondFlight | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList.secondFlight | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList.secondFlight | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList.secondFlight |
{
"outsideOrderNo":"SL54851255", //外部订单号
"originalOrderNo":"TB2301738179", //美亚原订购单号
"opRemark": "", //备注(改签原因)
"flightList":
[{
"secondFlight":
{
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}, //预订多程中转航班时需要必传;
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}], //航段列表
"passengerList":"['20115164']", //旅客列表
"contactList":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"changeType":100, //改签类型(自愿 100;非自愿:200)
"isSubmit":false, //是否提交改签出票(true时不用再调用SubmitChangeOrder,同一个公司需要统传值)
"changeReason": "", //改签原因
"InvoiceType":0, //客户所需发票类型
默认=0 ( 0=纸质行程单 1=电子行程单 )
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 订单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo":"TB2301733006", //订单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
国内机票订单列表
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单号 | String | 否 | |
opId | 制单人编号 | String | 否 | |
outsideOpId | 制单人的外部系统编号 | String | 否 | |
departureCity | 出发城市 | String | 否 | |
arrivalCity | 到达城市 | String | 否 | |
startTime | 制单时间范围(开始) | String | 否 | |
endTime | 制单时间范围(结束) | String | 否 | |
startIssueTime | 出票时间范围(开始) | String | 否 | |
endIssueTime | 出票时间范围(结束) | String | 否 | |
startDepartureTime | 出发时间范围(开始) | String | 否 | |
endDepartureTime | 出发时间范围(结束) | String | 否 | |
pnr | pnr | String | 否 | |
status | 订单状态 | Integer | 否 | |
pageIndex | 当前页码 | Integer | 否 | |
pageSize | 每页大小 | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo": "", //订单号
"opId": "", //制单人编号
"outsideOpId": "", //制单人的外部系统编号
"departureCity": "", //出发城市
"arrivalCity": "", //到达城市
"startTime": "", //制单时间范围(开始)
"endTime": "", //制单时间范围(结束)
"startIssueTime": "", //出票时间范围(开始)
"endIssueTime": "", //出票时间范围(结束)
"startDepartureTime": "", //出发时间范围(开始)
"endDepartureTime": "", //出发时间范围(结束)
"pnr": "", //pnr
"status":0, //订单状态
"pageIndex":0, //当前页码
"pageSize":0, //每页大小
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
totalCount | 订单总数 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
orderList | 返回结果 | Array[] | ||
costList | 成本中心 | Array[] | orderList | |
costCenterName | 成本中心名称 | String | orderList.costList | |
contactInfo | 联系信息 | ContactInfo | orderList | |
contactName | 联系人 | String | orderList.contactInfo | |
mobile | 手机号码 | String | orderList.contactInfo | |
phone | 联系电话 | String | orderList.contactInfo | |
电子邮件 | String | orderList.contactInfo | ||
priceList | 机票价格 | Array[] | orderList | |
orderNo | 订单编号 | String | orderList.priceList | |
passengerType | 旅客类型 | String | orderList.priceList | |
price | 价格 | Number | orderList.priceList | |
returnprice | 退还费用 | Number | orderList.priceList | |
tax | 税费 | Number | orderList.priceList | |
serviceAmount | 服务费 | Number | orderList.priceList | |
discount | 折扣 | Number | orderList.priceList | |
baseInfo | 订单基本信息 | OrderBaseInfo | orderList | |
pnr | String | orderList.baseInfo | ||
outsideOrderNo | 外部订单编号 | String | orderList.baseInfo | |
orderNo | 美亚订单号 | String | orderList.baseInfo | |
originalOrderNo | 原订单编号 改签、退票、废票单的原单编号,订购单时为空 | String | orderList.baseInfo | |
opDate | 建单时间 | String | orderList.baseInfo | |
opName | 客户制单人 | String | orderList.baseInfo | |
statusText | 订单状态(中文) | String | orderList.baseInfo | |
status | 订单状态 | Integer | orderList.baseInfo | |
orderType | 订单类型(1->国内订购单,2->国内改签单,3->国内退票单) | Integer | orderList.baseInfo | |
productType | 产品类型 产品子类型 1-机票 | Integer | orderList.baseInfo | |
issueDate | 出票时间 | String | orderList.baseInfo | |
oaSerialnumber | 出差申请单号 | String | orderList.baseInfo | |
TotalPay | 订单总金额 | Number | orderList.baseInfo | |
opRemark | 操作备注 | String | orderList.baseInfo | |
passengerList | 乘机人 | Array[] | orderList | |
orderNo | 订单编号 | String | orderList.passengerList | |
passengerNo | 订单乘机人编号 | Integer | orderList.passengerList | |
passengerCode | 乘机人编码 | String | orderList.passengerList | |
passengerName | 乘机人名称 | String | orderList.passengerList | |
gender | 性别 | String | orderList.passengerList | |
nationality | 国籍 | String | orderList.passengerList | |
certificateType | 证件类型 | String | orderList.passengerList | |
certificateID | 证件号码 | String | orderList.passengerList | |
passengerType | 乘机人类型 | String | orderList.passengerList | |
birthday | 生日 | String | orderList.passengerList | |
reasonID | 差旅政策违反原因 | Integer | orderList.passengerList | |
reasonRemark | 差旅政策违反原因 | String | orderList.passengerList | |
ticketNo | 在国内、国际酒店中代表房间号,从1开始 | String | orderList.passengerList | |
OutsidePsngrId | 外部旅客编号 add 2017-04-06 jiayi | String | orderList.passengerList | |
segmentList | 航班信息 | Array[] | orderList | |
orderNo | 订单编码 | String | orderList.segmentList | |
cabin | 大舱位 | String | orderList.segmentList | |
clazz | 小舱位 | String | orderList.segmentList | |
planeType | 机型 | String | orderList.segmentList | |
airlineCode | 行司代码 | String | orderList.segmentList | |
segmentNo | 行段序号 | Integer | orderList.segmentList | |
flightNo | 航班号 | String | orderList.segmentList | |
originName | 出发机场名称 | String | orderList.segmentList | |
destinationName | 终点机场名称 | String | orderList.segmentList | |
departureDate | 出发日期 | String | orderList.segmentList | |
departureTime | 出发时间 | String | orderList.segmentList | |
arrivalDate | 到达日期 | String | orderList.segmentList | |
arrivalTime | 到达时间 | String | orderList.segmentList | |
flyTime | 飞行时间 | String | orderList.segmentList | |
carrier | 共享航班号 | String | orderList.segmentList | |
stopItem | 经停 | String | orderList.segmentList | |
originCityCode | 出发城市编号 | String | orderList.segmentList | |
destinationCityCode | 到达城市编号 | String | orderList.segmentList | |
origincityName | 出发城市名称 | String | orderList.segmentList | |
destinationCityName | 到达城市名称 | String | orderList.segmentList | |
depTerminal | 开始航站楼 | String | orderList.segmentList | |
arrTerminal | 到达航站楼 | String | orderList.segmentList | |
airlineName | 航司名称 | String | orderList.segmentList | |
remark | 备注 | String | orderList.segmentList |
{
"orderList":
[{
"baseInfo":
{
"pnr":"HR8RV4", //
"outsideOrderNo":"SL445885212", //外部订单编号
"orderNo":"TB2301732275", //美亚订单号
"originalOrderNo":"HR8RV4", //原订单编号 改签、退票、废票单的原单编号,订购单时为空
"opDate":"2023-10-23 09:35", //建单时间
"opName":"刘展超", //客户制单人
"statusText":"已出票", //订单状态(中文)
"status":40, //订单状态
"orderType":1, //订单类型(1->国内订购单,2->国内改签单,3->国内退票单)
"productType":1, //产品类型 产品子类型 1-机票
"issueDate":"2023-10-23 09:36", //出票时间
"oaSerialnumber":"SL445885212", //出差申请单号
"TotalPay":1500, //订单总金额
"opRemark":"无", //操作备注
}, //订单基本信息
"segmentList":
[{
"orderNo": "", //订单编码
"cabin": "", //大舱位
"clazz": "", //小舱位
"planeType": "", //机型
"airlineCode": "", //行司代码
"segmentNo":0, //行段序号
"flightNo": "", //航班号
"originName": "", //出发机场名称
"destinationName": "", //终点机场名称
"departureDate": "", //出发日期
"departureTime": "", //出发时间
"arrivalDate": "", //到达日期
"arrivalTime": "", //到达时间
"flyTime": "", //飞行时间
"carrier": "", //共享航班号
"stopItem": "", //经停
"originCityCode": "", //出发城市编号
"destinationCityCode": "", //到达城市编号
"origincityName": "", //出发城市名称
"destinationCityName": "", //到达城市名称
"depTerminal": "", //开始航站楼
"arrTerminal": "", //到达航站楼
"airlineName": "", //航司名称
"remark": "", //备注
}], //航班信息
"priceList":
[{
"orderNo": "", //订单编号
"passengerType": "", //旅客类型
"price":0, //价格
"returnprice":0, //退还费用
"tax":0, //税费
"serviceAmount":0, //服务费
"discount":0, //折扣
}], //机票价格
"passengerList":
[{
"orderNo": "", //订单编号
"passengerNo":0, //订单乘机人编号
"passengerCode": "", //乘机人编码
"passengerName": "", //乘机人名称
"gender": "", //性别
"nationality": "", //国籍
"certificateType": "", //证件类型
"certificateID": "", //证件号码
"passengerType": "", //乘机人类型
"birthday": "", //生日
"reasonID":0, //差旅政策违反原因
"reasonRemark": "", //差旅政策违反原因
"ticketNo": "", //在国内、国际酒店中代表房间号,从1开始
"OutsidePsngrId": "", //外部旅客编号
add 2017-04-06 jiayi
}], //乘机人
"costList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系信息
}], //返回结果
"totalCount":0, //订单总数
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
OrderNo | 订单号 | String | 否 | |
OutsideOrderNo | 外部订单号 | String | 否 | |
ElectronicNumber | 电子票号 | String | 否 | |
OrderStatus | 订单状态 | Integer | 否 | |
PassengerName | 旅客姓名 | String | 否 | |
TrainNumber | 车次 | String | 否 | |
FromStartTime | 出发日期开始 | String | 否 | |
FromEndTime | 出发日期结束 | String | 否 | |
ToStartTime | 到达日期开始 | String | 否 | |
ToEndTime | // 到达日期结束 | String | 否 | |
SubmitName | 客户制单人 | String | 否 | |
OperateStartTime | 制单时间开始 | String | 否 | |
OperateEndTime | 制单时间结束 | String | 否 | |
IssueStatus | 出票结果 | String | 否 | |
PageIndex | 页码 | Integer | 否 | |
PageSize | 页数 | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"OrderNo": "", //订单号
"OutsideOrderNo": "", //外部订单号
"ElectronicNumber": "", //电子票号
"OrderStatus":0, //订单状态
"PassengerName": "", //旅客姓名
"TrainNumber": "", //车次
"FromStartTime": "", //出发日期开始
"FromEndTime": "", //出发日期结束
"ToStartTime": "", //到达日期开始
"ToEndTime": "", ////
到达日期结束
"SubmitName": "", //客户制单人
"OperateStartTime": "", //制单时间开始
"OperateEndTime": "", //制单时间结束
"IssueStatus": "", //出票结果
"PageIndex":0, //页码
"PageSize":0, //页数
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
TotalCount | Integer | |||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
OrderInfoList | Array[] | |||
CostList | 成本中心信息 | Array[] | OrderInfoList | |
costCenterName | 成本中心名称 | String | OrderInfoList.CostList | |
InvoiceInfo | 发票信息 | InvoiceInfo | OrderInfoList | |
InvoiceAddress | 发票邮寄地址 | String | OrderInfoList.InvoiceInfo | |
InvoiceRecipients | 发票收件人 | String | OrderInfoList.InvoiceInfo | |
InvoicePostCode | 发票邮编 | String | OrderInfoList.InvoiceInfo | |
ContactInfo | 联系人信息 | ContactInfo | OrderInfoList | |
contactName | 联系人 | String | OrderInfoList.ContactInfo | |
mobile | 手机号码 | String | OrderInfoList.ContactInfo | |
phone | 联系电话 | String | OrderInfoList.ContactInfo | |
电子邮件 | String | OrderInfoList.ContactInfo | ||
ApproveInfo | 订单审批信息 | Array[] | OrderInfoList | |
ActName | 环节名称 | String | OrderInfoList.ApproveInfo | |
Operator | 操作人 | String | OrderInfoList.ApproveInfo | |
Result | 处理结果 | String | OrderInfoList.ApproveInfo | |
OperateTime | 操作时间 | String | OrderInfoList.ApproveInfo | |
Remark | 备注 | String | OrderInfoList.ApproveInfo | |
TicketTrain | 车次信息 | TicketTrain | OrderInfoList | |
OrderNo | 火车订单号 | String | OrderInfoList.TicketTrain | |
TrainNumber | 火车票车次排序号 | String | OrderInfoList.TicketTrain | |
FromStation | 出发站 | String | OrderInfoList.TicketTrain | |
ToStation | 到达站 | String | OrderInfoList.TicketTrain | |
DepartureTime | 出发时间 | String | OrderInfoList.TicketTrain | |
ArriveTime | 到达时间 | String | OrderInfoList.TicketTrain | |
TrainType | 车次类型 | String | OrderInfoList.TicketTrain | |
SeatLevel | 座位等级 | String | OrderInfoList.TicketTrain | |
BaseInfo | 订单基本信息 | OrderCommonInfo | OrderInfoList | |
outsideOrderNo | 外部订单编号 | String | OrderInfoList.BaseInfo | |
orderNo | 美亚订单号 | String | OrderInfoList.BaseInfo | |
originalOrderNo | 原订单编号 改签、退票、废票单的原单编号,订购单时为空 | String | OrderInfoList.BaseInfo | |
opDate | 建单时间 | String | OrderInfoList.BaseInfo | |
opName | 客户制单人 | String | OrderInfoList.BaseInfo | |
statusText | 订单状态(中文) | String | OrderInfoList.BaseInfo | |
status | 订单状态 | Integer | OrderInfoList.BaseInfo | |
orderType | 订单类型(1->国内订购单,2->国内改签单,3->国内退票单) | Integer | OrderInfoList.BaseInfo | |
productType | 产品类型 产品子类型 1-机票 | Integer | OrderInfoList.BaseInfo | |
issueDate | 出票时间 | String | OrderInfoList.BaseInfo | |
oaSerialnumber | 出差申请单号 | String | OrderInfoList.BaseInfo | |
TotalPay | 订单总金额 | Number | OrderInfoList.BaseInfo | |
opRemark | 操作备注 | String | OrderInfoList.BaseInfo | |
PassengerList | 旅客信息 | Array[] | OrderInfoList | |
PassengerNo | Integer | OrderInfoList.PassengerList | ||
PassengerName | String | OrderInfoList.PassengerList | ||
DepartmentID | String | OrderInfoList.PassengerList | ||
DepartmentName | String | OrderInfoList.PassengerList | ||
Sex | String | OrderInfoList.PassengerList | ||
Nationality | String | OrderInfoList.PassengerList | ||
CertificateType | String | OrderInfoList.PassengerList | ||
CertificateID | String | OrderInfoList.PassengerList | ||
Mobile | String | OrderInfoList.PassengerList | ||
SeatNum | String | OrderInfoList.PassengerList | ||
TicketPrice | Number | OrderInfoList.PassengerList | ||
PassengerType | String | OrderInfoList.PassengerList | ||
ServicePrice | Number | OrderInfoList.PassengerList | ||
ElectronicOrderNo | String | OrderInfoList.PassengerList | ||
IssueStatus | String | OrderInfoList.PassengerList | ||
Reason | String | OrderInfoList.PassengerList |
{
"OrderInfoList":
[{
"BaseInfo":
{
"outsideOrderNo":"SL445885212", //外部订单编号
"orderNo":"TB2301732275", //美亚订单号
"originalOrderNo":"HR8RV4", //原订单编号 改签、退票、废票单的原单编号,订购单时为空
"opDate":"2023-10-23 09:35", //建单时间
"opName":"刘展超", //客户制单人
"statusText":"已出票", //订单状态(中文)
"status":40, //订单状态
"orderType":1, //订单类型(1->国内订购单,2->国内改签单,3->国内退票单)
"productType":1, //产品类型 产品子类型 1-机票
"issueDate":"2023-10-23 09:36", //出票时间
"oaSerialnumber":"SL445885212", //出差申请单号
"TotalPay":1500, //订单总金额
"opRemark":"无", //操作备注
}, //订单基本信息
"TicketTrain":
{
"OrderNo": "", //火车订单号
"TrainNumber": "", //火车票车次排序号
"FromStation": "", //出发站
"ToStation": "", //到达站
"DepartureTime": "", //出发时间
"ArriveTime": "", //到达时间
"TrainType": "", //车次类型
"SeatLevel": "", //座位等级
}, //车次信息
"PassengerList":
[{
"PassengerNo":0, //
"PassengerName": "", //
"DepartmentID": "", //
"DepartmentName": "", //
"Sex": "", //
"Nationality": "", //
"CertificateType": "", //
"CertificateID": "", //
"Mobile": "", //
"SeatNum": "", //
"TicketPrice":0, //
"PassengerType": "", //
"ServicePrice":0, //
"ElectronicOrderNo": "", //
"IssueStatus": "", //
"Reason": "", //
}], //旅客信息
"ContactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"CostList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心信息
"InvoiceInfo":
{
"InvoiceAddress": "", //发票邮寄地址
"InvoiceRecipients": "", //发票收件人
"InvoicePostCode": "", //发票邮编
}, //发票信息
"ApproveInfo":
[{
"ActName": "", //环节名称
"Operator": "", //操作人
"Result": "", //处理结果
"OperateTime": "", //操作时间
"Remark": "", //备注
}], //订单审批信息
}], //
"TotalCount":0, //
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
无
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
ReturnOrderNo | 美亚退票单号 | String | 否 | |
OrderNo | 美亚订购单号 | String | 否 | |
OutsideReturnOrderNo | 外部退票单号 | String | 否 | |
ElectronicNumber | 电子票号(12306订单号) | String | 否 | |
PassengerName | 旅客姓名 | String | 否 | |
TrainNumber | 车次号(如,G70) | String | 否 | |
OrderStatus | 订单状态 | Integer | 否 | |
FromStartDate | 出发日期开始(格式:yyyy-MM-dd) | String | 否 | |
FromEndDate | 出发日期结束(格式:yyyy-MM-dd) | String | 否 | |
ToStartDate | 到达日期开始(格式:yyyy-MM-dd) | String | 否 | |
ToEndDate | 到达日期结束(格式:yyyy-MM-dd) | String | 否 | |
SubmitName | 客户制单人 | String | 否 | |
OperateStartDate | 制单开始日期(格式:yyyy-MM-dd) | String | 否 | |
OperateEndDate | 制单结束日期(格式:yyyy-MM-dd) | String | 否 | |
ReturnStatus | 退票结果 | Integer | 否 | |
PageIndex | 页码(分页索引) | Integer | 否 | |
PageSize | 页数(每页条数,默认返回最大值50) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"ReturnOrderNo": "", //美亚退票单号
"OrderNo": "", //美亚订购单号
"OutsideReturnOrderNo": "", //外部退票单号
"ElectronicNumber": "", //电子票号(12306订单号)
"PassengerName": "", //旅客姓名
"TrainNumber": "", //车次号(如,G70)
"OrderStatus":0, //订单状态
"FromStartDate": "", //出发日期开始(格式:yyyy-MM-dd)
"FromEndDate": "", //出发日期结束(格式:yyyy-MM-dd)
"ToStartDate": "", //到达日期开始(格式:yyyy-MM-dd)
"ToEndDate": "", //到达日期结束(格式:yyyy-MM-dd)
"SubmitName": "", //客户制单人
"OperateStartDate": "", //制单开始日期(格式:yyyy-MM-dd)
"OperateEndDate": "", //制单结束日期(格式:yyyy-MM-dd)
"ReturnStatus":0, //退票结果
"PageIndex":0, //页码(分页索引)
"PageSize":0, //页数(每页条数,默认返回最大值50)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
TotalCount | 总数(用于分页,默认为0) | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
ReturnOrderInfoList | 退票单信息 | Array[] | ||
Total | 合计 | Number | ReturnOrderInfoList | |
ContactInfo | 联系人信息 | ContactInfo | ReturnOrderInfoList | |
contactName | 联系人 | String | ReturnOrderInfoList.ContactInfo | |
mobile | 手机号码 | String | ReturnOrderInfoList.ContactInfo | |
phone | 联系电话 | String | ReturnOrderInfoList.ContactInfo | |
电子邮件 | String | ReturnOrderInfoList.ContactInfo | ||
ApproveInfoList | 审批信息 | Array[] | ReturnOrderInfoList | |
ActName | 环节名称 | String | ReturnOrderInfoList.ApproveInfoList | |
Operator | 操作人 | String | ReturnOrderInfoList.ApproveInfoList | |
Result | 处理结果 | String | ReturnOrderInfoList.ApproveInfoList | |
OperateTime | 操作时间 | String | ReturnOrderInfoList.ApproveInfoList | |
Remark | 备注 | String | ReturnOrderInfoList.ApproveInfoList | |
TicketTrain | 车次信息 | TicketTrain | ReturnOrderInfoList | |
OrderNo | 火车订单号 | String | ReturnOrderInfoList.TicketTrain | |
TrainNumber | 火车票车次排序号 | String | ReturnOrderInfoList.TicketTrain | |
FromStation | 出发站 | String | ReturnOrderInfoList.TicketTrain | |
ToStation | 到达站 | String | ReturnOrderInfoList.TicketTrain | |
DepartureTime | 出发时间 | String | ReturnOrderInfoList.TicketTrain | |
ArriveTime | 到达时间 | String | ReturnOrderInfoList.TicketTrain | |
TrainType | 车次类型 | String | ReturnOrderInfoList.TicketTrain | |
SeatLevel | 座位等级 | String | ReturnOrderInfoList.TicketTrain | |
BaseInfo | 退票单基本信息 | OrderCommonInfo | ReturnOrderInfoList | |
outsideOrderNo | 外部订单编号 | String | ReturnOrderInfoList.BaseInfo | |
orderNo | 美亚订单号 | String | ReturnOrderInfoList.BaseInfo | |
originalOrderNo | 原订单编号 改签、退票、废票单的原单编号,订购单时为空 | String | ReturnOrderInfoList.BaseInfo | |
opDate | 建单时间 | String | ReturnOrderInfoList.BaseInfo | |
opName | 客户制单人 | String | ReturnOrderInfoList.BaseInfo | |
statusText | 订单状态(中文) | String | ReturnOrderInfoList.BaseInfo | |
status | 订单状态 | Integer | ReturnOrderInfoList.BaseInfo | |
orderType | 订单类型(1->国内订购单,2->国内改签单,3->国内退票单) | Integer | ReturnOrderInfoList.BaseInfo | |
productType | 产品类型 产品子类型 1-机票 | Integer | ReturnOrderInfoList.BaseInfo | |
issueDate | 出票时间 | String | ReturnOrderInfoList.BaseInfo | |
oaSerialnumber | 出差申请单号 | String | ReturnOrderInfoList.BaseInfo | |
TotalPay | 订单总金额 | Number | ReturnOrderInfoList.BaseInfo | |
opRemark | 操作备注 | String | ReturnOrderInfoList.BaseInfo | |
PassengerList | 旅客姓名(旅客姓名、是否退票失败) | Array[] | ReturnOrderInfoList | |
PassengerNo | Integer | ReturnOrderInfoList.PassengerList | ||
PassengerName | String | ReturnOrderInfoList.PassengerList | ||
DepartmentID | String | ReturnOrderInfoList.PassengerList | ||
DepartmentName | String | ReturnOrderInfoList.PassengerList | ||
Sex | String | ReturnOrderInfoList.PassengerList | ||
Nationality | String | ReturnOrderInfoList.PassengerList | ||
CertificateType | String | ReturnOrderInfoList.PassengerList | ||
CertificateID | String | ReturnOrderInfoList.PassengerList | ||
Mobile | String | ReturnOrderInfoList.PassengerList | ||
SeatNum | String | ReturnOrderInfoList.PassengerList | ||
TicketPrice | Number | ReturnOrderInfoList.PassengerList | ||
PassengerType | String | ReturnOrderInfoList.PassengerList | ||
ServicePrice | Number | ReturnOrderInfoList.PassengerList | ||
ElectronicOrderNo | String | ReturnOrderInfoList.PassengerList | ||
IssueStatus | String | ReturnOrderInfoList.PassengerList | ||
Reason | String | ReturnOrderInfoList.PassengerList |
{
"ReturnOrderInfoList":
[{
"BaseInfo":
{
"outsideOrderNo":"SL445885212", //外部订单编号
"orderNo":"TB2301732275", //美亚订单号
"originalOrderNo":"HR8RV4", //原订单编号 改签、退票、废票单的原单编号,订购单时为空
"opDate":"2023-10-23 09:35", //建单时间
"opName":"刘展超", //客户制单人
"statusText":"已出票", //订单状态(中文)
"status":40, //订单状态
"orderType":1, //订单类型(1->国内订购单,2->国内改签单,3->国内退票单)
"productType":1, //产品类型 产品子类型 1-机票
"issueDate":"2023-10-23 09:36", //出票时间
"oaSerialnumber":"SL445885212", //出差申请单号
"TotalPay":1500, //订单总金额
"opRemark":"无", //操作备注
}, //退票单基本信息
"TicketTrain":
{
"OrderNo": "", //火车订单号
"TrainNumber": "", //火车票车次排序号
"FromStation": "", //出发站
"ToStation": "", //到达站
"DepartureTime": "", //出发时间
"ArriveTime": "", //到达时间
"TrainType": "", //车次类型
"SeatLevel": "", //座位等级
}, //车次信息
"PassengerList":
[{
"PassengerNo":0, //
"PassengerName": "", //
"DepartmentID": "", //
"DepartmentName": "", //
"Sex": "", //
"Nationality": "", //
"CertificateType": "", //
"CertificateID": "", //
"Mobile": "", //
"SeatNum": "", //
"TicketPrice":0, //
"PassengerType": "", //
"ServicePrice":0, //
"ElectronicOrderNo": "", //
"IssueStatus": "", //
"Reason": "", //
}], //旅客姓名(旅客姓名、是否退票失败)
"ContactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"ApproveInfoList":
[{
"ActName": "", //环节名称
"Operator": "", //操作人
"Result": "", //处理结果
"OperateTime": "", //操作时间
"Remark": "", //备注
}], //审批信息
"Total":0, //合计
}], //退票单信息
"TotalCount":0, //总数(用于分页,默认为0)
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
查询相关公告信息通知
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
originCode | 原始发地 机场/城市三字码 | String | 否 | |
destinationCode | 最终目的地 机场/城市三字码 | String | 否 | |
tripType | 行程类型:1:单程、2:往返 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
flightSegments | 航段(多段或中转,每个航段需要分开赋值) | Array[] | 否 | |
airline | 航司 | String | flightSegments | |
depArea | 始发地 机场/城市三字码 | String | flightSegments | |
depDate | 起飞日期 YYYY-MM-DD | String | flightSegments | |
arrArea | 目的地 机场/城市三字码 | String | flightSegments | |
arrDate | 返回日期 YYYY-MM-DD | String | flightSegments | |
segmentType | 航段类型OUTBOUND为去程,RETURN为回程 | String | flightSegments | |
transit | 中转 true:中转 false:非中转 | Boolean | flightSegments |
{
"originCode": "", //原始发地 机场/城市三字码
"destinationCode": "", //最终目的地 机场/城市三字码
"tripType": "", //行程类型:1:单程、2:往返
"flightSegments":
[{
"airline": "", //航司
"depArea": "", //始发地 机场/城市三字码
"depDate": "", //起飞日期 YYYY-MM-DD
"arrArea": "", //目的地 机场/城市三字码
"arrDate": "", //返回日期 YYYY-MM-DD
"segmentType": "", //航段类型OUTBOUND为去程,RETURN为回程
"transit":false, //中转 true:中转 false:非中转
}], //航段(多段或中转,每个航段需要分开赋值)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
OutbreakNotices | 公告 | Array[] | ||
depArea | 始发地 机场/城市三字码 | String | OutbreakNotices | |
arrArea | 目的地 机场/城市三字码 | String | OutbreakNotices | |
airline | 航司 | String | OutbreakNotices | |
transitPlace | 中转地 记录城市三字码,多个以/隔开 如:CAN-广州/BJS-北京/SHA-上海 | Array[] | OutbreakNotices | |
contenthtml | 富文本内容 用于保存编辑数据 | String | OutbreakNotices | |
summary | 概要 | String | OutbreakNotices |
{
"OutbreakNotices":
[{
"depArea": "", //始发地 机场/城市三字码
"arrArea": "", //目的地 机场/城市三字码
"airline": "", //航司
"transitPlace":[], //中转地 记录城市三字码,多个以/隔开 如:CAN-广州/BJS-北京/SHA-上海
"contenthtml": "", //富文本内容 用于保存编辑数据
"summary": "", //概要
}], //公告
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
南网创建订单
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
outsideOrderNo | 外部订单号 | String | 否 | |
opRemark | 备注 | String | 否 | |
oaSerialnumber | 出差申请单号 | String | 否 | |
bookType | 默认不传为0, 0-因公 ;1-因私; | String | 是 | |
receivePayType | 默认不传为0, 0-信用付;1-即付, 3-预存款支付,因私默认0; | String | 是 | |
uatpCompany |
指定UATP公司
0:美亚运算 1 快钱 2 嘉惠 3 虫洞 4 中航结(商务卡) 5 易商旅 6.中航结(UATP卡) 添加日期: 2021-10-18 |
Integer | 否 | |
isUatp |
是否使用uatp(默认true)
仅已签订uatp出票协议时有效 添加日期: 2021-10-18 |
Boolean | 否 | |
IsAutoSubmit | 是否自动提交,如果没有审批流程自动审批的话则赋值为true,否则为false | Boolean | 是 | |
InvoiceType | 客户所需发票类型 默认=0 ( 0=纸质行程单 1=电子行程单 ) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
reasonList | 违反差旅政策原因 | Array[] | 否 | |
outsidePassengerId | String | reasonList | ||
tripNum | Integer | reasonList | ||
reasonID | Integer | reasonList | ||
reasonRemark | String | reasonList | ||
contactList | 联系人信息 | ContactInfo | 是 | |
contactName | 联系人 | String | contactList | |
mobile | 手机号码 | String | contactList | |
phone | 联系电话 | String | contactList | |
电子邮件 | String | contactList | ||
flightList | 选择的航班ID | Array[] | 是 | |
flightID | 航班ID(从查询航班返回获取) | String | flightList | |
departureCity | 出发城市(三字码) | String | flightList | |
arrivalCity | 达到城市(三字码) | String | flightList | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList | |
airline | 航空二字码,如 MU | String | flightList | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList | |
secondFlight | 预订多程中转航班时需要必传; | FlightInfoForCreateBase | flightList | |
flightID | 航班ID(从查询航班返回获取) | String | flightList.secondFlight | |
departureCity | 出发城市(三字码) | String | flightList.secondFlight | |
arrivalCity | 达到城市(三字码) | String | flightList.secondFlight | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList.secondFlight | |
airline | 航空二字码,如 MU | String | flightList.secondFlight | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList.secondFlight | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList.secondFlight | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList.secondFlight | |
passengerList | 旅客列表 | Array[] | 是 | |
uatpCardNameList | uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
uatpCardNumberList | uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理) | Array[] | passengerList | |
passengerJruisdictions | 拥有的权限列表(根据passengerJruisdictionType决定) | Array[] | passengerList | |
passengerJruisdictionType | passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理 | Integer | passengerList | |
outsidePassengerId | 对接方系统的旅客编号 | String | passengerList | |
passengerId | 美亚旅客编号(不用传) | String | passengerList | |
passengerName | 乘机人姓名 | String | passengerList | |
passengerType | 旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿) | String | passengerList | |
companyId | 公司编号 | String | passengerList | |
sex | 必传 性别:男/女;不能传其他字符 | String | passengerList | |
cnName | 中文姓名(中文姓名、英文姓名2选一) | String | passengerList | |
enName | 英文姓名(中文姓名、英文姓名2选一,格式:zhang/san) | String | passengerList | |
userName | 登录用户名 | String | passengerList | |
dId | 部门ID(不传) | Integer | passengerList | |
dName | 部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心 | String | passengerList | |
nationality | 国籍:中国填写 CN,必传 | String | passengerList | |
birthday | 出生日期(yyyy-MM-dd)必传 | String | passengerList | |
mobile | 手机号码 | String | passengerList | |
mobileAreaCode | 国际手机号码区号,国内手机号可不传 | String | passengerList | |
电子邮箱 | String | passengerList | ||
defaultRoleId | 默认角色 | String | passengerList | |
holderId | 职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值 | String | passengerList | |
postID | 职位ID | String | passengerList | |
approvalOutsideId | 审批人的外部系统编号 | String | passengerList | |
SuperVip | 0:非VIP 1VIP | Integer | passengerList | |
phone | 固定电话 | String | passengerList | |
policyId | 差旅政策ID;如果是非正常职等差标满足不了的,则使用policyId传美亚差标ID,进行跨职等差标预订;例如旅客配领导享受领导差标; | String | passengerList | |
staffId | 员工工号 | String | passengerList | |
chooseSeatNo | 在线选座(火车票)如:1A | String | passengerList | |
isPositionMapping | 是否存在职位映射 0=否,1=是(校验postID 更新职位) | Integer | passengerList | |
CostList | 成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可 | Array[] | passengerList | |
costCenterName | 成本中心名称 | String | passengerList.CostList | |
insuranceList | 保险产品信息 | Array[] | passengerList | |
insuranceId | 保险产品编号(联系美亚获取) | Integer | passengerList.insuranceList | |
insuranceCount | 保险份数(一般最大是两份) | Integer | passengerList.insuranceList | |
certificatePhoto | 证件图片信息(只有国际机票使用,其他产品传null 或者不处理) | CertificatePhoto | passengerList | |
fileName | 文件名称 | String | passengerList.certificatePhoto | |
fileCode | 文件流 | String | passengerList.certificatePhoto | |
frequentTraveller | 常旅卡信息 | FrequentTraveller | passengerList | |
airlineCode | 航司二字码 | String | passengerList.frequentTraveller | |
cardName | 常旅卡名称 | String | passengerList.frequentTraveller | |
cardNumber | 常旅卡号 | String | passengerList.frequentTraveller | |
certificatesList | 证件 | Array[] | passengerList | |
certType | 证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证 | String | passengerList.certificatesList | |
certNumber | 证件号码 | String | passengerList.certificatesList | |
expiration | 必传 证件有效期(yyyy-MM-dd)默认一年 | String | passengerList.certificatesList | |
isFlightCertificate | 是否是乘机证件 | Boolean | passengerList.certificatesList |
{
"outsideOrderNo":"SLX154488874", //外部订单号
"opRemark":"订单备注说明", //备注
"oaSerialnumber":"SLX154488874", //出差申请单号
"flightList":
[{
"secondFlight":
{
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}, //预订多程中转航班时需要必传;
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}], //选择的航班ID
"passengerList":
[{
"uatpCardNameList":"null", //uatp卡名称(卡号、名称二选一,如果卡号有值,卡名称不处理)
"uatpCardNumberList":"null", //uatp卡号(卡号、名称二选一,如果卡号有值,卡名称不处理)
"passengerJruisdictions":"null", //拥有的权限列表(根据passengerJruisdictionType决定)
"passengerJruisdictionType":0, //passengerJruisdictions 值类型:1:旅客(外部旅客编号);2:部门(中文名称);3:公司(中文名称);4:集团(中文名称);其它:不处理
"outsidePassengerId":"ak10002", //对接方系统的旅客编号
"passengerId": "", //美亚旅客编号(不用传)
"passengerName":"刘展超", //乘机人姓名
"passengerType":"成人", //旅客类型:成人/儿童/婴儿(国际机票:暂不支持儿童和婴儿)
"companyId":"S118022", //公司编号
"sex":"男", //必传 性别:男/女;不能传其他字符
"cnName":"刘展超", //中文姓名(中文姓名、英文姓名2选一)
"enName":"liu/zhanchao", //英文姓名(中文姓名、英文姓名2选一,格式:zhang/san)
"userName":"AK_liuzhanchao", //登录用户名
"dId":0, //部门ID(不传)
"dName":"美亚集团/旅游产品部/运营中心", //部门名称(空则不更新);多层级部门用/分割传,比如:美亚集团/旅游产品部/运营中心
"nationality":"CN", //国籍:中国填写 CN,必传
"birthday":"2000-01-20", //出生日期(yyyy-MM-dd)必传
"mobile":"18628535565", //手机号码
"mobileAreaCode":"556", //国际手机号码区号,国内手机号可不传
"email":"liuzhanchao@meiya.com", //电子邮箱
"CostList":
[{
"costCenterName": "", //成本中心名称
}], //成本中心,没有成本中心则传 null(null 则不更新),有则只传成本中心名称即可
"certificatesList":
[{
"certType":"身份证", //证件类型:身份证/台湾通行证/因公护照/因私护照/军人证/港澳通行证/国际海员证/台胞证/外国人永久居留身份证/其它/港澳台居民居住证
"certNumber":"410802198909128831", //证件号码
"expiration":"2025-10-01", //必传 证件有效期(yyyy-MM-dd)默认一年
"isFlightCertificate":true, //是否是乘机证件
}], //证件
"defaultRoleId": "", //默认角色
"holderId":"M1", //职称ID; 关系到差标映射,对应客户系统的职级职等;请和业务一起划分好差标等级确认传值
"postID":"一厂经理", //职位ID
"approvalOutsideId": "", //审批人的外部系统编号
"SuperVip":0, //0:非VIP 1VIP
"phone":"020-82862903", //固定电话
"policyId": "", //差旅政策ID;如果是非正常职等差标满足不了的,则使用policyId传美亚差标ID,进行跨职等差标预订;例如旅客配领导享受领导差标;
"staffId": "", //员工工号
"insuranceList":
[{
"insuranceId":0, //保险产品编号(联系美亚获取)
"insuranceCount":0, //保险份数(一般最大是两份)
}], //保险产品信息
"chooseSeatNo": "", //在线选座(火车票)如:1A
"isPositionMapping":0, //是否存在职位映射
0=否,1=是(校验postID 更新职位)
"frequentTraveller":
{
"airlineCode":"MU", //航司二字码
"cardName":"东方明珠积分卡", //常旅卡名称
"cardNumber":"7894587775", //常旅卡号
}, //常旅卡信息
"certificatePhoto":
{
"fileName":"我的证件.jpg", //文件名称
"fileCode":"ADWHIFHWFJJSFJWFJ...", //文件流
}, //证件图片信息(只有国际机票使用,其他产品传null 或者不处理)
}], //旅客列表
"reasonList":
[{
"outsidePassengerId": "", //
"tripNum":0, //
"reasonID":0, //
"reasonRemark": "", //
}], //违反差旅政策原因
"contactList":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"bookType":"0", //默认不传为0, 0-因公 ;1-因私;
"receivePayType":"0", //默认不传为0, 0-信用付;1-即付, 3-预存款支付,因私默认0;
"uatpCompany":0, //指定UATP公司
"isUatp":false, //是否使用uatp(默认true)
"IsAutoSubmit":false, //是否自动提交,如果没有审批流程自动审批的话则赋值为true,否则为false
"InvoiceType":0, //客户所需发票类型
默认=0 ( 0=纸质行程单 1=电子行程单 )
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNos | 订单号列表 | Array[] | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNos":"['TB2301739801']", //订单号列表
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
根据初始订单,查询可改签航班航班信息
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单号 | String | 是 | |
departureDate | 出发日期 | String | 是 | |
airline | 销售航司 | String | 否 | |
cabinClass | 舱位等级(经济舱:1 公务舱:2 头等舱:3 豪华经济舱:4) | String | 否 | |
isShowALLPrice | 是否显示所有航班 | Boolean | 否 | |
isCodeShare | 是否返回共享航班:1返回(默认)、0:(不返回) | Integer | 否 | |
isShowALLFlight | 是否返回所有航班::1返回(默认)、0:(只返回可改签航班) | Integer | 否 | |
departureCity | 出发机场 | String | 否 | |
arrivalCity | 到达机场 | String | 否 | |
changeType | 改签类型(自愿[默认]100;非自愿:200) | Integer | 否 | |
isOnlyDirectFlight |
是否仅查直飞(仅支持单程),默认是true
添加日期: 2024-04-08 |
Boolean | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2300009065", //订单号
"departureDate":"TB2300009065", //出发日期
"airline":"TB2300009065", //销售航司
"cabinClass":"1", //舱位等级(经济舱:1 公务舱:2 头等舱:3 豪华经济舱:4)
"isShowALLPrice":true, //是否显示所有航班
"isCodeShare":1, //是否返回共享航班:1返回(默认)、0:(不返回)
"isShowALLFlight":1, //是否返回所有航班::1返回(默认)、0:(只返回可改签航班)
"departureCity":"CAN", //出发机场
"arrivalCity":"BJS", //到达机场
"changeType":100, //改签类型(自愿[默认]100;非自愿:200)
"isOnlyDirectFlight":true, //是否仅查直飞(仅支持单程),默认是true
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
flightInfoList | 返回结果 | Array[] | ||
resultID | 行程ID 比如:去程、回程 | String | flightInfoList | |
segmentID | 航班ID | String | flightInfoList | |
depDate | 出发日期 | String | flightInfoList | |
depTime | 出发时间 | String | flightInfoList | |
arrDate | 到达日期 | String | flightInfoList | |
arrTime | 到达时间 | String | flightInfoList | |
orgCity | 出发城市名称 | String | flightInfoList | |
orgCityCode | 出发城市编码 | String | flightInfoList | |
desCity | 到达城市名称 | String | flightInfoList | |
desCityCode | 到达城市编码 | String | flightInfoList | |
orgAirport | 出发机场名称 | String | flightInfoList | |
orgAirportCode | 出发机场编号 | String | flightInfoList | |
desAirport | 到达机场名称 | String | flightInfoList | |
desAirportCode | 到达机场编号 | String | flightInfoList | |
depTerm | 出发航站楼 | String | flightInfoList | |
arrTerm | 到达航站楼 | String | flightInfoList | |
flightNo | 销售航班号 | String | flightInfoList | |
airlineCode | 销售航司编号 | String | flightInfoList | |
airlineName | 销售航司 | String | flightInfoList | |
planeMode | 机型 | String | flightInfoList | |
isCodeShare | 是否共享航班 | Boolean | flightInfoList | |
carrier | 实际承运航班号;如果销售航班号是共享航班号,那么实际承运航班号才有值的 | String | flightInfoList | |
meal | 餐食 | Boolean | flightInfoList | |
MealCode | 餐食编号 | String | flightInfoList | |
MealName | 餐食名称 B :早餐 C :免费酒精饮料 D :正餐 F :供采购的食物 G :供采购的食物和饮料 H :热膳食 K :轻快早餐 L :午餐 M: 膳食 N :没有饭食供应 O: 冷膳食 P :供采购的酒精饮料 R :茶点 S: 快餐 V :供采购的茶点 | String | flightInfoList | |
tpm | 里程 | Integer | flightInfoList | |
stopNumber | 经停0:无经停,1:有经停 | Integer | flightInfoList | |
fAmount | 头等舱全价 | Number | flightInfoList | |
cAmount | 公务舱全价 | Number | flightInfoList | |
yAmount | 经济舱全价 | Number | flightInfoList | |
secondFlight |
第二段
添加日期: 2024-04-08 |
SecondFlight | flightInfoList | |
depDate |
出发日期
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
depTime |
出发时间
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
arrDate |
到达日期
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
arrTime |
到达时间
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgCity |
出发城市名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgCityCode |
出发城市编码
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desCity |
到达城市名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desCityCode |
到达城市编码
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgAirport |
出发机场名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
orgAirportCode |
出发机场编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desAirport |
到达机场名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
desAirportCode |
到达机场编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
depTerm |
出发航站楼
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
arrTerm |
到达航站楼
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
flightNo |
销售航班号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
airlineCode |
销售航司编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
airlineName |
销售航司
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
planeMode |
机型
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
isCodeShare |
是否共享航班
添加日期: 2024-04-08 |
Boolean | flightInfoList.secondFlight | |
carrier |
实际承运航班号;如果销售航班号是共享航班号,那么实际承运航班号才有值的
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
meal |
餐食
添加日期: 2024-04-08 |
Boolean | flightInfoList.secondFlight | |
MealCode |
餐食编号
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
MealName |
餐食名称
B :早餐
C :免费酒精饮料
D :正餐
F :供采购的食物
G :供采购的食物和饮料
H :热膳食
K :轻快早餐
L :午餐
M: 膳食
N :没有饭食供应
O: 冷膳食
P :供采购的酒精饮料
R :茶点
S: 快餐
V :供采购的茶点
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopNumber |
经停0:无经停,1:有经停
添加日期: 2024-04-08 |
Integer | flightInfoList.secondFlight | |
carrierAirlineName |
实际承运航司中文名
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopCityName |
经停城市名称
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopCityCode |
经停城市三字码
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopTime |
经停时长
添加日期: 2024-04-08 |
String | flightInfoList.secondFlight | |
stopItemList |
经停的具体项,仅当stopNumber>0时有数据
添加日期: 2024-04-08 |
Array[] | flightInfoList.secondFlight | |
cityName | 城市的中文说明 | String | flightInfoList.secondFlight.stopItemList | |
depTime | 从该经停地起飞的时间 | String | flightInfoList.secondFlight.stopItemList | |
arrTime | 到达该经停地的时间 | String | flightInfoList.secondFlight.stopItemList | |
flightPriceInfoList | 价格信息 | Array[] | flightInfoList | |
priceID | 价格ID | String | flightInfoList.flightPriceInfoList | |
flightID | 航段序号(等于resultID+segmentID+priceID下划线分割) | String | flightInfoList.flightPriceInfoList | |
discount | 折扣 | Number | flightInfoList.flightPriceInfoList | |
ticketPrice | 票价 | Number | flightInfoList.flightPriceInfoList | |
airPortFee | 机场建设费 | Number | flightInfoList.flightPriceInfoList | |
oilFee | 燃油费 | Number | flightInfoList.flightPriceInfoList | |
serviceAmount | 服务费 | Number | flightInfoList.flightPriceInfoList | |
airlineYouHui | 航司优惠 | Number | flightInfoList.flightPriceInfoList | |
meiYaYouHui | 美亚优惠 | Number | flightInfoList.flightPriceInfoList | |
amount | 舱位公布运价 | Number | flightInfoList.flightPriceInfoList | |
airlineYouHuiAmount | 机票票面价 | Number | flightInfoList.flightPriceInfoList | |
cabinType | 舱位(如:Y) | String | flightInfoList.flightPriceInfoList | |
cabin | 舱位等级 | String | flightInfoList.flightPriceInfoList | |
clazzName | 舱位名称 | String | flightInfoList.flightPriceInfoList | |
cabinAliasNameCn |
舱等别名-中文
添加日期: 2023-10-17 |
String | flightInfoList.flightPriceInfoList | |
cabinAliasNameEn |
舱等别名-英文
添加日期: 2023-10-17 |
String | flightInfoList.flightPriceInfoList | |
refundChangeInfo | 退改条款 | String | flightInfoList.flightPriceInfoList | |
violate | 违反差旅政策标识(0表示不违反,1表示违反但不是强制的,2标示违反强制差旅政策) | Integer | flightInfoList.flightPriceInfoList | |
seatNum | 座位数(9张或9张以上:A;1-8张:具体座位数) | String | flightInfoList.flightPriceInfoList | |
protocolType | 协议类型(0:非协议价;1、2协议价) | Integer | flightInfoList.flightPriceInfoList | |
isForbidReturn | 不得退票(只退未使用税费) | Boolean | flightInfoList.flightPriceInfoList | |
isForbidChange | 不得变更 | Boolean | flightInfoList.flightPriceInfoList | |
luggageRule | 行李额规则 | String | flightInfoList.flightPriceInfoList | |
fareType | 运价来源; PUBLIC 公布运价,PRIVATE 私有运价 AGREEMENT 协议价 | String | flightInfoList.flightPriceInfoList | |
refundRuleInfo | 退票规则内容 | String | flightInfoList.flightPriceInfoList | |
changeRuleInfo | 改签规则内容 | String | flightInfoList.flightPriceInfoList | |
transferRuleInfo | 签转规则内容 | String | flightInfoList.flightPriceInfoList | |
purchaseRule | 购票规定 | ApiTicketPricePurchaseRule | flightInfoList.flightPriceInfoList | |
content | 内容 | String | flightInfoList.flightPriceInfoList.purchaseRule | |
categories | 分类 | Array[] | flightInfoList.flightPriceInfoList.purchaseRule | |
type | 类型,0=小团专享,1=青年特惠,2=长者特惠 | String | flightInfoList.flightPriceInfoList.purchaseRule.categories | |
content | 内容 | String | flightInfoList.flightPriceInfoList.purchaseRule.categories | |
structor | 内容结构 | ApiTicketPricePurchaseRuleStruct | flightInfoList.flightPriceInfoList.purchaseRule | |
minCount | 最小旅客数量(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
maxCount | 最大旅客数量(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
minAge | 最小年龄(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
maxAge | 最大年龄(空为不限) | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
certificateTypes | 证件类型(身份证/因私护照/因公护照等等) | Array[] | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
gertificateNumber | 证件号码限制 | String | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
genders | 性别(男/女) | Array[] | flightInfoList.flightPriceInfoList.purchaseRule.structor | |
ticketLuggageRule | 行李额 | TicketLuggageRule | flightInfoList.flightPriceInfoList | |
checkRuleInfo | 托运行李规则内容(托运汇总内容) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
handRuleInfo | 手提行李规则内容(手提汇总内容) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeCheckCount | 免费托运行李数量 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeCheckUnit | 免费托运行李单位 KG=公斤 PC=件 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeCheckLuggage | 免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
checkDescription | 托运行李说明 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeHandCount | 免费手提行李数量 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeHandUnit | 免费手提行李单位 KG=公斤 PC=件 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
freeHandLuggage | 免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”) | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
handDescription | 手提行李说明 | String | flightInfoList.flightPriceInfoList.ticketLuggageRule | |
refundFees | 退票规则费用计算 | Array[] | flightInfoList.flightPriceInfoList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | flightInfoList.flightPriceInfoList.refundFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.refundFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.refundFees | |
fee | 运算后的退改费用(元) | Number | flightInfoList.flightPriceInfoList.refundFees | |
baseFee | 运算基数 | Number | flightInfoList.flightPriceInfoList.refundFees | |
feePercent | 费用百分比 | Number | flightInfoList.flightPriceInfoList.refundFees | |
minimumFee | 保底费用(元) | Number | flightInfoList.flightPriceInfoList.refundFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | flightInfoList.flightPriceInfoList.refundFees | |
timingCount | 计时数量 | Integer | flightInfoList.flightPriceInfoList.refundFees | |
timingUnit | 计时单位:H 小时、D 天 | String | flightInfoList.flightPriceInfoList.refundFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | flightInfoList.flightPriceInfoList.refundFees | |
changeFees | 改签规则费用计算 | Array[] | flightInfoList.flightPriceInfoList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | flightInfoList.flightPriceInfoList.changeFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.changeFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | flightInfoList.flightPriceInfoList.changeFees | |
fee | 运算后的退改费用(元) | Number | flightInfoList.flightPriceInfoList.changeFees | |
baseFee | 运算基数 | Number | flightInfoList.flightPriceInfoList.changeFees | |
feePercent | 费用百分比 | Number | flightInfoList.flightPriceInfoList.changeFees | |
minimumFee | 保底费用(元) | Number | flightInfoList.flightPriceInfoList.changeFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | flightInfoList.flightPriceInfoList.changeFees | |
timingCount | 计时数量 | Integer | flightInfoList.flightPriceInfoList.changeFees | |
timingUnit | 计时单位:H 小时、D 天 | String | flightInfoList.flightPriceInfoList.changeFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | flightInfoList.flightPriceInfoList.changeFees |
{
"flightInfoList":
[{
"resultID":"bbe4b225e9094de38e8750b6be292695", //行程ID 比如:去程、回程
"segmentID":"fb84a4ca567c4c56936e7ad739a60333", //航班ID
"depDate":"2023-12-26", //出发日期
"depTime":"06:30", //出发时间
"arrDate":"2023-12-26", //到达日期
"arrTime":"09:00", //到达时间
"orgCity":"广州", //出发城市名称
"orgCityCode":"CAN", //出发城市编码
"desCity":"昆明", //到达城市名称
"desCityCode":"KMG", //到达城市编码
"orgAirport":"白云国际机场", //出发机场名称
"orgAirportCode":"CAN", //出发机场编号
"desAirport":"长水国际机场", //到达机场名称
"desAirportCode":"KMG", //到达机场编号
"depTerm":"T1", //出发航站楼
"arrTerm":"T1", //到达航站楼
"flightNo":"MU6823", //销售航班号
"airlineCode":"MU", //销售航司编号
"airlineName":"东方航空-东", //销售航司
"planeMode":"波音73L(中)", //机型
"isCodeShare":false, //是否共享航班
"carrier":"null", //实际承运航班号;如果销售航班号是共享航班号,那么实际承运航班号才有值的
"meal":false, //餐食
"MealCode":"0", //餐食编号
"MealName":"null", //餐食名称
B :早餐
C :免费酒精饮料
D :正餐
F :供采购的食物
G :供采购的食物和饮料
H :热膳食
K :轻快早餐
L :午餐
M: 膳食
N :没有饭食供应
O: 冷膳食
P :供采购的酒精饮料
R :茶点
S: 快餐
V :供采购的茶点
"tpm":0, //里程
"stopNumber":0, //经停0:无经停,1:有经停
"fAmount":5450.0, //头等舱全价
"cAmount":4950.0, //公务舱全价
"yAmount":1980.0, //经济舱全价
"flightPriceInfoList":
[{
"priceID":"1", //价格ID
"flightID":"bbe4b225e9094de38e8750b6be292695_fb84a4ca567c4c56936e7ad739a60333_1", //航段序号(等于resultID+segmentID+priceID下划线分割)
"discount":33.8, //折扣
"ticketPrice":670.0, //票价
"airPortFee":50.0, //机场建设费
"oilFee":130.0, //燃油费
"serviceAmount":10.0, //服务费
"airlineYouHui":0.0, //航司优惠
"meiYaYouHui":0.0, //美亚优惠
"amount":670.0, //舱位公布运价
"airlineYouHuiAmount":670.0, //机票票面价
"cabinType":"V", //舱位(如:Y)
"cabin":"经济舱", //舱位等级
"clazzName":"经济舱", //舱位名称
"cabinAliasNameCn":"null", //舱等别名-中文
"cabinAliasNameEn":"null", //舱等别名-英文
"refundChangeInfo":"null", //退改条款
"violate":0, //违反差旅政策标识(0表示不违反,1表示违反但不是强制的,2标示违反强制差旅政策)
"seatNum":"A", //座位数(9张或9张以上:A;1-8张:具体座位数)
"protocolType":0, //协议类型(0:非协议价;1、2协议价)
"isForbidReturn":false, //不得退票(只退未使用税费)
"isForbidChange":false, //不得变更
"luggageRule":"免费托运行李额20KG,免费手提行李额10KG。(免费携带1件10KG以内)", //行李额规则
"fareType":"PRIVATE", //运价来源; PUBLIC 公布运价,PRIVATE 私有运价 AGREEMENT 协议价
"refundFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //退票规则费用计算
"changeFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //改签规则费用计算
"ticketLuggageRule":
{
"checkRuleInfo": "", //托运行李规则内容(托运汇总内容)
"handRuleInfo": "", //手提行李规则内容(手提汇总内容)
"freeCheckCount":"1", //免费托运行李数量
"freeCheckUnit":"PC", //免费托运行李单位 KG=公斤 PC=件
"freeCheckLuggage":"1PC", //免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”)
"checkDescription":"1件", //托运行李说明
"freeHandCount": "", //免费手提行李数量
"freeHandUnit": "", //免费手提行李单位 KG=公斤 PC=件
"freeHandLuggage": "", //免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”)
"handDescription": "", //手提行李说明
}, //行李额
"refundRuleInfo":"null", //退票规则内容
"changeRuleInfo":"null", //改签规则内容
"transferRuleInfo":"null", //签转规则内容
"purchaseRule":
{
"content": "", //内容
"categories":
[{
"type": "", //类型,0=小团专享,1=青年特惠,2=长者特惠
"content": "", //内容
}], //分类
"structor":
{
"minCount": "", //最小旅客数量(空为不限)
"maxCount": "", //最大旅客数量(空为不限)
"minAge": "", //最小年龄(空为不限)
"maxAge": "", //最大年龄(空为不限)
"certificateTypes":[], //证件类型(身份证/因私护照/因公护照等等)
"gertificateNumber": "", //证件号码限制
"genders":[], //性别(男/女)
}, //内容结构
}, //购票规定
}], //价格信息
"secondFlight":"1980.0", //第二段
}], //返回结果
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
南网获取改签价格,根据初始订单查询改签单价格
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
originalOrderNo | 美亚原订购单号 | String | 否 | |
ticketNo | 票号 | Array[] | 否 | |
changeType | 改签类型 自愿变更 = 100, 非自愿变更 = 200 | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
flightList | 航段列表 | Array[] | 否 | |
flightID | 航班ID(从查询航班返回获取) | String | flightList | |
departureCity | 出发城市(三字码) | String | flightList | |
arrivalCity | 达到城市(三字码) | String | flightList | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList | |
airline | 航空二字码,如 MU | String | flightList | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList | |
secondFlight | 预订多程中转航班时需要必传; | FlightInfoForCreateBase | flightList | |
flightID | 航班ID(从查询航班返回获取) | String | flightList.secondFlight | |
departureCity | 出发城市(三字码) | String | flightList.secondFlight | |
arrivalCity | 达到城市(三字码) | String | flightList.secondFlight | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList.secondFlight | |
airline | 航空二字码,如 MU | String | flightList.secondFlight | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList.secondFlight | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList.secondFlight | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList.secondFlight |
{
"originalOrderNo":"TB2301733006", //美亚原订购单号
"ticketNo":"[“999 - 3102966118”]", //票号
"flightList":
[{
"secondFlight":
{
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}, //预订多程中转航班时需要必传;
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}], //航段列表
"changeType":100, //改签类型 自愿变更 = 100,
非自愿变更 = 200
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
isCanOnlineReturn | 是否可以在线退 如果为false,则不显示价格信息,走人工核对流程 | Boolean | ||
noOnlineReason | 不能在线改签的原因,方便排查问题 | String | ||
pnr | 新PNR | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
changePrice | 费用信息 | Array[] | ||
passType | 旅客类型 成人/儿童/婴儿 | String | changePrice | |
personNum | 人数 | Integer | changePrice | |
upgradeFee | 升舱费 | Number | changePrice | |
sellAmount | 变更手续费 | Number | changePrice | |
airPortFee | 机建费 | Number | changePrice | |
oilFee | 燃油费 | Number | changePrice | |
servicePrice | 服务费 | Number | changePrice | |
total | 费用合计(单人) | Number | changePrice |
{
"isCanOnlineReturn":true, //是否可以在线退
如果为false,则不显示价格信息,走人工核对流程
"noOnlineReason":"No", //不能在线改签的原因,方便排查问题
"pnr":"KDL0N7", //新PNR
"changePrice":
[{
"passType":"成人", //旅客类型
成人/儿童/婴儿
"personNum":1, //人数
"upgradeFee":320.0, //升舱费
"sellAmount":120.0, //变更手续费
"airPortFee":0.0, //机建费
"oilFee":0.0, //燃油费
"servicePrice":10, //服务费
"total":450.0, //费用合计(单人)
}], //费用信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
南网初始化退票单接口,根据初始订单查询目前已出票订单是否可退改
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单编号 | String | 是 | |
operateType | 改签:change-改签;退票:refund | String | 是 | |
rebackType | 退票/改签类型(自愿 100;非自愿:200) | Integer | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB2301737396", //订单编号
"operateType":"refund", //改签:change-改签;退票:refund
"rebackType":100, //退票/改签类型(自愿 100;非自愿:200)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 订单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
segmentInfos | 人员信息 | Array[] | ||
segmentNo | 航程号 | Integer | segmentInfos | |
passengerInfo | 旅客信息 | ApiChangeRefundInitPassenger | segmentInfos | |
passengerName | 乘机人名字 | String | segmentInfos.passengerInfo | |
ticketNo | 票号 | String | segmentInfos.passengerInfo | |
isCanRefund | 是否可退 | Boolean | segmentInfos.passengerInfo | |
isCanChange | 是否可改 | Boolean | segmentInfos.passengerInfo | |
unRefundReason | 不可退原因 | String | segmentInfos.passengerInfo | |
unChangeReason | 不可改原因 | String | segmentInfos.passengerInfo | |
changeServiceFee | 改签服务费 | Number | segmentInfos.passengerInfo | |
refundServiceCommission | 退票手续费(费用无值时返回-1) | Number | segmentInfos.passengerInfo | |
refundServiceFee | 退票服务费 | Number | segmentInfos.passengerInfo |
{
"orderNo":"TB2301740977", //订单号
"segmentInfos":
[{
"passengerInfo":
{
"passengerName":"刘展超", //乘机人名字
"ticketNo":"731-8533068416", //票号
"isCanRefund":true, //是否可退
"isCanChange":true, //是否可改
"unRefundReason": "", //不可退原因
"unChangeReason": "", //不可改原因
"changeServiceFee":0, //改签服务费
"refundServiceCommission":-1, //退票手续费(费用无值时返回-1)
"refundServiceFee":0, //退票服务费
}, //旅客信息
"segmentNo":1, //航程号
}], //人员信息
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
南网创建改签单接口,根据初始订单操作目前出票的订单改签
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 原订购单编号 | String | 是 | |
oaSerialnumber | 出差申请单号 | String | 否 | |
opRemark | 备注 | String | 否 | |
ticketNoList | 票号 | Array[] | 是 | |
changeType | 改签类型(自愿 100;非自愿:200) | Integer | 是 | |
changeReason | 改签原因 | String | 是 | |
OaOrderSource | 订单来源 | String | 否 | |
opId | 制单人旅客编号(内部使用) | String | 否 | |
opName | 制单人旅客姓名(内部使用) | String | 否 | |
isSubmit | 是否提交改签出票(true时不用再调用SubmitChangeOrder,同一个公司需要统传值) | Boolean | 否 | |
receivePayType | 默认不传为0, 0-信用付;1-即付,因私默认0; | String | 是 | |
InvoiceType | 客户所需发票类型 默认=0 ( 0=纸质行程单 1=电子行程单 ) | Integer | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
contactInfo | 联系人信息 | ContactInfo | 是 | |
contactName | 联系人 | String | contactInfo | |
mobile | 手机号码 | String | contactInfo | |
phone | 联系电话 | String | contactInfo | |
电子邮件 | String | contactInfo | ||
flightList | 航段列表 | Array[] | 是 | |
flightID | 航班ID(从查询航班返回获取) | String | flightList | |
departureCity | 出发城市(三字码) | String | flightList | |
arrivalCity | 达到城市(三字码) | String | flightList | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList | |
airline | 航空二字码,如 MU | String | flightList | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList | |
secondFlight | 预订多程中转航班时需要必传; | FlightInfoForCreateBase | flightList | |
flightID | 航班ID(从查询航班返回获取) | String | flightList.secondFlight | |
departureCity | 出发城市(三字码) | String | flightList.secondFlight | |
arrivalCity | 达到城市(三字码) | String | flightList.secondFlight | |
departureDate | 出发日期:yyyy-MM-dd | String | flightList.secondFlight | |
airline | 航空二字码,如 MU | String | flightList.secondFlight | |
cabinType | 舱位(航班查询返回的 cabinType:如Y、L等) | String | flightList.secondFlight | |
flightNo | 航班号(航班查询返回的 flightNo ) | String | flightList.secondFlight | |
price | 价格(票面价,航班查询返回的 ticketPrice) | Number | flightList.secondFlight |
{
"orderNo": "", //原订购单编号
"oaSerialnumber": "", //出差申请单号
"opRemark": "", //备注
"flightList":
[{
"secondFlight":
{
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}, //预订多程中转航班时需要必传;
"flightID":"0b6d51da3f5944588e8a8aad5a5385ae_d80bce71449e4f3f8093966f2ec85b8a_19", //航班ID(从查询航班返回获取)
"departureCity":"CTU", //出发城市(三字码)
"arrivalCity":"LXA", //达到城市(三字码)
"departureDate":"2023-10-25", //出发日期:yyyy-MM-dd
"airline":"TV", //航空二字码,如 MU
"cabinType":"V1", //舱位(航班查询返回的 cabinType:如Y、L等)
"flightNo":"TV9803", //航班号(航班查询返回的 flightNo )
"price":600, //价格(票面价,航班查询返回的 ticketPrice)
}], //航段列表
"ticketNoList":[], //票号
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"changeType":0, //改签类型(自愿 100;非自愿:200)
"changeReason": "", //改签原因
"OaOrderSource": "", //订单来源
"opId": "", //制单人旅客编号(内部使用)
"opName": "", //制单人旅客姓名(内部使用)
"isSubmit":false, //是否提交改签出票(true时不用再调用SubmitChangeOrder,同一个公司需要统传值)
"receivePayType": "", //默认不传为0, 0-信用付;1-即付,因私默认0;
"InvoiceType":0, //客户所需发票类型
默认=0 ( 0=纸质行程单 1=电子行程单 )
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 订单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNo": "", //订单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
南网创建退票单接口,根据初始订单操作目前出票的订单退票
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
oaSerialnumber | 出差申请单号 | String | 否 | |
orderNo | 原订购单编号 | String | 否 | |
rebackType | 退票/改签类型(自愿 100;非自愿:200) | Integer | 否 | |
refundReason | 退票原因 | String | 否 | |
segmentList | 航段号(退改初始化接口获取) | Array[] | 否 | |
ticketNoList | 票号列表 | Array[] | 否 | |
isSubmit | 是否提交退票(true时不用再调用SubmitReturnOrder,同一个公司需要统传值) | Boolean | 否 | |
sessionId | sessionId,login接口返回 | String | 是 | |
contactInfo | 联系人信息 | ContactInfo | 否 | |
contactName | 联系人 | String | contactInfo | |
mobile | 手机号码 | String | contactInfo | |
phone | 联系电话 | String | contactInfo | |
电子邮件 | String | contactInfo |
{
"oaSerialnumber": "", //出差申请单号
"orderNo": "", //原订购单编号
"rebackType":0, //退票/改签类型(自愿 100;非自愿:200)
"refundReason": "", //退票原因
"segmentList":[0], //航段号(退改初始化接口获取)
"ticketNoList":[], //票号列表
"contactInfo":
{
"contactName":"刘展超", //联系人
"mobile":"18205205295", //手机号码
"phone":"020-66548585", //联系电话
"email":"liuzhanchao@meiya.com", //电子邮件
}, //联系人信息
"isSubmit":false, //是否提交退票(true时不用再调用SubmitReturnOrder,同一个公司需要统传值)
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNoList | 订单号 | Array[] | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"orderNoList":[], //订单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
南网订单提交和取消处理,根据初始原订单操作订单提交和取消
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 订单号 | String | 否 | |
operate | 操作(取消 或者 出票) | String | 否 | |
ticketNo | 票号,一次只能操作一个票号; | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo": "", //订单号
"operate": "", //操作(取消 或者 出票)
"ticketNo": "", //票号,一次只能操作一个票号;
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
priceInfo | PAT信息,只有出票时变价才返回 | PATPriceInfo | ||
newPrice | 新价格 | Number | priceInfo | |
oldPrice | 旧价格 | Number | priceInfo |
{
"priceInfo":
{
"newPrice":1500.00, //新价格
"oldPrice":1350.00, //旧价格
}, //PAT信息,只有出票时变价才返回
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
南网查询订单详细信息,根据初始原订单查询
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订购单号 | String | 否 | |
outsideOrderNo | 客户订单号 | String | 否 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo": "", //美亚订购单号
"outsideOrderNo": "", //客户订单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderNo | 订购单号 | String | ||
outsideOrderNo | 外部订单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
data | 订单信息(如果有订退改,则list有多个订单) | Array[] | ||
orderType |
订单类型
1:国内机票订购单; 2:国内机票改签单; 3:国内机票退票单; 11:国际机票订购单; 12:国际机票改签单; 13:国际机票退票单 |
Integer | data | |
status |
订单状态
国际机票只包含:40,70,80 5 :待提交 10 :审批中 20 :待收款 25 :待付款 30 :出票中 35 :紧急处理 40 :已出票 50 :已取消 60 :待核对 70 :处理中 75 :紧急处理 80 :已处理 200:待审核 |
Integer | data | |
changeType | 变更/改签类型 0:未知 100:自愿 200:非自愿 | Integer | data | |
changeReason | 变更/改签原因 | String | data | |
totalTicketPrice | 票款总额 | Number | data | |
totalServicePrice | 服务费总额 | Number | data | |
deadLineTime | 价格有效期(改签单和退票单时,订单需在价格有效期内提交订单,过了有效期会提交订单失败) | String | data | |
tripId | 行程编号 | String | data | |
companyId | 公司编号 | String | data | |
failureReason | 订单失败原因 | String | data | |
oaOtherInfo | 其他信息,个性化客户需要(比如:中奖码) | String | data | |
firstOrderNo | 美亚原购单号 | String | data | |
orderSource | 订单来源 | Integer | data | |
receivePayType |
支付方式
月结 现结 预存卡 |
String | data | |
affiliateBusinessName | 供应商 | String | data | |
pnr | pnr | String | data | |
StaffPayExcess |
个人承担费用,=true 为存在个人承担,false
添加日期: 2024-04-03 |
Boolean | data | |
PolicyExcessAmount |
StaffPayExcess=true 时需要关注,个人承担的金额,否则为 0;
添加日期: 2024-04-03 |
Number | data | |
CompanyExcessAmount |
StaffPayExcess=true 时需要关注,公司承担的金额;
添加日期: 2024-04-03 |
Number | data | |
c_TextField_2401 | 客户自定义字段1 | String | data | |
c_TextField_2402 | 客户自定义字段2 | String | data | |
c_TextField_2403 | 客户自定义字段3 | String | data | |
c_TextField_2404 | 客户自定义字段4 | String | data | |
c_TextField_2405 | 客户自定义字段5 | String | data | |
c_TextField_2406 | 客户自定义字段6 | String | data | |
c_TextField_2407 | 客户自定义字段7 | String | data | |
c_TextField_2408 | 客户自定义字段8 | String | data | |
totalPrice | 当前订单总金额 | Number | data | |
opId | 制单人旅客编号 | String | data | |
onBusiness | 订单类型(1:因公;0:因私) 注意:如果因私订单不需要的,记得接收时过滤掉 | Integer | data | |
orderRemark | 订单备注 | String | data | |
outsideOrderNo | 客户订单号 | String | data | |
orderNo | 美亚订单号 | String | data | |
originalOrderNo | 美亚原订单号 | String | data | |
opStaffCode | 客户制单人工号 | String | data | |
opName | 客户制单人 | String | data | |
opDate | 下单时间(yyyy-MM-dd HH:mm:ss) | String | data | |
statusText | 订单状态(名称) | String | data | |
issueDate | 出票日期(yyyy-MM-dd HH:mm:ss) | String | data | |
oaSerialnumber | 客户出差申请单号 | String | data | |
stApplyOrderNo | 美亚出差申请单号 | String | data | |
contactInfo | 联系人信息 | OrderPushContactinfo | data | |
contactName | 联系人姓名 | String | data.contactInfo | |
mobile | 手机号 | String | data.contactInfo | |
phone | 固定电话 | String | data.contactInfo | |
邮箱 | String | data.contactInfo | ||
policyList | 出差政策列表 | Array[] | data | |
passengerCode | 旅客编号 | String | data.policyList | |
staffCode | 旅客编号 | String | data.policyList | |
passengerName | 旅客姓名 | String | data.policyList | |
policyName | 政策名称 | String | data.policyList | |
policyProperty | 属性(建议/强制) | String | data.policyList | |
policyType | 基础/分类/个人/附加 | String | data.policyList | |
costList | 成本中心 | Array[] | data | |
remark | 备注 | String | data.costList | |
staffCode | 员工工号 | String | data.costList | |
passengerCode | 旅客编号 | String | data.costList | |
passengerName | 旅客名称 | String | data.costList | |
costId | 成本中心编号 | Integer | data.costList | |
costCenterName | 成本中心名称 | String | data.costList | |
amount | 成本金额 | Number | data.costList | |
priceList | 价格信息 | Array[] | data | |
passengerType | 旅客类型 | String | data.priceList | |
ticketPrice | 机票票面价格(改签时为升舱费) | Number | data.priceList | |
tax | 机场建设费;国际机票税费 | Number | data.priceList | |
oilFee | 燃油附加费;国际机票无 | Number | data.priceList | |
servicePrice | 服务费 | Number | data.priceList | |
discount | 折扣(8.0折进值为80);国际机票无 | Number | data.priceList | |
serviceCommission | 改签/退票手续费 | Number | data.priceList | |
usedFlight | 已使用航段费 | Number | data.priceList | |
orderSurcharge | 退票详情里的 单据附加费 | Number | data.priceList | |
passengerCode | 旅客编号 | String | data.priceList | |
passengerName | 旅客姓名 | String | data.priceList | |
staffCode | 员工工号 | String | data.priceList | |
currency | 结算币种 | String | data.priceList | |
quotationCurrency | 报价币种(预留,暂返回空) | String | data.priceList | |
QuotationPrice | 国际机票,报价价格,多币种报价结算时才使用 暂无实际数据 | QuotationPriceMode | data.priceList | |
quotationTicketPrice | 机票票面价格(改签时为升舱费) | Number | data.priceList.QuotationPrice | |
quotationTax | 机场建设费 | Number | data.priceList.QuotationPrice | |
quotationServicePrice | 服务费 | Number | data.priceList.QuotationPrice | |
quotationServiceCommission | 改签/退票手续费 | Number | data.priceList.QuotationPrice | |
quotationSellIticketChangefee | 国际改签单改签手续费 | Number | data.priceList.QuotationPrice | |
passengerList | 旅客信息 | Array[] | data | |
reasonId | 差旅政策违反原因序号 | Integer | data.passengerList | |
reasonRemark | 差旅政策违反原因 | String | data.passengerList | |
errorMessage | 退票失败原因(订单为火车票时有值) | String | data.passengerList | |
returnStatus | 出票状况(订单为火车票时有值) | String | data.passengerList | |
seatNo | 座席号(订单为火车票时有值) | String | data.passengerList | |
originalTicketNo | 机票/火车票原票号(改签单时有值) | String | data.passengerList | |
belongToProject |
归属项目
添加日期: 2023-11-21 |
String | data.passengerList | |
travelPurpose |
出行目的
添加日期: 2023-11-21 |
String | data.passengerList | |
passengerNo | 旅客排序号(从1开始递增) | Integer | data.passengerList | |
passengerCode | 旅客编号 | String | data.passengerList | |
passengerName | 旅客姓名 | String | data.passengerList | |
certificateType | 证件类型 | String | data.passengerList | |
certificateId | 证件号码 | String | data.passengerList | |
passengerType | 旅客类型(成人/儿童/婴儿) | String | data.passengerList | |
ticketNo | 机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系) | String | data.passengerList | |
staffCode | 员工工号 | String | data.passengerList | |
mobile | 旅客手机号码 | String | data.passengerList | |
旅客邮箱,国际机票使用 | String | data.passengerList | ||
statusDesc | 客票状态描述 | String | data.passengerList | |
ticketStatus | 票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到 | String | data.passengerList | |
depName |
部门名称,用/分隔(列表返回最后一级,详细返回全级)
添加日期: 2018-10-18 |
String | data.passengerList | |
belongToCenter |
归属中心
添加日期: 2023-11-21 |
Array[] | data.passengerList | |
centerNo |
序号
添加日期: 2023-11-21 |
Integer | data.passengerList.belongToCenter | |
centerTitle |
归属中心标题
添加日期: 2023-11-21 |
String | data.passengerList.belongToCenter | |
centerName |
归属成本中心选项值
添加日期: 2023-11-21 |
String | data.passengerList.belongToCenter | |
segmentList | 航段信息 | Array[] | data | |
cabin |
舱位等级(1/2/3/4)
1 经济舱 2 公务舱 3 头等舱 4 豪华经济舱 |
String | data.segmentList | |
clazz | 小舱位(如:Y/Z/...) | String | data.segmentList | |
clazzName | 舱位名称 | String | data.segmentList | |
planeType | 机型 | String | data.segmentList | |
airlineCode | 销售航司编号(如:HU) | String | data.segmentList | |
segmentNo | 航段序号(从1开始) | Integer | data.segmentList | |
flightNumber | 销售航班号 | String | data.segmentList | |
originName | 出发机场名称 | String | data.segmentList | |
originCountryName | 出发地区或国家名称 | String | data.segmentList | |
originCountryCode | 出发地区或国家二字码 | String | data.segmentList | |
destinationName | 到达机场名称 | String | data.segmentList | |
destinationCountryName | 到达地区或国家名称 | String | data.segmentList | |
destinationCountryCode | 到达地区或国家二字码 | String | data.segmentList | |
departureDate | 出发日期 | String | data.segmentList | |
departureTime | 出发时间 | String | data.segmentList | |
arrivalDate | 到达日期 | String | data.segmentList | |
arrivalTime | 到达时间 | String | data.segmentList | |
flyTime | 飞行时间(分钟) | String | data.segmentList | |
carrier | 实际承运航班号(如果销售航班号是共享航班号,那么实际承运航班号才有值的) | String | data.segmentList | |
stopItem | 经停信息(格式:经停城市|到达时间|起飞时间)(如:上饶|2018-04-23 18:05|2018-04-23 18:55) | String | data.segmentList | |
originCityCode | 出发机场编码 | String | data.segmentList | |
destinationCityCode | 到达机场编码 | String | data.segmentList | |
origincityName | 出发城市名称 | String | data.segmentList | |
destinationCityName | 到达城市名称 | String | data.segmentList | |
depTerminal | 出发航站楼 | String | data.segmentList | |
arrTerminal | 到达航站楼(不详时传 --) | String | data.segmentList | |
airlineName | 航司名称 | String | data.segmentList | |
remark | 备注 | String | data.segmentList | |
ruleInfo | 航班退改规则; | String | data.segmentList | |
amount | 公布运价;(国际机票无公布运价) | Number | data.segmentList | |
fAmount | 头等舱标准价;(国际机票无头等舱标准价) | Number | data.segmentList | |
cAmount | 公务舱标准价;(国际机票无公务舱标准价) | Number | data.segmentList | |
yAmount | 经济舱标准价(国际机票无经济舱标准价) | Number | data.segmentList | |
mileage |
里程
添加日期: 2024-04-25 |
Number | data.segmentList | |
isProtocolPrice |
协议类型:0非协议票,1三方协议,2两方协议
添加日期: 2024-04-25 |
Integer | data.segmentList | |
destinationCityNameEn |
到达城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
destinationNameEng |
到达机场英文名 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
origincityNameEn |
出发城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
originNameEng |
出发机场英文名 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
stopType |
有无经停 0无 1有
添加日期: 2024-04-25 |
Integer | data.segmentList | |
stopCityName |
停留城市名称 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
stopCityNameEn |
停留城市英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
meal |
有无餐食:0 无 1 有 PM2024123 2024-04-25 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
airlineNameEng |
航司英文名 PM2024123 添加
添加日期: 2024-04-25 |
String | data.segmentList | |
JourneyIndex |
行程序号 1-第一程;2-第二程;3-第三程
添加日期: 2024-05-07 |
String | data.segmentList | |
refundRuleInfo | 退票规则内容 | String | data.segmentList | |
changeRuleInfo | 改签规则内容 | String | data.segmentList | |
transferRuleInfo | 签转规则内容 | String | data.segmentList | |
segmentIndex |
航段序号(1开始,展示用)
添加日期: 2025-02-12 |
Integer | data.segmentList | |
departureDiffHour | 出发地时差 正负数值 2025-03-21之前下单的数据为空值 null | Number | data.segmentList | |
arrivalDiffHour |
出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
添加日期: 2025-02-21 |
Number | data.segmentList | |
originProvinceCN | 出发国家省州中文名 | String | data.segmentList | |
originProvinceEN | 出发国家省州英文名 | String | data.segmentList | |
originContinentCN | 出发机场所属大洲中文名 | String | data.segmentList | |
originContinentEN | 出发机场所属大洲英文名 | String | data.segmentList | |
destinationContinentCN | 到达机场所属大洲中文名 | String | data.segmentList | |
destinationContinentEN | 到达机场所属大洲英文名 | String | data.segmentList | |
departureTimeZone | 到达时区 | String | data.segmentList | |
originTimeZone | 出发时区 | String | data.segmentList | |
originCountryNameEN | 出发国家英文名称 | String | data.segmentList | |
destinationCountryNameEN | 到达国家英文名称 | String | data.segmentList | |
routeType | 航线类型,长航线-短航线 暂无实际数据 | String | data.segmentList | |
ticketLuggageRule | 行李额 | TicketLuggageRule | data.segmentList | |
checkRuleInfo | 托运行李规则内容(托运汇总内容) | String | data.segmentList.ticketLuggageRule | |
handRuleInfo | 手提行李规则内容(手提汇总内容) | String | data.segmentList.ticketLuggageRule | |
freeCheckCount | 免费托运行李数量 | String | data.segmentList.ticketLuggageRule | |
freeCheckUnit | 免费托运行李单位 KG=公斤 PC=件 | String | data.segmentList.ticketLuggageRule | |
freeCheckLuggage | 免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”) | String | data.segmentList.ticketLuggageRule | |
checkDescription | 托运行李说明 | String | data.segmentList.ticketLuggageRule | |
freeHandCount | 免费手提行李数量 | String | data.segmentList.ticketLuggageRule | |
freeHandUnit | 免费手提行李单位 KG=公斤 PC=件 | String | data.segmentList.ticketLuggageRule | |
freeHandLuggage | 免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”) | String | data.segmentList.ticketLuggageRule | |
handDescription | 手提行李说明 | String | data.segmentList.ticketLuggageRule | |
refundFees | 退票规则费用计算 | Array[] | data.segmentList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | data.segmentList.refundFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | data.segmentList.refundFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | data.segmentList.refundFees | |
fee | 运算后的退改费用(元) | Number | data.segmentList.refundFees | |
baseFee | 运算基数 | Number | data.segmentList.refundFees | |
feePercent | 费用百分比 | Number | data.segmentList.refundFees | |
minimumFee | 保底费用(元) | Number | data.segmentList.refundFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | data.segmentList.refundFees | |
timingCount | 计时数量 | Integer | data.segmentList.refundFees | |
timingUnit | 计时单位:H 小时、D 天 | String | data.segmentList.refundFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | data.segmentList.refundFees | |
changeFees | 改签规则费用计算 | Array[] | data.segmentList | |
Interval | 区间 B 前 BE (含)前 A 后 AE (含)后 E 等于 | String | data.segmentList.changeFees | |
rcTime | 【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后, 如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | data.segmentList.changeFees | |
rcTimeTiming | 【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/ 不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于” | String | data.segmentList.changeFees | |
fee | 运算后的退改费用(元) | Number | data.segmentList.changeFees | |
baseFee | 运算基数 | Number | data.segmentList.changeFees | |
feePercent | 费用百分比 | Number | data.segmentList.changeFees | |
minimumFee | 保底费用(元) | Number | data.segmentList.changeFees | |
feeBaseType | 费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价 | Integer | data.segmentList.changeFees | |
timingCount | 计时数量 | Integer | data.segmentList.changeFees | |
timingUnit | 计时单位:H 小时、D 天 | String | data.segmentList.changeFees | |
isForbid |
是否不得退票/改期
添加日期: 2021-10-19 |
Boolean | data.segmentList.changeFees |
{
"data":
[{
"segmentList":
[{
"cabin":"1", //舱位等级(1/2/3/4)
"clazz":"V", //小舱位(如:Y/Z/...)
"clazzName":"经济舱", //舱位名称
"planeType":"波音737", //机型
"airlineCode":"MF", //销售航司编号(如:HU)
"segmentNo":1, //航段序号(从1开始)
"flightNumber":"MF8969", //销售航班号
"originName":"虹桥国际机场", //出发机场名称
"originCountryName":"中国", //出发地区或国家名称
"originCountryCode":"CN", //出发地区或国家二字码
"destinationName":"经济舱", //到达机场名称
"destinationCountryName":"中国", //到达地区或国家名称
"destinationCountryCode":"CN", //到达地区或国家二字码
"departureDate":"2023-10-23", //出发日期
"departureTime":"14:00", //出发时间
"arrivalDate":"2023-10-23", //到达日期
"arrivalTime":"16:30", //到达时间
"flyTime":"150", //飞行时间(分钟)
"carrier": "", //实际承运航班号(如果销售航班号是共享航班号,那么实际承运航班号才有值的)
"stopItem": "", //经停信息(格式:经停城市|到达时间|起飞时间)(如:上饶|2018-04-23 18:05|2018-04-23 18:55)
"originCityCode":"SHA", //出发机场编码
"destinationCityCode":"SZX", //到达机场编码
"origincityName":"上海", //出发城市名称
"destinationCityName":"深圳", //到达城市名称
"depTerminal":"T1", //出发航站楼
"arrTerminal":"T3", //到达航站楼(不详时传 --)
"airlineName":"厦门航空", //航司名称
"remark":"无", //备注
"ruleInfo":"退票规则:航班预计离站时间之前168小时(含)前,收取20 % 退票费.航班预计离站时间之前48小时(含)前,收取40 % 退票费.航班预计离站时间之前4小时(含)前,收取70 % 退票费.航班预计离站之前4小时(不含)后,收取90 % 退票费.
变更规则:航班预计离站时间之前168小时(含)前,收取10 % 改期费.航班预计离站时间之前48小时(含)前,收取30 % 改期费.航班预计离站时间之前4小时(含)前,收取50 % 改期费.航班预计离站之前4小时(不含)后,收取70 % 改期费.
签转规则:不允许
免费托运行李:每件20KG,每人1件,每件体积不超过40×60×100厘米。
免费手提行李:每件5KG,每人1件,每件体积不超过20×40×55厘米。
", //航班退改规则;
"amount":1100.00, //公布运价;(国际机票无公布运价)
"fAmount":5080.00, //头等舱标准价;(国际机票无头等舱标准价)
"cAmount":2030.00, //公务舱标准价;(国际机票无公务舱标准价)
"yAmount":2030.00, //经济舱标准价(国际机票无经济舱标准价)
"mileage":1324, //里程
"isProtocolPrice":1, //协议类型:0非协议票,1三方协议,2两方协议
"destinationCityNameEn":"BeiJing", //到达城市英文名 PM2024123 添加
"destinationNameEng":"BeiJing DaXing AirPort", //到达机场英文名 PM2024123 2024-04-25 添加
"origincityNameEn":"Amsterdam", //出发城市英文名 PM2024123 添加
"originNameEng":"Amsterdam AirPort", //出发机场英文名 PM2024123 2024-04-25 添加
"stopType":1, //有无经停 0无 1有
"stopCityName":"伦敦", //停留城市名称 PM2024123 添加
"stopCityNameEn":"London", //停留城市英文名 PM2024123 添加
"meal":"1", //有无餐食:0 无 1 有 PM2024123 2024-04-25 添加
"airlineNameEng":"China Southern Airlines", //航司英文名 PM2024123 添加
"JourneyIndex":"1", //行程序号 1-第一程;2-第二程;3-第三程
"refundFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //退票规则费用计算
"changeFees":
[{
"Interval":"B", //区间
B 前
BE (含)前
A 后
AE (含)后
E 等于
"rcTime":"2023-11-28", //【退票改签时间】:取值产品接口返回的“时间”+“区间”,格式:YYYY-MM-DD(含/不含)前/后,
如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"rcTimeTiming":"7天/小时", //【退票改签计时】:取值产品接口返回的“计时数量”+“计时单位”+“区间”,格式:7天/小时(含/
不含)前/后,如果“区间”的值是等于,那么给客户的值里不需要显示“等于”
"fee":4950.0, //运算后的退改费用(元)
"baseFee":1, //运算基数
"feePercent":0.5, //费用百分比
"minimumFee":300, //保底费用(元)
"feeBaseType":0, //费用计算基础类型 0=票面价 1=当前舱位公布运价 2=其他舱位公布运价
"timingCount":4, //计时数量
"timingUnit":"H", //计时单位:H 小时、D 天
"isForbid":false, //是否不得退票/改期
}], //改签规则费用计算
"ticketLuggageRule":
{
"checkRuleInfo": "", //托运行李规则内容(托运汇总内容)
"handRuleInfo": "", //手提行李规则内容(手提汇总内容)
"freeCheckCount":"1", //免费托运行李数量
"freeCheckUnit":"PC", //免费托运行李单位 KG=公斤 PC=件
"freeCheckLuggage":"1PC", //免费托运行李额(取值产品接口“免费托运行李数量”+“免费托运行李单位”)
"checkDescription":"1件", //托运行李说明
"freeHandCount": "", //免费手提行李数量
"freeHandUnit": "", //免费手提行李单位 KG=公斤 PC=件
"freeHandLuggage": "", //免费手提行李额(取值产品接口“免费手提行李数量”+“免费手提行李单位”)
"handDescription": "", //手提行李说明
}, //行李额
"refundRuleInfo": "", //退票规则内容
"changeRuleInfo": "", //改签规则内容
"transferRuleInfo": "", //签转规则内容
"segmentIndex":1, //航段序号(1开始,展示用)
"departureDiffHour":0, //出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
"arrivalDiffHour":0, //出发地时差 正负数值
2025-03-21之前下单的数据为空值 null
"originProvinceCN": "", //出发国家省州中文名
"originProvinceEN": "", //出发国家省州英文名
"originContinentCN": "", //出发机场所属大洲中文名
"originContinentEN": "", //出发机场所属大洲英文名
"destinationContinentCN": "", //到达机场所属大洲中文名
"destinationContinentEN": "", //到达机场所属大洲英文名
"departureTimeZone": "", //到达时区
"originTimeZone": "", //出发时区
"originCountryNameEN": "", //出发国家英文名称
"destinationCountryNameEN": "", //到达国家英文名称
"routeType": "", //航线类型,长航线-短航线 暂无实际数据
}], //航段信息
"priceList":
[{
"passengerType":"成人", //旅客类型
"ticketPrice":1100, //机票票面价格(改签时为升舱费)
"tax":50, //机场建设费;国际机票税费
"oilFee":130, //燃油附加费;国际机票无
"servicePrice":10, //服务费
"discount":80, //折扣(8.0折进值为80);国际机票无
"serviceCommission":0, //改签/退票手续费
"usedFlight":0, //已使用航段费
"orderSurcharge":0, //退票详情里的 单据附加费
"passengerCode":"P3510651", //旅客编号
"passengerName":"刘晓东", //旅客姓名
"staffCode":"EMP2110131EAJFM1I", //员工工号
"currency": "", //结算币种
"quotationCurrency":"CNY", //报价币种(预留,暂返回空)
"QuotationPrice":
{
"quotationTicketPrice":0, //机票票面价格(改签时为升舱费)
"quotationTax":0, //机场建设费
"quotationServicePrice":0, //服务费
"quotationServiceCommission":0, //改签/退票手续费
"quotationSellIticketChangefee":0, //国际改签单改签手续费
}, //国际机票,报价价格,多币种报价结算时才使用 暂无实际数据
}], //价格信息
"orderType":0, //订单类型
"status":0, //订单状态
"changeType":0, //变更/改签类型
0:未知
100:自愿
200:非自愿
"changeReason": "", //变更/改签原因
"totalTicketPrice":0, //票款总额
"totalServicePrice":0, //服务费总额
"deadLineTime":"2023/11/25 0:00:00", //价格有效期(改签单和退票单时,订单需在价格有效期内提交订单,过了有效期会提交订单失败)
"tripId": "", //行程编号
"companyId":"S117955", //公司编号
"failureReason": "", //订单失败原因
"oaOtherInfo":"zjm485215588", //其他信息,个性化客户需要(比如:中奖码)
"firstOrderNo":"TB2024000154", //美亚原购单号
"orderSource":3, //订单来源
"receivePayType":"月结", //支付方式
"affiliateBusinessName":"广东美亚商旅科技有限公司", //供应商
"pnr": "", //pnr
"passengerList":
[{
"reasonId":0, //差旅政策违反原因序号
"reasonRemark": "", //差旅政策违反原因
"errorMessage": "", //退票失败原因(订单为火车票时有值)
"returnStatus": "", //出票状况(订单为火车票时有值)
"seatNo": "", //座席号(订单为火车票时有值)
"originalTicketNo": "", //机票/火车票原票号(改签单时有值)
"belongToCenter":
[{
"centerNo":0, //序号
"centerTitle": "", //归属中心标题
"centerName": "", //归属成本中心选项值
}], //归属中心
"belongToProject": "", //归属项目
"travelPurpose": "", //出行目的
"passengerNo":1, //旅客排序号(从1开始递增)
"passengerCode":"P827827", //旅客编号
"passengerName":"张宇宇", //旅客姓名
"certificateType":"因公护照", //证件类型
"certificateId":"562233", //证件号码
"passengerType":"成人", //旅客类型(成人/儿童/婴儿)
"ticketNo":"2", //机票火车票票号或酒店房间编号(非实际入住房间号,只表示合住关系)
"staffCode":"WBDDH002", //员工工号
"mobile": "", //旅客手机号码
"email": "", //旅客邮箱,国际机票使用
"statusDesc": "", //客票状态描述
"ticketStatus": "", //票号状态 1:待使用、2:已使用、3:已经办理登记、4:已离港、5:已作废、6:已退票、7:换开、8:挂起、9:机场控制、10:机场控制、11:未查到
"depName":"0922部门/0922", //部门名称,用/分隔(列表返回最后一级,详细返回全级)
}], //旅客信息
"costList":
[{
"remark": "", //备注
"staffCode": "", //员工工号
"passengerCode":"P409149", //旅客编号
"passengerName":"陈军凤", //旅客名称
"costId":163939, //成本中心编号
"costCenterName":"董事会", //成本中心名称
"amount":240.00, //成本金额
}], //成本中心
"contactInfo":
{
"contactName":"张宇宇", //联系人姓名
"mobile":"15617929598", //手机号
"phone": "", //固定电话
"email":"St87875@meiya.com", //邮箱
}, //联系人信息
"policyList":
[{
"passengerCode":"P415090", //旅客编号
"staffCode":"董事会", //旅客编号
"passengerName":"WBDDH001", //旅客姓名
"policyName":"机票差旅政策一", //政策名称
"policyProperty":"强制", //属性(建议/强制)
"policyType":"基础", //基础/分类/个人/附加
}], //出差政策列表
"StaffPayExcess":false, //个人承担费用,=true 为存在个人承担,false
"PolicyExcessAmount":0.0, //StaffPayExcess=true 时需要关注,个人承担的金额,否则为 0;
"CompanyExcessAmount":818, //StaffPayExcess=true 时需要关注,公司承担的金额;
"c_TextField_2401": "", //客户自定义字段1
"c_TextField_2402": "", //客户自定义字段2
"c_TextField_2403": "", //客户自定义字段3
"c_TextField_2404": "", //客户自定义字段4
"c_TextField_2405": "", //客户自定义字段5
"c_TextField_2406": "", //客户自定义字段6
"c_TextField_2407": "", //客户自定义字段7
"c_TextField_2408": "", //客户自定义字段8
"totalPrice":818.00, //当前订单总金额
"opId": "", //制单人旅客编号
"onBusiness":0, //订单类型(1:因公;0:因私) 注意:如果因私订单不需要的,记得接收时过滤掉
"orderRemark":"订单备注", //订单备注
"outsideOrderNo":"jd20231011022", //客户订单号
"orderNo":"HB2300004135", //美亚订单号
"originalOrderNo": "", //美亚原订单号
"opStaffCode":"WBDDH001", //客户制单人工号
"opName":"张宇宇", //客户制单人
"opDate":"2023-10-20 11:24:26", //下单时间(yyyy-MM-dd HH:mm:ss)
"statusText":"处理成功", //订单状态(名称)
"issueDate":"zjm485215588", //出票日期(yyyy-MM-dd HH:mm:ss)
"oaSerialnumber":"SL58445577484", //客户出差申请单号
"stApplyOrderNo":"EC230005785", //美亚出差申请单号
}], //订单信息(如果有订退改,则list有多个订单)
"orderNo": "", //订购单号
"outsideOrderNo": "", //外部订单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
创建保险订购单
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
sessionId | sessionId,login接口返回 | String | 是 | |
Content | 保险订购单内容 | CreateInsuranceOrderContent | 否 | |
TicketNo | 机票票号 | String | Content | |
Mobile | 联系方式 | String | Content | |
InsuranceProductNo | 保险产品编号 | String | Content | |
InsuranceCount | 保险份数 | Integer | Content |
{
"Content":
{
"TicketNo": "", //机票票号
"Mobile": "", //联系方式
"InsuranceProductNo": "", //保险产品编号
"InsuranceCount":0, //保险份数
}, //保险订购单内容
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
InsuranceOrderNo | 保险单号 | String | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"InsuranceOrderNo": "", //保险单号
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
创建保险退保单
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
sessionId | sessionId,login接口返回 | String | 是 | |
Content | 保险退保单内容 | CreateInsuranceReturnContent | 否 | |
TicketNo | 机票票号 | String | Content | |
InsuranceOrderNo | 保险单号 | String | Content | |
InsuranceCount | 保险份数 | Integer | Content |
{
"Content":
{
"TicketNo": "", //机票票号
"InsuranceOrderNo": "", //保险单号
"InsuranceCount":0, //保险份数
}, //保险退保单内容
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String |
{
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}
调整单查询
请求参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | 是否必填 |
orderNo | 美亚订购单号 | String | 是 | |
sessionId | sessionId,login接口返回 | String | 是 |
{
"orderNo":"TB230004581", //美亚订购单号
"sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA", //sessionId,login接口返回
}
返回参数 | ||||
---|---|---|---|---|
参数名 | 备注 | 参数类型 | 父级 | |
orderType | 订单类型 | Integer | ||
adjustOrderType | 被调整订单类型 | Integer | ||
code | 返回代码,10000=成功,其他为错误 | String | ||
description | 执行结果描述 | String | ||
data | 订单信息 | ApiAdjustOrderPush | ||
originalOrderType | Integer | data | ||
c_TextField_2401 | 客户自定义字段1 | String | data | |
c_TextField_2402 | 客户自定义字段2 | String | data | |
c_TextField_2403 | 客户自定义字段3 | String | data | |
c_TextField_2404 | 客户自定义字段4 | String | data | |
c_TextField_2405 | 客户自定义字段5 | String | data | |
c_TextField_2406 | 客户自定义字段6 | String | data | |
c_TextField_2407 | 客户自定义字段7 | String | data | |
c_TextField_2408 | 客户自定义字段8 | String | data | |
totalPrice | 当前订单总金额 | Number | data | |
opId | 制单人旅客编号 | String | data | |
onBusiness | 订单类型(1:因公;0:因私) 注意:如果因私订单不需要的,记得接收时过滤掉 | Integer | data | |
orderRemark | 订单备注 | String | data | |
outsideOrderNo | 客户订单号 | String | data | |
orderNo | 美亚订单号 | String | data | |
originalOrderNo | 美亚原订单号 | String | data | |
opStaffCode | 客户制单人工号 | String | data | |
opName | 客户制单人 | String | data | |
opDate | 下单时间(yyyy-MM-dd HH:mm:ss) | String | data | |
statusText | 订单状态(名称) | String | data | |
issueDate | 出票日期(yyyy-MM-dd HH:mm:ss) | String | data | |
oaSerialnumber | 客户出差申请单号 | String | data | |
stApplyOrderNo | 美亚出差申请单号 | String | data | |
passengerList | Array[] | data | ||
passengerCode | 旅客编号 | String | data.passengerList | |
passengerName | 旅客姓名 | String | data.passengerList | |
passengerType | 旅客类型(成人/儿童/婴儿) | String | data.passengerList | |
staffCode | 员工工号 | String | data.passengerList | |
depName | 部门 | String | data.passengerList | |
costId | 成本中心编号 | String | data.passengerList | |
costCenterName | 成本中心名称 | String | data.passengerList | |
amount | 成本中心金额 | String | data.passengerList | |
perAmount | 调整金额合计 | Number | data.passengerList | |
priceList | Array[] | data | ||
passengerCode | 旅客编号 | String | data.priceList | |
passengerName | 旅客姓名 | String | data.priceList | |
passengerType | 旅客类型(成人/儿童/婴儿) | String | data.priceList | |
staffCode | 员工工号 | String | data.priceList | |
ticketPrice | 金额 | Number | data.priceList | |
servicePrice | 服务费 | Number | data.priceList | |
serviceCommission | 改签/退票手续费 | Number | data.priceList | |
tax | 机建费/税 | Number | data.priceList | |
oilFee | 机票-燃油费 | Number | data.priceList | |
surcharge | 机票-单据附加费 | Number | data.priceList | |
usedFlight | 机票-已使用航段费 | Number | data.priceList | |
changeReturnPrice | 火车票-改签差额退费 | Number | data.priceList | |
roomPrice | 酒店-房费 | Number | data.priceList | |
foodPrice | 酒店-餐费 | Number | data.priceList | |
bedPrice | 酒店-床费 | Number | data.priceList | |
rebatePrice | 酒店-返现 | Number | data.priceList |
{
"data":
{
"originalOrderType":0, //
"passengerList":
[{
"passengerCode": "", //旅客编号
"passengerName": "", //旅客姓名
"passengerType": "", //旅客类型(成人/儿童/婴儿)
"staffCode": "", //员工工号
"depName": "", //部门
"costId": "", //成本中心编号
"costCenterName": "", //成本中心名称
"amount": "", //成本中心金额
"perAmount":0, //调整金额合计
}], //
"priceList":
[{
"passengerCode": "", //旅客编号
"passengerName": "", //旅客姓名
"passengerType": "", //旅客类型(成人/儿童/婴儿)
"staffCode": "", //员工工号
"ticketPrice":0, //金额
"servicePrice":0, //服务费
"serviceCommission":0, //改签/退票手续费
"tax":0, //机建费/税
"oilFee":0, //机票-燃油费
"surcharge":0, //机票-单据附加费
"usedFlight":0, //机票-已使用航段费
"changeReturnPrice":0, //火车票-改签差额退费
"roomPrice":0, //酒店-房费
"foodPrice":0, //酒店-餐费
"bedPrice":0, //酒店-床费
"rebatePrice":0, //酒店-返现
}], //
"c_TextField_2401": "", //客户自定义字段1
"c_TextField_2402": "", //客户自定义字段2
"c_TextField_2403": "", //客户自定义字段3
"c_TextField_2404": "", //客户自定义字段4
"c_TextField_2405": "", //客户自定义字段5
"c_TextField_2406": "", //客户自定义字段6
"c_TextField_2407": "", //客户自定义字段7
"c_TextField_2408": "", //客户自定义字段8
"totalPrice":818.00, //当前订单总金额
"opId": "", //制单人旅客编号
"onBusiness":0, //订单类型(1:因公;0:因私) 注意:如果因私订单不需要的,记得接收时过滤掉
"orderRemark":"订单备注", //订单备注
"outsideOrderNo":"jd20231011022", //客户订单号
"orderNo":"HB2300004135", //美亚订单号
"originalOrderNo": "", //美亚原订单号
"opStaffCode":"WBDDH001", //客户制单人工号
"opName":"张宇宇", //客户制单人
"opDate":"2023-10-20 11:24:26", //下单时间(yyyy-MM-dd HH:mm:ss)
"statusText":"处理成功", //订单状态(名称)
"issueDate":"zjm485215588", //出票日期(yyyy-MM-dd HH:mm:ss)
"oaSerialnumber":"SL58445577484", //客户出差申请单号
"stApplyOrderNo":"EC230005785", //美亚出差申请单号
}, //订单信息
"orderType":0, //订单类型
"adjustOrderType":0, //被调整订单类型
"code":"10000", //返回代码,10000=成功,其他为错误
"description":"请求成功", //执行结果描述
}