新增

  • 接口:common/glCashFlowReconciliationBankJournals/batch
  • Method:POST
  • 数据格式:JSON
  • 限流信息:100次每天和50次每小时
  • 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
  • 接口说明:该接口用作银行日记账的批量同步,在整批数据中如果只有几条数据因为其他原因失败,那么只有这几条数据不会被处理,其他数据仍会被正常处理
  • 其他补充信息:单次数据量过大时候(超过200条)会全部转为异步处理,具体参考回调示例

参数:

请求参数

字段名称 字段类型 字段描述 是否必填 长度限制(字节)
bizId String 当前次接口同步的唯一标识 TRUE 36
timestamp long 当前次接口同步对应的时间戳 TRUE 13
data Array 当前次接口同步的数据集合 TRUE
data.code String 唯一编码 TRUE 64
data.journal_num String 凭证号 TRUE 64
data.voucher_line_number INTEGER 凭证行号 TRUE 11
data.structure_name String 会计科目类型名称 TRUE 255
data.gl_account_code String 会计核算编码 TRUE 64
data.receipt_currency String 币种信息 TRUE 64
data.rec_pay_id Char 借贷标记(01-借;02-贷) TRUE 2
data.receipt_amount BigDecimal 交易发生额 TRUE 13
data.voucher_date Long 记账日期 TRUE
data.reconciliation_code String 记账码 FALSE 64
data.document_num String 单据号 FALSE 64
data.opposite_account_name String 对方账户名 FALSE 128
data.opposite_account_number String 对方账号 FALSE 64
data.opposite_bank_name String 对方银行名称 FALSE 64
data.journal_text String 日记账文本 FALSE 255

返回参数

字段名称 字段类型 字段描述
bizId String 当前次接口同步的唯一标识
resCode Integer 响应状态码(见附录)
resMsg String 返回信息描述
created String 创建成功的条数
updated String 记录重复的条数
validatorErrors Array 字段强校验不合格的数据
dbErrors Array 数据持久化时出现错误的数据
warnings Array 字段弱校验不合格的数据,任会做同步处理

示例:

请求数据

{
  "bizId": "c40f1bf0-e757-4a72-8863-fd6749821584",
  "timestamp": 1591266599229,
  "data": [
    {
      "code": "journal_num2",
      "gl_account_code": "1001111",
      "journal_num": "1001111",
      "structure_name": "default",
      "document_num": "EXP0000000001",
      "reconciliation_code": "journal_code",
      "receipt_currency": "receipt_currency1",
      "receipt_amount": 1.0,
      "rec_pay_id": "01",
      "voucher_line_number": 1,
      "voucher_date": 1591266599229
    },
    {
      "code": "journal_num3",
      "gl_account_code": "1001",
      "journal_num": "1001111",
      "structure_name": "default",
      "document_num": "EXP0000000001",
      "reconciliation_code": "journal_code",
      "receipt_currency": "receipt_currency1",
      "receipt_amount": 1.0,
      "rec_pay_id": "01",
      "voucher_line_number": 1,
      "voucher_date": 1591266599229
    }
  ]
}

返回数据

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "c40f1bf0-e757-4a72-8863-fd6749821584",
  "data": {
    "validatorErrors": [
      {
        "code": "journal_num2",
        "messages": [
          "会计核算编码1001111不存在"
        ]
      }
    ],
    "created": "此次请求新建成功了1条数据",
    "warnings": [],
    "dbErrors": [],
    "updated": "此次请求0条数据重复数据"
  }
}

results matching ""

    No results matching ""