Dynamics 365 Finance & Operations RESTコネクター

APIドキュメント

D365 F&OのOData v4エンドポイントとData Management Frameworkに、このコネクターが使用するエンドポイントと一括抽出パスが記載されています。

認証の仕組み

この接続は、Entra ID（Azure AD）のクライアント資格情報を使用してアプリケーションとして認証します。アプリ登録のクライアントIDとシークレットを、環境のリソースにスコープされたアクセストークンに交換します。対話型のサインインはありません。

設定

フィールド	タイプ	説明
名前	テキスト	この接続の表示名。
環境URL	テキスト	D365 F&Oの環境URL（例：`https://yourorg.operations.dynamics.com`）。
クライアントID	テキスト	Entraアプリ登録のアプリケーション（クライアント）ID。
クライアントシークレット	テキスト	アプリ登録のクライアントシークレット。暗号化して保存されます。
テナントID	テキスト	Azure ADのテナントID。
リソース/スコープ	テキスト	要求するOAuth2スコープ。通常は環境URLに`/.default`を付けたものです。

インポートできるエンティティ

Import D365 F&O Entityステップは、main_accounts、currencies、customers、vendors、released_products、ledger_journal_headersの6つのエンティティに対応しています。各取得は、odata同期モード（通常の取得向けの直接呼び出し）またはdmf一括モード（大規模な抽出向けの、非同期のData Management Frameworkエクスポートジョブ）のいずれかで実行され、日付、勘定科目、ディメンションの範囲を含む、エンティティごとのサーバー側フィルターを使用できます。フィールドの詳細はImport D365 F&O Entityステップを参照してください。

仕訳の転記

D365 F&O: Post Journal Entryステップは、PlaidCloudの共通ERP書き込みパイプラインを通じて総勘定元帳の仕訳を転記します。D365 F&Oの非同期カスタムサービスの仕訳転記アクションに送信し、最終状態になるまでポーリングし、確認してから仕訳を転記済みとして報告します。訂正では、元の仕訳を編集するのではなく、借方と貸方を入れ替えた新しい取消仕訳を転記します。フィールドのリファレンスはD365 F&O: Post Journal Entryステップを、転記の手順全体はDynamics 365 Finance & Operationsへの接続を参照してください。

既知の制限事項

制限事項	意味
DMF同期モードには抽出の待ち時間がある	`dmf`による取得は非同期のエクスポートジョブを待つため、同じサイズの`odata`による取得よりもかなり遅くなります。
ディメンションのフィルタリングは構造に依存する	勘定科目構造に含まれない財務ディメンションは、サーバー側でフィルターできません。取得後にワークフロー内で絞り込んでください。