付款业务单据预留字段二开使用指导

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

适用情况：

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

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

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

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

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

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

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

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

ps：

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

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