/
SnapPay pos收银应用商户定制收银流水号规则技术实施方案

SnapPay Developer Documents

SnapPay pos收银应用商户定制收银流水号规则技术实施方案

背景



SnapPay现有一批商户,使用安装在WPOS上自己开发的APP管理业务订单,下单后人工打开SnapPay的收银APP进行支付收银,由于是人工单独操作这两个APP,系统无法知道关联业务订单与支付订单,只能通过人工的方式录入

SnapPay平台的交易单号到商户自有的业务APP,现商户为提供工作效率,希望能够通过扫码设备扫描SnapPay打印

的支付小票的条码,进行快捷录入,由于SnapPay目前的交易号是23位长度并且没有一维码,故商户希望SnapPay能调整现有系统,按商户的规则生成13位的订单号,方便商户方系统的识别。



主要修改点

商户自定义生成POS收银应用的订单号主要涉及以下几方面的修改:



1.商户参数配置

  运营平台omp WPOS Terminal 收银设置 增加配置项:打开商户自定义订单号生成的开关,只能开不能关,

设置订单号编码规则

 

前期开发时,已预估此类业务需求,已设计表 t_cs_device_settings,可存储商户某个应用的某个设备的,根据业务可自由定制与扩展的业务参数



门店和终端添加外部门店号和外部终端号的字段

 

 

2.个性化生成下单订单号

WPOS Terminal下单时,读取以上商户配置的参数,若商户开启了自定义订单号生成规则配置,则按照此规则生成订单号,其他没有开启此功能的商户按原有逻辑正常生成订单号



3.POS小票打印商户订单号一维码,用于商家识别

WPOS Terminal初始化时返回商户参数设置时,会增加设备参数的返回,POS应用拉取并缓存此配置,WPOS Terminal客户端应用按照返回的参数判断订单显示及小品打印的规则,若开启了个性化订单号生成的开关,则显示订单号及订单号一维码,否则按照原有逻辑显示及打印





订单支付流程

 



开发工作项

序号

功能项

后端修改点

前端修改点

1

商户参数设置

pbs新增,修改,查询商户自定义订单号生成规则配置

omp页面相关修改

2

POS订单展示与打印

pbs设备初始化时返回相关配置信息

POS收银应用缓存配置信息,订单详情展示及小票打印格式调整

3

POS订单号生成

读取配置,根据规则生成订单号





数据库设计及配置



本次功能,涉及的数据库表有如下三个:

t_cs_merchant_settings     商户业务配置,配置商户级别的业务数据,应用于该商户下所有的门店及设备



具体表结构如下:

 

配置SQL示例:

 

只需要修改红色部分相应的值,此例中902000305587为商户号,QYR54NB0为WPOS设备号,25为商户外部门店号,03为外部设备号



原始SQL示例如下:

INSERT INTO `t_cs_merchant_settings`(merchant_no,biz_code,attr_key,attr_value,create_time,update_time) VALUES ('902000305587', 'B001', 'is_custom_gen_orderno', 'true', SYSDATE(), SYSDATE()); INSERT INTO `t_cs_merchant_settings`(merchant_no,biz_code,attr_key,attr_value,create_time,update_time) VALUES ('902000305587', 'B001', 'gen_orderno_mode', '13', SYSDATE(), SYSDATE()); UPDATE t_aps_store set outer_store_id = '25' where store_no = '80002112'; UPDATE t_aps_terminal set outer_terminal_id = '03' where device_en = 'QYR54NB0';

 

Copyright reserved for SnapPay Inc 2019.