模組與串接選擇
模組決定公司能用哪些功能。先確認方案包含什麼,再決定要不要串接、怎麼串接。
套組與模組
- 基本套組:訂單、金流、會員、員工與權限、設定、信件與前台外殼。
- 進階套組:另含「API 與自動化」「自建前台」「自有網域」三項能力。
- 業務模組:行程、訂房、進階會計、登山、抽籤、靠行請款,依需求加購。海外團已包含在行程模組內。
價格與方案內容見方案與定價。
模組由平台開通,租戶不能在後台自行打開。到後台 →「公司設定」→「方案模組」,可以看到每個模組的涵蓋功能與狀態(「已開通」或「未包含」)。要調整方案,請聯絡平台窗口。
業務模組
使用時注意:
- 行程模組開通後,就能標示海外團。登山團另需登山模組;同一家公司可同時販售一般團、登山團與海外團。
- 行程與訂房是獨立產品線。登山、抽籤與進階會計需要行程模組;行程配套住宿需要行程與訂房模組。
- 護照辨識只用在海外行程。結帳時上傳的新影本會自動辨識一次,人工核對後才帶入表單。國內團的外籍旅客只存影本,不辨識。
- 多幣別成本屬於進階會計,不會因為販售海外團而一併開通。
- 模組沒開通時,側欄不顯示該模組專屬的頁面,例如「旅宿」「裝備」「抽籤」。
行程與出團指令另需行程模組(tour),包含行程、梯次、隨團人員、排班、出團準備、成本範本與團號。旅遊契約、嚮導 portal 政策與承辦輪流名單設定,跨梯次供應商付款登記、嚮導 portal 個資顯示與梯次成本操作也需要行程模組;成本申報與支出證明單核准另需進階會計模組。未開通時回傳 403 module_disabled。停用後,既有訂單仍可收款與退款。
選擇串接方式
三項能力彼此獨立,可以搭配使用:
- 自建前台只負責呈現內容,報名與付款仍連回平台。
- 只用平台提供的網站,也可以綁定自有網域,不必另外開發網站。
- 員工後台一律留在平台網址,不會搬到自有網域。
- 員工用的 API 金鑰與官網用的前台金鑰不能互換。前台金鑰只放在官網後端,不放進瀏覽器程式碼。
開通不等於取得所有權限
一個操作能不能做,同時看三件事:模組是否開通、角色有沒有權限、資料在不在角色的範圍內。例如,建立訂房訂單需要訂房模組,也需要角色能建立訂單。
開通「API 與自動化」不會增加任何帳號的權限,也不會開通其他業務模組。角色與範圍見權限與角色。
›模組代碼與 API 錯誤
模組代碼:
| 模組 | 代碼 |
|---|---|
| API 與自動化 | api_access |
| 自建前台 | headless_storefront |
| 自有網域 | custom_domain |
| 行程 | tour |
| 訂房 | lodging |
| 進階會計 | accounting |
| 登山 | climbing |
| 抽籤 | lottery |
| 靠行請款 | affiliated_sales |
已開通員工 API 時,可用 GET /settings/modules 查詢模組狀態(需 role.manage)。
| 回應 | 檢查方式 |
|---|---|
401 unauthorized | 確認租戶網址、憑證種類與憑證是否有效。 |
403 module_disabled | 確認該功能所需的模組已開通。 |
403 forbidden | 確認帳號角色具有端點要求的權限。 |
404 not_found | 確認資源存在,且在帳號的可見範圍內。 |
完整錯誤格式見 API 串接基礎。