コンテンツにスキップ
As-Link Docs

iDempiere 1099ボックスの使い方｜債権債務・資金管理 操作マニュアル・技術仕様

📖 債権債務・資金管理の全体像: 債権債務・資金管理の全体図 も合わせてご覧ください。

1099ボックスは、米国の税務報告様式「Form 1099」の報告区分（ボックス）を定義するマスタです。定義したボックスは取引先マスタのデフォルト 1099 ボックスや請求明細に紐づけられ、仕入先への支払を 1099 報告区分ごとに分類する基盤になります。

📌 ポイント: 米国税務（IRS への支払報告）向けの機能です。取引先マスタには「1099 対象仕入先（Is1099Vendor）」フラグと「デフォルト 1099 ボックス」が用意されており、ここで定義したボックスを割り当てて使用します。

1099ボックスでできること

Section titled “1099ボックスでできること”
  • 1099 報告区分（ボックス）のコード・名称の定義
  • Bucket 番号（1〜16 の整数）による区分の管理
  • 取引先マスタへのデフォルト 1099 ボックス割り当て（Default1099Box_ID）
  • 請求明細（C_InvoiceLine）単位での 1099 ボックス指定
  • 説明・コメント欄による運用ルールの記録

画面構成

Section titled “画面構成”

単一タブ構成のマスタウィンドウです（AD_Window_ID: 200036）。

タブ名テーブル項目数役割
1099 BoxC_1099Box8項目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/>支払分類に利用"]

メニューから開く 債権債務管理＆資金管理 > 1099 Box 新規で登録 （検索キー・名称・Bucket） 保存 取引先マスタで仕入先に デフォルト1099ボックスを設定 仕入請求書の明細に 1099ボックスが紐づく 1099報告区分ごとの 支払分類に利用

アクセス方法

Section titled “アクセス方法”

メニューから「債権債務管理＆資金管理 > 1099 Box」を開きます。

新規登録

Section titled “新規登録”
  1. ツールバーの「新規」ボタンをクリック
  2. 基本情報を入力:
    • 検索キー: ボックスの一意コード（必須、最大40文字）
    • 名称: ボックスの名称（必須、最大60文字）
    • Bucket: 区分番号（必須。1〜16 の整数）
    • 説明 / コメント: 補足情報（任意）
  3. 「保存」をクリック
  4. 取引先マスタの対象仕入先で「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 にする運用を推奨します。

関連機能

Section titled “関連機能”
🛠 技術仕様（開発者向け）

概要

Section titled “概要”

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

<> +getValue() String +getName() String +getBucket() int <> <> > PO X_C_1099Box ..

パッケージ: 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_IDIDPK1099ボックスID主キー
AD_Client_ID / AD_Org_IDTableDirectYクライアント / 組織
ValueString(40)Y検索キー一意
NameString(60)Y名称レコード識別子
BucketIntegerY区分番号最小値 1・最大値 16
DescriptionString(255)N説明
HelpText(2000)Nコメント
IsActiveYesNoY有効デフォルト 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_BPartnerDefault1099Box_ID仕入先のデフォルト 1099 ボックス（Is1099Vendor と併用）
C_InvoiceLineC_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プラグインによる安全なカスタマイズを提供しています。

OSS ERP導入・カスタマイズサービスの詳細はこちら