ユーザーマニュアル

ヘルプセンター/ユーザーマニュアル/Fishbowl 接続：販売注文と発注を取り込み、在庫を確認

Fishbowl 接続：販売注文と発注を取り込み、在庫を確認

最終更新 2026-11-01

Integration を自社の Fishbowl Server のアドレスに向け、Fishbowl のユーザー名とパスワードでログインし、Fishbowl クライアントの Settings → Integrated Apps で統合アプリを 1 回承認してから、テスト・マッピング・有効化を行います。

Fishbowl コネクタは、お客様自身が運用する Fishbowl Server に接続し、Fishbowl Advanced の販売注文と発注をこのシステムに取り込み、品番で在庫を確認できます。範囲はこれだけです：顧客の取り込みや送信は行わず、在庫その他のレコードを Fishbowl に返送することもありません。サーバーはお客様のものなので、このシステムから到達可能でなければなりません。ローカルネットワーク内でのみ応答し、パブリックまたは VPN の経路がないサーバーは接続できません。

Fishbowl 接続手順：到達可能性の確認、初回ログイン後のアプリ承認、実際のログインテスト、Mapping、有効化。

前提条件#

このシステムからアドレスに到達できる、稼働中の Fishbowl Server（Fishbowl Advanced）。サーバーのアドレスはパブリック経路または VPN 経由で到達可能でなければなりません。アドレスがローカルネットワーク内でのみ機能する場合は、先に経路を直してください。閉じた経路越しには、どの認証情報でも接続できません。
サーバーの Web アドレスとポート（例：http://192.168.1.10:80）。80 は通常の Web ポートです。そのマシンで 80 がすでに使用中の場合、Fishbowl は代わりに 2456 を使います。サーバーがどのポートで応答するか確認してください。
ログインに使う Fishbowl のユーザー名とパスワード。この接続には Fishbowl 内の専用統合アカウントを使ってください。ログインを認識しやすく、パスワードを個人アカウントとは別に管理できます。
Fishbowl クライアントにアクセスでき、初回ログイン後に Settings → Integrated Apps を開いてこの統合アプリを承認できること。その 1 回の承認がないと、他の値がすべて正しくてもテストは 403 を返します。

認証情報の取得#

Fishbowl にはクラウドポータルも生成するキーもありません。認証情報は、接続がログインに使うアカウントの Fishbowl ユーザー名とパスワードそのものです。まだない場合は、先に Fishbowl で専用の統合ユーザーを作成してください。
Fishbowl Server のアドレスを、入力手順で必要な形式で控えます（例：http://192.168.1.10:80）。サーバーが応答するアドレスとポートそのもので、そのマシンでポート 80 が使用中の場合は 80 の代わりに 2456 を使います。
統合アプリ名を今決めてください。他に使用中の名前がなければ Docklify Integration です。この名前が、初回ログイン後に Fishbowl クライアントの Settings → Integrated Apps に表示され、そこで承認する対象となります。
App ID は初回設定では脇に置いてください。App ID は、管理者が Integrated Apps で承認済みアプリに数値 ID を割り当てた場合にのみ存在します。まだ割り当てられていない場合は、探すものはありません。

Integration への入力#

Integration → コネクタマーケットプレイス → Fishbowl → 新規接続を開きます。
server_url、必須、Fishbowl サーバー URL：Fishbowl Server のアドレス（例：http://192.168.1.10:80）を入力します。そのマシンでポート 80 が使用中の場合は、80 の代わりに 2456 を使います。アドレスはパブリック経路または VPN 経由でこのシステムから到達可能でなければなりません。
username、必須、Fishbowl ユーザー名：統合用 Fishbowl アカウントのユーザー名を入力します。専用の統合アカウントが望ましいです。
password、必須、Fishbowl パスワード：同じ Fishbowl アカウントのパスワードを入力します。パスワード型のフィールドで、秘密情報として保存されます。
app_name、必須、統合アプリ名：認証情報の手順で決めた名前（例：Docklify Integration）を入力します。初回ログイン後、この名前は Fishbowl クライアントの Settings → Integrated Apps に表示され、そこで承認します。
app_id、任意、App ID：初回設定では空のままにします。管理者が Integrated Apps で承認済みアプリに数値 ID を割り当て、それが渡された場合にのみ入力してください。
次に、正しい順序で承認手順を行います：接続を保存して接続テストを 1 回実行し、初回ログインでアプリを登録させます。Fishbowl クライアント → Settings → Integrated Apps を開き、app_name の項目を見つけて承認し、戻って再テストします。承認は Integration ではなく Fishbowl クライアントで行います。

接続テスト#

接続テストをクリックします。テストは実際のログインを行います：appName、appId、username、password を Fishbowl Server の POST {server_url}/api/login に送信し、ログイントークンが返れば合格となります。結果には応答したサーバーが表示されます。ログイン成功直後、テストはログアウトします。server_url が未入力の場合、テストは MISSING_SERVER_URL で止まります。他の必須フィールドが未入力の場合は、対応する未入力エラーで止まります。401 はユーザー名またはパスワードが拒否されたことを意味します。403 は MISSING_SCOPE として返され、統合アプリが Settings → Integrated Apps でまだ承認されていない可能性があることを意味します。ログインは 12 秒でタイムアウトします。

Mapping / テンプレート選択#

Fishbowl 標準の Mapping を選択します。Fishbowl の標準形式の販売注文と発注、および品番による在庫確認に対応します。テスト合格後、1 回取得を実行し、実販売注文を並べて確認してください（注文番号、明細、数量）。発注 1 件も同様に確認し、品番 1 件の在庫を Fishbowl の表示と照合してから有効化します。

Fishbowl のデータフロー：ログイン、販売注文と発注の取り込み、品番による在庫読み取り、ログアウト。

有効化#

有効化後、接続は設定した頻度で Fishbowl Server にログインし、販売注文と発注をこのシステムに取り込み、在庫確認時には品番で数量を読み取ります。最初は Runs / Logs で取得を確認し、Fishbowl と照合してから無人運用に移してください。サーバーのアドレスや経路が後で変わった場合は、server_url を更新して再テストしてください。

この接続が行わないこと：顧客の取り込みや送信は行わず、在庫・注文その他のレコードを Fishbowl に返送することもありません。それらのレコードは引き続き Fishbowl で管理され、この接続は Fishbowl から注文と在庫を読み取ります。

よくある質問#

テストが 403 / MISSING_SCOPE で失敗する — 統合アプリが未承認

この接続では 403 には 1 つの特定の意味があります：統合アプリが Fishbowl クライアントの Settings → Integrated Apps でまだ承認されていない可能性があります。サーバーはログインを受け取りましたが、app_name で指定されたアプリが未承認のため、ログインを進められません。

Fishbowl クライアント → Settings → Integrated Apps を開き、app_name と同じ名前の項目を見つけて承認してください。その後、Integration で同じ値のまま接続テストを再実行します。他のフィールドを変更する必要はありません。

テストが 401 で失敗する — ユーザー名またはパスワードが拒否

サーバーは応答し、アプリの確認も通過しましたが、Fishbowl のログイン自体が拒否されました：ユーザー名とパスワードの組み合わせがそのサーバー上のアカウントと一致しないか、パスワードの入力に過不足があります。

同じユーザー名とパスワードで Fishbowl クライアントに自分でログインし、機能することを確認してください。専用の統合アカウントが望ましいです。その後、Integration で username を再入力し、password を貼り直して再テストしてください。

テストが MISSING_SERVER_URL または他の未入力エラーで止まる

必須フィールドが空のため、ログインは試行されませんでした。MISSING_SERVER_URL は server_url が空であることを具体的に意味します。他の未入力エラーは、username、password、app_name のうち空のフィールドを名指しします。app_id は任意であり、この停止の原因になることはありません。

Integration への入力の手順に従って、指摘されたフィールドを入力してください（server_url はポートを含むサーバーの完全なアドレス）。app_id は管理者が割り当てていない限り空のままにし、保存して再テストします。

テストがタイムアウトする — サーバーにまったく到達できない

ログインが 12 秒以内に応答を受け取りませんでした。自前運用サーバーで通常の原因は到達可能性です：server_url のアドレスがローカルネットワーク内でのみ応答し、このシステムからパブリックまたは VPN の経路がないか、アドレスのポートがサーバーの応答ポートではありません。確認すべきは 80 と 2456 の 2 つです。

まず Fishbowl Server が稼働していることを確認し、応答する正確なアドレスとポートを記録してください。次に、そのアドレスにローカルネットワーク外からパブリック経路または VPN 経由で到達できるようにし、server_url を正確に一致させて更新し、再テストします。ユーザー名やパスワードを変更してもタイムアウトは直りません。

初回設定の前に App ID はどこで見つかりますか？

どこにもありません。初回設定では通常まだ存在しません。App ID は、アプリが Settings → Integrated Apps で承認された後に、管理者が割り当てることのある数値 ID です。承認前に探すのは、まだ作成されていないものを探すことになります。

app_id は空のままにして、先に設定と承認を完了してください。管理者が後で App ID を割り当てて渡した場合にのみ、接続を編集し、その番号を app_id に入力して保存し、再テストします。

接続済みだが顧客が取り込まれず、何も書き戻されない

これはこの接続の能力の境界であり、障害ではありません：販売注文と発注を取り込み、品番で在庫を読み取ります。顧客レコードはどちらの方向にも含まれず、いかなるレコードも Fishbowl に返送されません。

顧客と在庫の変更は引き続き Fishbowl 自体で管理してください。この接続は注文フローに使います。Runs / Logs で取り込まれた販売注文または発注を確認し、接続がその役割を果たしているか確かめてください。