Dynamics 365 Finance & Operationsに接続する

PlaidCloudをDynamics 365 Finance & Operations（D365 F&O）のODataおよびData Management Framework（DMF）エンドポイントに接続すると、ODataを手書きすることなくマスターデータとトランザクションデータを取得でき、総勘定元帳の仕訳エントリを書き戻すこともできます。このガイドでは、接続、インポートステップ、転記ステップについて説明します。

注意

インポートは必ず最初にサンドボックス環境に対して実行し、本番に転記する前に、すべての転記バッチで下記のValidate Onlyを実施してください。

前提条件

Azure ADとD365 F&Oで次のものが必要です。

• PlaidCloud用のEntra ID（Azure AD）アプリ登録とクライアントシークレット。D365 F&Oリソースに対するアプリケーションのアクセス許可（または管理者が同意した委任されたアクセス許可）が付与されている必要があります。
• Azure ADのテナントID。
• PlaidCloudが呼び出すD365 F&O環境の環境URL（例: https://yourorg.operations.dynamics.com）。
• リソース/スコープの値。通常は環境URL自体に/.defaultを付加したもので、アプリ登録がトークンを要求する対象です。

ノート

この接続は、ユーザーとしてではなくアプリケーションとして認証します。Entra IDのクライアント資格情報フローで、PlaidCloudが他のMicrosoft REST接続で使用するOAuth2の仕組みと同じです。対話的なサインインはありません。

接続を作成する

1. Tools > Connectionsを開き、New Connectionをクリックします。

2. メニューからDynamics 365 Finance & Operationsを選択します。

3. フィールドを入力します。

   フィールド	値
   名前	わかりやすい名前（例: D365 F&O Prod）。
   環境URL	環境のURL（例: https://yourorg.operations.dynamics.com）。
   クライアントID	Entraアプリ登録のアプリケーション（クライアント）ID。
   クライアントシークレット	アプリ登録のクライアントシークレット。
   テナントID	Azure ADのテナントID。
   リソース/スコープ	要求するOAuth2スコープ。通常は環境URLに/.defaultを付加したものです。

4. Createをクリックします。

接続をスモークテストする

1. ワークフローにImport D365 F&O Entityステップを追加します。

2. D365 F&O接続に作成した接続を、エンティティタイプにmain_accountsを、ターゲットテーブルに作業用テーブルを設定します。

3. ステップを実行します（ワークフロー内で1つのステップを実行するを参照）。

ターゲットテーブルにデータが入っていれば、テナント、認証情報、環境URLがすべて正しいことを確認できます。エラーが出た場合は、問題が示されます。クライアントシークレットの誤り、アクセス許可の付与漏れ、環境URLの誤りなどです。

データをインポートする

1. Import D365 F&O Entityステップを追加し、D365 F&O接続とターゲットテーブルを設定します。

2. エンティティタイプに取得するレコードを設定し、同期モードは、通常のサイズの取得ならodata、大きなエンティティの一括抽出ならdmfに設定します。

3. 取得を絞り込むにはフィルターを追加します。日付、勘定科目、ディメンションの範囲は、リクエストのOData $filterに変換され、エンティティごとに、D365 F&Oがサーバー側で実際にフィルターできるフィールドに限られます。

4. ステップを実行し、ターゲットテーブルを確認します。

エンティティとフィルター

エンティティタイプ	取得する内容	フィルター可能なフィールド
main_accounts	勘定科目表	勘定科目の範囲、ディメンション
currencies	通貨マスター	—
customers	顧客マスター	勘定科目の範囲
vendors	仕入先マスター	勘定科目の範囲
released_products	リリース済み製品マスター	—
ledger_journal_headers	未転記および転記済みの仕訳ヘッダー	日付の範囲、勘定科目の範囲、ディメンション

ノート

同期モード: ODataとDMF。odataは、D365 F&O標準のODataエンティティエンドポイントを直接呼び出します。最も単純な方法で、日常的な取得に適しています。dmfは、非同期のData Management Frameworkエクスポートジョブを送信し、完了後に生成されたパッケージをダウンロードします。通常のODataのページングでは遅くなったり切り捨てられたりする、大きなエンティティの一括抽出（たとえばledger_journal_headersの全履歴）に向いた方法です。

仕訳エントリを転記する

D365 F&O: Post Journal Entryステップは、D365 F&Oの非同期カスタムサービスの仕訳転記アクションを使って、PlaidCloudの共通ERP書き込みパイプラインを通じて総勘定元帳の仕訳エントリを転記します。

1. ヘッダーテーブル（仕訳エントリごとに1行）を作成します。journal_id（エントリの識別子）、journal_name（転記先のD365 F&O仕訳帳名）、posting_date、descriptionを含めます。

2. 明細テーブル（journal_idごとに1行以上）を作成します。account、debit、creditと、元帳で必要なディメンション列を含めます。

3. D365 F&O: Post Journal Entryステップを追加し、D365 F&O接続、ヘッダーテーブル、明細テーブル、結果テーブルを設定します。

4. Validate Onlyをオンのままステップを実行します。PlaidCloudは、台帳の請求を行わず、何も転記せずに、すべてのエントリを作成してチェックします。

5. 結果テーブル（エントリごとに1行: journal_id、natural_key、confirmation_id、status、message）を確認します。error行があれば修正して、再検証します。

6. Validate Onlyをオフにして再度実行し、実際に転記します。バッチが最初に失敗したエントリで完全に停止してよい場合を除き、Continue On Errorはオンのままにしてください。

転記の仕組み

PlaidCloudは、各仕訳エントリをD365 F&Oの非同期カスタムサービスの転記アクションに送信し、サービスがエントリの最終状態を報告するまでポーリングします。エントリは、その最終状態が確認された場合にのみpostedとして報告されます。受け付けられたものの最終状態が確定しないエントリは、転記済みとして記録されず隔離されたままになるため、停止した送信が黙って成功として扱われることはありません。PlaidCloud独自の台帳請求によって、再試行または再実行されたバッチで同じエントリが二重に転記されることを防ぎます。

転記済みエントリを訂正する

このステップが、転記済みのエントリを削除したり書き換えたりすることはありません。訂正するには、元のエントリを直接編集するのではなく、元のエントリと借方と貸方を入れ替えた新しいエントリ（転記済みの反対仕訳エントリ）を転記します。これにより、D365 F&O自体の監査証跡が保たれ、アプリケーション上で直接訂正する場合のやり方とも一致します。

機能の制限 — 本番に転記する前にお読みください

注意

• DMF同期モードには抽出の待ち時間があります。dmfによる取得は非同期のエクスポートジョブを待つため、同じサイズのodataによる取得よりもかなり長くかかります。小規模で待ち時間に敏感な読み取りには使用しないでください。
• ディメンションのフィルターは、元帳のディメンション設定に依存します。 勘定科目構造に含まれていない財務ディメンションは、サーバー側でフィルターできません。取得後にワークフロー内で絞り込んでください。
• このコネクタは、汎用のDynamics RESTコネクタとは別のものです。 そちらは他のDynamics 365アプリケーション（たとえばSales/CRM）を対象としています。Finance & Operationsに接続しない場合にのみ使用してください。

関連項目

• Dynamics 365 F&O RESTコネクタ — フィールドリファレンス。
• Import D365 F&O Entityステップ
• D365 F&O: Post Journal Entryステップ
• ERP転記履歴を確認する — D365 F&Oへのすべての転記試行とその最新の状態を記録した常設の履歴。
• 接続の作成と管理