Acumaticaに接続する

PlaidCloudをAcumaticaのコントラクトベースREST APIに接続すると、ODataを手書きすることなく参照データやトランザクションデータを取得でき、仕訳トランザクション、売上請求書、請求、支払を書き戻すこともできます。このガイドでは、接続、インポートステップ、転記ステップについて説明します。

注意

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

前提条件

Acumaticaで次のものが必要です。

• インスタンスのベースURL（例: https://yourcompany.acumatica.com）。
• 会社名（PlaidCloudがログインする正確な会社ID）。ブランチを使用する場合は、転記先のブランチ。
• PlaidCloud専用のユーザー名とパスワード。読み取るエンティティと転記先のドキュメント画面にアクセスできるロールが必要です。
• そのユーザーに対して有効化されたコントラクトベースREST APIへのアクセス（System > Integration Preferences。現在のAcumaticaのバージョンではデフォルトでオンです）。

ノート

AcumaticaのコントラクトベースREST APIは、トークンベースではなくセッションベースです。PlaidCloudは、呼び出しのたびに認証するのではなく、一定の作業単位（1回のインポート取得、1回の転記バッチ）ごとに1度ログインし、完了時にログアウトします。Acumaticaのトライアルや下位ティアのライセンスでは、同時APIセッション数が最小2に制限される場合があるため、同じ接続に対して多数のAcumaticaステップを並列に実行することは避けてください。

接続を作成する

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

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

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

   フィールド	値
   名前	わかりやすい名前（例: Acumatica Prod）。
   インスタンスのベースURL	インスタンスのURL（例: https://yourcompany.acumatica.com）。
   エンドポイント名	コントラクトエンドポイント名。カスタムエンドポイントを公開していない限りDefaultです。
   エンドポイントのバージョン	任意（例: 25.200.001）。空白のままにすると、エンドポイントの公開済み最新バージョンを使用します。
   会社/テナント	Acumaticaの正確な会社ID。
   ブランチ	任意。空白のままにすると、ログインユーザーのデフォルトのブランチを使用します。
   ユーザー名	PlaidCloud用のAPIユーザー。
   パスワード	PlaidCloud用のAPIユーザーのパスワード。

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

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

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

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

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

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

データをインポートする

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

2. エンティティタイプに、取得するレコードを設定します。マスターデータと参照リストはaccount、subaccount、ledger、financial_period、branch、currency、currency_rate、customer、vendor、stock_item、warehouse、employee、tax_category、project、トランザクションのエンティティはsales_invoice、bill、sales_order、shipmentです。

3. Activeフラグを持つエンティティについて、アクティブなレコードのみを取得するには、アクティブのみをオンのままにします。

4. 更新日時以降にISO形式の日付または日時を設定すると、それ以降に変更された行のみを取得します（リクエスト側のフィルターであり、永続化される増分カーソルではありません。実行のたびに基準日時を指定します）。

5. 大量の取得を絞り込むにはフィルターを追加します。各フィルターは、{field, operator, value}句（eq、ne、gt、ge、lt、le、contains）または{field, from, to}の範囲で、エンティティごとに、Acumaticaがサーバー側で実際にフィルターできるフィールドに限られます。PlaidCloudは、そのエンティティがサポートしないフィルターフィールドを黙って破棄せず、拒否します。

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

ノート

試算表、総勘定元帳のトランザクション明細、手持在庫、予算、会社間データは、上記のコントラクトベースのエンティティではなく、AcumaticaのGeneric Inquiryの背後にあり、PlaidCloudはGeneric Inquiryを生成しません。これらが必要な場合は、AcumaticaでGeneric Inquiryを作成し、代わりにGeneric REST接続で取得してください。

ドキュメントを転記する

Acumatica Postステップは、すべてのERP転記ステップが使用する共通の書き込みパイプラインを通じて、JournalTransaction、SalesInvoice、Bill、Paymentの4種類のドキュメントを転記します。

1. ヘッダーテーブル（ドキュメントごとに1行）を作成します。列はref（ドキュメントの識別子）、doc_type（JournalTransaction、SalesInvoice、Bill、Paymentのいずれか）、posting_date、party_id（ドキュメントタイプに必要な場合の顧客/仕入先）、memo、due_date、branch_idです。1つのバッチに複数のドキュメントタイプを混在させることができ、PlaidCloudは転記前にdoc_typeで分割します。

2. ドキュメントタイプに合わせた明細テーブル（refごとに1行以上）を作成します。

   ドキュメントタイプ	明細列
   JournalTransaction	account, subaccount, branch, debit, credit
   SalesInvoice	item, qty, unit_price, amount
   Bill	account, amount
   Payment	linked_txn_id, amount

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

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

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

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

転記の仕組み

Acumaticaはすべてのドキュメントを保留状態で作成し、その後PlaidCloudがリリースアクションを呼び出します。このアクションは非同期で実行されます（202レスポンスを返し、完了までポーリングした後、204でリリースが確認されます）。PlaidCloudは、リリースが確認された場合にのみドキュメントをpostedとして報告します。登録はされたもののリリースが確認されないドキュメントは、転記済みとして記録されず隔離されたままになるため、保留のままで止まっているものが黙って成功として扱われることはありません。

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

注意

• ネイティブの冪等性キーがありません。 AcumaticaのWrite APIにはドキュメントごとの冪等性フィールドがないため、再試行または再実行されたバッチでの二重転記を防ぐ唯一の手段は、PlaidCloud独自の台帳請求です。同じドキュメントを別の方法で転記して、このステップの台帳を迂回しないでください。
• 取消は手動です。 AcumaticaのコントラクトベースのAPIには、どのドキュメントタイプについても文書化された無効化/取消アクションがなく、PlaidCloudがそれを偽装することもありません。転記済みのドキュメントを、このステップから取り消すことはできません。誤って転記したドキュメントは、Acumatica上で直接修正してください。
• Paymentには確実な検索手段がありません。 Acumaticaには、曖昧な結果（タイムアウトや応答の欠落）の後でPaymentをPlaidCloudのリクエストと突き合わせるための、文書化されたフィールドがありません。判断のつかないPaymentは推測せずに隔離されるため、Acumaticaで直接確認して解決してください。
• 明細行レベルのコストセンターによるフィルターはサーバー側では行われません。 Acumaticaの$filterはドキュメントの明細行のディメンションには届かないため、ヘッダー/エンティティのレベルでフィルターし、明細行レベルの絞り込みは取得後にワークフロー内で行ってください。

関連項目

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