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

版本4.0之后可以用该接口

凭证ID和四要素二选一

启用凭证ID的情况：
凭证ID不变，四要素不变，其他字段修改后再次同步会更新
凭证ID不变，四要素变化，其他字段修改后再次同步会更新
凭证ID变化，四要素不变，其他字段修改后再次同步会报错: "四要素已被其他凭证使用"
未启用凭证ID的情况：
四要素不变，其他字段修改后再次同步会更新
未启用凭证ID时，接口导入的凭证ID是无效的

数据量：接口没有限制一次推送多少数据，但是建议一次推送不要超过50条

凭证关联流水且流水没有回单文件：凭证没法看到回单，流水可以看到凭证和跳转，在版本4.0.0会更新成没有回单文件也可以在凭证上看到流水
特殊场景：配置文件voucherId=true。如果客户需要先进入关联关系，后面再进入凭证数据时。关联关系请求参数的voucherId字段必填，否则后续无法补录关系成功。

请求参数

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

com.maycur.cm.dto.OpenResultDto<com.maycur.cm.dto.OpenBatchResultDataDto,java.util.List<com.maycur.cm.dto.voucher.VoucherImportResultDTO>>

code

integer | null

结果代码

可选

message

string | null

结果信息

可选

errMsg

string | null

错误信息

可选

data

object (OpenBatchResultDataDto)

结果数据

可选

successAmount

integer | null

成功条数

可选

timestamp

string | null

时间戳

可选

errData

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

错误信息

可选

示例

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