捐贈碼
捐贈碼管理用於維護愛心碼（發票捐贈碼）清單，消費者可在結帳時選擇捐贈發票給指定公益機構。建立後即可在「新增發票」的捐贈類型中選用。
進入路徑
後台左側 發票管理 → 捐贈碼。
多分店行為（2026-08-21 起）
捐贈碼由各分店各自管理。您在哪一間分店底下新增，那組捐贈碼就屬於哪一間店：
| 狀況 | 看得到嗎 |
|---|---|
| 在 A 店建立的捐贈碼 | 只有 A 店看得到、用得到 |
| 早期建立、沒有指定分店的捐贈碼 | 所有分店都看得到（視為全店共用），不受影響 |
不同分店可以建立相同的愛心碼。愛心碼是全國共用的號碼，多家分店把同一個公益機構放進自家常用清單是正常的；此前第二家店建立時會被擋下並顯示「捐贈碼已存在」，現在只有同一間店內重複才會被擋。
單店的商家看不到分店切換器，行為與此前完全相同。
此前所有分店其實是共用一份清單
主要功能
捐贈碼列表 顯示捐贈碼、名稱、啟用狀態與排序序號。
新增 / 編輯 可建立新的捐贈碼或編輯既有項目。
啟用 / 停用 以「啟用」欄位控制是否在「新增發票」表單的選單中出現。
刪除 可刪除不再使用的捐贈碼。
操作流程
新增捐贈碼
點擊右上角 新增捐贈碼，填寫：
捐贈碼 必填，例如 25885。
名稱 必填，例如「愛心動物協會」，作為下拉選單上的可讀名稱。
排序 數字，用於控制下拉選單呈現順序。
啟用此捐贈碼 勾選後才會出現在「新增發票」的捐贈下拉選單中。
編輯或停用
於列表的 編輯 中可修改名稱、排序、啟用狀態。要暫時隱藏某個捐贈碼，可取消勾選「啟用此捐贈碼」即可，無需刪除。
在發票中使用
於「發票列表 → 新增發票」中將「買受人類型」選為「捐贈」，「捐贈碼」下拉選單即會列出此頁所有啟用中的項目。
財政部即時搜尋
後台提供「從財政部搜尋」功能（API：GET /api/pos-invoice/donations/national-search?q=關鍵字），可直接查詢財政部 Open API 取得全國愛心碼清單，不需手動輸入愛心碼。
使用方式：於「新增捐贈碼」對話框中輸入公益機構名稱或愛心碼 → 點「搜尋」→ 系統即時從財政部 Open API 拉取結果並列出 → 點選後自動填入捐贈碼與名稱欄位。
結果太多時只會顯示前幾筆，畫面會明白告訴您（2026-08-25 起）
財政部 API 偶發無法存取
常見問題
Q1 愛心碼從哪裡取得？
愛心碼由財政部核發給公益機構。可使用上方「財政部即時搜尋」功能查詢，或至財政部電子發票整合服務平台查詢清單，店家無需申請，直接輸入有效的愛心碼與對應機構名稱即可使用。
Q2 可以同時提供多個捐贈選項嗎？
可以。將多個捐贈碼設為「啟用」後，於「新增發票」的捐贈下拉選單中即可逐一選擇。
Q3 建立時顯示「此捐贈碼已存在」，可是清單裡沒看到？
請確認兩件事：一是目前切在哪一間分店，同一組愛心碼在同一間店內只能建立一次；二是這組愛心碼可能屬於早期建立的全店共用那一批，共用的那些每間店都看得到、也不能在店內重複建立。若要調整，請直接編輯既有那一筆，不必新增。
Q4 排序欄位是做什麼用的？
「排序」是數字，用於決定捐贈碼在列表與下拉選單中的排列順序，數字較小者通常較早出現，方便將長期合作的公益機構置頂。
其他問題協助