新增
- 接口: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条数据重复数据"
}
}