票据附件创建
接口说明
- URL：
/common/invoiceAttachment/create - Method：POST
- Content-Type：
application/json
按员工号批量创建附件元数据。附件文件应先上传至文件服务；票据关联由后续业务流程完成。每个附件独立传入存储地址及可选文件名，避免多个列表按下标配对。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
employee_number |
String | 是 | 附件所属员工号 |
attachments |
Object[] | 是 | 附件列表，1 至 20 个 |
attachments[].attachment_url |
String | 是 | 文件存储地址 |
attachments[].file_name |
String | 否 | 调用方填写的文件名；不传时保持为空 |
请求示例
{
"employee_number": "E10001",
"attachments": [
{
"attachment_url": "receipts/2026/10/payment-001.pdf",
"file_name": "付款凭证一.pdf"
},
{
"attachment_url": "receipts/2026/10/payment-002.jpg"
}
]
}
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
resCode |
Integer | 响应状态码（见附录） |
resMsg |
String | 响应消息 |
bizId |
String | 业务标识，示例中为 null |
data |
Object[] | 创建成功的附件元数据列表 |
data[].attachment_id |
Long | 附件编号 |
data[].receipt_id |
Integer | 关联票据编号；未绑定时为 null |
data[].source |
String | 附件来源，如 openapi |
data[].file_name |
String | 文件名；创建时未传则为空 |
data[].attachment_url |
String | 文件存储地址 |
JSON 响应
data 为附件数组，附件对象只包含持久化元数据及 attachment_url 存储地址。
{
"resCode": 200000,
"resMsg": "success",
"bizId": null,
"data": [
{
"attachment_id": 98765,
"receipt_id": null,
"source": "openapi",
"file_name": "付款凭证一.pdf",
"attachment_url": "receipts/2026/10/payment-001.pdf"
}
]
}