# 接口说明
- 1.快递订单详情接口 通过该接口可以查询快递订单详情数据
| 名称 | 描述 |
|---|---|
| HTTP方法 | POST |
| Content-Type | application/x-www-form-urlencoded |
| method | /openapi/func/orders/express/deliveryOrderDetail |
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| timestamp | 时间戳 | long | Y | 13位时间戳 |
| sign | 签名 | string | Y | gaghegsgd535te3534 |
| access_token | token | string | Y | 登录 token |
| employee_id | 操作人id | string | Y | 操作人id,调用接口人 id |
| employee_type | 用户类型 | string | Y | 类型,0为分贝用户,1为第三方用户 |
| data | 请求数据 | jsonobject | Y | |
| data.order_id | 订单ID | string | Y | OEX202005271202154567174 为分贝通内部的订单号 |
请求示例:
"access_token":"5747fbc10f0e60e0709d8d722",
"sign":"oihfnlyeofdh98",
"timestamp":124124325,
"employee_id":"59b74c1323445f2d54dd07922",
"employee_type":"0",
"data":{"order_id":"OEX210707181234902224706"}
1
2
3
4
5
6
2
3
4
5
6
响应结果示例:
# 响应数据:
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| code | 响应码 | integer | Y | 0:成功;1:失败 |
| msg | 响应信息 | string | N | success |
| data | 响应数据 | jsonObject | N |
# 订单信息order_info:
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| order_id | 订单ID | string | Y | 订单ID |
| status | 订单状态 | integer | Y | 订单状态 |
| status_name | 订单状态名称 | string | Y | 订单状态名称 |
| supplier_order_id | 订单的三方Id | string | Y | 订单的三方Id |
| supplier_name | 订单供应商名称 | String | Y | 订单供应商名称 |
| order_des | 订单描述 | String | Y | 订单描述 |
| create_time | 订单的创建时间 | String | Y | 订单的创建时间 |
# 下单人信息user_info:
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| id | 下单人id | string | Y | 5d70ba9b23445f04bc031156 |
| name | 下单人姓名 | string | Y | 强仔 |
| phone | 下单人手机号 | integer | Y | 18310480640 |
| unit_name | 下单人部门名称 | string | Y | 嘟嘟搞测试 |
| full_unit_name | 下单人部门全名称 | string | Y | 嘟嘟搞测试 |
| user_city | 订单下单人的所在的城市 | string | Y | 订单下单人的所在的城市 |
# 订单金额信息price_info:
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| total_price | 订单总支付的价格 | double | Y | 订单总支付的价格 |
| personal_total_pay | 订单个人支付的价格 | double | Y | 订单个人支付的价格 |
| red_envelope | 红包券支付金额 | double | N | 0 |
| company_total_pay | 公司支付总金额 | double | N | 0 |
# 乘客信息goods_info:
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| number | 货物的数量 | integer | Y | 货物的数量 |
| type | 货物的类型 | string | Y | 货物的类型 |
# 快递人信息express_info:
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| sender_name | 订单发出者名字 | string | Y | 订单发出者名字 |
| sender_phone | 订单发出者电话 | string | Y | 订单发出者电话 |
| sender_city | 订单发出者城市 | string | Y | 订单发出者城市 |
| sender_address_detail | 订单发出者地址 | string | Y | 订单发出者地址 |
| receiver_name | 订单接收者名字 | string | Y | 订单接收者名字 |
| receiver_phone | 订单接收者电话 | string | Y | 订单接收者电话 |
| receiver_city | 订单接收者城市 | string | Y | 订单接收者城市 |
| receiver_address_detail | 订单接收者地址 | string | Y | 订单接收者地址 |
# 管控信息saas_info:
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| is_exceed | 是否超规 | string | N | false |
| exceed_reason | 超规理由 | string | N | |
| exceed_item | 超规项 | string | N | |
| remark | 下单事由 | string | N | |
| cost_category | 费用类别 | string | N | 市场活动费 |
| cost_category_code | 费用类别编码 | string | N | 10010 |
| cost_attribution_list | 管控费用信息 | jsonArray | Y | 管控费用信息 |
| cost_attribution_list.cost_attribution_category | 费用归属类型1:部门;2:项目 | integer | N | 1 |
| cost_attribution_list.cost_attribution_id | 费用归属id | string | N | 59a80dd92798630fd780babf |
| cost_attribution_list.cost_attribution_name | 费用归属名称 | string | N | 嘟嘟搞测试 |
| cost_attribution_list.cost_attribution_custom_ext | 费用归属自定义字段列表 | jsonArray | N | |
| cost_attribution | 费用归属 | jsonArray | N | 费用归属 |
| cost_attribution.type | 费用归属类型 | integer | N | 费用归属类型枚举值:1,部门2,项目3,自定义档案 |
| cost_attribution.archive_id | 分贝通自定义档案ID | string | N | 分贝通自定义档案ID |
| cost_attribution.third_archive_id | 三方系统自定义档案ID | string | N | 三方系统自定义档案ID |
| cost_attribution.archive_name | 自定义档案名称 | string | N | 自定义档案名称 |
| cost_attribution.details | 费用归属详情 | jsonArray | N | 费用归属详情 |
| cost_attribution.details.id | 分贝通费用归属id | string | N | 分贝通费用归属id |
| cost_attribution.details.third_id | 三方系统费用归属id | string | N | 当费用归属类(cost_attribution_type)为1时,需使用三方系统部门ID,为2时,为三方系统项目ID;为3时,为三方系统自定义档案项目ID。 |
| cost_attribution.details.name | 费用归属名称 | string | N | 当费用归属类型(cost_attribution_type)为1时,需使用部门名称;为2时,为项目名称;为3时,为自定义档案项目名称。 |
| cost_attribution.details.weight | 费用归属权重 | double | N | 费用归属的百分比 |
| cost_attribution.details.amount | 费用归属分摊金额 | bigDecimal | N | 费用归属的分摊金额 |
# 三方信息third_info:
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| user_id | 三方员工id | string | N | 三方员工id |
| dept_id | 三方部门id | string | N | 三方部门id |
| cost_dept_id | 三方费用归属部门id | string | N | dinge78ced08591e110bf5bf40eda33b7ba0 |
| cost_project_id | 三方费用归属项目id | string | N | dinge78ced08591e110bf5bf40eda33b7ba2 |
| apply_id | 快递审批id | string | N | 快递审批id |
{
"code": 0,
"msg": "success",
"data": {
"order_info": {
"order_id": "OEX202007212030541320507",
"status": 5,
"status_name": "已取消",
"supplier_order_id": "SF7444407668644",
"supplier_name": "顺丰快递",
"order_des": "文件/<5公斤",
"create_time": "2020-07-21 20:30:54"
},
"price_info": {
"personal_total_pay": 0.0,
"total_price": 23.0,
"red_envelope": 0,
"company_total_pay": 23.0
},
"goods_info": {
"number": 1,
"type": 10
},
"user_info": {
"id": "5e4cdf3c23445f5a48b040c7",
"name": "张一鸣",
"unit_name": "研发部",
"user_city": "北京市",
"phone": "18510675651"
},
"express_info": {
"sender_name": "张一鸣",
"sender_phone": "18510675651",
"sender_city": "北京市",
"receiver_name": "张一鸣",
"receiver_phone": "18510675655",
"receiver_city": "金昌市",
"sender_address_detail": "北京北京市朝阳区1楼2门101测试单",
"receiver_address_detail": "甘肃省金昌市永昌县1号楼2门101JD测试单"
},
"saas_info": {
"exceed_reason": "{\"exceed_reason\":\"\",\"exceed_reason_comment\":\"\"}",
"is_exceed": false,
"exceed_item": "[]",
"remark": "{\"remark\":\"其他\",\"remark_detail\":\"\"}",
"cost_category":"市场活动费",
"cost_category_code":"10010",
"attribution_list": [
{
"cost_attribution_id": "5efe9df523445f432146d295",
"cost_attribution_category": 2,
"cost_attribution_name": "手批2",
"cost_attribution_custom_ext": "[{\"custom_field_title\":\"干啥啊\",\"custom_field_content\":\"加油\"},{\"custom_field_title\":\"恭喜发财\",\"custom_field_content\":\"麦兜兜菠萝油王子\"}]"
}
],
"cost_attribution":[
{
"type":1,
"archive_id":"",
"third_archive_id":"",
"archive_name":"",
"details":[
{
"name":"部门二",
"weight":33.33,
"amount":7,
"third_id":"bumen2",
"id":"5bfca57dbfd57c0523d83ce0"
},
{
"name":"部门一",
"weight":33.33,
"amount":7,
"third_id":"bumenyi",
"id":"5bfb58a7bfd57c3d9d01c713"
},
{
"name":"部门三",
"weight":33.34,
"amount":7,
"third_id":"bumen3",
"id":"5bfca584bfd57c0523d83ce1"
}
]
},
{
"type":2,
"details":[
{
"name":"财务项目004",
"weight":33.34,
"amount":7,
"third_id":"cwxm004",
"id":"5f717ce3aa42278ee8a11c8e"
},
{
"name":"财务项目003",
"weight":33.33,
"amount":7,
"third_id":"cwxm003",
"id":"5f717ce3aa42278ee8a11c8d"
},
{
"name":"财务项目002",
"weight":33.33,
"amount":7,
"third_id":"cwxm002",
"id":"5f717ce3aa42278ee8a11c8c"
}
]
}
]
},
"third_info": {
"user_id": "23122222222112",
"dept_id": "146f0295-fbbc-4448-b9ec-c6dc171de573",
"cost_project_id": "third_group_033",
"apply_id": "67678"
}
},
"request_id": "oLJuRJBAoh6YYzRB"
}
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122