受注伝票をBAPIで登録・変更する方法|ABAPの使い分けと注意点

ABAPから受注伝票を登録・変更する場合は、処理の目的に合うBAPIを選びます。登録と変更では入力構造や更新フラグが異なり、呼び出しただけではデータベースへの確定も終わりません。この記事では、代表的なBAPIの使い分けと実装時の確認点を整理します。

受注伝票で使う主なBAPI

目的主なインターフェース確認する結果
登録BAPI_SALESORDER_CREATEFROMDAT2受注番号とRETURN
変更BAPI_SALESORDER_CHANGERETURNと更新結果
一覧取得BAPI_SALESORDER_GETLIST抽出条件と対象受注
ステータス取得BAPI_SALESORDER_GETSTATUS受注の状態

対象のSAP製品・リリースによって利用できるインターフェースは異なります。実装前にSE37のパラメータとドキュメントを確認してください。

登録:BAPI_SALESORDER_CREATEFROMDAT2

受注タイプや販売エリアなどのヘッダー、明細、得意先などの取引先、必要に応じた納入日程行を渡します。IN 構造には値、対応する INX 構造には設定する項目のフラグを指定します。以下は、各構造に値を設定した後の呼び出し部分です。

CALL FUNCTION 'BAPI_SALESORDER_CREATEFROMDAT2'
  EXPORTING
    order_header_in    = ls_header
    order_header_inx   = ls_headerx
  IMPORTING
    salesdocument      = lv_salesdocument
  TABLES
    return             = lt_return
    order_items_in     = lt_items
    order_items_inx    = lt_itemsx
    order_partners     = lt_partners
    order_schedules_in = lt_schedules
    order_schedules_inx = lt_schedulesx.

ここで示した変数には、業務要件に応じた値を事前に設定します。必要な販売エリア、取引先機能、品目、数量、納期などは受注タイプやカスタマイズに依存します。受注番号が返っても、RETURN のエラー確認とコミットを省略しないでください。

変更:BAPI_SALESORDER_CHANGE

変更対象の受注番号を指定し、変更する項目の値と対応する INX フラグを渡します。たとえばヘッダーの得意先発注番号を変更する場合、次のように指定します。

DATA: ls_header  TYPE bapisdh1,
      ls_headerx TYPE bapisdh1x,
      lt_return  TYPE STANDARD TABLE OF bapiret2 WITH DEFAULT KEY.

ls_header-purch_no_c  = lv_customer_po.
ls_headerx-purch_no_c = 'X'.
ls_headerx-updateflag = 'U'.

CALL FUNCTION 'BAPI_SALESORDER_CHANGE'
  EXPORTING
    salesdocument    = lv_salesdocument
    order_header_in  = ls_header
    order_header_inx = ls_headerx
  TABLES
    return           = lt_return.

lv_salesdocument と lv_customer_po は事前に設定した値です。明細を変更する場合は、明細番号と変更項目を ORDER_ITEM_IN・ORDER_ITEM_INX に設定し、更新区分も指定します。INX の指定漏れは、値を渡しても更新されない原因になります。

RETURNを確認し、コミットまたはロールバックする

登録・変更後は RETURN の各行を確認し、エラー・中断メッセージがあれば原因を処理してロールバックします。成功時には同じ処理単位で BAPI_TRANSACTION_COMMIT を呼びます。警告も読み飛ばさず、受注が意図どおりに作成・変更されたか確認してください。

DATA: ls_return TYPE bapiret2,
      lv_has_error TYPE abap_bool VALUE abap_false.

LOOP AT lt_return INTO ls_return.
  IF ls_return-type = 'E' OR
     ls_return-type = 'A' OR
     ls_return-type = 'X'.
    lv_has_error = abap_true.
  ENDIF.
ENDLOOP.

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

元記事にあったSD_系汎用モジュールとの違い

SD_SALESDOCUMENT_CREATE と SD_SALES_DOCUMENT_PREFETCH は、名前に BAPI_ が付かない汎用モジュールです。元記事ではBAPIとして並べていましたが、登録・変更・参照の公開インターフェースとして同列に扱わず、まず上記のBAPIを検討します。既存プログラムでSD_系を使っている場合は、そのシステムでのリリース状態と用途、影響範囲を確認してください。

実装前の確認ポイント

  • 登録:販売エリア、受注タイプ、取引先機能、明細、納入日程などの必須項目を確認する
  • 変更:対象の受注番号、変更項目の INX フラグ、更新区分を確認する
  • 共通:RETURN、コミット、権限、ロック、ユーザーEXITやBAdIの影響を検証する
  • 外部連携:リトライ時の二重登録を防ぐため、外部キーと受注番号の対応を管理する

参考・関連記事

関連記事

PAGE TOP