批量设置凭证和流水关联关系V2 - 电子档案开放接口文档

请求参数

Header 参数

Authorization

string

可选

默认值:

Content-Type

string

可选

默认值:

application/json

Body 参数application/json

array of:

voucherId

string | null

可选

凭证Id
用户系统凭证唯一编码，和凭证四要素二选一

businessEntityName

string | null

可选

业务实体名称
V3接口不支持该参数，V2接口支持
凭证四要素之一，和凭证ID二选一

accountSetNo

string | null

可选

账套编号
V2接口不支持该参数，V3接口支持
凭证四要素之一，和凭证ID二选一

voucherPeriod

string | null

可选

凭证期间
凭证四要素之一，和凭证ID二选一

voucherType

string | null

可选

凭证类型
凭证四要素之一，和凭证ID二选一

voucherNo

string | null

可选

凭证号
凭证四要素之一，和凭证ID二选一

transNos

array[string] | null

可选

流水号列表
关联流水号数组，跟details二选一，该字段有值时details不生效

details

array[object (VoucherRelTransDetailDTO) {9}] | null

可选

关联流水要素列表
跟transNos二选一，transNos有值时details不生效

transNo

string | null

可选

流水号
与uniqueNo不可同时为空

accountNo

string | null

我方银行账号

可选

opAccountNo

string | null

对方银行账号

可选

balance

number | null

可选

余额
3.7.0开始支持

transDate

string | null

交易日期

可选

transAmtD

number | null

借方金额

可选

transAmtC

number | null

贷方金额

可选

uniqueNo

string | null

可选

招行CBS唯一键值流水号
与transNo不可同时为空
若detail里同时还存在transNo，则以uniqueNo为准

transSource

enum<string> | enum<null>

可选

流水数据来源系统
只支持 CMB_CBS("招行CBS")，YOCYL("优财")

枚举值:

CMBCMB_CBSCMB_CLOUDCMB_SAASYOCYLABCBCMBOCCCBCCB_P1CIBCITICCZBHZBHCCB_TMS_CLOUDICBCNBCBNBCB_TMSPABSPDBSPDB_SAASYDB

示例

[
    {
        "voucherId": "string",
        "businessEntityName": "string",
        "accountSetNo": "string",
        "voucherPeriod": "string",
        "voucherType": "string",
        "voucherNo": "string",
        "transNos": [
            "string"
        ],
        "details": [
            {
                "transNo": "string",
                "accountNo": "string",
                "opAccountNo": "string",
                "balance": 0,
                "transDate": "string",
                "transAmtD": 0,
                "transAmtC": 0,
                "uniqueNo": "string",
                "transSource": "CMB"
            }
        ]
    }
]

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/open/relation/v2/voucher/trans' \
--header 'Authorization: {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "voucherId": "string",
        "businessEntityName": "string",
        "accountSetNo": "string",
        "voucherPeriod": "string",
        "voucherType": "string",
        "voucherNo": "string",
        "transNos": [
            "string"
        ],
        "details": [
            {
                "transNo": "string",
                "accountNo": "string",
                "opAccountNo": "string",
                "balance": 0,
                "transDate": "string",
                "transAmtD": 0,
                "transAmtC": 0,
                "uniqueNo": "string",
                "transSource": "CMB"
            }
        ]
    }
]'

返回响应

🟢200成功

application/json

Body

com.maycur.cm.dto.ResultDto<java.util.List<com.maycur.cm.dto.voucher.VoucherImportResultDTO>>

code

integer | null

结果代码

可选

message

string | null

结果信息

可选

errMsg

string | null

错误信息

可选

data

array[object (VoucherImportResultDTO) {9}] | null

结果数据

可选

index

integer | null

数据在列表中索引

必需

voucherId

string | null

可选

凭证Id
有传入则原始返回，未传入则为空，可根据四要素组合定位排查错误记录

businessEntityName

string | null

业务实体名

可选

accountSetNo

string | null

可选

账套编号
V2接口不支持该参数，V3接口支持

voucherPeriod

string | null

凭证期间

可选

voucherType

string | null

凭证类型

可选

voucherNo

string | null

凭证号

可选

code

integer | null

结果代码

可选

errorMsg

string | null

错误信息

可选

timestamp

string | null

时间戳

可选

示例

{
  "code": 0,
  "message": "",
  "errMsg": "",
  "data": [
    {
      "index": 0,
      "voucherId": "",
      "businessEntityName": "",
      "accountSetNo": "",
      "voucherPeriod": "",
      "voucherType": "",
      "voucherNo": "",
      "code": 0,
      "errorMsg": ""
    }
  ],
  "timestamp": ""
}