Connexion sortante
Chiffrée, sur le port 443. Elle traverse le NAT et les pare-feu usuels : aucune redirection de port, aucun VPN.
L’agent Ponteo Connect, discret et sous contrôle
Installé sur le serveur où tourne Acomba ou Avantage, l’agent ouvre une connexion sortante sécurisée vers Ponteo Connect et exécute les requêtes de l’API par le SDK officiel du logiciel comptable. Rien n’est exposé sur Internet.
Téléchargement libre en tout temps. Windows 10 / Server 2016 ou plus récent. Une clé de licence est nécessaire pour relier une compagnie.
Un service, une connexion sortante, une file par compagnie
Reconnexion automatique
Une connexion interrompue est rétablie seule, avec des délais croissants entre les tentatives.
Une file par compagnie
Chaque compagnie a sa connexion et sa file : les compagnies travaillent en parallèle, les requêtes d’une même compagnie en série.
Journal des écritures
Chaque écriture est notée avant et après son exécution. Même après un arrêt brutal du serveur, une facture n’est pas écrite deux fois.
Sur votre serveur Windows, en quatre étapes
Le service Windows
Démarre avec Windows, sans qu’une session soit ouverte. Il maintient la connexion vers api.ponteo.ca, reçoit les requêtes, les exécute dans le logiciel comptable et tient le journal des opérations.
L’application de la zone de notification
Lancée à l’ouverture de session, elle affiche l’état de l’agent par une icône près de l’horloge et donne accès à la fenêtre de configuration.
Prérequis
- Windows 10 ou Windows Server 2016, ou une version plus récente.
- .NET Framework 4.8, présent d’origine sur ces versions de Windows. S’il manque, l’installateur le télécharge et l’installe lui-même.
- Acomba ou Avantage installé sur le serveur, avec son SDK.
- Accès sortant HTTPS (port 443) vers
api.ponteo.ca. Aucun port entrant. - Un utilisateur du logiciel comptable réservé à l’intégration, avec les droits nécessaires sur les modules utilisés.
- Une clé de licence Ponteo Connect par compagnie à relier, et des droits d’administrateur pour l’installation.
Installation
-
Téléchargez l’installateur et obtenez une clé
Téléchargez l’installateur (
PonteoAgent-x.y.z.exe) en tout temps. Votre clé de licence vous parvient par courriel après l’abonnement à un forfait. -
Exécutez-le sur le serveur comptable
L’installateur vérifie d’abord la présence de .NET Framework 4.8 et l’installe au besoin (téléchargement depuis Microsoft, un redémarrage peut être demandé). L’assistant installe ensuite le service en démarrage automatique et l’icône de la zone de notification. Si le SDK d’Acomba ou d’Avantage (
AcoSDK.dll) n’est pas encore enregistré dans Windows, il vous demande de sélectionner le fichier AcoSDK.dll (bouton « Parcourir ») et l’enregistre pour vous. Le logiciel comptable n’est pas modifié. -
Configurez vos compagnies
Ouvrez Ponteo (icône près de l’horloge, raccourci du bureau ou menu Démarrer), indiquez le dossier d’installation d’Acomba ou d’Avantage, ajoutez chaque compagnie, puis cliquez sur Tester cette compagnie.
-
Enregistrez
Les compagnies actives se connectent aussitôt : dès que le bandeau et l’icône passent au vert, l’API répond pour la compagnie. Vérifiez-le avec
GET /v1/health. -
Mettez à jour quand vous le décidez
Aucune mise à jour à votre insu : bouton Mise à jour… de la fenêtre ou menu de l’icône. Avec une licence valide, l’agent télécharge un correctif signé numériquement, vérifie sa signature et chaque fichier, puis l’applique en quelques secondes, sans installateur, avec retour automatique à la version précédente en cas de problème. À votre demande, le support Ponteo Connect peut aussi appliquer une mise à jour corrective depuis la gestion des licences. La configuration est conservée.
Fenêtre de configuration
Un bandeau indique l’état en un coup d’œil. Le dossier d’installation d’Acomba ou d’Avantage, commun à toutes les compagnies, est vérifié dès sa sélection (présence du programme). Les réglages du service s’y trouvent aussi : compte Windows utilisé et démarrage avec Windows. Ajoutez ensuite une entrée par compagnie :
- Clé de licenceLa clé Ponteo Connect de la compagnie.
- LogicielAcomba ou Avantage.
- Dossier de la compagnieLe dossier de données de la compagnie dans le logiciel comptable.
- Utilisateur et mot de passeCeux que l’agent emploie pour ouvrir la compagnie (case « Aucun mot de passe » au besoin).
- Autoriser les écrituresCase décochée par défaut. Tant qu’elle l’est, toute écriture est refusée avec
WRITE_DISABLED, même si la licence la permet. La simulation (dryRun) reste possible.
Tester cette compagnie ouvre la compagnie et valide la licence. Les boutons Redémarrer le service, Redémarrer Ponteo, Journal et Mise à jour… complètent la fenêtre.
L’icône de la zone de notification
Clic gauche : ouvre la fenêtre de configuration. Clic droit : menu Ouvrir, Rechercher une mise à jour, Journal, Redémarrer le service, Redémarrer Ponteo, Quitter.
Grise : arrêté
Service arrêté ou aucune compagnie configurée.
Verte : en écoute
Licence valide, l’agent attend les requêtes.
Rouge : licence invalide
Clé inconnue, expirée ou révoquée : pas d’écoute.
Orange : connexion dégradée
Au moins une compagnie n’est pas en écoute (connexion ou ouverture en cours, reconnexion).
Prêt à relier votre comptabilité ?
Choisissez un forfait : votre clé de licence et le lien de téléchargement de l’agent vous parviennent par courriel après le paiement. Une question avant de commencer ? Écrivez-nous.