# 接口说明
- 1.该接口用于查询报销单的详情业务数据
- 2.一页最多可支持查询20条
| 请求方式 | 请求地址 |
|---|---|
| POST | /openapi/func/reimb/detail |
请求参数:
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| timestamp | 时间戳 | long | Y | 13位时间戳 |
| sign | 签名 | string | Y | 4ergfdsawesf |
| access_token | token | string | Y | 登录 token |
| data | 请求数据 | jsonstring | Y | 请求数据 |
| data.payment_status | 付款状态 | integer | Y | 0:待付款 1:已付款 2:付款中 3:无需付款 |
| data.start_time | 报销单创建开始时间 | string | Y | "2020-05-27" |
| data.end_time | 报销单创建结束时间 | string | Y | "2020-05-27" |
| data.page_index | 页码 | integer | Y | 页码 |
| data.page_size | 条数 | integer | Y | 条数 |
| data.payment_start_time | 支付开始时间 | string | N | 2022-03-31 |
| data.payment_end_time | 支付结束时间 | string | N | 2022-04-01 |
请求示例:
"access_token": "xxx.xxx.xxx",
"timestamp": 123456789,
"employee_id":"12345678",
"sign": "jifejfwojelajflejf",
"data":
{
"payment_status": 0,
"start_time": "2021-10-13",
"end_time": "2021-10-13",
"page_index": 1,
"page_size": 20,
"payment_start_time":"2022-03-31",
"payment_end_time":"2022-04-01"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 响应数据：
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| code | 响应码 | integer | Y | 0:成功;1:失败 |
| msg | 响应信息 | string | N | success |
| data | 响应数据 | jsonObject | N | |
| data.reimb_form | 报销单据信息 | jsonArray | N | 报销单据信息 |
# 报销单据信息reimb_form：
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| type | 单据类型 | integer | Y | 16 核销单；17报销单；26 自定义报销单 |
| form_id | 自定义表单id | String | Y | 自定义表单id |
| company_id | 公司id | String | Y | 公司id |
| reimb_id | 报销单号 | String | Y | 如：BX202110100001 |
| proposor_id | 提单人id | String | Y | 如：14001001 |
| proposor_name | 提单人姓名 | String | Y | 如：张伟 |
| user_id | 实际报销人id | String | Y | 如：1301001 |
| user_name | 实际报销人姓名 | String | Y | 如：张三 |
| currency_code | 币种编码 | String | Y | 如：CNY(默认) |
| total_amount | 单据总金额 | BigDecimal | Y | 如：1000.00 |
| payment_amount | 应付金额 | BigDecimal | Y | 如：900.00 |
| no_need_pay_amount | 无需付款金额 | BigDecimal | Y | 单据总金额-应付金额 |
| expenses_num | 费用笔数 | Integer | N | 如：3 |
| receipt_num | 发票数量 | Integer | N | 如：9 |
| receipt_total_amount | 发票总金额 | BigDecimal | N | 发票的价税合计金额总和 |
| apply_state | 审批状态 | Integer | Y | 4:"已完成"； |
| ticket_status | 单据回票状态 | Integer | Y | 1:已全部回票 ; |
| payment_status | 付款状态 | Integer | Y | 0:待付款; 1:已付款 ;2:付款中;3:无需付款; |
| apply_reason | 报销事由 | String | Y | 如：因公出差拜访客户 |
| apply_reason_dec | 补充说明 | String | Y | 作为{单据事由}的补充 |
| reimburse_time | 提交日期 | String | Y | 提交日期 |
| pay_finish_time | 付款完成日期 | String | Y | 付款完成日期 |
| relevance_application_num | 关联申请单数 | Integer | N | 关联申请单数 |
| relevance_application | 关联申请单 | List | N | 1:差旅;4:采购; 12:申请用车; 11:用餐; 14:外卖; 24.自定义表单; |
| apply_info | 审批日志 | JsonArray | N | 审批日志 |
| apply_info.log | 审批日志信息 | String | N | 如：节点：已同意 操作人：王伟 操作时间：2021-8-2 |
| apply_info.time | 时间 | String | N | 2021-10-13 15:36:47 |
| apply_info.action | 审批行为 | Integer | N | 审批行为 |
| apply_info.sponsor_id | 发起人id | String | N | 发起人id |
| employee_info | 人员信息 | JsonArray | N | 提单人和报销人信息 |
| employee_info.type | 人员类型 | Integer | N | 1:提单人 2:报销人 |
| employee_info.employee_no | 人员工号 | String | N | 人员工号 |
| employee_info.third_employee_id | 三方人员id | String | N | 三方人员id |
| employee_info.employee_phone | 人员手机号 | String | N | 如：1399999999 |
| employee_info.employee_department_id | 人员部门编码 | String | N | 如：dept001 |
| employee_info.employee_department_name | 人员部门名称 | String | N | 如：财务部 |
| employee_info.third_department_id | 人员部门三方id | String | N | 人员部门三方id |
| employee_info.custom_fields | 人员扩展字段 | JsonArray | N | 人员扩展字段 |
| employee_info.custom_fields.key | 扩展字段key | String | N | 如：star |
| employee_info.custom_fields.value | 扩展字段value | Object | N | 如：五星级 |
| form_custom_fields | 单据自定义字段 | JsonArray | N | 单据自定义字段 |
| form_custom_field.key | 单据自定义字段名 | String | N | 单据自定义字段名 |
| form_custom_field.value | 单据自定义字段值 | Object | N | 单据自定义字段值 |
| reimb_expenses | 报销单费用信息 | JsonArray | N | 报销单费用信息 |
| third_apply_id | 三方审批单id | string | N | 三方审批单id |
# 报销费用信息reimb_expenses：
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| cost_category_code | 费用类型编码 | Integer | Y | 如：10001 |
| cost_category_name | 费用类型名称 | String | Y | 如：住宿费 |
| form_type | 支付方式 | Integer | N | 1:虚拟卡付；2:App付；3:纯报销 |
| total_amount | 费用总金额 | BigDecimal | Y | 如：500.00 |
| cost_reason | 费用描述 | BigDecimal | Y | 因公出差支持客户，住宿酒店开销 |
| cost_attribution_group | 费用归属 | JsonArray | N | 费用归属 |
| cost_attribution_group.category | 费用归属类型 | Integer | N | 1.部门 2.项目 3.自定义 |
| cost_attribution_group.record_id | 自定义档案id | String | N | 自定义档案id，部门项目没有 |
| cost_attribution_group.category_name | 自定义档案名称 | String | N | 自定义档案名称 |
| cost_attribution_group.range | 费用归属范围 | Integer | N | 1:范围一 2:范围二 |
| cost_attribution_group.cost_attribution_list | 费用归属信息 | JsonArray | N | 费用归属信息 |
| cost_attribution_group.cost_attribution_list.id | 费用归属id | String | N | 费用归属id |
| cost_attribution_group.cost_attribution_list.name | 费用归属名字 | String | N | 费用归属名字 |
| cost_attribution_group.cost_attribution_list.weight | 费用归属分摊比例 | Integer | N | 20 |
| cost_attribution_group.cost_attribution_list.amount | 费用归属分摊金额 | BigDecimal | N | 100.00 |
| cost_attribution_group.cost_attribution_list.third_id | 费用归属三方id | string | N | 费用归属三方id |
| cost_attribution_group.cost_attribution_list.cost_attribution_code | 费用归属编码 | string | N | 费用归属编码 |
| cost_custom_fields | 费用自定义字段 | JsonArray | N | 费用自定义字段 |
| cost_custom_fields.key | 费用自定义字段名 | String | N | 费用自定义字段名 |
| cost_custom_fields.value | 费用自定义字段值 | Object | N | 费用自定义字段值 |
| reimb_invoices | 报销单发票信息 | JsonArray | N | 报销单发票信息 |
| tax_amount | 费用税额 | string | N | 费用税额 |
| tax_rate | 费用税率 | string | N | 费用税率 |
# 报销发票信息reimb_invoice：
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| inv_id | 发票id | String | Y | 发票业务数据的唯一属性 |
| inv_type | 发票类型 | Integer | Y | 100：增值税专用发票；101：增值税普通发票；102：增值税电子普通发票；103：增值税普通发票（卷式）；104：机动车销售统一发票；105：二手车销售统一发票；200：定额发票；400：机打发票；500：出租车发票；503：火车票；505：客运汽车票 ；506：航空运输电子客票行程单；507：过路费发票；508：船票 |
| inv_type_name | 发票类型名称 | String | Y | 如：增值税电子普通发票 |
| inv_code | 发票代码 | String | Y | 如：D12345678901 |
| inv_number | 发票号码 | String | Y | 如：12345678 |
| issued_date | 开票日期 | String | Y | 如：2021-08-01 |
| seller_name | 销售方名称 | String | N | 如：天津***有限公司 |
| seller_tax_number | 销售方纳税人识别号 | String | N | 如：1234567890MA654321 |
| buyer_name | 购买方名称 | String | N | 如：北京***有限公司 |
| buyer_tax_number | 购买方纳税人识别号 | String | N | 如：987654321KL07654321 |
| total_price_plus_tax | 价税合计 | BigDecimal | Y | 400.00 |
| inv_tax_amount | 发票税额 | BigDecimal | Y | 32.03 |
| tax_rate | 税率 | BigDecimal | Y | 32 |
| exclude_tax_amount | 不含税金额 | BigDecimal | Y | 366.97 |
| inv_pdf_url | 发票原件pdf地址 | String | N | 如：附件url地址 |
| inv_pic_url | 拍照图片pdf地址 | String | N | 如：图片url地址 |
| detail | 发票税率信息 | jsonArray | N | 发票税率信息 |
| detail.rate | 发票税率 | BigDecimal | N | 发票税率 |
| detail.amount | 发票税额 | BigDecimal | N | 发票税额 |
| detail.name | 名称 | string | N | 名称 |
返回结果
{
"code": 0,
"msg": "success",
"data": {
"reimb_form": [{
"reimb_id": "32872389",//报销单号
"type": 17,//单据类型 16 核销单；17报销单；26 自定义报销单
"company_id": "236857423njh232",//公司id
"apply_state": 4,//审批状态 4:"已完成"；
"proposor_id": "73268457hkjdsahkfa",//提单人id
"proposor_name": "测试",//提单人姓名
"currency_code": "CNY",//币种编码
"total_amount": 500,//total_amount
"payment_amount": 500,//应付金额
"no_need_pay_amount": 0,//无需付款金额
"create_time": "2021-10-13 15:36:47",//创建时间
"apply_reason": "开发市场",//报销事由
"apply_reason_id": "61814",//报销事由id
"apply_reason_desc": "下雨天",//补充说明
"expenses_num": 3,//费用笔数
"receipt_num": 2,//发票数量
"receipt_total_amount": 507.99,//发票总金额
"payment_status": 0,//付款状态 0:待付款 1:已付款 2:付款中 3:无需付款
"ticket_status": 1,单据回票状态 1:已全部回票 ;
"relevance_application": [{//关联申请单数
"apply_id": "632874628748sede3724928",//关联申请单单号
"type": 24 //关联申请单类型 1:差旅;4:采购; 12:申请用车; 11:用餐; 14:外卖; 24.自定义表单
}],
"relevance_application_num": 1,//关联申请单数
"apply_info": [{ //审批日志
"log": "测试提交申请",
"time": "2021-10-13 15:36:47",
"action": 4,
"sponsor_id": "7324985732ewqfa3274"
},
{
"log": "测试审核通过",
"time": "2021-10-13 15:36:47",
"action": 16,
"sponsor_id": "3724985723847adfa"
}
],
"reimb_expense": [{ //报销单费用信息
"tax_amount":"1",
"tax_rate":"1",
"cost_category_code": "10011", //费用类型编码
"cost_category_name": "差旅费", //费用类型名称
"form_type": 3, //支付方式
"cost_reason": "梧桐来了", //费用描述
"total_amount": 300, //发票总金额
"cost_attribution_group": [{ //费用归属
"record_id": "391857243987ejwaf", //自定义档案id
"category_name": "蛋01", //自定义档案名称
"cost_attribution_list": [{ //费用归属信息
"id": "hsadfka23794572398", //费用归属id
"name": "8", //费用归属名字
"weight": 30, //费用归属分摊比例
"amount": 90, //费用归属分摊金额
"third_id":"567895678",//费用归属三方id
"cost_attribution_code":"67676"//费用归属编码
},
{
"id": "28347598dasfa",
"name": "而我去二",
"weight": 70,
"amount": 210,
"third_id":"456783456",
"cost_attribution_code":"3456"
}
],
"category": 3, //费用归属类型 1.部门 2.项目 3.自定义
"range": 1 //费用归属范围 1:范围一 2:范围二
},
{
"category_name": "部门",
"cost_attribution_list": [{
"id": "3268457298798asf",
"name": "接口测试专用部门一",
"weight": 40,
"amount": 120
},
{
"id": "32758732988若98adf",
"name": "里程补贴测试部门fat",
"weight": 60,
"amount": 180
}
],
"category": 1,
"range": 2
}
],
"reimb_invoice": [{//报销单发票信息
"inv_id": "6238472984798", //发票id
"inv_type": 999, //发票类型 100：增值税专用发票；101：增值税普通发票；102：增值税电子普通发票；103：增值税普通发票（卷式）；104：机动车销售统一发票；105：二手车销售统一发票；200：定额发票；400：机打发票；500：出租车发票；503：火车票；505：客运汽车票 ；506：航空运输电子客票行程单；507：过路费发票；508：船票
"inv_type_name": "其他票据（手动录入）", //发票类型名称
"inv_code": "6238562389754298", //发票代码
"inv_number": "3u25u32u9238459432", //发票号码
"issued_date": "2021-10-12", //开票日期
"seller_name": "其他票据（手动录入）", //销售方名称
"total_price_plus_tax": 300, //价税合计
"inv_tax_amount": 0, //发票税额
"tax_rate": 0, //税率
"exclude_tax_amount": 300, //不含税金额
"inv_pic_url": "https://xxx/xxx//aaa.jpg", //拍照图片pdf地址
"inv_pdf_url":"https://xxx/xxx//aaa.pdf" //发票原件pdf地址
"detail":{
"rate":"1",
"amount":"1",
"name":"名称"
}
}],
"cost_custom_fields": [ //自定义信息
]
}
],
"employee_info": [{//人员信息
"type": 1, //人员类型
"employee_no": "", //人员工号
"employee_phone": "13999999999", //人员手机号
"employee_department_id": "6328457324875297594", //人员部门编码
"employee_department_name": "钢蛋测试test/fy", //人员部门名称
"third_department_id":"68798989",
"custom_fields": [ //人员扩展字段
{
"key":"star",
"value":"五星级"
}
]
}],
"third_apply_id":"7897989"
}],
"total_count": 2,
"total_pages": 1,
"page_index": 1,
"page_size": 100
},
"request_id": "MFJFMtApKAptTXiR"
}
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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142