Configuration

La page de configuration de ScanConnect se trouve dans Accueil > Configuration > Modules/Applications, en cliquant sur l'icône d'engrenage du module ScanConnect, ou directement via l'URL /custom/scanconnect/admin/setup.php.

Paramètres à renseigner

Trois paramètres sont à fournir pour établir la connexion au serveur OCR.

Adresse du serveur OCR

Champ : Adresse de votre serveur d'OCR.

Par défaut : https://ocr.cap-rel.fr. C'est le serveur OCR public proposé par CAP-REL. Le compte gratuit permet l'analyse de cinq documents par mois.

Si vous disposez de votre propre serveur OCR (déploiement interne, ou serveur d'un partenaire), saisissez son URL ici. L'URL doit toujours être complète, en https://.

Adresse mail

Champ : Adresse mail.

Identifiant de votre compte sur le serveur OCR. Si vous avez déjà un compte (parce que vous utilisiez l'ancien module ScanInvoices, ou que vous avez créé un compte directement sur le site OCR), saisissez l'adresse de ce compte. Sinon, indiquez celle que vous voulez utiliser : le compte sera créé automatiquement à la première connexion.

Mot de passe du webservice

Champ : Mot de passe du webservice (mini 6 caractères).

• Si le compte existe déjà côté serveur OCR, saisissez le mot de passe correspondant.
• Si le compte n'existe pas encore, choisissez un mot de passe : ScanConnect créera le compte avec ce mot de passe lors de la première vérification de connexion.

Attention : ce mot de passe est stocké dans la table llx_const de Dolibarr. Utilisez un mot de passe dédié à ce service, distinct de vos autres mots de passe.

Vérification et activation du compte

Après avoir renseigné les trois paramètres :

1. Cliquez sur Enregistrer.
2. Cliquez sur Vérifier la connexion.

Trois cas se présentent :

Cas 1 : compte existant, mot de passe correct

ScanConnect se connecte au serveur, génère une clé d'API et la stocke en local. La clé d'API remplace ensuite le mot de passe pour toutes les communications avec le serveur OCR. Un message de succès s'affiche : Connexion avec le serveur établie.

Cas 2 : compte inexistant

Le serveur ne trouve pas l'adresse mail dans sa base. ScanConnect tente alors de créer le compte automatiquement avec l'adresse mail et le mot de passe que vous avez indiqués. Si la création réussit, la clé d'API est générée et stockée.

Cas 3 : compte existant, mot de passe incorrect

Le serveur reconnaît l'adresse mail mais refuse le mot de passe. ScanConnect affiche alors un lien Cliquez ici pour réinitialiser votre mot de passe qui ouvre la page de récupération sur le serveur OCR. Une fois le mot de passe réinitialisé, revenez sur la page de configuration de ScanConnect, mettez à jour le champ mot de passe et relancez la vérification.

Migration depuis ScanInvoices

Si votre instance utilisait l'ancien module ScanInvoices, ScanConnect détecte automatiquement les paramètres de l'ancien module à l'activation et les recopie sous les nouveaux noms (SCANINVOICES_* -> SCANCONNECT_*). Vous n'avez rien de spécial à faire : les paramètres sont conservés, et la clé d'API existante est réutilisée.

Modification ultérieure

Vous pouvez revenir sur cette page à tout moment pour changer l'URL, l'adresse mail ou le mot de passe. Toute modification efface la clé d'API stockée et exige une nouvelle vérification de connexion.