同業(B2B)
同業是合作的旅行社與個人團主。建好資料、指派負責業務,同業下單時用同業價建單,並把訂單掛到這家同業。
同業資料
在後台 →「客戶」→「同業」管理。按新增,只有公司名稱必填:
- 公司名稱、統編: 統編是 8 碼數字,個人團主可以留空。
- 主要聯絡人、電話、聯絡 Email、地址。
- 帳期 / 結算方式: 自由填寫,例:月結 30 天。
- 負責業務: 長期維護這家同業的人,可以留未指派。
- 備註: 內部使用。
清單可以依狀態、負責業務、有無統編篩選,並顯示每家同業的累計訂單數。頁首統計會提醒「未指派負責業務」與「無統編」的同業數。
負責業務不等於業績
同業的負責業務,回答「這家同業長期歸誰維護」。訂單的承辦業務,回答「這張單算誰的業績」。兩者互不影響:
- 同業的負責業務不會帶進訂單派發。新單由誰承辦,依公司的訂單派發規則決定。
- 換同業的負責業務,不會改寫歷史訂單的業績。改訂單的承辦,也不會改同業的負責業務。
- 有讀取同業權限的人看得到全部同業。業務在訂單那邊仍只看得到自己承辦的單。
替同業建單
同業的訂單只能在後台或 API 建立,前台結帳不能選同業。
- 在後台開「K 單」。
- 訂購人分類選「同業」。整張單改用同業價。
- 在「所屬同業(選填)」搜尋並選一家同業。
- 照一般流程完成建單。
同業價在行程與梯次的價格設定裡填,梯次留空就沿用行程的同業價。同業價只在後台顯示。除了價格不同,保留名額、應收與收款的流程和直客單一樣。
| 情況 | 結果 |
|---|---|
| 選「同業」並選了所屬同業 | 用同業價建單,訂單計入這家同業 |
| 選「同業」但沒選所屬同業 | 用同業價建單,不計入任何同業 |
| 選「直客」卻指定同業 | 不能建單 |
| 指定的同業不存在或已下架 | 不能建單 |
系統不會依訂購人自動帶入同業,每張單都要自己選。掛上同業後,訂單列表可以依同業篩選。
下架與重新上架
不再合作的同業請下架,不要刪除。下架後:
- 這家同業不再出現在活躍名單,也不能再掛新訂單。
- 既有訂單的關聯與歷史保留。
- 隨時可以按「重新上架」,回到活躍名單。
›API 與 CLI 對應
所有端點見 agencies API。
| 動作 | 端點 | 權限 |
|---|---|---|
| 列出同業 | GET /api/v1/agencies | agency.read |
| 讀單一同業 | GET /api/v1/agencies/{id} | agency.read |
| 匯出名單 | GET /api/v1/agencies/export | agency.read |
| 可指派的負責業務 | GET /api/v1/agencies/assignable-staff | agency.read |
| 新增同業 | POST /api/v1/agencies | agency.manage |
| 部分更新 | PATCH /api/v1/agencies/{id} | agency.manage |
| 下架或重新上架 | POST /api/v1/agencies/{id}/status | agency.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 張,請經同業收款」。系統不寄催款信給旅客、訂購人或同業。