票据附件替换
接口说明
- URL：
/common/invoiceAttachment/replace - Method：POST
- Content-Type：
application/json
按附件编号替换附件元数据。file_name 和 attachment_url 至少提供一个；未提供的字段保持不变。可选传入 receipt_id，将尚未绑定的附件绑定到指定票据；省略时保持现有绑定关系。票据必须属于当前公司，已绑定到其他票据的附件不能改绑。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
attachment_id |
Long | 是 | 附件编号 |
file_name |
String | 否 | 更新后的文件名；与 attachment_url 至少提供一个 |
attachment_url |
String | 否 | 更新后的文件存储地址；与 file_name 至少提供一个 |
receipt_id |
Integer | 否 | 绑定目标票据编号；只能绑定尚未关联其他票据的附件 |
请求示例
{
"attachment_id": 98765,
"attachment_url": "receipts/2026/10/payment-updated.pdf",
"receipt_id": 12345
}
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
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": 12345,
"source": "openapi",
"file_name": "付款凭证.pdf",
"attachment_url": "receipts/2026/10/payment-updated.pdf"
}
}