購買発注伝票をBAPIで登録・変更する方法|BAPI_PO_CREATE1・BAPI_PO_CHANGE

購買発注伝票をアドオンから登録・変更するときは、登録にBAPI_PO_CREATE1、既存伝票の変更にBAPI_PO_CHANGEを使います。画面操作ではそれぞれME21N、ME22Nに対応する処理ですが、BAPIには入力項目や変更可能範囲の制約があるため、画面と完全に同じ操作ができると考えず、対象システムで検証しましょう。

この記事では、2つのBAPIの使い分け、入力構造、ABAPの呼び出し例、更新フラグとコミット処理をまとめます。購買発注が業務のどこに位置するかを先に確認したい方は、MMの基本プロセスも参照してください。

登録と変更で使うBAPI

やりたいことBAPI画面での確認先
新しい購買発注伝票を登録BAPI_PO_CREATE1ME21N/登録後はME23N
既存の購買発注伝票を変更BAPI_PO_CHANGEME22N/変更後はME23N

どちらもRETURNのメッセージを確認し、成功時にBAPI_TRANSACTION_COMMITを呼ぶのが基本です。BAPIが伝票番号や成功メッセージを返しても、コミット前には保存が確定していません。

BAPI_PO_CREATE1で購買発注を登録する

主な入力先は、ヘッダのPOHEADER/POHEADERXと、明細のPOITEM/POITEMXです。たとえばヘッダには伝票タイプ、仕入先、会社コード、購買組織、購買グループを指定します。明細には品目、プラント、数量などを指定します。X側の構造では、対応する値をBAPIへ渡す項目に'X'を立てます。

以下は主要項目を渡す骨格です。仕入先番号、品目、組織コードは例示値に置き換えてください。納入日、納入日程、価格、勘定設定など、実際に必要な項目は伝票タイプとカスタマイズによって変わるため、この断片だけで登録できることを保証するものではありません。

DATA: ls_header TYPE bapimepoheader,
      ls_headerx TYPE bapimepoheaderx,
      ls_item TYPE bapimepoitem,
      ls_itemx TYPE bapimepoitemx,
      ls_return TYPE bapiret2,
      lt_item TYPE TABLE OF bapimepoitem,
      lt_itemx TYPE TABLE OF bapimepoitemx,
      lt_return TYPE TABLE OF bapiret2,
      lv_po TYPE bapimepoheader-po_number,
      lv_has_error TYPE c LENGTH 1.

ls_header-comp_code = '1000'.
ls_header-doc_type  = 'NB'.
ls_header-vendor    = '0000100000'.
ls_header-purch_org = '1000'.
ls_header-pur_group = '001'.

ls_headerx-comp_code = 'X'.
ls_headerx-doc_type  = 'X'.
ls_headerx-vendor    = 'X'.
ls_headerx-purch_org = 'X'.
ls_headerx-pur_group = 'X'.

ls_item-po_item  = '00010'.
ls_item-material = 'MAT-001'.
ls_item-plant    = '1000'.
ls_item-quantity = '10'.
APPEND ls_item TO lt_item.

ls_itemx-po_item  = ls_item-po_item.
ls_itemx-po_itemx = 'X'.
ls_itemx-material = 'X'.
ls_itemx-plant    = 'X'.
ls_itemx-quantity = 'X'.
APPEND ls_itemx TO lt_itemx.

CALL FUNCTION 'BAPI_PO_CREATE1'
  EXPORTING
    poheader        = ls_header
    poheaderx       = ls_headerx
  IMPORTING
    exppurchaseorder = lv_po
  TABLES
    return          = lt_return
    poitem          = lt_item
    poitemx         = lt_itemx.

LOOP AT lt_return INTO ls_return
  WHERE type = 'E' OR type = 'A' OR type = 'X'.
  lv_has_error = 'X'.
  EXIT.
ENDLOOP.

IF lv_has_error IS INITIAL AND lv_po IS NOT INITIAL.
  CALL FUNCTION 'BAPI_TRANSACTION_COMMIT'
    EXPORTING wait = 'X'.
ELSE.
  CALL FUNCTION 'BAPI_TRANSACTION_ROLLBACK'.
ENDIF.

登録前に入力妥当性だけを確かめたい場合はTESTRUN = 'X'を利用できます。テスト実行では伝票を保存しません。実登録ではフラグを外し、エラーがないことと返却された伝票番号を確認してからコミットします。

BAPI_PO_CHANGEで既存伝票を変更する

変更時はPURCHASEORDERに対象の購買発注番号を渡します。変更する項目の値と、対応するX項目の両方を指定します。次は購買グループを変更する例です。

DATA: lv_existing_po TYPE bapimepoheader-po_number,
      ls_header TYPE bapimepoheader,
      ls_headerx TYPE bapimepoheaderx,
      ls_return TYPE bapiret2,
      lt_return TYPE TABLE OF bapiret2,
      lv_has_error TYPE c LENGTH 1.

lv_existing_po = '4500000000'. "変更対象の発注番号
ls_header-pur_group  = '002'.
ls_headerx-pur_group = 'X'.

CALL FUNCTION 'BAPI_PO_CHANGE'
  EXPORTING
    purchaseorder = lv_existing_po
    poheader      = ls_header
    poheaderx     = ls_headerx
  TABLES
    return        = lt_return.

LOOP AT lt_return INTO ls_return
  WHERE type = 'E' OR type = 'A' OR type = 'X'.
  lv_has_error = 'X'.
  EXIT.
ENDLOOP.

IF lv_has_error IS INITIAL.
  CALL FUNCTION 'BAPI_TRANSACTION_COMMIT'
    EXPORTING wait = 'X'.
ELSE.
  CALL FUNCTION 'BAPI_TRANSACTION_ROLLBACK'.
ENDIF.

明細を変更するときはPOITEMとPOITEMXに同じ明細番号(PO_ITEM)を指定し、POITEMX-PO_ITEMX = 'X'と変更対象項目のフラグを立てます。たとえば数量ならPOITEM-QUANTITYに新しい数量、POITEMX-QUANTITY = 'X'を渡します。ただし納入日程行や入庫済み数量などとの整合性により、希望どおりに変更できないことがあります。数量変更は対象伝票の状態も含めて確認してください。

実装前に確認したい4点

  1. 必須項目を画面とカスタマイズで確認する。発注タイプ、仕入先、プラント、勘定設定、納入日程などで必要項目が変わります。
  2. 更新フラグを値と対で設定する。POHEADERX、POITEMX、必要に応じてPOSCHEDULEXなどを設定しないと、値だけ渡しても反映されない場合があります。
  3. RETURNを記録し、エラー時は確定しない。SY-SUBRCだけで成功を判断せず、メッセージの種別・番号・本文を確認します。
  4. コミット後にME23Nで結果を確認する。成功メッセージと実際の保存結果を照合し、重複登録を避けるため再実行時の扱いも決めておきます。

SE37で単体確認する場合も、登録BAPIとBAPI_TRANSACTION_COMMITをテストシーケンスで続けて実行すると、保存まで含めて確認できます。開発・検証クライアントで試し、結果の伝票をME23Nで照会しましょう。

まとめ

新規登録はBAPI_PO_CREATE1、既存伝票の変更はBAPI_PO_CHANGEです。どちらも入力値だけでなく対応する更新フラグ、RETURNの判定、コミットまでを一連の処理として設計します。まず標準画面で必要な項目と変更可否を確かめ、同じ条件の伝票でBAPIを検証すると原因を切り分けやすくなります。

BAPI成功後も後続処理を確認

BAPIのRETURNにエラーがなく、コミットが完了しても、仕入先への発注書送信まで終わったとは限りません。ME23Nで発注内容とメッセージ・出力状況を確認し、入庫や請求書照合へ引き継ぐ項目が画面登録と同じになるか比較します。発注を変更した場合は、既存の入庫・請求履歴による変更制限にも注意します。

参考・関連記事

関連記事

PAGE TOP