/** * Automatisation « devis accepté → facture PDF → e-mail → relance à J+7 » * Google Apps Script lié à un Google Sheet (Extensions > Apps Script). * * Onglets utilisés (créés par installer()) : * - Devis : on passe la colonne « Statut » à « Accepté » * - Factures : rempli automatiquement * - Paramètres : coordonnées de l'entreprise, délais, mode test * * Mise en route : exécuter installer() une fois (autorisations Google demandées), * puis passer un devis en « Accepté ». Voir README.md. */ var ONGLET_DEVIS = 'Devis'; var ONGLET_FACTURES = 'Factures'; var ONGLET_PARAMS = 'Paramètres'; var COL_DEVIS = ['N° devis', 'Date', 'Client', 'E-mail client', 'Désignation', 'Montant HT', 'Statut', 'N° facture']; var COL_FACTURES = ['N° facture', 'N° devis', 'Client', 'E-mail client', 'Montant', 'Date d\'émission', 'Échéance', 'Statut paiement', 'Lien PDF', 'Nb relances', 'Dernière relance']; var PARAMS_DEFAUT = [ ['Entreprise', 'Menuiserie Dupin (entreprise fictive)'], ['Adresse', '12 rue des Artisans, 00000 Villefictive'], ['SIRET', '000 000 000 00000'], ['E-mail entreprise', 'contact@exemple.fr'], ['IBAN', 'FR76 0000 0000 0000 0000 0000 000'], ['Délai de paiement (jours)', 30], ['Relance après (jours)', 7], ['Nombre max de relances', 2], ['Dossier Drive des factures', 'Factures'], ['Mode test (e-mails envoyés à moi-même)', 'OUI'], ]; // ---------------------------------------------------------------- Installation /** À lancer une fois : crée les onglets manquants et les déclencheurs. */ function installer() { var ss = SpreadsheetApp.getActiveSpreadsheet(); creerOnglet_(ss, ONGLET_DEVIS, COL_DEVIS); creerOnglet_(ss, ONGLET_FACTURES, COL_FACTURES); var p = ss.getSheetByName(ONGLET_PARAMS); if (!p) { p = ss.insertSheet(ONGLET_PARAMS); p.getRange(1, 1, PARAMS_DEFAUT.length, 2).setValues(PARAMS_DEFAUT); } // Menu déroulant sur la colonne Statut var regle = SpreadsheetApp.newDataValidation() .requireValueInList(['Brouillon', 'Envoyé', 'Accepté', 'Refusé'], true).build(); ss.getSheetByName(ONGLET_DEVIS).getRange('G2:G1000').setDataValidation(regle); // Déclencheurs (on supprime d'abord ceux du projet pour ne pas les dupliquer) ScriptApp.getProjectTriggers().forEach(function (t) { ScriptApp.deleteTrigger(t); }); ScriptApp.newTrigger('surModification').forSpreadsheet(ss).onEdit().create(); ScriptApp.newTrigger('relancerImpayes').timeBased().everyDays(1).atHour(9).create(); return 'Installation terminée'; } function creerOnglet_(ss, nom, entetes) { var f = ss.getSheetByName(nom); if (!f) { f = ss.insertSheet(nom); f.getRange(1, 1, 1, entetes.length).setValues([entetes]).setFontWeight('bold'); f.setFrozenRows(1); } return f; } // ---------------------------------------------------------------- Déclencheur /** Déclencheur « à la modification » : un devis passe à « Accepté ». */ function surModification(e) { if (!e || !e.range) return; var f = e.range.getSheet(); if (f.getName() !== ONGLET_DEVIS || e.range.getColumn() !== COL_DEVIS.indexOf('Statut') + 1) return; if (String(e.value || e.range.getValue()).trim() !== 'Accepté') return; traiterDevis(e.range.getRow()); } /** Crée la facture d'un devis accepté (idempotent : ne refait rien si déjà facturé). */ function traiterDevis(ligne) { var verrou = LockService.getDocumentLock(); verrou.waitLock(30000); try { var ss = SpreadsheetApp.getActiveSpreadsheet(); var fDevis = ss.getSheetByName(ONGLET_DEVIS); var v = fDevis.getRange(ligne, 1, 1, COL_DEVIS.length).getValues()[0]; var devis = { numero: v[0], date: v[1], client: v[2], email: String(v[3]).trim(), designation: v[4], montant: Number(v[5]), statut: v[6], facture: v[7], }; if (devis.facture) return null; // déjà facturé if (!devis.numero || !devis.client || !(devis.montant > 0) || devis.email.indexOf('@') < 1) { throw new Error('Devis ligne ' + ligne + ' incomplet (n°, client, e-mail ou montant).'); } var p = lireParametres_(); var aujourdhui = new Date(); var facture = { numero: prochainNumero_(ss, aujourdhui), emission: aujourdhui, echeance: ajouterJours_(aujourdhui, Number(p['Délai de paiement (jours)']) || 30), }; var pdf = genererPdf_(devis, facture, p); var fichier = dossierFactures_(p['Dossier Drive des factures']).createFile(pdf); envoyer_(p, devis.email, 'Facture ' + facture.numero + ' — ' + p['Entreprise'], 'Bonjour,\n\nMerci pour votre confiance. Suite à l\'acceptation du devis ' + devis.numero + ', vous trouverez ci-joint la facture ' + facture.numero + ' d\'un montant de ' + euros_(devis.montant) + ', payable avant le ' + dateFr_(facture.echeance) + '.\n\nIBAN : ' + p['IBAN'] + '\n\nBien cordialement,\n' + p['Entreprise'], pdf); ss.getSheetByName(ONGLET_FACTURES).appendRow([ facture.numero, devis.numero, devis.client, devis.email, devis.montant, facture.emission, facture.echeance, 'À payer', fichier.getUrl(), 0, '', ]); fDevis.getRange(ligne, COL_DEVIS.indexOf('N° facture') + 1).setValue(facture.numero); return facture.numero; } finally { verrou.releaseLock(); } } // ---------------------------------------------------------------- Relances /** Déclencheur quotidien : relance les factures impayées depuis N jours. */ function relancerImpayes() { var ss = SpreadsheetApp.getActiveSpreadsheet(); var p = lireParametres_(); var delai = Number(p['Relance après (jours)']) || 7; var max = Number(p['Nombre max de relances']) || 2; var f = ss.getSheetByName(ONGLET_FACTURES); var donnees = f.getDataRange().getValues(); var maintenant = new Date(); var envoyees = 0; for (var i = 1; i < donnees.length; i++) { var r = donnees[i]; var statut = r[7], nb = Number(r[9]) || 0; var reference = r[10] ? new Date(r[10]) : new Date(r[5]); // dernière relance, sinon émission if (statut !== 'À payer' || nb >= max) continue; if (joursEntre_(reference, maintenant) < delai) continue; envoyer_(p, r[3], (nb === 0 ? 'Rappel' : 'Second rappel') + ' : facture ' + r[0] + ' en attente de règlement', 'Bonjour,\n\nSauf erreur de notre part, la facture ' + r[0] + ' de ' + euros_(r[4]) + ' émise le ' + dateFr_(new Date(r[5])) + ' n\'a pas encore été réglée (échéance : ' + dateFr_(new Date(r[6])) + ').\nVous la retrouverez ici : ' + r[8] + '\n\nSi le paiement a été effectué entre-temps, merci de ne pas tenir compte de ce message.' + '\n\nBien cordialement,\n' + p['Entreprise'], null); f.getRange(i + 1, 10, 1, 2).setValues([[nb + 1, maintenant]]); envoyees++; } return envoyees; } // ---------------------------------------------------------------- Outils function lireParametres_() { var f = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(ONGLET_PARAMS); var p = {}; PARAMS_DEFAUT.forEach(function (l) { p[l[0]] = l[1]; }); if (f) f.getDataRange().getValues().forEach(function (l) { if (l[0]) p[String(l[0]).trim()] = l[1]; }); return p; } /** Numérotation continue par année : F-2026-001, F-2026-002… (obligation légale). */ function prochainNumero_(ss, date) { var annee = date.getFullYear(); var prefixe = 'F-' + annee + '-'; var max = 0; ss.getSheetByName(ONGLET_FACTURES).getDataRange().getValues().slice(1).forEach(function (l) { var n = String(l[0]); if (n.indexOf(prefixe) === 0) max = Math.max(max, parseInt(n.slice(prefixe.length), 10) || 0); }); return prefixe + ('00' + (max + 1)).slice(-3); } function genererPdf_(devis, facture, p) { var html = '' + '' + '
' + esc_(p['Entreprise']) + '
' + esc_(p['Adresse']) + '
SIRET ' + esc_(p['SIRET']) + '
' + esc_(p['E-mail entreprise']) + '
FACTURE
N° ' + facture.numero + '
Date : ' + dateFr_(facture.emission) + '
Échéance : ' + dateFr_(facture.echeance) + '
' + '

Client : ' + esc_(devis.client) + '
Réf. devis : ' + esc_(devis.numero) + '

' + '' + '' + '' + '
DésignationMontant
' + esc_(devis.designation) + '' + euros_(devis.montant) + '
Total à payer' + euros_(devis.montant) + '
' + '

TVA non applicable, art. 293 B du CGI.
' + 'Paiement par virement — IBAN : ' + esc_(p['IBAN']) + '
' + 'En cas de retard : pénalités au taux légal majoré et indemnité forfaitaire de 40 € pour frais de recouvrement.

' + ''; return Utilities.newBlob(html, 'text/html', facture.numero + '.html') .getAs('application/pdf').setName(facture.numero + '.pdf'); } function dossierFactures_(nom) { var it = DriveApp.getFoldersByName(nom); return it.hasNext() ? it.next() : DriveApp.createFolder(nom); } /** En mode test, tous les e-mails partent vers le propriétaire du script. */ function envoyer_(p, destinataire, sujet, corps, pieceJointe) { var test = String(p['Mode test (e-mails envoyés à moi-même)']).toUpperCase() === 'OUI'; var a = test ? Session.getEffectiveUser().getEmail() : destinataire; var options = { name: p['Entreprise'] }; if (pieceJointe) options.attachments = [pieceJointe]; MailApp.sendEmail(a, (test ? '[TEST → ' + destinataire + '] ' : '') + sujet, corps, options); } function ajouterJours_(d, n) { var x = new Date(d.getTime()); x.setDate(x.getDate() + n); return x; } function joursEntre_(a, b) { return Math.floor((b.getTime() - a.getTime()) / 86400000); } function dateFr_(d) { return Utilities.formatDate(d, 'Europe/Paris', 'dd/MM/yyyy'); } function euros_(n) { return Number(n).toFixed(2).replace('.', ',').replace(/\B(?=(\d{3})+(?!\d))/g, ' ') + ' €'; } function esc_(s) { return String(s == null ? '' : s).replace(/[&<>"]/g, function (c) { return { '&': '&', '<': '<', '>': '>', '"': '"' }[c]; }); }