接口描述

请求地址：/prepayPayment/paymentBillQuery

接口编号：FSSC-API-000170

接口诞生版本：3.9.4

所属系统：共享运营系统

所属微服务：zfs-op

接口说明：本接口旨在生成支付指令后，供外部系统查询使用，以返回与支付指令相关联的汇票明细及支付金额信息。同时，当内部资金系统启用时，该接口将自动推送应收汇票明细至资金系统。

注意事项和整体逻辑：

1.外部系统调用，外部系统调用时，按接口正常返回对应的参数

2.资金系统调用，当支付属性=应收汇票时，通过定时器【共享推送支付命令到资金系统】推送支付申命令到资金时，需先通过“paymentNo/实付指令编码”查询到对应的指令的汇票明细信息，后按映射关系拼接到推送接口bills区，完成内部推送

单次调用最大条数：1

最大条数：1000返回数据上限

报文编码格式：UTF-8

注意事项：

请求参数

参数名	中文名称	参数类型	是否必填	示例	参数说明
▼data	请求数据	object	Y		请求数据
sourceSystem	来源系统	string	N	ZTE	外系统标识，由外系统自己定
paymentNo	实付指令编码	string	N	ZTEDD-PAY202205260001
prePaymentNo	预支付指令编码	string	N	ZTEDD-PAY202205260001	实付指令编码或预支付指令编码必须填写一个，二选一。若两者均未填写，报错：“必须填写实付或预支付指令编码，请检查”。若两者都填写，报错：“只能选择填写实付或预支付指令编码其中一个，请检查”。编码格式：多个编码用^隔开。单个编码长度不超过63个字符。最多可查询1000个编码。
groupCode	集团编码		N	ZTEDD	为空则取当前登录人集团信息，不为空则取当前集团数据进行过滤；需校验集团编码数据有效性；同一接口数据中集团编码需要唯一，否则报错“集团编码不唯一，请重新推送” 如果为空时也无法获取到当前登录人信息，则报错“集团编码不存在，请重新确认后推送”
limit	查询条数		Y	100	返回的查询结果条数，上限1000，超过上限值则报错
page	页数		Y	1	为空则默认第一页，不为空则取当前值

返回参数

参数名	中文名称	参数类型	是否必填	示例	说明
msg	信息	string		成功	返回消息
code	编码	string		1	处理结果编码，0表示成功，其它表示失败
▼data	数据	object	Y		返回对象
currPage	当前页数	string	Y	1	当前
totalPage	总页数	string	N	1
pageSize	每页记录数	string	Y	1
totalCount	总记录数	string	N	1
▼date	返回数据	array	N		返回数据
boeNo	单据号	string			支付指令所在的单据编号
boeId	单据ID	string
sourceSystem	来源系统	string			默认传FSSC
billId	主键ID	string		y8ro2qhdqo8y13123	汇票ID
leId	核算主体	string		47382193789127	核算主体ID
billNum	汇票编码	string		32132321	汇票编码
allExpenseAmount	出票金额	number		2000.00	汇票出票金额
subticketStart	子票序列开始区间	string
subticketEnd	子票序列结束区间	string
ticketChangesFlag	是否可拆分	string		Y	Y/N；可拆分/不可拆分
bankAccount	持票人账号	string		43214643
expenseDate	出票日期	date		2023-11-26	YYYY-MM-DD
signDate	签收日期	date		2024-10-26	YYYY-MM-DD
loanRepaymentDate	汇票到期日	date		2024-11-26	YYYY-MM-DD
waitCavAmount	可用金额	number		1000.00
oriBillId	母票ID	string		41223123
oriBillCode	母票编码	string		321321
expenseAmount	本次背书金额	number		276.00

相关校验：

1.需要校验集团存在有效性，若集团编码不存在/有效则接口报错：“集团编码【groupCode】+值不存在/无效，请检查”

示例：“集团编码【groupCode】TEDD不存在/无效，请检查”

2.若集团+实付指令编码不存在则接口报错：“集团编码【groupCode】+值，指令编码【paymentNo】+值，不存在。请检查“

2.若集团+预付指令编码不存在则接口报错：“集团编码【groupCode】+值，指令编码【prePaymentNo】+值，不存在。请检查“

修改集团级定时器【共享中心-共享推送付款申请单到资金】

针对开启资金的集团的且结算方式属性=应收汇票时，在推送付款申请单到资金时需要调用本查询接口获取对应指令的应收汇票明细和金额拼接后传输给资金系统

接口新增区域字段映射，资金接口文档详情见附件

新增区域

编码映射：

共享侧-date			资金侧-bills:区
字段编码	字段类型	字段名称	字段编码	字段类型	必填	字段名称
id	String	主键ID	billId	String	是	票据ID
expenseAmount	BigDecimal	本次背书金额	busAmount	BigDecimal21	是	业务金额（背书）
postalOrderCode	String	汇票编码	postalOrderCode	String	是	汇票编码

请求参数示例

{
  "data": {
    "paymentNo": "ZTEDD-PAY202205260001",
    "sourceSystem": "ZTE",
    "prePaymentNo": "",
    "limit": "10",
    "page": "1",
    "groupCode": "ZTEDD"
  }
}

返回参数示例

{
  "msg": "成功",
  "code": "0",
  "data": {
    "currPage": "1",
    "data": [
      {
        "boeNo": "",
        "boeId": "",
        "sourceSystem": "",
        "leId": "47382193789127",
        "billNum": "32132321",
        "billId": "y8ro2qhdqo8y13123",
        "allExpenseAmount": "2000",
        "subticketStart": ""
        "subticketEnd": "",
        "ticketChangesFlag": "Y",
        "bankAccount": "43214643",
        "expenseDate": "2023-11-26",
        "signDate": "2024-10-26",
        "loanRepaymentDate": "2024-10-26",
        "oriBillCode": "321321",
        "oriBillId": "41223123",
        "expenseAmount": "276",
        "waitCavAmount": "1000",
      }
    ],
    "totalPage": "1",
    "pageSize": "10",
    "totalCount": "100"
  }
}

支付指令-票据查询接口（3.9.4）

支付指令-票据查询接口（3.9.4）

关于作者

目录