toko

同業(B2B)

同業是合作的旅行社與個人團主。建好資料、指派負責業務,同業下單時用同業價建單,並把訂單掛到這家同業。

同業資料

在後台 →「客戶」→「同業」管理。按新增,只有公司名稱必填:

  • 公司名稱、統編: 統編是 8 碼數字,個人團主可以留空。
  • 主要聯絡人、電話、聯絡 Email、地址。
  • 帳期 / 結算方式: 自由填寫,例:月結 30 天。
  • 負責業務: 長期維護這家同業的人,可以留未指派。
  • 備註: 內部使用。

清單可以依狀態、負責業務、有無統編篩選,並顯示每家同業的累計訂單數。頁首統計會提醒「未指派負責業務」與「無統編」的同業數。

負責業務不等於業績

同業的負責業務,回答「這家同業長期歸誰維護」。訂單的承辦業務,回答「這張單算誰的業績」。兩者互不影響:

  • 同業的負責業務不會帶進訂單派發。新單由誰承辦,依公司的訂單派發規則決定。
  • 換同業的負責業務,不會改寫歷史訂單的業績。改訂單的承辦,也不會改同業的負責業務。
  • 有讀取同業權限的人看得到全部同業。業務在訂單那邊仍只看得到自己承辦的單。

替同業建單

同業的訂單只能在後台或 API 建立,前台結帳不能選同業。

  1. 在後台開「K 單」。
  2. 訂購人分類選「同業」。整張單改用同業價。
  3. 在「所屬同業(選填)」搜尋並選一家同業。
  4. 照一般流程完成建單。

同業價在行程與梯次的價格設定裡填,梯次留空就沿用行程的同業價。同業價只在後台顯示。除了價格不同,保留名額、應收與收款的流程和直客單一樣。

情況結果
選「同業」並選了所屬同業用同業價建單,訂單計入這家同業
選「同業」但沒選所屬同業用同業價建單,不計入任何同業
選「直客」卻指定同業不能建單
指定的同業不存在或已下架不能建單

系統不會依訂購人自動帶入同業,每張單都要自己選。掛上同業後,訂單列表可以依同業篩選。

下架與重新上架

不再合作的同業請下架,不要刪除。下架後:

  • 這家同業不再出現在活躍名單,也不能再掛新訂單。
  • 既有訂單的關聯與歷史保留。
  • 隨時可以按「重新上架」,回到活躍名單。
›API 與 CLI 對應

所有端點見 agencies API。

動作端點權限
列出同業GET /api/v1/agenciesagency.read
讀單一同業GET /api/v1/agencies/{id}agency.read
匯出名單GET /api/v1/agencies/exportagency.read
可指派的負責業務GET /api/v1/agencies/assignable-staffagency.read
新增同業POST /api/v1/agenciesagency.manage
部分更新PATCH /api/v1/agencies/{id}agency.manage
下架或重新上架POST /api/v1/agencies/{id}/statusagency.manage

欄位: name(必填)、taxId、contactName、phone、email、address、paymentTerm、ownerUserId/ownerName、status(active 活躍、archived 已下架)、note、orderCount(派生)。列表與匯出可用 status、owner、hasTaxId 篩選。

同業訂單: POST /api/v1/orders 帶 customerType=agency(預設 direct),選填 agencyId(agc_ 開頭)。CLI 為 orders create --customer-type agency --agency-id <id>。直客單帶 agencyId、或 agencyId 不存在或已下架,回 422 validation。GET /api/v1/orders 與 GET /api/v1/orders/export 可用 agencyId 篩選。

相關指南

同業應付日

在同業資料選「應付日規則」:不設定、月結下個月 N 日、出團後 N 天,或訂單成立後 N 天。日期使用台北時間;月結遇到沒有該日的月份時,取月底。

訂單掛上同業時算一次。K 單、API 與名冊匯入帶同業時也會計算。改主檔規則不改既有訂單。出團後的規則使用第一梯出發日。

訂單頁可以手動改或清空應付日。沒有日期時顯示「未設應付日」。解除同業後,尾期回到行程規則。訂單尾期與待收清單使用已存的應付日。

應付日當天未付清時,系統通知第一梯的承辦;沒有合格承辦時通知管理員。此提醒不受硬期限通知開關控制,只沿用通知時刻。同一單與日期只通知一次。到期待辦列出已到期且未付清的同業單;付清或取消後離開。

批次寄尾款排除同業單,不建立付款連結。結果顯示「同業單 N 張,請經同業收款」。系統不寄催款信給旅客、訂購人或同業。

Command Palette

Search for a command to run...