管理應用程式
目錄
一、使用情境
情境 1:使用團隊提供的倉端工具
狀況:團隊已提供額外的倉端工具,您需要在日常作業中使用它,處理自己有權執行的倉庫作業。
用這個功能:從已安裝的工具開啟 App。
結果:直接使用組織的工具,操作仍依您的作業權限與倉庫範圍執行。
二、功能介紹
從側邊選單的「進階設定」→「應用程式」→「管理應用程式」開啟本頁。
本頁集中顯示目前組織已安裝的 App,無須先選擇貨主,供您開啟工具或停止其存取。具串接管理權限的人員可瀏覽工具並確認安裝,也可檢查已安裝 App 的更新並原地升級。切換頁首貨主不會改變這份清單;App 線上讀取或處理倉端資料時,仍受目前操作員權限與所屬倉庫限制。

2.1 開啟與狀態
「目前版本」欄顯示目前已安裝的版本,例如 1.0.2;只有確認升級後才會改變,不會隨商店發布新版自動更新。沒有版本紀錄時顯示「—」。
需要串接檢視權限才能開啟 App。展開側邊欄「應用程式」後,可直接點選已安裝的 App 名稱;選擇「管理應用程式」則回到安裝清單。也可在清單點選「開啟」。
App 會填滿後台的內容區域,保留側邊導覽。可透過側邊選單的「管理應用程式」返回清單,或使用瀏覽器上一頁。此頁可加入書籤或在新分頁開啟;重新整理會重新確認目前的存取權限。
「可使用」表示目前可開啟;「已暫停」無法開啟。清單空白表示目前組織沒有已安裝的工具;請聯繫提供工具的團隊。
組織 App 的線上操作受目前操作員權限與所屬倉庫限制。訂單、庫存、入庫、退貨、商品等貨主資料只限該操作員被分派的貨主;揀貨單不以頁首貨主篩選或貨主分派縮小範圍。經安裝同意的背景作業可處理本組織各倉庫資料;卸載會停止後續存取。
若 App 版本已宣告庫存變動或訂單出貨、訂單取消通知,且您同意事件訂閱與對應的讀取權限(庫存變動需庫存讀取、訂單出貨與取消需訂單讀取),安裝時會自動建立訂閱並立即生效。訂閱範圍是整個組織:本組織任一貨主的庫存變動、訂單出貨或取消都會通知 App,每則通知會標明所屬貨主。安裝前的事件不會補送,卸載後停止通知。這些通知的推送紀錄只有被指派該貨主的倉庫人員看得到,貨主後台看不到。
2.2 卸載
需要串接管理權限。點選「解除安裝」並確認後,該 App 會從組織的清單移除,現有存取權限失效。卸載不會取消訂單或改動庫存,App 先前寫入的訂單標記也會保留;如需再使用,可依安裝流程重新安裝。
2.3 從 App Store 安裝
- 點選「瀏覽 App Store」,同一分頁會前往 App Store,並帶入目前的安裝對象。
- 在 App Store 開啟 App 詳情,點選安裝後會回到本頁。在確認視窗核對 App 圖示與名稱、發行者、「安裝對象」及要求的權限。展開「詳細資訊」可查看版本與應用程式網域。
- 開啟「我同意授予以上權限。」,再點選「同意並安裝」。成功後會直接開啟新安裝的 App,並出現在已安裝清單與側邊選單。部分 App 要開啟後才會開始在背景運作(例如自動處理新訂單),所以安裝後會直接帶您進入 App。
倉庫端的安裝屬於目前組織;不需要選擇貨主。
選擇版本不代表已安裝。取消確認不會授予權限,也不會影響既有工具。同一 App 已有有效安裝時,不會以新版本覆蓋原安裝;要更新既有安裝請用檢查更新與升級。
▸ 方案不足時無法安裝
確認視窗會先檢查組織方案,有兩種情況會擋下安裝:視窗會以警示說明擋下原因與目前組織方案,沒有「我同意授予以上權限。」開關與「同意並安裝」按鈕,只能「取消」。
- App 宣告了最低方案:目前組織方案低於門檻時無法安裝。方案由低到高為「標準版」、「進階版」、「專業版」、「企業版」;「新竹物流專屬進階版」視同「進階版」。
- 組織方案不含 Vanta Connect 串接:倉庫端安裝的都是組織 App,一律需要含 Vanta Connect 串接功能的方案(「標準版」不含),不論 App 有沒有宣告最低方案。
升級方案後,再從 App Store 重新發起安裝即可。已安裝的 App 不受方案變動影響,之後方案降級也不會解除既有安裝;但組織 App 呼叫 Vanta Connect API 的操作,仍依目前方案是否含該功能決定能否使用。
2.4 檢查更新與升級
- 具串接管理權限的人員可點選 App 旁的「檢查更新」。
- 核對「目前版本」與「最新版本」。有可用新版時,確認「安裝對象」顯示的是目前組織、發行者、所有要求的權限及應用程式網域;新增的權限會另外標示。
- 在視窗底部開啟「我同意此版本要求的權限並確認升級」,再點選「確認升級」。同意開關與操作按鈕固定顯示,捲動明細時仍可操作。完成後會直接重新開啟該 App;如需連線授權,系統會帶您完成。
檢查本身不會修改安裝。升級會保留原安裝與組織的串接憑證,套用新版權限及組織層級的事件訂閱,並使舊視窗與舊授權失效;系統會隨即重新開啟 App,讓它以新版重新連線。若沒有更新或目的平台尚不支援新版,視窗會顯示原因,不提供升級確認。
確認有效時間為五分鐘。若版本被撤回、安裝或權限已變更、登入工作階段失效,請重新檢查並核對後再確認。新版若要求只有貨主安裝才能使用的能力,確認時會被拒絕,原安裝不變。查詢失敗時不會自動升級;尚未連結 App Store 版本的舊安裝需聯繫管理員處理。
2.5 App 的憑證與 Webhook
App 安裝時取得的 API 憑證與事件訂閱只在本頁查看與維護,不會出現在 Vanta Connect 串接 的憑證清單。
清單的「Webhook」欄顯示事件通知是否在送出:「已連線」表示事件會正常通知 App;「已停用」表示目前不會通知;「未訂閱」表示這個 App 版本沒有宣告事件通知。
點選該列左側的展開符號,可核對 App 拿到的授權與訂閱:「授權範圍」是安裝時同意的權限;組織 App 的憑證為「Vanta Connect 憑證」。「Webhook 網址」、「API 版本」與「訂閱事件」由 App 版本決定,本頁不能修改,也不提供重新產生簽章金鑰;需要變更時請升級 App。
▸ 訂閱被自動停用時重新啟用
接收端連續 10 筆事件都投遞失敗(每一筆在自動重試全部用完後才算失敗)時,系統會自動停用訂閱並通知組織的倉庫人員。展開後可看到「連續失敗次數」與「最後投遞時間」。
- 先請提供 App 的團隊修好接收端。
- 具串接管理權限的人員點選「重新啟用訂閱」並確認。
- 狀態恢復為「已連線」,連續失敗次數歸零,之後本組織的庫存變動、訂單出貨或取消恢復通知。停用期間的事件不會補送。
App 已卸載、暫停或下架,App 憑證已停用,或授權已不含事件訂閱權限時,無法重新啟用,畫面會說明原因,訂閱維持停用。
▸ 測試投遞與投遞紀錄
訂閱啟用中時,具串接管理權限的人員可點選「測試投遞」,對 App 的 Webhook 網址送出一筆測試事件。畫面會顯示接收端的 HTTP 狀態與耗時;接收端回應錯誤時顯示其狀態碼,連線失敗或 20 秒內沒有回應時顯示連線失敗或逾時。測試投遞記為手動送出;按下這一次不會自動重試,也不計入連續失敗次數。
點選「查看投遞紀錄」會開啟「Webhook 紀錄」並只列出這條訂閱的投遞;點選「顯示全部」可回到完整清單。需要紀錄檢視權限才看得到這個按鈕。實際事件的投遞仍只有被指派該事件貨主的倉庫人員看得到;測試投遞不屬於任何貨主,只會出現在從「查看投遞紀錄」開啟的這條訂閱清單中;組織內能查看 Webhook 紀錄的倉庫人員都看得到,不受頁首貨主影響。
三、常見問題
3.1 FAQ
▪ App 顯示請求過於頻繁時怎麼辦?
請稍候再操作,避免連續重試;持續發生時,將 App 名稱與錯誤訊息提供給開發團隊。每個組織的每個 App 各自計算額度:每秒 10 次、每分鐘 180 次、每日 10,000 次。若用完日額度,須等組織時區午夜重設;重新登入或重新安裝不會重置用量。
▪ 為何沒有看到 App?
本頁不需要選擇貨主。若清單為空,請聯繫提供工具的團隊確認是否已安裝到目前組織。看不到功能入口時,請管理員確認串接檢視權限。
▪ App 顯示已失效時怎麼辦?
使用瀏覽器重新整理頁面,或返回清單重新開啟。切換倉庫、登出、權限變更或卸載都可能使原視窗失效。關閉視窗不會撤回已完成的操作;請先查看保存結果再重試。
▪ App 沒有載入時怎麼辦?
若安裝清單沒有載入,可點選「重新載入應用程式」重新取得清單。開啟 App 時會先顯示載入提示;若 15 秒內未完成連線,會顯示失敗畫面,可點選「重新載入應用程式」重新開啟。仍無法開啟時,將 App 名稱與錯誤訊息交給提供工具的團隊。
▪ 為何無法點選瀏覽 App Store?
請管理員確認您具有串接管理權限。
▪ 確認失效或安裝失敗時怎麼辦?
登出、切換登入身分或權限被撤回後,需重新選擇 App 與版本。暫時無法連線時可重試;版本已下架時請選擇其他可用版本。若無法進入商店,請管理員確認 App Store 連線設定。若仍無法安裝,請提供錯誤訊息給管理員。
▪ 確認視窗顯示需要某方案或需要含 Vanta Connect 串接的方案、無法安裝,怎麼辦?
這表示目前組織方案不符合該 App 的安裝條件,不是安裝失敗,重試也不會改變結果;條件說明見方案不足時無法安裝。請點選「取消」,由管理員升級組織方案後,再從 App Store 重新發起安裝。既有的其他 App 不受影響。
▪ App 換了網站,已安裝的版本會跟著變更嗎?
不會自動變更。已安裝的 App 會保留安裝時的名稱、說明與版本;商店之後改名或發布新版,不會改動您現有安裝的版本與網站來源。要使用已核准的新版本,請使用檢查更新與升級,核對新網域與要求的權限後明確確認;原安裝與串接憑證會保留,不會換成新的安裝。升級後舊視窗與授權失效,系統會隨即重新開啟 App。
▪ 為何 App 名稱或操作按鈕不是目前的語言?
App 名稱與操作按鈕會使用該版本提供的翻譯;沒有相符翻譯時,顯示 App 設定的預設語言。繁體中文與簡體中文不會自動互相替代;若 App 將其中一種設為預設語言,仍會按該預設顯示。
▪ 收到「Webhook 已自動停用」通知,App 收不到事件怎麼辦?
接收端連續投遞失敗才會自動停用。請先讓提供 App 的團隊修好接收端,再依訂閱被自動停用時重新啟用重新啟用;可先用測試投遞確認接收端已恢復。不需要卸載重裝。
▪ 為何無法重新啟用訂閱?
畫面會說明原因:App 已卸載、暫停或下架,App 憑證已停用,或授權已不含事件訂閱權限。前兩種請聯繫提供 App 的團隊;權限不足時請升級到含事件訂閱權限的 App 版本,或聯繫提供 App 的團隊。按鈕無法點選時,請管理員確認您具有串接管理權限。
3.2 注意事項
⚠️ 重要提醒
- 卸載立即停止該 App 的存取;重新安裝不會恢復舊視窗的權限。要換新版請用檢查更新與升級,不必卸載。
- 訂閱停用期間發生的事件不會在重新啟用後補送。
- 方案降級不會解除已安裝的 App,但組織 App 呼叫 Vanta Connect API 的操作會隨方案不再含該功能而停止。
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 訂單列表 | 選取訂單後使用批次工具 | 前往 |
| 訂單詳情 | 核對訂單的處理進度 | 前往 |