toko

模組與串接選擇

模組決定公司能用哪些功能。先確認方案包含什麼,再決定要不要串接、怎麼串接。

套組與模組

  • 基本套組:訂單、金流、會員、員工與權限、設定、信件與前台外殼。
  • 進階套組:另含「API 與自動化」「自建前台」「自有網域」三項能力。
  • 業務模組:行程、訂房、進階會計、登山、抽籤、靠行請款,依需求加購。海外團已包含在行程模組內。

價格與方案內容見方案與定價。

模組由平台開通,租戶不能在後台自行打開。到後台 →「公司設定」→「方案模組」,可以看到每個模組的涵蓋功能與狀態(「已開通」或「未包含」)。要調整方案,請聯絡平台窗口。

業務模組

模組提供能力閱讀指南
行程行程、梯次、出團準備、期限、排班與海外團(護照效期、OCR)旅客與個資
訂房旅宿與房型、每晚庫存、散客直訂與行程配套住宿訂房
進階會計多帳戶對帳與結算、內外帳毛利、公司損益、多幣別成本、出款批次內外帳與梯次毛利
登山參加資格審核、裝備租借、入山證等許可文件旅客與個資、裝備租借
抽籤抽籤梯次、抽籤結果、候補遞補與未中籤轉備案行程與梯次
靠行請款靠行業務的專用入口、帳號管理與申請送出,不依賴行程或進階會計權限與角色

使用時注意:

  • 行程模組開通後,就能標示海外團。登山團另需登山模組;同一家公司可同時販售一般團、登山團與海外團。
  • 行程與訂房是獨立產品線。登山、抽籤與進階會計需要行程模組;行程配套住宿需要行程與訂房模組。
  • 護照辨識只用在海外行程。結帳時上傳的新影本會自動辨識一次,人工核對後才帶入表單。國內團的外籍旅客只存影本,不辨識。
  • 多幣別成本屬於進階會計,不會因為販售海外團而一併開通。
  • 模組沒開通時,側欄不顯示該模組專屬的頁面,例如「旅宿」「裝備」「抽籤」。

行程與出團指令另需行程模組(tour),包含行程、梯次、隨團人員、排班、出團準備、成本範本與團號。旅遊契約、嚮導 portal 政策與承辦輪流名單設定,跨梯次供應商付款登記、嚮導 portal 個資顯示與梯次成本操作也需要行程模組;成本申報與支出證明單核准另需進階會計模組。未開通時回傳 403 module_disabled。停用後,既有訂單仍可收款與退款。

選擇串接方式

你想要使用能力誰來做下一步
用程式讀訂單、建請款、跑報表或自動化API 與自動化工程師或 AI agent,以員工帳號的權限操作API 串接基礎、營運自動化
在自己的官網顯示行程、梯次與日誌自建前台工程師架官網,管理者在後台建立前台金鑰自建前台 API
讓平台提供的網站使用公司品牌網址自有網域管理者在後台設定,並在 DNS 加記錄自有網域設定

三項能力彼此獨立,可以搭配使用:

  • 自建前台只負責呈現內容,報名與付款仍連回平台。
  • 只用平台提供的網站,也可以綁定自有網域,不必另外開發網站。
  • 員工後台一律留在平台網址,不會搬到自有網域。
  • 員工用的 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 串接基礎。

開始串接

  1. 到「公司設定」→「方案模組」,確認方案包含所需的能力與業務模組。
  2. 使用目標公司的網址,準備對應的憑證。
  3. 先執行唯讀查詢,確認權限與資料範圍。
  4. 依 API 參考或自建前台指南實作。
  5. 寫入前確認業務條件,依營運自動化處理重試與逐筆結果。

Command Palette

Search for a command to run...