內外帳與損益

cairn 的財務分兩層：每梯次只算到「毛利」（收入 − 真實成本），公司層才把手續費、稅、辦公室費用扣一次算出「淨利」。同一筆成本同時帶「內帳真實額」與「外帳可申報額」兩個金額，據此派生真實利潤與報稅邊界。

理解這層分工，你才能正確解讀損益相關端點——每梯次的 grossProfit、公司的淨利，都是成本明細與費用台帳算出來的派生值。

這是進階會計模組

注意

本篇的所有端點都屬進階會計模組（accounting）。租戶未啟用此模組時，內外帳、損益、結算相關端點會回 403 module_disabled——即使你的角色有對應權限。這與「權限不足」的 403 forbidden 是兩回事：module_disabled 要租戶在設定啟用模組，forbidden 要換有權限的 token。另外，內外帳與損益屬敏感全局財務，只有 admin / accountant 角色可讀（線控、嚮導端看不到淨利）。

內帳 vs 外帳：一筆成本兩個金額

每一筆成本同時承載兩個台幣金額，不分裂成兩套帳：

金額	是什麼	用途
內帳真實額	實際花掉的錢（含拿不到發票的支出）	算真實毛利 / 淨利
外帳可申報額	取得合法憑證、可報稅的部分（無憑證為 0）	對外申報 / 報稅

實務上常有拿不到發票的支出（停車費、補貼、自然人嚮導 / 司機勞務），這些是真實成本必須據實記錄，但對外申報只能列有合法憑證的部分——兩個金額的差就是「無憑證真實成本」。

說明

可申報額可上修也可下修：通常等於真實額，但有時拿到高於實際支出的發票（可上修），或一筆完全無發票（為 0）。所以「外帳 > 內帳」不是錯誤，是合法的匯率 / 憑證落差。

無發票的支出會掛一張支出證明單作為內帳的合法內部憑證（記受款對象、原因、摘要），可列印、走經手與核准雙職分離。

成本要先覆核才入帳

不是所有成本都「送出即生效」。嚮導 / 領隊在現場填報的成本，先進「待覆核」狀態，不計入淨利、不可申報、不可轉請款，要等會計覆核通過才入帳；後台或團控直接登記的成本則直接視為已覆核。

對應 API：GET /internal-external-ledger/declarations/pending 取待覆核佇列，POST /internal-external-ledger/costs/{costId}/approve-declaration 覆核單筆（覆核人必須 ≠ 經手人）。覆核後的嚮導代墊成本可一鍵轉成請款（payable）退還嚮導。

外幣成本：雙率派生台幣

海外團的真實成本常以外幣發生（地接日幣、印尼盾）。成本可原生記外幣金額 + 匯率，兩個台幣金額由同一筆外幣各自派生：

內帳匯率取真實取得成本：外幣帳戶的加權平均成本、當日台銀牌告、或手填成交率（三選一，不寫死團型）。
外帳匯率一律台銀牌告。
兩個匯率都在登記當下快照進成本列，事後牌告變動不回改既有成本。

注意

多幣別只進成本側。營收一律台幣——訂單、收款、退款都不收外幣，客人付的永遠是 TWD。

查匯率走 GET /exchange-rates（台銀牌告表，含現金 / 即期 × 買入 / 賣出四報價）與 GET /exchange-rates/resolve（解析某幣別某日的「1 外幣 = ? 台幣」）。resolve 的 fail-safe 約定：查無匯率回 200 帶 rate: null（不是 404），呼叫端請對 null 分支，不要靜默用 0 或 1。

每梯次只算到毛利

每一梯的權威數字是毛利 = 本團收入 − 真實成本，不扣手續費 / 稅：

本團收入   = 該梯次「成交應收」（不是當期收到的現金）
真實成本   = 已覆核成本的內帳真實額加總（含房費）
毛利       = 本團收入 − 真實成本

說明

收入認列口徑要記牢：本團收入是該梯次的成交應收，不是當期收到的現金（訂金 / 尾款常跨月分次收）。期間歸屬一律看出團月——某梯 5 月出團、3 月收訂金、6 月收尾款，全額營收與毛利都落在 5 月。

讀每梯次內外帳走 GET /internal-external-ledger/departures（列表）與 .../departures/{departureId}（單梯派生：revenue / realCost / declarable / grossProfit / estimatedNetProfit）。estimatedNetProfit 只是給現場快速感覺的參考預估（毛利減預估費率），不是公司財務真相。

掛帳台帳的跨梯彙整走 GET /accrual-ledger（單期間四區塊）與 .../departure-summary（梯次彙總：收入 / 真實成本 / 毛利）。

公司月損益

公司真實淨利在公司層算，把手續費 / 稅 / 辦公室費用用實際值扣一次（避免與每梯次重複計）：

公司營業費用是與梯次無關的支出，逐筆登錄成台帳，按月歸屬；費用科目由租戶自訂。對應 API：

端點	用途
`GET /pnl/statement`	公司月損益表（各區毛利 → 公司淨利）
`GET /pnl/expenses`	公司營業費用台帳（可依月 / 大類 / 科目篩選）
`GET /pnl/expense-categories`	費用科目目錄（租戶自訂）
`POST /pnl/expenses` · `PATCH /pnl/expenses/{id}`	登錄 / 更正費用

說明

費用大類（kind）分 opex（一般營業費用）、tax（稅）、platform_fee（平台手續費實際月結）、special（一次性特殊損益）。損益表按大類 roll-up 成幾格，點開再 drill-down 到逐筆。「人事」這格只裝行政 / 內勤固定薪——領隊費屬每梯次直接成本，已算進該梯毛利，不要重算進公司人事。

下一步

成本與範本：成本怎麼登記、行程綁範本自動帶成本行。
收款帳戶與結算：多帳戶分流、跨帳戶補款、月結互抵與換匯。
付款流程：客人收款、退款、出款（payables）的分界。
internal-external-ledger API · pnl API。