单据附件添加
- 接口:common/document/addAttachments
- Method:POST
- 数据格式:JSON
- 接口说明:单据附件添加
- 其他补充信息:
documentNum
与externalId
必填其一
- 只能添加附件, 不能删除/修改附件
- 目前只允许添加头上附件
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度 |
externalId |
String |
外部系统单据号或云简系统单据号 |
ONE-OF |
64 |
请求数据
?externalId=8000252981
body
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
bizId |
String |
当前次接口同步的唯一标识 |
TRUE |
36 |
timestamp |
Long |
当前次接口同步的时间戳 |
TRUE |
13 |
data |
Object |
请求数据体 |
TRUE |
无 |
data.attachments |
Object |
单据头附件栏位 |
FALSE |
无 |
data.attachments.file_name |
String |
文件名 |
FALSE |
255 |
data.attachments.attachment_url |
String |
文件地址 (需提前调用文件上传标准口上传文件,贴上传结果中的文件地址) |
FALSE |
无 |
data.attachments.attachment_type_code |
String |
附件类型编码 |
FALSE |
无 |
data.attachments1 |
Object |
单据头附件栏位 |
FALSE |
无 |
data.attachments1.file_name |
String |
文件名 |
FALSE |
255 |
data.attachments1.attachment_url |
String |
文件地址 (需提前调用文件上传标准口上传文件,贴上传结果中的文件地址) |
FALSE |
无 |
data.attachments1.attachment_type_code |
String |
附件类型编码 |
FALSE |
无 |
data.attachments50 |
Object |
单据头附件栏位 |
FALSE |
无 |
示例:
请求数据
common/document/addAttachments?externalId=REQ0000025379
{
"bizId": "4aba2901-8b53-40f5-91fc-e8f375cddc84",
"timestamp": 1614053054469,
"data": {
"attachments": [
{
"file_name": "file_name.png",
"attachment_url": "通过文件上传接口获取到的文件key.png",
"attachment_type_code": "test002"
}
],
"attachments1": [
{
"file_name": "file_name.png",
"attachment_url": "通过文件上传接口获取到的文件key.png"
}
],
"attachments50": [
{
"file_name": "file_name.png",
"attachment_url": "通过文件上传接口获取到的文件key.png"
}
]
}
}