交易非实时同步对接方案

更新时间：2017/12/01 访问次数：31266

交易非实时同步对接

该方案可实现飞猪平台订单同步至商家系统，同时支持商家通过API接口修改飞猪订单状态，推进订单流程。交易订单非实时同步对接方案流程如下图，图中虚线框为可选流程：

飞猪系统告知商家有新订单产生，商家获取订单信息并在商家系统创建对应订单。商家获取飞猪平台订单信息有以下两个步骤：
步骤一、获取飞猪平台交易订单id。

推荐方案：在淘宝开放平台订阅消息服务：alitrip_travel_OrderChanged。当飞猪平台有新订单产生、付款时，消息服务会主动通知到商家系统有新订单产生并附带上飞猪平台的订单id。该方案的优点：实时；缺点：消息存在延迟、丢失、重复的可能，需要商家处理好异常情况。
备选方案：商家系统定期调用订单列表搜索接口，获取尚未处理的订单：alitrip.travel.trades.search。该方案的优点在于商家可以主动获取订单列表；缺点是对新订单的处理不够实时，需要定期轮询。

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

商家系统在获知并创建了对应的订单信息后，需要及时对该订单进行处理：

情况一：确认发货。商家确认有资源可以对该笔订单进行发货，则需要回调飞猪平台提供的订单发货接口（alitrip.travel.trade.deliver），实现飞猪平台上订单的发货处理。特别的，针对即时确认订单的场景，卖家无需进行发货处理，因为即时确认类商品产生的订单在买家付款后将自动发货成功。
情况二：拒绝发货。商家确认已经没有资源可以对该笔订单进行发货，则需要人工联系买家申请退款。特别的，针对二次确认订单的场景，飞猪平台提供了订单关闭接口，即由卖家发起的快速退款（alitrip.travel.trade.close），实现卖家主动关闭无法发货订单，快速退款给买家。

如果买家在飞猪平台对一笔已付款订单发起退款，飞猪系统将告知商家该事件，商家需要在自身系统对该笔订单发起取消流程并进行处理。该场景同样存在两种方案：

订单消息服务 - 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-订单已付定金（只有预售商品订单才有）	int	否	1
seller_nick	卖家昵称	string	否	seller11

通过主订单id获取一笔订单详情信息：主订单详情（基本信息+支付信息+优惠信息+买家信息+卖家信息）+子订单详情（商品相关信息（包含各业务订单特有扩展信息）+出行人信息+联系人信息）。该订单详情接口为通用接口，支持度假、门票、签证等业务类型订单。
部分用户隐私信息字段经过了模糊化处理，需要满足集团安全条件才能获取到明文数据。具体对接安全整改请参考：（待定）
该订单详情接口同时也支持分阶段付款的预售商品订单。对于预售订单，根据主订单信息中type字段值进行判断（预售订单值为step，一口价订单值为fixed）。如果是预售订单，主订单支付信息（pay_info）中会包含分阶段付款明细信息，详见字段step_paid_fee，step_trade_status

无物流虚拟商品发货接口，实现卖家对一笔子订单的确认发货。支持以下业务类型：
1、二次确认订单：支持对二次确认订单进行资源确认成功操作（资源确认成功后订单自动触发发货）
2、支持手工电子票、自取型wifi/电话卡、流量充值订单的卖家发货功能
3、（预留，暂不支持）支持邮寄型wifi/电话卡订单发货（需要物流）

卖家发起关闭一笔子订单，支持以下业务类型及情况：
1、订单已付款（卖家快速退款）：卖家主动关闭一笔已付款订单，针对特殊业务、个别授信卖家开放
2、二次确认订单：支持对二次确认订单进行资源确认失败操作（资源确认失败后订单触发自动退款）

关于此文档暂时还没有FAQ

有用(5) 我要提问