批量设置凭证和每刻单据关联关系V3 - 电子档案开放接口文档

请求参数

Header 参数

Authorization

string

可选

默认值:

Content-Type

string

可选

默认值:

application/json

Body 参数application/json

array of:

voucherId

string | null

可选

凭证Id
用户系统凭证唯一编码。

businessEntityName

string | null

可选

业务实体名
四要素之一
V3接口不支持该参数，V2接口支持

voucherPeriod

string | null

可选

凭证期间
四要素之一

voucherType

string | null

可选

凭证类型
四要素之一

voucherNo

string | null

凭证号四要素之一

可选

accountSetNo

string | null

可选

账套编号
四要素之一
V2接口不支持该参数，V3接口支持

reportIds

array[string] | null

可选

单据号列表
选项1：关联单据号数组
与选项2互斥，当选项2的数组对象为空时，此数组（单据号数组）则必填；当选项2的数组对象不为空时，则以选项2的数组对象为主，此数组（单据号数组）可不填

baseReportList

array[object (MaycurReimburseBaseReportDto) {3}] | null

可选

关联单据对象
选项2（新增）：关联单据对象数组，以前可依旧采用 reportIds 对象来对接，现用baseReportList对象来对接

reportId

string

单据号

必需

reimburseType

enum<string>

单据大类

必需

枚举值:

INTERNATIONAL_REIMBURSEMENT_FORMINTERNATIONAL_APPLICATION_FORMINTERNATIONAL_CORPORATE_PAYMENTINTERNATIONAL_CORPORATE_REPAYMENTINTERNATIONAL_REPAYMENTINTERNATIONAL_CONTRACT_FORMINTERNATIONAL_MONTHLY_INVOICEULTIMATE_REIMBURSEMENT_FORMULTIMATE_APPLICATION_FORMULTIMATE_LOAN_FORMULTIMATE_CONTRACT_FORMULTIMATE_INSTALLMENT_FORM

subsidiaryCode

string | null

可选

业务实体编码，可不必填

示例

[
    {
        "voucherId": "string",
        "businessEntityName": "string",
        "voucherPeriod": "string",
        "voucherType": "string",
        "voucherNo": "string",
        "accountSetNo": "string",
        "reportIds": [
            "string"
        ],
        "baseReportList": [
            {
                "reportId": "string",
                "reimburseType": "INTERNATIONAL_REIMBURSEMENT_FORM",
                "subsidiaryCode": "string"
            }
        ]
    }
]

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/open/relation/v3/voucher/maycur' \
--header 'Authorization: {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "voucherId": "string",
        "businessEntityName": "string",
        "voucherPeriod": "string",
        "voucherType": "string",
        "voucherNo": "string",
        "accountSetNo": "string",
        "reportIds": [
            "string"
        ],
        "baseReportList": [
            {
                "reportId": "string",
                "reimburseType": "INTERNATIONAL_REIMBURSEMENT_FORM",
                "subsidiaryCode": "string"
            }
        ]
    }
]'

返回响应

🟢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": ""
    }
  ]
}