條碼掃描器
進貨與訂單揀貨
最後更新：2026年9月5日
STOAR 支援在進貨入庫、訂單揀貨與商品查詢時使用條碼掃描——不需要安裝任何驅動程式、外掛或應用程式。
掃描器以 HID 鍵盤模式連線：掃描器會以鍵盤的身分配對或插入，把解碼後的條碼「輸入」到目前作用中的欄位，再送出 Enter 完成提交。任何支援 HID 鍵盤模式的掃描器都能使用。
掃描器可以做什麼 #
| 作業流程 | 位置 | 會發生什麼 |
|---|---|---|
| 進貨入庫 | 後台 → 目錄 → 進貨入庫 | 每掃一次就增加庫存，並寫入一筆稽核記錄 |
| 訂單揀貨 | 後台 → 訂單 → 揀貨 | 每掃一次就確認訂單上的一個品項；所有明細都揀完後才會解鎖「標記為已出貨」 |
| 商品查詢 | 後台全域搜尋 | 掃描條碼即可立即找到該商品 |
| 自訂應用程式 | GET /api/v1/barcode/{code} |
從您自己的應用程式將條碼解析為商品／款式 |
條碼如何解析 #
商品與款式各自帶有兩組識別碼：
- 條碼——印在商品包裝上的製造商代碼（EAN-13、UPC-A、GTIN）
- SKU——您內部使用的識別碼
一次掃描會依下列順序解析：款式條碼 → 商品條碼 → 款式 SKU → 商品 SKU。也就是說，品項可以貼製造商條碼，也可以貼您自己的 SKU 標籤——兩者都能正確掃描。
條碼在 後台 → 目錄 → 商品 中設定，商品本身與每個款式都可以各自設定。
沒有掃描器也能試用 #
您不需要任何硬體就能試用這些掃描流程。因為掃描器所做的，不過是把條碼輸入到目前 作用中的欄位再按 Enter，所以您完全可以手動做同一件事：開啟進貨入庫、 訂單揀貨或 POS 銷售點，點一下掃描欄位，然後輸入或貼上商品的 條碼或 SKU，再按 Enter。該品項就會被入庫、揀貨或加入這筆銷售，效果與 實際掃描完全相同。在掃描器送達之前，這是示範或熟悉流程最快的方式—— 標籤破損或遺失時，也是很方便的備用手段。
開發自訂應用程式的開發者，完全不必經過後台介面就能解析條碼：
GET /api/v1/barcode/{code} 會以 JSON 回傳對應的商品與款式。
掃描器設定 #
每台掃描器都需要三項設定：
- HID 鍵盤模式——不是序列埠／SPP 或 SDK 模式
- Enter（Carriage Return）後綴——每次掃描後送出，這正是提交表單的關鍵
- 主機端使用美式英文鍵盤配置（或將掃描器設定為相符的配置）——配置不一致可能讓英數字條碼出現亂碼
Socket Mobile 1D（S700 系列）
口袋大小的藍牙掃描器，適用於一維（1D）條碼——EAN、UPC、Code 128、Code 39。如果您的標籤全都是標準零售條碼，這款很合適。無法讀取 QR 或 Data Matrix 條碼。
- 掃描 Socket Mobile 快速入門指南中的 "Basic Mode (HID)" 設定條碼——Socket 掃描器出廠時常設定為 Application Mode（SDK），而 STOAR 並不需要這個模式
- 從裝置的藍牙設定進行配對（它會顯示為鍵盤）
- 在 HID 模式下，Enter 後綴是 Socket 的預設值——掃描到任一文字欄位即可驗證
Socket Mobile 2D（S720／S740）
外型與設定方式和 1D 機型相同，但配備 2D 影像掃描器，還能讀取 QR Code、Data Matrix、PDF417，以及顯示在螢幕上的條碼。如果您會為儲位或內部 SKU 列印 QR 標籤，請選這款。
設定方式與 1D 機型完全相同：掃描 "Basic Mode (HID)"，再以鍵盤身分配對。
Zebra DS2208（USB 有線）
USB 有線手持式掃描器，具備 1D + 2D 影像掃描能力。固定式收貨檯的主力機種——不用電池、不用配對。
- 插上 USB——開箱即以 HID 鍵盤方式運作
- 掃描 DS2208 快速入門指南中的 "Add an Enter Key (Carriage Return/Line Feed)" 設定條碼
- 若字元輸出錯誤，請掃描與主機相符的鍵盤配置設定條碼（例如 US English）
Zebra DS2278（藍牙無線）
DS2208 的無線版本——影像掃描器規格相同，另附充電座。最適合在倉庫中邊移動邊揀貨。
- 透過充電座：將充電座插上 USB；它會以鍵盤身分呈現——隨插即用
- 直接藍牙連線：掃描 "Bluetooth Keyboard Emulation (HID Slave)" 設定條碼，再從裝置的藍牙設定進行配對
無論採用哪一種方式，都請一併掃描 "Add an Enter Key (Carriage Return/Line Feed)"。
如何挑選掃描器 #
| 使用情境 | 建議機種 |
|---|---|
| 固定式收貨檯，追求最低成本 | Zebra DS2208 |
| 在倉庫中移動揀貨 | Zebra DS2278 |
| 可放口袋，搭配手機或平板使用 | Socket Mobile 2D |
| 只有標準零售條碼，預算有限 | Socket Mobile 1D |
| 現在或將來會用到 QR 或 Data Matrix 標籤 | 任一 2D 機型 |
疑難排解 #
| 症狀 | 解法 |
|---|---|
| 掃描後欄位有填入，但沒有送出 | 未設定 Enter／CR 後綴——請掃描您機型對應的後綴設定條碼 |
| 出現「Unknown code」通知 | 該條碼未儲存在任何商品或款式上——請在 後台 → 目錄 → 商品 中新增 |
| 字母或符號輸出錯誤 | 主機鍵盤配置與掃描器不符——請將兩者都設為美式英文 |
| Socket 掃描器完全不輸入任何內容 | 它處於 Application Mode——請掃描 "Basic Mode (HID)" 設定條碼 |
| UPC 條碼前置的 0 消失 | 請將掃描器的 UPC 傳送格式設定為與儲存的條碼一致——比對必須完全相符 |