# 1. 内部户明细账-内部户明细账写入接口 ## 1.1. **接口概要信息** | 接口名称 | 内部户明细账-内部户明细账批量新增接口 | 接口编码 | FSSC-API-000185 | | -------------- | ------------------------------------- | ------------ | ----------------- | | 接口类型 | 同步类 | 所属系统 | 资金管理系统 | | 数据类型 | 内部户明细账-内部户明细账数据 | 厂商 |
| | 版本 | 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. **请求参数** | 参数名称 | 参数 | 参数类型 | 是否必填 | 说明 | | ---------------- | --------------------------- | -------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | 明细账数据唯一ID | transactionId | VARCHAR2(120) | 否 | 根据明细账数据唯一ID判重 | | 账号ID | accountId | VARCHAR2(64) | 否 |
| | 本方账号 | bankNumber | VARCHAR2(100) | 是 | | | 本方账户名称 | accountName | VARCHAR2(300) | 否 |
| | 开户单位 | accountOrg | VARCHAR2(300) | 是 | | | 业务类型 | busType | VARCHAR2(64) | 是 | 默认内部户单据 | | 交易类型 | transactionType | VARCHAR2(64) | 是 | ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2025/03/06/1830A2CEFFFF91415D6C400DB1B7B2AE1465.png) | | 交易币种 | transactionCurrencyCode | VARCHAR2(64) | 是 | | | 交易币种名称 | transactionCurrencyCodeName | VARCHAR2(64) | 否 |
| | 交易金额-贷 | amount**Credit** | NUMBER(19,2) | 否 | 交易金额-借或贷必须有一个有值，否则提示
“交易金额-借或贷必须有一个有值” | | 交易金额-借 | amount**Lend** | NUMBER(19,2) | 否 | 交易金额-借或贷必须有一个有值，否则提示
“交易金额-借或贷必须有一个有值” | | 借贷标识 | flag | VARCHAR2(64) | 是 | 借或贷 | | 交易后余额 | bookBalance | NUMBER(19,2) | 否 |
| | 对方账号 | othBankNumber | VARCHAR2(200) | 否 | | | 对方户名 | othAccountName | VARCHAR2(200) | 否 |
| | 内部户业务单号 | boeNo | VARCHAR2(200) | 否 | | | 交易用途 | transactionPurpose | VARCHAR2(1500) | 否 | | | 摘要 | remark | VARCHAR2(1500) | 否 | | | 业务日期 | transactionDate | TIMESTAMP(6) | 是 | | | 产品保留字段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" ``` }

司库内部户明细账写入接口

司库内部户明细账写入接口

关于作者

目录