Avant propos
Pour commencer le paramétrage de ce connecteur, il faut que vous disposiez d'ores et déjà d'un compte GMail dédié à la réception des factures fournisseurs.
L’intégration proposée récupère toutes les pièces jointes de la boîte mail que vous indiquerez, sans distinction.
Il est conseillé de dédier cette adresse e-mail uniquement à la réception des factures, sinon, vous risquez de vous retrouver avec des données inutiles dans Cleemy Factures.
Avec Make
Se connecter à Make, et aller dans les scénarios :
Vous retrouverez ici toutes les routines qui sont lancées pour votre compte. Nous allons en créer une nouvelle :
La page pour créer un nouveau scénario vous guidera. L’idée est d’agencer plusieurs étapes :
- Récupération des pièces jointes dans GMail.
- Uploader les documents sur notre brique technique traitant les fichiers entrants
- Envoyer le document uploadé à Cleemy Factures.
Étape 1 - GMail
En cliquant sur le bouton “+”, nous allons créer la première étape. Pour cela, choisissez l’application GMail :
Watch e-mails
Parmi les options proposées, nous souhaitons regarder les e-mails entrants, ce qui correspond à “Watch e-mails” :
Paramétrage de l’étape
Plusieurs paramètres sont à indiquer :
- Le compte GMail que vous souhaitez utiliser.
- Le dossier dans lequel le mail arrive. Par défaut, vous pouvez indiquer “All Mail”.
- Vous n’avez pas besoin de modifier le filtre.
- Indiquer que seuls les mails non lus doivent être relevés et qu’une fois qu’un mail est relevé, il soit lu. Cette combinaison ne vous permet de n’avoir que les nouveaux mails.
- Le maximum de résultat n’est pas important. Par défaut, je prends maximum 10 mails : 10 mails arrivant d’un coup restant très peu fréquent.
La dernière étape pour Gmail est d’indiquer que l’on ne récupère pas les mails dans le passé et donc de commencer la veille à partir de maintenant :
Étape 2 - Gestion de plusieurs pièces jointes
Ajout d’une étape
Pour ajouter une seconde étape, il suffit de passer la souris sur l’étape créée et l’action “Add another module” apparaît.
En cliquant sur celle-ci, vous pourrez définir la seconde étape.
Si vous souhaitez gérer le cas où plusieurs documents sont joints à un mail, il suffit d’ajouter une étape GMail, s’appelant “Iterate attachments”.
Celle-ci permet de boucler sur l’ensemble des pièces jointes à vos mails.
Aucun paramétrage n’est nécessaire.
Étape 3 - Upload du fichier
Ajout de l’étape
Ajoutez une troisième étape, comme vous avez procédé pour la seconde étape, en choisissant “HTTP”.
Une fois HTTP choisi, cliquez sur l’option “Make a request” :
Paramétrage
Plusieurs champs sont à remplir, certains avec vos propres données.
Url
Indiquez l’url de votre instance suivi de :
/lucca-files/api/uploads
Method
Choisissez “POST” dans le menu déroulant.
Headers
Ajoutez un header en choisissant comme name “Authorization” et comme value une clé API que vous devez créer en amont depuis votre site Lucca en lui affectant la permission Cleemy Factures "Comptabiliser et payer des factures". Voici la fiche d'aide pour la générer.
Query string
Laissez query string vide
Body type
Choisissez “multipart/form-data” dans le menu déroulant.
Fields
Ajoutez un field
Et choisissez le type “file”
Ensuite, vous pourrez compléter les informations suivantes :
- Key : uploadedFile
- File : choisissez l’option Gmail
Parse response
Cochez "Yes"
Cliquez sur “OK” pour enregistrer cette étape.
Étape 4 - Enregistrement du document dans Cleemy Factures
Ajout de l’étape
De la même manière que l’étape 3, ajoutez une étape “HTTP”, en choisissant l’option “Make a request”.
Paramétrage
Url
Indiquez l’url de votre instance suivi de :
/cleemy-procurement/api/documents
Method
Choisissez “POST” dans le menu déroulant.
Headers
Ajoutez un header en choisissant comme name “Authorization” et comme Value la clé API.
Query string
Laissez ce champ vide
Body type
Choisissez “raw” dans le menu déroulant, ce qui fera apparaître de nouveaux champs dans le formulaire.
Content type
Choisissez JSON
Request content
Ajoutez le code suivant dans le champ en question :
{
"type":"Unknown",
"attachmentIds":[""]
}
Une fois ceci fait, vous pouvez récupérer un champ pour l’ajouter dans “attachmentIds”.
Pour cela, en cliquant dans la zone de texte, l’intégralité des données disponibles s’ouvrira à côté de l’écran :
Parmi toutes ces données, ajoutez “id” qui se trouve dans la rubrique “ HTTP - Make request ”, sous "Data".
Nous reprenons le résultat de l’étape 3 pour l’injecter dans l’étape 4.
En cliquant sur “id”, cette donnée va s’ajouter dans la zone de texte. Il faut l'ajouter entre les deux guillemets, présents entre les deux crochets.
Parse response
Vous n’avez pas besoin de modifier la valeur.
Périodicité du relevé
Il ne vous reste qu’à choisir à quelle fréquence lancer cette intégration.
Pour cela, cliquez sur l’horloge présente à la première étape votre scénario.
Vous pouvez lancer le scénario à un intervalle de temps régulier, dont la durée minimale entre deux lancements est de 15 minutes.
Vous pouvez changer l’option et choisir “Every day” : relever votre boîte mail une fois par jour est suffisant pour l’utilisation que nous aurons du scénario.
En outre, vous pourrez choisir l’heure à laquelle le scénario sera joué.
Tests
Votre intégration est terminée, vous pouvez maintenant la tester.
Pour cela, prenez une facture que vous souhaitez ajouter dans Cleemy Factures et envoyez-la à l’adresse mail que vous avez utilisée pour créer votre scénario.
Une fois celle-ci reçue, cliquez sur “Run once” en bas à gauche de votre écran :
Vous retrouverez la facture dans Cleemy Factures.
N'oubliez pas d'activer le scnéario avec l'interrupteur ON/OFF