iDempiere 担当者(エージェント)別取引情報の使い方｜取引先管理 操作マニュアル・技術仕様

📖 取引先管理の全体像: 取引先管理の全体図 も合わせてご覧ください。

担当者(エージェント)別取引情報（Sales Rep Info）は、営業担当者（社内担当者・エージェント）を軸に、その担当者に関係する受注・請求を明細レベルまで一覧する照会ウィンドウです。担当者を 1 名選ぶだけで、担当案件の受注ヘッダー・受注明細・請求ヘッダー・請求明細を階層的にたどれます。

📌 ポイント: 表示対象は「その担当者が伝票の担当であるもの」だけではありません。iDempiere の定義では「担当者が伝票・取引先・品目のいずれかを担当している」受注・請求が対象になります。担当者の守備範囲を広く捉えた集計になっている点を理解して使ってください。

担当者別取引情報でできること

• 営業担当者を選んで、担当案件の受注・請求を横断的に確認する
• 受注明細タブで、品目別の注文数量・引当数量・出荷済数量・請求済数量を確認する
• 請求明細タブで、品目別の請求数量・単価・行合計・税額を確認する
• 受注の伝票状態・納品予定日・送付済み/請求済みフラグから進捗を把握する
• 請求の入金済み・検討中フラグから回収状況を把握する
• 担当者本人の連絡先情報（メール・電話・上長）を確認する
• 担当者ごとの受注残・請求実績を明細レベルで分析する

画面構成

親タブの下に、受注系（2 階層）と請求系（2 階層）が並ぶ4 タブ + 親タブの構成です。子タブがさらに孫タブを持つ点が、取引先別取引情報との大きな違いです。

タブ名	テーブル	階層	項目数	役割
販売代理	AD_User	0	14項目	対象の担当者を選択（連絡先・上長）
注文書	C_Order	1	32項目	担当案件の受注ヘッダー
注文書詳細	C_OrderLine	2	26項目	受注明細（品目・数量・単価）
請求書	C_Invoice	1	25項目	担当案件の請求ヘッダー
請求書詳細	C_InvoiceLine	2	17項目	請求明細（品目・数量・税額）

graph TD
    P["👤 販売代理<br/>AD_User<br/>14項目"]
    P --> T1["🛒 注文書<br/>C_Order<br/>32項目"]
    T1 --> T2["&nbsp;&nbsp;└ 注文書詳細<br/>&nbsp;&nbsp;&nbsp;&nbsp;C_OrderLine<br/>&nbsp;&nbsp;&nbsp;&nbsp;26項目"]
    P --> T3["🧾 請求書<br/>C_Invoice<br/>25項目"]
    T3 --> T4["&nbsp;&nbsp;└ 請求書詳細<br/>&nbsp;&nbsp;&nbsp;&nbsp;C_InvoiceLine<br/>&nbsp;&nbsp;&nbsp;&nbsp;17項目"]

販売代理 AD_User 14項目 注文書 C_Order 32項目   └ 注文書詳細     C_OrderLine     26項目 請求書 C_Invoice 25項目   └ 請求書詳細     C_InvoiceLine     17項目

💡 ヒント: 明細タブ（注文書詳細・請求書詳細）は、上位タブで選択中の伝票に連動します。品目別の実績を見たい場合は、まず上位タブで対象伝票を選んでから明細タブへ移動してください。

基本操作手順

graph TD
    A["🚀 メニューから開く<br/>取引先管理 > 担当者(エージェント)別取引情報"] --> B["🔍 販売代理タブで<br/>担当者を検索・選択"]
    B --> C{"何を確認するか"}
    C -->|受注の進捗| D["🛒 注文書タブ<br/>伝票状態・納品予定日<br/>送付済み・請求済みを確認"]
    D --> E["📦 注文書詳細タブ<br/>注文数量 vs 出荷済数量<br/>vs 請求済数量を突合"]
    C -->|請求・回収| F["🧾 請求書タブ<br/>入金済み・検討中を確認"]
    F --> G["🧮 請求書詳細タブ<br/>品目別の行合計・税額を確認"]
    E --> H["📊 担当者別の実績を把握"]
    G --> H

メニューから開く 取引先管理 > 担当者(エージェント)別取引情報 販売代理タブで 担当者を検索・選択 何を確認するか 注文書タブ 伝票状態・納品予定日 送付済み・請求済みを確認 注文書詳細タブ 注文数量 vs 出荷済数量 vs 請求済数量を突合 請求書タブ 入金済み・検討中を確認 請求書詳細タブ 品目別の行合計・税額を確認 担当者別の実績を把握 受注の進捗 請求・回収

アクセス方法（メニューパス）

メニューから「取引先管理 > 担当者(エージェント)別取引情報」を開きます（AD_Window_ID: 293）。

照会の手順

1. 「販売代理」タブで対象の担当者を検索します
   • 名称（Name） で絞り込みます
   • 取引先（C_BPartner_ID）: 担当者が紐付く取引先（社内組織や代理店）
   • Eメール / 電話番号 / FAX: 連絡先の確認
   • 責任者（Supervisor_ID）: エスカレーション先の上長
2. 「注文書」タブで担当案件の受注を確認します
   • 伝票状態（DocStatus） で進行状況を確認
   • 送付済み（IsDelivered） / 請求済み（IsInvoiced） で出荷・請求の完了状況を確認
   • 総合計（GrandTotal） で受注金額を確認
3. 「注文書詳細」タブで品目別の数量を突合します
   • 注文数量 / 引当数量 / 出荷済数量 / 請求済数量 の 4 つを比較すると、どこで止まっているかがわかります
4. 「請求書」「請求書詳細」タブで請求・回収状況を確認します

⚠️ 注意: 本画面は照会目的で、伝票アクション（DocAction）のフィールドは配置されていません。伝票の完了・取消は 受注伝票・売上請求伝票の各ウィンドウで行ってください。

項目リファレンス（主要タブ）

販売代理タブ（AD_User）

項目名	必須	型	説明
名称	必須	文字列	担当者名
説明	-	文字列	補足説明
取引先	-	検索	担当者が属する取引先
取引先住所	-	選択	担当者の所在地
Eメール	-	文字列	メールアドレス
タイトル	-	文字列	肩書き
電話番号	-	文字列	電話番号
FAX	-	文字列	FAX 番号
生年月日	-	日付	誕生日・記念日
責任者	-	検索	上長（エスカレーション・承認先）
取引組織	-	選択	実行・起票する組織
有効	必須	チェック	レコードが有効か

注文書タブ（主要項目）

項目名	必須	型	説明
伝票番号	必須	文字列	受注伝票番号
顧客注文番号	-	文字列	取引先側の注文番号
伝票状態	必須	リスト	ドラフト/完了/取消等
注文日付	必須	日付	受注日
納品予定日	必須	日付	約束した納品日
取引先	必須	検索	受注先
出荷ルール	必須	リスト	出荷タイミングの規則
請求ルール	必須	リスト	請求のタイミング・方法
社内担当者	必須	選択	担当営業
送付済み	必須	チェック	出荷が完了しているか
請求済み	必須	チェック	請求が完了しているか
明細行合計	必須	金額	明細合計（税抜）
総合計	必須	金額	伝票総額

注文書詳細タブ（主要項目）

項目名	必須	型	説明
明細番号	必須	整数	伝票内の行番号
品目	-	検索	受注品目
説明のみ	必須	チェック	ON なら説明行（取引を伴わない）
注文数量	必須	数量	受注した数量
引当数量	必須	数量	在庫を引き当てた数量
出荷済数量	必須	数量	出荷済みの数量
請求済数量	必須	数量	請求済みの数量
営業定価	必須	単価	価格表の定価
割引 %	-	数値	割引率
単価	必須	単価	実際の販売単価
行合計	必須	金額	数量 × 単価（送料・手数料を除く）
出荷日付	-	日付	実際に出荷した日
請求日付	-	日付	請求した日

請求書詳細タブ（主要項目）

項目名	必須	型	説明
明細番号	必須	整数	伝票内の行番号
品目	-	検索	請求品目
料金	-	選択	品目以外の請求項目（手数料等）
請求済数量	必須	数量	請求数量
単価	必須	単価	実際の請求単価
営業定価	必須	単価	価格表の定価
行合計	必須	金額	数量 × 単価（税抜）
税額	-	金額	明細の税額
税率	必須	選択	適用される税
税込行合計	-	金額	税込の行合計

全項目一覧はリファレンス参照

数量の突合による進捗把握

受注明細の 4 つの数量を比較すると、案件がどの段階で止まっているかが判別できます。

状態	注文数量	引当数量	出荷済数量	請求済数量	判断
受注直後	10	10	0	0	在庫は確保済み、出荷待ち
在庫不足	10	0	0	0	引当できていない（在庫確認が必要）
一部出荷	10	4	6	0	6個出荷済み、残4個が引当中
出荷完了・未請求	10	0	10	0	請求処理が未実施
完了	10	0	10	10	出荷・請求とも完了

業務フロー上の位置づけ

graph TD
    A["担当者（社内担当者）<br/>AD_User"] --> B["受注伝票<br/>C_Order"]
    A --> C["取引先<br/>C_BPartner"]
    A --> D["品目<br/>M_Product"]
    C --> B
    D --> E["受注明細<br/>C_OrderLine"]
    B --> E
    B --> F["請求伝票<br/>C_Invoice"]
    F --> G["請求明細<br/>C_InvoiceLine"]
    E --> G
    G --> H["担当者別の売上実績"]

担当者（社内担当者） AD_User 受注伝票 C_Order 取引先 C_BPartner 品目 M_Product 受注明細 C_OrderLine 請求伝票 C_Invoice 請求明細 C_InvoiceLine 担当者別の売上実績

よくある質問（FAQ）

Q. 担当者として選べるユーザーの条件は何ですか？

親タブは AD_User を対象にしていますが、iDempiere で「社内担当者（Sales Rep）」として扱われるには、対応する取引先（C_BPartner）で 社内担当者（IsSalesRep） にチェックが入っている必要があります。担当者が選択肢に出ない場合は、取引先マスタ側の設定を確認してください。

Q. 自分が担当していない伝票も表示されるのはなぜですか？

このウィンドウの対象定義は「担当者が伝票・取引先・品目のいずれかを担当している受注/請求」です。伝票の SalesRep_ID が別人でも、その取引先や品目の担当が自分であれば表示されます。純粋に伝票担当だけで絞りたい場合は、注文書タブの「社内担当者」列でさらに絞り込んでください。

Q. 「送付済み（IsDelivered）」と出荷済数量の関係は？

IsDelivered は受注ヘッダーのフラグで、全明細の出荷が完了した時点で ON になります。一部だけ出荷されている段階では OFF のままなので、部分出荷の把握には注文書詳細タブの出荷済数量を見てください。

Q. 引当数量（QtyReserved）が 0 なのに出荷されていません

在庫の引当ができていない状態です。在庫不足、または倉庫・ロケーターの設定に問題がある可能性があります。品目マスタの在庫状況と、倉庫の設定を確認してください。

Q. 「説明のみ（IsDescription）」の明細とは何ですか？

品目を伴わず、伝票上にテキストだけを表示する行です。IsDescription=Y の明細は数量・金額の計算対象外になります。集計時はこの行を除外してください。

Q. 請求書詳細の「税込行合計（LineTotalAmt）」と「行合計（LineNetAmt）」の違いは？

LineNetAmt は税抜の行金額（数量 × 単価、送料・手数料を除く）、LineTotalAmt は税を含めた行合計です。税抜・税込のどちらで集計するかによって使い分けてください。

Q. 取引先別取引情報との使い分けは？

取引先別取引情報（AD_Window_ID: 291）は取引先を軸にヘッダーレベルで幅広く（出荷・入金・資産・リクエストまで）照会します。本ウィンドウは担当者を軸に受注・請求へ絞り、明細レベルまで掘り下げます。「1 社の全体像」なら前者、「1 人の販売実績の内訳」なら本ウィンドウが適しています。

関連機能

• 取引先別取引情報の使い方
• 取引先マスタの使い方
• 受注伝票の使い方
• 売上請求伝票の使い方
• 品目マスタの使い方
• 画面リファレンス: 担当者(エージェント)別取引情報

🛠 技術仕様（開発者向け）

概要

担当者(エージェント)別取引情報（AD_Window_ID: 293）は照会型のウィンドウで、親タブ AD_User（階層 0）に対し、C_Order（階層 1）→ C_OrderLine（階層 2）、C_Invoice（階層 1）→ C_InvoiceLine（階層 2）という 2 系統の階層タブを持ちます。

このウィンドウ固有のモデルクラスは存在しません。 各タブは既存の業務テーブルを参照するため、ロジックは MUser（1,193行）、MOrder / MOrderLine、MInvoice / MInvoiceLine に委譲されます。伝票アクションのフィールドを持たないため、伝票処理は実行できません。

アーキテクチャ概要

classDiagram
    class MUser {
        +get(ctx, AD_User_ID)$ MUser
        +getName() String
        +getEMail() String
        +getSupervisor_ID() int
        +getC_BPartner_ID() int
    }
    class MOrder {
        <<DocAction>>
        +getLines() MOrderLine[]
        +getGrandTotal() BigDecimal
    }
    class MOrderLine {
        +getQtyOrdered() BigDecimal
        +getQtyReserved() BigDecimal
        +getQtyDelivered() BigDecimal
        +getQtyInvoiced() BigDecimal
        +getLineNetAmt() BigDecimal
    }
    class MInvoice {
        <<DocAction>>
        +getLines() MInvoiceLine[]
    }
    class MInvoiceLine {
        +getQtyInvoiced() BigDecimal
        +getLineNetAmt() BigDecimal
        +getTaxAmt() BigDecimal
    }
    MUser --> MOrder : sales rep of
    MOrder --> MOrderLine : has many
    MUser --> MInvoice : sales rep of
    MInvoice --> MInvoiceLine : has many

+get(ctx, AD_User_ID)$ MUser +getName() String +getEMail() String +getSupervisor_ID() int +getC_BPartner_ID() int <> +getLines() MOrderLine[] +getGrandTotal() BigDecimal +getQtyOrdered() BigDecimal +getQtyReserved() BigDecimal +getQtyDelivered() BigDecimal +getQtyInvoiced() BigDecimal +getLineNetAmt() BigDecimal <> +getLines() MInvoiceLine[] +getQtyInvoiced() BigDecimal +getLineNetAmt() BigDecimal +getTaxAmt() BigDecimal

パッケージ: org.compiere.model 主なソースファイル: org.adempiere.base/src/org/compiere/model/MUser.java（1,193行）、MOrder.java / MOrderLine.java / MInvoice.java / MInvoiceLine.java

関連DBテーブル

AD_User（担当者・親タブ）

カラム名	型	必須	説明	備考
AD_User_ID	ID	PK	ユーザーID	主キー
Name	String	Y	名称
Description	String	N	説明
C_BPartner_ID	Search	N	取引先	担当者の所属先
C_BPartner_Location_ID	TableDirect	N	取引先住所
EMail	String	N	Eメール
Title	String	N	タイトル（肩書き）
Phone / Fax	String	N	電話番号 / FAX
Birthday	Date	N	生年月日
Supervisor_ID	Search	N	責任者	エスカレーション・承認先
AD_OrgTrx_ID	Table	N	取引組織
IsActive	YesNo	Y	有効

C_OrderLine（注文書詳細）の数量カラム

進捗判定の要になるカラム群です。

カラム名	型	必須	説明
QtyOrdered	Quantity	Y	注文数量
QtyReserved	Quantity	Y	引当数量（未出荷分の在庫確保）
QtyDelivered	Quantity	Y	出荷済数量
QtyInvoiced	Quantity	Y	請求済数量
PriceList	Costs+Prices	Y	営業定価
PriceActual	Costs+Prices	Y	実際の販売単価
Discount	Number	N	割引率(%)
LineNetAmt	Amount	Y	行合計（税抜）
IsDescription	YesNo	Y	説明のみの行か

C_InvoiceLine（請求書詳細）の金額カラム

カラム名	型	必須	説明
QtyInvoiced	Quantity	Y	請求済数量
PriceActual	Costs+Prices	Y	実際の請求単価
PriceList	Costs+Prices	Y	営業定価
LineNetAmt	Amount	Y	行合計（税抜）
TaxAmt	Amount	N	税額
C_Tax_ID	TableDirect	Y	適用税
LineTotalAmt	Amount	N	税込行合計
C_Charge_ID	TableDirect	N	料金（品目以外の請求項目）

ER図

erDiagram
    AD_User ||--o{ C_Order : "sales rep"
    AD_User ||--o{ C_Invoice : "sales rep"
    AD_User }o--o| C_BPartner : "belongs to"
    AD_User }o--o| AD_User : "supervisor"
    C_Order ||--o{ C_OrderLine : "lines"
    C_Invoice ||--o{ C_InvoiceLine : "lines"
    C_Order ||--o{ C_Invoice : "billed by"
    C_OrderLine ||--o{ C_InvoiceLine : "invoiced as"
    C_OrderLine }o--o| M_Product : "product"

sales rep belongs to billed by invoiced as

ビジネスロジック

このウィンドウ自体には固有のビジネスロジックがありません。

タブの絞り込み条件

AD_Tab の定義（説明文）によれば、注文書・請求書タブの対象は次のとおりです。

タブ	対象条件（AD_Tab の定義）
注文書	担当者が「伝票」「取引先」「品目」のいずれかを担当している全受注
注文書詳細	同条件を満たす全受注明細
請求書	担当者が「伝票」「取引先」「品目」のいずれかを担当している全請求
請求書詳細	同条件を満たす全請求明細

📌 ポイント: この「伝票・取引先・品目のいずれか」という条件は、SalesRep_ID 単独の絞り込みより広い範囲になります。担当者別の売上実績を厳密に集計する場合は、伝票の SalesRep_ID だけで絞る独自レポートを別途用意する方が正確です。

数量カラムの更新タイミング

カラム	更新契機
QtyReserved	受注完了時に在庫引当、出荷完了時に減算
QtyDelivered	出荷（M_InOut）完了時に加算
QtyInvoiced	請求（C_Invoice）完了時に加算

いずれも MOrderLine / MInOutLine / MInvoiceLine の伝票処理内で更新され、このウィンドウは結果を表示するだけです。

拡張ポイント（カスタマイズ箇所）

タブ・項目の追加

担当者軸で見たい情報（見積の履歴、目標達成率など）を追加する場合は、AD 上で AD_Tab / AD_Field を追加します。ソースコードの改変は不要で、バージョンアップ時の影響も最小限に抑えられます。

担当者別実績の集計

明細レベルの集計（担当者別・品目別の売上）は、このウィンドウよりも以下の方法が適しています。

• Print Format / レポートビューア: C_InvoiceLine を対象に SalesRep_ID でグループ化
• Info Window: 独自 SQL で担当者別の集計ビューを定義
• パフォーマンス指標（PA_Measure / PA_Goal）: 担当者ごとの目標と実績をダッシュボードに表示

OSGi Model Validator

担当者の割り当てルール（例: 特定の取引先には特定の担当者しか設定できない）を強制する場合は、受注・請求側の Model Validator で制御します。

public class CustomSalesRepValidator implements ModelValidator {
    @Override
    public int modelChange(PO po, int type) throws Exception {
        if (po instanceof MOrder && (type == TYPE_BEFORE_NEW || type == TYPE_BEFORE_CHANGE)) {
            MOrder order = (MOrder) po;
            if (order.isSOTrx() && order.getSalesRep_ID() == 0) {
                throw new AdempiereException("受注伝票には社内担当者を設定してください");
            }
        }
        return null;
    }

    @Override
    public String docValidate(PO po, int timing) {
        return null;
    }
}

権限による表示範囲の制御

担当者が自分の案件だけを見られるようにする場合は、ロールのデータアクセスルール（Data Access / Record Access）や、AD_Tab の WhereClause に @#AD_User_ID@ を用いた条件を追加する方式が使えます。

関連プロセス

このウィンドウに紐付く標準プロセスはありません（純粋な照会画面です）。

関連ドキュメント

• 操作マニュアル: 取引先別取引情報
• 操作マニュアル: 取引先マスタ
• 操作マニュアル: 受注伝票
• 操作マニュアル: 売上請求伝票
• 画面リファレンス: 担当者(エージェント)別取引情報

---

iDempiereカスタマイズのご相談

営業担当者ごとの実績把握は、集計の切り口とインセンティブ設計に直結する領域です。 標準の照会画面に加え、担当者別ダッシュボードや独自集計レポートの追加も、AD 定義と OSGi プラグインで安全に実現できます。

Ａｓ－Ｌｉｎｋ株式会社では、OSGiプラグインによる安全なカスタマイズを提供しています。

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