# 接口说明
- 1.新接口
- 2.机票、酒店、火车的订单改签或退票通知，通知的内容是从分贝通退改的订单
- 3.请求地址需要对接方提供
| 名称 | 描述 |
|---|---|
| 请求方 | 分贝通 |
| 响应方 | 对接方 |
| 请求地址url | 对接方提供 |
| method | 对接方提供 |
| HTTP方法 | POST |
| Content-Type | application/json |
# 业务请求参数
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| apply_type | 申请单类型 | String | Y | 1：退订 2：改签 |
| apply | 申请单信息 | jsonObject | Y | |
| apply.id | 申请单id | String | Y | 57678687787 |
| apply.name | 申请单名称 | String | Y | 申请单名称 |
| apply.apply_reason | 退改原因 | String | N | 退改原因 |
| apply.remark | 退改原因补充说明 | String | N | 退改原因补充说明 |
| proposer | 申请人信息 | jsonObject | Y | 申请人信息 |
| proposer.id | 分贝通申请人ID | String | Y | 分贝通申请人ID |
| proposer.third_id | 三方系统申请人ID | String | N | 三方系统申请人ID |
| proposer.phone | 申请人手机号 | String | Y | 申请人手机号 |
| proposer.name | 申请人姓名 | String | Y | 申请人姓名 |
| proposer.dept_id | 分贝通申请人所属部门ID | String | Y | 分贝通申请人所属部门ID |
| proposer.third_dept_id | 三方系统申请人所属部门ID | String | N | 三方系统申请人所属部门ID |
| proposer.all_path_dept_name | 申请人所属部门名称 | String | Y | 申请人所属部门名称 |
| orders | 订单信息 | jsonArray | Y | 订单信息 |
| orders.category | 业务线 | integer | Y | 6:机票 8：酒店 9：火车 |
| orders.type | 订单类型 | String | Y | 1：原单 2：新单 |
| orders.id | 订单ID | String | N | 订单ID |
| orders.rebook_price | 改签金额 | BigDecimal | N | 单位：元 |
| orders.start_city | 出发城市名称 | String | Y | 酒店：入住城市、机票：出发城市、火车：出发城市 |
| orders.end_city | 到达城市名称 | String | Y | 酒店：入住城市、机票：出发城市、火车：出发城市 |
| orders.start_station | 出发站名称 | String | N | 机票：出发航站楼、 火车：出发火车站;机票场景时该字段必返 |
| orders.end_station | 到达站名称 | String | N | 机票：到达航站楼、 火车：到达火车站;机票场景时该字段必返 |
| orders.start_data | 出发日期 | String | Y | 格式为：YYYY-MM-DD |
| orders.end_data | 到达日期 | String | Y | 格式为：YYYY-MM-DD |
| orders.start_time | 出发时间 | String | Y | 格式为：HH：mm |
| orders.end_time | 到达时间 | String | Y | 格式为：HH：mm |
| orders.hotel_name | 酒店名称 | String | Y | 酒店名称，酒店场景必返 |
| orders.hotel_address | 酒店地址 | String | Y | 酒店地址，酒店场景必返 |
| orders.room_number | 房间数 | integer | N | 房间数 |
| orders.room_type | 房型 | String | Y | 酒店场景必返 |
| orders.train_code | 车次 | String | Y | 火车场景必返 |
| orders.seat_type | 座位类型 | String | Y | 火车场景必返 |
| orders.seat_location | 座位号 | String | N | 火车 |
| orders.flight_code | 航班号 | String | Y | 机票场景必返 |
| orders.airline_name | 航司名称 | String | Y | 机票场景必返 |
| orders.cabin | 舱位 | String | Y | 机票场景必返 |
| user | 使用人信息 | jsonObject | Y | 酒店：入住人、机票：乘机人、火车：乘车人 |
| user.id | 分贝通使用人ID | String | N | 分贝通使用人ID |
| user.third_id | 三方系统使用人ID | String | N | 三方系统使用人ID |
| user.name | 使用人姓名 | String | Y | 使用人姓名 |
| user.phone | 使用人手机号 | String | Y | 使用人手机号 |
| user.cert_type | 使用人证件类型 | integer | N | 1:身份证;2:护照;3:回乡证;4:台胞证;5:往来港澳通行证;6: 大陆居民往来台湾通行证 |
| user.cert_no | 使用人证件号 | String | N | 使用人证件号 |
| contacter_name | 联系人姓名 | String | Y | 李四 |
| contacter_phone | 联系人手机号 | String | Y | 13809876543 |
| cost_attributions | 订单费用归属信息 | jsonArray | N | 只有比例，没有金额 |
| cost_attributions.id | 分贝通费用归属id | String | Y | 分贝通费用归属id |
| cost_attributions.third_id | 三方系统费用归属ID | String | N | 三方系统费用归属ID |
| cost_attributions.name | 费用归属名称 | String | Y | 费用归属名称 |
| cost_attributions.weight | 比例 | BigDecimal | Y | 比例 |
# 请求示例：
机票退改示例：
{
"apply": {
"id": "567687687987899",
"name": "孔祥峰的机票退订申请",
"apply_reason": "行程变更",
"remark": "134949"
},
"proposer": {
"id": "354657657897979",
"phone": "18888888888",
"name": "测试同学",
"third_id": "013955105723455359",
"dept_id": "7627897989080980",
"third_dept_id": "379309935",
"all_path_dept_name": "钉钉云dev1/销售部"
},
"orders": [{
"category": 6,
"type": "1",
"id": "456677687688779",
"cabin": "经济舱",
"start_city": "北京市",
"end_city": "沈阳市",
"start_date": "2022-07-13",
"end_date": "2022-07-13",
"start_time": "08:55",
"end_time": "10:25",
"flight_code": "CA1651",
"airline_name": "中国国航",
"start_station": "首都机场",
"end_station": "桃仙机场"
}],
"user": {
"id": "4566778688779879899",
"name": "测试同学",
"phone": "18888888888",
"third_id": "013955105723455359",
"cert_type": 1,
"cert_no": "2302*************3"
},
"apply_type": "1",
"contacter_name": "测试同学",
"contacter_phone": "18888888888",
"cost_attributions": [{
"id": "456757687879879989",
"name": "销售部",
"weight": 100.00,
"third_id": "379309935"
}, {
"id": "354656756778688798",
"name": "素素素sssw11w",
"weight": 100.00
}]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
酒店退改示例：
{
"apply": {
"id": "43546567786878979",
"name": "测试的酒店退订申请",
"apply_reason": "行程变更",
"remark": ""
},
"proposer": {
"id": "6567687979889",
"phone": "19999999999",
"name": "测试同学",
"third_id": "05490314481220671",
"dept_id": "34567677878",
"third_dept_id": "528225396",
"all_path_dept_name": "测试dev1/test1"
},
"orders": [{
"category": 8,
"type": "1",
"id": "4657687687989890",
"start_city": "北京市",
"end_city": "北京市",
"start_date": "2022-06-15",
"end_date": "2022-06-16",
"hotel_name": "秋果酒店(北京建国门CBD店)",
"hotel_address": "建华南路11号1幢1-9层",
"room_number": 1,
"room_type": "明星舒适大床房"
}],
"user": {
"id": "354657676879900",
"name": "测试同学",
"phone": "19999999999",
"third_id": "05490314481220671",
"cert_type": 1,
"cert_no": ""
},
"apply_type": "1",
"contacter_name": "测试同学",
"contacter_phone": "19999999999",
"cost_attributions": [{
"id": "23544656567879890",
"name": "销售部",
"weight": 100.00,
"third_id": "379309935"
}, {
"id": "13235465767890",
"name": "ctq",
"weight": 100.00
}]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
火车退改示例：
{
"apply": {
"id": "132432345456766768790",
"name": "测试同学的火车改签申请",
"apply_reason": "行程变更",
"remark": "134949"
},
"proposer": {
"id": "1323435465768789",
"phone": "19999999999",
"name": "测试",
"third_id": "013955105723455359",
"dept_id": "576576877989324",
"third_dept_id": "629681054",
"all_path_dept_name": "内嵌版测试企业/多企业试试"
},
"orders": [{
"category": 9,
"type": "1",
"id": "4657676878979980",
"start_city": "两当县",
"end_city": "凤县",
"start_date": "2022-06-15",
"end_date": "2022-06-15",
"start_time": "15:35",
"end_time": "15:49",
"train_code": "6064",
"seat_type": "硬座",
"seat_location": "03车厢,001号",
"start_station": "宏庆",
"end_station": "凤县"
}, {
"category": 9,
"type": "2",
"rebook_price": "0",
"start_city": "宏庆",
"end_city": "凤县",
"start_date": "2022-06-14",
"end_date": "2022-06-14",
"start_time": "15:35",
"end_time": "15:49",
"train_code": "6064",
"seat_type": "硬座"
}],
"user": {
"id": "2332455564565768687989",
"name": "测试",
"phone": "19999999999",
"third_id": "013955105723455359",
"cert_type": 1,
"cert_no": "35264672834298"
},
"apply_type": "2",
"contacter_name": "测试",
"contacter_phone": "19999999999",
"cost_attributions": [{
"id": "53246727836478274979",
"name": "钉钉内嵌版测试企业",
"weight": 100.00,
"third_id": "dingtest08978687665545321"
}, {
"id": "23746287463728742989",
"name": "项目162752656971311kxf修改2",
"weight": 100.00,
"third_id": "test93284827348627"
}]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67