Utilisation

ScanConnect est un module pivot : il n'a pas d'interface utilisateur propre en dehors de sa page de configuration. Son rôle est de fournir une connexion configurée au serveur OCR aux autres modules CAP-REL (ScanExpenses, ScanPay, ScanBank).

Vérifier que la connexion fonctionne

À tout moment, retournez dans Accueil > Configuration > Modules/Applications, cliquez sur l'engrenage du module ScanConnect, puis sur le bouton Vérifier la connexion.

Trois statuts possibles :

• Connexion avec le serveur établie : tout va bien, votre clé d'API est valide et le serveur répond.
• Erreur de vérification de la connexion : le serveur a refusé la requête. Vérifiez vos paramètres (URL, mail, mot de passe) puis relancez la vérification.
• Mise à jour du serveur en cours : le serveur OCR est temporairement indisponible. Patientez quelques minutes et réessayez.

Que se passe-t-il en arrière-plan ?

Quand un module dépendant (par exemple ScanExpenses) traite un PDF :

1. Il appelle ScanConnect en lui passant le fichier.
2. ScanConnect ouvre une connexion HTTPS vers le serveur OCR avec votre clé d'API.
3. Le PDF est envoyé au serveur, qui exécute l'OCR et renvoie les données extraites au format JSON.
4. ScanConnect transmet ces données au module appelant, qui les utilise pour pré-remplir une facture, une note de frais, ou autre.

Vous n'avez rien à faire manuellement : c'est entièrement transparent pour l'utilisateur final.

Quota et abonnement

Le compte gratuit sur ocr.cap-rel.fr permet cinq analyses par mois. Au-delà, il faut souscrire un abonnement payant.

Pour vérifier votre quota ou souscrire :

• Visitez la page tarifs : https://ocr.cap-rel.fr/tarifs.
• Connectez-vous avec votre adresse mail et votre mot de passe (les mêmes que dans la page de configuration de ScanConnect).

Si vous atteignez le quota, les modules dépendants reçoivent une erreur du serveur et l'utilisateur est invité à vérifier son abonnement.

Erreurs de protocole

Le module ScanConnect et le serveur OCR partagent un numéro de protocole (actuellement 1). Si le serveur évolue vers une nouvelle version du protocole, le module installé localement peut devenir incompatible. Dans ce cas, la vérification de connexion affiche le message :

La version de votre plugin n'est pas en mesure de communiquer avec le serveur (erreur de protocole), veuillez mettre à jour votre plugin.

Suivez le lien proposé pour télécharger la dernière version du module et installez-la en suivant la procédure de mise à jour.

Utilisation par les modules dépendants

Reportez-vous à la documentation spécifique de chaque module utilisateur :

• ScanExpenses pour les notes de frais.
• ScanPay pour les paiements.
• ScanBank pour les relevés bancaires.

Ces modules détectent automatiquement la présence de ScanConnect et affichent les fonctionnalités d'analyse OCR uniquement si la connexion est valide.