行啊推送服务接口资料.docx

1、行啊推送服务接口资料行啊推送服务接口说明书变更记录版本号修改原因内容修改人审核批准人修改时间2.0.0增加内容：1.增加火车票节点2.最低价3.出票完成、出保险未完成推送到小太阳的情况的缺陷修复王松王松2016/04/132.1.0增加内容：1.机票航段对应关系(有开关，可控制是否推送)2.支付信息3.增加GP验证方式的字段（公务员身份验证/采购卡验证）王松王松2016/05/032.2.1增加内容：1.行程导入的TC账号2.航段添加打票机号(本次新增内容参见黄色部分)王松王松2016/05/232.2.2增加内容：1. GP采购卡号2.行程数据来源(本次新增内容参见黄色部分)王松王松2016

2、/06/27接口说明本接口用于将代理人在行啊系统中预定出票的行程数据推送到代理人后台系统。需要提供推送地址及合作同步账号。推送采用http的post传输，数据格式是utf-8编码的json字符串。加密方式采用3Des加密算法，参见ThirdDes.java。推送后需返回结果给行啊系统，json格式如下：msgCode:1, errMsg:null msgCode：1-同步成功 0-同步失败errMsg：同步失败用于记录同步失败原因到行啊系统接口推送数据说明：推送对象：AgentSysSynReqVo属性说明accountName同步账号,StringjourneySynVO行程详情,Journ

3、eySynVOJourneySynVO属性说明agentId代理人id NUMBERairItemPayStatus航空单元是否已支付：（n 非在线支付 c 支付成功，等待收款（分润失败） f 支付失败 0 待支付 1 支付成功 2 待补款 3 补款成功 4 支付取消 5 退款中 6 退款成功 7 补款取消 ）,StringairItemSynVOList航空单元列表，ListalterTicketReason改签原因 StringalterTicketRemark改签说明 StringappJourneyDescapprovalUrgency紧急送审标志 1紧急送审 0 null正常送审 S

4、tringapvLevel当前审批级别 StringapvType审批类型：0:web审批 1:通过parid审批 2:通过邮箱审批 StringapvruleId审批规则类型ID NUMBERbookUserType预订人用户类型，1-个人型，0-秘书型，2-TC StringbookerEmail预订人邮箱 StringbookerId预订人OBT账户id NUMBERbookerMobile预订人手机号码 StringbookerName预订人姓名 StringbookerTel预订人电话 Stringbooktime已定妥时间 NUMBERcontactEmail联系人email St

5、ringcontactName联系人姓名 StringcontactParId联系人parid NUMBERcontactTel联系人电话 StringcorpCode公司编码 StringcorpId公司ID NUMBERcostCenterInfo成本中心 Stringcreatetime创建时间 NUMBERdataFrom数据来源，1为手机端，2为web端 Stringdescription行程说明(出差原因) Stringdi国际国内标识（d-国内，i-国际） StringemailType邮件类型 StringhotelItemSynVOList酒店单元列表 ListicsAtta

6、chment邮件附件 StringifSyncOA是否同步OA(0-否 1-是) StringisApplyEndorseTicket用户是否已申请改签 0 否，1是 StringisApplyRefundTicket用户是否已申请退票 0 否，1是 StringisEndorseTicket是否改期 0否，1是jourState行程状态（0-已取消，1-计划中，2-审批中，3-已通过，4-已拒绝，5-待订妥，6-已订妥） StringjourneyNo行程号 NUMBERneedApv是否需要审批 StringneedMailPassenger标记是否需要给乘机人发送邮件 （0 - 不需要

7、1 - 需要） StringneedSendItineraryPdf标记是否需要发送PDF行程单 0 - 不需要 1 - 需要 StringoaOrderNo结算单号 StringparId预订人常客id NUMBERpayCancelReason支付取消原因 StringpayFailTimes审批类型：0:web审批 1:通过parid审批 2:通过邮箱审批 Stringpayconfirm是否已点击过“确认支付” 0否 1是 StringpolicyUserId差旅政策人id NUMBERpsgRemarkpsg备注 StringpushDownState下推状态，SUCCESS或这FA

8、IL StringrefundTicketReason退票原因 StringrefundTicketRemarks退票说明 Stringremark备注(TC转线下处理回填备注用) StringreturnReason订单退回理由 StringselectedApvers所选审批人（多个使用,分隔） StringserviceCodeId服务代码ID NUMBERserviceCodeName服务代码名称 StringstateUpTime状态修改时间 NUMBERsubmitDirectly标记审批通过后是否直接提交订单 （0 - 不直接提交 1 - 直接提交） Stringsupplier

9、Id供应商id NUMBERsynOaFlag同步oa标志位 0-未同步;1-自动同步失败;2-人工同步失败;3-同步成功 StringtcRemark1tc备注 StringtcRemark2tc备注 StringtcRemark3tc备注 StringtcRemark4tc备注 StringtcRemark5tc备注 StringtcRemark6tc备注 StringtcRemark7tc备注 StringtcRemark8tc备注 StringticketSyns票面信息 ListtktIssueType出票类型 1-TC出 2自动出票 3TC确认自动出票 4易行 Stringtrav

10、elPolicyId差旅政策id NUMBERtravelPurpose旅行目的 StringtravelPurposeEn旅行目的英文描述 StringupdatePnrRemarkpnr更新备注 StringworkName预订人工作用名 StringbookerUserName预订人用户名 StringorderType订单类型（0-默认 1-gp行程） StringtktTcAccountName出票人TC用户账户名 StringapvHistorySynVOList审批历史 ListcustomFieldSynVals自定义字段列表ListtrainItemSynVOList火车单元

11、列表 ListbcTktSynVOList票列表 ListjourPayedRepayedHisSynVoList已支付 已补款 历史信息 ListimportTcAccount导入行程的TC账号 StringjourneySource行程数据来源 0-bde 1-易行，默认为 0 CHAR(1)AirItemSynVO属性说明agentId代理人ID NUMBERairItemNo航空单元号 NUMBERairItemState航空单元的状态（1-正常,0-已删除） StringairportTax机建税 NUMBERautoCancelFlag自动取消标识 StringbookedLowe

12、stType预定时差旅政策类型，0-全天最低价，1-以期望时间为基准最低价，3-以所选航班为基准最低价，4-本次航班最低价 Stringbpnr航空公司大编码 StringcancelFlagpnr是否取消标识，“1”已取消；“0”未取消；默认为“0” StringcontrContent违背了哪些差旅政策 StringcontrContentEn违背政策内容（英文） StringcontrPolicy是否违背差旅政策（1-违背,0-不违背） StringcontrReason违背差旅政策的原因 StringcontrReasonEn违背差旅政策的原因(英文) Stringcreatetime

13、航空单元创建日期 NUMBERei退改签规定 StringeiEn英文退改签规定 StringfuelTax燃油税 NUMBERhasServiceFee是否需要服务费（0-不需要，1-需要） StringifSupplement是否需要补位(0-不需要补位 1-正在补位 2-自动补位成功 3-自动补位失败 4-手工补位成功 5-手工补位失败) StringisAutoTkt用于移动判断该航空单元是否需要自动出票，0-不需要 1-需要 StringjourType行程类型（OW-单程，RT-往返） StringjourneyCreatetime行程创建日期 NUMBERjourneyNo行程号

14、 NUMBERlostVolume措施节约成本 NUMBERlowestType最低价类型（0-全天最低价，1-时段最低价，为空是正常价） StringofficeNo代理人Office号 Stringoi用来标志是去程还是回程,o 去程 i回程 StringotherPrice其他价格说明 StringparGuestname旅客姓名 StringpassengerSynVOList乘客列表ListpnrCreatetimepnr创建时间 NUMBERpnrNopnr号 StringpriceType/价格类型（RTNET,RTPUB，NET，PUB，NET+NET，PUB+PUB，NET+

15、PUB，PUB+NET） StringpriceTypeDesc价格类型 StringreferenceId分开预订的航空单元UUID StringsegmentSynVOList航段列表 ListserviceFee服务费 NUMBERtktResult出票结果 0-出票失败 1-出票成功 Stringtktl出票时限 NUMBERtotalPrice总价（不含税）NUMBERtotalTax总税 NUMBERissueBy出票方式：0-待定（tc手动确定）；m-TC手动出票；1-BSP自动出票；2-外采平台出票；3-航空公司B2B StringgpOrderNoGP政府采购订单号 Stri

16、ngairItemInsureSynVOListListtypeForLowest参考航班最低价-最低价类型（0-全天最低价，1-时段最低价，空-本身是最低价）StringairportTaxForLowest参考航班最低价-机建税 NUMBERfuelTaxForLowest参考航班最低价-燃油税 NUMBERtotalPriceForLowest参考航班最低价-总价（不含税）NUMBERtotalTaxForLowest参考航班最低价-总税 NUMBERgpPayTypeGP政府采购订单支付方式 1-公务卡验证 2-预算单位验证 CHAR(1)issueMachineNobsp打票机号 S

17、tringgpPurchaseCardNoGP采购卡号 StringPassengerSynVO属性说明agentId代理人id NUMBERairItemNo航空单元号 NUMBERbirthday出生日期 NUMBERcertNo证件号 StringcertType证件类型（1身份证；2护照；3其他（暂时不用）StringcorpCode公司编码 StringcorpId公司id NUMBERcostCenterDepartMentId成本中心部门id NUMBERcostCenterInfo成本中心信息 StringdepartMentId乘客部门id NUMBERdepartmentN

18、ame部门名称 Stringemail乘机人email StringemployeeNo员工号 StringexpireDate证件有效期 NUMBERgender性别（M-男；F-女） String(1)holderNationality国籍两字码 StringhostName主机姓名 StringhotelItemId酒店单元ID NUMBERisCheckInPerson是否是入住人：1表示入住人，0表示是同住人 StringisTempPsg临客为“1”，常客不为“0” StringissueCountry证件签发国 StringjourneyCreatetime此乘机人所属行程创建时

19、间 NUMBERmemCard常客卡号 Stringmobile乘机人手机 StringparSynVOList常客列表 ListpassengerIdid NUMBERpassengerType乘机人类型 1-成人,2-儿童 StringpsgName乘机人姓名 StringpsgNameEn乘客英文名字 StringpsgParCode乘客常旅客代码 StringpsgParId常客ID NUMBERseatPrice席别价格 NUMBERseatType席别 StringsequenceNo乘客在PNR中的序号 StringticketNumber票号 StringissueChanne

20、l出票渠道：1-其他；2-外采；3-B2B ；(与票号顺序一一对应) StringissueExPlatform出票外部平台：1-易行平台 2-支付宝 3-其他 (与票号顺序一一对应) StringticketType客票类型：1-BSP;2-B2B;(与票号顺序一一对应) StringissueRemark出票说明（当出票渠道选择其他时，此字段为tc输入的自由文本）StringinsureNumber保险单号 StringticketState机票客票状态(1出票、2退废票、3改期、9拒绝出票) StringtrainBCStatus火车票退改状态 0 已出票、1 申请退票中、2 已退票、3

21、 申请退票失败 StringtrainItemID火车票单元ID NUMBERtrainPrice火车票单价 NUMBERtrainInsureType火车票保险险种 StringtrainInsureNo火车票保单号 StringtrainInsurePrice火车票保险价格 NUMBERtrainInsureNum火车票保险份数 NUMBERtrainBox火车票列车车厢号码 StringtrainSeatNo火车票座位号StringtrainSeatType火车票座位类型StringtrainRefundID火车票退票通知ID NUMBERtrainRefundAmount火车票单票退款

22、金额 NUMBERtrainRefundStatus火车票退票处理结果0为SUCCESS/1为FAILURE成功/拒绝退票 StringtrainRefundFailReason火车票退票失败原因 StringshowInSchedule是否在我的日程中显示，0 不显示 1 显示 默认为1 StringParSynVO属性说明agentId代理人id NUMBERapvruleId关联国内审批规则id Stringbirthday出生日期 NUMBERchngName中文名 StringchnsName中文姓 Stringcity所属城市 StringcontactEmail联系人邮箱 Str

23、ingcontactMobile联系人手机 StringcontactName联系人姓名 StringcorpCode所属总公司代码 StringcorpId所属总公司ID NUMBERdepartmentId常客所属部门id NUMBERdocaTakeoffStn默认DOCA出发地信息 Stringemail个人邮件 StringemergencyContact紧急联系人 StringemergencyContactEmail紧急联系人邮箱 StringemergencyContactMobile紧急联系人手机 StringemployeeNo员工号 StringenggName英文名 S

24、tringengsName英文姓 StringhostName主机格式姓名（国内预定相关） StringinApvruleId关联国际审批规则id StringinHostName主机格式姓名（国际预定相关） StringinTravelId关联国际差旅政策ID StringisTemp是否临时旅客（0：否；1：是） Stringmobile个人手机 Stringnation国籍 StringparIdId NUMBERparLevel常旅客级别（C：普通；V：VIP；S：最高级） StringparreMark常旅客备注 Stringrelated该常客是否已关联了前台账号(0-否 1-是)

25、 Stringsex性别（M：男；F：女） Stringstatus状态（A：有效；I：无效；B：黑名单） Stringtitle职务 StringtravelId关联差旅政策id StringupdateTime创建时间 NUMBERworkName工作用名 StringSegmentSynVO属性说明accountCode大客户编码 StringactionCode行动代码 StringagentId代理人id NUMBERairItemNo航空单元号 NUMBERairlineShortName航空公司简称 StringairportTax机建税 NUMBERarriveAirportN

26、ame到达机场名称 StringarriveCity到达城市三字码 StringarriveCityName到达城市名称 StringarriveStn到达机场三字码 StringarriveTerminal到达地航站楼 StringarriveTime到达时间 NUMBERbankStringges刷卡费 NUMBERbankStringgesRate刷卡费率 NUMBERbaseCabin基础舱位（F-头等舱，C-商务舱，Y-经济舱） StringbaseFare运价基础 StringcabinCode舱位代码 StringcabinDiscount折扣 StringcabinType舱位

27、类型（F-头等舱，C-商务舱，Y-经济舱,其他为超级经济舱） StringcarriageAirline承运方航空公司 StringcarriageFltNo承运方航班号 StringcraftTypeCode机型 StringexternalPriceFormula对外价格公式 Stringflytime飞行时间 StringformulaName公式名称 StringfuelTax燃油税 NUMBERfullPrice该航段所属舱位类型全价 NUMBERinPrice对外价格 NUMBERjourneyCreatetime此航段所属行程创建时间 NUMBERmarketAirline市场航

28、空公司两字码 StringmarketFltNo市场航空公司航班号 Stringmealcode餐食代码 Stringoi去回程标识 StringoutDiscount营销策略id Stringprice航段票价（不含税） NUMBERsalePrice售价 NUMBERsalePriceFormula售价公式 StringsaleStrategyId贴扣点 Stringseat0-未知，1-支持，2-不支持 StringsegmentIdId NUMBERsequenceNo航段序号 StringstandardPrice标准价 NUMBERstopTime经停时间 Stringstopover是否有经停 StringstoppingPlaces经停点 StringtakeoffAirprotName起飞机