数据准备
1.菜品表.TXT
格式:
编号(5位)、类别号(2位)、中文名称(20位)、单价(9位)、单位(4位)、重量单位(4位)、菜品属性 (1位)、作法(45 位)、助记码(10位)、做法加价(60位)、空格(12位)会员价(9位)
“菜品表.TXT” 中每一行菜品数据文本 46~90 中填入做法编号,多做法直接拼接
示例:
0100101冰爽杨梅 98.00份 份 0 BSYM
0100401凉拌长生果 56.00份 份 0 LBCSG
0100601河虾(盐水 酱油 油爆) 120.00份 份 0005006007 GYPPY 5;0,6;1,10;0
0100701蜜法叉烧 56.00份 份 0008009002 MFCS
0100901精品刺身 68.00份 份 0 JPLC
做法加价解释:这个字段可选,其中由逗号分隔,分号后0和1表示加价类型;河虾第一个做法005按每例加5元,第二个做法006定额加6元,第三个做法每例加10元
说明:
除了单价外所有数据均为左对齐
"编号"不足五位时前面写0
"单价"必须写为两位小数
非称重类菜品"重量单位"同"单位"
菜品属性(1位)
|
属性/值 |
需称重(注意:在ZDCX中也有相关返回值说明) |
可变价 |
需称重、可变价 |
做法必选 |
自定义(临时菜 |
|
|
1 |
2 |
3 |
4 |
8 |
在不需要确认重量时写0,否则写1,临时菜填8, 如果既是临时菜又需要
说明: 如果需要必选, 就把菜品属性设置为属性4就必选了
需要称重的菜品,在ZDCX中也有相关必要的返回值要求。
2.菜品类别表.TXT
基础格式:
类别编号(2位)、类别名称(10位)
示例:
01凉菜
02海鲜
建议按类别编号排序
某些客户希望实现二级菜品类别选择,则可以使用下面的2种类别扩展格式:
扩展二级类格式1:
增加
“菜品类别大类表.txt”
示例:
01凉菜
02炒菜
并在原“菜品类别表.TXT”增加上级编码字段
编码(2) 类别名称(10) 上级编码(2)
示例:
01精美凉菜 01
02精品特色佳01
03特色佳肴 02
04精品炒菜 02
扩展二级类格式2:直接在一个菜品类表中增加大类小类关联;如下格式:
菜品类别表.TXT
编码(2) 类别名称(10) 上级编码(2)
示例:
05凉菜
06精美凉菜 05
07精品特色佳05
08炒菜
09特色佳肴 08
10精品炒菜 08
注意1:扩展二级类格式2的大小类编码不能重复, 如果上层软件中的大类编码和小类存在冲突, 可以在生成txt文件时加上一个不会冲突的数值。比如大类“01,02,03”变成“81,82,83” 甚至大类编码可以使用字母,“a1,a2,a3,b1,b2,b3”等等。
注意2:无论是哪种扩展格式,编码都不能重复。
3.退菜理由表.TXT
基础格式:
退菜理由编号(2位)、退菜理由名称(20位)
示例:
01客人点的太多
02上菜太慢
建议按退菜理由编号排序
扩展格式:
理由编号(2位)、理由名称(20位)、类型(2位)
示例:
01客人点的太多 01
02上菜太慢 01
03楼面经理赠送 02
04总经理赠送 02
05催菜 03
06整桌催菜 03
类型编号: 01表示退菜理由, 02表示赠菜理由,03表示通知(知会)类型
建议按退菜理由编号排序
4.包房名称表.TXT
格式:
台号(4位)、名称(20位) 、楼层编号(4位)桌台类型(4)
简单示例:
0401牡丹江包房
0102黑龙江
0405乌苏里
0506鄂伦春
建议按台号排序
说明:
如果需要分楼层显示,则按如下格式建立“楼层表.TXT”
格式:
编号(2位) 、名称(10位)
示例:
01一楼
02二楼
然后在“包房名称表.TXT”中增加对应关系
示例:
0401牡丹江包房 01
0102黑龙江 01
0405乌苏里 02
0506鄂伦春 02
“桌台类型表.txt”
格式:
编号(4位) 、类型名称(20位)
示例:
0001小桌2-4人
0002大桌6-8人
0003包厢12人
“包房名称表.TXT”中关联桌台类型
示例:
0401牡丹江包房 01 0001
0102黑龙江 01 0001
0405乌苏里 02 0002
0506鄂伦春 02 0002
5.客户要求表.TXT
格式:编号(3),名称(16) ,速查(4位),分类码(2位),空(2位),做法标志(2位),、空(2位)、长名称(100)、加价(9位)、加价方式(2位)
注意:做法标记:0—表示是口味(所有菜品都能选择) 1—表示做法(关联的菜品才能选择),不标记默认为口味;2---整桌口味
加价方式:0—表示按数量加价 1—表示定额加价
客户要求表最简示例:
012炒球
013冬菜蒸头腩
014碎件面酱蒸
客户要求表示例:


如果需要将客户要求分类选择,则需要提供“客户要求类别表.txt”,
格式:编号(2),名称(16)
客户要求类别表示例:
01凉拌类
02三吃类
03其他类
6.厨师推荐.TXT (同菜品表格式一致,但只取4个有效字段)
格式:
编号(5位)、类别号(2位)、中文名称(20位)、单价(9位)、单位(4位)
示例:
02001 肉丝面~~~~~~~~~~~~~~~~~~ 5.00盘
02002 肉丝面~~~~~~~~~~~~~~~~~~ 5.00盘
注意:点选时,菜品价格还是按照“菜品表.txt”
7.每日新菜.TXT (同菜品表格式一致,但只取4个有效字段)
格式:
编号(5位)、类别号(2位)、中文名称(20位)、单价(9位)、单位(4位)
示例:
02001 肉丝面~~~~~~~~~~~~~~~~~~ 5.00盘
02002 肉丝面~~~~~~~~~~~~~~~~~~ 5.00盘
注意:点选时,菜品价格还是按照“菜品表.txt”
8.沽清表.TXT
格式:
菜品编码(5位),沽清原因(20位) , 剩余数量(6位)
示例:
01001限量 999
01034无货
沽清更新规则:
- 沽清表在通用协议中没有单独定义,电子菜谱目前通过 账单查询“ZDCX”同步实现沽清信息的更新;因此开发商可以在处理“ZDCX”指令的时候更新沽清表.txt;
- 当服务员没有选择桌台直接离线点菜时, 沽清信息不会更新。这时可以点击电子菜谱界面上“其他功能”里的“沽清列表”,沽清信息即可同步至电子菜谱;
此时的“沽清列表”也是借用了ZDCX指令,但桌台字段为空,例如:
请求格式:类型码(4位)、 点菜机机号(4位)
这里就是没有台号 空位(1位)、出厂号(7位)
----- T1.txt --------
ZDCX 0016
bf994d5
返回格式:类型码(4位)、 点菜机机号(4位)
----- R1.txt --------
ZDCX 0016
刷新沽清菜品成功!
3、目前沽清还是依靠服务员更新,还无法实现实时更新,为此“沽清更新”以后会采取推送方式,开发商更新好 “沽清表.txt”后, 给WX发送一个约定的推送消息(PostMessage)即可。(此功能还在开发)
9.多单位.TXT
格式:
菜品编号5位,单位名称8位,价格9位
示例:
06086只 21
06086大份 45
08004中份 35
10.套餐表
注意:套餐名称必须在 “菜品表.txt”中存在,并且套餐名称不能和已存在的单品名称一样。
菜品套餐表.TXT 和 菜品套餐内容表.TXT
菜品套餐表.TXT
格式:
套餐编号(2位)、套餐名称(20位) 套餐标记(2位)
示例:
01情侣套餐
02家庭套餐
建议按套餐编号排序
套餐属性说明:
默认属性:分为两种【一.出现在菜品套餐表.TXT 中的菜品都被认定为套餐,如果XX套餐内的明细有一组组号相同的菜品,那就认定为
可换菜套餐。可换菜套餐:组号相同的菜品可以进行二选一,套餐的总价不变,套餐明细不能任意添加和删除。】
【二.出现在菜品套餐表.TXT 中的菜品都被认定为套餐,如果XX套餐内的明细没有组号相同的菜品,那就认定为
标准模式套餐,套餐内可以进行任意的添加菜品,并且价格保持不变】
套餐标记:“S” 表示不可换菜,加菜。并且套餐明细的价格在“我的菜单”不显示价格。
套餐标记:“X” 表示自定义套餐,可随意加菜。套餐总价按明细价格累计。
套餐标记:“M” 表示自定义套餐,可随意加菜。套餐总价按明套餐设计价格。
例:
01情侣套餐 S
02家庭套餐
03自选套餐 X
04自选800元套餐 M
菜品套餐内容表.TXT
格式:
套餐号(2位)、菜号(5位)、数量(9位)、单价(9位) 、单位(4位)、缺省选中标志(1位)、套餐菜组号(2位)、可选套餐的选择数(4)
示例:
0102001~~~~~~~~1~~~~~3.50盘~~101
0104012~~~~~~~~1~~~~~9.50盘~~101
0103023~~~~~~~~2~~~~30.00盘~~102
0111033~~~~~~~~1~~~~28.00盘~~102
0111034~~~~~~~~1~~~~~5.00盘~~103
0111035~~~~~~~~1~~~~~5.00盘~~103
如果在分组里面任意选择
注意:可选套餐的选择数,在相同组号的第一个菜品有效,如下示例:
0102001~~~~~~~~1~~~~~3.50盘~~101
0104012~~~~~~~~1~~~~~9.50盘~~102
0103023~~~~~~~~2~~~~30.00盘~~103 2
0111033~~~~~~~~1~~~~28.00盘~~103
0111034~~~~~~~~1~~~~~5.00盘~~103
0111035~~~~~~~~1~~~~~5.00盘~~103
这个例子表示:可选套餐03组的4个菜品中选择2个菜品
11.餐台状态表.txt
用于台位状态要颜色区分,和餐饮系统的状态同步
餐台状态表.TXT
格式:
台号(4位)、状态(10位)
示例:
1001开台
1002空台
注意:如果需要在选择桌台时同步刷新,则不要建立这个文件,使用接口另外提供的ZZSX指令
12.用户表.txt
此数据表可选,需要选择用户的客户可以提供这个数据表
用户表.TXT
格式:
服务员工号(5位)、服务员姓名(10位)
示例:
001 001
1001 张三
1002 李四
13.折扣模板.txt (可选)
此数据表可选,需要选择用户的客户可以提供这个数据表
格式:
折扣模版编号(4位) 折扣模版名称(20位)
示例(折扣率):
70 70折
80 80折
90 90折
交换用数据
由 WX46 传送到程序的数据文件为:T1.TXT
由程序传送到WX46 的数据文件为:R1.TXT
请求文件和返回文件均为多行的文本文件,第一行固定为一个请求类型编码和一个点菜机编号,信息提示类内容均应该为每行 20 字符,以 5 行为一个显示页,以美观为原则,其内容开发商可以自己随意更改。
以上文件的字段间都必须用一个空格隔开。
以上文件每次只能存在一条记录,每次使用前都会删除原来的内容。多点菜机同时发出请求时由
WX46 进行排队处理,接口程序不需考虑请求同时到来的问题。