Acumatica 接続：注文と顧客を取り込み、在庫を確認
専用の API ユーザーで Acumatica インスタンスにサインインし、インスタンス URL、会社、エンドポイントのバージョンを Integration に入力、テスト・マッピング・有効化を行います。
Acumatica コネクタは Acumatica Cloud ERP インスタンスを Integration に接続します。販売注文と顧客をシステムに取り込み、Acumatica にある在庫を確認できます。1 つの接続で 1 つの Acumatica 会社に対応します。在庫は Acumatica から読み取れますが、在庫の変更がこの接続経由で Acumatica に書き戻されることはありません。
前提条件#
- サインインできる Acumatica インスタンスと、サインイン時に使う正確な会社（テナント）名。
- この接続用のログインユーザー（専用の API ユーザーを推奨）。その会社で販売注文、顧客、在庫品目を読めることが必要です。
- Acumatica → Web Service Endpoints に公開済みのエンドポイントがあること。標準エンドポイントを公開している場合、名前は通常 Default で、バージョンはお使いの Acumatica リリースに一致します。
- 会社のサインインでブランチが必要な場合は、ブランチ名も把握してください。ブランチを聞かれない場合は、そのフィールドは後で空欄のままにできます。
認証情報の取得#
- このコネクタ用に別途作成するキーはありません。認証情報は Acumatica のログインユーザー自体です。Acumatica で専用の API ユーザーを用意し、そのユーザーでサインインできることを確認して、ユーザー名とパスワードを控えてください。
- サインイン時に表示される会社（テナント）名をそのまま正確に控えてください。ブランチが必要な場合はブランチ名も控えます。これらの値はインスタンスの表記と完全に一致する必要があります。
- インスタンスアドレスを控えてください。Acumatica インスタンスのルートアドレスです。例：https://mycompany.acumatica.com。末尾に /entity を付けないでください。
- Acumatica で Web Service Endpoints を開き、公開済みエンドポイントを確認します。エンドポイント名とエンドポイントのバージョンを控えてください。Default と 24.200.001 と異なる場合のみ、後で入力が必要です。
Integration への入力#
- Integration → コネクタマーケットプレイス → Acumatica → 新規接続を開きます。
- base_url — Instance URL、必須：Acumatica インスタンスのルートアドレスを入力します。例：https://mycompany.acumatica.com。末尾に /entity を付けないでください。
- company — Company、必須：Acumatica へのサインイン時に表示される会社（テナント）名をそのまま入力します。
- branch — Branch、任意：会社のサインインでブランチが必要な場合のみ入力します。ブランチを聞かれない場合は空欄のままにします。
- username — Username、必須：Acumatica で用意した専用 API ユーザーのログイン名を入力します。
- password — Password、必須：同じログインユーザーのパスワードを入力します。暗号化して保存され、再表示されることはありません。
- endpoint_name — Endpoint name、任意：標準エンドポイントを公開している場合は空欄のままにします。その場合システムは Default を使います。Web Service Endpoints に別の名前が表示される場合のみ入力してください。
- endpoint_version — Endpoint version、任意：バージョン 24.200.001 を公開している場合は空欄のままにします。その場合システムは 24.200.001 を使います。異なる場合は Web Service Endpoints に表示される正確なバージョンを入力してください。バージョンはお使いの Acumatica リリースに一致する必要があります。
接続テスト#
接続テストをクリックします。テストは順番に 2 つのことを行います。まず、入力したユーザー名、パスワード、会社、ブランチでインスタンスにサインインします。インスタンスが応答してセッションを返したときだけサインイン成功となり、テストはそのセッションをすぐに使い、最後にサインアウトします。次に、そのセッションで、接続のエンドポイント名とバージョンを使って在庫品目を 1 件読み取ります。通過すれば、サインインが使え、エンドポイントが応答し、ログインユーザーが在庫品目を読めるということです。テストの待ち時間は約 12 秒です。タイムアウトした場合は、インスタンスアドレスにアクセスできるか確認して再試行してください。失敗した場合は、表示される正確なエラーコードを控えてください。下の FAQ で各コードの原因と対処法を確認できます。
Mapping / テンプレート選択#
Acumatica 標準テンプレートを選択します。Acumatica の販売注文を標準注文にマッピングし、顧客も一緒に取り込むので、注文番号、明細、数量、顧客情報が正しいフィールドに入ります。テンプレートが読めるフィールドは、インスタンスに公開されているエンドポイントから決まります。そのため、公開されているエンドポイント名やバージョンが標準と異なる場合は、先に接続で endpoint_name と endpoint_version を設定し、マッピングのプレビューを再確認してください。有効化前にプレビューを開き、実際の注文 1 件で明細と顧客名が正しいか確認してください。在庫確認は在庫品目を直接読むため、注文のマッピングは不要です。
有効化#
有効化後、設定した頻度で Acumatica インスタンスにサインインし、新しい販売注文と顧客を取り込み、Acumatica の在庫品目を読んで在庫の問い合わせに答えます。各サインインセッションはその実行のためだけに使われ、実行終了時に閉じられます。この接続が行わないこと：在庫の変更を Acumatica に書き戻しません。そのため、Acumatica 側で数量を直す必要がある場合は、Acumatica 自体で調整してください。無人で任せる前に、まず Runs / Logs で最初の数件を確認してください。
よくある質問#
テストが ENDPOINT_VERSION_MISMATCH で失敗する — 在庫品目の読み取りが 404 を返す
サインインはできていますが、接続のエンドポイント名またはバージョンが、インスタンスに公開されているエンドポイントと一致していません。テストは指定された名前とバージョンで在庫品目を探しますが、そのアドレスには何も公開されていないため、読み取りが 404 を返します。ログイン自体に問題がない場合、これが最も多い原因です。
Acumatica で Web Service Endpoints を開き、公開済みエンドポイントの名前とバージョンをそのままコピーしてください。接続の endpoint_name と endpoint_version に入力します。公開済みが本当に Default と 24.200.001 の場合は、両フィールドを空にしてください。保存して再テストしてください。
テストが INVALID_CREDENTIALS で失敗する — サインインが 401 または 400 を返す
インスタンスがサインインを拒否しました。ユーザー名、パスワード、会社名のいずれかが、インスタンスが期待する値と一致していません。会社名がサインイン画面の表記と少しでも違うと認証情報の誤りとして扱われます。サインインに必要なブランチを接続で省略した場合も同様です。
まずブラウザで同じユーザーを使って Acumatica にサインインし、ユーザー名、パスワード、会社名がすべて使えることを確認してください。次に、ブラウザで使った表記のまま username、password、company を接続に入力し直し、そのサインインでブランチを聞かれた場合は branch も追加して、再テストしてください。
テストが MISSING_SCOPE で失敗する — 在庫品目の読み取りが 401 または 403 を返す
サインインはでき、エンドポイントも存在しますが、ログインユーザーにその会社で在庫品目を読む権限がありません。そのため、サインインできてもインスタンスは在庫品目の読み取りを拒否します。
Acumatica で、専用 API ユーザーに、その会社で在庫品目を読む権限を与えてください。接続は販売注文と顧客も読むので、それらの権限も併せて付与します。または、すでにその権限を持つユーザーに接続を切り替えてください。保存して再テストしてください。
テストが MISSING_BASE_URL または MISSING_CREDENTIALS で失敗する、あるいはサインインがインスタンスに届かない
必須フィールドが空であるか、インスタンスアドレス自体が間違っています。MISSING_BASE_URL は base_url が空、MISSING_CREDENTIALS は username、company、password のいずれかが不足しているという意味です。アドレスでよくある間違いは、base_url の末尾に /entity を付けることです。接続はルートアドレスの後に自身のパスを追加するため、そのサフィックスが付いたアドレスではサインイン先が間違ってしまいます。
必須フィールド（base_url、company、username、password）をすべて入力し、base_url を確認してください。インスタンスのルートアドレスだけを使い、例：https://mycompany.acumatica.com のように、後に何も付けません。保存して再テストしてください。