请求地址：/import/3_8/claimInOutFlow

接口编号：FSSC-API-000076

接口诞生版本：3.8

所属系统：流水认领系统

所属微服务：zfs-claim

接口说明：银行流水同步接口用于接收银行账户交易明细数据，接收成功会在流水认领-流水管理进行体现，进而实现流水数据后续的款项确认和认领报账业务。

单次调用最大条数：1000

注意事项：

1、同一批次，失败的数据不影响成功的数据写入；

2、需保证流水十要素（交易类型+本方银行账号+对方银行账号+币种+金额+银行流水号+交易时间+交易用途+摘要+特殊唯一要素）的唯一性，如已在系统存在，则此条数据同步失败；

3、仅支持数据新增，不支持数据更新。

4、界面说明：

①　若借贷标识为贷则同步至收款流水页签，流水类型为收款，银行账号、户名、开户行、联行号对应收款方账号、收款方户名、收款方开户行、收款方联行号，对方账号、户名、开户行、联行号对应付款方账号、付款方户名、付款方开户行、付款方联行号；

②　若借贷标识为借则同步至扣款流水页签，流水类型为扣款，银行账号、户名、开户行、联行号对应付款方账号、付款方户名、付款方开户行、付款方联行号，对方账号、户名、开户行、联行号对应收款方账号、收款方户名、收款方开户行、收款方联行号；

③　同步成功后若户名、开户行、开户行联行号未填写则需根据银行账号（公司账号）带出；若对方户名、对方开户行、对方联行号未填写则需根据对方账号（客商以及员工账号）带出，若找不到则不带出；核算主体和往来方带出规则见认领平台全量文档-流水管理（收款/扣款流水）章节；

④　由接口推送过来的流水的流水状态为待清分，数据来源为接口导入，在流水管理界面不可编辑、删除；

5、回单说明：

①　对于回单地址、名称是否写入的判断依据为流水的内部文件地址是否为空，为空则写入，否则不写入，与流水状态无关；

②　特别的，在流水状态为已拆分时，同步覆盖到子流水，此时与子流水的状态也无关，只需判断子流水的内部文件地址是否为空，为空则写入，否则不写入；

③　回单来源标识为接口同步，在回单弹框中不可删除，可预览、下载；

④　页面的下载和预览，均是通过内部文件地址进行操作；

请求参数

参数名	中文名称	参数类型	是否必填	示例	说明
▼data	银行流水数据集合	array	Y
hostid	银行流水号	string	Y	418957ed7207d8da8a55b1b9b2ae0af5
dirflag	借贷方向	string	Y	OUT	OUT：借-付款 IN：贷-收款
name	本方账户名	string	N	新云通信公司	若传值，则根据【财务数据-公司账户】进行一致性校验；若不传，则根据银行号自动生成。
account	本方银行账号	string	Y	3772867000091234567
bankName	本方开户行	string	N	中国工商银行股份有限公司深圳工业区支行	若传值，则根据【财务数据-公司账户】进行一致性校验；若不传，则根据银行号自动生成。
unitedCode	本方联行号	string	N	402161042012	若传值，则根据【财务数据-公司账户】进行一致性校验；若不传，则根据银行号自动生成。
otherAccount	对方银行账号	string	N	3882860733332867891
otherName	对方账户名	string	N	千优
otherBankName	对方开户行	string	N	广发银行股份有限公司东莞麻涌支行
currency	币种	string	Y	CNY
amount	交易金额	string	Y	12.32
actDate	交易时间	string	Y	2022-12-14 13:47:54	格式：yyyy-mm-dd hh:mm:ss
uniqueNo	特殊唯一要素	string	N	btadhiu8923847be891341ad
useage	交易用途	string	N	银行流水同步
explainInfo	摘要	string	N	银行流水
receiptAccessoryName	回单名称	string	N	流水.pdf	回单链接地址填写时，则必填
receiptUrl	回单链接地址	string	N	M00/02/55/wKgCVWNt8USAIb w2AACXMUYKUiY234.pdf	需为接口提供方的文件服务器的文件地址
bankHostId	银行原始流水号	string	N	111
memo	备注	string	N	银行流水
externalId	外系统唯一键	string	N	8336f30effff8f0743295c27b1b9b2ae0d06	此ID与回单ID一致时，触发【外系统唯一键】匹配，详情见链接-流水回单写入接口（3.8）http://tmpbbs.ztc.ztccloud.com.cn:6875/article/1274987
createBy	创建者	string	N	913a59876f9d1d517537b1b9b2ae0217
extendS1	扩展 String 1	string	N	扩展 String 1
extendS2	扩展 String 2	string	N	扩展 String 2
extendS3	扩展 String 3	string	N	扩展 String 3
extendS4	扩展 String 4	string	N	扩展 String 4
extendS5	扩展 String 5	string	N	扩展 String 5
extendS6	扩展 String 6	string	N	扩展 String 6
extendS7	扩展 String 7	string	N	扩展 String 7
extendS8	扩展 String 8	string	N	扩展 String 8
extendS9	扩展 String 9	string	N	扩展 String 9
extendS10	扩展 String 10	string	N	扩展 String 10
rowNum	行号	string	N	1	外系统传过来的行号，用于接口返回时告知外系统哪一行数据同步失败了
rowId	数据行ID	string	N	ae43563bffffcf30b2b221a3b1b2b7ae539b	外部接口调用需推送ID定位，未传则此字段返回为空。（建议外系统传唯一ID）

返回参数

参数名	中文名称	参数类型	示例	参数说明
code	编码	string	0	0-全部成功;1-全部失败;2-部分成功
msg	信息	string	全部成功	消息提示
successNum	成功条数	string	0	成功条数
failNum	失败条数	string	1	失败条数
▼data	数据	array		返回数据
rowId	行ID	string		接口平台数据同步标识
rowNum	行号	string	1	行号
errMsg	错误信息	string		每行错误消息

请求参数示例

{
  "data": [
    {
      "hostid": "418957ed7207d8da8a55b1b9b2ae0af5",
      "dirflag": "OUT",
      "name": "新云通信公司",
      "account": "3772867000091234567"
      "bankName": "中国工商银行股份有限公司深圳工业区支行",
      "unitedCode": "402161042012",
      "otherName": "千优",
      "otherBankName": "广发银行股份有限公司东莞麻涌支行",
      "currency": "CNY",
      "amount": "12.32",
      "actDate": "2022/9/23 13:47",
      "uniqueNo": "",
      "otherAccount": "3882860733332867891",
      "useage": "银行流水同步",
      "explainInfo": "银行流水",
      "receiptAccessoryName": "流水.pdf",
      "bankHostId": "111",
      "memo": "银行流水",
     "receiptUrl": "M00/02/55/wKgCVWNt8USAIbw2AACXMUYKUiY234.pdf",
      "externalId": "8336f30effff8f0743295c27b1b9b2ae0d06",
      "createBy": "913a59876f9d1d517537b1b9b2ae0217",
      "extendS1": "扩展 String 1",
      "extendS2": "扩展 String 2",
      "extendS3": "扩展 String 3",
      "extendS4": "扩展 String 4",
      "extendS5": "扩展 String 5",
      "extendS6": "扩展 String 6",
      "extendS7": "扩展 String 7",
      "extendS8": "扩展 String 8",
      "extendS9": "扩展 String 9",
      "extendS10": "扩展 String 10",
      "rowNum": "1",
      "rowId": "38ffbdb043f045ed544eb1b9b2ae034b"
    }
  ]
}

返回参数示例

 {
  "code": "2",
  "msg": "部分成功",
  "successNum": "1",
  "failNum": "1",
  "data": [
    {
      "rowId": "38ffbdb043f045ed544eb1b9b2ae034b",
      "rowNum": "1",
      "errMsg": "错误"
    }
  ]
}

银行流水同步接口（3.8）

银行流水同步接口（3.8）

关于作者

目录