打印设置

Table of Contents

设置虚拟打印机

了解虚拟打印机以及如何设置它并将其与 Eats365 POS 进行配对。

「虚拟打印机」是一项 Eats365 的功能，可让您建立虚拟路径并整合执行特定任务的端点。在虚拟打印机的设置中，当 POS 收到订单时，POS 会将订单详情发送至端点，并根据端点预设的程式指令来命令其执行任务。该端点需要与 Eats365 POS 进行后台通讯，以透过 JSON 格式的 API 呼叫来接收订单详细资讯。

例如，端点可以是根据所收到的订单详情进行自动烹饪的设备，或者是一个在屏幕上显示订单详情以便厨房员工查看和准备的厨房显示器。作为一个相关的对比，在实体打印机的设置中，POS（起点）将订单详情发送至打印机（端点），而专门被设定用来打印订单详情的打印机，随后会将订单详情打印在一张纸上，供厨房员工阅读和准备。而在虚拟打印机的架构下，“打印任务” 是由 POS （起点）发送至虚拟打印机（端点），接着端点会根据其接收到的 API 呼叫中所包含的订单详情来执行其任务。

虚拟打印机功能

打印任务的类型

虚拟打印机可以从 POS 接收三种类型的操作：

操作	功能
添加	新增商品至打印任务
更新	更新现有打印任务的信息
删除	删除打印任务

打印任务信息

该打印任务包含以下订单详情：

操作
参考编号
商品代码
数量
时间戳
订单编号
桌号
订购方式
订单参考 ID
订单名称
外部订单编号
来源
商品备注
订单备注
套餐选项指示器
商品名称
套餐名称
分类名称
更改代码代码
更改代码名称
改码选项名称
更改码数
厨房部门

在开始之前

配对虚拟打印机需符合以下要求：

Eats365 POS 终端机
您端点的 IP 地址
您端点的加密密钥
重点提示：虚拟打印机的请求主体（Request Body）将使用 AES/ECB/PKCS7 填补搭配共享金钥（16 字元的金钥）进行加密。

配对虚拟打印机

若要将虚拟打印机连接至 POS ，请依照下列步骤操作：

登入 Eats365 POS。
点击左上角的「设置」 。
在 “一般” 下，点击「打印机设定」。
点击「新增」，然后选择「虚拟打印机」。
输入以下资讯：
- 打印机名称
- 打印机 IP（端点的 IP 地址）
- 端点的加密密钥
点击「测试」以向端点发送测试 API 呼叫。
1. 在以下 URL 中，将红色文字替换为您端点的 IP 地址：
  - 方法：GET
  - 端点：http:// IP 地址/v1/check-status
2. 若要确认您的伺服器是否已接收到测试呼叫，请检查 API 是否回应下列讯息：
```
{
"status": "OK"
}
```
当 POS 成功与端点建立连线后，请点击「新增」。
接着选择适用的「支持的订单」与「打印项目」。
点击右上角的「储存」。

配对成功后， POS 就会依据您在虚拟打印机设定中选取的支持的订单及打印项目，开始向虚拟打印机发送打印任务。

检查打印任务

POS 透过 API 通讯以 JSON 格式发送打印任务至端点。若要检查发送至虚拟打印机的打印任务，请在下列 URL 中将红色文字替换为您端点的 IP 地址：

方法： POST
端点：http:// IP 地址/v1/send-job

JSON 脚本范例

[
{
{
"action": "ADD",
"reference_id": "[UUID]",
"data": {
"product_code": "[Product Code]",
"quantity": 1,
"timestamp": 1540655058000,
"order_number": "A1",
"table_number": "(Optional for DineIn) Table A",
"order_mode": "TAKEOUT/DINEIN",
"order_reference_id": "string",
"check_name": "string",
"external_order_number": "string",
"source": "string",
"item_remarks": "string",
"order_remarks": "string",
"is_combo_option": 1,
"product_name":{"zh_TW":"string","en_US":"string"},
"combo_name":{"zh_TW":"string","en_US":"string"},
"category_name":{"zh_TW":"string","en_US":"string"},
"modifier_code": ["string"],
"modifier":[{
"modifier_code":"string",
"modifier_name": {"zh_TW":"string","en_US":"string"},
"modifier_option_name": {"zh_TW":"string","en_US":"string"},
"quantity": 1
}],
"kitchen_station": "string"
}
},
{
"action": "UPDATE",
"reference_id": "[UUID]",
"data": {
"product_code": "[Product Code]",
"quantity": 2,
"timestamp": 1540655058000,
"order_number": "A1",
"table_number": "(Optional for DineIn) Table A",
"order_mode": "TAKEOUT/DINEIN",
"order_reference_id": "string",
"check_name": "string",
"external_order_number": "string",
"source": "string",
"item_remarks": "string",
"order_remarks": "string",
"is_combo_option": 1,
"product_name":{"zh_TW":"string","en_US":"string"},
"combo_name":{"zh_TW":"string","en_US":"string"},
"category_name":{"zh_TW":"string","en_US":"string"},
"modifier_code": ["string"],
"modifier":[{
"modifier_code":"string",
"modifier_name": {"zh_TW":"string","en_US":"string"},
"modifier_option_name": {"zh_TW":"string","en_US":"string"},
"quantity": 1
}],
"kitchen_station": "string"
}
},
{
"action": "DELETE",
"reference_id": "[UUID]"
}
]

Delete

虚拟打印机

聯繫我們