Skip to main content

📘 SKU Map 編輯器 使用說明

📖 簡介

SKU Map 編輯器 是一個基於 Python Tkinter 開發的桌面應用程式，
主要功能是管理 SKU 對應表 (SKU Map)，支援 JSON 檔案 與 Excel 檔案 的匯入匯出，
並可即時從線上取得產品清單（含價格與溫層資訊）。

此工具可協助快速維護多平台商品 SKU 對應關係，並計算總金額。

🛠 系統需求

  • Windows 10 / 11

  • Python 3.10 以上版本

  • 已安裝模組：

    • tkinter

    • requests

    • openpyxl

安裝缺少的套件：

pip install requests openpyxl

📂 程式結構

sku_editor_v1.1.py        # 本程式主檔

程式會自動從以下網址載入產品清單：

https://wu:wu2266228@ec.zfun.com.tw/plist.json

🚀 功能說明

1. 檔案操作

  • 讀取 JSON 檔案：開啟並載入 SKU Map。

  • 儲存 JSON：將當前資料存回已開啟的 JSON 檔。

  • 另存 JSON：將 SKU Map 另存為新的 JSON 檔。

  • 匯入 Excel：讀取 Excel 檔案並轉換成 SKU Map。

  • 匯出 Excel：將 SKU Map 以 Excel 格式匯出，並自動套用底色區隔不同原始 SKU。

  • 重新載入產品清單：從線上重新載入商品資料。

2. SKU 清單管理

  • 搜尋原始 SKU：即時過濾 SKU 清單。

  • 新增原始 SKU：輸入新的 SKU 並加入清單。

  • 修改選取 SKU：將目前選取的 SKU 重新命名。

  • 刪除選取 SKU：刪除當前選取的 SKU 及其子項目。

3. 子項目管理

每個原始 SKU 可對應多個子項目，包含以下欄位：

  • 新SKU

  • 產品名稱（自動從線上清單帶出，含溫層資訊）

  • 新數量

  • 新進價

可執行操作：

  • 新增子項

  • 儲存子項修改

  • 刪除子項

4. 總金額計算

  • 自動計算所有子項 (數量 × 單價) 的合計。

  • 顯示於畫面下方標籤，並四捨五入顯示。

📐 Excel 匯入/匯出格式

必要欄位

  • 原始SKU

  • 新SKU

  • 產品名稱

  • 新數量

  • 新進價

匯出檔案

  • 每個 原始 SKU 的子項會分組顯示。

  • 系統會為不同原始 SKU 的區塊套用不同底色（淺檸檬色、淺青色、淺玫瑰色等）。

📦 資料結構範例

JSON 範例

{
    "A123": [
        {
            "新SKU": "B456",
            "新數量": "10",
            "新進價": "150"
        },
        {
            "新SKU": "C789",
            "新數量": "5",
            "新進價": "200"
        }
    ]
}

Excel 範例

原始SKU 新SKU 產品名稱 新數量 新進價
A123 B456 牛肉火鍋片(冷凍) 10 150
A123 C789 豬肉火鍋片(冷凍) 5 200

📷 介面說明

  • 左側：原始 SKU 清單（可搜尋/新增/刪除/修改）。

  • 中間：子項列表（支援排序與檢視）。

  • 右側：編輯區（可選取 SKU、輸入數量與進價）。

  • 上方：功能按鈕列（檔案操作與產品清單管理）。

⚠️ 注意事項

  1. 產品清單來源需可連線，若讀取失敗，SKU 搜尋可能無法帶出產品名稱。

  2. Excel 格式必須正確，若缺少必要欄位將匯入失敗。

  3. 編輯完成後記得 手動儲存 JSON 或匯出 Excel，避免資料遺失。

  4. 子項輸入的數量與價格須為數字，否則計算總金額會失敗。

👨‍💻 維護資訊

  • 版本：1.1

  • 建立日期：2025-08-01

  • 負責人：日芳珍饌 技術部

Back to top