invoice-packing

Invoice & Packing List 轉檔工具

一個基於 Web 的檔案轉換工具，支援將 CSV/Excel 資料轉換為標準化的 Invoice（發票）和 Packing List（裝箱單）格式。

🚀 功能特色

• ✅ 多品項支援：支援任意數量的產品品項
• ✅ 雙格式轉檔：支援 Invoice 和 Packing List 兩種格式
• ✅ 自動編號：產品編號和發票編號自動遞增
• ✅ 響應式設計：支援桌面、平板、手機等各種設備
• ✅ 拖拽上傳：支援檔案拖拽上傳
• ✅ 即時預覽：上傳後立即顯示資料預覽
• ✅ 底部資訊固定：確保重要資訊不會被多品項推下去

📁 檔案結構

invoice-packing-tool/
├── exact_invoice_template.html    # 主要 HTML 應用（推薦使用）
├── app.py                         # Streamlit 應用
├── transform.py                   # 轉檔邏輯
├── create_invoice_template.py     # 範本建立工具
├── requirements.txt               # Python 依賴套件
├── test_data.csv                  # 測試資料
├── packing_list_test_data.csv     # Packing List 測試資料
├── run.bat                        # Windows 啟動腳本
├── run.sh                         # Linux/Mac 啟動腳本
├── README.md                      # 說明文件
└── PRD.md                         # 產品需求文件

🛠️ 安裝與使用

方法一：HTML 版本（推薦）

1. 直接開啟：雙擊 exact_invoice_template.html 檔案
2. 瀏覽器開啟：將檔案拖拽到瀏覽器中
3. 開始使用：上傳 CSV/Excel 檔案，選擇轉檔類型，執行轉檔

方法二：Streamlit 版本

1. 安裝依賴：

   pip install -r requirements.txt
   

2. 啟動應用：

   streamlit run app.py
   

3. 或使用腳本：
   • Windows: 雙擊 run.bat
   • Linux/Mac: 執行 ./run.sh

📋 支援的檔案格式

輸入格式

• CSV 檔案 (.csv)
• Excel 檔案 (.xlsx, .xls)

輸出格式

• Excel 檔案 (.xlsx)

🔧 必要欄位

Invoice 轉檔必要欄位

• retailer_erp_customer_name - 客戶名稱
• retailer_warehouse_address - 客戶地址
• retailer_contact_phone - 聯絡電話
• retailer_contact_name - 聯絡人
• sku - 產品編號
• name - 產品名稱

Packing List 轉檔必要欄位

• retailer_erp_customer_name - 客戶名稱
• retailer_warehouse_address - 客戶地址
• retailer_contact_phone - 聯絡電話
• retailer_contact_name - 聯絡人
• sku - 產品編號
• name - 產品名稱
• effective_date - 有效日期
• measurement - 測量單位
• weight - 重量

🎯 使用流程

1. 上傳檔案：選擇或拖拽 CSV/Excel 檔案
2. 選擇轉檔類型：Invoice 或 Packing List
3. 設定參數：填寫必要的設定資訊
4. 執行轉檔：點擊轉檔按鈕
5. 下載結果：下載生成的 Excel 檔案

🔄 轉檔對應關係

Invoice 對應關係

• E4 ← retailer_warehouse_address
• E5 ← retailer_contact_phone
• E6 ← retailer_contact_name
• SKU → Barcode 欄位 (B欄)
• 產品名稱 → 商品欄位 (C欄)

Packing List 對應關係

• E5 ← retailer_erp_customer_name (Buyer)
• E6 ← retailer_warehouse_address (Address)
• E8 ← retailer_contact_phone (Tel)
• B9 ← name (Contact)
• E9 ← retailer_contact_name (Contact)
• Barcode ← sku (多個商品往下排列)
• Best Before Date ← effective_date (YYYY-MM-DD 格式)

🚀 部署到 GitHub

方法一：使用 Git（推薦）

1. 初始化倉庫：

   git init
   git add .
   git commit -m "Initial commit: Invoice & Packing List 轉檔工具"
   

2. 添加遠端倉庫：

   git remote add origin https://github.com/rubylee-lgtm/invoice-packing.git
   

3. 推送到 GitHub：

   git push -u origin main
   

方法二：手動上傳

1. 下載壓縮包：使用 invoice-packing-tool.zip
2. 解壓縮：解壓縮到本地目錄
3. 上傳到 GitHub：將所有檔案上傳到 GitHub 倉庫

🌐 線上使用

部署到 GitHub 後，可以透過 GitHub Pages 提供線上服務：

1. 啟用 GitHub Pages：
   • 進入倉庫設定
   • 選擇 “Pages” 選項
   • 選擇 “Deploy from a branch”
   • 選擇 “main” 分支
2. 訪問網址：

   https://rubylee-lgtm.github.io/invoice-packing/
   

📱 瀏覽器支援

• ✅ Chrome (最新版本)
• ✅ Firefox (最新版本)
• ✅ Safari (最新版本)
• ✅ Edge (最新版本)

🛡️ 系統需求

• 作業系統：Windows 10+, macOS 10.14+, Linux
• Python 版本：3.7+ (僅 Streamlit 版本需要)
• 記憶體：最少 4GB RAM
• 儲存空間：最少 100MB 可用空間

📞 技術支援

如有問題或建議，請：

1. 查看 PRD.md 了解詳細功能
2. 檢查必要欄位是否完整
3. 確認檔案格式是否正確

📄 授權

本專案採用 MIT 授權條款。

---

版本：1.0
最後更新：2024-09-23
GitHub 倉庫：https://github.com/rubylee-lgtm/invoice-packing# invoice-packing