文档中心 > 旅游度假

飞猪度假-交易-订单履行

更新时间:2021/07/13 访问次数:23450

订单履行流程为必选流程,该流程节点实现了商家通过API接口完成对飞猪平台上订单的发货/拒绝发货,订单服务信息实时回传等功能。订单履行 同样有两种实现方式,一种是绝大部分业务都适用的通用流程,另一种是部分垂直业务定制的履行流程。
通用流程
垂直业务定制流程

通用流程

通用订单履行流程适用于除下文所述垂直定制业务外的所有飞猪度假和门票业务。通用订单履行流程包括以下三个部分:

一、(必选)订单处理:确认发货/拒绝发货(快速退款)

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

  • 情况一:确认发货。商家确认有资源,可以对该笔订单进行发货,则需要回调飞猪平台提供的订单发货接口(alitrip.travel.trade.deliver),实现飞猪平台上订单的发货处理。
    特别的:1)针对度假即时确认类型的订单,商家无需进行订单处理,因为即时确认类商品产生的订单在买家付款后将自动发货成功。2)针对使用电子凭证的门票订单,商家也无需进行订单处理,因为门票的发码等操作均由电子凭证完成,订单状态由系统自动推进。
  • 情况二:拒绝发货(快速退款给买家)。商家确认已经没有资源可以对该笔订单进行发货,则需要人工联系买家申请退款。
    特别的,针对二次确认类型的订单(以及个别特殊业务场景,如流量充值),飞猪平台提供了订单关闭接口,即由卖家发起的快速退款(alitrip.travel.trade.close),实现卖家主动关闭无法发货订单,快速退款给买家。

二、(可选)出行人管理

待开放,目前暂不支持,提供商家以API接口方式管理订单内出行人信息。

三、(可选)订单服务信息回填

订单服务信息回填提供给商家实时上传订单的服务信息,如手工电子票的电子码,接送机订单的司机信息,境外火车票的票号等。这些服务信息都将在飞猪APP上展示给用户,让用户实时了解当前订单的服务情况和关键信息。订单服务信息回填涉及以下两个接口的配合使用:订单服务详情模版查询(alitrip.travel.trade.template.query),订单服务信息写入(alitrip.travel.trade.serviceinfo.write)。

该流程开放的API接口

订单发货接口 - alitrip.travel.trade.deliver

  • 无物流虚拟商品发货接口,实现卖家对一笔子订单的确认发货。支持以下业务类型:
    1、二次确认订单:支持对二次确认订单进行资源确认成功操作(资源确认成功后订单自动触发发货)
    2、支持 普通无需物流订单的卖家发货功能
    3、(预留,暂不支持)支持 带物流信息(如邮寄型wifi/电话卡)订单卖家发货

订单关闭接口 - alitrip.travel.trade.close

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

订单服务信息回传
要完成服务信息回传,请参考下面几个步骤:

  • 订单服务详情模版查询 - alitrip.travel.trade.template.query
    1、商家可以通过订单号获取对应类目的模版信息,当然前提是这个类目已经配置过服务模版(注意:每个类目的模版信息是不一样的)
    服务模版会根据业务需要进行升级,所以请大家定期更新模版,否则可能影响正常使用

  • 订单服务信息写入 - alitrip.travel.trade.serviceinfo.write
    1、商家拿到模版信息后,根据模版上的规则设置相应的值,目前API不支持文件上传,仅支持链接URL;
    如果涉及到多值,则用英文分号“;”隔开;

  • 示例(以跟团游为例)

    根据任一订单ID获取对应业务服务模版,模版包含需回填信息,这里只有出团产品通知书字段,如下:
    {
      "alitrip_travel_trade_template_query_response": {
    "result": {
      "first_result": {
        "is_new": true,
        "template_info": {
          "category_id": 125094026,
          "model_list": {
            "order_tip_form_info": [
              {
                "accept_types": {
                  "string": [
                    "png",
                    "jpg"
                  ]
                },
                "desc": "png/jpg格式,支持多张",
                "max_num": 3,
                "name": "confirmImgs",
                "rule": {
                  "require": false
                },
                "sort": 5,
                "title": "出团产品通知书",
                "type": "imgs"
              }
            ]
          },
          "template_id": 65,
          "version": 0
        }
      }
    },
    "request_id": "16l3bplin2yz9"
      }
    }
    拿到模版信息后,根据回传接口约定的字段标准构造数据:
    1、传单值
    tip_value:{"confirmImgs":"https://img.daily.taobaocdn.net/imgextra/i3/2024098454/TB2C4VXXXXXXXc1XXXXXXXXXXXX_!!2024098454.jpg"}
    sub_tc_order_id:123456
    2、传多值(英文分号隔开“;”)
    tip_value:{"confirmImgs":"https://img.daily.taobaocdn.net/imgextra/i3/2024098454/TB2C4VXXXXXXXc1XXXXXXXXXXXX_!!2024098454.jpg;https://img.daily.taobaocdn.net/imgextra/i3/2024098454/TB2C4VXXXXXXXc1XXXXXXXXXXXX_!!2024098454.jpg"}
    sub_tc_order_id:123456

垂直业务定制流程

签证业务

对接注意事项:由于飞猪平台于2018年初 对签证业务进行了一次升级改版,商家在对接签证业务前请务必明确该笔订单是新版签证订单还是旧版签证订单,具体判断方法如下:商家在得知订单号的情况下,使用alitrip.travel.trade.query这个接口获取该订单详情,在返回结果中有个商品类目扩展信息字段(category_ext_infos),该字段中有个标识是否新版签证订单的key(isNewVisa),如果isNewVisa为true则需要使用新版签证订单履行流程,否则需要使用旧版签证订单履行流程

旧版签证订单 履行流程详见:签证申请人进度管理(旧)

新版签证订单 履行流程详见:签证申请人进度管理(新)

接送机直连对接业务

接送机直连对接业务 订单履行流程详见:接送机用车状态同步

门票业务(快速退款)

该业务适用于码商对接门票退款业务,用于码商获取门票退款信息和同步门票退款进度。业务实现流程图如下:

image

开放的接口都需要授权,请联系对应的小二,开放接口如下:

FAQ

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