iDempiere オンライン取引履歴の使い方｜債権債務・資金管理 操作マニュアル・技術仕様
This content is not available in your language yet.
📖 債権債務・資金管理の全体像: 債権債務・資金管理の全体図 も合わせてご覧ください。
オンライン取引履歴は、決済ゲートウェイ等の外部サービスと行ったオンライン処理の実行履歴を照会するウィンドウです。レコードは入出金や支払トランザクションのオンライン処理時にシステムが自動作成するため、日常運用では参照（監査・エラー調査）が中心となります。
📌 ポイント: 決済が承認されなかったときの原因調査はこのウィンドウが起点です。「エラー有無」フラグと「テキスト」（応答メッセージ）で、いつ・どのレコードの処理が・どんな応答で失敗したかを確認できます。
オンライン取引履歴でできること
Section titled “オンライン取引履歴でできること”- オンライン処理（決済等）の実行履歴の時系列照会
- エラー有無（IsError）による失敗取引の絞り込み
- ゲートウェイ応答メッセージ（テキスト）の確認
- 元レコードの特定（テーブル + レコードID の汎用参照）
- 処理済みフラグによる状態確認
単一タブ構成の照会向けウィンドウです（AD_Window_ID: 200018）。
| タブ名 | テーブル | 項目数 | 役割 |
|---|---|---|---|
| Online Transaction History | C_OnlineTrxHistory | 9項目 | オンライン処理 1 件ごとの実行履歴 |
基本操作手順
Section titled “基本操作手順”graph TD
A["💳 入出金 / 支払トランザクション等で<br/>オンライン処理を実行"] --> B["🤖 システムが履歴レコードを自動作成<br/>（C_OnlineTrxHistory）"]
B --> C["🚀 メニューから開く<br/>債権債務管理＆資金管理 > Online Transaction History"]
C --> D["🔍 作成日・エラー有無で検索"]
D --> E{エラー有無 = ON?}
E -->|Yes| F["⚠️ テキスト欄の応答メッセージを確認し<br/>テーブル+レコードIDから元伝票を特定"]
E -->|No| G["✅ 正常終了の記録として監査に利用"]
アクセス方法
Section titled “アクセス方法”メニューから「債権債務管理＆資金管理 > Online Transaction History」を開きます。
- 検索アイコンまたはグリッド表示で対象期間のレコードを絞り込みます
- エラー有無 にチェックが入っているレコードが失敗した取引です
- テキスト 欄でゲートウェイからの応答メッセージを確認します
- テーブル と レコードID から、処理元のレコード（入出金・支払トランザクション等）を特定します
💡 ヒント: このウィンドウは新規登録を前提としていません。履歴は各伝票のオンライン処理から自動で追加されます。
項目リファレンス
Section titled “項目リファレンス”全 9 項目です。全項目一覧はリファレンス参照。
| 項目名 | 必須 | 型 | 説明 |
|---|---|---|---|
| 作成日 | 必須 | 日時 | 履歴が記録された日時 |
| テーブル | 必須 | 選択 | 処理元レコードのテーブル |
| レコードID | 必須 | レコードID | 処理元レコードの内部ID |
| テキスト | - | テキスト | ゲートウェイ応答等のメッセージ（最大2000文字） |
| エラー有無 | 必須 | チェック | 実行時にエラーが発生したか（デフォルト N） |
| 処理済み | 必須 | チェック | 処理が完了したか（デフォルト N） |
| 有効 | 必須 | チェック | レコードの有効フラグ |
よくある質問（FAQ）
Section titled “よくある質問（FAQ）”Q. 履歴を手動で登録・編集する必要はありますか？
Section titled “Q. 履歴を手動で登録・編集する必要はありますか？”ありません。履歴レコードはソース上、入出金（MPayment）・支払トランザクション（MPaymentTransaction）・出荷取引（MShippingTransaction）・住所検証（MAddressTransaction）の各オンライン処理から自動作成されます。手動登録は監査記録としての価値を損なうため推奨されません。
Q. どの伝票に対する履歴か特定するには？
Section titled “Q. どの伝票に対する履歴か特定するには？”「テーブル」と「レコードID」の 2 項目が処理元レコードへの汎用参照です。例えばテーブルが C_PaymentTransaction であれば、そのレコードID を支払トランザクションウィンドウで開いて詳細を確認します。
Q. エラー有無が ON のレコードはどう対処しますか？
Section titled “Q. エラー有無が ON のレコードはどう対処しますか？”「テキスト」欄の応答メッセージが一次情報です。カード情報不備・プロセッサ設定不備などの原因を特定し、元伝票側（入出金・支払トランザクション）で修正のうえ再処理してください。履歴レコード自体を修正する必要はありません。
🛠 技術仕様（開発者向け）
オンライン取引履歴は C_OnlineTrxHistory テーブル（アクセスレベル: クライアント+組織）に格納されます。MOnlineTrxHistory クラス（60行）はコンストラクタのみの薄いモデルクラスで、ビジネスロジックは持ちません。履歴の書き込みは呼び出し元（MPaymentTransaction.processOnline() 等）が行います。
アーキテクチャ概要
Section titled “アーキテクチャ概要”classDiagram
class MOnlineTrxHistory {
+MOnlineTrxHistory(ctx, id, trxName)
+MOnlineTrxHistory(ctx, uu, trxName)
+MOnlineTrxHistory(ctx, rs, trxName)
}
class X_C_OnlineTrxHistory {
<<generated>>
}
class PO {
<<abstract>>
}
MOnlineTrxHistory --|> X_C_OnlineTrxHistory
X_C_OnlineTrxHistory --|> PO
MPayment ..> MOnlineTrxHistory : creates
MPaymentTransaction ..> MOnlineTrxHistory : creates
MShippingTransaction ..> MOnlineTrxHistory : creates
MAddressTransaction ..> MOnlineTrxHistory : creates
パッケージ: org.compiere.model
ソースファイル: org.adempiere.base/src/org/compiere/model/MOnlineTrxHistory.java
関連DBテーブル
Section titled “関連DBテーブル”C_OnlineTrxHistory（オンライン取引履歴）
Section titled “C_OnlineTrxHistory（オンライン取引履歴）”| カラム名 | 型 | 必須 | 説明 | 備考 |
|---|---|---|---|---|
| C_OnlineTrxHistory_ID | ID | PK | 履歴ID | 主キー |
| AD_Client_ID / AD_Org_ID | TableDirect | Y | クライアント / 組織 | |
| AD_Table_ID | TableDirect | Y | 処理元テーブル | 汎用参照 |
| Record_ID | RecordID | Y | 処理元レコードID | 汎用参照 |
| TextMsg | Text | N | 応答メッセージ | 最大2000文字 |
| IsError | YesNo | Y | エラー有無 | デフォルト N |
| Processed | YesNo | Y | 処理済み | デフォルト N |
| IsActive | YesNo | Y | 有効 | デフォルト Y |
ビジネスロジック
Section titled “ビジネスロジック”モデルクラス側に beforeSave/afterSave 等の独自ロジックはありません。履歴レコードの生成は呼び出し元のオンライン処理内で行われます（例: MPaymentTransaction.processOnline() が処理結果を TextMsg / IsError にセットして保存）。
拡張ポイント
Section titled “拡張ポイント”- Model Validator: 履歴作成をトリガに通知を送る等の後続処理は
C_OnlineTrxHistoryへのTYPE_AFTER_NEWフックで実装できます。 - Callout: 標準の callout 定義はありません。
関連ドキュメント
Section titled “関連ドキュメント”iDempiereカスタマイズのご相談
Section titled “iDempiereカスタマイズのご相談”オンライン取引履歴を活用した決済エラーの自動通知・監視など、運用に合わせた拡張が可能です。
Ａｓ－Ｌｉｎｋ株式会社では、OSGiプラグインによる安全なカスタマイズを提供しています。