一、功能介绍

前端系统在收付款交易单、历史明细或电子对账单页面电子回单查看,向DSP发送http链接访问指定的回单文件。DSP在接收到请求后,根据请求报文的账号、日期、回单编号、业务参考号、批次号、支付流水号、对账码、交易金额等参数在DSP本地保存回单关系映射的db中查找,找到了会直接在前端系统页面上渲染出来回单文件,找不到会提示未找到回单文件。

其中前端系统和DSP的电子回单查看交互说明参见:https://www.yuque.com/dspgroup/design/dy9f86

二、接口设计

前端系统发送http get请求访问dspweb,向dspweb获取指定的电子回单文件,需在dsp中启动dspweb,首先需要在javadsp\config\DSPSystem.xml中增加dspweb配置:

  1. <disableWeb readme="是否禁用DSPWeb">false</disableWeb>
  2. <webLoginUser readme="DSPWeb登录用户名">root</webLoginUser>
  3. <webLoginPassword readme="DSPWeb登录密码,使用Web加密功能加密的密文,初始密码明文root">IPEZpMiX6SVpW4FOW3TBSw==</webLoginPassword>
  4. <webPort readme="dsp的web页面服务端口">8808</webPort>
  5. <webDirPath readme="dsp的web主目录">{$DSPHOME}\config\Web</webDirPath>
  1. dsp本地开启dspweb后,dsp启动时会提示dspweb启动地址,示例:<br /> ![image.png](https://cdn.nlark.com/yuque/0/2021/png/21915962/1628130975114-f577afca-97d7-4dbb-9581-704d0edf870c.png#clientId=u6bc36fd2-e1e9-4&from=paste&height=414&id=ufd271149&margin=%5Bobject%20Object%5D&name=image.png&originHeight=414&originWidth=836&originalType=binary&ratio=1&size=72133&status=done&style=none&taskId=u50156eec-76dc-4130-942b-f2d4bf2dced&width=836)<br />后续前端系统需要在内部配置该web地址,并传入参数来获取,dspweb读取规则如下:<br />1)根据账号、日期、电子回单编号获取,获取不到走下一步;
  1. select * from "+tabName+" where RECEIPTNO=? and OWNACT=?

2)根据账号、日期、业务参考号获取,获取不到走下一步;

  1. select * from "+tabName+" where OWNACT=? and (BUSREF=? or BUSREF2=? or BUSREF3=?)

3)根据账号、日期、支付流水号获取,获取不到走下一步;

  1. select * from "+tabName+" where OWNACT=? and (BUSREF=? or BUSREF2=? or BUSREF3=?)

4)根据账号、日期、银行流水号获取,获取不到走下一步;

  1. select * from "+tabName+" where BNKSEQNO=? and OWNACT=?

5)根据账号、日期、交易金额、收付方向获取,获取不到报错未找到电子回单。

  1. select * from "+tabName+" where BUSDATE=? and OWNACT=? and AMOUNT=? and MONEYWAY=?

找到后示例:

  1. http://10.60.44.121:8808/receiptdetail?down=0&busdate=20210620&bank=7006&barcode=&bnkseqno=313552021071901002647885447B0AD9&act=00009000356&receiptno=2020082500021718&busref=&abstract=31071973888770&moneyway=1&amount=3860

image.png

找不到示例:

  1. http://10.60.44.121:8808/receiptdetail?down=0&busdate=20210620&bank=7006&barcode=&bnkseqno=313552021071901002647885447B0AD9&act=00009000356&receiptno=2020082500021788&busref=&abstract=31071973888770&moneyway=1&amount=3860

image.png