酒店预约修改订单
收藏接口说明
1.抖音侧调用第三方修改酒店订单，加密字段解密方法请参考：加密字段解密
2.订单修改信息通知，可修改内容都是基于创建订单接口内容进行修改同步，仅下发修改字段，未修改字段不下发，一旦结构体字段有修改，结构体字段内容全量下发。
3.小修改场景，商家需要在修改订单接口同步返回修改成功或失败的结果，接口响应超时时间为5s。
4.酒店修改能力需加白支持，请务必确认商家系统已支持订单修改并完成本接口调试验收
基本信息
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 |
