Suivi des dépenses piloté par API avec Google Sheets - Workflow n8n

Les personnes cherchant à automatiser le suivi de leurs finances personnelles.
Les développeurs ayant besoin d'un point de terminaison API simple pour enregistrer des données transactionnelles.
Les utilisateurs à la recherche de modèles n8n puissants combinant logique personnalisée et stockage cloud.
Quiconque souhaite remplacer la saisie manuelle de données par une solution n8n automatisée.

La gestion des finances personnelles implique souvent une saisie manuelle fastidieuse ou le recours à des applications tierces coûteuses et restrictives. Ce puissant workflow n8n résout ce problème en créant un point de terminaison API dédié pour enregistrer les dépenses en temps réel. En utilisant un déclencheur n8n de type Webhook, toute application externe (comme un formulaire mobile ou un outil de script) peut instantanément envoyer des données de dépenses. Le workflow assure l'intégrité des données grâce à une validation avant de stocker l'information de manière sécurisée dans Google Sheets. De plus, un déclencheur n8n secondaire planifié génère automatiquement des synthèses des dépenses journalières, offrant des aperçus instantanés sans nécessiter de calcul manuel. Cette solution n8n complète offre des capacités de suivi robustes et un retour d'information immédiat via la réponse API.

Ce workflow n8n fonctionne via deux processus parallèles principaux, chacun commençant par un déclencheur n8n unique.

1. Enregistrement des dépenses en temps réel (Déclenchement API)

1. Webhook de saisie des dépenses : Le processus principal démarre lorsqu'une requête POST atteint le point de terminaison du déclencheur n8n /webhook/add-expense, fournissant les données brutes de la dépense (montant, catégorie, description, etc.).


2. Validation et formatage des données de dépense : Un nœud Fonction n8n crucial prend le relais. Il valide la saisie, s'assurant que le montant est positif, attribue des valeurs par défaut si nécessaire, et applique les catégories définies (Nourriture, Transport, etc.). En cas d'échec de la validation, une erreur est levée.


3. Sauvegarde de la dépense dans Google Sheets : Les données validées sont transmises au nœud n8n Google Sheets, qui ajoute de manière sécurisée la nouvelle transaction à l'onglet 'Expenses' désigné.


4. Calcul du récapitulatif mensuel et réponse : Un nœud Fonction n8n subséquent prépare un message de succès clair et la charge utile du résumé. Enfin, le nœud n8n Envoyer la réponse de succès renvoie immédiatement un message de confirmation à l'application appelante, assurant une confirmation en temps réel.

2. Rapports quotidiens planifiés (Déclenchement Cron)

1. Planification du résumé quotidien : Ce flux est initié par un déclencheur n8n Cron (planifié, généralement pour la soirée).


2. Lecture des dépenses du jour depuis la feuille : Le nœud n8n Google Sheets lit les données de dépenses pertinentes dans la feuille de calcul. Comme toutes les données sont lues, l'étape suivante gère le filtrage.


3. Calcul du total journalier : Un nœud Fonction n8n dédié filtre les données récupérées pour n'inclure que les transactions marquées pour aujourd'hui. Il calcule ensuite la dépense totale pour la journée et fournit une ventilation par catégorie. Ceci achève la phase de génération du rapport quotidien du workflow n8n.

Pour déployer et utiliser ce workflow n8n hautement efficace, suivez ces étapes :

1. Importer le modèle n8n : Copiez le JSON fourni et importez-le dans votre instance n8n.


2. Configuration de Google Sheets : Créez une nouvelle feuille Google. Il est crucial de s'assurer que l'onglet de données principal est nommé 'Expenses' et contient les colonnes d'en-tête requises : Date | Catégorie | Description | Montant | Moyen de paiement.


3. Configuration des identifiants : Configurez vos identifiants OAuth2 pour Google Sheets dans n8n.


4. Mise à jour des identifiants de feuille de calcul : Dans le nœud n8n Sauvegarder la dépense dans Google Sheets et le nœud n8n Lire les dépenses du jour depuis la feuille, remplacez REPLACEWITHYOURSPREADSHEETID par l'ID réel de votre feuille de calcul de suivi des dépenses.


5. Activation : Enregistrez le workflow n8n et réglez le déclencheur n8n Planification du résumé quotidien à l'heure de votre choix (par exemple, 20h00 tous les jours). Activez le workflow n8n pour rendre le webhook opérationnel.

Ce workflow n8n exploite plusieurs nœuds n8n clés pour obtenir des fonctionnalités robustes :

Webhook de saisie des dépenses (déclencheur n8n) : C'est le point d'entrée, configuré comme gestionnaire de requête POST au chemin /add-expense. C'est le déclencheur n8n principal pour la consignation des dépenses.
Validation et formatage des données de dépense (nœud Fonction n8n) : Essentiel pour la qualité des données. Ce nœud n8n personnalisé valide que montant > 0, attribue une catégorie par défaut si nécessaire, et garantit que les données adhèrent à un format strict avant de passer au stockage.
Sauvegarder la dépense dans Google Sheets (nœud n8n Google Sheets) : Configuré pour utiliser l'opération append (ajouter), garantissant que chaque nouvel élément transmis par le nœud n8n précédent est ajouté comme une nouvelle ligne à l'onglet 'Expenses'.
Planification du résumé quotidien (déclencheur Cron n8n) : Le déclencheur n8n secondaire, configuré pour s'exécuter sur une base quotidienne, automatisant la génération des rapports de synthèse.
Lire les dépenses du jour depuis la feuille (nœud n8n Google Sheets) : Récupère les données nécessaires à l'analyse, utilisées par la branche planifiée du workflow n8n.
Calculer le total journalier (nœud Fonction n8n) : Un nœud n8n personnalisé qui effectue un filtrage basé sur la date du jour et agrège les totaux par catégorie, générant la charge utile finale du rapport de synthèse.