饿了么开放平台小票打印方案
商品搭售能力升级后,商家通过api对接小票打印的方案需要做相应的调整,平台目前支持2种打印方案:小票云模板和常规小票打印。
7.1、小票云模板
小票云模板的方案介绍:https://open.shop.ele.me/openapi/documents/cloudprint
此方案因为直接使用的小票打印指令,平台侧优化升级支持即可,无需服务商和商家改造。
7.2、常规小票打印
常规小票打印,小票数据格式由开发者自行组装,数据来源于推单消息或者订单查询接口,常规小票打印需遵守平台的小票规范(规范内容:https://open.shop.ele.me/openapi/documents/xiaopiao )。
商品搭售能力升级后,订单数据中的商品属性结构不变,无需特殊处理,但需识别 配料份数和价格 ,商品配料信息的识别需要做相应调整。
(1)主商品和配料都会作为商品信息存在item中;
(2)通过foodType区分主商品还是配料,foodType为0表示主商品,foodType为3表示配料;
(3)主商品下如果有配料,会将配料信息放在ingredients字段中;
(4)通过ingredients.uniqueId与item[].uniqueId关联可识别配料的详细信息,比如价格重量等信息;
(5)ingredients.quantity表示该配料在单份商品下的份数;
(6)item[].quantity表示该商品的总份数,如果为配料,表示该配料在主商品下的总份数;
(7)小票上计算主商品+配料总价的方式:item[主商品].total+item[配料].total;
注意:订单小票打印时,需要根据以上规则将配料跟主菜关联起来,在小票上体现出关联关系以及配料份数,配料不允许单独打印!!!
例:比如某笔订单信息如下
主商品 | 配料 | 数量 | 总价 |
---|---|---|---|
布丁奶茶(单价10元) | 西米(单价3元)2份 | 2 | 10×2+3×(2×2)=32元 |
茉莉奶茶(单价12元) | 西米(单价3元)1份 | 1 | 12×1+3×(1×1)=15元 |