打印設置

設置虛擬打印機

了解虛擬打印機以及如何設置它並將其與 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]"
}
]

刪除

虛擬打印機

联系我们