创建预约单

我的收藏

接口说明

三方对接请订单创单幂等：
•创单成功必须要返回out_book_id并维护好和book_id的幂等映射，超时会重试。研发请重点关注！！！
15min未接单则超时拒单

抖音侧调用第三方进行预约单创单,必接

基本信息

Scope	life.capacity.comprehensive_reserve_creater_order
权限要求	到综团购预约解决方案-综合预约订单创建
回调场景	综合预约品订单到三方进行创建

Header

•

Content-Type：application/json

•

X-Bytedance-Logid: 请求 logid，用于问题排查用

•

x-life-clientkey: 服务商应用的 client_key

•

X-life-sign: 请求签名，签名规则

Body

字段名称	字段类型	是否必传	说明
book_id	string	是	抖音预约单ID
product_info	list<object>	否	商品信息
» sku_id	string	否	抖音sku_id
» out_sku_id	string	否	外部sku_id
» sku_name	string	否	商品名称
» original_amount	int	否	商品售卖价(分)
» source_sku_id	string	否	来源商品id
» source_sku_name	string	否	来源商品名称
» out_source_sku_id	string	否	来源商品三方SkuID
» out_source_product_id	string	否	来源商品三方商品Id
» item_infos	list<object>	否	关联的itemInfos
»»item_id	string	否	关联itemId
»»certificate_code	string	否	对应的三方码code
user_infos	list<object>	否	用户留资信息
» name	string	否	姓名(加密)
» phone	string	否	手机号（加密）
» license_type	int	否	证件类型（体检类目商家加白名单）
» license_id	string	否	证件号（加密）（体检类目商家加白名单）
» age	int	否	年龄（体检类目商家加白名单）
» sex	int	否	性别(1:男，2:女)（体检类目商家加白名单）
» marital_status	int	否	婚否(1:已婚，2：未婚)（体检类目商家加白名单）
book_info	object	是	用户预约信息
» booking_start_time	string	是	预约开始时间（毫秒时间戳）
» booking_end_time	string	是	预约结束时间（毫秒时间戳）
poi_id	string	是	预约门店id
count	int	是	用户预约数量
user_notes	string	否	用户备注

JSON示例

{
        "poi_id": "7403292379249117235",
        "book_id": "800009321452854118616346113",
        "book_info": {
                "booking_end_time": "1724688000000",
                "booking_start_time": "1724601600000"
        },
        "user_infos": [{
                "sex": 1,
                "phone": "1111111111",
                "license_id": "1111111111",
                "license_type": 1,
                "age": 25,
                "name": "11111111",
                "marital_status": 1
        }],
        "product_info": [{
                "sku_id": "1111111111111",
                "sku_name": "接待单元",
                "item_infos": [{
                        "item_id": "800009360301489945813166113",
                        "certificate_code": "0010922222631532"
                }],
                "original_amount": 0
        }],
        "count": 1
}

响应

字段名称	字段类型	是否必传	说明
book_id	string	是	抖音预约单ID
out_book_id	string	是	商家/服务商预约单ID
error_code	int	是	是否创建成功
description	string	否	创建不成功原因(当返回不成功时，该字段必传)
confirm_info	object	否	交易模式信息供应商在交易模式为一步创单模式该对象必须返回，否则会导致订单取消
»confirm_mode	int	否	接单方式(在confirm_info对象有返回的时候必填，通过后接单方式，1：同步接单，2：异步接单)
»confirm_result	int	否	接单方式为同步接单时必填交易模式(同步时必填：1：接单，2：拒单)
»fulfil_type	int	否	核销方式：（1-身份证、2-护照、3-港澳通行证、4-台湾通行证、5-台胞证、6-回乡证）

JSON示例

{
        "data": {
                "error_code": 0,
                "book_id": "11",
                "out_book_id": "1111111111",
                "confirm_info": {
                        "confirm_mode": 2,
                        "confirm_result": 1,
                        "fulfil_type": 2
                }
        }
}

失败原因枚举：

error_code	失败原因
0	成功
1	商品不存在/失效
2	预约时间格式错误
3	姓名/联系电话格式错误
4	重复提交预约请求
5	订单不存在或状态异常
6	购买该产品必须填写身份证号码
7	库存异常
8	价格异常
17	其他异常（服务商自定义）
100	需要重试