SUIVI DES VENTES CLIM-SPLIT — APPLICATION EXTERNE (v2.0.0) =========================================================== Contenu du ZIP -------------- app/ → l'application, à mettre sur le sous-domaine (ex. suivi.clim-split.com) climsuivilink.zip → petit module PrestaShop (pastille + bouton « Ouvrir dans le suivi ») LISEZMOI-INSTALLATION.txt ÉTAPE 1 — Créer le sous-domaine (cPanel O2switch) ------------------------------------------------- 1. cPanel → « Domaines » (ou « Sous-domaines ») → Créer : sous-domaine : suivi · domaine : clim-split.com racine du document : /home/kole3907/suivi.clim-split.com 2. cPanel → « SSL/TLS Status » → cocher suivi.clim-split.com → « Run AutoSSL » (le certificat HTTPS gratuit arrive en quelques minutes). ÉTAPE 2 — Créer la base de données ---------------------------------- cPanel → « Bases de données MySQL® » : 1. Créer une base : suivi → elle s'appellera kole3907_suivi 2. Créer un utilisateur : suivi + mot de passe fort → kole3907_suivi 3. « Ajouter l'utilisateur à la base » → cocher TOUS LES PRIVILÈGES. Notez le nom de la base, l'utilisateur et le mot de passe. ÉTAPE 3 — Envoyer l'application (FileZilla) ------------------------------------------- Envoyez le CONTENU du dossier app/ (pas le dossier lui-même) dans : /home/kole3907/suivi.clim-split.com/ Vous devez y voir directement index.php, install.php, orders.php, lib/, assets/, storage/… Pensez à afficher les fichiers cachés dans FileZilla (Serveur → Forcer l'affichage des fichiers cachés) pour que les fichiers .htaccess soient bien envoyés. ÉTAPE 4 — Installer ------------------- Ouvrez https://suivi.clim-split.com → la page d'installation s'affiche. Saisissez la base (serveur : localhost) et créez votre compte administrateur (votre email + un mot de passe d'au moins 10 caractères). Puis connectez-vous. ÉTAPE 5 — Relier à PrestaShop (lecture seule) --------------------------------------------- Dans le back-office PrestaShop : 1. Paramètres avancés → Webservice → « Activer le service web de PrestaShop » : OUI → Enregistrer. 2. « Ajouter une nouvelle clé de service web » : - Clé : cliquez sur « Générer » - Description : Suivi des ventes - État : Oui - Permissions : cochez UNIQUEMENT la colonne « Voir (GET) » pour : customers, order_states, orders → Enregistrer, et copiez la clé. Dans l'application : Réglages → Connexion à PrestaShop - Adresse de la boutique : https://lastclim-split.com - Clé Webservice : collez la clé - Adresse du back-office : https://lastclim-split.com/vic2024 → Enregistrer, puis « Tester la connexion » : les 3 lignes doivent être vertes. Si une ligne est rouge en 403 : le pare-feu Tiger Protect bloque peut-être /api/ → cPanel → Tiger Protect / ModSecurity : autoriser l'adresse du serveur, ou contacter le support O2switch. ÉTAPE 6 — Reprendre les données de l'ancien module -------------------------------------------------- Dans l'application : Réglages → « Importer les données de l'ancien module » 1. Téléchargez export-suivi-ventes.php et envoyez-le par FTP à la racine de PrestaShop : /home/kole3907/lastclim-split.com/export-suivi-ventes.php 2. Cliquez sur « Importer maintenant » (fournisseurs, montants, factures reçues, mise en service, kit, avoirs, statuts de saisie et nom de la personne qui a saisi sont repris). 3. SUPPRIMEZ export-suivi-ventes.php de PrestaShop par FTP. 4. Vérifiez le tableau d'un mois passé, puis dans PrestaShop : Modules → « Clim-split — Suivi des ventes & marge » → Désinstaller (ses tables restent en base, rien n'est perdu). ÉTAPE 7 — Module PrestaShop « Lien suivi des ventes » (facultatif mais conseillé) ------------------------------------------------------------------------------- Il remet dans PrestaShop la pastille « Saisie fourn. » (liste des commandes + haut de la fiche commande) et un bouton « Ouvrir dans le suivi des ventes ». Il ne modifie rien dans PrestaShop. 1. Décompressez climsuivilink.zip et envoyez le dossier climsuivilink par FTP dans /home/kole3907/lastclim-split.com/modules/ 2. Modules → Gestionnaire de modules → « Lien suivi des ventes » → Installer → Configurer. 3. Recopiez l'adresse (https://suivi.clim-split.com) et la clé d'API affichées dans l'application : Réglages → Module PrestaShop. → Enregistrer (un message confirme la connexion). ÉTAPE 8 — Email mensuel automatique ----------------------------------- 1. Dans l'application : Réglages → Email mensuel : destinataires + adresse d'expédition (créez de préférence une adresse @clim-split.com dans cPanel, ex. suivi@clim-split.com, pour que l'email n'arrive pas en spam). 2. cPanel → « Tâches Cron » → Ajouter : Paramètre courant : « Une fois par mois » (ou minute 0, heure 7, jour 1, mois *, jour sem. *) Commande : php /home/kole3907/suivi.clim-split.com/cron.php Le 1er de chaque mois à 7 h, l'export du mois précédent est créé, archivé (page Exports) et envoyé par email. 3. Supprimez l'ancienne tâche cron de climsuivivente si vous l'aviez créée. ÉTAPE 9 — Créer les comptes --------------------------- Utilisateurs → Ajouter : nom, email, mot de passe. Cochez « Administrateur » seulement pour les personnes qui doivent gérer les comptes et les réglages. UTILISATION AU QUOTIDIEN ------------------------ - Tableau du mois : les commandes sont récupérées automatiquement depuis PrestaShop (toutes les 10 min au plus, ou bouton « Actualiser maintenant »). Filtres par statut (À saisir / En cours / Validée / Factures en attente) et recherche. - Cliquez sur un n° de commande pour saisir : prix fournisseurs HT + « Facture reçue », mise en service TTC, kit installation TTC, avoir (+ Reçu), « Saisie validée ». « Enregistrer et passer à la suivante » pour enchaîner. - Exports : téléchargement Excel de n'importe quel mois, envoi immédiat par email, archives. Calculs (identiques au module) : CA HT net = (CA TTC − mise en service TTC − kit installation TTC) ÷ (1 + TVA de la commande) Marge brute = CA HT net − achats fournisseurs HT L'avoir n'entre dans aucun calcul. Sécurité : accès par identifiant/mot de passe, HTTPS forcé, pages non indexées par Google, 5 essais de connexion max / 15 min, clé PrestaShop en lecture seule. Sauvegarde : la base kole3907_suivi est incluse dans les sauvegardes JetBackup d'O2switch.