饿了么开放平台出餐宝出餐场景条码二维码生成方案
文档说明
本文档面向对象为第三方开发者服务的商家或自研商家,在使用饿了么官方出餐宝硬件时,对自研打印机打印出来的小票条形码/二维码的生成规则。
背景说明
什么是饿了么出餐码
饿了么出餐码是一种打印在饿了么外卖出餐小票上的条形码或二维码,可以被出餐宝(E出餐)设备识别在备餐完成后,使用饿了么出餐宝设备扫描饿了么出餐码,可以高效率出餐
为了更加明确商家的出餐时间,用来真实反应商家的时机出餐情况,饿了么提供了出餐宝硬件方便商家进行出餐上报,只需要扫描小票上的饿了么出餐码,即可完成出餐操作。因为出餐宝识别的订单信息有一定规范,需要小票打印机按照我们的出餐规则完成饿了么出餐码
生成方案
第一步:获取饿了么订单号
通过饿了么商家开放平台接口,获取19位订单信息,接口使用方式参考如下文档
https://open.shop.ele.me/openapi/apilist/eleme-order/eleme-order-getOrder
参数名称参数类型参数示例参数描述
orderIdString”5060312396537546206“订单ID
第二步:订单号编码规则
压缩编码规则:压缩后编码方式为:平台标识(1位字符) + 出餐编码(N位字符)
字段长度解析说明
平台标识1位字符“E”代表饿了么订单(固定不变)
出餐编码N为字符将19位订单号转化为58进制字符
示例
原订单号为:5060312396537546206
压缩后编码为:EcKhdzSYiBb7
第三步:一维码生成规则
优先采用code 128 auto方式生成 (code 128 A/B/C均可)
一维码条纹宽度(条码密度)需宽于10.8mil (0.275mm)(实际小票总长需大于45mm)
条码高度大于10mm
条码打印要保证完整,不能有大面积的条码打印缺失或者连续多条条纹不清晰(下图示例为条码横向或者竖向或者斜向缺失情况)
第四步:打印要求
小票打印机分辨率需200dpi以上
打印油墨纸张对比度(清晰度)在20%以上
条码生成位置需放在订单尾部,方便扫码操作
建议在条码附近打印文字“饿了么出餐码”方便餐厅区分
备选:二维码生成规则
优先推荐使用QR code, 纠错等级使用H级(容错能力更强,识读体验更好)
QR码:条码密度高于:20 mil,实际打印尺寸大于13mm*13mm, 19位字符的订单号条码打印出来的尺寸如图所示
条码打印要保证完整,不能有大面积的条码打印缺失或者污损
FAQ
Q:可否直接使用订单号生成条形码
A:可以,但是由于饿了么订单号较长,所以在部分打印机精度不高的情况下会导致识别困难,建议使用推荐的生成方案进行生成
Q:二维码跟条形码更推荐谁
A:如果小票上没有其他的二维码(如开票码),建议使用二维码方式生成出餐码,识别率更高