toko

公司設定

公司設定是整個公司共用的一份設定,不是每個人各一份。這篇列出每個分區管什麼,並連到詳細說明。

誰能進入

在後台 →「公司設定」。左側依領域分組列出分區。

  • 管理員看得到全部分區。
  • 會計只看得到會計分區,而且公司要開通進階會計模組。
  • 其他角色看不到這一頁。

看不到的分區不會顯示,也不能直接用網址進入。

分區一覽

公司與方案

分區管什麼
公司資料公司名稱、統一編號、客服電話、聯絡信箱、地址、官方 LINE 加好友連結、Facebook 與 YouTube 連結、Logo。顯示在信件、單據抬頭與前台頁尾
方案模組方案包含哪些模組。由平台開通,這裡只能查看。見模組與串接選擇

公司名稱必填,也是兩步驟驗證顯示的識別名稱。官方 LINE 連結會出現在訂單頁與訂單確認信,罐頭訊息可以用 {{官方LINE連結}} 引用。

訂單與收款

分區管什麼詳細說明
訂單派發客人自助下單後交給哪位業務,以及業務佣金費率訂單派發
付款設定尾款收款方式、少收核准、撤銷人工收款時限、金流商與憑證、代收轉付收據付款流程
費用項目行程「費用包含 / 不包含」的預設清單。刪除不影響已帶入行程的文字行程與梯次
取消政策客人自助取消與換梯、退改費階梯、未中籤行政費、誰能核准退款取消與退款

會計

分區管什麼詳細說明
收款帳戶收款帳戶目錄,以及費用性質對應的帳戶收款帳戶與對帳結算
費用類別公司營業費用的分類營業費用
損益分區損益表的分區營業費用
月固定費用每月固定發生的費用營業費用
內外帳費率內外帳利潤試算用的費率內外帳與梯次毛利

收款帳戶不需要會計模組;其他會計分區要開通進階會計模組。

出團作業

團號格式、出團作業、旅遊契約與嚮導 portal 要開通行程模組才出現。對應的 API 在模組未開通時回 403 module_disabled。

分區管什麼詳細說明
團號格式梯次團號的樣板與序號樣式。留空時用內建格式行程與梯次
出團作業警示門檻、隨團人員職稱、硬期限通知、梯次承辦輪流(見下)本篇
旅遊契約旅遊型態、乙方資訊、可變更第三人期限、法務開關旅遊契約
嚮導 portal嚮導登入方式、旅客名單開放天數嚮導與排班
登山路線分級登山審核用的路線分數表。開通登山模組才出現(見下)本篇

通知與整合

分區管什麼詳細說明
郵件設定回覆 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
嚮導 portalPUT /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 與行程模組限制。

bash
toko settings guide-portal-policy --data '{"loginMode":"email_otp","dossierWindowDays":7}' --confirm

相關指南

Command Palette

Search for a command to run...