Intégrer Sage 100 pas à pas

Ce guide suit un exemple concret : Comptoir Kodjo, une PME de Lomé qui facture ses clients dans Sage 100 Gestion commerciale. À la fin, l'assistante sélectionne une facture, clique sur Demander le paiement, le client paie depuis son téléphone, et la facture passe Payée dans l'application quelques secondes plus tard.

Comptez 45 minutes pour tout faire en mode test, sans vrai paiement.

Comment ça marche#

Sage 100 est installé sur un ordinateur de votre bureau, pas sur Internet. pismile fournit donc une petite application Windows, pismile Encaissement pour Sage 100, que vous installez à côté de Sage.

1. La facture

   Vous créez la facture dans Sage comme d'habitude, puis vous l'ajoutez dans l'application pismile : à la main, ou en important la liste des factures exportée de Sage vers Excel.

2. La demande de paiement

   Un clic sur Demander le paiement : le client reçoit la demande dans sa banque ou son mobile money, avec le nom de votre organisation et le numéro de facture.

3. Le règlement

   Le client valide. L'argent arrive directement sur votre compte. L'application affiche la facture Payée, avec la référence PI-SPI pour votre rapprochement bancaire.

Vue d'ensemble#

Partie 1 — Dans la console pismile#

1. 1. Créez votre compte et votre organisation

   Rendez-vous sur pismile.com/signup et créez votre compte personnel. Puis Nouvelle organisation : nom affiché (celui que vos clients connaissent, par exemple « Comptoir Kodjo »), pays, type de compte, et cochez Encaissement.

2. 2. Activez l'encaissement et votre accès PI-SPI

   Console → Modules → Encaissement PI-SPI → Activer.

   Puis console → Encaissement → Accès participant : recopiez l'accès PI-SPI fourni par votre banque ou votre mobile money (participant, URL de l'API, URL du jeton, identifiant et secret client, alias qui reçoit les paiements). Cliquez sur Enregistrer et tester.

   Le détail de cet écran est dans le guide Intégrer Odoo, étape 3 : c'est le même pour tous les connecteurs.

3. 3. Choisissez une offre Sage 100

   Console → Plan et usage → section Connecteurs → Offres Sage 100. Comparez les offres, puis Mensuel ou Annuel (paiement en ligne sécurisé). Une offre gratuite s'active d'un clic sur Activer.

   Pour profiter du suivi instantané des paiements, choisissez une offre qui inclut Facture marquée payée. Sans elle, l'application vérifie les demandes en attente une fois par minute.

4. 4. Créez la clé de l'installation

   Console → Encaissement → Connecteurs → carte Sage 100 → Nouvelle installation :

   • nom : par exemple « Sage Comptoir Kodjo » ;

   • laissez Test coché pour commencer ;

   • Créer la clé.

   La clé commence par pmc_test_.

Partie 2 — Installer l'application#

1. 5. Vérifiez la configuration requise

   	Requis
   Système	Windows 10 ou 11 (64 bits), ou Windows Server 2019 et plus récent
   Sage	Sage 100 Gestion commerciale, toutes versions (i7, V8, 100c, 100cloud), version fichier ou SQL
   Réseau	Accès Internet sortant en https vers pismile.com
   Droits	Un compte administrateur Windows pour l'installation
   Place	500 Mo

   Aucun autre logiciel à installer : tout est inclus dans le fichier d'installation.

2. 6. Installez l'application

   Le fichier d'installation pismile-agent-sage100-<version>.msi vous est fourni par pismile ou par votre intégrateur. N'utilisez que ce fichier, jamais une copie trouvée sur un autre site.

   Un seul poste (Sage et la personne qui l'utilise sur le même ordinateur) : double-cliquez sur le fichier, puis Suivant jusqu'au bout.

   Plusieurs postes (Sage sur un serveur ou un ordinateur central) :

   1. Sur l'ordinateur central, ouvrez PowerShell en administrateur, dans le dossier du fichier :

   POWERSHELLCopier

      msiexec /i pismile-agent-sage100-<version>.msi ACCES_RESEAU=1

   ACCES_RESEAU=1 permet aux autres postes du réseau local de joindre l'application (port 8790, ouvert dans le pare-feu Windows pour le réseau local seulement). Ce choix est conservé lors des mises à jour.

   2. Sur chaque poste, double-cliquez sur le fichier, choisissez Installation personnalisée et ne gardez que Application.

3. 7. Premier lancement

   Sur l'ordinateur central, ouvrez pismile Encaissement pour Sage 100 (menu Démarrer) :

   1. Gardez l'adresse proposée (https://localhost:8790) et cliquez sur Se connecter au service.

   2. Créez le compte administrateur : votre nom, un identifiant, un mot de passe de 10 caractères au moins.

   Sur un autre poste, saisissez le nom de l'ordinateur central (par exemple serveur-sage). L'application affiche une empreinte de sécurité : comparez-la avec celle affichée sur l'ordinateur central (Paramètres → Ce service). Si elles sont identiques, acceptez.

4. 8. Branchez l'application sur pismile

   Paramètres → Connexion à pismile :

   Champ	Ce qu'il faut mettre
   Adresse de l'API	https://pismile.com/api/connect/v1 (déjà remplie)
   Nouvelle clé	la clé pmc_test_… de l'étape 4

   Cliquez sur Enregistrer. Le résultat doit être vert : « Connecté à pismile : Comptoir Kodjo, en mode test ».

   Dans Paramètres → Mode de fonctionnement, laissez Manuel (voir « Les deux modes » plus bas).

5. 9. Créez les comptes de l'équipe

   Utilisateurs → nouveau compte : nom, identifiant, rôle et mot de passe temporaire. À sa première connexion, la personne choisit son propre mot de passe.

   Rôle	Peut faire
   Commercial	Voir et ajouter les factures, importer, envoyer les demandes de paiement, suivre les paiements, lire le journal
   Comptable	Tout ce que fait le commercial, plus les écritures et les exports comptables (prochaines versions)
   Administrateur	Tout, plus les paramètres (clé pismile, mode) et les comptes

   Après 5 mots de passe faux, le compte est bloqué 15 minutes. Une session se ferme après 8 heures sans activité.

Partie 3 — Au quotidien#

10. Ajoutez les factures#

Menu Factures.

Une facture : + Nouvelle, puis remplissez :

Plusieurs factures : dans Sage, exportez la liste des factures vers Excel, puis Importer Excel / CSV…. Les colonnes sont reconnues par leur titre, dans n'importe quel ordre :

• Formats acceptés : Excel .xlsx et CSV (point-virgule ou virgule, accents Windows ou UTF-8). L'ancien format .xls doit être réenregistré en .xlsx.

• Les lignes de titre et les lignes de total de l'export sont ignorées.

• Un import répété ne double jamais une facture : les numéros déjà présents sont laissés tels quels.

• Les lignes refusées sont listées avec leur numéro de ligne et la raison (montant avec centimes, numéro manquant…). Corrigez-les dans le fichier et réimportez.

• Le bouton Modèle de fichier donne un tableau prêt à remplir dans Excel.

11. Envoyez la demande de paiement#

1. Dans Factures, sélectionnez la facture.

2. Vérifiez l'alias PI-SPI du client dans la fiche. Si vous le changez ici, il est retenu pour la facture.

3. Facultatif : un motif, affiché dans la banque du client (par défaut « Facture » suivi du numéro).

4. Demander le paiement, puis confirmez.

Le client reçoit une demande de 1 250 000 F CFA avec le motif « Comptoir Kodjo - Facture FA00125 ». Le nom de votre organisation est toujours affiché en premier.

Suivez les paiements#

Menu Suivi des paiements : chaque demande et sa réponse, mise à jour toutes les 10 secondes, avec le total payé.

Renvoyer une demande : après un refus ou une expiration, corrigez la facture si besoin (montant, alias), Enregistrer, puis Renvoyer la demande de paiement. La nouvelle demande porte le numéro suivi de -2, -3… L'historique de chaque essai est conservé.

Le journal#

Menu Journal : tout ce que l'application a fait, en français simple, avec « Que faire » quand une action est nécessaire. Filtrez par niveau, sujet (Factures, Demandes, Paiements…), dates ou recherche. Les alias des clients y sont toujours masqués (+228••••3456) et aucune clé n'y apparaît. Le journal garde 13 mois.

Enregistrer le règlement dans Sage#

Aujourd'hui, le comptable saisit le règlement dans Sage à partir de Suivi des paiements (filtre Payée) : date, montant, et référence PI-SPI en référence du règlement, pour retrouver la ligne sur le relevé bancaire.

Les deux modes#

Le mode se change dans Paramètres → Mode de fonctionnement. Les factures déjà dans l'application sont conservées.

Essayer tous les cas en mode test#

Avec une clé de test, aucun argent ne circule et rien n'arrive sur un vrai téléphone. pismile simule la réponse du client environ 10 à 20 secondes après l'envoi, selon les derniers chiffres du montant :

Les demandes de test sont marquées (test) partout et ne sont jamais facturées.

Passer aux vrais paiements#

1. Vérifiez les conditions

   • Votre organisation est vérifiée.

   • Votre accès participant est enregistré et son test réussit.

   • Votre abonnement Sage 100 est en cours.

2. Créez une clé de production

   Console → Encaissement → Connecteurs → carte Sage 100 → Nouvelle installation, nom « Sage production », Test décoché, Créer la clé. Elle commence par pmc_live_.

3. Remplacez la clé dans l'application

   Paramètres → Connexion à pismile → collez la clé pmc_live_… → Enregistrer. Le résultat doit indiquer « en production ».

4. Faites un premier essai réel

   Ajoutez une petite facture à votre propre nom (100 F CFA, votre numéro comme alias), envoyez la demande et payez-la. Quand elle passe Payée, vérifiez que l'argent est sur votre compte. Révoquez ensuite l'installation de test dans la console.

Sécurité et données#

• Où sont les données : sur l'ordinateur central, dans C:\ProgramData\pismile\Agent Sage 100, dossier lisible seulement par Windows et les administrateurs.

• Secrets chiffrés : la clé pismile, le mot de passe SQL éventuel et le certificat sont chiffrés par Windows. Les mots de passe des utilisateurs ne sont jamais enregistrés en clair.

• Échanges chiffrés : entre les postes et l'ordinateur central (https, empreinte vérifiée), et vers pismile (https).

• Aucun port ouvert vers Internet : seulement des appels sortants vers pismile.

• Sage : jamais modifié en mode manuel ; lecture seule en mode automatique.

• L'argent va directement du client à votre compte ; pismile ne le détient jamais.

Mises à jour, sauvegarde, désinstallation#

• Mettre à jour : installez le nouveau fichier .msi par-dessus l'ancien, sur l'ordinateur central puis sur chaque poste. Factures, demandes, comptes et réglages sont conservés.

• Sauvegarder : arrêtez le service (Services Windows → pismile Encaissement pour Sage 100 → Arrêter), copiez le dossier C:\ProgramData\pismile\Agent Sage 100, puis redémarrez le service. La clé pismile chiffrée ne se relit que sur ce même ordinateur : sur un nouvel ordinateur, collez de nouveau la clé.

• Désinstaller : Paramètres Windows → Applications → pismile Encaissement pour Sage 100 → Désinstaller. Les données restent dans le dossier ci-dessus ; supprimez-le pour tout effacer.

En cas de souci#

Besoin d'aide ? Menu Aide et contacts de l'application : Copier ces informations puis écrivez à support@pismile.com ou sur WhatsApp au +228 78 90 15 79, en collant les informations copiées.

Pour les statuts, délais et limites communs à tous les connecteurs, lisez Le connecteur au quotidien.