付款业务单据预留字段二开使用指导原创
金蝶云社区-毛竹
毛竹
0人赞赏了该文章 402次浏览 未经作者许可,禁止转载编辑于2022年10月18日 15:02:27

应用背景:星空可以对接银企平台进行提交银行付款,而银企对接了各种各样的银行,付款时不同银行需要的付款信息会有所不同,这时就会有传特殊付款信息给银企的场景和需求,以前通常需要星空和银企两边一起改动,一个传,一个接收,还需要等待标准补丁再升级,比较麻烦。而现在,星空在银行付款单预置了三个字段(预留字段、预留字段2、预留字段3),通过简单的二开就可以满足客户部分特殊付款信息传给银企的需求。

适用情况:

1.已跟银企确认了特殊付款信息银企那边会从预留字段里取值,这种情况只需要在星空二开,给预留字段传值即可;

2.自己在星空和银企两边自行二开,即在星空这边二开使用预留字段传值,然后在银企那边二开从预留字段里取值(银企二开指导请咨询银企平台)。

使用说明:下面以付款单为例子介绍预留字段在星空这边怎样二开使用。

一、在付款单上新增二开字段,用于填入需要给银企传的值,以文本字段为例。

图示1.png

二、在对应单据转换的字段映射里将新增二开字段映射给预留字段,因为传给银企时会按"Key=Value"的格式进行解析(多个则用英文分号;作为分隔符),所以注意格式要按如下拼接格式进行配置(Key是要和银企约定好的,这样银企接收到才能根据Key取到正确的Value)。

图示2.png

ps:如果是特殊二开字段控件,比如是复选框,字符串和布尔值拼接会报错,则需要使用str()函数将字段转换一下,即"Key="+str(Value),避免因格式转换错误而报错。

三、在付款单二开字段填入要传的值,按正常操作进行付款就可以把二开字段的值传到银企了。

图示3.png

四、查看银企平台付款接口(pay)的日志,预留字段对应日志的reserveds,验证是否成功。

图示4.png

ps:

1.星空“预留字段”对应银企日志的“reserveds”,星空“预留字段2”对应银企日志的“reserved2”,星空“预留字段3”对应银企日志“的reserved3”

2.reserved1用于传入账类型,reserved2和reserved3银企一般会用来接收特定信息,且一个字段只能接收一个值,所以使用前需要和银企确认好,这两个字段直接按常规方法映射二开字段就好,不需要按"Key=Value"的格式配置。

赞 0