4.5 国内采购生单(/IDomesticTicketBookingV2)
| 参数 | 类型 | 说明 | 必填 | 备注 |
|---|---|---|---|---|
| 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:
| 参数 | 类型 | 说明 | 必填 | 备注 |
|---|---|---|---|---|
| Name | String | 乘客姓名 | Y | |
| PsgType | Int | 乘客类型 | Y | 0：成人 1：儿童 2：婴儿 |
| Nationality | String | 国籍代码 | Y | |
| IDType | Int | 证件类型 | Y | 0：护照 身份证:2 港澳通行证:3 回乡证:4 户口簿:5 出生证明:6 台湾通行证:7 台胞证:8 军人证:9 港澳台居民居住证 : 10 外国人永久居留身份证:11 其他有效证件 : 12 电子护照:13 海员证:14 |
| IDNumber | String | 证件号码 | Y | |
| IDNationality | String | 证件签发国 | ||
| Gender | Int | 性别 | Y | 1：男 0：女 |
| Birthday | String | 出生日期 | Y | |
| PhoneNumber | String | 手机号 | Y | 航司规定，多成人不可重复，目前MU,HU,SQ,MI限制必输 购买保险产品时必填 |
| 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项 |
| 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 拆单时不填默认第一张或按顺序获取 |
| changeConditions | String | 签转条件 | |
| ruleRemark | String | 备注 | |
| baggageAllowance | String | 行李额 | |
| ruleItem | Array | 退改明细 |
ruleItem:
| 参数 | 类型 | 说明 | 备注 |
|---|---|---|---|
| changePrice | Decimal | 同舱改签费 | |
| refundPrice | Decimal | 退票费用 | |
| operatorHourText | String | 适用条件 | |
| depTime | String | 起飞前时间 | |
| text | String | 文本型条款 |
{
"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",
}
| 参数 | 类型 | 说明 | 备注 |
|---|---|---|---|
| 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 | 说明 |
{
"code": "20000",
"detail": [{
"OrderStatus": 10,
"PNR": "XXXXXX",
"DepAir": "CAN",
"DesAir": "JGS",
"DepCityName": "广州白云国际机场",
"DesCityName": "井冈山机场",
"TOOrderID": "TO18071834650",
"IOOrderInfoList":[]
}]
}