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

接口编号：FSSC-API-000077

接口诞生版本：3.8

所属系统：流水认领系统

所属微服务：zfs-claim

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

单次调用最大条数：1000

注意事项：

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

2、需保证流水3要素（票据编号+收票方账号+交易时间）的唯一性，如已在系统存在，则此条数据同步失败；

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

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

5、由接口推送过来的流水的流水状态为待清分，数据来源为接口导入。

请求参数

参数名	中文名称	参数类型	是否必填	示例	说明
▼data	收票流水数据集合	array	Y
billNo	票据编号	string	Y	b48fb0797e84f366be98b1b7b2ae000e
receiptName	收票方户名	string	N	新云通信公司
receiptAccount	收票方账号	string	Y	3772867000091234567
receiptUnitedCode	收票方开户行联行号	string	N	402161042012
receiptBankName	收票方开户行	string	N	中国工商银行股份有限公司深圳工业区支行
payName	上手背书人户名	string	N	千优
payAccount	上手背书人账号	string	N	3882860733332867891
payBankName	上手背书人开户行	string	N	广发银行股份有限公司东莞麻涌支行
currency	币种	string	Y	CNY	CNY：人民币，只接收币种为人民币的流水
amount	交易金额	string	Y	111.00
actDate	交易时间	string	Y	2022-09-10 10:00:00	格式：yyyy-mm-dd hh:mm:ss
useage	交易用途	string	N	流水同步
explainInfo	摘要	string	N	流水同步
issueDate	出票日期	string	Y	2022-06-09	格式：yyyy-mm-dd
dueDate	到期日期	string	Y	2023-06-09	格式：yyyy-mm-dd
billType	票据类型	string	Y	001	商业承兑汇票/002；银行承兑汇票/001；支持扩展
paperTypeCode	票据形式	string	Y	001	纸票/002；电票/001；支持扩展
drawerAccount	出票人账号	string	N	6222600260001072567
drwrAcctsvcrName	出票人开户行	string	N	中国工商银行股份有限公司深圳工业区支行
drawer	出票人全称	string	N	安达有限公司
receiptAccessoryName	回单名称	string	N	流水.pdf	回单链接地址填写时，则必填
receiptUrl	回单链接地址	string	N	M00/02/55/wKgCVWNt8USAIbw2AACXMUYKUiY234.pdf	需为接口提供方的文件服务器的文件地址
hostid	银行流水号	string	N	dc04eb4effffef8e318cee34b1b0aeb200dc
memo	备注	string	N	流水同步
externalId	外系统唯一键	string	N	8336f30e7e3ea490c170b1b9b2ae130c
createBy	创建者	string	N	cb05ce77-c491-4e30-bc5e-b22f9024a304
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

返回参数

参数名	中文名称	参数类型	示例	参数说明
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": [
    {
      "billNo": "210479100303620190521399461090",
      "receiptName": "新云通信公司",
      "receiptAccount": "3772867000091234567",
      "receiptUnitedCode": "402161042012",
      "receiptBankName": "中国工商银行股份有限公司深圳工业区支行",
      "payName": "千优",
      "payAccount": "3882860733332867891",
      "payBankName": "广发银行股份有限公司东莞麻涌支行",
      "currency": "CNY",
      "amount": "111",
       "actDate": "2022-09-10 10:00:00",
       "useage": "流水同步",
      "explainInfo": "流水同步",
      "issueDate": "2022-06-09",
      "dueDate": "2023-06-09",
      "billType": "001",
      "paperTypeCode": "001",
       "drawerAccount": "6222600260001072567",
       "drwrAcctsvcrName": "中国工商银行股份有限公司深圳工业区支行",
       "drawer": "安达有限公司",
       "receiptAccessoryName": "流水.pdf",
       "receiptUrl": "M00/02/55/wKgCVWNt8USAIbw2AACXMUYKUiY234.pdf"
      "hostid": "dc04eb4effffef8e318cee34b1b0aeb200dc",
      "memo": "流水同步",
      "externalId": "8336f30e7e3ea490c170b1b9b2ae130c",
      "createBy": "cb05ce77-c491-4e30-bc5e-b22f9024a304",
      "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）

关于作者

目录