文档中心 > 旅游度假

飞猪度假-交易-订单创建

更新时间:2021/04/13 访问次数:17508

订单创建流程为必选流程,商家系统通过该流程可以获取到在飞猪平台上产生的实时订单数据。订单创建 主要有两种实现方式:一种是绝大部分业务都适用的通用流程,另一种是部分垂直业务定制的下单流程。
通用流程
垂直业务定制流程

通用流程

通用订单创建流程适用于除下文所述垂直定制业务外的所有飞猪度假业务。商家系统获取飞猪平台订单信息以完成订单创建可以分为以下两个步骤:
步骤一、获取飞猪平台交易订单id。

  • 消息监听方案:在淘宝开放平台订阅消息服务:alitrip_travel_OrderChanged。当飞猪平台有新订单产生、付款时,消息服务会主动通知到商家系统 有新订单产生并附带上飞猪平台的订单id。该方案的优点:实时;缺点:消息存在延迟、丢失、重复的可能,需要商家处理好异常情况
  • 定期轮询方案:商家系统定期调用订单列表搜索接口,获取尚未处理的订单:alitrip.travel.trades.search。该方案的优点在于商家可以主动获取订单列表;缺点是对新订单的处理不够实时,需要定期轮询
  • 推荐最佳方案:消息监听实时获取状态变更的订单信息,同时定期轮询兜底,防止消息丢失导致丢单

步骤二、根据飞猪订单id获取订单详情。商家可以调用飞猪提供的订单详情接口(alitrip.travel.trade.query)获取到飞猪订单的详情信息(如买卖家信息、出行人信息等),然后实现在商家系统创建对应的订单。

注:关于消息服务的说明

该流程开放的API接口

订单消息服务 - alitrip_travel_OrderChanged

  • 飞猪度假交易订单消息通知服务,如果商家应用订阅该消息服务,则当飞猪度假订单有状态变化时会主动通知到商家应用。目前支持的消息产生条件:订单产生,订单已付全款,订单关闭,订单已发货,订单已完成,订单已付定金(只有分阶段付款的预售商品订单才有)。
  • 请注意,order_status=2代表订单已付全款。对于预售商品订单,已付定金消息对应的order_status=6。
  • 订单消息内容如下表所示。
字段名称 字段描述 字段类型 是否可以为空 示例值
buyer_nick 买家昵称 string buyer11
gmt_created 订单创建时间 Date 2017-01-11 15:30:01
gmt_modified 订单上一次修改时间 Date 2017-01-11 15:30:01
item_infos 该主订单下子订单列表所对应的商品信息列表,多个以英文逗号分隔。商品信息格式为:类目id:商品id:商品级别商家编码:sku级别商家编码 string 123456:2333:outProId:outSkuId,123456:2333:outProId:outSkuId11
order_id 主订单id long 12345678
order_status 订单状态。1-订单创建,2-订单已付款(已付全款),3-订单已关闭,4-订单已发货,5-交易成功,6-订单已付定金(只有预售商品订单才有),7-部分交易成功(部分打款给卖家,目前只有签证业务才有),8-在线办理订单买家提交材料(签证在线化业务,发送申请人ID),9-签证使馆出签结果(直连使馆订单才有) int 1
seller_nick 卖家昵称 string seller11
seller_id 卖家id string 123456
auth_appkeys 可选字段,跨店铺数据访问情况下,已被授权允许访问该笔订单数据的appkey列表。开发者需要验证接收消息的appkey是否包含在此字段auth_appkeys。若包含则可以正常调用订单查询接口;若不包含又需要查询详情,则需要走多店铺授权+商品报备,具体可以参考店铺商品授权报备 string 123,233
biz_type 可选字段,垂直业务类型。1-度假(自由行,跟团游),2-普通签证,3-门票,4-wifi,7-当地玩乐,9-邮轮,10-用车(包车,租车),12-电话卡,17-流量充值,18-港澳签注,19-在线签证,0-其他 int 19
biz_exts 可选字段,垂直业务相关扩展信息。json格式字符串,各业务支持的可选key列表详见:订单消息-业务扩展字段定义 string {"key1":"value1"}

订单搜索接口 - alitrip.travel.trades.search

  • 飞猪度假交易订单搜索服务,基于订单创建时间进行搜索,同时支持按照订单基本状态进行过滤。预留扩展字段,以支持更多过滤条件支持。

订单详情接口 - alitrip.travel.trade.query

  • 通过主订单id获取一笔订单详情信息:主订单详情(基本信息+支付信息+优惠信息+买家信息+卖家信息)+子订单详情(商品相关信息(包含各业务订单特有扩展信息)+出行人信息+联系人信息)。该订单详情接口为通用接口,支持度假、门票、签证等业务类型订单。
  • 部分用户隐私信息字段经过了模糊化处理,需要满足集团安全条件才能获取到明文数据。具体安全整改请进商家API对接群查看和咨询
  • 该订单详情接口同时也支持 分阶段付款的预售商品订单。对于预售订单,根据主订单信息中type字段值进行判断(预售订单值为step,一口价订单值为fixed)。如果是预售订单,主订单支付信息(pay_info)中会包含分阶段付款明细信息,详见字段step_paid_fee,step_trade_status
  • 订单详情中有两部分跟各个垂直业务强相关的信息没有做结构化字段,而是以扩展属性的形式给出:商品类目扩展信息 和 自定义出行人信息。详细定义与说明如下,请注意查看和了解:
    商品类目扩展信息定义:https://fliggy.open.taobao.com/docs/doc.htm?docType=1&articleId=107548
    自定义出行人扩展信息定义:https://fliggy.open.taobao.com/docs/doc.htm?docType=1&articleId=107550

垂直业务定制流程

接送机直连对接业务

直连对接业务指飞猪平台调用外部商家接口服务以完成相应业务流程。针对接送机场景,开放设计了接送机订单提交接口(fliggy.tripcar.order.submitorder)。服务商需要实现该API定义的接口规范并提供公网可访问的http服务,在用户提交订单后,飞猪平台将通过该接口将订单信息推送到商家系统。

国际租车直连对接业务

直连对接业务指飞猪平台调用外部商家接口服务以完成相应业务流程。针对国际租车场景,开放设计了国际租车订单提交接口(qimen.alitrip.rentcar.order.submit )。服务商需要实现该API定义的接口规范并提供公网可访问的http服务,在用户提交订单后,飞猪平台将通过该接口将订单信息推送到商家系统。

注:1、由于垂直业务定制下单流程为飞猪直连对接商家接口,如有商家需要接入请先联系飞猪业务和技术小二进行评估。2、直连对接业务需要商家入驻奇门平台,相应API接口规范需要登录奇门平台才能访问。

FAQ

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