Business Centralに接続する

PlaidCloudをBusiness Centralの標準OData v2.0 REST APIに接続すると、ODataを手書きすることなく、勘定科目、元帳エントリ、顧客、仕入先、品目、仕訳帳を取得でき、総勘定元帳の仕訳明細を書き戻すこともできます。このガイドでは、接続、インポートステップ、転記ステップについて説明します。

注意

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

前提条件

Azure ADとBusiness Centralで次のものが必要です。

• PlaidCloud用のEntra ID（Azure AD）アプリ登録とクライアントシークレット。Business CentralへのAPIアクセス許可（Dynamics 365 Business Central > API.ReadWrite.All、または管理者が発行するより限定的なアクセス許可）が付与されている必要があります。
• Azure ADのテナントID。
• PlaidCloudが呼び出すBusiness Central環境の名前（例: Productionまたはサンドボックス環境）。
• PlaidCloudが読み取りと転記を行う会社。Business Centralでは、エンティティの読み取りと仕訳の転記のどちらも、一度に1つの会社に限定されます。

ノート

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

接続を作成する

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

2. メニューからBusiness Centralを選択します。

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

   フィールド	値
   名前	わかりやすい名前（例: BC Prod）。
   クライアントID	Entraアプリ登録のアプリケーション（クライアント）ID。
   クライアントシークレット	アプリ登録のクライアントシークレット。
   テナントID	Azure ADのテナントID。
   環境	Business Central環境の名前（例: Production）。
   会社	読み取りと転記の対象となるBusiness Centralの会社ID。

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

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

1. ワークフローにImport Business Central Entityステップを追加します。

2. Business Central接続に作成した接続を、エンティティタイプにaccountsを、ターゲットテーブルに作業用テーブルを設定します。

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

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

データをインポートする

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

2. エンティティタイプに、取得するレコードとしてaccounts、generalLedgerEntries、customers、vendors、items、journalsのいずれかを設定します。

3. フィルターを追加します。{field, operator, value}の行がANDでリクエストの$filterに結合され、エンティティ自身のクエリ可能フィールドの許可リストに照らしてチェックされます。エンティティ全体を取得するには、空白のままにします。

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

ノート

会社はステップではなく、接続から決まります。 Business Centralはすべての読み取りを1つの会社に限定しており、接続が環境とともにその会社も保持するため、インポートステップには会社や環境のフィールドがありません。同じエンティティを別の会社から取得するには、その会社を指す2つ目のBusiness Central接続を作成してください。

ノート

generalLedgerEntriesは、Business Centralの読み取り専用で、転記済みのみの元帳です。未転記の仕訳帳バッチに残っている明細行は表示されないため、試算表や総勘定元帳の明細を取得するには、仕訳帳を直接クエリするのではなく、このエンティティを使用します。

総勘定元帳の仕訳明細を転記する

Business Central Postステップは、既存の総勘定元帳の仕訳帳バッチに明細行を転記し、そのバッチを転記します。

1. ヘッダーテーブル（journal_idごとに1行）を作成します。明細行の転記先となるBusiness Centralの仕訳帳バッチ名に加えて、document_number、posting_date、通貨ラベルを含めます。

2. 明細テーブル（journal_idごとに1行以上）を作成します。符号付きのamount（借方は正、貸方は負）、account_idまたはaccount_number、account_type、descriptionを含めます。

3. Business Central Postステップを追加し、Business Central接続、環境、ヘッダーテーブル、明細テーブル、結果テーブルを設定します。

4. Validate Onlyをオンのままステップを実行します。PlaidCloudは、何も転記せずに、すべての仕訳を作成してチェックします。

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

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

注意

journal_idで指定する仕訳帳バッチは、Business Centralにすでに存在している必要があります。 このステップはバッチの中に明細行を作成しますが、バッチ自体は作成しません。先にBusiness Centralで仕訳帳バッチ（名前、仕訳帳テンプレート）を設定してから、journal_idでそれを指定してください。

転記の仕組み

Business CentralのMicrosoft.NAV.postアクションは、PlaidCloudが作成した明細行だけでなく、仕訳帳バッチ全体を転記します。そのため、呼び出す前にPlaidCloudはバッチを読み戻し、このリクエストのドキュメント番号が付いていない明細行が含まれている場合は、転記を拒否します（エラーを記録し、何も転記しません）。このガードは、以前の部分的な失敗で残った明細行が、同じバッチへの無関係な後続の転記によって総勘定元帳に紛れ込まないようにするために、特に設けられています。

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

注意

• 書き込めるドキュメントタイプは1つです。 サポートされるのは総勘定元帳の仕訳明細の転記のみです。Business Centralの下書きドキュメントのフロー（売上/購買請求書の下書きから転記済みへの移行）はサポートされません。このフローの正確な転記アクションがMicrosoftのドキュメントで明確にされておらず、PlaidCloudは、資金が動く書き込みについて、検証されていないエンドポイントを推測して使用することはしません。
• 既存のバッチにのみ転記します。 このステップが仕訳帳バッチを作成することはありません。先にBusiness Centralで作成してください（上記を参照）。
• まだ本番での検証は行われていません。 Business Centralの文書化されたOData v2.0コントラクトに基づいて構築されています。最初の本番バッチは検証用の実行として扱い、Business Central上で直接照合してください。
• 同一バッチへの同時転記は完全には直列化されません。 冪等性のガードは、仕訳帳バッチではなくドキュメント番号を単位としているため、異なる2つのドキュメント番号を同じバッチに同時に転記した場合、同じドキュメント番号で2回呼び出した場合のようには直列化されることが保証されません。1つの仕訳帳バッチへの転記を同時に実行しないでください。

関連項目

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