現金出納帳
現金出納帳機能は、仕訳データから現金勘定に関連する取引を抽出し、日々の現金の入出金を管理する機能です。
概要
現金出納帳は仕訳帳から自動的に生成されるため、別途データ入力は不要です。仕訳データを登録するだけで、自動的に現金出納帳に反映されます。
表示される情報：
- 取引日
- 摘要（仕訳の摘要）
- 入金額（現金の借方計上）
- 出金額（現金の貸方計上）
- 残高（累積残高）
- 相手勘定科目
主な機能
仕訳データからの自動生成
現金出納帳は仕訳帳に登録された現金勘定（account_code: 'cash' または account_name: '現金'）の取引から自動生成されます。
- 借方計上: 現金の入金として表示
- 貸方計上: 現金の出金として表示
残高の自動計算
各取引の登録後、現金残高が自動的に計算されます。
計算式：
新残高 = 前残高 + 入金額 - 出金額
前期繰越残高
指定した期間の開始日前の現金残高が前期繰越として表示されます。
相手勘定科目の表示
現金取引の相手勘定科目を表示します：
- 単一相手科目: 1対1の仕訳の場合、相手勘定科目を表示
- 諸口: 複数の相手勘定科目がある場合、「諸口」と表示
取引履歴の表示
登録された現金取引の一覧を日付順に表示できます。期間を指定しての絞り込みも可能です。
PDF出力
現金出納帳をPDF形式で出力できます。以下の情報が含まれます：
- 会社名
- 対象期間
- 前期繰越残高
- 取引明細（日付、摘要、相手勘定科目、入金、出金、残高）
- 合計金額
- 期末残高
Excel/CSV出力
現金出納帳のデータをCSV形式でエクスポートできます。Excelで開いて再加工や分析が可能です。
使い方
Webインターフェース
- レポートメニューから「現金出納帳」を選択
- 表示期間を設定（デフォルトは現在の会計期間）
- 画面上に現金取引明細が表示される
- 「PDF出力」または「Excel出力」ボタンをクリック
API エンドポイント
現金出納帳表示
GET /reports/cash-book?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD
PDF出力
GET /reports/cash-book/export-pdf?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD
Excel/CSV出力
GET /reports/cash-book/export-excel?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD
パラメータ
start_date(オプション): 開始日（YYYY-MM-DD）end_date(オプション): 終了日（YYYY-MM-DD）
※ 日付の指定がない場合、現在の会計期間が使用されます。
法定帳簿としての適合性
この実装は日本の会計法規に基づく現金出納帳の要件を満たしています：
- 年月日 - 各取引の日付を記録
- 摘要 - 取引内容の説明
- 相手勘定科目 - 複式簿記の相手勘定科目を表示
- 入金額/出金額 - 各取引の金額
- 残高 - 各取引後の累積残高
- 前期繰越 - 期間開始時の残高
仕訳データとの関係
現金出納帳は仕訳データのビューとして機能します：
- 仕訳帳に現金勘定を含む仕訳を登録すると、自動的に現金出納帳に反映
- 仕訳の修正・削除も自動的に反映
- 現金出納帳は読み取り専用で、現金取引の登録は仕訳帳から行います
注意事項
- 現金出納帳に表示されるデータは仕訳データから生成されるため、直接編集することはできません
- 現金取引を修正する場合は、仕訳帳から該当の仕訳を修正してください
- PDF生成には日本語フォントが必要です
- 大量データの出力は処理時間に注意が必要です