UGOMK 操作手冊
06 章 / 共 7

參數設定

發票登錄模組的參數設定控制全域行為,包含財政部電子發票 API、OCR 服務供應商、管理員通知 UID,影響所有活動的驗證與通知流程。

進入路徑

後台左側 發票登錄 → 參數,頁面標題為 發票登錄參數

主要功能

財政部電子發票 設定電子發票 API 模式與憑證,決定發票真實性驗證的來源

OCR 服務 照片登錄的辨識設定。目前系統只提供「模擬辨識」,尚未接上真實的 OCR 辨識服務,詳見下方說明。

管理員通知 UID 當有待審核發票或異常事件時,系統會推播給這些管理員。

操作流程

設定財政部電子發票

模式

Mock(本機模擬) 預設模式,不會真的呼叫財政部 API,用於開發測試。

Sandbox(測試) 行為與 Mock 完全相同(財政部並未提供對外的測試環境),一樣不會真的連到財政部。

Production(正式) 使用財政部正式環境,上線前必須切換

頁面右上會以彩色徽章顯示目前模式。

AppID

填入財政部電子發票整合服務平台核發的 AppID。

API Key

填入對應的 API Key。儲存後再次載入會顯示為遮罩(****),未變更時系統不會覆蓋已儲存的真實值。

設定 OCR 服務

照片辨識目前是模擬的,不會真的讀取照片內容

系統尚未接上任何真實的 OCR 辨識服務供應商 下拉選單裡除了 Mock(開發用) 以外的選項都還沒有實作,選了會讓照片登錄直接失敗目前唯一可用的設定是 `Mock(開發用)`,這也是系統的預設值。 Mock 的行為是:忽略客人上傳的照片內容,直接產生一組隨機的發票號碼、日期、賣方與金額(並有約 5% 機率回傳「照片太模糊」以模擬辨識失敗)。它可以用來把整條登錄流程跑通、驗證獎勵發放與審核介面,但它讀不出客人實際拍到的發票

供應商 建議設定:

  • `Mock(開發用)`請維持這個選項。用於流程測試,以及搭配「人工審核」讓管理員自己看照片判讀。
  • `不啟用`(空白) — 不會停用照片上傳,而是讓照片登錄直接報錯。若不想開放照片登錄,請改在活動的「驗證模式」選擇非 OCR 的方式。
  • `Google Vision` / `AWS Textract` / `Azure Document Intelligence`尚未實作,請勿選擇

選了這三個之後按儲存,設定根本不會被存下來

後端目前不認得這三個值,會靜默忽略這一欄:畫面顯示儲存成功,但 供應商 實際上維持原本的值,重新整理頁面後會變回去。 這是選單裡有、後端沒接的殘留選項。看到「改了又跳回去」不是您操作錯誤,也不是網路問題。真正需要調整這一欄時請維持 Mock(開發用)不啟用

選擇非 Mock 的供應商時會出現 API Key 欄位,填了同樣不會生效。

想真的辨識發票,現在該怎麼做

1. 要驗發票真偽 → 活動的驗證模式選 財政部電子發票 API,並在本頁把模式切到 Production 並填入 AppID。這條路是真的會連到財政部的,不受 OCR 限制影響。 2. 只能拍紙本發票 → 活動的驗證模式選 人工審核,由管理員在登錄紀錄頁看照片後逐筆核可。 3. 真實 OCR 串接的需求請與我們聯繫,會列入開發規劃。

設定管理員通知 UID

於輸入框輸入管理員 LINE Messaging userId(U + 32 字 hex;不是 LINE app 設定的「LINE ID」@xxxxxx),按 加入 或 Enter 加入清單。清單內的管理員會在發票登錄發生異常事件時收到 LINE 推播。可隨時點擊清單項目右側 × 移除。

儲存設定

頁面底部 儲存設定

常見問題

Q1 不設定財政部 API 可以辦活動嗎

可以,但驗證模式必須選擇人工審核或自動通過(測試用),否則發票驗證一定會失敗注意「OCR 照片辨識」目前不是可行的替代方案(見 Q2)。建議想驗真偽的客戶提前到財政部申請 AppID 並切換到 Production 模式。

Q2 OCR 供應商要選哪一家

目前沒有這個選擇題。 系統還沒接上任何真實 OCR 服務,選單裡的 Google Vision / AWS Textract / Azure Document Intelligence 都尚未實作,而且選了也存不進去(後端不認得這三個值,會靜默忽略,重新整理後會跳回原值)。請維持預設的 `Mock(開發用)`

Mock 不會真的讀照片,它產生的是隨機的假發票資料。因此如果活動需要客人拍紙本發票,實務上請把活動的驗證模式設為 人工審核,由管理員看照片核可。

Q3 管理員通知 UID 在哪可以拿到

請該管理員加入官方帳號後,到 會員管理 → 會員列表 查找該會員,複製欄位中的 LINE User ID(U 開頭)貼到設定即可。

上線前檢查

模式切換 正式上線前務必把財政部電子發票模式從 Mock 切到 Production,並重新測試一張真實發票確認驗證流程通暢。 API Key 保密 API Key 屬於敏感資訊,請勿截圖外流。若懷疑外洩請至財政部平台重新申請後在本頁更新。

其他問題協助

若遇本說明未涵蓋的問題,請透過後台右下角 LINE 客服 @ugomk 聯繫真人專員協助處理。