文档中心 > 淘宝旅行

机票接入FAQ

更新时间:2015/09/18 访问次数:22585

机票代理人接入

亲,请点击

//open.taobao.com/api/api_cat_detail.htm?spm=0.0.0.0.cGneAa&cat_id=10078&category_id=102

一、政策Q&A

Q: 接口上传的政策为什么不展现?

A : 商户可先自查:

1.     首先检查是否绑定销售规则;

2.     检查销售规则的销售有效期、旅行有效期;

3.     检查政策上的销售有效期、旅行有效期;

4.     检查政策上的工作时间;

5.     检查政策上的最早、最晚提前出票天数是否有限制;

6.     计算销售价格,淘宝默认展现前10个价格.

如果自查后仍无法展现,可联系区域技术支持。

Q2: 接口上传的政策后演淘宝旅行后台是否可以查看?

A可以,登录代理人后台,在运价管理-查询维护渠道政策

Q3: 政策添加接口没有政策类型的字段,怎么区别政策类型?

A政策类型字段是老系统中才存在,如:特价、让利、特殊等。目前系统中已将政策类型去掉,针对特价、让利、特殊这种类型的政策按正常政策录入即可。特别说明:像NDF特价可以直接使用淘宝旅行下载的运价数据,商户只需维护对应政策即可使用。

Q4: 增量政策查询接口是以ZIP格式输出文件还是以JSON格式输出文件?

A: 增量政策查询接口以JSON格式输出文件(包括错误信息),而全量政策查询接口以ZIP格式输出文件(包括错误信息)。

Q5:  增量政策查询接口中参数:includeFlightNos是否不用带航空公司两字码?

A是的,includeFlightNos包含航班号和excludeFlightNos排除航班号都不用带航空公司两字码。

Q6:  政策接口中需要传递“workTime”“refundTime”作为出票工作时间和退票工作时间,淘宝旅行的后台也提供了录入该时间的地方,请问有何区别?

A政策接口的工作时间是必须要传的,不传政策将无法入库。前后关系:淘宝后台录入的工作时间,是适用于代理商的,如果到了工作时间此代理商下的所有政策都不展现了。政策传入的工作时间是适用与此条政策的,如果到了工作时间,此条政策将不展现。

Q7:政策接口中PolicyPriceDoPolicySegmentDo都为list,请问两者之间有关系么?

A PolicyPriceDoPolicySegmentDo虽然都是List但是两者之间是没有直接的对应关系的,PolicyPriceDoLIST是为了平台而设计,因为平台有多个卖家ID

Q8: 政策接口有没有挂起、解挂功能?

A没有,目前政策只有上传和删除功能,商户可以通过政策接口来实现挂起解挂,即商户挂起的政策通过接口删除,解挂通过接口上传。

Q9: 政策(全量政策查询和增量政策查询)接口只支持单程?

A:目前政策接口只支持上传单程政策,后台EXCEL上传功能可支持单程和往返。

Q10: 批量政策上传如果有几条政策上传失败会不会影响此次上传?

A批量政策上传时如果其中有几条政策由于录入信息有问题导致上传失败不会影响其他政策,即它们不是在同一个事务中。

Q11: 增量政策查询接口中利用deleteIds属性删除政策时,是否有数量的限制?

A建议最好控制在500个以内,最大支持1000条。

Q12: 如果全量政策查询接口的数据很大(例如几百万条),这时增量查询接口会按什么逻辑进行调度?

A系统进行全量政策查询接口任务调度时,增量调度任务不会启动,待全量调度完成后在进行增量调度。

Q13: 全量政策查询之后,是先发送全量导入政策结果通知,还是先进行增量政策查询?

A: 导入政策通知接口是本次请求错误每满1000条发送一次,如果本次请求错误数不满1000条,则在全部政策处理完成后发送通知。通知与增量没有顺序保证,政策通知参数中都会有相应的requestId.

Q14: 如果一次增量查询连续收到很多数据,怎么发出处理通知?

A政策通知只负责发送,不关心接口返回的结果。增量查询每次请求都有唯一的requestId,通知发送也是以requestId为准的。当上次增量政策查询任务未完成时,下次增量政策查询任务是不会启动的。

Q15: 全量、增量查询返回结果中的 lastModifiedTime 参数细节?

A该参数只能是标准的时间格式,可精确到毫秒。

Q16: 如何通过全量政策查询接口来实现政策删除?

A通过指定delTime 参数,系统判断 政策上的 timestamp< =delTime 的政策都会被删除。全量政策增量政策都是先做入库操作,然后在做删除操作。

Q17:如果全量或增量政策查询的处理结果通知没有被我方正确处理会重试吗?

A如果超时会重试三次,超时时间10S

Q18:政策对象 PolicyDO 中的 timestamp 属性,限制重复值吗?

Atimestamp 没有限制,具体到毫秒。系统会将此值转化为时间与delTime做比较,
凡是小于等于delTime的政策都会被删除。

Q19: 全量政策查询接口的调度机制?

A:全量政策查询接口调用时间不再是固定的周一和周二,而是可以根据商户要求配置,但是配置时间也只能是每周一到二次(具体配置是在上线邮件中说明)。

Q20: 全量政策接口里面delTime delOuterId的区别?

A: 如果上传政策时两个值同时传入,系统会以delOuterId(不会处理delTime属性)为准,会根据delOuterId对应政策ID上传时候的timestamp时间,删除此时间之前的政策。如果这个时间与商户传的delTime 不一致,将会存在政策删除不全的情况。建议只传入delTime参数。

 

二、退改签Q&A

Q1: 新系统中退改签规则如何录入?

A可以通过上传政策(全量政策查询接口、增量政策查询接口)的同时上传退改签,或者通过淘宝旅行后台EXCEL上传政策时同步上传退改签,或者通过淘宝旅行后台菜单单独录入。

Q2: 退改签显示信息如何匹配?

A退改签展现规则:

公布运价(无价格)如果不传退改签,匹配淘宝系统中的退改签,匹配不到展现:航空公司为准

公布运价(无价格)如果上传退改签,则已上传的为准

私有运价,必须上传退改签,已卖家上传的为准。

三、订单Q&A

Q1: 调用TOP 机票API时提示没有权限为啥?

A在调用TOP 机票API前,第一步需要入塔;第二步创建应用,并将应用标识为“新业务”;第三步找运营的同学做机票应用授权。

Q2: 如何获取SESSION KEY

 A 授权的原理以及获取请查看://open.taobao.com/doc/detail.htm?spm=0.0.0.0.P67edB&id=118

Q3: SessionKey的有效时长只有24小时或者1个月,如何提高?

A当应用的状态处于“正式测试环境”时,sessionkey的有效时长仅为24小时。只有当状态“正式运行中” sessionkey的有效时长1年,如果此状态下有效期只有1个月时请先尝试重新获取,如果不行再加旺旺号:“晓川”协助。

Q4: 目前下单流程如何分类?

A目前流程为:一个是正常的流程,一个是申请流程(如K位)。申请流程的差异在于:下单后用户不能立即支付,需要等代理申请座位,这个时间是60分钟。代理需要在60分钟内确定座位(卖家通过淘旅行后台手工确认),买家就可以支付了。之后就和普通订单一样,如果代理没有在60分钟内确定座位,那订单就失效了

Q5: 机票订单消息订阅时消息名称?

A: 消息名称是:JipiaoTripOrderChanged ,类目是jipiao

三、其他

Q1: 调用SDK时,报“禁止聚石塔外机器调用”

A这个是因为没有完成入塔,请到聚石塔完成入塔(如果使用系统商系统,可以先确认系统商三方入塔,如果已经入塔,完成关联授权即可)

Q2: 调用SDK时,报“appkey无效”

A请确认调用的环境是沙箱还是线上,对应的网关不一样(网关说明详见:http://www.tbsandbox.com/doc/index.html#sandbox_url

Q3: 消息订阅服务如何对接

A请访问//open.taobao.com/doc/detail.htm?id=101663或者下载机票接入白皮书查询。

待续。

FAQ

关于此文档暂时还没有FAQ
返回
顶部