Connecter Fishbowl : recevoir commandes de vente et d’achat, consulter le stock

Pointez Integration vers l’adresse de votre propre Fishbowl Server, connectez-vous avec un nom d’utilisateur et un mot de passe Fishbowl, approuvez l’application d’intégration une fois sous Settings → Integrated Apps dans le client Fishbowl, puis testez, mappez, activez.

Le connecteur Fishbowl se connecte au Fishbowl Server que vous exploitez vous-même et importe les commandes de vente et les commandes d’achat de Fishbowl Advanced dans ce système, et peut consulter le stock par référence de pièce. C’est tout le périmètre : il n’importe ni n’envoie de clients, et ne renvoie ni le stock ni aucun autre enregistrement vers Fishbowl. Comme le serveur est le vôtre, il doit être joignable depuis ce système : un serveur qui ne répond que dans votre réseau local, sans route publique ni VPN jusqu’à lui, ne peut pas être connecté.

Prérequis#

• Un Fishbowl Server (Fishbowl Advanced) en fonctionnement dont l’adresse est joignable depuis ce système. L’adresse du serveur doit être joignable par une route publique ou un VPN : si l’adresse ne fonctionne que dans votre réseau local, corrigez d’abord la route ; aucun identifiant ne connectera à travers une route fermée.
• L’adresse web du serveur et le port, par ex. http://192.168.1.10:80. Le port 80 est le port web habituel ; si 80 est déjà utilisé sur cette machine, Fishbowl utilise 2456 à la place : confirmez sur quel port votre serveur répond.
• Un nom d’utilisateur et un mot de passe Fishbowl pour se connecter. Utilisez un compte d’intégration dédié dans Fishbowl pour cette connexion, afin que ses connexions soient faciles à reconnaître et que son mot de passe se gère séparément des comptes personnels.
• Un accès au client Fishbowl, pour qu’après la première connexion vous puissiez ouvrir Settings → Integrated Apps et approuver cette application d’intégration. Sans cette unique approbation, le test répond 403, même si toutes les autres valeurs sont correctes.

Obtenir les identifiants#

1. Il n’y a ni portail cloud ni clé à générer pour Fishbowl. Les identifiants sont simplement le nom d’utilisateur et le mot de passe Fishbowl du compte avec lequel la connexion se connecte : créez d’abord un utilisateur d’intégration dédié dans Fishbowl si vous n’en avez pas.
2. Notez l’adresse du Fishbowl Server sous la forme demandée à l’étape de saisie, par ex. http://192.168.1.10:80 — la même adresse et le même port que ceux auxquels le serveur répond, avec 2456 au lieu de 80 si le port 80 est déjà utilisé sur cette machine.
3. Décidez dès maintenant du nom de l’application d’intégration : Docklify Integration, sauf si vous en utilisez déjà un autre. Ce nom est celui qui apparaît dans le client Fishbowl sous Settings → Integrated Apps après la première connexion, et c’est l’entrée que vous y approuverez.
4. Laissez l’App ID de côté pour la première configuration. Un App ID n’existe que si un administrateur attribue un ID numérique à l’application approuvée dans Integrated Apps : si ce n’est pas encore fait, il n’y a rien à chercher pour le moment.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → Fishbowl → Nouvelle connexion.
2. server_url, obligatoire, Fishbowl server URL : l’adresse de votre Fishbowl Server, par ex. http://192.168.1.10:80. Utilisez le port 2456 au lieu de 80 si le port 80 est occupé sur cette machine. L’adresse doit être joignable depuis ce système par une route publique ou un VPN.
3. username, obligatoire, Fishbowl username : le nom d’utilisateur du compte Fishbowl pour l’intégration, idéalement un compte d’intégration dédié.
4. password, obligatoire, Fishbowl password : le mot de passe de ce même compte Fishbowl. C’est un champ de type mot de passe, conservé comme secret.
5. app_name, obligatoire, Integration app name : le nom décidé à l’étape des identifiants, par ex. Docklify Integration. Après la première connexion, ce nom apparaît dans le client Fishbowl sous Settings → Integrated Apps, où vous l’approuvez.
6. app_id, facultatif, App ID : laissez-le vide lors de la première configuration. Ne le remplissez que si un administrateur a attribué un ID numérique à l’application approuvée dans Integrated Apps et vous l’a communiqué.
7. Faites ensuite l’étape d’approbation dans le bon ordre : enregistrez la connexion et lancez Tester la connexion une fois pour que la première connexion enregistre l’application, ouvrez le client Fishbowl → Settings → Integrated Apps, trouvez l’entrée portant votre app_name et approuvez-la, puis revenez tester. L’approbation se fait dans le client Fishbowl, pas dans Integration.

Tester la connexion#

Cliquez sur Tester la connexion. Le test effectue une vraie connexion : il envoie votre appName, appId, username et password à POST {server_url}/api/login sur votre Fishbowl Server, et un token de connexion renvoyé compte comme un succès — le résultat indique quel serveur a répondu. Juste après une connexion réussie, le test se déconnecte. Si server_url manque, le test s’arrête avec MISSING_SERVER_URL ; si un autre champ obligatoire manque, il s’arrête avec l’erreur de champ manquant correspondante. Un 401 signifie que le nom d’utilisateur ou le mot de passe a été refusé. Un 403 est renvoyé comme MISSING_SCOPE et signifie que l’application d’intégration n’est peut-être pas encore approuvée dans Settings → Integrated Apps. La connexion expire après 12 secondes.

Mapping / choisir un modèle#

Choisissez le mapping standard Fishbowl. Il couvre les commandes de vente et les commandes d’achat dans leur forme standard Fishbowl, et les consultations de stock par référence de pièce. Après un test réussi, lancez une extraction et comparez une commande de vente réelle côte à côte (numéro, lignes et quantités), faites de même pour une commande d’achat, et comparez le stock d’une référence avec ce qu’affiche Fishbowl, avant d’activer.

Activer#

Après activation, la connexion se connecte à votre Fishbowl Server selon la fréquence définie, importe les commandes de vente et les commandes d’achat dans ce système, et lit le stock par référence lors des consultations. Surveillez les premières extractions dans Runs / Logs et comparez-les avec Fishbowl avant de laisser la connexion sans surveillance — et si l’adresse du serveur ou la route change ensuite, mettez à jour server_url et retestez.

Ce que cette connexion ne fait pas : elle n’importe ni n’envoie de clients, et ne renvoie ni le stock, ni les commandes, ni aucun autre enregistrement vers Fishbowl. Fishbowl reste l’endroit où ces enregistrements sont gérés ; cette connexion y lit les commandes et le stock.

FAQ#

Le test échoue avec 403 / MISSING_SCOPE — application d’intégration non approuvée

Dans cette connexion, 403 a un sens précis : l’application d’intégration n’est peut-être pas encore approuvée dans Settings → Integrated Apps dans le client Fishbowl. Le serveur a reçu la connexion, mais l’application désignée par votre app_name n’a pas encore été approuvée, donc la connexion ne peut pas continuer.

Ouvrez le client Fishbowl → Settings → Integrated Apps, trouvez l’entrée portant le même nom que votre app_name et approuvez-la. Puis relancez Tester la connexion dans Integration avec les mêmes valeurs — aucun autre champ n’a besoin de changer.

Le test échoue avec 401 — nom d’utilisateur ou mot de passe refusé

Le serveur a répondu et le contrôle de l’application est passé, mais la connexion Fishbowl elle-même a été refusée : le couple nom d’utilisateur et mot de passe ne correspond à aucun compte sur ce serveur, ou le mot de passe a été saisi avec un caractère en trop ou en moins.

Connectez-vous vous-même au client Fishbowl avec le même nom d’utilisateur et mot de passe pour confirmer qu’ils fonctionnent, de préférence avec le compte d’intégration dédié. Puis ressaisissez username et recollez password dans Integration et retestez.

Le test s’arrête avec MISSING_SERVER_URL ou une autre erreur de champ manquant

Un champ obligatoire est vide, donc aucune connexion n’a été tentée. MISSING_SERVER_URL signifie précisément que server_url est vide ; les autres erreurs de champ manquant nomment le champ vide parmi username, password et app_name. app_id est facultatif et ne cause jamais cet arrêt.

Remplissez le champ indiqué selon l’étape de saisie dans Integration — server_url avec l’adresse complète du serveur, port inclus — laissez app_id vide sauf si un administrateur en a attribué un, enregistrez, puis retestez.

Le test expire — le serveur est totalement injoignable

La connexion n’a reçu aucune réponse en 12 secondes. Avec un serveur auto-hébergé, la raison habituelle est la joignabilité : l’adresse dans server_url ne répond que dans votre réseau local et il n’y a pas de route publique ni VPN depuis ce système jusqu’à elle, ou le port de l’adresse n’est pas celui auquel le serveur répond — 80 et 2456 sont les deux à vérifier.

Confirmez d’abord que le Fishbowl Server fonctionne et notez l’adresse et le port exacts auxquels il répond. Rendez ensuite cette adresse joignable depuis l’extérieur de votre réseau local par une route publique ou un VPN, mettez à jour server_url pour qu’il corresponde exactement, puis retestez. Changer le nom d’utilisateur ou le mot de passe ne corrigera pas une expiration.

Où trouver l’App ID avant la première configuration ?

Nulle part — lors d’une première configuration, il n’existe normalement pas encore. Un App ID est un ID numérique qu’un administrateur peut attribuer à l’application après son approbation dans Settings → Integrated Apps : le chercher avant l’approbation, c’est chercher quelque chose qui n’a pas encore été créé.

Laissez app_id vide et terminez d’abord la configuration et l’approbation. Ce n’est que si un administrateur attribue ensuite un App ID et vous le communique qu’il faut modifier la connexion, remplir app_id avec ce numéro, enregistrer et retester.

Connecté, mais aucun client n’arrive et rien n’est réécrit

C’est la limite de cette connexion, pas un échec : elle importe les commandes de vente et les commandes d’achat et lit le stock par référence. Les fiches clients n’en font partie dans aucun sens, et aucun enregistrement d’aucune sorte n’est renvoyé vers Fishbowl.

Continuez à gérer les clients et les changements de stock dans Fishbowl même. Utilisez cette connexion pour le flux de commandes : vérifiez une commande de vente ou d’achat importée dans Runs / Logs pour confirmer que la connexion fait sa part.