【決定版】BAPI_MATERIAL_SAVEDATAをどこよりも詳しく解説！

SD、MM、PPなど、ロジスティクス系のSAPモジュールを導入している企業にとって、品目マスタのメンテナンスは、重要で欠かせない業務の一つである。左記のモジュールはいずれも、品目マスタが登録されていなければ運用できない。ロジスティクス系マスタの中で、品目マスタは特に重要なマスタといえる。

品目マスタのメンテナンスといえば、トランザクションコード MM01（登録）と MM02（変更）であるが、汎用モジュール／BAPIなら BAPI_MATERIAL_SAVEDATA だ。このBAPIは、MM01とMM02の両方の機能を併せ持つBAPIで、品目マスタが未登録なら新規登録を、登録済みなら変更を、自動判別して行う。

本記事は、品目マスタの一括登録や変更を行うプログラムを開発する上で、強力なツールとなりえるBAPI_MATERIAL_SAVEDATA の特徴、メリットとデメリット、そしてパラメータの設定方法や注意すべき点まで、どこよりも詳しく丁寧に解説する。

BAPI_MATERIAL_SAVEDATAとは

BAPI_MATERIAL_SAVEDATAの特徴

BAPI_MATERIAL_SAVEDATAは、SAPシステムの品目マスタの、新規登録、または変更を行うBAPIである。T-CODE「MM01」と「MM02」の両方の機能を持ち合わせており、品目マスタの新規登録と変更を自動で判別する。つまり、品目マスタが未登録であれば新規登録を、登録済みであればマスタの変更を、自動判別して品目マスタの更新が行える。

BAPI_MATERIAL_SAVEDATAの役割

BAPI_MATERIAL_SAVEDATAは、次のようなシチュエーションで役立つ。

プロジェクト初期段階のデータ移行

SAPシステムを新しく導入する際の、品目マスタの一括登録が必要な場合。データ更新のパフォーマンスに優れるBAPI_MATERIAL_SAVEDATAは、大量の品目マスタを一括で登録する際、威力を発揮する。

定期的な品目マスタのメンテナンス

品目の属性が頻繁に更新される企業では、手動での作業を自動化することで大幅な工数削減が可能となる。

システム間のデータ連携

外部システムと連携し、品目マスタを外部から受信してSAPシステムに登録するインターフェースプログラムが必要な場合、BAPI_MATERIAL_SAVEDATAを使用してプログラムを開発できる。

---

BAPIそのものを解説した記事は以下。そもそもBAPI のことがよく解らないという人は、下の記事をまず読んでいただきたい。

BAPI_MATERIAL_SAVEDATAのメリットとデメリット

メリット

MM01とMM02の機能統合

BAPI_MATERIAL_SAVEDATAは、品目マスタの登録状態を自動判別し、新規登録（MM01）と変更（MM02）を同時に行うことができる。これにより、MM01とMM02のT-CODEを個別に選ぶ必要がなくなるため、作業フローがシンプルになり、業務効率が向上する。

一括更新による操作の簡便さ

T-CODE: MM01とMM02は、品目マスタのビューを一つ一つ選択し、ビューの中にあるデータ項目に値を入力していく。BAPI_MATERIAL_SAVEDATAは、複数のビューを一括して登録・更新できる。これにより、登録時の操作の手間を減らすことができる。

バッチインプットよりも速い

SAPシステム上のデータを更新する処理速度は、MM01やMM02でバッチインプットするよりも高速である。大量の品目マスタをメンテナンスする場合、バッチインプットよりもパフォーマンスに優れるので、短時間で処理が完了する。

デメリット（注意点）

MM01とMM02の両方の機能を備え、データ更新のパフォーマンスにも優れるBAPI_MATERIAL_SAVEDATAは、メリットしかないように見える。しかし、デメリットや、使用上の注意は存在する。

複雑なデータ構造

BAPI_MATERIAL_SAVEDATAは、品目マスタの多くのビューやフィールドに対応しているが、そのパラメータの構造はMM01やMM02とは異なる。標準トランザクションように、入力項目がビュー毎にグループ化されておらず、項目の並び順も画面とは違う。このため、パラメータの構造を理解しにくく、設定のミスを起こしやすい。

エラー処理の難しさ

BAPI_MATERIAL_SAVEDATAは実行時エラーが発生すると、詳細なエラーメッセージを返すが、標準トランザクションでは見かけないデータ名称やメッセージを返すため、エラーの内容を理解するのが難しい。このため、エラーの原因を特定するのに時間がかかる場合がある。

意図しない新規登録のリスク

BAPI_MATERIAL_SAVEDATAは、MM01とMM02の両方の機能を備えているが、これが仇となる場合がある。登録済みの品目マスタを変更したい場合、品目コードをうっかり間違えると、誤って新規に品目マスタが登録されてしまう。この結果、意図しない不要な品目マスタが増えるリスクがある。
これを防ぐには、パフォーマンスはBAPI_MATERIAL_SAVEDATAよりも劣るが、MM01およびMM02をバッチインプットで実行した方が確実である。

---

バッチインプットとBAPIの違いについて解説した記事は以下。また、データの種類やシチュエーション別に、どちらの手段を利用するのが適切なのかも紹介している。

BAPI_MATERIAL_SAVEDATAの全パラメータ

以下は、S/4HANA 2023 における、BAPI_MATERIAL_SAVEDATA の全パラメータの一覧である。

ただし、BAPI_MATERIAL_SAVEDATAのパラメータ数は、全部で1500を超えて多すぎるため、「更新情報」パラメータは省略した。「更新情報」パラメータとは、当該パラメータの更新を指示する「更新のためのフラグ」を設定するためのパラメータであり、パラメータ名と同じ名前の、末尾に’X’の付いたパラメータである。

• 行数が多いので、アコーディオンブロックになっている。上下に展開したり折り畳む時は、「▲▼」をクリック。

BAPI_MATERIAL_SAVEDATAのパラメータ設定

MM01と同じ要領で

「第1画面」の必須項目を設定

品目マスタを新規に登録するときは、MM01の「第一画面」と同じ必須項目、すなわち、パラメータ「HEADDATA」の 品目コード／産業コード／品目タイプに値を設定する。

パラメータ Parameter	設定する値	入力必須
		新規登録	変更
Import
HEADDATA
MATERIAL 品目コード (18 桁)	キー項目。18桁の品目コードを指定する。	◯	◯
IND_SECTOR 産業コード		◯
MATL_TYPE 品目タイプ		◯
BASIC_VIEW 基本データビュー	‘X’
SALES_VIEW 販売ビュー	‘X’
PURCHASE_VIEW 購買管理ビュー	‘X’
MRP_VIEW 資材所要量計画 (MRP) ビュー	‘X’
FORECAST_VIEW 需要予測ビュー	‘X’
WORK_SCHED_VIEW 作業計画ビュー	‘X’
PRT_VIEW 生産資源/治工具 (PRT) ビュー	‘X’
STORAGE_VIEW 保管ビュー	‘X’
WAREHOUSE_VIEW 倉庫管理ビュー	‘X’
QUALITY_VIEW 品質管理ビュー	‘X’
ACCOUNT_VIEW 会計ビュー	‘X’
COST_VIEW 原価計算ビュー	‘X’
MATERIAL_EXTERNAL 項目 MATERIAL の品目コード (長)
MATERIAL_LONG 品目コード	品目コードが40桁の環境の場合、こちらを使用する。

HEADDATAにはビューを指定するパラメータがあるが、設定は必須ではない。ビューは設定した値に基づいて自動的に追加される。ビューを明示的に追加したい場合に、ビューのパラメータに値’X’を設定する。

ビューの対比と使用するパラメータ

標準トランザクション（MM01やMM02）のビューと、BAPI_MATERIAL_SAVEDATAのビューは、内容に少し差がある。それぞれのビューの対応をまとめたのが次表だ。

標準トランザクションのビュー	BAPI_MATERIAL_SAVEDATAのビュー（パラメータ）	項目値の設定に使うパラメータ（一部）
基本データ1 基本データ2	BASIC_VIEW 基本データビュー	CLIENTDATA CLIENTDATAX MATERIALDESCRIPTION
販売組織データ1 販売組織データ2 販売一般/プラントデータ	SALES_VIEW 販売ビュー	PLANTDATA PLANTDATAX SALESDATA SALESDATAX TAXCLASSIFICATIONS
国際取引: 輸出	SALES_VIEW 販売ビュー	PLANTDATA PLANTDATAX
販売テキスト	SALES_VIEW 販売ビュー	MATERIALLONGTEXT
購買管理	PURCHASE_VIEW 購買管理ビュー	PLANTDATA PLANTDATAX
国際取引: 輸入	PURCHASE_VIEW 購買管理ビュー	PLANTDATA PLANTDATAX
購買発注テキスト	PURCHASE_VIEW 購買管理ビュー	MATERIALLONGTEXT
MRP1 MRP2 MRP3 MRP4	MRP_VIEW 資材所要量計画 (MRP) ビュー	PLANTDATA PLANTDATAX
拡張計画	MRP_VIEW 資材所要量計画 (MRP) ビュー	PLANTDATA PLANTDATAX
需要予測	FORECAST_VIEW 需要予測ビュー	FORECASTPARAMETERS FORECASTPARAMETERSX
作業計画	WORK_SCHED_VIEW 作業計画ビュー	PLANTDATA PLANTDATAX
生産資源/治工具	PRT_VIEW 生産資源/治工具 (PRT) ビュー	PRTDATA PRTDATAX
一般プラントデータ/保管1 一般プラントデータ/保管2	STORAGE_VIEW 保管ビュー	STORAGELOCATIONDATA STORAGELOCATIONDATAX
倉庫管理1 倉庫管理2	WAREHOUSE_VIEW 倉庫管理ビュー	WAREHOUSENUMBERDATA WAREHOUSENUMBERDATAX
品質管理	QUALITY_VIEW 品質管理ビュー	CLIENTDATA CLIENTDATAX
会計1 会計2	ACCOUNT_VIEW 会計ビュー	VALUATIONDATA VALUATIONDATAX
原価計算1 原価計算2	COST_VIEW 原価計算ビュー	VALUATIONDATA VALUATIONDATAX

品目マスタの各項目に値を設定する

品目マスタ登録の「第1画面」に値を設定したら、次は品目マスタの各入力項目に値を設定していく。

品目テキスト

品目マスタの「基本データ1」ビューの、最初の入力項目である「品目テキスト」に、品目の名称を設定する。

BAPI_MATERIAL_SAVEDATAにおいては、品目テキストの入力は、パラメータ「MATERIALDESCRIPTION」を使用する。このパラメータはテーブル型なので、複数の言語の品目テキストを一度に設定することが可能である。

Parameter パラメータ		Description パラメータの説明	設定する値	データの長さ
MATERIALDESCRIPTION	BAPI_MAKT	品目テキスト	–
	LANGU_ISO	2 桁の SAP 言語コード	日本語であれば’JA’、英語であれば’EN’を指定する。	2
	MATL_DESC	品目テキスト	品目の名称テキスト	40

値を設定する時の注意：更新用のフラグを設定する

次に、品目マスタの各項目に値を設定していく。この時、注意しなければならないのは、ほとんどの入力項目に「更新のためのフラグ」があるという点だ。「フラグ」を設定しなければ、入力項目に値を設定しても無視される。フラグは各項目と１：１の関係で存在する（フラグを持たない入力項目も存在する）。

「更新のためのフラグ」のパラメータは、入力項目のパラメータと同じ名前で、末尾に’X‘が付いている。たとえば、「品目グループ」の値を更新したい場合、品目グループはパラメータ「CLIENTDATA（クライアント依存の品目データ）」の中のフィールド「MATL_GROUP」なので、概念的に表すと、以下のように設定する。

CLIENTDATA-MATL_GROUP = 品目グループの値
CLIENTDATAX-MATL_GROUP = ‘X’

このように、CLIENTDATAには品目グループの値を設定し、CLIENTDATAXには’X’を設定する。’X’をセットし忘れた場合、品目グループの値は更新されない。この「更新のためのフラグ」は、品目マスタの新規登録／更新登録のどちらの場合も設定しなければならない。

数量単位を設定するときの注意

JavaやVBAなど、ABAP以外からBAPIを実行する時、「基本数量単位」など数量単位には、内部数量単位を指定しなくてはならない。

たとえば、MM01で「基本数量単位」に「個」を指定する場合、設定する値は通商単位の「PC」である。しかし、外部からBAPI_MATERIAL_SAVEDATAを呼び出す場合、内部数量単位の「ST」を設定しなければならない（「個」の内部数量単位は「ST」）。

この外部からBAPIを実行する際に、内部数量単位を設定するルールは、他には BAPI_GOODSMVT_CREATE など、数量単位を扱うほとんどのBAPIに当てはまるので、覚えておいた方がいいだろう。

サンプルコード

以下は、品目マスタを新規に登録する、ABAPのサンプルコードである。この例では、基本データビューのみ、値を設定している。

REPORT z_create_material_master.

DATA: lv_material       TYPE bapimatnm,        "品目コード
      lv_material_type  TYPE bapimmara-mtart,  "品目タイプ
      lv_industry_sector TYPE bapimmara-mbrsh, "産業コード
      lv_base_uom       TYPE bapimeins,        "数量単位
      lv_material_group TYPE bapimatgr,        "品目グループ
      lt_description    TYPE TABLE OF bapi_maktx, "品目テキスト（テーブル）
      wa_description    TYPE bapi_maktx,       "品目テキストワークエリア
      lv_return         TYPE TABLE OF bapiret2, "BAPI返却メッセージ
      wa_return         TYPE bapiret2,
      lv_head           TYPE bapimathead,      "品目ヘッダデータ
      lv_clientdata     TYPE bapimaterial,     "品目基本データ
      lv_clientdatax    TYPE bapimaterialx.    "品目データの更新フラグ

* 品目に設定する値を指定
lv_material       = 'SAMPLE-1'.         "品目コード
lv_material_type  = 'HALB'.             "品目タイプ
lv_industry_sector = 'M'.               "産業コード
lv_base_uom       = 'ST'.               "数量単位
lv_material_group = 'GRP001'.           "品目グループ

* 品目テキストを設定（英語と日本語）
CLEAR wa_description.
wa_description-langu = 'EN'.            "言語：英語
wa_description-maktx = 'SAMPLE PARTS-1'. "品目テキスト（英語）
APPEND wa_description TO lt_description.

CLEAR wa_description.
wa_description-langu = 'JA'.            "言語：日本語
wa_description-maktx = 'サンプル部品-1'. "品目テキスト（日本語）
APPEND wa_description TO lt_description.

* BAPI構造にデータを設定
lv_head-material     = lv_material.
lv_head-ind_sector   = lv_industry_sector.  "産業コード
lv_head-matl_type    = lv_material_type.    "品目タイプ

lv_clientdata-base_uom  = lv_base_uom.      "基本数量単位
lv_clientdata-matkl     = lv_material_group. "品目グループ

* 更新フラグの設定
lv_clientdatax-base_uom = 'X'.         "基本数量単位を更新
lv_clientdatax-matkl    = 'X'.         "品目グループを更新

* BAPIを呼び出して新規品目を登録
CALL FUNCTION 'BAPI_MATERIAL_SAVEDATA'
  EXPORTING
    headdata          = lv_head
    clientdata        = lv_clientdata
    clientdatax       = lv_clientdatax
  TABLES
    materialdescription = lt_description    "品目テキストをテーブル型で設定
    return             = lv_return.

* 結果を確認
LOOP AT lv_return INTO wa_return.
  WRITE: / wa_return-message.
ENDLOOP.

* コミットまたはロールバック
IF lv_return IS INITIAL.
  CALL FUNCTION 'BAPI_TRANSACTION_COMMIT'
    EXPORTING
      wait = 'X'.
ELSE.
  CALL FUNCTION 'BAPI_TRANSACTION_ROLLBACK'.
ENDIF.

テーブル型の入力項目への値の設定

品目マスタの、ほとんどの入力項目は、Import型の パラメータ CLIENTDATA、PLANTDATA を使って設定することができる。

一方、ビューの中に含まれる「テーブル状のUI」の場合、複数行のレコードを登録する必要性から、Table型のパラメータでインターフェースが提供されている。たとえば、標準トランザクションの「販売組織1」ビューにある「税データ」は、Table型パラメータの「TAXCLASSIFICATIONS」を使い、複数の「税分類」を一度に追加できる。

以下は、「販売組織1」ビューの「税データ」に、税区分を追加するABAPのサンプルコードである。
なお、TAXCLASSIFICATIONSには、「更新のためのフラグ」は存在しないので設定は不要である。

REPORT z_update_material_tax.

DATA: lv_material           TYPE bapimatnm,      "品目コード
      lv_sales_org          TYPE bapivbeln,      "販売組織
      lv_dist_channel       TYPE bapimtvk,       "流通チャネル
      lv_depart_country     TYPE bapitvkla-land1, "出荷国
      lt_tax_classifications TYPE TABLE OF bapimatlgtx,  "税区分
      wa_tax_classification  TYPE bapimatlgtx,
      lv_return             TYPE TABLE OF bapiret2,  "BAPIの戻り値
      wa_return             TYPE bapiret2.

* 更新する品目番号、販売組織、流通チャネル、出荷国を設定
lv_material       = 'MATERIAL_NUMBER'.
lv_sales_org      = 'SALES_ORG'.          "販売組織
lv_dist_channel   = 'DIST_CHANNEL'.       "流通チャネル
lv_depart_country = 'DEPARTURE_COUNTRY'.  "出荷国（例：'JA'日本）

* 税区分（税カテゴリと税分類）を設定
* 1つ目の税区分
wa_tax_classification-tax_type = 'TAX_CATEGORY_1'.  "税カテゴリ1
wa_tax_classification-tax_classification = 'TAX_CLASSIFICATION_1'.  "税分類1
wa_tax_classification-sales_org = lv_sales_org.
wa_tax_classification-distr_chan = lv_dist_channel.
wa_tax_classification-depart_country = lv_depart_country.  "出荷国を設定
APPEND wa_tax_classification TO lt_tax_classifications.

* 2つ目の税区分
wa_tax_classification-tax_type = 'TAX_CATEGORY_2'.  "税カテゴリ2
wa_tax_classification-tax_classification = 'TAX_CLASSIFICATION_2'.  "税分類2
wa_tax_classification-sales_org = lv_sales_org.
wa_tax_classification-distr_chan = lv_dist_channel.
wa_tax_classification-depart_country = lv_depart_country.  "出荷国を設定
APPEND wa_tax_classification TO lt_tax_classifications.

* BAPIを呼び出して税区分を更新
CALL FUNCTION 'BAPI_MATERIAL_SAVEDATA'
  EXPORTING
    headdata         = VALUE bapimathead( material = lv_material )
    salesdata        = VALUE bapimatvs( )
  TABLES
    taxclassifications = lt_tax_classifications
    return             = lv_return.

* 結果を確認
LOOP AT lv_return INTO wa_return.
  WRITE: / wa_return-message.
ENDLOOP.

* コミット
IF lv_return IS INITIAL.
  CALL FUNCTION 'BAPI_TRANSACTION_COMMIT'
    EXPORTING
      wait = 'X'.
ELSE.
  CALL FUNCTION 'BAPI_TRANSACTION_ROLLBACK'.
ENDIF.

実行後の確認とトランザクション制御

実行結果の確認

RETURNパラメータは２つある

BAPI_MATERIAL_SAVEATAの実行後は、他のBAPIと同様に「RETURN」パラメータをチェックする。

BAPI_MATERIAL_SAVEATAにおいては、RETURN相当のパラメータは、RETURNMESSAGES（テーブル型）とRETURN（Export型）の２つがある。RETURNMESSAGESには細かい情報が格納され、RETURNはサマリが格納される。

どちらのパラメータもデータ構造は同じで、結果のステータスは「TYPE」にセットされる。セットされるステータスは以下がある。

ステータス	意味
S	成功
W	警告あり
E	エラー
I	通知
A	強制終了

TYPEにステータスがセットされると同時に、メッセージ番号が「ID」と「NUMBER」に、メッセージ本文は「MESSAGE」にセットされる。

RETURN と RETURNMESSAGES の違い

RETURN（Export）

実行結果のサマリが格納される。「〇〇が保存されました」のような、MM01やMM02で品目マスタを保存した時と同じ内容のメッセージがセットされる。したがって、品目マスタが登録されたかどうかは、このパラメータの「TYPE」の値で判断できる。品目マスタが登録できた時、TYPEの値は’S’（成功）、または’W’（警告）である。‘E’（エラー）の時、品目マスタは登録されていない。

RETURNMESSAGES（Table）

こちらは詳細なメッセージが格納される。テーブル型なので、TYPEやMESSAGEの値は複数行にセットされている。エラーが発生した時、どのパラメータの設定値に問題があったのかを知るには、このテーブルの内容を解析すればよい。

トランザクション制御

BAPI_MATERIAL_SAVEDATAはトランザクション制御が必要なBAPIである。つまり、BAPI実行後は、以下のいずれかのトランザクション制御を実行しなければならない。

正常終了時

BAPI_TRANSACTION_COMMIT を呼び出してトランザクションを確定（コミット）する。
これを忘れると、正常終了していてもデータベースに書き込みが行われず、品目マスタの更新は行われない。

エラー発生時、またはトランザクションをキャンセル（ロールバック）したい時

BAPI_TRANSACTION_ROLLBACK を呼び出して処理を取り消すことができる。

まとめ：BAPI_MATERIAL_SAVEDATAは特徴を理解して使う

BAPI_MATERIAL_SAVEDATAは、MM01とMM02の機能を統合し、品目マスタの登録と変更を自動判別して行うことができる強力なBAPIだ。データを更新する速度も、MM01／MM02をバッチインプットするよりも高速なので、データ移行など、大量の品目マスタを一括で更新する場合に威力を発揮する。

一方、MM01とMM02の機能を併せ持つということは、既に登録されている品目マスタを更新しようとして、うっかり誤った品目コードを指定してしまうと、意図しない品目マスタが新規に登録されてしまい、不要な品目マスタを増やしてしまうリスクもある。

このようなメリットとデメリットを理解した上で、BAPI_MATERIAL_SAVEDATAを適切に使用すれば、品目マスタのメンテナンスを効率良く行うことができるだろう。本記事を参考に、BAPI_MATERIAL_SAVEDATAを使いこなし、品目マスタのメンテナンスをスムーズに進めてほしい。

---

T-CODE: MM01/MM02に相当するBAPIは BAPI_MATERIAL_SAVEDATA というように、トランザクションコードおよびバッチインプットの代わりになるBAPIの一覧リストをまとめた記事は以下。