Skip to content

管理應用程式 ​


目錄 ​


一、使用情境 ​

情境 1:使用團隊提供的訂單工具 ​

狀況:團隊已提供額外的訂單處理工具,您需要在日常作業中使用它,並確認它仍可存取目前貨主的資料。

用這個功能:從已安裝的工具開啟 App;若操作針對多筆訂單,改從訂單列表選取訂單。

結果:使用指定貨主的工具與資料,不必重新挑選帳戶。


二、功能介紹 ​

本頁集中顯示目前貨主已安裝的 App,供您開啟工具或停止其存取。具串接管理權限的人員可瀏覽工具並確認安裝。切換貨主後,會顯示新貨主的安裝清單。

應用程式 - 頁面總覽

2.1 開啟與狀態 ​

「目前版本」欄顯示目前已安裝的版本,例如 1.0.2;只有確認升級後才會改變,不會隨商店發布新版自動更新。沒有版本紀錄時顯示「—」。

需要串接檢視權限才能開啟 App。預設選單中,「應用程式」位於「開發者工具」下方,兩者為同層選單;若已自訂排序,會沿用您的設定。展開側邊欄「應用程式」後,可直接點選已安裝的 App 名稱;選擇「管理應用程式」則回到安裝清單。也可在清單點選「開啟」。

App 會填滿後台的內容區域,保留側邊導覽。可透過側邊選單的「管理應用程式」返回清單,或使用瀏覽器上一頁。此頁可加入書籤或在新分頁開啟;重新整理會重新確認目前的存取權限。訂單內的 App 操作仍以操作視窗開啟。

「可使用」表示目前可開啟;「已暫停」無法開啟。清單空白表示目前貨主沒有已安裝的工具;請聯繫提供工具的團隊。

貨主 App 只能存取這次安裝授權的貨主資料;線上操作同時受目前使用者權限限制,例如 App 要以您的身分發送小鈴鐺通知時,您需要「通知」的編輯權限(見編輯用戶的權限對照表)。若 App 版本已宣告事件通知,且您同意事件訂閱權限,安裝時會自動建立訂閱並立即生效;訂閱狀態與重新啟用見 App 的憑證與 Webhook。一個 App 可接收多種已訂閱事件。安裝前的事件不會補送,卸載後停止通知。

2.2 卸載 ​

需要串接管理權限。點選「解除安裝」並確認後,該 App 會從清單與側邊選單移除,現有存取權限失效。卸載不會取消訂單或改動庫存,App 先前寫入的訂單標記也會保留;如需再使用,可依安裝流程重新安裝。

2.3 從 App Store 安裝 ​

  1. 點選「瀏覽 App Store」,同一分頁會前往 App Store,並帶入目前的安裝對象。
  2. 在 App Store 開啟 App 詳情,點選安裝後會回到本頁。在確認視窗核對 App 圖示與名稱、發行者、「安裝對象」及要求的權限。展開「詳細資訊」可查看版本與應用程式網域。
  3. 開啟「我同意授予以上權限。」,再點選「同意並安裝」。成功後會直接開啟新安裝的 App,並出現在已安裝清單與側邊選單。部分 App 要開啟後才會開始在背景運作(例如自動處理新訂單),所以安裝後會直接帶您進入 App。

貨主端的安裝只屬於發起時選定的貨主;確認期間請勿切換貨主。

選擇版本不代表已安裝。取消確認不會授予權限,也不會影響既有工具。同一 App 已有有效安裝時,不會以新版本覆蓋原安裝。

▸ 方案不足時無法安裝 ​

App 若宣告了最低方案,確認視窗會先檢查您所屬組織的方案:低於門檻時會以警示顯示需要的方案與目前組織方案,沒有「我同意授予以上權限。」開關與「同意並安裝」按鈕,只能「取消」。方案由低到高為「標準版」、「進階版」、「專業版」、「企業版」;「新竹物流專屬進階版」視同「進階版」。

升級方案後,再從 App Store 重新發起安裝即可。已安裝的 App 不受方案變動影響,之後方案降級也不會解除既有安裝。

2.4 檢查更新與升級 ​

  1. 具串接管理權限的人員可點選 App 旁的「檢查更新」。
  2. 核對「目前版本」與「最新版本」。有可用新版時,確認安裝對象、發行者、所有要求的權限及應用程式網域;新增的權限會另外標示。
  3. 在視窗底部開啟「我同意此版本要求的權限並確認升級」,再點選「確認升級」。同意開關與操作按鈕固定顯示,捲動明細時仍可操作。完成後會直接重新開啟該 App;如需連線授權,系統會帶您完成。

檢查本身不會修改安裝。升級會保留原安裝與串接設定,套用新版權限及事件訂閱,並使舊視窗與舊授權失效;系統會隨即重新開啟 App,讓它以新版重新連線。若沒有更新或目的平台尚不支援新版,視窗會顯示原因,不提供升級確認。

確認有效時間為五分鐘。若版本被撤回、安裝或權限已變更、登入工作階段失效,請重新檢查並核對後再確認。查詢失敗時不會自動升級;尚未連結 App Store 版本的舊安裝需聯繫管理員處理。

2.5 App 的憑證與 Webhook ​

App 安裝時取得的 API 憑證與事件訂閱只在本頁查看與維護,不會出現在「串接管理」列表。

清單的「Webhook」欄顯示事件通知是否在送出:「已連線」表示事件會正常通知 App;「已停用」表示目前不會通知;「未訂閱」表示這個 App 版本沒有宣告事件通知。

點選該列左側的展開符號,可核對 App 拿到的授權與訂閱:「授權範圍」是安裝時同意的權限;貨主 App 的憑證為「Partners API 憑證」。「Webhook 網址」、「API 版本」與「訂閱事件」由 App 版本決定,本頁不能修改,也不提供重新產生簽章金鑰;需要變更時請升級 App。

▸ 訂閱被自動停用時重新啟用 ​

接收端連續 10 筆事件都投遞失敗(每一筆在自動重試全部用完後才算失敗)時,系統會自動停用訂閱並發出通知。展開後可看到「連續失敗次數」與「最後投遞時間」。

  1. 先請提供 App 的團隊修好接收端。
  2. 具串接管理權限的人員點選「重新啟用訂閱」並確認。
  3. 狀態恢復為「已連線」,連續失敗次數歸零,之後發生的事件恢復通知。停用期間的事件不會補送。

App 已卸載、暫停或下架,App 憑證已停用,或授權已不含事件訂閱權限時,無法重新啟用,畫面會說明原因,訂閱維持停用。

▸ 測試投遞與投遞紀錄 ​

訂閱啟用中時,具串接管理權限的人員可點選「測試投遞」,對 App 的 Webhook 網址送出一筆測試事件。畫面會顯示接收端的 HTTP 狀態與耗時;接收端回應錯誤時顯示其狀態碼,連線失敗或 20 秒內沒有回應時顯示連線失敗或逾時。測試投遞記為手動送出;按下這一次不會自動重試,也不計入連續失敗次數。

點選「查看投遞紀錄」會開啟「Webhook 紀錄」並只列出這條訂閱的投遞,包含測試投遞;點選「顯示全部」可回到完整清單。需要紀錄檢視權限才看得到這個按鈕。


三、常見問題 ​

3.1 FAQ ​

▪ App 顯示請求過於頻繁時怎麼辦? ​

請稍候再操作,避免連續重試;持續發生時,將 App 名稱與錯誤訊息提供給開發團隊。每個貨主的每個 App 各自計算額度:每秒 10 次、每分鐘 180 次、每日 10,000 次。若用完日額度,須等組織時區午夜重設;重新登入或重新安裝不會重置用量。App 不消耗串接管理的每日額度;一般串接用完每日額度,也不會因此停用 App。

▪ 為何沒有看到 App? ​

先確認目前貨主;倉庫人員只能使用獲授權貨主的工具。若貨主正確且清單仍為空,請聯繫提供工具的團隊確認安裝。看不到功能入口時,請管理員確認串接檢視權限。

▪ App 顯示已失效時怎麼辦? ​

使用瀏覽器重新整理頁面,或返回清單重新開啟。訂單操作視窗則關閉後重新開啟。切換貨主、登出、權限變更或卸載都可能使原視窗失效。關閉視窗不會撤回已完成的操作;請先查看保存結果再重試。

▪ App 沒有載入時怎麼辦? ​

若安裝清單沒有載入,可點選「重新載入應用程式」重新取得清單。開啟 App 時會先顯示載入提示;若 15 秒內未完成連線,會顯示失敗畫面,可點選「重新載入應用程式」重新開啟。仍無法開啟時,將 App 名稱與錯誤訊息交給提供工具的團隊。

▪ 為何無法點選瀏覽 App Store? ​

請先選擇貨主,再請管理員確認您具有串接管理權限。

▪ 確認失效或安裝失敗時怎麼辦? ​

登出、切換登入身分或權限被撤回後,需重新選擇 App 與版本。暫時無法連線時可重試;版本已下架時請選擇其他可用版本。若無法進入商店,請管理員確認 App Store 連線設定。若仍無法安裝,請提供錯誤訊息給管理員。

▪ 確認視窗顯示需要某方案、無法安裝,怎麼辦? ​

這表示目前組織方案低於該 App 宣告的最低方案,不是安裝失敗,重試也不會改變結果;方案高低見方案不足時無法安裝。請點選「取消」,由管理員升級組織方案後,再從 App Store 重新發起安裝。既有的其他 App 不受影響。

▪ App 換了網站,已安裝的版本會跟著變更嗎? ​

不會自動變更。商店之後改名或發布新版,不會改動您現有安裝的版本與網站來源。請使用檢查更新與升級,核對新網域與要求的權限後明確確認。升級後舊視窗與授權失效,系統會隨即重新開啟 App。

▪ 為何 App 名稱或操作按鈕不是目前的語言? ​

App 名稱與操作按鈕會使用該版本提供的翻譯;沒有相符翻譯時,顯示 App 設定的預設語言。繁體中文與簡體中文不會自動互相替代;若 App 將其中一種設為預設語言,仍會按該預設顯示。

▪ 收到「Webhook 已自動停用」通知,App 收不到事件怎麼辦? ​

接收端連續投遞失敗才會自動停用。請先讓提供 App 的團隊修好接收端,再依訂閱被自動停用時重新啟用重新啟用;可先用測試投遞確認接收端已恢復。不需要卸載重裝。

▪ 為何無法重新啟用訂閱? ​

畫面會說明原因:App 已卸載、暫停或下架,App 憑證已停用,或授權已不含事件訂閱權限。前兩種請聯繫提供 App 的團隊;權限不足時請升級到含事件訂閱權限的 App 版本,或聯繫提供 App 的團隊。按鈕無法點選時,請管理員確認您具有串接管理權限。

3.2 注意事項 ​

⚠️ 重要提醒 ​

  • 卸載立即停止該 App 的存取;重新安裝不會恢復舊視窗的權限。
  • 訂閱停用期間發生的事件不會在重新啟用後補送。

功能說明連結
訂單列表選取訂單後使用批次工具前往
訂單詳情核對訂單的處理進度前往

最後更新 2026-11-16 19:57