Acumatica RESTコネクター

APIドキュメント

AcumaticaのコントラクトベースREST APIに、このコネクターが使用するエンドポイントとクエリオプションが記載されています。

認証の仕組み

この接続はセッションベースです。PlaidCloudは、処理の区切りとなる単位ごとに1回ログインし（ユーザー名、パスワード、会社、任意のブランチを指定してPOST <instance>/entity/auth/login）、その単位内のすべての呼び出しで得られたセッションCookieを再利用し、完了時にログアウトします。ベアラートークンやOAuthのフローではありません。セッションはAcumaticaライセンスの同時セッション数の上限にカウントされ、トライアルや下位ティアのインスタンスでは上限が2程度に制限される場合があります。そのため、1つの接続で多数のAcumaticaステップを並列実行することは避けてください。

設定

フィールド	タイプ	説明
名前	テキスト	この接続の表示名。
インスタンスのベースURL	テキスト	AcumaticaインスタンスのURL（例：`https://yourcompany.acumatica.com`）。
エンドポイント名	テキスト	コントラクトエンドポイント名。カスタムエンドポイントを公開していない限り`Default`です。
エンドポイントのバージョン	テキスト	任意（例：`25.200.001`）。空白のままにすると、エンドポイントの最新の公開バージョンを使用します。
会社/テナント	テキスト	この接続がログインするAcumaticaの会社IDそのもの。
ブランチ	テキスト	任意。空白のままにすると、ログインユーザーのデフォルトブランチを使用します。
ユーザー名	テキスト	PlaidCloud APIユーザーのログイン名。
パスワード	テキスト	PlaidCloud APIユーザーのパスワード。暗号化して保存されます。

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

Import Acumatica Entityステップは、コントラクトベースの18のエンティティに対応しています。

マスターデータと参照データ — account、subaccount、ledger、financial_period、branch、currency、currency_rate、customer、vendor、stock_item、warehouse、employee、tax_category、project

トランザクションデータ — sales_invoice、bill、sales_order、shipment

各取得では、Active Onlyトグル、Updated Afterのカットオフ、エンティティごとのサーバー側フィルターを使用できます。フィールドの詳細はImport Acumatica Entityステップを参照してください。

ドキュメントの転記

Acumatica Postステップは、PlaidCloudの共通ERP書き込みパイプラインを通じて、JournalTransaction、SalesInvoice、Bill、Paymentの各ドキュメントを転記します。保留状態で作成し、リリース（非同期アクション）し、リリースを確認してからドキュメントを転記済みとして報告します。フィールドのリファレンスはAcumatica: Post Documentsステップを、転記の手順全体はAcumaticaへの接続を参照してください。

既知の制限事項

制限事項	意味
GIに依存する読み取りは対象外	試算表、総勘定元帳のトランザクション明細、手持在庫、予算、会社間データは、上記18のコントラクトベースのエンティティではなく、AcumaticaのGeneric Inquiryの背後にあります。Acumaticaでそのインクワイアリを作成し、汎用REST接続で取得してください。
書き込みにネイティブの冪等性キーがない	AcumaticaのPUTベースの書き込みAPIには冪等性フィールドがありません。二重転記に対する唯一の防御策は、PlaidCloud自身の台帳による確保です。
取り消しは手動	無効化や取り消しのアクションが文書化されているドキュメントタイプはありません。転記済みのドキュメントはPlaidCloudから取り消せません。Acumatica上で直接訂正してください。
支払の突合フィールドがない	Acumaticaには、結果が不明確になった後に支払をPlaidCloudのリクエストと突き合わせるための、文書化されたフィールドがありません。結果が不明な支払は隔離され、手動で解決します。
明細のフィルタリングはサーバー側では行われない	`$filter`形式のフィルターはエンティティとヘッダーのフィールドには適用されますが、ドキュメントの明細ディメンション（たとえば明細レベルのコストセンター）には適用されません。取得後にワークフロー内で明細を絞り込んでください。