附件-会计资料创建

  • 接口: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 其他电子会计资料 银行对账单、税务文件等

results matching ""

    No results matching ""