Oracle Fusion ERP 接続：注文と請求書を取り込む

Oracle Fusion のインスタンス URL を Integration に入力し、Fusion REST のユーザー名とパスワード、または事前に取得した OAuth bearer token のどちらかでログイン、テスト・マッピング・有効化。

Oracle Fusion ERP コネクタは Oracle Fusion Cloud ERP の販売注文と請求書をこのシステムに取り込みます。これがこの接続の全範囲です：顧客は取り込まず、在庫の確認も取得もせず、Oracle Fusion へ何も返送しません。ログイン方法は 2 つのうち 1 つです。Fusion REST のユーザー名とパスワードか、事前に取得して貼り付ける OAuth bearer token です。トークンが入力されている場合は、トークンが優先して使われます。Oracle Fusion のインスタンスごとに 1 接続です。

前提条件#

• ログインできる Oracle Fusion Cloud インスタンスと、そのインスタンス URL（例：https://fa-xxx.oraclecloud.com）。
• 事前に選んだ完全なログインセット 1 つ：統合ロールを持つ Fusion ユーザーとそのパスワードか、OCI / IDCS の ID ドメインで事前に取得した OAuth2 アクセス トークンのどちらかです。半分だけでは接続できません。
• トークンを使う場合：貼り付けたトークンが使えなくなったときに、OCI / IDCS の ID ドメインで新しいトークンを取得する方法を用意してください。この接続はトークンを貼り付けたそのままの形で使い、新しいものを代わりに取得することはありません。

認証情報の取得#

1. インスタンス URL（例：https://fa-xxx.oraclecloud.com）を控えます。どちらのログインセットを選んでも、すべての接続に必要な唯一の値です。
2. 方法 A — Basic ログイン：統合ロールを持つ Fusion ユーザー（例：REST_USER）を用意し、そのパスワードを用意します。ユーザー名とパスワードは一緒にに入力しなければならず、片方だけではセットになりません。
3. 方法 B — トークン ログイン：OCI / IDCS の ID ドメインで、事前に OAuth2 アクセス トークンを取得してコピーします。ここに貼り付けるのは取得済みのトークンです。この接続の中にログインへのジャンプもトークン交換もありません。
4. どちらか 1 つを実際に使うセットとして選んでください。後で、ユーザー名とパスワードを使っていた接続にトークンを入力すると、その時点からトークンが使われるようになります。

Integration への入力#

1. Integration → コネクタマーケットプレイス → Oracle Fusion ERP → 新規接続 を開きます。
2. base_url、必須、インスタンス URL：Oracle Fusion インスタンスのアドレス（例：https://fa-xxx.oraclecloud.com）を入力します。
3. api_version、任意、API バージョン：空のままにすると組み込みのデフォルト値 11.13.18.05 が使われます。お使いの環境が別のバージョンの場合だけ入力してください。
4. username、Basic ログイン用、ユーザー名（Basic 認証）：統合ロールを持つ Fusion REST ユーザー（例：REST_USER）を入力します。password と一緒に入力するか、両方とも空にして代わりに token を使ってください。
5. password、Basic ログイン用、パスワード（Basic 認証）：同じ Fusion ユーザーのパスワードを入力します。パスワード型のフィールドで、秘密情報として保存されます。
6. token、任意の代替、OAuth bearer token：OCI / IDCS の ID ドメインで事前に取得した OAuth2 アクセス トークンを貼り付けます。パスワード型のフィールドで、秘密情報として保存されます。token が入力されている場合、username と password より先に使われます。

接続テスト#

接続テストをクリックします。テストはまず入力内容を確認します：base_url が未入力か、どちらのログインセットも揃っていない場合（ユーザー名とパスワードがなく、トークンもない場合）は、未入力のメッセージで止まり、何も送信しません。次に、選んだセットを使って実際の軽い読み取り専用リクエストを 1 回行います。トークンが入力されていればトークンを Bearer ログインとして、そうでなければユーザー名とパスワードを Basic ログインとして使い、請求書リソースに 1 件を問い合わせます。200 の応答が返れば合格です。401 または 403 の応答は、実際に使われたログインセットが拒否されたことを示します。そのセットを確認し、もう一方は確認しないでください。インスタンスが約 12 秒応答しない場合、テストはタイムアウトで止まります。

Mapping / テンプレート選択#

Oracle Fusion 標準の Mapping を選択します。この接続が取得する 2 種類のデータに対応します：販売注文は salesOrdersForOrderHub リソースから、請求書は invoices リソースから取得します。テスト合格後、1 回取得を実行し、実注文と実請求書を並べて確認してください（番号、顧客参照、明細、金額）。確認後に有効化します。この接続には顧客や在庫の Mapping はありません。この接続は顧客も在庫も取得しないためです。

有効化#

有効化後、接続は設定した頻度で Oracle Fusion の販売注文と請求書をこのシステムに取り込みます。最初は Runs / Logs で取得を確認し、Oracle Fusion と照合してから無人運用に移してください。トークンでログインしている場合は、そのトークンに注意してください：貼り付けたトークンが使えなくなると、新しいものを貼り付けるまで取得が失敗するようになります。

この接続が行わないこと：Oracle Fusion から顧客を取り込まず、在庫の確認も取得もせず、在庫やその他のものを Oracle Fusion に返送しません。顧客と在庫は引き続き Oracle Fusion 自体で、またはその作業が実際に行われるシステムで処理してください。

よくある質問#

テストが 401 または 403 で失敗する

Oracle Fusion が、テストで実際に使われたログインセットを拒否しました。トークンが入力されている場合はトークンが使われたので、ユーザー名とパスワードも入力されていても、拒否されたのはトークンです。トークンが入力されていない場合は、ユーザー名とパスワードが拒否されたか、その Fusion ユーザーに REST リソースが必要とする統合ロールがありません。

実際に使われたセットを確認してください。トークン使用中：OCI / IDCS の ID ドメインで新しい OAuth2 アクセス トークンを取得し、token に全文を貼り付けます。Basic 使用中：username と password を一緒に再確認し、Fusion でそのユーザーに統合ロールがあることを確認してください。その後、再テストしてください。

テストが何も送信する前に未入力のメッセージで止まる

入力が不完全です：base_url が空か、どちらのログインセットも揃っていません。パスワードのないユーザー名はセットではなく、ユーザー名のないパスワードもセットではありません。さらにトークンも入力されていない場合、テストにはログインする方法がまったくありません。

base_url にインスタンスの完全な URL を入力し、次にちょうど 1 セットだけを揃えてください：username と password を一緒に、またはトークンを全文貼り付けます。保存して再テストしてください。

以前は接続できていたのに、取得が勝手に失敗し始めた

この接続がトークンでログインしている場合、貼り付けたトークンが使えなくなっています。この接続はトークンを貼り付けたそのままの形で使い、新しいものを取得しないため、テスト時に機能していたトークンが後で使えなくなることがあります。他の値はすべて正しいままです。

OCI / IDCS の ID ドメインで新しい OAuth2 アクセス トークンを取得し、token フィールドに全文を貼り付けて保存し、テストしてください。新しいトークンでも失敗が続く場合は、代わりに Basic のセットを確認するか、意図的に token フィールドを空にしてユーザー名とパスワードに戻してください。

ユーザー名とパスワードを入力したのに、入力していないようにログインが振る舞う

この接続にはトークンも入力されており、入力されたトークンは username と password より先に使われます。Basic の値が壊れているわけではありません。トークンの値がある間は、そのセットが使われていないだけです。

どちらのセットを使うか決めてください。トークンを使う場合：トークンを新しい状態に保ち、Basic のフィールドは気にしないでください。ユーザー名とパスワードを使う場合：token フィールドを完全に空にし、保存して再テストしてください。

接続済みだが、顧客や在庫がまったく表示されない

これはこの接続の範囲であり、故障ではありません：取得するのは販売注文と請求書だけです。顧客と在庫はこの接続では取得されないため、Mapping、頻度、認証情報を変更してもここに表示されることはありません。

顧客と在庫は引き続き Oracle Fusion 自体で、またはそのデータが実際に存在するシステムで処理してください。この接続は注文と請求書に使い、確認するときは Runs / Logs でその 2 つを見てください。

接続済みだが注文や請求書が取り込まれない

接続は機能しています（テストで請求書リソースを実際に読みました）が、新しく取り込むものがありません。インスタンスの取得範囲内に新しい販売注文や請求書がありません。お使いの環境がそのバージョンでない場合、api_version の値が間違っていると、同じように空の結果になることがあります。

Oracle Fusion で販売注文 1 件と請求書 1 件を作成または確認し、お使いの環境が組み込みのデフォルトと異なるバージョンであることが分かっている場合を除き api_version は空のままにしてください。その後、手動取得を実行し、両方がプレビューまたは Runs / Logs に表示されるか確認してください。