一套能跑通的「云打印」接入思路（易联云/飞印通用）
门店小票云打印要稳，核心就三件事：把打印机绑到云平台、把票据模板做对、订单来了能自动触发。易联云、飞印这类平台思路都差不多：你在后台拿到商户ID/应用Key/密钥，再把打印机的设备号加进来，云端就能给它派发打印任务。
- 打印机准备：常见是58mm/80mm热敏机，能联网（Wi-Fi/网口/4G）
- 平台侧绑定：添加设备号+门店分组，建议按“店名-收银台1/后厨1”命名
- 系统侧对接：用平台提供的API/SDK，把订单数据发成“打印任务”
票据模板怎么设计，才不会天天被店员吐槽
模板别追求花，追求扫一眼就懂。实操里我建议按“抬头-关键字段-明细-备注-二维码”排。80mm纸宽容错更高，58mm就把字段压缩，别塞满。
模板字段清单（够用版）：
- 订单号（建议后6位加粗）、下单时间、取餐号/桌号
- 商品明细：名称+数量+单价/小计（后厨单可去掉金额）
- 备注：加料/忌口要单独一行放大
- 合计、实收、支付方式
小案例：同一笔外卖单，收银联打“顾客联+商家联”各1张，后厨再打1张。高峰期每单3张，小票长度控制在20-35行，出单速度会明显更稳。
订单自动触发与离线重打：把“漏打”风险压下去
自动触发建议用两段确认：订单支付/接单成功才打印，避免“未付款先出单”。接口上要保存每次打印的任务ID和返回状态，方便追踪和重打。
- 触发点：支付成功、商家确认、改价完成后再触发更稳
- 重打策略：店员点“重打”时，用订单号查历史任务，优先走平台的“重发任务”
- 离线兜底：网络断了也别慌，做一个“待打印队列”，恢复网络后按时间顺序补打
如果你门店晚高峰经常断网，建议给主打印机上4G版或给路由器配双WAN，成本不高，但能少很多扯皮。
常见故障排查（按概率从高到低）
- 能发任务但不出纸：先看打印机是否“离线/缺纸/开盖”，再看是否绑错设备号
- 打印一半乱码：多是字符集或模板指令不兼容，先换成纯文本模板验证
- 重复打印：回调超时导致重试，接口要做幂等（同订单同触发点只允许成功一次）
- 个别门店不打印：检查门店路由DNS/端口放行，顺便确认是否分配到正确门店组
可执行建议：用2026年3月10日这天做一次演练，挑10笔订单（含备注、退款、加菜），把“触发-任务ID-打印结果-重打结果”记录成表；再把模板拆成收银/后厨/交接三份。你会很快定位到底是模板问题、网络问题，还是接口幂等没做对。
