ABAPから受注伝票を登録・変更する場合は、処理の目的に合うBAPIを選びます。登録と変更では入力構造や更新フラグが異なり、呼び出しただけではデータベースへの確定も終わりません。この記事では、代表的なBAPIの使い分けと実装時の確認点を整理します。
受注伝票で使う主なBAPI
| 目的 | 主なインターフェース | 確認する結果 |
| 登録 | BAPI_SALESORDER_CREATEFROMDAT2 | 受注番号とRETURN |
| 変更 | BAPI_SALESORDER_CHANGE | RETURNと更新結果 |
| 一覧取得 | 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の影響を検証する - 外部連携:リトライ時の二重登録を防ぐため、外部キーと受注番号の対応を管理する
参考・関連記事
- 汎用モジュール一覧:FI・CO・SDなどの関連BAPIを探す際に
- 購買発注伝票の登録・変更を行うBAPI:購買側のBAPI実装と比較する際に