
5 月 7 日,一套订单进销存系统完成了 4 家快递的电子面单对接。对接内容包含下单取号、打印模板、取消订单、退货件四个动作,测试共跑了 120 单,其中 20 单专门测取消与退货。
4 家快递的接口字段命名各不相同,同一件事在一家叫 receiverMobile,另一家叫 toPhone。工作室的做法是先在系统里建一张字段映射表,把 4 家的差异收敛到系统自己的 12 个统一字段,后续再加快递只需补映射,不动主流程。
打印模板做了 2 种尺寸:100×180 毫米的热敏面单与 100×150 毫米的常用规格。模板里订单号打的是系统单据号,不是快递单号,仓库拣货时按单据号找货,不会拿错。
测试中发现的问题集中在退货件。退货面单需要把寄件人与收件人对调,部分快递的接口要求在备注字段写原单号。这一条补进映射表后,120 单全部打印成功,面单信息与系统订单字段比对一致。
120 单测试单里,30 单专门造了异常地址:缺手机号、地址带特殊符号、收件人姓名超长三种情况。4 家接口对超长姓名的截断位置不同,统一在系统里先截到 20 个字符再传,避免打印出来折成两行盖住条形码。
上线后第一周实际发货 860 单,打印失败 3 单,全是地址里带特殊符号的那类。工作室把这类地址加进提交前校验,先做一次字符过滤,第二周 940 单没有出现失败,面单信息与系统订单逐条比对一致。
系统里的字段映射表最终收敛到 12 个统一字段:收件人、电话、地址、商品名、数量、重量、备注、原单号、退货标识、预约时间、代收金额、网点编码。4 家快递的差异全部落在映射层,后续接入第 5 家只补 1 张表,主流程代码不改一行。
耗材与打印机也一起验了:100×180 毫米热敏纸在 2 台不同品牌打印机上各打 20 张,走纸偏移都在 1 毫米以内;100×150 毫米规格换了 1 台机器后出现 2 毫米偏移,调了打印机的纸张校准才对齐。这一步写进交付手册第 3 页。