1. 交易明细-当日、历史明细批量新增接口

1.1. 接口概要信息

接口名称	交易明细-当日明细批量新增接口	接口编码	FSSC-API-000207
接口类型	同步类	所属系统	资金管理系统
数据类型	交易明细-当日明细数据	厂商
版本	V3.9.4	服务端	资金系统
数据流向	外系统→资金系统	接口调用方式	实时
接口协议	HTTP JSON	接口频次
单次最大数据量		前置接口	无
唯一主键		同步方式

1.1. 接口说明

1.1.1. 说明

外系统推送账户管理信息到资金系统，资金系统收到请求后对入参的唯一标识的唯一性、各字段的必填性、格式的正确性以及是否能生成/更新账户等进行校验，校验通过后将接口数据存入，并在资金系统-账户管理写入数据；校验不通过返回失败原因。

1.1.2. 流程

1.1.2.1. 时序图

1.1.2.2. 正向流程

由外部系统主动发起，根据外部系统的传入参数校验通过后将接口数据存入，并在资金系统-交易明细-当日或历史明细写入数据。如果交易时间传当天，写当日明细表，传历史，写历史明细表。

1.1.2.3. 逆向流程

资金系统收到请求后对入参的唯一标识的唯一性、各字段的必填性、格式的正确性以及是否能生成/更新账户等进行校验，校验不通过返回失败原因。

1.1.3. 注意事项

1.2. 请求参数

参数名称	参数	参数类型	是否必填	说明
交易流水号	transactionNo	VARCHAR2(120)	否	9要素组成唯一标识判重
账号ID	accountId	VARCHAR2(64)	是
银行账号	bankNumber	VARCHAR2(100)	是	9要素组成唯一标识判重
账户名称	accountName	VARCHAR2(300)	否
开户行名称	openBankName	VARCHAR2(200)	否
交易类型	transactionType	CHAR(1)	是	9要素组成唯一标识判重
交易币种	transactionCurrencyCode	VARCHAR2(64)	是	9要素组成唯一标识判重
交易币种名称	transactionCurrencyCodeName	VARCHAR2(64)	否
交易金额	transactionAmount	NUMBER(19,2)	是	9要素组成唯一标识判重
交易后余额	bookBalance	NUMBER(19,2)	否
对方账号	othBankNumber	VARCHAR2(200)	否	9要素组成唯一标识判重
对方户名	othAccountName	VARCHAR2(200)	否
对方开户行名称	othOpenBankName	VARCHAR2(200)	否
对方总行名称	othBankName	VARCHAR2(200)	否
交易用途	transactionPurpose	VARCHAR2(1500)	否	9要素组成唯一标识判重
摘要	remark	VARCHAR2(1500)	否	9要素组成唯一标识判重
交易时间	transactionDate	TIMESTAMP(6)	是	9要素组成唯一标识判重
账户编码	accountCode	VARCHAR2(100)	否
开户行	openBank	VARCHAR2(64)	是
指令json集合	instructionList	List	否
回单编号	billReceiptNo	VARCHAR2(64)	否
归集标签	collectionType	VARCHAR2(64)	否
产品保留字段11	prod11	VARCHAR2(64)	否	新增产品保留字段11
产品保留字段12	prod12	VARCHAR2(64)	否	新增产品保留字段12
产品保留字段13	prod13	VARCHAR2(64)	否	新增产品保留字段13

示例

[
{
"transactionNo": "1",
"accountId": "79cd78db62b177d3aed8b1b0aeb2001c",
"bankNumber": "888898870093",
"accountName": "test124",
"openBankName": "中国工商银行股份有限公司深圳工业区支行",
"transactionType": "1",
"transactionCurrencyCode": "CNY",
"transactionCurrencyCodeName": "人民币",
"transactionAmount": 1,
"othBankNumber": "1113",
"othAccountName": "对方户名",
"othOpenBankName": "对方开户行",
"othBankName": "总行",
"transactionPurpose": "交易用途",
"remark": "摘要1",
"transactionDate": "2023-12-04 14:48:19",
"instructionIds": "",
"instructionNumbers": "",
"accountCode": "88888",
"openBank": "ffd9889a-7200-44c8-8d1a-010316d37300",
"instructionList": []
}
]

1.1. 响应结果

出参说明：

参数名称	参数	参数类型	说明
消息提示	msg	String(20)	消息提示，有错误时需要用到
消息编码	code	Integer(15)	0表示成功，其它表示失败
消息类型	type	String(20)	错误消息：ERROR；提示消息：INFO；确认消息：WARNING;

响应结果示例

{

"code": 0,

"msg": "success",

"type": "INFO"

}

司库当日明细写入接口

司库当日明细写入接口

关于作者

目录