iDempiere 運賃カテゴリの使い方｜在庫管理 操作マニュアル・技術仕様

📖 在庫管理の全体像: 在庫管理の業務フロー全体図 も合わせてご覧ください。

運賃カテゴリは、選択した配送業者（Shipper）の運賃を計算するために使用する分類マスタです。「小口便」「パレット便」「冷蔵便」のように運賃体系の異なる区分をカテゴリとして定義し、配送業者ごとの運賃計算の基準にします。

📌 ポイント: 運賃カテゴリ自体はシンプルな分類マスタです。検索キー・名称を登録するだけで使用でき、配送業者の運賃計算時にカテゴリ単位で運賃を切り替えられます。

運賃カテゴリでできること

• 運賃体系の区分（カテゴリ）の定義
• 配送業者（Shipper）ごとの運賃計算の基準設定
• 検索キーによる一意なコード管理
• 有効フラグによる利用停止（削除せずに非表示化）

画面構成

運賃カテゴリは 1 タブのみのシンプルな構成です。

タブ名	テーブル	項目数	役割
運賃カテゴリ	M_FreightCategory	7項目	カテゴリの基本情報（検索キー・名称・説明等）

基本操作手順

graph TD
    A["🚀 メニューから開く<br/>在庫管理 > 品目マスタ管理 > 運賃カテゴリ"] --> B["➕ 新規ボタンをクリック"]
    B --> C["✏️ 検索キー・名称を入力<br/>（必要に応じて説明・コメント）"]
    C --> D["💾 保存"]
    D --> E["🚚 配送業者の運賃計算で<br/>カテゴリとして参照"]

メニューから開く 在庫管理 > 品目マスタ管理 > 運賃カテゴリ 新規ボタンをクリック 検索キー・名称を入力 （必要に応じて説明・コメント） 保存 配送業者の運賃計算で カテゴリとして参照

アクセス方法

メニューから「在庫管理 > 品目マスタ管理 > 運賃カテゴリ」を開きます。

新規登録

1. ツールバーの「新規」ボタンをクリック
2. 基本情報を入力:
   • 検索キー: カテゴリの一意コード（例: PARCEL）※最大40文字
   • 名称: カテゴリ名（例: 小口便）※最大60文字
   • 説明: 補足説明（任意）
   • コメント: 運用上のヒント（任意）
3. 「保存」をクリック

項目リファレンス

項目名	必須	型	説明
クライアント	必須	選択	このレコードが属するクライアント
組織	必須	選択	このレコードが属する組織
検索キー	必須	文字列(40)	カテゴリの一意コード
名称	必須	文字列(60)	カテゴリの名称
説明	-	文字列(255)	補足説明
コメント	-	テキスト	コメント・ヒント
有効	必須	チェック	レコードの有効/無効

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

よくある質問（FAQ）

Q. 運賃カテゴリはどこで使われますか？

配送業者（Shipper）を選択した際の運賃計算に使用されます。運賃体系の異なる区分をカテゴリとして分けておくことで、配送業者ごと・カテゴリごとに運賃を管理できます。

Q. 使わなくなった運賃カテゴリは削除できますか？

レコードの削除は可能ですが、他のレコードから参照されている場合は削除できません。運用上は「有効」チェックを外して無効化する方法を推奨します。無効化すれば新規の選択肢には表示されなくなり、既存データはそのまま保持されます。

Q. 検索キーと名称の違いは何ですか？

検索キー（Value）はシステム内で一意である必要があるコード（最大40文字）で、名称（Name）は画面表示用の名前（最大60文字）です。コード体系を決めて検索キーを付与し、名称には業務でわかりやすい日本語名を設定してください。

関連機能

• 品目マスタ（Product）の使い方
• 出荷（Shipment）の使い方
• 画面リファレンス: 運賃カテゴリ

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

概要

運賃カテゴリはマスタデータ型のウィンドウ（AD_Window_ID: 282）で、M_FreightCategory テーブルに格納されます。モデルクラスは MFreightCategory（94行）で、検索キーによるルックアップ用の静的メソッドを提供する軽量なクラスです。Document 型ではありません。

アーキテクチャ概要

classDiagram
    class MFreightCategory {
        +MFreightCategory(ctx, M_FreightCategory_ID, trxName)
        +MFreightCategory(ctx, rs, trxName)
        +getByValue(ctx, value, trxName)$ MFreightCategory
    }
    class X_M_FreightCategory {
        <<generated>>
    }
    class PO {
        <<abstract>>
    }
    MFreightCategory --|> X_M_FreightCategory
    X_M_FreightCategory --|> PO

+MFreightCategory(ctx, M_FreightCategory_ID, trxName) +MFreightCategory(ctx, rs, trxName) +getByValue(ctx, value, trxName)$ MFreightCategory <> <> > X_M_FreightCategory X_M_FreightCategory --

パッケージ: org.compiere.model ソースファイル: org.adempiere.base/src/org/compiere/model/MFreightCategory.java

関連DBテーブル

M_FreightCategory（運賃カテゴリ）

カラム名	型	必須	説明	備考
M_FreightCategory_ID	ID	PK	運賃カテゴリID	主キー
AD_Client_ID	TableDirect	Y	クライアント	デフォルト @#AD_Client_ID@
AD_Org_ID	TableDirect	Y	組織	デフォルト @#AD_Org_ID@
Value	String(40)	Y	検索キー	一意
Name	String(60)	Y	名称	識別子（Identifier）
Description	String(255)	N	説明
Help	Text(2000)	N	コメント
IsActive	YesNo	Y	有効フラグ	デフォルト Y
M_FreightCategory_UU	UUID	N	UUID

ビジネスロジック

MFreightCategory に beforeSave/afterSave のオーバーライドはなく、標準の PO 永続化ロジックのみで動作します。ユーティリティとして次のメソッドを提供します。

• getByValue(Properties ctx, String value, String trxName): 検索キー（Value）を指定してカテゴリを取得する静的メソッド。プラグインから運賃カテゴリをコードで参照する場合に使用します。

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

このテーブルに標準の Callout は定義されていません。独自の制約（コード体系の強制等）を追加する場合は OSGi の Model Validator を使用します。

public class CustomFreightCategoryValidator implements ModelValidator {
    @Override
    public int modelChange(PO po, int type) throws Exception {
        if (po instanceof MFreightCategory
            && (type == TYPE_BEFORE_NEW || type == TYPE_BEFORE_CHANGE)) {
            // 例: 検索キーの命名規則チェック
        }
        return null;
    }
}

関連プロセス

このウィンドウに直接関連する標準プロセスはありません。

関連ドキュメント

• 画面リファレンス: 運賃カテゴリ
• 品目マスタの技術仕様

---

iDempiereカスタマイズのご相談

運賃カテゴリを起点とした独自の運賃計算ロジック（重量・距離・カテゴリ別の運賃テーブル等）も、コア改変なしで拡張できます。

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

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