BAPI_MATERIAL_SAVEDATA

品目マスタ登録変更BAPI

 

概要

品目マスタを登録または変更するBAPIです。品目マスタのビューの拡張も行うことができます。

BAPIでは品目マスタ登録画面(MM01)のような入力チェックがかからないため、品目コードが番号範囲外であったり必須項目が未入力でも品目マスタを登録することができます。

パラメータ

品目マスタのデータ構成に近い形でBAPIのパラメータも定義されています。
(クライアントデータ、プラントデータ、販売データ、会計データなど)

パラメータは非常に多いですが、品目マスタ登録画面(MM01)のように品目を登録するビューをHEADDATAパラメータで選択することができます。ここで選択した品目マスタのビューのみパラメータを設定する必要があります。

また、指定したビューに対して全ての項目を設定する必要はなく、更新する項目を指定するチェックボックスパラメータあります。チェックボックスパラメータはパラメータの名称の最後が「X」になっています。

パラメータ一覧

種別	パラメータ	説明
インポート	SALESDOCUMENTIN	販売管理伝票番号
	HEADDATA	ヘッダセグメントと管理情報
	CLIENTDATA	クライアント依存の品目データ
	CLIENTDATAX	CLIENTDATAの更新情報
	PLANTDATA	プラント固有品目データ
	PLANTDATAX	PLANTDATAの更新情報
	FORECASTPARAMETERS	需要予測パラメータ
	FORECASTPARAMETERSX	FORECASTDATAの更新情報
	STORAGELOCATIONDATA	保管場所固有品目データ
	STORAGELOCATIONDATAX	STORAGELOCATIONDATAの更新情報
	VALUATIONDATA	評価データ
	VALUATIONDATAX	VALUATIONDATAの更新情報
	WAREHOUSENUMBERDATA	倉庫番号固有品目データ
	WAREHOUSENUMBERDATAX	WAREHOUSEDATAの更新情報
	SALESDATA	販売データ
	SALESDATAX	SALESDATAの更新情報
	STORAGETYPEDATA	保管域タイプ固有品目データ
	STORAGETYPEDATAX	STORAGETYPEDATAの更新情報
	FLAG_ONLINE	ALE 項目選択なし
	FLAG_CAD_CALL	CADシステムからコール
	NO_DEQUEUE	Dynpro, ユーザエントリ照会
	NO_ROLLBACK_WORK	エラー発生時のロールバック無効
エクスポート	RETURN	リターンパラメータ
テーブル	MATERIALDESCRIPTION	品目テキスト
	UNITSOFMEASURE	数量単位
	UNITSOFMEASUREX	UNITOFMEASUREの更新情報
	INTERNATIONALARTNOS	国際商品コード(EAN)
	MATERIALLONGTEXT	テキスト(長)
	TAXCLASSIFICATIONS	税分類
	RETURNMESSAGES	全メッセージ
	PRTDATA	品目マスタの生産資源/治工具(PRT)項目
	PRTDATAX	PRTDATAXの更新情報
	EXTENSIONIN	BAPIパラメータのEXTENTIONIN / EXTENSIONOUTの参照構造
	EXTENSIONINX	BAPIパラメータのEXTENTIONIN / EXTENSIONOUTの参照構造

 

ヘッダと管理情報のパラメータを設定する

ヘッダセグメントと管理情報(HEADDATA)には、品目コード、産業コード、品目タイプと品目マスタのビューを指定します。登録または拡張するビューの項目には「X」を設定します。

設定例：HEADDATA

項目	項目名称	設定値
MATERIAL	品目コード	MAT0001
IND_SECTOR	産業コード	P
MATL_TYPE	品目タイプ	HAWA
BASIC_VIEW	基本データビュー	X
SALES_VIEW	販売ビュー	X
PURCHASE_VIEW	購買管理ビュー	X
ACCOUNT_VIEW	会計ビュー	X

基本データビューのパラメータを設定する

クライアント依存の品目データ(CLIENTDATA)には品目グループ、基本数量単位などを設定します。対となるチェックボックスパラメータとしてCLIENTDATAの更新情報(CLIENTDATAX)があります。更新する項目には「X」を設定します。

設定例：CLIENTDATA

項目	項目名称	設定値
MATL_GROUP	品目グループ	0001
BASE_UOM	基本数量単位	ST
NET_WEIGHT	正味重量	1
UNIT_OF_WT	重量単位	KG
TRANS_GRP	輸送グループ	0001
ITEM_CAT	一般明細カテゴリグループ	NORM

設定例：CLIENTDATAX

項目	項目名称	設定値
MATL_GROUP	品目グループ	X
BASE_UOM	基本数量単位	X
NET_WEIGHT	正味重量	X
UNIT_OF_WT	重量単位	X
TRANS_GRP	輸送グループ	X
ITEM_CAT	一般明細カテゴリグループ	X

他のビューのパラメータを設定する

プラント固有品目データ(PLANTDATA)には、プラント、購買グループなどを設定します。対となるパラメータとしてPLANTDATAの更新情報(PLANTDATAX)があります。

販売データ(SALESDATA)には、販売組織、流通チャネル、販売単位などを設定します。対となるパラメータとしてSALESDATAの更新情報(SALESDATAX)があります。

評価データ(VALUATIONDATA)には、評価エリア、原価、評価クラスなどを設定します。対となるパラメータとしてVALUATIONDATAの更新情報(VALUATIONDATAX)があります。

設定例：PLANTDATA

項目	項目名称	設定値
PLANT	プラント	1000
PUR_GROUP	購買グループ	001
LOADINGGRP	積載グループ	0001

設定例：PLANTDATAX

項目	項目名称	設定値
PLANT	プラント	1000
PUR_GROUP	購買グループ	X
LOADINGGRP	積載グループ	X

設定例：SALESDATA

項目	項目名称	設定値
SALES_ORG	販売組織	1000
DISTR_CHAN	流通チャネル	00
SALES_UNIT	販売単位	ST
ITEM_CAT	明細カテゴリグループ	NORM

設定例：SALESDATAX

項目	項目名称	設定値
SALES_ORG	販売組織	1000
DISTR_CHAN	流通チャネル	00
SALES_UNIT	販売単位	X
ITEM_CAT	明細カテゴリグループ	X

設定例：VALUATIONDATA

項目	項目名称	設定値
VAL_AREA	評価レベル	1000
PRICE_CTRL	原価管理区分	V
VAL_CLASS	評価クラス	3100

設定例：VALUATIONDATAX

項目	項目名称	設定値
VAL_AREA	評価レベル	1000
PRICE_CTRL	原価管理区分	X
VAL_CLASS	評価クラス	X

品目テキスト、税のパラメータを設定する

品目テキスト(MATERIALDESCRIPTION)に言語別の品目テキスト設定します。
税データ(TAXCLASSIFICATIONS)には販売管理用の品目税分類を国別に設定します。

設定例：MATERIALDESCRIPTION

項目	項目名称	設定値
LANGU	言語	J
MATL_DESC	品目テキスト	品目A

設定例：TAXCLASSIFICATIONS

項目	項目名称	設定値
DEPCOUNTRY	税出荷国	JP
TAX_TYPE_1	税カテゴリ1	MWST
TAXCLASS_1	税分類1	1

サンプルコード

通常の汎用モジュールを実行するのと同様にCALL FUNCTIONで実行します。品目マスタ登録のBAPIの内部ではコミットされるため、正常終了時はロールバックすることができません。

BAPIは例外を発生させない仕様なので、エラー判定はRETURNMESSAGESパラメータにメッセージタイプが「E」のレコードが1件以上あるかどうかで判定をします。

DATA: LS_HEADDATA             TYPE BAPISMATHEAD,
      LS_CLIENTDATA           TYPE BAPI_MARA,
      LS_CLIENTDATAX          TYPE BAPI_MARAX,
      LS_PLANTDATA            TYPE BAPI_MARC,
      LS_PLANTDATAX           TYPE BAPI_MARCX,
      LS_SALESDATA            TYPE BAPI_MVKE,
      LS_SALESDATAX           TYPE BAPI_MBEW,
      LS_VALUATIONDATA        TYPE BAPI_MARA,
      LS_VALUATIONDATAX       TYPE BAPI_MBEWX,
      LS_RETURN               TYPE BAPIRET2,
      LT_MATERIALDESCRIPTION  TYPE TABLE OF BAPI_MAKT,
      LT_TAXCLASSIFICATIONS   TYPE TABLE OF BAPI_MLAN,
      LT_RETURNMESSAGES       TYPE TABLE OF BAPI_MATRETURN2.

* パラメータに値を設定する
LS_HEADDATA-MATERIAL   = 'MAT0001'. " 品目コード
LS_HEADDATA-IND_SECTOR = 'P'.       " 産業コード
LS_HEADDATA-MATL_TYPE  = 'HAWA'.    " 品目タイプ
LS_HEADDATA-BASIC_VIEW = 'X'.       " 基本データビュー
*             ：
*          (以下略)

CALL FUNCTION 'BAPI_MATERIAL_SAVEDATA'
  EXPORTING
    HEADDATA             = LS_HEADDATA
    CLIENTDATA           = LS_CLIENTDATA
    CLIENTDATAX          = LS_CLIENTDATAX
    PLANTDATA            = LS_PLANTDATA
    PLANTDATAX           = LS_PLANTDATAX
    SALESDATA            = LS_SALESDATA
    SALESDATAX           = LS_SALESDATAX
    VALUATIONDATA        = LS_VALUATIONDATA
    VALUATIONDATAX       = LS_VALUATIONDATAX
  IMPORTING
    RETURN               = LS_RETURN
  TABLES
    MATERIALDESCRIPTION  = LT_MATERIALDESCRIPTION
    TAXCLASSIFICATIONS   = LT_TAXCLASSIFICATIONS
    RETURNMESSAGES       = LT_RETURNMESSAGES
  .
* エラーメッセージの取得
READ TABLE LT_RETURNMESSAGES WITH KEY TYPE = 'E'.

* エラーメッセージがない場合
IF SY-SUBRC <> 0.
  " 正常処理.
ELSE.
  " エラー処理.
ENDIF.