api接口文档简要说明

测试环境接口调用域名为:http://testapi.shinetour.com

接口在不改变原数据结构、字段属性前提下,可能会添加新字段,请做好兼容

版本更新说明:

模块 位置 类型 描述 更新时间
全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.对接流程参考
查阅对接流程

登陆接口: http://testapi.shinetour.com/API.svc/Login

接口描述:

平台访问凭证登录信息,接口通行证sessiondid获取


登陆文档各参数深入解释:登陆文档说明

验证自己加密的Password:Password验证


 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询城市公告: http://testapi.shinetour.com/API.svc/QueryNoticeInfoList

接口描述:

查询平台重要公告通知和航班相关信息通知



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

获取跳转地址: http://testapi.shinetour.com/API.svc/GetUrl

接口描述:

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 获取跳转地址: http://testapi.shinetour.com/API.svc/GetUrlH5

接口描述:

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&parameters=",    //跳转Url,可以直接打开
  "code":"10000",    //返回代码,10000=成功,其他为错误
  "description":"请求成功",    //执行结果描述
}

订单支付、确认支付有效性: http://testapi.shinetour.com/API.svc/OrderPay

接口描述:

线上支付,通过支付流水进行确认成功与否



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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&parameters=",    //跳转Url,可以直接打开,用于在线支付
  "code":"10000",    //返回代码,10000=成功,其他为错误
  "description":"请求成功",    //执行结果描述
}

机票酒店火车票订单处理(取消和出票): http://testapi.shinetour.com/API.svc/OrderHandling

接口描述:

订单取消和出票处理,所有订单的取消和出票



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

同步差旅政策: http://testapi.shinetour.com/API.svc/SyncPolicyInfo

接口描述:

客户平台差旅政策同步到美亚系统差旅政策



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

同步旅客: http://testapi.shinetour.com/API.svc/SyncPsgInfo

接口描述:

同步旅客信息(旧版),无法返回部分成功部分失败情况,建议使用: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  
        email 电子邮箱 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":"请求成功",    //执行结果描述
}

同步旅客(新): http://testapi.shinetour.com/API.svc/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  
        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  
        email 电子邮箱 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":"请求成功",    //执行结果描述
}

查询订单状态: http://testapi.shinetour.com/API.svc/GetOrderStatus

接口描述:

根据订单号查询订单状态



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

获取角色列表: http://testapi.shinetour.com/API.svc/GetRoleList

接口描述:

旧接口,目前无使用场景



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

系统配置信息: http://testapi.shinetour.com/API.svc/GetSysDictionary

接口描述:

旧接口,目前无使用场景



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
type 字典类型 String
sessionId sessionId,login接口返回 String

请求参数示例:

{
  "type": "",    //字典类型
  "sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA",    //sessionId,login接口返回
}

 

返回参数:

返回参数
参数名 备注 参数类型 父级  
dictionaryList 返回结果 Array[]  
code 返回代码,10000=成功,其他为错误 String  
description 执行结果描述 String  

返回参数示例:

{
  "dictionaryList":
    [{
    }],    //返回结果
  "code":"10000",    //返回代码,10000=成功,其他为错误
  "description":"请求成功",    //执行结果描述
}

同步审批人: http://testapi.shinetour.com/API.svc/SyncApprovalInfo

接口描述:

同步审批人信息,支持按旅客审批 或 按成本中心审批,按旅客审批示范: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":"请求成功",    //执行结果描述
}

同步成本中心: http://testapi.shinetour.com/API.svc/SyncCostCenter

接口描述:

批量同步成本中心,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":"请求成功",    //执行结果描述
}

公司的部门列表: http://testapi.shinetour.com/API.svc/GetDepartmentList

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

获取城市列表: http://testapi.shinetour.com/API.svc/GetCityList

接口描述:

根据产品类型,获取对应的基础城市数据,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":"请求成功",    //执行结果描述
}

航变动态查询: http://testapi.shinetour.com/API.svc/GetFlightChangeNotice

接口描述:

航变动态查询



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

保存出差申请单: http://testapi.shinetour.com/API.svc/SaveBusinessApplication

接口描述:

同步出差单,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  
    email 电子邮箱 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  
    email 电子邮箱 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  
        email 电子邮箱 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":"请求成功",    //执行结果描述
}

同步取消/废弃出差申请单: http://testapi.shinetour.com/API.svc/ChangeBusinessApplicationStatus

接口描述:

同步取消/废弃出差申请单,出差单号必须美亚出差单号



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

获取行政区域数据接口: http://testapi.shinetour.com/API.svc/GetCityAreaList

接口描述:

出差单对接,获取区域城市基础数据,用于订机票、酒店锚点城市更精准



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

同步美亚订单状态接口: http://testapi.shinetour.com/API.svc/UpdateOrderSignStatus

接口描述:

历史接口,目前无场景使用



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

订单关联: http://testapi.shinetour.com/API.svc/RelevanceOrder

接口描述:

历史接口,目前无场景使用



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询出差申请单列表: http://testapi.shinetour.com/API.svc/GetApplyOrderList

接口描述:

根据出差单号查询详细出差单信息



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

出差政策运算: http://testapi.shinetour.com/API.svc/CheckPolicy

接口描述:

历史接口,目前无场景使用



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮箱 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  
    email 电子邮箱 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  
        email 电子邮箱 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":"请求成功",    //执行结果描述
}

新根据客户订单号查询: http://testapi.shinetour.com/API.svc/GetOrderInfoByOutsideOrderNo

接口描述:

新根据客户订单号或者美亚订单号查询所有美亚关联的订单信息,也可以理解为根据客户出差单信息查询所有预订的订单信息



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

绑定出差单和订单: http://testapi.shinetour.com/API.svc/RelevanceOrderNoAndApplyOrderNo

接口描述:

该接口绑定线下预订的订单和客户系统出差单的关系,只对线下无出差单号的订单有绑定效果,对使用美亚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":"请求成功",    //执行结果描述
}

查询航班信息: http://testapi.shinetour.com/API.svc/QueryFlights

接口描述:

查询航班信息



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

退改规则(客规)查询: http://testapi.shinetour.com/API.svc/QueryTicketRule

接口描述:

国内机票退改规则,行李额查询



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询航班详细舱位价格: http://testapi.shinetour.com/API.svc/GetMoreFlights

接口描述:

查询国内机票航班价格



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询经停: http://testapi.shinetour.com/API.svc/GetStopItems

接口描述:

根据航班,查询经停信息



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询机型信息: http://testapi.shinetour.com/API.svc/QueryPlaneType

接口描述:

国内机票机型信息



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

预订前验舱验价: http://testapi.shinetour.com/API.svc/CheckFlightPirceBeforeOrder

接口描述:

预订前验舱验价



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

创建订购单: http://testapi.shinetour.com/API.svc/CreateOrder

接口描述:

国内机票创建订单



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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  
    email 电子邮箱 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":"请求成功",    //执行结果描述
}

国内机票价格校验: http://testapi.shinetour.com/API.svc/CheckPrice

接口描述:

国内机票价格校验



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

订购单取消: http://testapi.shinetour.com/API.svc/CancelOrder

接口描述:

国内机票取消订单



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

订购单提交审批: http://testapi.shinetour.com/API.svc/SubmitOrder

接口描述:

国内机票提交审批



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询订单列表(新): http://testapi.shinetour.com/API.svc/GetFlightOrderList

接口描述:

国内机票订单列表,最新版本,新对接客户使用该接口,勿使用旧版本



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 旅客邮箱,国际机票使用 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":"请求成功",    //执行结果描述
}

查询订单详情(新): http://testapi.shinetour.com/API.svc/GetFlightOrderDetail

接口描述:

国内机票订单详细(新),最新版本,新对接客户使用该接口,勿使用旧版本



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 邮箱 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  
        email 旅客邮箱,国际机票使用 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":"请求成功",    //执行结果描述
}

查询可改期航线: http://testapi.shinetour.com/API.svc/QueryChangeAirway

接口描述:

根据传入订单,查询可改签的航线



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

改签航班查询: http://testapi.shinetour.com/API.svc/QueryChangeFlights

接口描述:

根据传入订单,查询该订单可改签的航班



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

线上获取改签单费用(新): http://testapi.shinetour.com/API.svc/GetPriceChangeOrder

接口描述:

线上获取改签单费用



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

退改初始化接口: http://testapi.shinetour.com/API.svc/ChangeRefundInit

接口描述:

退改初始化接口



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

创建改签单(新): http://testapi.shinetour.com/API.svc/CreateChangeOrderDomestic

接口描述:

国内机票创建改签(新)



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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":"请求成功",    //执行结果描述
}

改签验价: http://testapi.shinetour.com/API.svc/ChangeCheckPrice

接口描述:

改签验价



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

改签单取消: http://testapi.shinetour.com/API.svc/CancelChangeOrder

接口描述:

国内机票取消改签单



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

提交审批改签单: http://testapi.shinetour.com/API.svc/SubmitChangeOrder

接口描述:

国内机票提交改签审批



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
orderNo 美亚订单号,共用的实体,订单号展示只做示例 String
sessionId sessionId,login接口返回 String

请求参数示例:

{
  "orderNo":"TB2301739858",    //美亚订单号,共用的实体,订单号展示只做示例
  "sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA",    //sessionId,login接口返回
}

 

返回参数:

返回参数
参数名 备注 参数类型 父级  
code 返回代码,10000=成功,其他为错误 String  
description 执行结果描述 String  

返回参数示例:

{
  "code":"10000",    //返回代码,10000=成功,其他为错误
  "description":"请求成功",    //执行结果描述
}

创建退票单: http://testapi.shinetour.com/API.svc/CreateReturnOrderDomestic

接口描述:

创建退票单


国际机票退票参考:

国际机票退票流程


 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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":"请求成功",    //执行结果描述
}

退票验价: http://testapi.shinetour.com/API.svc/RefundVerify

接口描述:

退票验价



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

取消退票单: http://testapi.shinetour.com/API.svc/CancelReturnOrder

接口描述:

国内机票取消退票单



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

提交审批退票单: http://testapi.shinetour.com/API.svc/SubmitReturnOrder

接口描述:

国内机票提交退票审批



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
orderNo 美亚订单号,共用的实体,订单号展示只做示例 String
sessionId sessionId,login接口返回 String

请求参数示例:

{
  "orderNo":"TB2301739858",    //美亚订单号,共用的实体,订单号展示只做示例
  "sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA",    //sessionId,login接口返回
}

 

返回参数:

返回参数
参数名 备注 参数类型 父级  
code 返回代码,10000=成功,其他为错误 String  
description 执行结果描述 String  

返回参数示例:

{
  "code":"10000",    //返回代码,10000=成功,其他为错误
  "description":"请求成功",    //执行结果描述
}

国内国际机票客票状态: http://testapi.shinetour.com/API.svc/GetTicketStatus

接口描述:

国内机票查询客票状态



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

国内国际机票客票状态-分页: http://testapi.shinetour.com/API.svc/GetTicketStatusList

接口描述:

分页查询客票状态



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

国际城市列表: http://testapi.shinetour.com/API.svc/GetICityList

接口描述:

国际城市列表



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询航班信息(测试30天后的): http://testapi.shinetour.com/API.svc/IFlightQuery

接口描述:

查询航班信息,默认返回航班最低价,测试请查询当前日期30天后的航班


国际机票订购流程参考:

国际机票订购流程


 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

机票查询更多价格(测试30天后的): http://testapi.shinetour.com/API.svc/IFlightQueryMore

接口描述:

机票查询当前已选航班的舱位和价格详细信息



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

获取航班详细信息: http://testapi.shinetour.com/API.svc/GetFlightDetailDto

接口描述:

获取航班详细信息



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

预订前计价: http://testapi.shinetour.com/API.svc/IFlightCheckPirceBeforeOrder

接口描述:

预订前核对价格



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询退改规则,行李额: http://testapi.shinetour.com/API.svc/QueryAirRules

接口描述:

查询已选航班退改规则和行李额



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询经停: http://testapi.shinetour.com/API.svc/IFlightGetStopItems

接口描述:

查询已选航班的经停信息



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

创建订单: http://testapi.shinetour.com/API.svc/IFlightCreateOrder

接口描述:

创建国际机票订单



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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  
    email 电子邮箱 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  
    email 电子邮箱 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":"请求成功",    //执行结果描述
}

校验价格: http://testapi.shinetour.com/API.svc/CheckOrConfirmPrice

接口描述:

出票前校验价格



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

改签问询: http://testapi.shinetour.com/API.svc/ChangeInquiry

接口描述:

改签问询,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":"请求成功",    //执行结果描述
}

国际机票改签航班查询: http://testapi.shinetour.com/API.svc/QueryIntairTicketChangeFlight

接口描述:

国际机票改签航班查询



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功"
}

国际机票获取改签条款: http://testapi.shinetour.com/API.svc/QueryIntairTicketChangeRule

接口描述:

国际机票获取改签条款



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功"
}

国际机票改签验价: http://testapi.shinetour.com/API.svc/IntairTicketChangePricing

接口描述:

国际机票改签验价



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功"
}

创建改签单: http://testapi.shinetour.com/API.svc/CreateIFlightChangeOrder

接口描述:

创建改签单


国际机票改签流程参考:

国际机票改签流程


 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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":"请求成功",    //执行结果描述
}

退票问询: http://testapi.shinetour.com/API.svc/RefundInquiry

接口描述:

退票问询,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":"请求成功",    //执行结果描述
}

获取退票费: http://testapi.shinetour.com/API.svc/QueryIntairTicketRefundFee

接口描述:

获取退票费



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

创建退票单: http://testapi.shinetour.com/API.svc/CreateIFlightReturnOrder

接口描述:

创建退票单


国际机票退票参考:

国际机票退票流程


 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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":"请求成功",    //执行结果描述
}

取消订单,订退改都适用: http://testapi.shinetour.com/API.svc/IFlightCancelOrder

接口描述:

根据订单号进行取消,取消订单,订退改都适用



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

提交出票,订退改都适用: http://testapi.shinetour.com/API.svc/IFlightSubmitOrder

接口描述:

根据订单号进行取消,提交出票,订退改都适用



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

订单详细,订退改都适用: http://testapi.shinetour.com/API.svc/GetInternationFlightOrderDetail

接口描述:

根据订单号查询国际机票订单详细(新)



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 邮箱 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  
        email 旅客邮箱,国际机票使用 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":"请求成功",    //执行结果描述
}

订单列表,订退改都适用: http://testapi.shinetour.com/API.svc/GetInternationFlightOrderList

接口描述:

根据条件查询国际机票订单列表,订退改都适用



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 旅客邮箱,国际机票使用 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":"请求成功",    //执行结果描述
}

国际机票航变动态: http://testapi.shinetour.com/API.svc/GetIFlightChangeNotice

接口描述:

国际机票航变动态



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询航班信息(加密验证方式): http://testapi.shinetour.com/apis/intairticket/queryflights

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

退改规则(加密验证方式): http://testapi.shinetour.com/apis/intairticket/queryairrules

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询经停(加密验证方式): http://testapi.shinetour.com/apis/intairticket/querystopitems

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

创建询价单: http://testapi.shinetour.com/API.svc/CreateAskPriceOrder

接口描述:

创建询价单,根据出行需求,询价国际机票


询价单流程参考:

询价单流程


 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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  
    email 电子邮箱 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":"请求成功",    //执行结果描述
}

取消询价单: http://testapi.shinetour.com/API.svc/CancelAskPriceOrder

接口描述:

预订前取消询价单,预订后不可取消



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

更新询价单单: http://testapi.shinetour.com/API.svc/UpdateAskPriceOrder

接口描述:

更新询价单信息



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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  
    email 电子邮箱 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":"请求成功",    //执行结果描述
}

重新报价: http://testapi.shinetour.com/API.svc/ReAskPrice

接口描述:

对报价方案重新报价



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

确认报价: http://testapi.shinetour.com/API.svc/ConfirmAskPriceSolution

接口描述:

确认报价方案



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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  
    email 电子邮箱 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":"请求成功",    //执行结果描述
}

取消解决方案订单: http://testapi.shinetour.com/API.svc/CancelAskPriceSolution

接口描述:

取消解决方案订单



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
solutionNo 解决方案编号 String
sessionId sessionId,login接口返回 String

请求参数示例:

{
  "solutionNo":"QU2300003415-1",    //解决方案编号
  "sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA",    //sessionId,login接口返回
}

 

返回参数:

返回参数
参数名 备注 参数类型 父级  
code 返回代码,10000=成功,其他为错误 String  
description 执行结果描述 String  

返回参数示例:

{
  "code":"10000",    //返回代码,10000=成功,其他为错误
  "description":"请求成功",    //执行结果描述
}

查询询价单 请求: http://testapi.shinetour.com/API.svc/QueryAskPriceOrder

接口描述:

查询询价单详细信息



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 邮箱 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  
        email 邮箱 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":"请求成功",    //执行结果描述
}

城市查询: http://testapi.shinetour.com/API.svc/GetHCityList

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

房态价格校验: http://testapi.shinetour.com/API.svc/CheckHotelStatusAndPrice

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

是否需要担保: http://testapi.shinetour.com/API.svc/CheckIsNeedVouch

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

担保信用卡验证: http://testapi.shinetour.com/API.svc/CheckCreditStatus

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

国内酒店担保规则: http://testapi.shinetour.com/API.svc/GetVouchDomestic

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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": "",    //最晚取消变更时间  :担保订单可取消的时间,如果返回的时间小于当前时间,则代表此订单不可变更取消
}

酒店信息查询: http://testapi.shinetour.com/API.svc/QueryHotels

接口描述:


国内酒店流程参考:

国内酒店流程


 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

酒店价格详情信息: http://testapi.shinetour.com/API.svc/GetHotelDetail

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

创建订购单: http://testapi.shinetour.com/API.svc/CreateHotelOrder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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  
    email 电子邮箱 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":"请求成功",    //执行结果描述
}

酒店订购单提交审批: http://testapi.shinetour.com/API.svc/SubmitHotelOrder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
OrderNo 订单号 String
sessionId sessionId,login接口返回 String

请求参数示例:

{
  "OrderNo": "",    //订单号
  "sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA",    //sessionId,login接口返回
}

 

返回参数:

返回参数
参数名 备注 参数类型 父级  
code 返回代码,10000=成功,其他为错误 String  
description 执行结果描述 String  

返回参数示例:

{
  "code":"10000",    //返回代码,10000=成功,其他为错误
  "description":"请求成功",    //执行结果描述
}

取消订单: http://testapi.shinetour.com/API.svc/CancelHotelOrder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
OrderNo 美亚订购单号 String
sessionId sessionId,login接口返回 String

请求参数示例:

{
  "OrderNo": "",    //美亚订购单号
  "sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA",    //sessionId,login接口返回
}

 

返回参数:

返回参数
参数名 备注 参数类型 父级  
code 返回代码,10000=成功,其他为错误 String  
description 执行结果描述 String  

返回参数示例:

{
  "code":"10000",    //返回代码,10000=成功,其他为错误
  "description":"请求成功",    //执行结果描述
}

订单列表查询: http://testapi.shinetour.com/API.svc/QueryHotelOrderList

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 电子邮件 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":"请求成功",    //执行结果描述
}

订单详情: http://testapi.shinetour.com/API.svc/QueryHotelOrderInfo

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 电子邮件 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":"请求成功",    //执行结果描述
}

创建酒店退单: http://testapi.shinetour.com/API.svc/CreateHotelReturnOrder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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":"请求成功",    //执行结果描述
}

取消酒店退房单: http://testapi.shinetour.com/API.svc/CancelReturnHotelOrder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
OrderNo 美亚订购单号 String
sessionId sessionId,login接口返回 String

请求参数示例:

{
  "OrderNo": "",    //美亚订购单号
  "sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA",    //sessionId,login接口返回
}

 

返回参数:

返回参数
参数名 备注 参数类型 父级  
code 返回代码,10000=成功,其他为错误 String  
description 执行结果描述 String  

返回参数示例:

{
  "code":"10000",    //返回代码,10000=成功,其他为错误
  "description":"请求成功",    //执行结果描述
}

查询退房列表: http://testapi.shinetour.com/API.svc/QueryHotelReturnOrderList

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询退房详细: http://testapi.shinetour.com/API.svc/QueryHotelReturnOrderInfo

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

国际酒店城市信息: http://testapi.shinetour.com/apis/intairhotel/querycityinfo

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

酒店列表: http://testapi.shinetour.com/apis/intairhotel/queryhotellist

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

酒店详细: http://testapi.shinetour.com/apis/intairhotel/queryhoteldetail

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 邮箱 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  
    email 邮箱 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":"请求成功",    //执行结果描述
}

获取列表 酒店房型和实时价格: http://testapi.shinetour.com/apis/intairhotel/queryroomprice

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

可预订检查: http://testapi.shinetour.com/apis/intairhotel/bookingcheck

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

国际酒店创建订单: http://testapi.shinetour.com/apis/intairhotel/createintairhotelorder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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  
    email 电子邮箱 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":"请求成功",    //执行结果描述
}

酒店订单列表: http://testapi.shinetour.com/apis/intairhotel/queryintairhotelorderlist

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

酒店订单详细: http://testapi.shinetour.com/apis/intairhotel/queryintairhotelorderdetail

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 邮箱 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  
        email 旅客邮箱,国际机票使用 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":"请求成功",    //执行结果描述
}

提交订单: http://testapi.shinetour.com/apis/intairhotel/submithotelorder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
orderNo 美亚订单号,共用的实体,订单号展示只做示例 String
sessionId sessionId,login接口返回 String

请求参数示例:

{
  "orderNo":"TB2301739858",    //美亚订单号,共用的实体,订单号展示只做示例
  "sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA",    //sessionId,login接口返回
}

 

返回参数:

返回参数
参数名 备注 参数类型 父级  
code 返回代码,10000=成功,其他为错误 String  
description 执行结果描述 String  

返回参数示例:

{
  "code":"10000",    //返回代码,10000=成功,其他为错误
  "description":"请求成功",    //执行结果描述
}

国际酒店取消订单: http://testapi.shinetour.com/apis/intairhotel/cancelhotelorder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

创建酒店退房单: http://testapi.shinetour.com/apis/intairhotel/createhotelreturnorder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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":"请求成功",    //执行结果描述
}

火车票登陆: http://testapi.shinetour.com/apis/train/trainlogin

接口描述:


火车票订购流程参考:

火车票订购流程


 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

国内火车站列表: http://testapi.shinetour.com/apis/train/querystationlist

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

车次查询: http://testapi.shinetour.com/apis/train/querytrains

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

经停: http://testapi.shinetour.com/apis/train/querytrainpassing

接口描述:

无调用日志数据,不做初始数据填充



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

常用联系人: http://testapi.shinetour.com/apis/train/querypassenger

接口描述:

常用联系人查询



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 邮件 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":"请求成功",    //执行结果描述
}

单车次查询: http://testapi.shinetour.com/apis/train/querytrainno

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

供应商手续费: http://testapi.shinetour.com/apis/train/qureytrainhandlingfee

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

火车票订单提交(占座申请): http://testapi.shinetour.com/apis/train/createtrainorder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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  
    email 电子邮箱 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":"请求成功",    //执行结果描述
}

取消订购单接口: http://testapi.shinetour.com/apis/train/canceltrainorder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

提交出票: http://testapi.shinetour.com/apis/train/submittrainorder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
orderNo 美亚订单号,共用的实体,订单号展示只做示例 String
sessionId sessionId,login接口返回 String

请求参数示例:

{
  "orderNo":"TB2301739858",    //美亚订单号,共用的实体,订单号展示只做示例
  "sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA",    //sessionId,login接口返回
}

 

返回参数:

返回参数
参数名 备注 参数类型 父级  
code 返回代码,10000=成功,其他为错误 String  
description 执行结果描述 String  

返回参数示例:

{
  "code":"10000",    //返回代码,10000=成功,其他为错误
  "description":"请求成功",    //执行结果描述
}

火车票订单列表: http://testapi.shinetour.com/apis/train/querytrainorderlist

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 旅客邮箱,国际机票使用 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":"请求成功",    //执行结果描述
}

火车票订单详细接口: http://testapi.shinetour.com/apis/train/querytrainorderinfo

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 邮箱 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  
        email 旅客邮箱,国际机票使用 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":"请求成功",    //执行结果描述
}

申请退票: http://testapi.shinetour.com/apis/train/returntrainorder

接口描述:


火车票退票流程参考:

火车票退票流程


 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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":"请求成功",    //执行结果描述
}

退票单取消接口: http://testapi.shinetour.com/apis/train/canceltrainreturnorder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

确认退票: http://testapi.shinetour.com/apis/train/submitrefundtrainorder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
orderNo 美亚订单号,共用的实体,订单号展示只做示例 String
sessionId sessionId,login接口返回 String

请求参数示例:

{
  "orderNo":"TB2301739858",    //美亚订单号,共用的实体,订单号展示只做示例
  "sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA",    //sessionId,login接口返回
}

 

返回参数:

返回参数
参数名 备注 参数类型 父级  
code 返回代码,10000=成功,其他为错误 String  
description 执行结果描述 String  

返回参数示例:

{
  "code":"10000",    //返回代码,10000=成功,其他为错误
  "description":"请求成功",    //执行结果描述
}

申请改签(占座申请): http://testapi.shinetour.com/apis/train/changetrainorder

接口描述:


火车票改签流程参考:

火车票改签流程


 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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":"请求成功",    //执行结果描述
}

确认改签: http://testapi.shinetour.com/apis/train/submitchangetrainorder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
orderNo 美亚订单号,共用的实体,订单号展示只做示例 String
sessionId sessionId,login接口返回 String

请求参数示例:

{
  "orderNo":"TB2301739858",    //美亚订单号,共用的实体,订单号展示只做示例
  "sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA",    //sessionId,login接口返回
}

 

返回参数:

返回参数
参数名 备注 参数类型 父级  
code 返回代码,10000=成功,其他为错误 String  
description 执行结果描述 String  

返回参数示例:

{
  "code":"10000",    //返回代码,10000=成功,其他为错误
  "description":"请求成功",    //执行结果描述
}

取消改签: http://testapi.shinetour.com/apis/train/cancelchangetrainorder

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

改签费用查询(开发中): http://testapi.shinetour.com/apis/train/QueryChangeTrainPrice

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

用车订单列表: http://testapi.shinetour.com/API.svc/QueryCarOrderList

接口描述:

用车订单列表



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 邮箱 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":"请求成功",    //执行结果描述
}

国内/国际酒店账单--标准: http://testapi.shinetour.com/API.svc/QueryHotelOrderSettle

接口描述:

酒店账单查询



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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
}

国内机票账单--标准: http://testapi.shinetour.com/API.svc/QueryTicketOrderSettle

接口描述:

国内机票账单查询



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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
}

国际机票账单--标准: http://testapi.shinetour.com/API.svc/QueryIntairTicketOrderSettle

接口描述:

国际机票账单查询



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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
}

火车票账单--标准: http://testapi.shinetour.com/API.svc/QueryTrainOrderSettle

接口描述:

火车票账单查询



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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
}

结算信息汇总(按产品类型汇总): http://testapi.shinetour.com/API.svc/QuerySettleSumList

接口描述:

结算信息汇总接口(按产品类型汇总)



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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
}

分页获取账单结算影像资料列表: http://testapi.shinetour.com/API.svc/SelectBillSettleImageList

接口描述:

分页获取账单结算影像资料列表



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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
}

用车账单: http://testapi.shinetour.com/API.svc/QueryUCSettleInfoList

接口描述:

分页获取账单结算影像资料列表



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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
}

确认账单并申请开票: http://testapi.shinetour.com/API.svc/ConfirmBillApplyInvoicing

接口描述:

线上确认账单,申请开票据



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 邮箱* 用于接收发票 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
}

确认账单: http://testapi.shinetour.com/API.svc/ConfirmBillInfo

接口描述:

确认账单



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
settleSerialNos 结算批次号 Array[]
sessionId sessionId,login接口返回 String

请求参数示例:

{
  "settleSerialNos":[],    
  "sessionId":"181290f79eab44fd90a1ee6145264ffd202310110937265250OA"
}

 

返回参数:

返回参数
参数名 备注 参数类型 父级  
code 返回代码,10000=成功,其他为错误 String  
description 执行结果描述 String  

返回参数示例:

{
  "code":"10000",    
  "description":"请求成功"
}

确认消费记录(账单): http://testapi.shinetour.com/API.svc/ConfirmBillRecord

接口描述:

确认消费记录(账单)



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功"
}

申请发票: http://testapi.shinetour.com/API.svc/ApplyInvoice

接口描述:

申请发票



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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
email 邮箱 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":"请求成功"
}

查询发票详细: http://testapi.shinetour.com/API.svc/QueryInvoiceDetail

接口描述:

查询发票详细



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 邮箱 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":"请求成功"
}

国内机票电子行程单 开具申请: http://testapi.shinetour.com/API.svc/CreateItinerary

接口描述:

国内机票电子行程单 开具申请



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

国内机票电子行程单 作废申请: http://testapi.shinetour.com/API.svc/CancelItinerary

接口描述:

国内机票电子行程单 作废申请



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询国内机票行程单开具/作废结果: http://testapi.shinetour.com/API.svc/QueryItineraryFile

接口描述:

查询国内机票行程单 开具/作废结果



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询授权电子行程单开具结果: http://testapi.shinetour.com/API.svc/QueryItineraryIssueResult

接口描述:

查询电子行程单开具结果(开发中)



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

石化 行程单开具作废换开: http://testapi.shinetour.com/API.svc/SinopecCreateItinerary

接口描述:

行程单开具作废换开(石化)



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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": "",    //描述信息
}

线上创建改签单,含改签费用(新): http://testapi.shinetour.com/API.svc/CreateOnlineChangeOrder

接口描述:

线上创建改签单(含改签费用)



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

线上改签,提交处理接口(新): http://testapi.shinetour.com/API.svc/SubmitOnlineChangeOrder

接口描述:

线上退票创建退票单



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

查询订单详情: http://testapi.shinetour.com/API.svc/GetOrderInfo

接口描述:

国内机票获取订单详情



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 电子邮件 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":"请求成功",    //执行结果描述
}

查询退票单详情: http://testapi.shinetour.com/API.svc/GetReturnOrderInfo

接口描述:

国内机票查询退票单详情



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 电子邮件 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":"请求成功",    //执行结果描述
}

查询退票单列表: http://testapi.shinetour.com/API.svc/GetReturnOrderList

接口描述:

国内机票退票单列表查询



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 电子邮件 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":"请求成功",    //执行结果描述
}

查询改签单详情: http://testapi.shinetour.com/API.svc/GetChangeOrderInfo

接口描述:

国内机票查询改签单详情



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 电子邮件 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":"请求成功",    //执行结果描述
}

改签单列表查询: http://testapi.shinetour.com/API.svc/GetChangeOrderList

接口描述:

国内机票改签单列表查询



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 电子邮件 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":"请求成功",    //执行结果描述
}

创建退票单: http://testapi.shinetour.com/API.svc/CreateReturnOrder

接口描述:

国内机票创建退票单


国际机票退票参考:

国际机票退票流程


 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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":"请求成功",    //执行结果描述
}

改签单创建退票单: http://testapi.shinetour.com/API.svc/CreateReturnOrderForTC

接口描述:

国内机票改签单创建退票单



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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":"请求成功",    //执行结果描述
}

创建改签单: http://testapi.shinetour.com/API.svc/CreateChangeOrder

接口描述:

国内机票创建改签单


国际机票改签流程参考:

国际机票改签流程


 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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":"请求成功",    //执行结果描述
}

查询订单列表: http://testapi.shinetour.com/API.svc/GetOrderList

接口描述:

国内机票订单列表



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 电子邮件 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":"请求成功",    //执行结果描述
}

火车票订购单列表查询: http://testapi.shinetour.com/API.svc/QueryTrainOrderList

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 电子邮件 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":"请求成功",    //执行结果描述
}

查询退票单列表: http://testapi.shinetour.com/API.svc/QueryTrainReturnOrderList

接口描述:



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 电子邮件 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":"请求成功",    //执行结果描述
}

公告信息通知: http://testapi.shinetour.com/API.svc/GetOutbreakNotices

接口描述:

查询相关公告信息通知



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

南网国内机票创建订单: http://testapi.shinetour.com/API.svc/NWCreateOrder

接口描述:

南网创建订单



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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  
    email 电子邮箱 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":"请求成功",    //执行结果描述
}

南网国内机票改签航班查询: http://testapi.shinetour.com/API.svc/NWQueryChangeFlights

接口描述:

根据初始订单,查询可改签航班航班信息



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

南网专用,线上获取改签费用: http://testapi.shinetour.com/API.svc/NWGetPriceChangeOrder

接口描述:

南网获取改签价格,根据初始订单查询改签单价格



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

南网专用,线上获取退票费用: http://testapi.shinetour.com/API.svc/NWChangeRefundInit

接口描述:

南网初始化退票单接口,根据初始订单查询目前已出票订单是否可退改



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

南网专用,国内机票改签单(新): http://testapi.shinetour.com/API.svc/NWCreateChangeOrderDomestic

接口描述:

南网创建改签单接口,根据初始订单操作目前出票的订单改签



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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":"请求成功",    //执行结果描述
}

南网专用,国内机票退票: http://testapi.shinetour.com/API.svc/NWCreateReturnOrderDomestic

接口描述:

南网创建退票单接口,根据初始订单操作目前出票的订单退票



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
    email 电子邮件 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":"请求成功",    //执行结果描述
}

南网专用,国内机票提交和取消: http://testapi.shinetour.com/API.svc/NWOrderHandling

接口描述:

南网订单提交和取消处理,根据初始原订单操作订单提交和取消



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

南网专用,国内机票订单详细(新): http://testapi.shinetour.com/API.svc/NWGetFlightOrderDetail

接口描述:

南网查询订单详细信息,根据初始原订单查询



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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  
        email 邮箱 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  
        email 旅客邮箱,国际机票使用 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":"请求成功",    //执行结果描述
}

创建保险订购单: http://testapi.shinetour.com/API.svc/CreateInsuranceOrder

接口描述:

创建保险订购单



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

创建保险退保单: http://testapi.shinetour.com/API.svc/CreateInsuranceReturnOrder

接口描述:

创建保险退保单



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}

调整单查询: http://testapi.shinetour.com/API.svc/QueryAdjustOrderDetail

接口描述:

调整单查询



 

请求参数:

请求参数
参数名 备注 参数类型 父级 是否必填
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":"请求成功",    //执行结果描述
}
Back to top