近日接单二次开发ERP增加电子面单的活儿，最开始选择了快递100、快递鸟和菜鸟裹裹。菜鸟裹裹流程复杂，首先被淘汰。而快递100使用java 8+的代码而客户ERP开发年代较早版本仅为1.6，会导致系统版本升级和大量函数重写，开发成本高昂周期不可控，且需配备专用打印设备。而快递鸟的API代码无关系统版本，不会导致老ERP连带系统版本升级，相对开发成本更容易接受。
使用厂家DEMO很快就调试出了相关数据，Json发起编码请求包，服务器再返回Json解码，使用Google的Gson解码后封包到对象。
“PrintTemplate”: “<!DOCTYPE html>…”,
“EBusinessID”: “test1652015”,
“UniquerRequestNumber”: “327ceb7c-XXXXXXXXXXXXXX”,
“ResultCode”: “100”,
“Reason”: “成功”,
“Success”: true”
返回报文已经自带打印模板，这样对打印终端就没有任何限制，企业可以使用现成的设备打印。返回消息后将返回的PrintTemplate存储到文件，就可以实现面单的多次打印。
然而真正的电子面单开发根本写不了多久，最坑的还是ERP配套，这也是二次开发最耗时费力的部分。
因为快递鸟要求传递必须到区一级，第一步要解决的就是精确到区一级的数据，在网上找到精确的区一级数据后发现麻烦接踵而至。因为原ERP系统只精确到市一级，且很多名称未加上“市”，更麻烦的是，原有系统的省市ID不能动，ERP系统的订单统计、门店、门店隶属关系和门店绑定人员、运费计算都依赖该ID，所以直接用新表替换旧表这条路还走不通。只能先用调试数据库完善数据，再把新表的区一级数据做插入，然后汇总成完善的三级地区表。
1、首先得把省一级名称统一，方便跟精确数据库匹配数据，有些加了自治区，行政区的名称手工改成一致，这样省一级先保证跟新数据的名称统一。
2、第二步就得把排除直辖市以后，目前所有的二级地区名称加上“市”，然后就好用找到的精确数据库做同步增区。
update X set X=X||’市’ where level=2 and id in(select id from X where area_name!=’北京’ and area_name!=’天津’….);
这样ERP旧库中省市一级名称就同步了，为给快递了传三级取值方便。
3、接下来还得为ERP地区数据库增加一个全名：”浙江省,台州市,路桥区”，于是数据库增加字段：merger_name。
4、再用关联查询比对二级名来生成插入旧库插入语句：
select ‘INSERT INTO X (parent_id, area_name, merger_name) VALUES (‘||b.id||’,”’||a.area_name||”’,”’||a.merger_name||”’);’ from NEW_area a,X b where b.parent_id>0 and a.merger_name like ‘%’||b.area_name||’,’||’%’ and a.merger_name NOT LIKE ‘北京%’ and a.merger_name NOT LIKE ‘天津%’ ….
最后执行生成的插入SQL指令，最终完成扩区。
5、原系统门店模块必须升级改造，从二级选单改为三级选单，重写原有的javascript选单。并且为数据库的门店表增加县一级id字段，因此需要更新添加门店和门店更新页。同时实现未选择区县一级的下单拦截和三级显示。
6、门店下单模块考虑加盟店和淘宝店发货并非用门店自身地址，因此需要同步增加三级联动，且限制非直辖市以外的地区不选区县下单。
如果选择加盟店下单，还需要考虑加盟店地址不完善的情况，提示门店先完善地址再下单，未完善地址的门店不允许被选中。
7、订单模块需要在下单时存储门店的地区全程，方便为快递鸟传值，所以订单表需要增加merger_name字段。同时因为电子运单的重量滞后性，首次提交无重量的电子运单不改变订单状态为已发货或缺货状态。
8、订单显示页面，需要增加客服点击电子运单发货，实现订单跟踪记录和扣费的插入。同时原有快递可达城市校验，需要将电子单跟原有实体单合并。
9、因为电子单是自动生成单号，所以选择后需要屏蔽前端运单输入，只保留运费和补货选项。同时升级地区数据库后的名称改变，还需同步将到达省市的运费数据重新添加。原有选省，输入市名的方式也需改为二级联动选单。
10、最后通过前端用户按下物流提交按钮，系统后台增加代码完成电子运单的传递、扣费、写单，并写入物流跟踪消息。订单无区级明细的老订单，不允许使用电子面单提交。
11、界面实现如果用户选择电子面单，做完快递到达省份校验通过后，就屏蔽单号的前端输入项，使用系统自动生成的单号填入。选择非电子单则取消单号输入的屏蔽。
12、订单流转表为区分是否为电子面单，需要增加快递鸟的唯一标识UniquerRequestNumber字段。这样就可以区分哪些是电子面单，那些是纸质面单。而电子面单就可以增加跳转链接到系统保存好的打印样式页。如果存在同订单号，同公司的信息被客服提交，需要系统确认只扣费一次。因系统订单号对应一家快递公司只生成一次运单号，因此需要为订单表增加计数器，点一次打印计数器增加1，并把累加数字追加到传递给快递公司的订单号中，达成一个订单多次生成运单号的功能。
13、同时需求还得满足先生成电子单，后填相同快递单和重量再计费的方式。第一次插入电子快递单只要重量为零就不扣费，有重量以后再计费。
14、因快递公司模板部分未插入HTML标记，保存后的模板打开就显示乱码，因此需要判断HTML头部是否有UTF-8编码指定，没有就插入标记后再写入HTML文件。最后根据打印机调整TemplateSize传递参数以适合尺寸。
15、为避免订单表中未有merger_name字段填充的订单使用电子运单报错，需要限制ID大于部署日期才允许使用电子面单。
16、中心发货，订单明细，订单查询，订单列表，订单打印，导出，订单老打印模版所有涉及地址的部分，都改为merger_name加地址信息输出。