ヘッダーをスキップ

Oracle Assetsユーザー・ガイド
リリース12
E06049-01
目次へ
目次
前のページへ
前へ
次のページへ
次へ

Oracle Assetsの共通請求書振替API

この付録では、次のトピックについて説明します。

はじめに

Oracle Assetsの既存のインタフェースとの併用が困難なカスタム・インタフェースを設定している場合は、このAPIを使用できます。共通請求書振替APIを使用すると、ソース明細の振替、コードの簡素化およびコード重複の防止を実行できます。

代替元帳通貨

代替元帳通貨を設定している場合は、Oracle Assets APIを使用して資産を追加または変更すると、その取引はAPIによって報告通貨に自動的にコピーされます。請求書端数処理の問題は、APIを使用して、元帳通貨と報告通貨の両方に対して代替元帳通貨会計処理を実行することで回避されます。

建設仮勘定

税務台帳の「資産台帳管理」ウィンドウで「建設仮勘定資産の許可」チェック・ボックスを選択している場合は、追加APIを使用して建設仮勘定資産を追加すると、その建設仮勘定資産が税務台帳に自動的に追加され、同時に会計用資産台帳にも追加されます。

関連項目

共通請求書振替APIの摘要

サンプル・スクリプト: 請求書振替APIの使用

共通請求書振替APIの摘要

共通請求書振替APIプロシージャは、FA_INV_XFR_PUB.DO_TRANSFER ()プロシージャと呼ばれます。次の表に、FA_INV_XFR_PUB.DO_TRANSFER ()プロシージャの各要素の引数、型、値および説明を示します。

各引数には、P、XまたはPXのプリフィクスが付加されます。それぞれの意味は、次のとおりです。

引数 説明
P_API_VERSION NUMBER 内部使用のみ。 使用しているAPIのバージョン。
P_INIT_MSG_LIST VARCHAR2(1) FND_API.G_TRUE: メッセージ・スタックを初期化します。
FND_API.G_FALSE: メッセージ・スタックを初期化しません(デフォルト)。
メッセージ・スタックを初期化および消去するかどうかを決定します。
P_COMMIT VARCHAR2(1) FND_API.G_TRUE: 自動的にコミットします。
FND_API.G_FALSE: 自動的にコミットしません(デフォルト)。
取引をコミットします。
P_VALIDATION_LEVEL NUMBER FND_API.G_VALID_ LEVEL_NONE: 取引に対して低レベルの検証を実行します。
FND_API.G_VALID_ LEVEL_FULL: 取引に対して高レベルの検証を実行します(デフォルト)。
APIによる資産の検証。
X_RETURN_STATUS VARCHAR2(1) FND_API.G_RET_STS_ SUCCESS: 成功を示します。
FND_API.G_RET_STS_ ERROR: 取引の失敗を示します。
FND_API.G_RET_STS_ UNEXP_ERROR: 予期しないエラーを示します。
APIの成功を判別します。
X_MSG_COUNT NUMBER   メッセージ・スタックのメッセージ数。
X_MSG_DATA VARCHAR2(1024)   メッセージ・スタック。
P_CALLING_FN VARCHAR2(30)   APIをコールする関数。
PX_SRC_TRANS_REC FA_API_TYPES.TRANS_REC_TYPE   実行する取引を示します。
PX_SRC_ASSET_HDR_REC FA_API_TYPES.ASSET_HDR_REC_TYPE   資産の一意の識別子。
PX_DEST_TRANS_REC FA_API_TYPES.TRANS_REC_TYPE   実行する取引を示します。
PX_DEST_ASSET_HDR_REC FA_API_TYPES.ASSET_HDR_REC_TYPE   資産の一意の識別子。
P_INV_TBL FA_API_TYPES. INV_TBL_TYPE   資産の請求書。

TRANS_REC取引体系

TRANS_REC_TYPE取引体系には、取引ヘッダーIDや取引タイプ・コードなど、取引に関する情報が記載されています。次の表に、各引数の型と値の情報を示します。

引数 必須/オプション
TRANSACTION_HEADER_ ID 内部使用のみ NUMBER(15) オプションのOUTパラメータ。
TRANSACTION_DATE_ ENTERED オプション DATE デフォルト設定される事業供用日と同じ日付である必要があります。
TRANSACTION_NAME オプション VARCHAR2(20) 取引の摘要。このフィールドは、資産ワークベンチの「注釈」フィールドです。
MASS_REFERENCE_ID オプション NUMBER(15) 取引を起動したコンカレント要求を識別します(一括取引の一部の場合)。
TRANSACTION_SUBTYPE オプション VARCHAR2(9) 取引タイプに関する追加情報。
AMORTIZATION_START_DATE オプション DATE 償却開始日。
CALLING_INTERFACE オプション VARCHAR2(30) CUSTOMにデフォルト設定されます。
DESC_FLEX オプション DESC_FLEX_ REC_ TYPE 付加フレックスフィールド・セグメント。
WHO_INFO 必須 STANDARD_ WHO_REC_ TYPE 標準WHO列。

INV_REC請求書体系

INV_REC請求書体系には、資産に関連付けられている単一の請求書の請求書情報が記載されています。INV_TBLはINV_REC_TYPEレコードの表です。これらのレコードには、資産に割り当てられているすべての請求書が含まれています。次の表に、各引数の型と摘要情報を示します。

引数 必須/オプション
FIXED_ASSETS_COST 必須 NUMBER Oracle Assetsの資産の取得価額。
SOURCE_LINE_ID 必須 NUMBER(15) この値は、振り替える各明細のデルタ金額です。この値は、0(ゼロ)から問題の明細の現行取得価額までの範囲内である必要があります。

サンプル・スクリプト: 請求書振替APIの使用

set serveroutput on



declare



   -- source

   l_src_trans_rec               FA_API_TYPES.trans_rec_type;

   l_src_asset_hdr_rec           FA_API_TYPES.asset_hdr_rec_type;

   l_inv_tbl                     FA_API_TYPES.inv_tbl_type;

   l_inv_rec                     FA_API_TYPES.inv_rec_type;



   -- destination     

   l_dest_trans_rec              FA_API_TYPES.trans_rec_type;

   l_dest_asset_hdr_rec          FA_API_TYPES.asset_hdr_rec_type;



   l_return_status               varchar2(1);

   l_mesg_count                  number;

   l_mesg                        varchar2(4000);



begin



   dbms_output.enable(10000000);



   FA_SRVR_MSG.Init_Server_Message;



   -- get source / destination info

   l_src_asset_hdr_rec.book_type_code          := '&book';

   l_dest_asset_hdr_rec.book_type_code         := l_src_asset_hdr_rec.book_type_code;

   l_src_asset_hdr_rec.asset_id                := &source_asset_id 

   l_dest_asset_hdr_rec.asset_id               := &destination_asset_id 



   -- get transaction_info

   l_src_trans_rec.transaction_subtype         := '&src_transaction_subtype';

   l_dest_trans_rec.transaction_subtype        := '&dest_transaction_subtype';

   l_src_trans_rec.transaction_date_entered    := '&src_transaction_date';

   l_dest_trans_rec.transaction_date_entered   := '&dest_transaction_date';

 

   -- invoice info - source

   l_inv_rec.source_line_id                    := &source_line_id

   l_inv_rec.fixed_assets_cost                 := &delta_cost_to_transfer



   -- set up the table for source

   l_inv_tbl (1)                               := l_inv_rec;



   --  call for source

   FA_INV_XFR_PUB.do_transfer(

           -- std parameters

           p_api_version         => 1.0,

           p_init_msg_list       => FND_API.G_FALSE,

           p_commit              => FND_API.G_FALSE,

           p_validation_level    => FND_API.G_VALID_LEVEL_FULL,

           p_calling_fn          => NULL,

           x_return_status       => l_return_status,

           x_msg_count           => l_mesg_count,

           x_msg_data            => l_mesg,

           -- api parameters

           px_src_trans_rec      => l_src_trans_rec,

           px_src_asset_hdr_rec  => l_src_asset_hdr_rec,

           px_dest_trans_rec     => l_dest_trans_rec,

           px_dest_asset_hdr_rec => l_dest_asset_hdr_rec,

           p_inv_tbl             => l_inv_tbl

          );





   --dump messages

   l_mesg_count := fnd_msg_pub.count_msg;



   if l_mesg_count > 0 then



      l_mesg := chr(10) || substr(fnd_msg_pub.get

                                    (fnd_msg_pub.G_FIRST, fnd_api.G_FALSE),

                                     1, 250);

      dbms_output.put_line(l_mesg);



      for i in 1..(l_mesg_count - 1) loop

         l_mesg :=

                     substr(fnd_msg_pub.get

                            (fnd_msg_pub.G_NEXT,

                             fnd_api.G_FALSE), 1, 250);



         dbms_output.put_line(l_mesg);

      end loop;



      fnd_msg_pub.delete_msg();



   end if;



   if (l_return_status <> FND_API.G_RET_STS_SUCCESS) then



      rollback;

      dbms_output.put_line('FAILURE');



   else 



      dbms_output.put_line('SUCCESS');

      dbms_output.put_line('THID_SRC' || to_char(l_src_trans_rec.transaction_header_id));

      dbms_output.put_line('THID_DEST' || to_char(l_dest_trans_rec.transaction_header_id));



   end if;



end;

/