首页文档中心关于API接入指南

1、申请加入

流程 申请加入
发起方 供应商
说明 1、填写供应商对接申请表(供应商系统对接申请表.docx),提供公司名称、联系人、联系方式(手机、qq),其他信息(如优势产品,技术平台,是否有NBooking账号等),并邮件发送openapi@tuniu.com
2、途牛收到申请后,7个工作日内予以答复。

2、资质审核

流程 资质审核
发起方 途牛
说明 途牛商务专员联系供应商做资质准入沟通(电话、IM等),并引导供应商完成准入,准入完成后分配供应商编号;
备注 1、如供应商已完成准入(已有供应商编号),略过此步骤,直接进入步骤三"需求开发";
2、如第三方技术平台需要接入途牛API,可略过此步骤,直接进入步骤三"需求开发";

3、需求开发

流程 需求开发
发起方 供应商
说明 1、供应商安排技术人员和业务人员,核对双方业务模型,分析途牛接口说明及开发文档(参考:跟团API),整理对接需求;
2、供应商技术人员根据对接需求进行功能开发,并进行内部测试;
3、途牛通过QQ群/电话会议/当面沟通等方式,负责解答供应商需求开发中的对接问题(仅限于业务、API接口相关问题);
4、供应商完成内部测试,且需要途牛配合线上联调的,需要提前7天,申请信息请提供:
     供应商系统对接联调申请表.docx
供应商id 7788
ip地址 192.168.1.1,192.168.1.2,192.168.1.3
操作反馈地址 url0
询位调用地址 url1
占位调用地址 url2
共享库存确认调用地址 url4
控位库存确认调用地址 url5
单房差变更地址 url6
5、邮件请发:openapi@tuniu.com,途牛收到申请后,将在两天内答复联调时间和配合联调人员。

4、发布上线

流程 发布上线
发起方 供应商
说明 1、联调完成之后,填写《供应商系统对接上线申请表.docx》并发送到openapi@tuniu.com
2、途牛收到上线申请后,与双方业务人员、技术人员约定上线时间、上线步骤;
3、如需试运行,则准备用于验证产品(试运行的产品和持续时间双方协商);
4、试运行结束后,推广到所有产品;
5、上线后双方观察业务运行情况
发布时间 2016-10-08
影响范围 控位库存确认单和共享库存确认单
内容

确认单新增字段scheme,非必填,默认为空。此字段展示供应商升级方案编号,如为空,则对应基础方案。


发布时间 2016-06-03
影响范围 跟团的产品管理、订单管理
内容

1、4.1.4 共享库存占位接口:
新增币种字段costCurrencyType,非必填,默认是人民币,支持15种币种,用于区分供应商与途牛的结算币种。
2、4.2.3 共享库存确认单接口:
新增币种字段costCurrencyType,非必填,默认是人民币,支持15种币种,用于区分供应商与途牛的结算币种。
3、4.3.3 控位库存确认单接口:
新增币种字段costCurrencyType,非必填,默认是人民币,支持15种币种,用于区分供应商与途牛的结算币种。
4、4.4.3 占位单房差变更接口
新增币种字段costCurrencyType,非必填,默认是人民币,支持15种币种,用于区分供应商与途牛的结算币种。
5、5.3.1产品基础信息接口:
新增是否默认行程字段,isDefault,1:是默认行程 0:不是。此字段用于区分当前推送的产品行程是否为默认行程(一个产品只有一个默认行程,且不可更换,如需要变更默认行程,请推送新的产品),新增供应商基本产品编号字段,productBaseScheduleId,如果isDefault为0,为必填项。此字段用于关联途牛产品行程与供应商产品,请务必填写此信息,否则后续订单等流程将会。新增行程排序字段,tripNum,非必填项,默认行程默认为0,其他行程为1,2,3等等。此字段用于控制途牛产品页面上行程的展示顺序,如不填写,将按照录入顺序展示。
6、5.3.13签证信息接口:
落地签费类型拆分。原有的落地签证对应落地签费/人(现付),添加“落地签费/人(预付)”。
7、5.3.39团期价格信息接口:
新增适用行程字段,applyFlag,1:适用 0:不适用。一个产品同一个团期只允许一个行程售卖,可通过这个字段控制产品指定团期的行程是否可以售卖,
新增适用机位定金,seatDeposit,出境线路存在此字段,且必填。


1、名词解释

序号 名词 说明
1 供应商ERP系统 供应商用于维护产品信息、库存、订单、财务等信息的管理软件,是系统对接的承载体
2 途牛产品 用于在途牛网站(www.tuniu.com)上可售卖的基本单位,含产品信息、团期信息、库存信息等
3 途牛库存划分 途牛库存共分为三类:
控位库存:途牛从供应商控位过来的库存,由途牛维护。此类库存已经卖断给途牛,只允许途牛使用。
共享库存:由供应商维护,目前支持在NB上手工维护。从此渠道上的库存,需要确认途牛使用时有位子。可在NB库存看板中查看库存使用情况。
虚拟共享库存:由供应商维护,仅用于展示供应商单签库存余位数。
4 清位时间 供应商给途牛位置保留的最大时间,超过时限将自动释放。
5 多行程 多行程是指一个产品下可添加多个不同团期的相似跟团资源。

2、基本流程

3、产品信息管理接口

名称 描述
接口名称 产品信息管理接口
接口归属 产品流程
接口方式 同步
接口依赖 产品操作信息反馈接口
前置要求
流程
接口说明 1、供应商产品维护人员在供应商ERP系统创建新产品,并维护产品信息,可将供应商产品推送到途牛API系统,支持新增或者修改
2、供应商ERP系统将供应商产品信息转换为途牛产品信息,途牛产品信息内容定义包括:产品基本信息、推荐信息、重要信息、费用包含信息、发车信息、费用包含、费用不包含、特殊人群限制、活动推荐、预定须知(详细字段对应关系可参考API接口定义或者查看NBooking系统的新跟团产品各展示页,NBooking传送门:www.tuniu.cn
3、途牛API系统接收到供应商产品信息后,会对各字段格式进行检查:
    1)如有格式问题,则反馈供应商erp系统异常,流程结束。异常定义传送门:open.tuniu.cn。
    2)如没有问题,则反馈供应商erp系统,通过校验,并将供应商产品信息转入内部系统进行处理。
4、途牛系统内部完成数据处理后,通过产品操作信息反馈接口,推送处理结果。处理结果定义传送门:open.tuniu.cn。
5、途牛维护途牛资源编号、供应商产品编号对应关系(后续产品更新、团期维护、库存管理、订单流程均基于此关系)
注意事项-供应商产品与途牛产品对对应关系 1、一个途牛产品对应多个途牛资源,每个资源对应一个供应商产品
2、一个途牛产品对应多个供应商产品

               (图示:供应商产品与途牛产品的对应关系)
注意事项-途牛产品、多行程、供应商产品对应关系 1、一个途牛产品可包括多个行程,每个行程对应一个途牛资源;
2、每个行程对应一个供应商产品;
3、一个途牛产品必须存在默认行程;
4、每个多行程必须指定对应的默认行程,才能将此行程挂在对应的途牛产品上。

                         (图示:途牛产品、行程、与供应商产品的对应关系)

4、行程信息管理

名称 描述
接口名称 行程信息管理
接口归属 产品流程
接口方式 同步
接口依赖 产品信息接口,产品操作信息反馈接口
前置要求 已推送产品信息
流程
接口说明 1、供应商产品维护人员在供应商ERP系统维护行程信息,并供应商产品行程信息推送到途牛API系统;
2、供应商ERP系统将供应商行程信息转换为途牛行程信息,途牛产品信息内容定义包括:行程安排、交通等(详细字段对应关系可参考API接口定义或者查看
NBooking系统的新跟团产品线路行程展示页,NBooking传送门:www.tuniu.cn
3、途牛API系统接收到供应商产品信息后,会对各字段格式进行检查:
    1)如有格式问题,则反馈供应商erp系统异常,流程结束。异常定义传送门:open.tuniu.cn
    2)如没有问题,则反馈供应商erp系统,通过校验,并将供应商产品行程信息转入内部系统进行处理。
4、途牛系统内部完成数据处理后,通过产品操作信息反馈接口,推送处理结果。处理结果定义传送门:open.tuniu.cn
注意事项

5、新增升级方案信息

名称 描述
接口名称 新增升级方案信息
接口归属 产品流程
接口方式 同步
接口依赖 产品信息管理,产品操作信息反馈接口
前置要求 已推送产品信息
流程图
接口说明 1、供应商产品维护人员在供应商ERP系统维护产品的升级方案信息,并将供应商产品升级方案推送到途牛API系统;
2、供应商ERP系统将供应商行程信息转换为途牛升级方案信息,途牛升级方案信息内容定义包括:升级内容、备注信息等(详细字段对应关系可参考API接口定义或者查看NBooking系统的新跟团产品升级方案展示页,NBooking传送门:www.tuniu.cn
3、途牛API系统接收到供应商升级方案信息后,会对各字段格式进行检查:
    1)如有格式问题,则反馈供应商erp系统异常,流程结束。异常定义传送门:open.tuniu.cn
    2)如没有问题,则反馈供应商erp系统,通过校验,并将供应商升级方案信息转入内部系统进行处理。
4、途牛系统内部完成数据处理后,通过产品操作信息反馈接口,推送处理结果。处理结果定义传送门:open.tuniu.cn
注意事项                                                             (图示:升级方案模型关系)

6、修改升级方案信息

名称 描述
接口名称 修改升级方案信息
接口归属 产品流程
接口方式 同步
接口依赖 产品信息管理,新增升级方案信息,产品操作信息反馈接口
前置要求 已提送产品信息、已推送升级方案
流程图
接口说明 1、供应商产品维护人员在供应商ERP系统维护升级方案信息,并变更后的升级方案信息推送到途牛API系统;
2、供应商ERP系统将供应商行程信息转换为途牛升级方案信息,途牛升级方案信息内容定义包括:行程安排、交通等(详细字段对应关系可参考API接口定义或者查看NBooking系统的新跟团产品线路行程展示页,NBooking传送门:www.tuniu.cn
3、途牛API系统接收到供应商升级方案信息后,会对各字段格式进行检查:
.    1)如有格式问题,则反馈供应商erp系统异常,流程结束。异常定义传送门:open.tuniu.cn
     2)如没有问题,则检查升级方案是否存在
        (1)如不存在,则通过产品操作反馈接口通知供应商修改失败。
        (2)若存在,则将供应商产品升级方案信息转入内部系统进行处理。
4、途牛系统内部完成数据处理后,通过产品操作信息反馈接口,推送处理结果。处理结果定义传送门:open.tuniu.cn
注意事项

7、团期信息维护接口

名称 描述
接口名称 团期信息管理
接口归属 产品信息管理,新增升级方案信息(存在升级方案则依赖),产品操作信息反馈接口
接口方式 同步
接口依赖 产品信息管理,新增升级方案信息(存在升级方案则依赖),产品操作信息反馈接口
前置要求 已推送产品信息,【已推送升级方案信息】
流程图
接口说明 1、供应商产品维护人员在供应商ERP系统中维护团期信息,并将团期行程信息推送到途牛API系统;
2、供应商ERP系统将供应商团期信息转换为途牛团期信息,途牛团期信息字段对应关系可参考API接口定义或者查看NBooking系统的新跟团产品线路团期展示页,NBooking传送门:www.tuniu.cn
3、途牛API系统接收到供应商团期信息后,会对各字段格式进行检查:
    如有格式问题,则反馈供应商erp系统异常,流程结束。异常定义传送门:open.tuniu.cn
    2)如没有问题,则反馈供应商erp系统,通过校验,并将供应商产品行程信息转入内部系统进行处理。
4、途牛系统内部完成数据处理后,通过产品操作信息反馈接口,推送处理结果。处理结果定义传送门:open.tuniu.cn
注意事项 1、可通过配置适用行程(applyFlag字段)来控制当前产品在售行程。
2、新增或者修改团期信息需要审核。

8、打开团期接口

名称 描述
接口名称 打开团期
接口归属 产品流程
接口方式 同步
接口依赖 产品操作信息反馈接口
前置要求 已推送产品信息,【已推送升级方案信息】
流程图
接口说明 1、供应商产品人员在供应商ERP系统中维护团期,打开团期请求推送到途牛API系统;
2、途牛API系统接收到供应商打开团期请求后,会对各字段格式进行检查:
    1)如有格式问题,则反馈供应商erp系统异常,流程结束。异常定义传送门:open.tuniu.cn
    2)如没有问题,则反馈供应商erp系统,通过校验,并将供应商产品行程信息转入内部系统进行处理。
3、途牛系统内部完成数据处理后,通过产品操作信息反馈接口,推送处理结果。处理结果定义传送门:open.tuniu.cn。
注意事项 1、如需打开某个行程的团期,请务必确认此行程在该团期是否可售卖(团期报价接口的applyFlag字段为0)。否则将会出现团期即使打开,也无法售卖的情况。
2、打开团期无需审核。

9、关闭团期接口

名称 描述
接口名称 关闭团期
接口归属 产品流程
接口方式 同步
接口依赖 已推送产品信息,【已推送升级方案信息】
前置要求 已推送产品信息,【已推送升级方案信息】
流程图
接口说明 1、供应商产品人员在供应商ERP系统中维护团期,关闭团期请求推送到途牛API系统;或者供应商ERP系统无库存后,自动推送关闭团期请求;
2、途牛API系统接收到供应商关闭团期请求后,会对各字段格式进行检查:
    1)如有格式问题,则反馈供应商erp系统异常,流程结束。异常定义传送门:open.tuniu.cn。
    2)如没有问题,则反馈供应商erp系统,通过校验,并将供应商产品行程信息转入内部系统进行处理。
3、途牛系统内部完成数据处理后,通过产品操作信息反馈接口,推送处理结果。处理结果定义传送门:open.tuniu.cn。
注意事项 1、过期团期自动关闭。
2、关闭团期无需审核。
3、支持关闭基本方案或升级方案,基本行程或多行程的团期

10、库存管理接口

名称 描述
接口名称 库存管理-修改库存
接口归属 产品流程
接口方式 同步
接口依赖 产品信息管理,新增升级方案信息(存在升级方案则依赖),团期信息,产品操作信息反馈接口
前置要求 已推送产品信息,已推送升级方案信息,【已推送升级方案信息】
流程图
接口说明 1、供应商产品维护人员在供应商ERP系统维护库存数量,并将库存余位推送到途牛API系统;或者系统自动监控库存余位,出现库存变动自动推送到途牛API系统;
2、途牛库存信息内容定义包括:行程安排、交通等(详细字段对应关系可参考API接口定义或者查看NBooking系统的新跟团产品线路行程展示页,NBooking传送门:www.tuniu.cn。
3、途牛API系统接收到供应商库存信息后,会对各字段格式进行检查:
    1)如有格式问题,则反馈供应商erp系统异常,流程结束。异常定义传送门:open.tuniu.cn。
    2)如没有问题,则反馈供应商erp系统,通过校验,并将供应商库存信息转入内部系统进行处理。
4、途牛系统内部完成数据处理后,通过产品操作信息反馈接口,推送处理结果。处理结果定义传送门:open.tuniu.cn。
注意事项 1、途牛只接收供应商全量库存,不支持增量变更;
2、途牛只接收共享库存推送,不接收切位库存(切位库存走协议);
3、建议出现库存余位变动,立即推送最新的库存余位到途牛。

11、产品操作信息反馈接口

名称 描述
接口名称 产品操作信息反馈接口
接口归属 产品流程
接口方式 异步
接口依赖 产品信息管理、行程信息管理、新增升级方案信息、修改升级方案信息、团期信息管理、打开团期、关闭团期、库存管理、点评信息
接口说明 1、供应商提供接口,途牛推送反馈信息;
注意事项 1、产品、团期、库存信息在途牛内部都为异步处理,此接口可推送最终处理结果给供应商。
2、此接口实现9大接口的反馈信息,公用一个回调地址

12、产品审核状态查询

名称 描述
接口名称 产品审核状态查询
接口归属 产品流程
接口方式 同步
接口依赖
流程图
接口说明 1、供应商系统查询推送到途牛的产品状态,支持查询审核状态、上线状态。
注意事项 1、支持批量查询

1、名词解释

序号 名词 说明
1 供应商ERP系统 供应商用于维护产品信息、库存、订单、财务等信息的管理软件,是系统对接的承载体
2 途牛产品 用于在途牛网站(www.tuniu.com)上可售卖的基本单位,含产品信息、团期信息、库存信息等
3 途牛库存划分 途牛库存共分为三类:
控位库存:途牛从供应商控位过来的库存,由途牛维护。此类库存已经卖断给途牛,只允许途牛使用。
共享库存:由供应商维护,目前支持在NB上手工维护。从此渠道上的库存,需要确认途牛使用时有位子。可在NB库存看板中查看库存使用情况。
虚拟共享库存:由供应商维护,仅用于展示供应商单签库存余位数。
4 清位时间 供应商给途牛位置保留的最大时间,超过时限将自动释放。
5 多行程 多行程是指一个产品下可添加多个不同团期的相似跟团资源。

2、基本流程

3、共享库存占位

名称 描述
接口名称 共享库存占位
接口归属 订单流程
接口方式 同步
接口依赖
前置要求 完成占位
流程图
接口说明 1、客人通过客服下单或者在线下单。
2、途牛下单到供应商ERP系统,带入需求号,订单号,和客人需要的产品id,团期,所需成人数、儿童数、单房差数量,参考金额
3、供应商根据实际情况反馈是否满足,如:
   1)、无库存,则反馈不满足
   2)、有库存,则反馈最新的价格(结算价),最大保留时间(清位时间),供应商erp系统订单号
注意事项 1、客人可能在同一个订单下,发起多次占位。比如第一次决定要出游3人,会发起3人的占位,第二次又新增2人出游,会再发起2人的占位。可根据需求号+订单号区分多次占位请求。需要供应商支持此种场景。
2、到供应商ERP系统占位时只有成人儿童数,没有详细的游客信息。游客信息在确认时提供。
3、占位反馈的清位时间,建议放长到24小时+。(客人有可能订购其他资源或者不能及时付款)
4、途牛控位库存占位不会到供应商ERP系统下单。(控位库存已经买断,供应商应该保留,故不需要下单,只需要确认即可)
s 5、途牛与供应商结算的价格,是按照供应商反馈的价格进行结算。(此处需注意:控位库存按照采购的金额结算,占位供应商共享库存按照反馈的价格进行结算)

4、共享库存占位(取消占位)

名称 描述
接口名称 共享库存占位(取消占位)
接口归属 订单流程
接口方式 同步
接口依赖
流程图
接口说明 1、客人取消行程或者超时没有付款,途牛发起取消订单流程。
2、途牛到供应商ERP系统取消原订单,带入需求号,订单号,取消标记,对应占位单的产品id,团期,成人数、儿童数、单房差数量,占位金额。
3、供应商根据需求号,订单号,取消标记,完成位置取消。
注意事项 1、客人多次占位,取消时也会发起多次取消。
2、不支持一次占位部分取消的情况。比如一次占位5个人,不支持取消其中2人,如果要取消,那么就将5人全部取消。
3、如果途牛在清位时间内发起取消,不接收取消反馈失败。
4、取消占位的需求号、订单号和对应的占位单的需求号和订单号是一样的。占位游客信息、结算信息可以做校验

5、共享库存确认单

名称 描述
接口名称 共享库存确认单
接口归属 订单流程
接口方式 同步
接口依赖
前置要求 完成占位,客人签约付款
流程图
接口说明 1、客人完成签约付款后,途牛发起跟供应商的结算确认。
2、途牛到供应商ERP系统进行确认,带入需求号,订单号,客人订购的产品id,团期,成人数/价格、儿童数/价格、单房差数/价格,订单联系人信息,游客信息,产品信息(行程、费用包含、费用不包含),订单备注信息,占控位库存的数量。
3、供应商完成对确认单的确认后,反馈确认结果给途牛(人数正确,金额正确,信息完整的情况下,不允许反馈失败)。
注意事项 1、客人多次占位,确认时也会发起多次确认。
2、多次占位的订单经确认后,需要供应商在排团的时候,通过途牛订单号,将同一个订单的客人排到一个团中

6、控位库存确认单

名称 描述
接口名称 控位库存确认单
接口归属 订单流程
接口方式 同步
接口依赖
前置要求 完成占位,客人签约付款
流程图
接口说明 1、客人完成签约付款后,途牛发起跟供应商的结算确认。
2、途牛到供应商ERP系统进行确认,带入需求号,订单号,客人订购的产品id,团期,成人数/价格、儿童数/价格、单房差数/价格,订单联系人信息,游客信息,产品信息(行程、费用包含、费用不包含),订单备注信息,占控位库存的数量。
3、供应商完成对确认单的确认后,反馈确认结果给途牛(人数正确,金额正确,信息完整的情况下,不允许反馈失败)。
注意事项 1、客人多次占位,确认时也会发起多次确认,可通过需求号关联对应的占位单。
2、多次占位的订单经确认后,需要供应商在排团的时候,通过途牛订单号,将同一个订单的客人排到一个团中。
3、控位库存没有到供应商ERP系统发起确认,需要供应商支持此种场景

7、占位单房差变更

名称 描述
接口名称 占位单房差变更
接口归属 订单流程
接口方式 同步
接口依赖
前置要求 已发起占位,未完成签约
流程图
接口说明 1、客人完成占位后,如需修改单房差,途牛会到供应商系统中变更单房差数量。
2、途牛到供应商ERP系统发起单房差变更,带入需求号,订单号,客人订购的产品id,团期,成人数、儿童数、单房差数。
3、供应商完成对单房差数量的变更后,反馈确认结果给途牛(信息完整的情况下,不允许反馈失败)。
注意事项 1、客人可多次发起单房差变更,以最后一次变更为准。
2、如客人占位(非单房差)时,确认时会将单房差带入每个确认单中,供应商根据途牛订单号,只需要确定每张确认中的数量与单房差总数一致即可。(每张确认单中的单房差数量均与总数一致)
3、此接口重要,需实现。
Copyright © 2006-2016 南京途牛科技有限公司 Tuniu.cn | 营业执照 | 苏 ICP B2-20070191 旅游网
联系人:蒋建华 openapi@tuniu.com 联系号码:02586853969-61741