[Oracle Cloud] FBDIのためのSOAP APIパラメータ - Import Receivables Transactions Using AutoInvoice編

## FBDI (File Based Data Import) の処理ステップ

FBDI (File Based Data Import) は名称のとおり、ファイルを使用したOracle Cloudへのデータインポート処理です。
FBDI によるデータインポートの処理ステップは以下です。

1. UCM (ファイルサーバ) へファイルアップロード
2. OIF (インタフェーステーブル) へのデータロード
3. 実テーブルへのインポート

各ステップはSOAP APIによる呼出が可能です。

## Import Receivables Transactions Using AutoInvoice (自動インボイスを使用した売掛/未収金トランザクションのインポート)

本機能はAR（売掛/未収金トランザクション）データをOracle Cloudへインポートするために使用します。（参考：[FBDIマニュアル : AutoInvoice Import](https://docs.oracle.com/en/cloud/saas/financials/20b/oefbf/receivables.html#receivables)）

FBDIの各処理ステップは、[ERP Integration Service](https://docs.oracle.com/en/cloud/saas/financials/20b/oeswf/business-object-services.html#erpintegrationservice-d13711e35899)の以下Operationで呼出します。

1. uploadFileToUcm (UCM account: fin/autoInvoice/import)
2. submitESSJobRequest (Job: InterfaceLoaderController)
3. submitESSJobRequest (Job: AutoInvoiceMasterEss)

### Import Receivables Transactions Using AutoInvoice と Import AutoInvoice の違い

Import AutoInvoiceは子プロセスであり、Import Receivables Transactions Using AutoInvoiceは親プロセスです。
重要な違いが1つあり、親プロセスは「Number of Workers (ワーカー数)」を指定可能です。
これは、FBDIを使用して大量のトランザクションをアップロードする場合に便利です。
最大40人のワーカーを割り当てることができるので、アップロード作業を分散させることができ、より高速に処理することができます。

## 各ステップのパラメータ

Import Receivables Transactions Using AutoInvoiceに特化したパラメータは以下にまとめてみました。（必要最小限のパラメータのみを検証）

### 1. uploadFileToUcm (UCM account: fin/autoInvoice/import)

   * UCM account: fin/autoInvoice/import
   * UCM security group: FAFusionImportExport

### 2. submitESSJobRequest (Job: InterfaceLoaderController)

   * Job Package name: oracle/apps/ess/financials/commonModules/shared/common/interfaceLoader
   * Job definition name: InterfaceLoaderController
   * Job Parameters:

    |No.|Name|名称|必須|値|備考|
    |---|---|---|---|---|---|
    |1|Import Process|インポート・プロセス|*|2|固定値|
    |2|Data File|データ・ファイル|*|Document ID|1. uploadFileToUcmのレスポンス値|
    |3|argument3|argument3||N|固定値|
    |4|argument4|argument4||N|固定値|

### 3. submitESSJobRequest (Job: AutoInvoiceMasterEss)

   * Job Package name: oracle/apps/ess/financials/receivables/transactions/autoInvoices
   * Job definition name: AutoInvoiceMasterEss
   * Job Parameters:

    |No.|Name|名称|必須|値|備考|
    |---|---|---|---|---|---|
    |1|Number of Workers|ワーカー数|*|1|必要に応じて変更|
    |2|Business Unit|ビジネス・ユニット||sampleUN|データファイルのBusiness Unit Name項目値|
    |3|Transaction Source|トランザクション・ソース|*|sampleTS|データファイルのTransaction Batch Source Name項目値|
    |4|Default Date|デフォルト日付|*|2020-01-01|データファイルのAccounting Dateが空の場合この値を使用 [参考](https://docs.oracle.com/en/cloud/saas/financials/20b/faofc/manage-customer-billing.html#FAOFC582048)|
    |5|Transaction Type|トランザクション・タイプ||#NULL||
    |6|From Customer|顧客: 自||#NULL||
    |7|To Customer|顧客: 至||#NULL||
    |8|From Customer Account Number|顧客アカウント番号: 自||#NULL||
    |9|To Customer Account Number|顧客アカウント番号: 至||#NULL||
    |10|From Accounting Date|会計日: 自||#NULL||
    |11|To Accounting Date|会計日: 至||#NULL||
    |12|From Ship Date|出荷日: 自||#NULL||
    |13|To Ship Date|出荷日: 至||#NULL||
    |14|From Transaction Number|トランザクション番号: 自||#NULL||
    |15|To Transaction Number|トランザクション番号: 至||#NULL||
    |16|From Sales Order Number|販売オーダー番号: 自||#NULL||
    |17|To Sales Order Number|販売オーダー番号: 至||#NULL||
    |18|From Transaction Date|トランザクション日: 自||#NULL||
    |19|To Transaction Date|トランザクション日: 至||#NULL||
    |20|From Ship-to Customer Account Number|出荷先顧客アカウント番号: 自||#NULL||
    |21|To Ship-to Customer Account Number|出荷先顧客アカウント番号: 至||#NULL||
    |22|From Ship-to Customer Name|出荷先顧客名: 自||#NULL||
    |23|To Ship-to Customer Name|出荷先顧客名: 至||#NULL||
    |24|Base Due Date on Transaction Date|トランザクション日を基準に支払期日計算|*|Y|YまたはN|
    |25|Due Date Adjustment Days|支払期日修正日数||#NULL||

## [おまけ]インポート後の画面確認パス

Navigator -> Receivables -> Billing

ナビゲータ -> 売掛管理 -> 請求