Business Central RESTコネクター

APIドキュメント

Business Centralの標準OData v2.0 APIに、このコネクターが使用するエンティティと$filter/$orderbyオプションが記載されています。

認証の仕組み

この接続は、Entra ID（Azure AD）のクライアント資格情報（S2S） を使用してアプリケーションとして認証します。アプリ登録のクライアントIDとシークレットを、https://login.microsoftonline.com/<tenant id>/oauth2/v2.0/tokenでアクセストークンに交換し、スコープはhttps://api.businesscentral.dynamics.com/.defaultです。対話型のサインインはありません。アプリ登録には、Business Centralへ付与されたAPIアクセス許可（API.ReadWrite.All、または管理者が発行するより限定的なスコープ）が必要です。

すべてのリクエストは、1つの環境（たとえばProductionやサンドボックス環境）と、その中の1つの会社にスコープが限定されます。どちらもリクエストごとに選択するのではなく、接続に設定します。

設定

フィールド	タイプ	説明
名前	テキスト	この接続の表示名。
クライアントID	テキスト	Entraアプリ登録のアプリケーション（クライアント）ID。
クライアントシークレット	テキスト	アプリ登録のクライアントシークレット。暗号化して保存されます。
テナントID	テキスト	Azure ADのテナントID。
環境	テキスト	Business Centralの環境名（例：`Production`）。
会社	テキスト	この接続が読み取りと転記の対象とするBusiness Centralの会社ID。

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

Import Business Central Entityステップは、accounts、generalLedgerEntries、customers、vendors、items、journalsの6つのエンティティに対応しています。各取得では、エンティティごとのサーバー側フィルターを使用できます。フィールドの詳細はImport Business Central Entityステップを参照してください。

generalLedgerEntriesは読み取り専用で、転記済みのもののみを対象とします。未転記の仕訳バッチに残っている明細行は含まれないため、試算表や総勘定元帳の明細を取得する際に使用するエンティティです。

総勘定元帳の仕訳明細行の転記

Business Central Postステップは、既存の仕訳バッチ内に明細行を作成し、PlaidCloudの共通ERP書き込みパイプラインを通じてそのバッチを転記します。転記前にバッチにこのリクエストの明細行のみが含まれていることを検証し、転記は（仕訳バッチ自体ではなく）generalLedgerEntriesに対して確認します。フィールドのリファレンスはBusiness Central: Post General Journal Linesステップを、転記の手順全体はBusiness Centralへの接続を参照してください。

既知の制限事項

制限事項	意味
書き込みのドキュメントタイプは1つのみ	総勘定元帳の仕訳明細行の転記のみに対応しています。下書きドキュメントのフロー（販売/購買請求書、下書き → 転記済み）には対応していません。このフローの転記アクションは、Microsoftの公開ドキュメントでは特定されていないためです。
既存のバッチへの転記のみ	このコネクターは、Business Centralで仕訳バッチを作成することはありません。先にBusiness Central側で作成してください。
同一バッチへの同時転記	冪等性のガードはドキュメント番号単位であり、仕訳バッチ単位ではありません。異なる2つのドキュメント番号が同じバッチへ同時に転記される場合、直列化は保証されません。