度假日历品解决方案

收藏

我的收藏

业务介绍

场景简介

日历品：选择日期固定价格、明确使用用户后下订；当前仅支持酒景套餐类商品

可参考以下商品类型差异：
••预售券：支持用户“先买券，后预约使用”，是方便用户囤货和商家卖货的一种商品类型
••团购券：用户购买后直接去商家核销使用，无需预约（旅行社行业暂不支持）

当前支持类目：

一级	二级		三级
住宿	境内酒景套餐	8005000	境内酒店套餐	8005001	仅可发布至少包含酒店住宿及景点门票元素的中国大陆境内城市周边玩乐套餐商品，但不得包含跨城交通。本类目不允许发布日游、跟团游等含行程安排的包价游商品。
	境外酒景套餐	8006000	境外酒景套餐（不含港澳）	8006001	仅可发布境外（不含港澳）同时含有酒店住宿及景点门票元素的周边玩乐套餐商品，不得包含跨城交通，司导服务等服务及体验项目等其他元素。
	境外酒景套餐	8006000	港澳酒景套餐	8006002	仅可发布港澳同时含有酒店住宿及景点门票元素的周边玩乐套餐商品，不得包含跨城交通，司导服务等服务及体验项目等其他元素。（可发布包含单港澳酒景套餐商品，也可以发布大陆境内+港澳的酒景套餐商品）

接入流程

接入前准备

根据以下文档完成开发者账号开通认证、生活服务应用的创建、研发基础配置和测试验收。

开通认证开发者账号、创建生活服务应用

•

技术服务商：技术服务商接入指南

•

自研：自研商家接入指南

开发基础配置和测试验收

•

根据开发者接入指南进行各类基础配置和测试验收

https://developer.open-douyin.com/docs/resource/zh-CN/local-life/connect/partner/basic-config/dev-info

业务对接流程

时序图

接口清单

能力	是否必接	接口文档	描述
旅行社poi查询	必须对接	查询订单商品快照的poi	三方系统查询抖音创建的订单所关联商品的poi信息，内部自行匹配后在消费凭证中返回对应的poiid
旅行社日历品价量态操作	建议对接	旅行社日历品价量态信息同步	商家在来客后台创建商品成功后，通过接口调整日历套餐的价格库存信息最大日期范围不超过当天起360天（含）价库实时生效，无需审核
	建议对接	日历品商品价量态信息查询	商家在来客后台创建商品成功后，可以通过接口查询到商品基础信息、商品状态以及价格库存信息；查询范围 360 天内；仅返回可售日期+不可售日期且已设置价库的日期
	建议对接	日历套餐价库信息拉取更新（SPI）	商家在来客后台创建商品成功后，通过接口调整日历套餐的价格库存信息
旅行社日历品操作	建议对接	日历商品操作上下架	•下架操作：商品为“上架”“审核中”状态时可进行下架操作，其他状态返回失败•返回信息：商品当前状态未生效，无需重复操作•需要校验商品归属于当前商家，如果不属于则拒绝请求•返回信息：当前商品ID无效，请检查后重试•仅可设置旅行社商品且为直连商品•支持批量，单次最多10个商品
旅行社日历品操作	建议对接	商品审核结果通知（webhook）	商家在来客后台提交商品审核，或通过直连操作修改价格库存信息并审核通过时，抖音侧推送至商家
旅行社日历品行业交易商家接单	必须对接	旅行社日历套餐接单	抖音侧通知第三方支付成功后，第三方需要在商品上单中设置的接单时间内通知抖音侧接单结果，超时会拒单。采用异步确认。
旅行社日历品行业交易可定检查	必须对接	可定检查（SPI）	用于可定检查。当且仅当明确告知可定检查失败时拒绝用户下单，其余情况默认放行
旅行社日历品行业交易创建订单	必须对接	旅行社日历品行业交易创建订单	用户下单后，抖音侧调用第三方创建旅行社日历套餐订单
旅行社日历品行业交易支付结果通知	非一步订单必须对接	旅行社日历品行业交易支付结果通知	抖音侧通知第三方支付成功。供应商交易模式为支付后创单的情况下抖音不会调用该 spi
旅行社日历品行业交易退款成功通知	必须对接	日历品行业交易订单退款结果通知（SPI）	订单退款时，抖音侧通知三方系统退款结果。当订单退款时，如果订单中没有第三方订单号，则无需通知三方系统
旅行社日历品-订单取消通知	必须对接	旅行社日历品订单取消	用于预售订单/预约单取消时，抖音侧通知三方系统取消订单
KA核销对账		账单详细查询	商家通过接口查询自己账单详情。

常见问题