生活服务商家应用 OpenAPI SDK 总览

OpenAPI

接入前准备

通用接口

餐饮

大交通

酒旅

会员通手机号格式说明&国家区号拆分能力

酒店通用错误码

酒店行业日历房解决方案

酒店日历房常见枚举值列表

酒店静态信息匹配/创建/更新能力

酒店静态信息自助获取能力

物理房型静态信息匹配/创建/更新

营销规则价格推送

物理房型上下架能力

主动拉取价量态

营销价量态拉取

营销规则推送

营销库存推送

日历房线上开票

日历房上下架能力

营销规则价格模式推送

营销查询

入住/离店状态同步能力

日历房交易正向

酒店会员管理

日历房交易逆向

售卖房型创建/更新能力

物理房型静态信息自助获取能力

房价/房态/房量更新

代理商-酒店静态信息自助获取

酒店账单详情查询

酒店行业新预售券解决方案

度假行业解决方案

景区行业日历票解决方案

景区团购（在线预约）

景区团购三方码方案

景区行业团购|在线预约解决方案

综合

历史版本文档（不推荐）

酒店修改订单

我的收藏

接口说明

抖音侧调用第三方修改酒店订单，加密字段解密方法请参考：加密字段解密

订单修改信息通知，可修改内容都是基于创建订单接口内容进行修改同步，仅下发修改字段，未修改字段不下发，一旦结构体字段有修改，结构体字段内容全量下发。

小修改场景，商家需要在修改订单接口同步返回修改成功或失败的结果，接口响应超时时间为5s。

酒店修改能力需加白支持，请务必确认商家系统已支持订单修改并完成本接口调试验收

基本信息

Scope	hotel_spot.order.modify_order
权限要求	酒店日历房解决方案-日历房正向交易
回调场景	酒店修改订单

请求头

•Content-Type：application/json

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

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

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

请求体

req

参数名称	参数类型	必须参数	备注
» order_id	string	必填	抖音订单id
» source_order_id	string	选填	预售订单的order_id
» modify_type	int	必填	修改分类：1-小修改（顾客备注、入住人、联系人）；
» biz_type	int	必填	2012:酒店预约单 2021:日历房
» reservation_modify	object	必填	修改内容（根据用户实际修改内容增量下发）
»» contact_info	object	选填	联系人信息
»»» name	string	选填	姓名(可能为"")
»»» phone	string	必填	联系电话，加密
»» occupancies	object	选填	入住人列表
»»» first_name	string	选填	名
»»» last_name	string	选填	姓
»»» name	string	选填	姓名
»»» phone	string	必填	联系电话，加密 (可能为"")
»»» license_type	int	选填	1 -身份证 2-港澳通行证 3-台湾通行证 4-回乡证 5-台胞证 6-护照,7-外籍护照,8-外国人永久居留证,9-港澳台居民居住证,10-中华人民共和国旅行证
»»» license_id	string	选填	证件 ID，加密
»»»sex	int	选填	1:男，2：女
»»»birthday	string	选填	出生日期，格式 yyyy-MM-dd
»»»license_validity	string	选填	证件有效期，格式 yyyy-MM-dd，当证件类型不为身份证时，该字段必填
»» remark_from_guest	string	选填	顾客备注（需要加白支持）

请求示例

//示例1:
{
        "order_id": "109001******47043",
        "source_order_id": "",
        "modify_type": 1,
        "biz_type": 2021,
        "reservation_modify": {
                "remark_from_guest": "靠近电梯，安静，我在改一次试试"
        }
}
//示例2:
{
        "order_id": "109001******67043",
        "source_order_id": "",
        "modify_id": "800012******7526617747043",
        "modify_type": 1,
        "biz_type": 2021,
        "reservation_modify": {
                "contact_info": {
                        "name": "",
                        "phone": "182******12"
                }
        }
}
//示例3:
{
        "order_id": "109001******67043",
        "source_order_id": "",
        "modify_id": "800012******7347417197043",
        "modify_type": 1,
        "biz_type": 2021,
        "reservation_modify": {
                "occupancies": [{
                        "name": "郭xxxx",
                        "phone": "",
                        "license_id": ""
                }]
        }
}

响应参数

参数名称	参数类型	必须参数	备注
data	struct	必填
» error_code	int	必填	错误码见下文
» description	string	选填	描述信息
» modify_status	int	选填	1-同意修改，2-拒绝修改
» reason	string	选填	拒绝原因

响应示例

//成功示例
{
        "error_code": 0
        "description": "",
        "modify_status": 1,
        "reason": ""
}
//失败示例:
{
        "error_code": 2,
        "description": "入住总人数超过上限",
        "modify_status": 2,
        "reason": ""
}

错误码

枚举id	参数名称	备注
0	成功
1	房型不存在/失效
2	入住总人数超过上限
5	日期格式错误
6	姓名/联系电话格式错
9	订单不存在或状态异常
10	日期格式错误
11	手机号/证件号码已达到购买上限
12	购买该产品必须填写身份证号码
13	其他异常（服务商自定义）
14	会员信息不一致
15	订单已入住不可取消
60	订单状态不支持修改
61	顾客修改条件无法满足
62	酒店不支持修改
100	需要重试	三方如果需要重试传该code

上一篇：酒店日历房可订检查