公司設定
公司設定是整個公司共用的一份設定,不是每個人各一份。這篇列出每個分區管什麼,並連到詳細說明。
誰能進入
在後台 →「公司設定」。左側依領域分組列出分區。
- 管理員看得到全部分區。
- 會計只看得到會計分區,而且公司要開通進階會計模組。
- 其他角色看不到這一頁。
看不到的分區不會顯示,也不能直接用網址進入。
分區一覽
公司與方案
| 分區 | 管什麼 |
|---|---|
| 公司資料 | 公司名稱、統一編號、客服電話、聯絡信箱、地址、官方 LINE 加好友連結、Facebook 與 YouTube 連結、Logo。顯示在信件、單據抬頭與前台頁尾 |
| 方案模組 | 方案包含哪些模組。由平台開通,這裡只能查看。見模組與串接選擇 |
公司名稱必填,也是兩步驟驗證顯示的識別名稱。官方 LINE 連結會出現在訂單頁與訂單確認信,罐頭訊息可以用 {{官方LINE連結}} 引用。
訂單與收款
會計
收款帳戶不需要會計模組;其他會計分區要開通進階會計模組。
出團作業
團號格式、出團作業、旅遊契約與嚮導 portal 要開通行程模組才出現。對應的 API 在模組未開通時回 403 module_disabled。
通知與整合
| 分區 | 管什麼 | 詳細說明 |
|---|---|---|
| 郵件設定 | 回覆 Email、寄件人帳號、自有網域寄件 | 網站、自有網域與寄件網域 |
| API / Webhook | 要貼到金流商後台的付款通知網址 | 付款流程 |
| 開發者 | 員工 API 金鑰與 CLI 登入紀錄 | AI agent 初始化與內建 skill |
網站內容、網站模式與自有網域不在這裡,在後台 →「內容與行銷」→「網站」,見網站、自有網域與寄件網域。
危險區域
「刪除所有測試資料」只在開發與測試環境出現。正式環境看不到。
出團作業
警示門檻
| 設定 | 預設 | 作用 |
|---|---|---|
| 護照效期提醒天數 | 180 天 | 出國團旅客的護照效期距出發日少於這個天數,就標警示 |
| 嚮導證照到期提醒天數 | 60 天 | 梯次回程日加上這個天數晚於證照到期日,就標警示 |
| 派嚮導清單:差幾人算快成團 | 2 人 | 還沒成團、但差這個人數以內的梯次,列進派嚮導清單。0 表示只列已成團的梯次 |
隨團人員職稱
排班、出團準備、成本範本與嚮導 portal 顯示的職稱。分「主要職稱」與「協同職稱」。例:派領隊的旅行社填「領隊 / 導遊」,登山業者填「嚮導 / 協作嚮導」。
硬期限通知
梯次的期限碰到硬期限當天,用鈴鐺通知承辦。可以設定是否通知,以及幾點發(台北時間 0 到 23 點)。期限本身見出團準備與線控。
梯次承辦輪流
新梯次自動帶入承辦的名單,國內線與海外線各一份,照順序輪流。名單是空的,新梯次就不帶入承辦。不能當承辦的人輪到時會跳過。
登山路線分級
開通登山模組後,管理員可以在「登山路線分級」維護路線與分數,用於登山審核。
- 對照表一開始是空的,請貼入公司自己的分級表。系統不預載其他公司的路線。
- 可以逐筆新增、編輯或刪除,也可以從試算表複製兩欄貼上:路線名稱、分數(中間用 Tab 分隔)。
- 分數介於 0 到 20,可以有小數。
- 系統列出還沒對到的路線與出現次數,方便補表。
每條路線另有兩個設定,在逐筆新增或編輯時調整:
- 高海拔:未設定、是、否。設定了「是」或「否」時,客人或承辦選到這條路線,高山經驗依此帶入並鎖住。未設定時由填寫人自己勾。只影響之後新增的經歷,已存的經歷不會改。請依公司登山分級表的「為高海拔」欄填寫,和行程的「屬高海拔」一致。
- 客人看得到:預設開。關掉後,會員中心與結帳的路線建議清單不列這條路線,例如內部用的名稱。後台代填仍列全部。
整批貼上只更新分數。已存在的路線,兩個設定維持原狀;新路線預設客人看得到、高海拔未設定。
計分規則:
- 客人填的路線去掉前後空白後,必須和表上名稱完全相同。
- 對不到的路線不計分。客人或業務自己填的分數也不計分。
- 補表後,同名的歷史經歷在下次計算時採用新分數。已完成的審核紀錄不會自動更新。
- 高山與雪地經驗仍由客人自己勾選。
›API 與 CLI 對應
所有端點見 settings API。除另外註明,權限都是 role.manage,讀取也一樣。
| 設定 | 端點 |
|---|---|
| 整份公司設定 | GET /api/v1/settings、PATCH /api/v1/settings(只帶要改的欄位) |
| 方案模組(唯讀) | GET /api/v1/settings/modules |
| 費用項目 | GET /api/v1/settings/fee-item-presets、POST /api/v1/settings/fee-item-presets、PUT /api/v1/settings/fee-item-presets/{id}、POST /api/v1/settings/fee-item-presets/{id}/delete |
| 取消政策 | PUT /api/v1/settings/cancellation-policy |
| 團號格式 | PUT /api/v1/settings/group-code-pattern(group_code.manage) |
| 梯次承辦輪流 | GET /api/v1/settings/departure-owner-rotation、PUT /api/v1/settings/departure-owner-rotation |
| 旅遊契約 | PUT /api/v1/settings/tour-agreement |
| 嚮導 portal | PUT /api/v1/settings/guide-portal-policy |
| 暫停新付款與新契約 | GET /api/v1/settings/workflow-controls、PUT /api/v1/settings/workflow-controls |
| 內外帳費率 | PATCH /api/v1/settings/ledger-fees |
PATCH /api/v1/settings 可寫欄位: companyName、companyPhone、taxId、companyAddress、logoUrl、emailReplyTo、senderLocalPart、passportExpiryWarningDays、guideCertExpiryWarningDays、guideDispatchNearGap(0–99)、escortLeadLabel、escortAssistantLabel。
暫停新付款與新契約(只有 API 與 CLI,後台沒有開關):PUT 同時帶 newPaymentsPaused 與 newAgreementsPaused,都是 boolean。CLI 為 settings workflow-controls 與 settings set-workflow-controls。
- 暫停新付款:不再產生新的付款頁。既有付款通知、退款與結算照常處理。
- 暫停新契約:不再產生新契約,也不因內容變更撤銷既有待簽契約。既有契約仍可檢視與簽署。
- 訂單取消與旅客移除的清理照原規則處理。開關不撤銷已送出的付款頁,也不停止進行中的請求。每次變更都留下稽核紀錄。
訂單派發、付款、收款帳戶、費用類別與寄件網域的端點,見各自的指南。
嚮導登入政策
PUT /api/v1/settings/guide-portal-policy 接受 loginMode 與 dossierWindowDays。
loginMode 可用 password_totp、password_only、email_otp。
password_only 免強制綁定,已綁第二因素者仍須完成驗證。
email_otp 每次要求 Email 登入碼,拒絕密碼及 Passkey。
模式變更會撤銷全體嚮導登入、信任裝置及未完成驗證;同值儲存或只改資料窗不登出。
此操作維持 role.manage 與行程模組限制。
toko settings guide-portal-policy --data '{"loginMode":"email_otp","dossierWindowDays":7}' --confirm相關指南
- 權限與角色:誰能管理公司設定。
- 網站、自有網域與寄件網域。
- 同意書與罐頭訊息範本。