凭证分录行追加接口V3

POST

/open/voucher/v3/addVoucherLine

支持的档案版本：4.6.1以后

请求参数

Header 参数

Authorization

string

可选

默认值:

Content-Type

string

可选

默认值:

application/json

Body 参数application/json

voucherId

string | null

可选

凭证Id
用户系统凭证唯一编码。启用凭证ID情况下必传
不传则数据以业务实体名、凭证类型、凭证期间、凭证号四要素确定唯一

voucherPeriod

string

必需

凭证期间
四要素之一
凭证期间必须为[yyyy-mm]格式且在系统中维护，例如：2022-02

voucherType

string

必需

凭证类型
四要素之一

voucherNo

string

凭证号四要素之一

必需

accountSetNo

string | null

可选

账套编号
四要素之一

lines

array[object (OpenVoucherLineUpsertDto) {32}] | null

凭证行列表

可选

voucherAbstract

string | null

摘要

可选

subjectCode

string | null

科目代码

可选

subjectName

string | null

科目名称

可选

originalAmount

number | null

原币金额

可选

debitAmount

number | null

借方金额

可选

creditAmount

number | null

贷方金额

可选

entrySequenceNo

string | null

分录顺序号

可选

quantity

number | null

数量

可选

unitPrice

number | null

单价

可选

currency

string | null

可选

原币币种
不校验，例如：人民币或CNY皆可传

exchangeRate

number | null

汇率

可选

deptCode

string | null

部门编码

可选

deptName

string | null

部门名称

可选

employeeCode

string | null

员工编码

可选

employeeName

string | null

员工名称

可选

projectCode

string | null

项目编码

可选

projectName

string | null

项目名称

可选

transactionUnitCode

string | null

往来单位编码

可选

transactionUnitName

string | null

往来单位名称

可选

supplierCode

string | null

供应商编码

可选

supplierName

string | null

供应商名称

可选

merchantCode

string | null

客商编码

可选

merchantName

string | null

客商名称

可选

inventoryCode

string | null

存货编码

可选

inventoryName

string | null

存货名称

可选

cashFlowCode

string | null

现金流量代码

可选

cashFlowName

string | null

现金流量

可选

auxiliaryAccountings

array[object (AuxiliaryAccounting) {4}] | null

可选

辅助核算列表
在系统界面不会显示

auxiliaryStr

string | null

可选

辅助核算字符串
可以在系统界面展示

explain

object (Map«String»)

说明

可选

custom

object (Map«Object»)

可选

自定义字段
凭证行(分录行)自定义字段放这里，字段要提前在系统配置，报文样例：
"custom":{
"key": "value"
}

businessRemark

string | null

业务备注

可选

示例

{
    "voucherId": "string",
    "voucherPeriod": "string",
    "voucherType": "string",
    "voucherNo": "string",
    "accountSetNo": "string",
    "lines": [
        {
            "voucherAbstract": "string",
            "subjectCode": "string",
            "subjectName": "string",
            "originalAmount": 0,
            "debitAmount": 0,
            "creditAmount": 0,
            "entrySequenceNo": "string",
            "quantity": 0,
            "unitPrice": 0,
            "currency": "string",
            "exchangeRate": 0,
            "deptCode": "string",
            "deptName": "string",
            "employeeCode": "string",
            "employeeName": "string",
            "projectCode": "string",
            "projectName": "string",
            "transactionUnitCode": "string",
            "transactionUnitName": "string",
            "supplierCode": "string",
            "supplierName": "string",
            "merchantCode": "string",
            "merchantName": "string",
            "inventoryCode": "string",
            "inventoryName": "string",
            "cashFlowCode": "string",
            "cashFlowName": "string",
            "auxiliaryAccountings": [
                {
                    "type": "string",
                    "code": "string",
                    "name": "string",
                    "value": "string"
                }
            ],
            "auxiliaryStr": "string",
            "explain": {
                "key": "string"
            },
            "custom": {
                "key": {}
            },
            "businessRemark": "string"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/open/voucher/v3/addVoucherLine' \
--header 'Authorization: {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "voucherId": "string",
    "voucherPeriod": "string",
    "voucherType": "string",
    "voucherNo": "string",
    "accountSetNo": "string",
    "lines": [
        {
            "voucherAbstract": "string",
            "subjectCode": "string",
            "subjectName": "string",
            "originalAmount": 0,
            "debitAmount": 0,
            "creditAmount": 0,
            "entrySequenceNo": "string",
            "quantity": 0,
            "unitPrice": 0,
            "currency": "string",
            "exchangeRate": 0,
            "deptCode": "string",
            "deptName": "string",
            "employeeCode": "string",
            "employeeName": "string",
            "projectCode": "string",
            "projectName": "string",
            "transactionUnitCode": "string",
            "transactionUnitName": "string",
            "supplierCode": "string",
            "supplierName": "string",
            "merchantCode": "string",
            "merchantName": "string",
            "inventoryCode": "string",
            "inventoryName": "string",
            "cashFlowCode": "string",
            "cashFlowName": "string",
            "auxiliaryAccountings": [
                {
                    "type": "string",
                    "code": "string",
                    "name": "string",
                    "value": "string"
                }
            ],
            "auxiliaryStr": "string",
            "explain": {
                "key": "string"
            },
            "custom": {
                "key": {}
            },
            "businessRemark": "string"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

com.maycur.cm.dto.OpenResultDto<com.maycur.cm.dto.OpenBatchResultDataDto,java.lang.String>

code

integer | null

结果代码

可选

message

string | null

结果信息

可选

errMsg

string | null

错误信息

可选

data

object (OpenBatchResultDataDto)

结果数据

可选

successAmount

integer | null

成功条数

可选

timestamp

string | null

时间戳

可选

errData

string | null

失败结果

可选

示例

{
  "code": 0,
  "message": "",
  "errMsg": "",
  "data": {
    "successAmount": 0
  },
  "timestamp": "",
  "errData": ""
}

修改于 2023-10-25 08:11:36

凭证附件批量追加接口V3

凭证批量删除接口