iDempiere 税金申告の使い方｜会計 操作マニュアル・技術仕様
📖 会計の全体像: 会計の全体図 も合わせてご覧ください。
税金申告は、税務当局への申告を裏付ける情報を作成し、対象伝票と会計転記を照合するためのウィンドウです。期間（開始日付〜終了日付）を指定して「課税申告作成」を実行すると、期間内の請求伝票等から申告明細が自動生成され、会計情報タブで転記済みの会計ファクトと突き合わせできます。
⚠️ 注意: iDempiere 13 標準ではこのウィンドウは無効化されています（旧バージョンからの互換用・標準メニュー未登録）。新規の業務設計での利用は推奨されません。税額の集計は税レポートや会計レポートの利用をご検討ください。
📌 ポイント: 明細は自動生成後に削除・手動追加が可能です。特定の伝票を申告対象から外したい場合は該当明細を削除し、調整が必要な場合はマニュアル明細を追加します。
税金申告でできること
Section titled “税金申告でできること”- 期間を指定した申告対象データの取りまとめ（取引日付・開始/終了日付）
- 「課税申告作成」ボタンによる伝票からの申告明細の自動生成
- 明細の削除・手動調整明細の追加（マニュアルフラグ）
- 課税標準額・税額の明細管理（税率・取引先・請求伝票との紐づけ）
- 会計情報タブでの会計転記（Fact_Acct）との照合
| タブ名 | テーブル | 項目数 | 役割 |
|---|---|---|---|
| 税金申告 | C_TaxDeclaration | 約10項目 | ヘッダー（期間・処理ボタン） |
| 申告明細 | C_TaxDeclarationLine | 約15項目 | 課税標準額・税額の明細（自動生成+手動） |
| 会計情報 | C_TaxDeclarationAcct | 約15項目 | 会計転記との照合情報（借方/貸方・勘定科目） |
基本操作手順
Section titled “基本操作手順”graph TD
A["🚀 ウィンドウを開く<br/>（13では標準メニュー未登録）"] --> B["➕ 新規でヘッダーを登録<br/>名称・取引日付・開始/終了日付"]
B --> C["⚙️ 課税申告作成ボタンを実行<br/>（期間内の伝票から明細を生成）"]
C --> D["📝 申告明細タブで確認<br/>不要な明細は削除・<br/>調整はマニュアル明細で追加"]
D --> E["📒 会計情報タブで<br/>会計転記と照合"]
E --> F["✅ 処理済みフラグで確定"]
アクセス方法（メニューパス）
Section titled “アクセス方法（メニューパス）”iDempiere 13 では標準メニューに登録されていません（AD_Window_ID: 359）。過去バージョンからの互換用途で、利用にはメニューまたはロールへの手動登録が必要です。
- 「新規」ボタンをクリック
- ヘッダー情報を入力:
- 名称: 申告の識別名（例:
2026年上期消費税） - 取引日付: 申告の基準日
- 開始日付 / 終了日付: 集計対象期間（時刻は保存時に自動で切り捨て）
- 名称: 申告の識別名（例:
- 「保存」後、「課税申告作成」ボタンで明細を生成
- 申告明細タブで内容を確認し、必要に応じて削除・手動追加
項目リファレンス（申告明細タブ）
Section titled “項目リファレンス（申告明細タブ）”| 項目名 | 必須 | 型 | 説明 |
|---|---|---|---|
| 明細番号 | 必須 | 整数 | 明細の一意な行番号 |
| マニュアル | 必須 | チェック | 手動追加の明細かどうか（デフォルト ON） |
| 課税標準額 | 必須 | 金額 | 税額計算の基礎となる金額 |
| 税額 | 必須 | 金額 | 明細の税額 |
| 転記日付 | 必須 | 日付 | 会計上の日付 |
| 取引先 | 必須 | 検索 | 対象取引先 |
| 通貨 | 必須 | 選択 | 明細の通貨 |
| 税率 | 必須 | 選択 | 適用税率 |
| 売上請求伝票 / 請求伝票明細 | - | 検索 | 明細の発生元（自動生成時に設定） |
よくある質問（FAQ）
Section titled “よくある質問（FAQ）”Q. iDempiere 13 でこのウィンドウは使えますか？
Section titled “Q. iDempiere 13 でこのウィンドウは使えますか？”標準では無効化されています（旧バージョンからの互換用）。新規の業務設計での利用は推奨されません。利用する場合はウィンドウの有効化とメニュー登録が別途必要です。
Q. 開始日付・終了日付に時刻を入れたのに消えてしまいます
Section titled “Q. 開始日付・終了日付に時刻を入れたのに消えてしまいます”仕様です。MTaxDeclaration.beforeSave() が DateFrom / DateTo の時刻部分を日単位に切り捨てます（TimeUtil.getDay()）。期間は日付単位で扱われます。
Q. 自動生成された明細を対象から外せますか？
Section titled “Q. 自動生成された明細を対象から外せますか？”外せます。明細は生成プロセスが作成しますが、特定の申告に含めたくない明細は削除できます。また、マニュアルフラグ付きの調整明細を手動で追加することも可能です。
Q. 会計情報タブには何が表示されますか？
Section titled “Q. 会計情報タブには何が表示されますか？”伝票との照合のための会計関連情報が表示されます。詳細レポートの基礎として、収益/費用および税金の転記（勘定科目・借方/貸方計上金額・ソース金額）が含まれます。
🛠 技術仕様（開発者向け）
税金申告は C_TaxDeclaration（ヘッダー）、C_TaxDeclarationLine（明細）、C_TaxDeclarationAcct（会計照合）の 3 テーブルで構成されます（いずれもアクセスレベル: Client+Org、削除不可テーブル）。モデルクラスは MTaxDeclaration（80行）、MTaxDeclarationLine（138行）、MTaxDeclarationAcct（82行）と小規模で、ロジックの中心は「課税申告作成」プロセス側にあります。DocAction/DocStatus カラムを持たない非伝票型（Processing ボタン + Processed フラグ方式）です。
アーキテクチャ概要
Section titled “アーキテクチャ概要”classDiagram
class MTaxDeclaration {
#beforeSave(newRecord) boolean
}
class MTaxDeclarationLine
class MTaxDeclarationAcct
class X_C_TaxDeclaration {
<<generated>>
}
class PO {
<<abstract>>
}
MTaxDeclaration --|> X_C_TaxDeclaration
X_C_TaxDeclaration --|> PO
MTaxDeclaration --> MTaxDeclarationLine : has many
MTaxDeclaration --> MTaxDeclarationAcct : has many
パッケージ: org.compiere.model
ソースファイル: org.adempiere.base/src/org/compiere/model/MTaxDeclaration.java ほか Line / Acct
関連DBテーブル
Section titled “関連DBテーブル”C_TaxDeclaration（税金申告ヘッダー）
Section titled “C_TaxDeclaration（税金申告ヘッダー）”| カラム名 | 型 | 必須 | 説明 | 備考 |
|---|---|---|---|---|
| C_TaxDeclaration_ID | ID | PK | 税金申告ID | |
| Name | String(60) | Y | 名称 | 識別子 |
| DateTrx | Date | Y | 取引日付 | |
| DateFrom / DateTo | Date | Y | 集計期間 | beforeSave で時刻切捨て |
| Processing | Button | N | 課税申告作成 | 伝票からの明細生成 |
| Processed | YesNo | Y | 処理済み |
C_TaxDeclarationLine（申告明細）
Section titled “C_TaxDeclarationLine（申告明細）”| カラム名 | 型 | 必須 | 説明 | 備考 |
|---|---|---|---|---|
| C_TaxDeclaration_ID | Search | Y | ヘッダーFK | 親リンク |
| Line | Integer | Y | 明細番号 | |
| IsManual | YesNo | Y | マニュアル | デフォルト Y |
| TaxBaseAmt / TaxAmt | Amount | Y | 課税標準額 / 税額 | |
| DateAcct | Date | Y | 転記日付 | |
| C_BPartner_ID | Search | Y | 取引先 | |
| C_Currency_ID | TableDirect | Y | 通貨 | |
| C_Tax_ID | TableDirect | Y | 税率 | |
| C_Invoice_ID / C_InvoiceLine_ID | Search | N | 発生元請求伝票/明細 | |
| C_AllocationLine_ID | Search | N | 消込明細 |
C_TaxDeclarationAcct（会計照合）
Section titled “C_TaxDeclarationAcct（会計照合）”| カラム名 | 型 | 必須 | 説明 |
|---|---|---|---|
| C_TaxDeclaration_ID | Search | Y | ヘッダーFK |
| C_AcctSchema_ID | TableDirect | Y | 会計スキーマ |
| Fact_Acct_ID | Search | Y | 会計ファクトへの参照 |
| Account_ID | Table | N | 勘定科目 |
| AmtAcctDr / AmtAcctCr | Amount | N | 借方/貸方計上金額 |
| AmtSourceDr / AmtSourceCr | Amount | N | ソース借方/貸方 |
| C_Tax_ID / C_BPartner_ID / C_Currency_ID | Search | N | 税率・取引先・通貨 |
erDiagram
C_TaxDeclaration ||--o{ C_TaxDeclarationLine : "lines"
C_TaxDeclaration ||--o{ C_TaxDeclarationAcct : "acct reconciliation"
C_TaxDeclarationLine }o--o| C_Invoice : "source"
C_TaxDeclarationLine }o--|| C_Tax : "tax rate"
C_TaxDeclarationAcct }o--|| Fact_Acct : "accounting fact"
ビジネスロジック
Section titled “ビジネスロジック”beforeSave()（MTaxDeclaration）
Section titled “beforeSave()（MTaxDeclaration）”DateFrom / DateTo が変更された場合、TimeUtil.getDay() で時刻部分を切り捨てて日単位に正規化します。モデルクラスのロジックはこれのみで、明細生成は Processing ボタンに紐づくプロセス（課税申告作成: Create Tax Declaration from Documents）が担います。
拡張ポイント
Section titled “拡張ポイント”- Model Validator:
C_TaxDeclarationLineのTYPE_BEFORE_NEWで税率・金額の整合チェック（課税標準額 × 税率 ≒ 税額 等）を追加できます - Callout: 標準ではこれらのテーブルにカラム callout は定義されていません
- 国別対応: 日本の申告様式への出力等は標準機能に含まれないため、本テーブルを集計ソースとした帳票プラグインの追加開発が必要です
関連プロセス
Section titled “関連プロセス”| プロセス名 | 説明 |
|---|---|
| 課税申告作成 | ヘッダーの Processing ボタンから実行。期間内の伝票から申告明細を生成 |
関連ドキュメント
Section titled “関連ドキュメント”iDempiereカスタマイズのご相談
Section titled “iDempiereカスタマイズのご相談”日本の消費税申告に合わせた集計・帳票出力は、標準の税データを活用したプラグイン開発で対応できます。
Ａｓ－Ｌｉｎｋ株式会社では、OSGiプラグインによる安全なカスタマイズを提供しています。