このレシピについて
このレシピは、支払リクエストを含むインタフェース・ファイルを、Oracle Integrationで指定されたスケジュールに従ってFTPサーバーからOracle ERP Cloudにインポートします。
Oracle ERP Cloudでは、支払リクエストを使用して(サプライヤ・レコードを作成せずに)外部サプライヤまたはパーティに1回かぎりの支払を行います。 支払リクエスト(トランザクション)がOracle ERP Cloudにインポートされると、受取人、パーティおよび銀行口座がアプリケーションで自動的に作成されるため、支払の実行タスクが簡略化されます。 さらに、トランザクションは自動的に検証されるため、手動操作が不要になります。
このレシピの一部として、Oracleには、支払リクエストをOracle ERP Cloudにロードするために使用できるファイル構造の例が用意されています。
レシピを使用するには、レシピをインストールし、その中の接続およびその他のリソースを構成する必要があります。 その後、レシピを手動でアクティブ化して実行したり、レシピの実行スケジュールを指定できます。 トリガーされると、レシピは指定したFTPサーバーからOracle ERP Cloudに支払リクエストをロードします。
システムおよびアクセスの要件
-
Oracle Integration、バージョン21.4.2.0.0以上
-
Oracle ERP Cloud、バージョン21d以上
-
管理者ロールおよび買掛/未払金請求書監督者/買掛/未払金マネージャ/買掛/未払金スペシャリスト・ロールを持つOracle ERP Cloudのアカウント(支払リクエストをチェックするため)
-
セキュアFTP (sFTP)サーバーまたはファイル・サーバー
-
sFTPサーバーにアクセスするFTPクライアント。
レシピ・スキーマ
このセクションでは、レシピのアーキテクチャの概要について説明します。
プライマリ統合フロー(「Oracle FTP ERP Cloud支払リクエスト」)は、実行スケジュールまたは手動発行によってトリガーされると、FTPサーバーに支払リクエスト・ファイル(.zip)を問い合せます。 ファイルが見つかった場合、統合フローによってファイルが処理されます。 最初に、フローはファイルのレイアウトをOracle ERP Cloudで必要なレイアウトにマップし、ERPアダプタを介して支払リクエストを一括でインポートします。
支払リクエストをインポートした後、Oracle ERP Cloudはセカンダリ統合フロー(「Oracle FTP ERP Cloud支払リクエスト・コール・バック」)へのコールバックを行います。これにより、Oracle ERP Cloudからログ・ファイルがダウンロードされ、FTPサーバーに配置されます。
支払リクエスト・ファイル定義
この項では、レシピのプライマリ統合フロー(「Oracle FTP ERP Cloud支払リクエスト」)で使用されるファイル・レイアウトについて説明します。 この統合フローは、sFTPサーバー上の.zipファイルを検索するように構成されています。 .zipファイルには、次の2つのファイルが含まれている必要があります:
apPaymentRequest.propertiesapPaymentRequest.csv
定義: apPaymentRequest.properties
このファイルは、支払リクエストの処理および検証方法をOracle ERP Cloudに指示します。 このファイルは.csv形式です。
| パラメータ | 値 |
|---|---|
| プログラムの場所 | oracle/ apps/ess/financials/payables/invoices/transactions/ |
| プログラム | APXPRIMPT |
| インタフェース | ロードされるファイル名。これは、.zipサフィクスなしでFTPImportFileNameルックアップ内に配置される名前です。 たとえば: apPaymentRequest。
|
| ビジネス・ユニット | Setup and Maintenance(設定および保守)/Manage Business Unit(ビジネス・ユニットの管理)。 |
| 記帳日 | 会計日を入力してください。 日付を入力しない場合、会計日は「会計日基準」オプションに基づきます。 |
| Oracle_Int1 | ハードコードされた内部値が1000に設定されます。
|
| ソース | 支払リクエストの場合、これは常にONE_TIME_PAYMENTSです。
|
| インポート・セット | インポートを制限するインポート・セットの名前。 |
| パージ |
はい。Payablesでは、このインポートのソースおよびグループIDに一致するレコードが削除されます。 いいえ。拒否されたレコードを除くすべてのレコードを保持します。 |
| 要約 | 買掛/未払金支払リクエスト・インタフェース・インポート・レポートの監査部分を要約するかどうかを入力します。 |
| レジャー | Setup and Maintenance(設定および保守)/Manage Primary Ledgers(プライマリ元帳の管理)。 |
| 請求書グループ | 請求書グループの名前を入力します。 |
| Oracle_Int2 | ハードコードされた内部値が1に設定されます。 |
値の例: apPaymentRequest.properties
次の表に、パラメータ・ファイルの値セットの例を示します。 インタフェース、ビジネス・ユニットおよび元帳フィールドに、構成に固有の値を入力してください。
| パラメータ | 値 |
|---|---|
| プログラムの場所 | oracle/apps/ess/financials/payables/invoices/transactions/ |
| プログラム | APXPRIMPT |
| インタフェース | apPaymentRequest |
| ビジネス・ユニット | 300000047498175 |
| 記帳日 | null |
| Oracle_Int1 | 1000 |
| ソース | ONE_TIME_PAYMENTS |
| インポート・セット | null |
| パージ | N |
| 要約 | N |
| レジャー | 300000047488112 |
| 請求書グループ | null |
| Oracle_Int2 | 1 |
サンプル・ファイル: apPaymentRequest.properties
この項では、パラメータ・ファイルの例と名前を示します: apPaymentRequest.properties。
ファイル名は、ファイル内の「インタフェース」フィールドに入力した値と同じで、サフィクスとして.propertiesを指定する必要があります。
サンプル・ファイル:
ProgramLocation,Program,Interface,BusinessUnit,AccountingDate,Oracle_Int1,Source,ImportSet,Purge,Summarise,Ledger,InvoiceGroup,Oracle_Int2 /oracle/apps/ess/financials/payables/invoices/transactions/,APXPRIMPT,apPaymentRequest,300000047498175,null,1000,ONE_TIME_PAYMENTS,null,N,N,300000047488112,null,1
定義: apPaymentRequest.csv
このファイルには、Oracle ERP Cloudを介して支払われる支払リクエストが含まれています。 次に、支払リクエストのロードに必要な最小限のデータ・セットを含む例を示します。
次の構造を使用して、このファイルを.csv形式で準備します:
| パラメータ | 説明 |
|---|---|
| トランザクション識別子 | 支払リクエスト明細レコードを一意に識別する識別子。 |
| パーティ名称 | 支払が行われるパーティの名前。 |
| パーティ・オリジナル・システム参照 | 元のシステムまたは外部ソースからのパーティ参照。 |
| パーティ・タイプ | 支払を受け取るパーティのタイプです。 |
| 事業所オリジナル・システム参照 | パーティ・サイト住所のオリジナル・システム参照。 |
| 国 | 国別の住所のロケーションです。 |
| 住所1 | パーティ住所の1行目。 |
| 住所2 | パーティ住所の2行目。 |
| 市町村 | 支払が行われるパーティの市区町村。 |
| 状態 | 支払が行われるパーティの状態。 |
| 地方 | 支払が行われるパーティの州。 |
| 郡 | 支払が行われるパーティの郡。 |
| 郵便番号 | 支払が行われるパーティの郵便番号。 |
| 郵便番号+4コード | 郵便番号に対する4桁の拡張。 |
| 受取人 | 住所に所在する個人または受信者。 |
| グローバル事業所番号 | 取引パートナ企業の各グローバル事業所を一意に識別する番号。 |
| Language | パーティ・サイト住所の操作言語。 |
| 電話国コード | 電話番号の国コード。 |
| 電話番号市外局番 | 住所電話番号のエリア・コード。 |
| 電話 | 支払を受領するパーティの電話番号。 |
| 電話内線 | 支払を受領するパーティの電話内線番号。 |
| 受取人Eメール・アドレス | 支払が行われる受取人のEメール・アドレス。 |
| パーティ税務登録番号 | 税務当局によってパーティまたはパーティ・サイトに割り当てられた一意の識別子。 |
| アカウント国コード | 受取人の銀行口座の国コードです。 |
| 口座通貨コード | 受取人の銀行口座の通貨コード。 |
| 口座 番号 | 受取人の銀行口座番号。 |
| IBAN | 受取人の国際銀行口座番号。 |
| セカンダリ口座参照 | 住宅金融共済組合のロール番号など、アカウント番号参照。 |
| 口座サフィクス | 勘定科目の種類を決定する勘定科目番号の末尾の1桁から3桁の数字。 |
| Account Name | 受取人銀行口座の名前。 |
| 勘定科目タイプ・コード | SAVINGSやCHECKINGなどの銀行口座のタイプです。 |
| 銀行名 | 支払を行う受取銀行の名前。 |
| 銀行番号 | 支払が行われる受取人銀行の番号。 |
| 銀行支店名 | 受取人銀行のブランチの名前。 |
| 銀行支店番号 | 銀行ブランチの番号です。 これは、米国およびカナダのルーティング転送番号と呼ばれます。 |
| BIC | 銀行ブランチのSWIFTまたは銀行識別コード(BIC)。 |
| 検証桁 | 銀行口座番号の検証に使用される1つ以上の桁。 |
| アカウントの説明 | 受取人銀行口座の摘要。 |
| アカウント・カナ名 | 受取人の銀行口座の代替勘定科目名です。 |
| ビジネス・ユニット | トランザクションが作成される販売先ビジネス・ユニット名。 |
| ソース | 支払リクエストのインポート元となる外部システムの名前。 |
| Invoice Number | 支払リクエストの一意の番号。 |
| インボイス日 | 支払リクエストが発行された日付。 |
| 通貨 | 支払リクエストの通貨。 |
| 説明 | 支払用に作成された請求書に関する情報。 |
| インポート・セット | 支払リクエストを含むインポート・セットに割り当てられた名前または番号。 |
| 法的エンティティ | 自分の企業体系(企業)に属する法的エンティティの名前。 |
| 支払条件 | 賦払の作成および各請求書の期日、割引日および割引額の計算に使用する支払条件の名前。 |
| 支払 方法 | 支払方法を識別するコード。 |
| 支払 グループ | 支払リクエストを単一の支払実行にグループ化するために使用されます。 |
| 負債組合せ | 会計の見越基準で負債が記録される勘定科目です。 |
| 行番号 | 請求書明細の番号。 |
| 金額 | 支払用にインポートする請求書明細金額。 |
| 行の説明 | 明細摘要 |
| 配分組合せ | 請求書配分の作成に使用される勘定科目組合せ。 |
値の例: apPaymentRequest.csv
次の表に、payment-requestファイルの値セットの例を示します。
| パラメータ | 説明 |
|---|---|
| トランザクション識別子 | 100109 |
| パーティ名称 | Fred Jones |
| パーティ・オリジナル・システム参照 | OTP-PTY-100109 |
| パーティ・タイプ | ORGANIZATION |
| 事業所オリジナル・システム参照 | OTP-PTY-100109 |
| 国 | GB |
| 住所1 | Oracle Parkway |
| 住所2 | Thames Valley Park |
| 市町村 | Reading |
| 状態 | UK |
| 地方 | 該当なし |
| 郡 | 該当なし |
| 郵便番号 | RG6 |
| 郵便番号+4コード | 1RA |
| 受取人 | 該当なし |
| グローバル事業所番号 | 該当なし |
| Language | 該当なし |
| 電話国コード | 該当なし |
| 電話番号市外局番 | 該当なし |
| 電話 | 該当なし |
| 電話内線 | 該当なし |
| 受取人Eメール・アドレス | fred.jones@emaildomain.com |
| パーティ税務登録番号 | 該当なし |
| アカウント国コード | GB |
| 口座通貨コード | GBP |
| 口座 番号 | 99453336 |
| IBAN | 該当なし |
| セカンダリ口座参照 | 該当なし |
| 口座サフィクス | 該当なし |
| Account Name | F Jones |
| 勘定科目タイプ・コード | 該当なし |
| 銀行名 | HSBC |
| 銀行番号 | 該当なし |
| 銀行支店名 | Reading |
| 銀行支店番号 | 754322 |
| BIC | 該当なし |
| 検証桁 | 該当なし |
| アカウントの説明 | 該当なし |
| アカウント・カナ名 | 該当なし |
| ビジネス・ユニット | UK Business Unit |
| ソース | ONE_TIME_PAYMENTS |
| Invoice Number | OTP-FJONES-109 |
| インボイス日 | 2021/11/09 |
| 通貨 | GBP |
| 説明 | Refund |
| インポート・セット | GBP,Refund,,UK Legal |
| 法的エンティティ | UK Legal Entity |
| 支払条件 | Immediate |
| 支払 方法 | 該当なし |
| 支払 グループ | 該当なし |
| 負債組合せ | 303.30.2210.000.000.000 |
| 行番号 | 1 |
| 金額 | 20 |
| 行の説明 | One time payment lines |
| 配分組合せ | 303.30.7740.000.000.000 |
