共享平台API接口规范版本: 0.7s携程旅行网目录1.前言 (4)1.1功能描述 (4)1.2阅读对象 (4)1.3业务术语 (4)1.4技术服务............................................................................................................... 错误!未定义书签。
2.接口参数说明 (5)2.1普通政策请求参数 (5)2.2特惠政策请求参数 (5)2.3特价政策请求参数 (16)3.示例Xml请求 (16)3.1普通政策 (16)3.2特惠政策 (16)3.3特价政策 (19)4.错误代码整理 (21)4.1错误代码规则说明 (21)4.2错误固定标识及错误代码分类说明 (21)4.3目前已知错误代码列表 (21)版本历史1.前言1.1 功能描述为了提高代理商在携程网的政策投放效率，满足其业务需求，由携程机票研发部门开发了一套代理商政策导入接入API。
本文档是为了描述相应的接口规范。
1.2 阅读对象面向具有一定技术实力的代理商公司相应的技术人员1.3 业务术语1.4 接口API导入必读API导入入口：/Flight-Product-TradeAPI/PolicyWS.asmx接口参数：username: 用户名password: 密码（格式: MD5(UTF-8(“username#password”)）)execType: 执行类型，只支持FullADD(全量上传), ADD(增量上传)gzipRequestBytes: 请求报文字节数组，是对报文进行GZIP后产生的字节流接口响应格式：返回的是对报文GZIP后的base64位格式的文本编码目前每日最大请求次数是500次1.5 技术服务前期请直接联系相应的票台关联业务人员2.接口参数说明2.1 普通政策请求参数2.2 特惠政策请求参数2.3 特价政策请求参数暂不提供2.4 返回参数3.示例Xml请求3.1 普通政策<?xml version="1.0"encoding="UTF-8"?><TradePolicyRequest xmlns="urn:ctrip:api:flight:trade:message:PolicyService:v1"> <TradePolicyImportRequest><ExecType>ADD</ExecType><PolicyType>COMMON</PolicyType><PolicyList><Policy><PolicyCode>December</PolicyCode><ProductUnit><EffectDate>2013-12-24T00:00:00</EffectDate><ExpiryDate>2013-12-24T23:59:00</ExpiryDate><ItineraryList><Itinerary><AirlineCode>CA</AirlineCode><DeptAirport>PEK</DeptAirport><ArrvAirport>URC,KWL,WUH,HRB,DLC,SHE</ArrvAirport><FlightEffectDate>2013-12-24T00:00:00</FlightEffectDate><FlightExpiryDate>2013-12-25T00:00:00</FlightExpiryDate><WeekDays>1357</WeekDays><BookingClass>Y,B,L</BookingClass><FlightControl><FlightNumSaleLimitFlag>1</FlightNumSaleLimitFlag><FlightNumRangeList><FlightNumRange><FlightNumStart>5000</FlightNumStart><FlightNumStop>5001</FlightNumStop></FlightNumRange></FlightNumRangeList></FlightControl></Itinerary></ItineraryList></ProductUnit><PriceUnit><ReturnPoint>8</ReturnPoint><ReturnPrice>4</ReturnPrice></PriceUnit></Policy></PolicyList></TradePolicyImportRequest></TradePolicyRequest>3.2 特惠政策请求格式：<?xml version="1.0"encoding="UTF-8"?><TradePolicyRequest xmlns="urn:ctrip:api:flight:trade:message:PolicyService:v1"><TradePolicyImportRequest><ExecType>ADD</ExecType><PolicyType>SPECIAL</PolicyType><PolicyList><Policy><PolicyCode>Inventory</PolicyCode><ProductUnit><ProductType>0</ProductType><EffectDate>2014-01-01T00:00:00</EffectDate><ExpiryDate>2014-01-31T23:59:00</ExpiryDate><MinAdvanceDays>0</MinAdvanceDays><MaxAdvanceDays>365</MaxAdvanceDays><MinStopDays>0</MinStopDays><MaxStopDays>0</MaxStopDays><MinPassengerNum>1</MinPassengerNum><ItineraryList><Itinerary><AirlineCode>MU</AirlineCode><DeptAirport>NKG</DeptAirport><ArrvAirport>PVG</ArrvAirport><FlightEffectDate>2014-01-01T00:00:00</FlightEffectDate><FlightExpiryDate>2014-01-31T00:00:00</FlightExpiryDate><FlightDepartTimeLimitRemarks/><WeekDays>1234567</WeekDays><BookingClass>Y</BookingClass><BookingClassNote/><FlightNo>1989</FlightNo><FlightControl/></Itinerary></ItineraryList><CabinClass>Y</CabinClass><RefundBasis>D</RefundBasis><RefundChangeEndorseRemarks>10-2-20^20-0-50^0</RefundChangeEndorseRemarks> <RefundChangeEndorseNote>for test only</RefundChangeEndorseNote><MinPassengerAge>0</MinPassengerAge><MaxPassengerAge>100</MaxPassengerAge><Remarks/></ProductUnit><PriceUnit><PriceInfo><PrintPrice>0</PrintPrice><SalePrice>880</SalePrice><SetPrice>880</SetPrice></PriceInfo><ReturnPoint>0</ReturnPoint><ReturnPrice>0</ReturnPrice></PriceUnit><InventoryUnit><InventoryType>FIX</InventoryType><SaleableQuantity>5</SaleableQuantity></InventoryUnit><ServiceUnit><OfficeNos/><AutoTicketed>false</AutoTicketed><NeedCreatePNR>true</NeedCreatePNR><NeedChangePNR>true</NeedChangePNR><NeedProvideInvoice>1</NeedProvideInvoice><NeedPata>true</NeedPata><NeedConfirm>false</NeedConfirm><NeedProvideFrequentFlyerScore>false</NeedProvideFrequentFlyerScore><AllowPayDirectly>true</AllowPayDirectly><WorkTimeLimitRemarks>0000-2359,0000-2359,0000-2359,0000-2359,0000-2359,0000-2359,0000-2359</ WorkTimeLimitRemarks><TicketedSpeed>0</TicketedSpeed></ServiceUnit></Policy></PolicyList></TradePolicyImportRequest></TradePolicyRequest>代码示例：ServiceInvokeDemo.7z3.3 特价政策暂不提供3.4 返回结果共有三种返回格式：a. 成功b. 政策错误c. 服务类或者请求错误4.错误代码整理4.1 错误代码规则说明错误代码由三部分组成，两位固定标识+两位错误代码分类+两位业务码+两位错误码4.2 错误固定标识及错误代码分类说明1，2位为固定标识: 803，4位错误代码分类，目前分为以下几类:00: 未知错误01: 请求合法性验证错误(比如销售日期结点不支持输入一个整型值)02: 请求有效性验证错误(比如销售起始日期不能大于其结束日期)03: 业务逻辑类验证错误(比如要求导入一个无效政策)5，6位表示政策类型，可以分为以下几类:00: 特惠政策01: 普通政策02: 特价政策4.3 目前已知错误代码列表注意事项：1、全量上传每次支持100W条政策，增量上传每次支持5W条政策2、全量上传操作后需价格20分钟可以进行下一次操作，增量上传没有间隔时间3、全量上传会覆盖删除接口和excel导入的政策，不会删除手工录入的政策。