美亚航旅机票B2B接口

用户工具

站点工具

4.5_国内采购生单v2_idomesticticketbookingv2_inside

目录

4.5 国内采购生单(/IDomesticTicketBookingV2)

4.5.1请求参数

参数 类型 说明 必填 备注
policySerialNumber String 计价key Y
createOrderType Int 下单方式 Y 1：实时抗班下单
2：PNR下单
3：航段下单
PNR String PNR N 下单方式为2、3该字段必填 且需先授权给出票 OFFICE号
isConvert int 是否转编码 N 当下单方式为2、3
是否自动转编码：1-转 0-不转
（计价结果isConvert为1）
（若不转生单为申请单，人工跟进）
passengerList Array 乘客列表 Y/N 当下单方式为1、3必填
QDOrderID String 第三方订单号 N
APIAntiOffice String API反授权office N
ETTJAuthOffice String 票号授权office N 票号需要授权的OFFICE号，仅限传一个OFFICE
FlightChangeNoticeMobileNumber String 航变通知手机号 N 需生成PNR且成功时生效(参数已弃用)
contact Object 联系信息 Y/N 订单联系信息
fareId String 价格id Y/N 使用IDPricingBySeg接口计价 必填
insuranceProductSerialNumber String 保险key N 购保时必传 IInsuranceProductsQuery接口的serialNumber
insuranceList Array 购买的保险集合 N IInsuranceProductsQuery按航段选择保险产品
查询保险产品时需按下单乘客类型传递 一旦选择则默认全部的乘客都购买 若下单和保险查询的乘客类型不一致则会提示
qCom Array 指令信息 N 订单需拆单时按拆单价格顺序传入 20220510
rules Array 退改条款 N 传递该参数时将替换原退改条款 未上线
请求参数同返回:4.8 国内实时航班退改条款(/IDomesticShoppingRuleQueryV2)

passengerList:

参数 类型 说明 必填 备注
NameString 乘客姓名 Y
PsgTypeInt 乘客类型 Y 0：成人
1：儿童
2：婴儿
NationalityString 国籍代码 Y
IDTypeInt 证件类型Y 0：护照
1：其他有效证件（注：含军人证、回乡证、台胞证、户口簿、出生证明、学生证、外国人永久居留证、民航局规定的其他有效乘机身份证件 长度不超过15位）
身份证:2
港澳通行证:3
回乡证:4
户口簿:5
出生证明:6
台湾通行证:7
台胞证:8
军人证:9
港澳台居民居住证 : 10
外国人永久居留身份证:11
其他有效证件 : 12
电子护照:13
海员证:14
IDNumberString 证件号码 Y
IDNationalityString 证件签发国
GenderInt性别 Y 1：男
0：女
BirthdayString 出生日期 Y
PhoneNumberString 手机号 Y 航司规定，多成人不可重复，目前MU,HU,SQ,MI限制必输
购买保险产品时必填
Email String 邮箱 Y/N 根据航司规定,部分航司必须录入 2022/05

insuranceList:

参数 类型 说明 必填 备注
fid String 保险航段标识ID Y IInsuranceProductsQuery接口：fid
insuranceids Array 选择的保险产品id集合 Y IInsuranceProductsQuery接口：insuranceList集合的id

contact:

参数 类型 说明 必填 备注
linker String 联系人 Y
phone String 联系人手机 Y 若订单生编，则作为编码OSI CTCT项
email String 邮箱 N
flightChangeNoticeMobileNumber String 航变通知手机号 N 若订单生编，则作为编码OSI CTCM项(弃用)
content String 备注 N
isEmail Int 出票邮件通知 N 默认为“0”；若“1”则出票成功发送邮件至上面参数邮箱
isSMS Int 出票短信通知 N 默认为“0”；若“1”则出票成功发送短信至上面参数联系人手机
isEmail_VoyageChange Int 航变邮件通知 N 默认为“0”；若“1”则发生航变发送邮件至上面参数邮箱
isSMS_VoyageChange Int 航变短信通知 N 默认为“0”；若“1”则发生航变发送短信至上面参数联系人手机

qCom:

参数 类型 说明 必填 备注
index Int 订单顺序标识 N 0/1 拆单时不填默认第一张或按顺序获取
pat String PAT指令 N 若有accountCode，需带accountCode指令
integral String 积量指令 N RMK 或 SSR 或 OSI 指令
other String 其它指令 N 多个逗号隔开；EI、TC指令
code String 大客户account_code N 下单核价时需要 accountCode
office String 出票OFFICE N 下单核价时需要
carrier String 出票航司 N 下单核价时需要
fareTag String 大客户价格标签 N 1:协议 2:特惠

rules:

参数 类型 说明 备注
index Int 订单顺序标识 0/1 拆单时不填默认第一张或按顺序获取
changeConditionsString 签转条件
ruleRemarkString 备注
baggageAllowanceString 行李额
ruleItemArray退改明细

ruleItem:

参数 类型 说明 备注
changePriceDecimal同舱改签费
refundPriceDecimal退票费用
operatorHourTextString适用条件
depTimeString起飞前时间
textString文本型条款

4.5.2请求样例

{
  "createOrderType": "1",
  "policySerialNumber": "fa88d07a-68f0-3a78-739c-9f8c1d072cea",
  "PNR":"KQJX8F",
  "isConvert": "0",
  "QDOrderID": "1",
  "APIAntiOffice": "CAN826",
  "FlightChangeNoticeMobileNumber": "13512345678",
  "insuranceProductSerialNumber": "145d34d096fa49f36999999999999",
  "insuranceList":[
	    {
	        "fid": "API0",
	        "insuranceids": ["13458"],
	    }
   ],
  "passengerList": [
    {
      "Name": "TEST/A",
      "PsgType": "0",
      "Nationality": "CN",
      "IDType": "0",
      "IDNumber": "123456",
      "IDExpiration": "2020-01-01",
      "Gender": "1",
      "Birthday": "1980-08-08",
      "PNR": "XXXXXX",
      "PhoneNumber": "13745678900"
     }
  ],
  "contact":
        {
          "linker":"联系人A",
          "phone":"13888888888",
          "email":"",
          "flightChangeNoticeMobileNumber":"13899999999",
          "content":"",
          "isEmail":"0",
          "isSMS":"0"

        }
    ,
    "fareId":"ADT0100-0-0",
}

4.5.3返回参数

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

detail:

参数 类型 说明 备注
DepCityName String 出发机场
DesCityName String 到达机场
DepAir String 出发机场三字码
DesAir String 到达机场三字码
TOOrderID String 单号 若返回空，则该单下单不成功
PNR String PNR
Desc String 说明
OrderStatus Int 订单状态 状态仅供参考，不作为订单实际状态的依据
IOOrderInfoList Array 保险下单信息

IOOrderInfoList：

参数 类型 说明 备注
OrderId String 保险单号 若返回空，则该单下单不成功
ProductNameID String 保险名称ID
ProductName String 保险名称
EffectDateStr String 生效时间
ExpiryDateStr String 失效时间
SaleTotal Decimal 金额
Description String 说明

4.5.4返回样例

{
  "code": "20000",
  "detail": [{
    "OrderStatus": 10,
    "PNR": "XXXXXX",
    "DepAir": "CAN",
    "DesAir": "JGS",
    "DepCityName": "广州白云国际机场",
    "DesCityName": "井冈山机场",
    "TOOrderID": "TO18071834650",
    "IOOrderInfoList":[]
  }]
}
4.5_国内采购生单v2_idomesticticketbookingv2_inside.txt · 最后更改: 2024/04/01 10:55 由 tiny

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki