附件-会计资料创建
- 接口:magneto/api/v1/documents/attachment
- Method:POST
- 接口说明:创建会计资料附件
- 其他补充信息:会计资料管理
参数:
请求头参数
- Content-Type:
application/json
- token: 用户认证令牌(必填)
请求参数
| 字段名 |
类型 |
必填 |
长度限制 |
说明 |
备注 |
| archive_ext_code |
String |
非 |
≤100 |
档案编码 |
若传入则表明关联档案,档案已整理的时候不允许被关联 |
| document_type_code |
String |
是 |
≤20 |
会计资料类型编码 |
决定关联的子表类型 |
| document_ext_num |
String |
是 |
≤36 |
会计资料外部系统编号 |
确保唯一性,与source_code+archive_type_code组成业务主键 |
| archive_type_code |
String |
是 |
≤20 |
档案类型编码 |
电子会计档案分类标识 |
| source_code |
String |
是 |
≤20 |
来源代码 |
标识数据来源系统 |
| document_sub_type |
String |
否 |
≤64 |
会计资料子类型 |
单据类型、票据类型、附件类型等 |
| document_num |
String |
否 |
≤64 |
会计资料编号 |
单据号、发票号码、回单号等 |
| document_desc |
String |
否 |
≤255 |
描述 |
会计资料的详细描述 |
| file_num_list |
Array |
否 |
- |
文件编号列表 |
关联的文件编号数组 |
返回参数
| 字段名 |
类型 |
说明 |
| resCode |
Integer |
响应代码,200000表示成功 |
| resMsg |
String |
响应消息 |
| data |
Object |
响应数据对象 |
| document_ext_num |
String |
会计资料外部系统编号 |
示例:
请求数据
curl --location --request POST 'https://devapi.cloudpense.com/magneto/api/v1/documents/attachment' \
--header 'token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjb21wYW55X2lkIjozODA5LCJleHAiOjE3NjM4MDY1MTksImNsaWVudF9pZCI6IkFyY2hpdmVFeHRlbnNpb24iLCJzb3VyY2VfbmFtZSI6IlNBUCJ9.8uqVNo9Mi0yc3lPIZMth7r1ERCDmdhOfj0Lek7d1j90' \
--header 'Content-Type: application/json' \
--data-raw '{
"biz_id": "202510211001",
"timestamp": 1759295384729,
"data": {
"document_type_code": "liushui",
"archive_type_code": "F003",
"source_code": "S001",
"document_ext_num": "sap202511191439xx1",
"document_sub_type": "合同附件",
"document_num": "EXP202510210311139",
"file_num_list": []
}
}'
返回数据
{
"resCode": 200000,
"resMsg": "会计资料创建成功",
"data": {
"id": null,
"document_ext_num": "sap202511191439xx1"
}
}
枚举值和字典说明
document_type_code(会计资料类型编码)
| 编码 |
说明 |
对应子表 |
备注 |
| S001 |
记账凭证 |
无(仅主表) |
会计凭证类文档 |
| S002 |
会计资料单据 |
mag_document_claim |
报销单、申请单等 |
| S003 |
进项发票 |
mag_document_invoice |
增值税进项发票 |
| S004 |
销项发票 |
mag_document_invoice |
增值税销项发票 |
| S005 |
银行回单 |
mag_document_receipt |
银行收付款凭证 |
archive_type_code(档案类型编码)
根据《电子会计档案管理办法》,电子会计档案分为4类:
| 编码 |
说明 |
备注 |
| F003 |
电子会计凭证类 |
记账凭证、原始凭证等 |
| KJZB |
电子会计账簿 |
总账、明细账、日记账等 |
| KJBG |
电子财务会计报告 |
财务报表、财务分析等 |
| QTZL |
其他电子会计资料 |
银行对账单、税务文件等 |