iDempiere 1099ボックスの使い方｜債権債務・資金管理 操作マニュアル・技術仕様
This content is not available in your language yet.
📖 債権債務・資金管理の全体像: 債権債務・資金管理の全体図 も合わせてご覧ください。
1099ボックスは、米国の税務報告様式「Form 1099」の報告区分（ボックス）を定義するマスタです。定義したボックスは取引先マスタのデフォルト 1099 ボックスや請求明細に紐づけられ、仕入先への支払を 1099 報告区分ごとに分類する基盤になります。
📌 ポイント: 米国税務（IRS への支払報告）向けの機能です。取引先マスタには「1099 対象仕入先（Is1099Vendor）」フラグと「デフォルト 1099 ボックス」が用意されており、ここで定義したボックスを割り当てて使用します。
1099ボックスでできること
Section titled “1099ボックスでできること”- 1099 報告区分（ボックス）のコード・名称の定義
- Bucket 番号（1〜16 の整数）による区分の管理
- 取引先マスタへのデフォルト 1099 ボックス割り当て（Default1099Box_ID）
- 請求明細（C_InvoiceLine）単位での 1099 ボックス指定
- 説明・コメント欄による運用ルールの記録
単一タブ構成のマスタウィンドウです（AD_Window_ID: 200036）。
| タブ名 | テーブル | 項目数 | 役割 |
|---|---|---|---|
| 1099 Box | C_1099Box | 8項目 | 1099 報告区分の定義（検索キー・名称・Bucket 等） |
基本操作手順
Section titled “基本操作手順”graph TD
A["🚀 メニューから開く<br/>債権債務管理＆資金管理 > 1099 Box"] --> B["➕ 新規で登録<br/>（検索キー・名称・Bucket）"]
B --> C["💾 保存"]
C --> D["👥 取引先マスタで仕入先に<br/>デフォルト1099ボックスを設定"]
D --> E["🧾 仕入請求書の明細に<br/>1099ボックスが紐づく"]
E --> F["📊 1099報告区分ごとの<br/>支払分類に利用"]
アクセス方法
Section titled “アクセス方法”メニューから「債権債務管理＆資金管理 > 1099 Box」を開きます。
- ツールバーの「新規」ボタンをクリック
- 基本情報を入力:
- 検索キー: ボックスの一意コード（必須、最大40文字）
- 名称: ボックスの名称（必須、最大60文字）
- Bucket: 区分番号（必須。1〜16 の整数）
- 説明 / コメント: 補足情報（任意）
- 「保存」をクリック
- 取引先マスタの対象仕入先で「1099 対象仕入先」を有効にし、「デフォルト 1099 ボックス」に登録したボックスを設定します
項目リファレンス
Section titled “項目リファレンス”全 8 項目です。全項目一覧はリファレンス参照。
| 項目名 | 必須 | 型 | 説明 |
|---|---|---|---|
| 検索キー | 必須 | 文字列 | ボックスの一意コード（最大40文字） |
| 名称 | 必須 | 文字列 | ボックス名（最大60文字、レコード識別子） |
| Bucket | 必須 | 整数 | 区分番号。最小値 1・最大値 16 |
| 説明 | - | 文字列 | 補足説明（最大255文字） |
| コメント | - | テキスト | コメント・ヒント（最大2000文字） |
| 有効 | 必須 | チェック | レコードの有効フラグ（デフォルト Y） |
よくある質問（FAQ）
Section titled “よくある質問（FAQ）”Q. Bucket には何を入力しますか？
Section titled “Q. Bucket には何を入力しますか？”1〜16 の整数を入力します（AD 定義で最小値 1・最大値 16 の制約あり、必須項目）。1099 報告区分を番号で管理するための項目で、範囲外の値は保存できません。
Q. 定義したボックスはどこで使われますか？
Section titled “Q. 定義したボックスはどこで使われますか？”ソース上の参照先は次のとおりです。(1) 取引先マスタの「デフォルト 1099 ボックス」（C_BPartner.Default1099Box_ID。「1099 対象仕入先（Is1099Vendor）」フラグとセットで使用）、(2) 請求明細の 1099 ボックス（C_InvoiceLine.C_1099Box_ID）、(3) 請求書インポート（I_Invoice）。また 1099 抽出用のワークテーブル T_1099Extract が標準で用意されています。
Q. 日本の税務でも使用しますか？
Section titled “Q. 日本の税務でも使用しますか？”Form 1099 は米国 IRS への支払報告制度に対応する機能であり、日本の税務申告には対応する制度がないため、通常は米国拠点・米国仕入先を持つ場合にのみ使用します。
Q. 登録したボックスは削除できますか？
Section titled “Q. 登録したボックスは削除できますか？”テーブル定義上は削除可能（isDeleteable=Y）です。ただし取引先や請求明細から参照されているボックスは外部参照制約により削除できないため、使用を止める場合は「有効」フラグを OFF にする運用を推奨します。
🛠 技術仕様（開発者向け）
1099ボックスは C_1099Box テーブル（アクセスレベル: クライアント+組織）に格納されます。専用の M クラスは存在せず、自動生成クラス X_C_1099Box（240行）のみで構成される純粋なマスタテーブルです。独自のビジネスロジックはありません。
アーキテクチャ概要
Section titled “アーキテクチャ概要”classDiagram
class X_C_1099Box {
<<generated>>
+getValue() String
+getName() String
+getBucket() int
}
class I_C_1099Box {
<<interface>>
}
class PO {
<<abstract>>
}
X_C_1099Box --|> PO
X_C_1099Box ..|> I_C_1099Box
C_BPartner --> X_C_1099Box : Default1099Box_ID
C_InvoiceLine --> X_C_1099Box : C_1099Box_ID
パッケージ: org.compiere.model
ソースファイル: org.adempiere.base/src/org/compiere/model/X_C_1099Box.java（M クラスなし）
関連DBテーブル
Section titled “関連DBテーブル”C_1099Box（1099ボックス）
Section titled “C_1099Box（1099ボックス）”| カラム名 | 型 | 必須 | 説明 | 備考 |
|---|---|---|---|---|
| C_1099Box_ID | ID | PK | 1099ボックスID | 主キー |
| AD_Client_ID / AD_Org_ID | TableDirect | Y | クライアント / 組織 | |
| Value | String(40) | Y | 検索キー | 一意 |
| Name | String(60) | Y | 名称 | レコード識別子 |
| Bucket | Integer | Y | 区分番号 | 最小値 1・最大値 16 |
| Description | String(255) | N | 説明 | |
| Help | Text(2000) | N | コメント | |
| IsActive | YesNo | Y | 有効 | デフォルト Y |
参照元テーブル
Section titled “参照元テーブル”erDiagram
C_1099Box ||--o{ C_BPartner : "Default1099Box_ID"
C_1099Box ||--o{ C_InvoiceLine : "C_1099Box_ID"
C_1099Box ||--o{ I_Invoice : "import"
| テーブル | カラム | 用途 |
|---|---|---|
| C_BPartner | Default1099Box_ID | 仕入先のデフォルト 1099 ボックス（Is1099Vendor と併用） |
| C_InvoiceLine | C_1099Box_ID | 請求明細単位の 1099 区分 |
| I_Invoice | （1099 関連列） | 請求書インポート時の指定 |
| T_1099Extract | - | 1099 抽出用ワークテーブル（X_T_1099Extract が生成済み） |
ビジネスロジック
Section titled “ビジネスロジック”M クラスが存在しないため、beforeSave/afterSave 等の固有ロジックはありません。Bucket の 1〜16 制約は AD カラム定義（valuemin/valuemax）で担保されます。
拡張ポイント
Section titled “拡張ポイント”- Model Validator: 検索キーの命名規則チェックや Bucket の重複禁止など、独自制約は
C_1099Boxへの modelChange フックで追加できます（OSGi プラグイン推奨）。 - Callout: 標準の callout 定義はありません。
関連ドキュメント
Section titled “関連ドキュメント”iDempiereカスタマイズのご相談
Section titled “iDempiereカスタマイズのご相談”米国拠点の 1099 報告運用や、国内税制に合わせた支払報告区分の独自マスタ追加など、要件に応じた拡張が可能です。
Ａｓ－Ｌｉｎｋ株式会社では、OSGiプラグインによる安全なカスタマイズを提供しています。