票据附件分页查询
接口说明
- URL：
/common/invoiceAttachment/findByPage - Method：POST
- Content-Type：
application/json
按票据编号列表和/或员工号筛选当前公司的附件，分页返回。receipt_ids 和 employee_number 单独看均为可选，但至少提供其中一个；同时提供时按 AND 关系筛选。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
receipt_ids |
Integer[] | 条件必填 | 票据编号列表；与 employee_number 至少提供一个 |
employee_number |
String | 条件必填 | 附件所属员工号；与 receipt_ids 至少提供一个 |
page_num |
Integer | 是 | 页码，从 1 开始 |
page_size |
Integer | 否 | 每页条数，默认 20，最大 200 |
请求示例
{
"receipt_ids": [12345, 12346],
"employee_number": "E10001",
"page_num": 1,
"page_size": 20
}
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
resCode |
Integer | 响应状态码（见附录） |
resMsg |
String | 响应消息 |
bizId |
String | 业务标识，示例中为 null |
data |
Object | 附件分页结果 |
data.page_num |
Integer | 当前页码，从 1 开始 |
data.page_size |
Integer | 每页条数 |
data.total_count |
Long | 符合筛选条件的附件总数 |
data.total_page |
Integer | 总页数 |
data.page_info |
Object[] | 当前页的附件元数据列表 |
data.page_info[].attachment_id |
Long | 附件编号 |
data.page_info[].receipt_id |
Integer | 关联票据编号；未绑定时为 null |
data.page_info[].source |
String | 附件来源，如 openapi |
data.page_info[].file_name |
String | 文件名；未设置时为空 |
data.page_info[].attachment_url |
String | 文件存储地址 |
JSON 响应
data 为分页结果；附件对象字段为 attachment_id、receipt_id、source、file_name、attachment_url，其中 attachment_url 是文件存储地址。
{
"resCode": 200000,
"resMsg": "success",
"bizId": null,
"data": {
"page_num": 1,
"page_size": 20,
"total_count": 1,
"total_page": 1,
"page_info": [
{
"attachment_id": 98765,
"receipt_id": 12345,
"source": "openapi",
"file_name": "付款凭证.pdf",
"attachment_url": "receipts/2026/10/payment-001.pdf"
}
]
}
}