toko

同意書與罐頭訊息範本

兩種範本性質不同:同意書一經簽署就不能改,只能發布新版本;罐頭訊息可以隨時修改。

旅遊定型化契約也用同意書範本保存,契約的設定與規則另見旅遊契約。

同意書範本

在後台 →「範本」→「同意書範本」操作。

版本只增不改

已經有人簽過的同意書必須原封保留。所以你不會「編輯」一份同意書,而是發布新版本:

  1. 選類別,按「建立 … 新版本」(第一次建立時是「建立第一版」)。
  2. 填內容,送出。新版本立即生效。
  • 每個類別只認最新的啟用版本。發布新版後,客人要依新版重簽。
  • 停用版本: 改用上一個啟用版本。停用的版本不能重新啟用,內容與既有簽署紀錄保留,版本號不重複使用。
  • 一個類別的版本全部停用時,這個類別沒有可用的範本,系統不會要求任何人簽。

系統種類與自訂種類

系統內建四種同意書:個人資料保護同意書(PDPA)、旅遊契約、取消政策、退款政策。它們的簽署時機由系統決定。

其他需要客人簽的文件,例如登山切結書,請按「新增自訂同意書種類」:

設定選項
名稱顯示在範本頁的分頁
簽署時機結帳時,或成團後
簽署對象逐訂單(訂購人簽一份),或逐旅客(訂購人代表每位旅客確認)
適用行程全部行程,或指定行程(可多選)

建好種類後,再建立第一版範本。

自訂種類的規則:

  • 種類要是啟用的、已有範本、而且適用這個行程,才會要求簽署。
  • 「成團後」的種類,梯次要已成團、未取消;抽籤團還要已中籤。
  • 修改設定只影響之後的判定,已簽的紀錄保留。改簽署對象後,舊對象的簽署不再算數。
  • 改名不影響已簽紀錄。停用後不再要求新的簽署,歷史保留。還沒有任何版本的種類可以刪除。

簽署一律由客人本人在前台完成,承辦不能代簽。逐旅客的種類,由訂購人代表每位旅客確認。成團後的簽署提醒見出團準備與線控。

罐頭訊息

在後台 →「範本」→「罐頭訊息」操作。罐頭訊息是給客人的常用文字,例如收尾款、換梯通知、未成團通知。

每則範本填:

  • 通道: Email 或官方 LINE。
  • 階段分類: 對應公司的作業階段,例:受理、收訂金、行前通知。按「SOP 階段目錄」自訂階段名稱與順序。
  • 標題: 給員工辨識用。
  • 單人版內文: 必填。可插入變數,例 {{客戶姓名}}、{{行程名稱}}。編輯時旁邊會即時預覽代入後的訊息。
  • 多人版內文: 選填。訂單有多位旅客時使用,留空就用單人版。
  • 識別碼: 選填。決定這則範本會不會被系統自動寄出(見下)。

每次儲存都會記錄修改人與時間。停用的範本不會出現在可選清單。

兩種用法

承辦手動使用: 在訂單頁產生罐頭訊息,系統代入這張訂單的資料,承辦複製後貼給客人。官方 LINE 尚未串接推播,LINE 範本一律用這種方式。

系統自動寄送: 只有 Email 範本、而且識別碼對上下列情境時,系統才會在該情境自動寄出。沒填識別碼的範本標「未填・不自動寄送」。

識別碼情境
BALANCE_DUE收尾款
DEPARTURE_CHANGE換梯通知
GROUP_NOT_CONFIRMED未成團通知
LOTTERY_LOST_REFUND未中籤退款
ORDER_CANCELLED取消確認
ORDER_LINE_FOLLOW_UP下單後加官方 LINE
PAYMENT_RECEIVED已收到款項(行前說明)
REFUND_CARD_COMPLETED刷退完成
REFUND_REMIT_COMPLETED匯款退款完成
  • 每個情境有自己可用的變數。用了該情境不會代入的變數,預覽會標紅;寄出時那個變數會原樣留在信裡。
  • 收尾款的範本必須放 {{繳款連結}} 與 {{尾款金額}},缺少時編輯器會警告。
  • 同一個識別碼只能給一則範本用。

登山資格審核預選: 下列識別碼不會自動寄出,只讓審核對話框預選這則範本。承辦可改選別則,或選「不寄信」。找不到對應範本時預選「不寄信」。

識別碼預選時機
SCREENING_APPROVE核可放行,下一列以外的情況
SCREENING_APPROVE_CONDITIONAL核可放行,能力分勉強,而且沒有被高山經驗要求擋下
SCREENING_REJECT_RESUPPLEMENT駁回,補件重審
SCREENING_REJECT_SWITCH駁回,換行程
SCREENING_REJECT_REFUND駁回,退費

承辦在對話框填的備註會代入 {{補充說明}}。核可時沒填備註,這個變數代入空白。範本沒放這個變數,備註只留在審核紀錄。

已收到款項(PAYMENT_RECEIVED): 訂單第一次收到款項時寄給訂購人,同一段文字也以「系統」身分貼進訂單對話。之後的收款不再發。同業單與舊系統搬遷的入帳不發。付款連結付的第一筆錢也會發。全額一次付清時,客人另外還會收到「付款成功」信。

  • 行前說明網址在行程設定的「出團安排 → 行前說明」填寫。
  • 標籤與網址請寫在同一行,例:行前說明網址:{{行前說明網址}}。行程沒填網址時,系統刪掉含這個變數的整行。
  • 行程可以有自己的內文:在行程設定的「出團安排 → 行前說明」填「收款後通知內文」。有填時,這條行程的 Email 與對話留言都改用這段內文,可用的變數與這則範本相同。主旨仍用這則範本的主旨。這則範本停用時,行程的內文也不寄。

取消確認(ORDER_CANCELLED): 訂單以「客戶要求」取消時寄給訂購人,同一段文字也以「系統」身分貼進訂單對話。客人在會員中心自行取消,或員工在後台代為取消,都會寄。其他取消原因不寄。同業單不寄。

  • 金額變數只有數字,請在前面自己寫 NT$。
  • 退款金額還要由專人確認時(例:海外行程待核算、選擇保留款項),退款金額、退款方式 沒有值,退款備註 是「退款金額將由專人聯繫確認」。海外行程待核算時,退改費 也沒有值。
  • 這幾個變數沒有值時,系統刪掉含它的整行。請把每個變數放在獨立一行,例:
text
{{客戶姓名}} 您好,訂單 {{訂單編號}}({{行程名稱}},{{出發日期}})已取消。
已付金額:NT$ {{已付金額}}
退改費:NT$ {{退改費}}
已付換梯手續費(不退):NT$ {{已付換梯手續費}}
預計退款:NT$ {{退款金額}}
退款方式:{{退款方式}}
{{退款備註}}
實際入帳時間依各銀行作業為準。如有問題,請回覆這封信或加官方 LINE:{{官方LINE連結}}

刷退完成(REFUND_CARD_COMPLETED)與匯款退款完成(REFUND_REMIT_COMPLETED): 退款單完成時寄給訂購人,同一段文字也以「系統」身分貼進訂單對話。刷退在金流商確認退刷成功(或承辦回報後台退刷完成)時發;處理中、失敗或結果不明不發。匯款在退款單「標記已退款」時發。一張訂單有幾張退款單就發幾次。同業單不發。兩則範本各自停用時,該種退款不發,退款流程照常。

建議文字:

text
刷退完成:
您好,已為您辦理刷退 NT$ {{退款金額}},款項會退回原付款的信用卡。依發卡銀行作業,約 3~7 個工作天入帳,實際入帳時間以銀行為準。

匯款退款完成:
您好,已將退款 NT$ {{退款金額}} 匯至您提供的帳戶(末四碼 {{帳號末四碼}}),匯出日期 {{匯出日期}}。實際入帳時間依各銀行作業為準。
›可用變數

所有範本都能用:客戶姓名、訂單編號、行程名稱、出發日期、回程日期、人數、旅客姓名、官方LINE連結、尾款期限、匯款銀行、匯款帳號、匯款戶名。尾款期限與匯款三欄只在訂單有收款紀錄時才有值。

各情境另外可用:

識別碼額外變數
BALANCE_DUE繳款連結、尾款金額、待付款金額
DEPARTURE_CHANGE參團版本、原行程名稱、新行程名稱、原梯次、新梯次、原出發日期、新出發日期、價差、付款狀態、待付款金額、退款狀態、待補資料、待簽文件、訂單連結
GROUP_NOT_CONFIRMED訂單連結
LOTTERY_LOST_REFUND行政費明細、行政費、轉帳費、退款金額、退款筆數、訂單連結
ORDER_CANCELLED取消事由、已付金額、退改費、已付換梯手續費、退款金額、退款方式、退款備註
PAYMENT_RECEIVED行前說明網址
REFUND_CARD_COMPLETED退款金額
REFUND_REMIT_COMPLETED退款金額、帳號末四碼、匯出日期
›API 與 CLI 對應

同意書範本(consent-templates API、consent-kinds API)

動作端點
列出版本(可用 kind 篩選)GET /api/v1/consent-templates
發布新版本POST /api/v1/consent-templates
讀單一版本GET /api/v1/consent-templates/{id}
停用版本DELETE /api/v1/consent-templates/{id}
  • 權限一律 consent_template.create,讀寫共用。
  • 停用回傳 retired: true。
  • 系統種類的 kind 值:pdpa、tour_agreement、cancellation_policy、refund_policy。自訂種類用它的 ID(cnsk_ 開頭),發新版時把 ID 放進 kind。
  • 自訂種類欄位:簽署時機 checkout、after_confirm;簽署對象 order、traveler;適用行程為全部或指定 tripIds。

罐頭訊息(message-templates API)

動作端點
列出、新增GET /api/v1/message-templates、POST /api/v1/message-templates
讀取、修改GET /api/v1/message-templates/{id}、PATCH /api/v1/message-templates/{id}
刪除DELETE /api/v1/message-templates/{id}
啟用或停用POST /api/v1/message-templates/{id}/active
  • 讀取要 message_template.read,異動要 message_template.manage。
  • 欄位:stage(階段名稱,須在階段目錄中且啟用)、channel(line、email)、title、bodySingle、bodyMulti、key(2–64 碼大寫英數、_、-,自動轉大寫)、isActive。
  • 錯誤:識別碼重複回 KEY_DUPLICATE;階段不存在或已停用回 STAGE_INVALID。

寄信紀錄與安全重試

使用 email-history list 查詢寄信紀錄,使用 get 讀取明細。 省略日期時,查詢包含今天的最近七個台北日期。--start-date 與 --end-date 都包含當日。 可依狀態、分類、收件人、梯次、訂單與嚮導篩選。分頁使用 --page 與 --page-size,每頁最多 100 筆。

bash
toko email-history list --status failed --recipient customer@example.com --json
toko email-history list --start-date 2026-10-01 --end-date 2026-10-07 --departure dep_example --page 1 --page-size 20 --json
toko email-history get <id> --json
toko email-history retry <id> --confirm --json

讀取需要 email_history.read,重試需要 email_history.retry。 明細的 contentState 表示內容可讀、已遮罩或不可用。回應不含原始寄信資料或驗證 token。 清單回傳 asOf 查詢時間。翻頁時傳回同一個 asOf(CLI:--as-of),避免新信插入造成分頁位移。

只有 canRetry 為 true 的失敗紀錄能安全重試。retryUnavailableReason 說明無法重試的原因。一般通知重試共用原事件;重複請求不重複排程。地址變更時,先讀取明細的 retryRecipient,確認後以 expectedRecipient 送出;CLI 使用 --recipient。 密碼重設與啟用信透過原驗證流程申請新連結,不重播舊 token。新信另留紀錄,原失敗紀錄不改成已寄。OTP 與不支援的事件須從原流程重新申請。

員工 API 對應 GET /api/v1/email-history、GET /api/v1/email-history/{id} 與 POST /api/v1/email-history/{id}/retry。 查詢使用 startDate、endDate、status、category、recipient、departureId、orderId、guideId、asOf、page、pageSize。 列表回傳 items、total、asOf、page、pageSize,分類可用 auth、order、payment、guide、contract、message、system。

相關指南

寄信紀錄與關聯篩選的 ID 必須使用對應資源的前綴。錯誤 ID 回傳 HTTP 422。

Command Palette

Search for a command to run...