BAPI_ACC_DOCUMENT_REV_POSTの使い方|会計伝票の取消と反対仕訳

ABAPから会計伝票を取り消すときに使うBAPIが、BAPI_ACC_DOCUMENT_REV_POSTです。元伝票を削除するのではなく、元伝票と紐付く取消伝票を転記します。実装では伝票番号だけを渡せばよいわけではありません。元伝票の参照情報、取消理由、転記日付、業務トランザクションを確認し、戻りメッセージを判定してからコミットします。

この記事では、FIの会計伝票をプログラムから取り消す場合の確認順序と、BAPIの呼び出し部分を説明します。画面からの取消はFB08が入口です。

BAPI_ACC_DOCUMENT_REV_POSTでできること

このBAPIは会計インターフェースを通じた取消転記に使用します。対象伝票に対して取消伝票を作成し、元伝票との参照関係を保持する点が、単に貸借を逆にした新規伝票をBAPI_ACC_DOCUMENT_POSTで登録する方法との違いです。元伝票の履歴を追えるようにしたい場合は、この違いが重要になります。

方法 主な用途 確認点
FB08 担当者が画面でFI伝票を取り消す 取消理由・転記日付を確認する
BAPI_ACC_DOCUMENT_REV_POST ABAPから取消処理を実行する 元伝票との参照、戻り値、コミットを確認する
BAPI_ACC_DOCUMENT_POST 新たな会計伝票を登録する 逆向きの金額を登録するだけでは、標準の取消関係と同じにはならない

ただし、MMやSDなどの業務伝票から発生した会計伝票は、原則として発生元の業務処理で取消方法を確認します。FI側の伝票だけを取り消しても、在庫や請求などの元データまで戻るとは限りません。

呼び出す前に確認すること

  1. 対象を一意に特定する:会社コード、会計伝票番号、会計年度を使ってBKPFの元伝票を取得します。伝票番号だけでは年度や会社コードを取り違える可能性があります。
  2. 既に取消済みでないか調べる:BKPF-STBLGなどで取消伝票との関係を確認します。ただし事前確認だけでは同時実行による二重処理を防ぎ切れないため、BAPIの戻りメッセージも必ず判定します。
  3. 元伝票の発生元を確認する:BKPF-AWTYP、BKPF-AWKEY、BKPF-AWSYSと業務トランザクションを確認します。参照キーは単純な「伝票番号」ではなく、発生元によって構成が異なります。
  4. 転記条件を決める:取消理由と取消の転記日付を業務担当者と確認し、転記期間や権限などの条件を満たすか調べます。取消理由のコードはシステムの設定に従います。

主な入力項目と参照キーの考え方

インターフェースの中心はREVERSAL(構造BAPIACREV)とBUS_ACTです。項目の意味を確認してから値を設定してください。

項目 意味・設定時の確認点
REVERSAL-OBJ_TYPE 参照トランザクション。元伝票のBKPF-AWTYPを手掛かりに、使用する取消インターフェースに対応するか確認する。
REVERSAL-OBJ_KEY 取消側の参照キー。元伝票と衝突しない値が必要。構成は元の転記インターフェースとシステムの設計に合わせる。
REVERSAL-OBJ_KEY_R 取り消す元伝票側の参照キー。元伝票のBKPF-AWKEYを確認する。
REVERSAL-OBJ_SYS 参照元の論理システム。元伝票のBKPF-AWSYSや論理システム設定を確認する。
REVERSAL-COMP_CODE 対象の会社コード。
REVERSAL-REASON_REV 取消理由。利用できるコードは設定と業務ルールによる。
REVERSAL-PSTNG_DATE 取消伝票の転記日付。元伝票と異なる期間に転記する場合は特に注意する。
BUS_ACT 元伝票で使用した業務トランザクション。FIの一般的な転記ではRFBUが使われるが、元伝票を確認して決める。

OBJ_KEYとOBJ_KEY_Rをどちらも会計伝票番号だけで埋めないようにします。BKPF-AWKEYの実際の値と、システム内での取消側参照キーの作り方をSE37のBAPI文書・既存の転記プログラム・テスト環境で照合してください。

ABAPでの呼び出し例

次は対象のBKPFを取得し、取消側の一意な参照キーlv_rev_awkeyを決定済みという前提での呼び出し部分です。元伝票の発生元やシステム設定によって、参照キーや論理システムの値を調整します。サンプルをそのまま本番環境で実行せず、まずテスト環境で伝票の対応関係を確認してください。

DATA: ls_reversal TYPE bapiacrev,
      lt_return   TYPE STANDARD TABLE OF bapiret2,
      lv_obj_type TYPE bapiacrev-obj_type,
      lv_obj_key  TYPE bapiacrev-obj_key,
      lv_obj_sys  TYPE bapiacrev-obj_sys.

ls_reversal-obj_type   = ls_bkpf-awtyp.
ls_reversal-obj_key    = lv_rev_awkey.   "取消側の一意な参照キー
ls_reversal-obj_key_r  = ls_bkpf-awkey. "元伝票の参照キー
ls_reversal-obj_sys    = ls_bkpf-awsys.
ls_reversal-comp_code  = ls_bkpf-bukrs.
ls_reversal-pstng_date = p_budat.
ls_reversal-reason_rev = p_stgrd.

CALL FUNCTION 'BAPI_ACC_DOCUMENT_REV_POST'
  EXPORTING
    reversal = ls_reversal
    bus_act  = ls_bkpf-glvor
  IMPORTING
    obj_type = lv_obj_type
    obj_key  = lv_obj_key
    obj_sys  = lv_obj_sys
  TABLES
    return   = lt_return.

LOOP AT lt_return TRANSPORTING NO FIELDS
  WHERE type = 'E' OR type = 'A' OR type = 'X'.
  EXIT.
ENDLOOP.

IF sy-subrc = 0.
  CALL FUNCTION 'BAPI_TRANSACTION_ROLLBACK'.
  "lt_return のメッセージを記録し、原因を確認する
ELSE.
  CALL FUNCTION 'BAPI_TRANSACTION_COMMIT'
    EXPORTING
      wait = 'X'.
  "lv_obj_key と元伝票の取消関係を確認する
ENDIF.

エラー・中止メッセージがないことだけを最終成功とせず、コミットの結果と転記された伝票を確認します。出力されたOBJ_KEYや元伝票・取消伝票の関係をFB03などで確認し、後続処理には検証済みの結果を渡します。更新に失敗した場合はメッセージIDと番号、対象伝票、参照キーをログに残すと原因を追いやすくなります。

エラーになったときの切り分け

状況 確認すること
参照伝票が見つからない 会社コード・年度、AWTYP・AWKEY・AWSYS、取消側キーの構成を確認する。
既に取消済み 元伝票と取消伝票の関係を確認する。リトライ処理なら二重起票を避ける。
転記日付・期間のエラー 取消理由、転記日付、会計期間の設定と権限を確認する。
元伝票がMM・SDなどから作成されている 発生元の業務伝票と、その標準取消手順を確認する。

特に外部連携やバッチ処理では、タイムアウト後に「BAPIが失敗した」と決めつけて再実行しないことが大切です。先に元伝票の取消状態を確認してから、再実行の要否を決めます。

まとめ

BAPI_ACC_DOCUMENT_REV_POSTでは、元伝票の参照情報を正しく把握し、取消側の参照キー、取消理由、転記日付を設定して呼び出すことが重要です。戻りメッセージを判定してコミットし、元伝票と取消伝票の紐付きを確認します。MM・SD起点の伝票は、まず発生元の取消手順を確認してください。

参考・関連記事

関連記事

PAGE TOP