# 接口说明

  • 1.快递订单消息推送接口,现有接口推送消息只包含已完成状态
# 订单信息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 订单的创建时间
order_category_type 场景类型 integer Y 131:快递
order_category_name 场景类型名称 string Y 快递
order_op_type 订单方向 integer Y 10:正向单;20:逆向单
order_op_type_name 订单方向名称 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 订单下单人的所在的城市
employee_number 员工工号 string N aaaa
# 订单金额信息price_info:
字段 名称 类型 必填 描述
total_price 订单总支付的价格 double Y 订单总支付的价格
personal_total_pay 订单个人支付的价格 double Y 订单个人支付的价格
red_envelope 红包券支付金额 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
{
	"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",
		"order_category_type": 131,
		"order_category_name": "快递",
		"order_op_type": 10,
		"order_op_type_name": "正向单"
	},
	"price_info": {
		"personal_total_pay": 0.0,
		"total_price": 23.0,
        "red_envelope": 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"
   }
}
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
lastUpdate: 5/17/2022, 3:39:42 PM