Un guide étape par étape pour télécharger votre facture sur Odoo à l'aide de l'API Eden AI

Dans cet article, nous allons vous montrer comment intégrer les IA d'Eden API d'analyse de factures dans un module Odoo pour vous aider à rationaliser vos opérations financières et à libérer du temps pour des tâches plus importantes. Le même processus s'applique si vous souhaitez inclure d'autres fonctionnalités telles que : Balisage des images, Détection de contenu explicite, Analyse de texte et de nombreuses autres API d'IA que nous proposons.

‍Pour le tutoriel, il est important que le serveur Odoo soit opérationnel sur votre machine.

‍

Développez l'IA sur Odoo avec Eden AI

Eden AI a été créé pour les non-codeurs qui ont des difficultés à choisir le bon fournisseur d'IA et/ou à intégrer plusieurs API. La gestion de plusieurs comptes pour chaque application peut être une tâche difficile, mais avec Eden AI, vous pouvez connecter et gérer toutes vos API sur un seul compte.

Certains fournisseurs d'IA pouvant être complexes à utiliser, nous voulions simplifier la partie « sans code » et mettre l'IA à la disposition du plus grand nombre de personnes possible.

Eden AI vous permet de résoudre plusieurs tâches d'IA sur Odoo :

• Analyse syntaxique des documents: extraction de texte à partir d'images et analyse syntaxique d'une facture, reçu ou reprendre pour extraire des données
• Vision par ordinateur : détecter visages, objets, logos, contenu explicite, etc.
• Analyse de texte : analyse des sentiments, extraction de mots clés, résumé, etc.
• ‍Traduction automatique
• ‍Reconnaissance vocale & Génération vocale

‍

‍

Pratiquons avec Analyse des factures!

‍Tout comme Reçu et CV Parsing, Invoice Parsing est un outil développé par OCR pour extraire et numériser des données pertinentes, Vision par ordinateur pour identifier la structure du document, et PNL techniques pour délimiter les champs. La technologie d'analyse des factures extrait les informations clés d'une facture (format .pdf, .png ou .jpg) telles que le numéro de la facture, le montant total dû, la date de la facture, le nom du client, etc.

‍

Le traitement des factures implique la nécessité de disposer de logiciels et de technologies pour automatiser le traitement et la gestion des factures. Il comprend des tâches telles que la saisie des données de facturation, leur validation par rapport aux bons de commande et leur acheminement pour approbation, paiement et archivage. L'objectif de l'IA dans le traitement des factures est d'améliorer l'efficacité, la précision et la rapidité du traitement des factures sans aucune intervention humaine.

‍

‍

Comment intégrer l'analyse des factures à votre application à l'aide d'Odoo ?

‍

Étape 1 Créez un compte Eden AI

Commencez par connexion à Eden AI! Vous n'avez pas de compte ? Ne vous inquiétez pas, nous vous offrons 10$ lors de votre inscription. Une fois que vous y êtes, un monde de possibilités s'ouvre à vous, notamment l'intégration à des plateformes telles que Salesforce.

‍

‍

Étape 2 : Activez votre module de facturation

Tout d'abord, vous devez activer le module de facturation (nom technique : « compte »). Si vous ne le trouvez pas dans le menu, tapez « Facturation » dans la barre de recherche ci-dessus :

‍

Une fois votre module de facturation activé, vous devrez le personnaliser (ou l'étendre) afin d'utiliser l'API de l'analyseur Eden Invoice.

‍

Étape 3 : étendre votre module de facturation

Ajoutez un module appelé « invoice_parsing » à vos modules complémentaires personnalisés et assurez-vous de configurer la bonne structure de dossiers. Cela devrait suffire pour le moment.

‍

Ajoutez également les informations pertinentes dans votre manifest.py fichier :

‍

Vous devez maintenant activer votre nouveau module personnalisé :

‍

‍Remarque : vous devrez supprimer le filtre « Applications » dans la barre de recherche car nous avons défini « application » sur False dans le manifest.py dossier.

‍

Étape 4 : Hériter du modèle et de la vue de facturation

Reportez-vous à la structure de dossiers partagée ci-dessus. Dans le répertoire models, créez les fichiers suivants :

1. __init__.py
2. eden_invoicing.py

‍

De même, dans le répertoire des vues, créez le fichier suivant :

1. eden_invoicing.xml

‍

La structure des dossiers devrait maintenant ressembler (quelque chose) à ceci :

‍

‍

Ajouts dans le fichier Python

Collez le code suivant dans votre « models/eden_invoicing.py » fichier :

from odoo import (
   api,
   fields,
   models,
)




class EdenInvoicing(models.Model):
   _name = "account.move"
   _inherit = ['account.move']


@staticmethod
def eden_api_button(self):
   pass

‍

Ajouts dans le fichier XML

De même, collez le code suivant dans le « views/eden_invoicing.xml » fichier :

 
   
   
     account.move.form.eden.api
     account.move
     
     
       

         
       
     
   
 

‍

En gros, dans ces deux cas, nous héritons de la facturation par défaut d'Odoo afin d'ajouter nos modifications pour intégrer l'API d'analyse des factures d'Eden.

Remarque : Comme vous pouvez le voir, le nom du bouton « eden_api_button » correspond au nom de la méthode dans le fichier python situé au-dessus, c'est-à-dire « def eden_api_button (self) :... »

‍

Ensuite, vous devez ajouter le chemin de la vue dans __manifest__.py et importez le modèle afin de rendre les modifications du module accessibles à Odoo :

‍

Ajoutez également les lignes suivantes dans le __init__.py fichier du module invoice_parsing et du répertoire models respectivement :

à partir de modèles .import

de .import eden_invoicing

‍

Maintenant, retournez à votre « analyse_des factures » module dans la liste des applications et mettez à jour à nouveau le module.

Ensuite, lorsque vous ouvrez la vue du formulaire de facturation, vous remarquerez le bouton suivant :

‍

Finalement, ce bouton (c'est-à-dire Eden Parser) nous permettra de télécharger un fichier et de l'enregistrer en tant qu'enregistrement sur Odoo.

Cependant, à partir de maintenant, nous allons nous concentrer sur l'API elle-même.

‍

Étape 5 : Intégrer l'API Eden-AI dans Odoo

‍

1. Écrivez le script d'API

L'étape suivante consiste à intégrer l'API Eden-AI au bouton que nous avons créé dans la dernière section. L'objectif ici est de déclencher l'API Eden AI en cliquant sur ce bouton.

‍

Tout d'abord, créez un fichier dans le répertoire des modèles avec le nom »eden_ai_api.py ».

‍

Dans le fichier que vous venez de créer, copiez le code suivant :

import requests
import json

def main():
   headers = {
       "Authorization": "Bearer Your-API-Key"
   }

   url = "https://api.edenai.run/v2/ocr/invoice_parser"
   data = {"providers": "affinda, mindee", "language": "en"}
   files = {'file': open("/path/to/invoice.pdf", 'rb')}

   response = requests.post(url, data=data, files=files, headers=headers)

   result = json.loads(response.text)
   print(result['mindee']['extracted_data'])
   return result['mindee']['extracted_data']

if __name__ == '__main__':
   main()

‍

Après avoir collé le code fourni, il est essentiel de remplacer l'espace réservé « Votre clé d'API » avec votre clé API actuelle, et mettez également à jour le chemin d'accès à votre fichier en remplaçant « /path/to/invoice.pdf » avec le chemin de fichier correct.

‍

2. Appelez le script d'API dans Model Method

Maintenant, revenons à « eden_invoicing.py » fichier, appelez « principal » fonction du script ci-dessus. Retournez au « eden_api_button« méthode que nous avons définie ci-dessus. Modifiez la méthode comme suit :

@staticmethod
def eden_api_button(self):
   a_dict = eden_ai_api.main()
   print(a_dict)

‍

‍

Maintenant que vous avez appelé « eden_ai_api » utilisez la méthode de votre bouton, redémarrez votre serveur et mettez à niveau votre module personnalisé depuis le menu Applications. Enfin, revenez à l'emplacement où le bouton a été initialement placé pour passer aux étapes suivantes :

‍

Cliquez sur le bouton « EDEN PARSER » et vérifiez vos journaux dans PyCharm, vous verrez un dictionnaire imprimé :

‍

La capture d'écran ci-dessous montre que votre facture a été analysée avec succès par l'API d'analyse des factures Eden-AI :

‍

‍

3. Télécharger le fichier sur Odoo

Bien que ce didacticiel fasse tout via le backend, vous pouvez également ajouter des fonctionnalités permettant de télécharger directement un fichier et d'automatiser le processus de téléchargement des factures. Cependant, cela nécessitera une connaissance approfondie de JavaScript et du framework Odoo Owl.

‍

Voici un résumé des étapes à suivre pour pouvoir télécharger un fichier depuis l'appareil :

1. Héritez du composant owl avec le nom de classe : « Account.ListView.Buttons ». Vous pouvez le trouver dans le répertoire statique du module des comptes dans le code source d'Odoo (c'est-à-dire odoo/addons/account/static/src/bills_upload/...). Vous constaterez qu'il s'agit d'une liste héritée, dont vous hériterez ultérieurement.

2. Ensuite, vous devez créer un composant appelé Eden File Uploader et fournir toutes les définitions. Dans ce cas, vous allez étendre la base « Téléchargeur de fichiers » Fonctionnalité des composants Vous trouverez un extrait de code d'exemple dans le même fichier :

3. Enfin, vous devez intégrer vos processus d'API Eden AI à l'aide du bouton. Pour cela, il se peut que vous deviez utiliser du JavaScript pur ou non, en fonction du flux de votre processus. Un exemple de bouton est également fourni dans le même fichier :

‍

Remarque : Ces extraits de code ne serviront que de base pour vos propres boutons personnalisés et les fonctionnalités de l'API. Vous devrez peut-être également travailler avec des contrôleurs et du JS pur.

‍

‍

Conversion de l'API Eden AI

Si vous n'avez pas compris ce qui s'est passé ci-dessus, notez les points suivants :

1. L'API Eden AI a analysé le document fourni sur votre machine locale et a récupéré toutes les données pertinentes.
2. Les données ont été stockées au format JSON. Cela fonctionne pour tous les fournisseurs qui utilisent l'API Eden AI. Vous remarquerez que des clés contenant toutes sortes d'informations sont disponibles avec l'API. Les valeurs qui n'ont pas été fournies dans la facture sont nulles.
3. Ces données JSON ont ensuite été converties en un dictionnaire Python par le script que nous avons écrit dans eden_ai_api.py dossier.
4. Enfin, ce script a été intégré à un bouton Odoo (que nous avions créé initialement).

‍

Pour l'instant, il ne s'agissait que d'un simple aperçu de la façon dont l'intégration avec l'API eDenai doit fonctionner. Vous pouvez étendre ce flux pour générer des rapports ou automatiser vos processus de comptabilité/facturation.

‍

Dans ce tutoriel, nous avons intégré avec succès l'API eDenai à Odoo. Vous pouvez utiliser cette API à différentes fins, telles que l'automatisation et la rationalisation de vos pipelines de facturation. L'API d'analyse des factures d'Eden AI vous aidera à analyser et à transférer rapidement des données entre les modules d'Odoo.

‍

Si d'autres outils d'intégration vous intéressent, consultez nos didacticiels étape par étape sur la façon d'intégrer l'IA à votre application avec Power Apps, Zapier, Script de l'application Google, Réoutillage, Fabriquer, Dataiku, IFTTT, et n8n.

‍