预约创单（SPI）

我的收藏

接口介绍

POST方法

用户发起预约，抖音侧调用第三方服务商接口创建景区的预约单，务必按照错误码规范返回错误码，如果遇到需要重试的错误码，抖音侧会进行12次重试，每次间隔1分钟。如果最终失败，抖音侧会执行取消预约流程，并通知三方。

基本信息

Scope	life.capacity.trip_order_create
权限要求	景区行业解决方案-景区创建订单
回调场景	景区创建订单

请求参数

参数名称	参数类型	是否必填	是否加密	参数描述
order_id	string	是	否	抖音订单 ID，biz_type=1 时表示券订单 ID，biz_type=3 时表示预约订单 ID
source_order_id	string	否	否	抖音券订单ID，biz_type=1时无需关注，biz_type=3时代表券订单ID
poi_id	string	否	否	抖音 POI_ID（即门店id）
product_id	string	是	否	抖音的商品ID，预售品ID
product_out_id	string	否	否	第三方商品ID，预售品ID
sku_id	string	是	否	抖音商品规格ID
~~sku_out_id~~	~~string~~	否	否	~~外部商品规格ID~~
biz_type	int32	是	否	业务类型：1-团购，2-日历票，3-团购在线预约
order_type	int32	是	否	订单类型：1-券订单，2-预约订单（biz_type=1时，order_type=1；biz_type=2时，order_type=2；biz_type=3时，order_type=1或2）
remark	string	否	否	备注要求
amount	struct	是	否	购券订单金额信息
- origin_amount	int64	是	否	原始金额，单位分
- pay_amount	int64	是	否	用户支付金额，单位分
currency	string	是	否	货币类型(默认人民币CNY)
create_order_time_unix	int64	是	否	订单创建时间时间戳（秒）
count	int32	否	否	预约份数
traveler_info	object	否	否	出行人群（对应商品 crowds）
-total_num	int32	是	否	出行人数
-diff_target_crowd	bool	是	否	是否区分人群
-crowd_list	list	否	否	人群列表
--crowd_type	int32	是	否	人群类型 Child=1 儿童 Adult=2 成人 Old=3 老人Student=4 学生Special=5 特殊人群Male=6 男士Female=7 女士Group=8 团体Couple=9 情侣Military = 10 军人 Teacher = 11 教师 Disabled = 12 残疾
--traveler_num	int32	是	否	此人群的适用人数
buyer	struct	否	否	联系人信息
- name	string	否	是	姓名
- phone	string	否	是	联系电话
tourists	list<struct>	否	否	游玩团购线下预约场景选填，线上预约场景预约时留资信息必填
- name	string	否	是	姓名，加密
- phone	string	否	是	联系电话，加密
- license_type	int	否	否	证件类型1 身份证2 港澳通行证3 台湾通行证4 回乡证5 台胞证6 护照
- license_id	string	否	否	证件 ID，加密
- en_first_name	string	否	否	英文名first name
- en_last_name	string	否	否	英文名last name
- email	string	否	否	电子邮箱
traveler_info	object	否	否	出行人群（对应商品 crowds）
-total_num	int32	是	否	出行人数
-diff_target_crowd	bool	是	否	是否区分人群
-crowd_list	list	否	否	人群列表
--crowd_type	int32	是	否	人群类型 Child=1 儿童 Adult=2 成人 Old=3 老人Student=4 学生Special=5 特殊人群Male=6 男士Female=7 女士Group=8 团体Couple=9 情侣Military = 10 军人 Teacher = 11 教师 Disabled = 12 残疾
--traveler_num	int32	是	否	此人群的适用人数
appointment_rule	object	否	否	预约规则（线上预约时返回）
- ahead_day	int32	否	否	需要提前X天预约
- ahead_sec	int64	否	否	预约提前时间（单位：秒）. i.e. 20:00点前预约，值为 72000
- part_appointment	bool	否	否	是否支持分开预约
- open_time_period	object	否	否	日开放预约时间
-- start_time	string	否	否	起始时间
-- end_time	string	否	否	结束时间
appointment_cancel_rule	object	否	否	预约取消规则
- cancel_type	int32	否	否	取消类型，2 不可取消，4 限时取消（按规则），5 未用随时取消
- cancel_detail_list	list<object>	否	否	取消规则明细
-- max_cancel_time	object	否	否	最晚取消时间
--- day	int32	否	否	天
--- hour	int32	否	否	小时
--- minute	int32	否	否	分
ticket_rule	struct	否	否	票务规则，包含凭证方式、券码类型、券码服务商
- code_sending_info	list<int32>	是	否	凭证发放方式，多选（建议全部写入list，凭证回调时，如果有额外类型的凭证会报错） 1 身份证件 2 券号 3 券码 6 链接URL
- code_type	int32	是	否	券码类型，日历票 code_type = 2
- url_type	int32	否	否	如果code_sending_info=6 凭证类型为url，则必填
ticket_specification	struct	否	否	预约下单参数，票种规格说明
- ticket_session	struct	否	否	场次
-- ticket_session_name	string	是	否	名称
-- ticket_session_time	string	否	否	时间
- ticket_seat	string	否	否	坐席
- ticket_area	string	否	否	区域
book_start_day	string	否	否	预定开始日期，yyyy-MM-dd，biz_type=2时，预约订单返回
book_start_end	string	否	否	预定结束日期，yyyy-MM-dd，biz_type=2时，预约订单返回

响应参数

参数名称	参数类型	是否必填	参数描述
data	struct	是
.error_code	int32	是	失败错误码，失败必填
.description	string	否	失败原因
.order_out_id	string	是	第三方预约订单号，成功情况下必填
.confirm_info	struct	是	确认接单信息，成功情况下必填
..confirm_mode	int	是	接单模式，1 同步接单，2 异步接单
..confirm_result	int	否	接单结果，同步接单时必填，1 接单，2 拒单

错误码说明

错误码	描述
0	成功
1	库存不足
2	商品已下架
3	当前出行人已购票
4	当前日期未开放预定
5	出行人年龄不在可订范围内
6	出行人性别不在可订范围内
100	抖音侧需要重试，其他错误码抖音不重试
999999	其他原因下单失败，抖音不重试