Aller au contenu

🔌 Intégrations

Tout se règle dans Paramètres → Intégrations, qui compte cinq onglets : E-mail, Modèles d'emails, Services, Automatisations et SSO.


E-mail (SMTP)

Le serveur qui envoie vos devis, factures et notifications, magasin par magasin.

Champ Exemple
Nom d'expéditeur Garage du Centre
Hôte SMTP smtp.hostinger.com
Port 587
Utilisateur noreply@mongarage.fr
Mot de passe Mot de passe du compte d'envoi

Enregistrez avec le bouton Enregistrer de la barre d'onglets.

Sans serveur SMTP, les documents restent téléchargeables en PDF et s'envoient depuis votre messagerie habituelle.

L'onglet Modèles d'emails règle, lui, le texte des messages envoyés — deux réglages voisins mais distincts.


Services : la galerie de connecteurs

L'onglet Services présente les connecteurs par catégorie, chacun avec une pastille d'état : Connecté, Non configuré, Bientôt ou Configurer.

Catégorie Connecteur Rôle
E-commerce WooCommerce Synchro commandes & stocks
E-commerce Boutique E-Commerce Clés de l'API publique pour votre site de vente
E-commerce Shopify, PrestaShop Bientôt disponible
Paiements Stripe Paiement par carte
Paiements Alma Paiement en 3x / 4x
Paiements PayPlug Paiement par carte
Paiements Terminal de paiement Envoyer le montant au terminal du comptoir — voir Terminal de paiement
Logistique Sendcloud Étiquettes et suivi (Colissimo, Chronopost, Mondial Relay, DPD)
Email & SMS Brevo Email & SMS par magasin
Email & SMS SMS Marketing Campagnes SMS via Brevo
Comptabilité Regate Export des factures vers le cabinet
Comptabilité Atrium Notifications Epsylon envoyées dans vos salons d'équipe
Logiciels partenaires Iryséon Ventes de cartes à collectionner, encaissées par Epsylon — voir Iryséon
Automatisation API et notifications Relier Epsylon à vos autres logiciels (Make, Zapier, n8n…) — voir API et notifications

ℹ️ PrestaShop. La carte affiche encore « Bientôt », mais le module existe : il se télécharge sur epsylon-cie.fr/prestashop et se branche avec une clé de l'API publique (carte Boutique E-Commerce), comme l'extension WooCommerce.

Toutes les clés secrètes sont chiffrées avant enregistrement et ne ressortent jamais de l'application.


WooCommerce

  1. Activez l'interrupteur en haut du panneau
  2. Créez une clé API (bouton + Créer une clé) et reportez-la dans l'extension Epsylon installée sur WordPress
  3. Choisissez le vendeur par défaut associé aux commandes — le bouton Créer WordPress Bot crée au besoin un utilisateur dédié
  4. Choisissez le type de document par défaut : Brouillon, Bon de commande ou Facture
  5. Renseignez éventuellement un email de notification

La synchronisation des stocks et des prix ne se règle pas ici mais dans l'extension WordPress (WooCommerce → Epsylon Sync) : c'est elle qui interroge Epsylon, et non l'inverse. Les commandes web arrivent en brouillon, à contrôler puis valider comme n'importe quel document.


Stripe

  1. Créez un compte sur stripe.com
  2. Renseignez la clé publique (pk_live_…) et la clé secrète (sk_live_…)
  3. Ajoutez le secret webhook (whsec_…) et choisissez la devise
  4. Cliquez sur Configurer Stripe

Dans Stripe, déclarez l'URL de webhook affichée dans le panneau et activez les événements checkout.session.completed et checkout.session.async_payment_failed.

Utilisez les clés de test (pk_test_… / sk_test_…) pendant la mise au point.


Alma

Renseignez votre clé API Alma puis Configurer Alma. L'URL IPN à déclarer chez Alma est affichée dans le panneau. Le paiement fractionné est proposé à partir de 200 € de transaction.


Sendcloud

Le connecteur se règle à deux niveaux : l'enseigne ou ce magasin, avec un sélecteur de portée. Chaque réglage indique s'il est hérité de l'enseigne ou propre au magasin, et un magasin peut choisir Hérite, Oui ou Non.

On y règle : Expédition activée, Mode simulation (aucune étiquette réellement achetée), la clé publique et la clé secrète Sendcloud (leur accès API demande au minimum l'offre Lite), l'adresse expéditeur (son identifiant Sendcloud), le poids par défaut appliqué aux articles sans poids, et le poids d'emballage ajouté une fois par colis.


Brevo et SMS

Brevo utilise votre propre compte : clé API v3, email expéditeur (vérifié chez Brevo) et nom d'expéditeur. Un bouton Tester valide la configuration.

SMS Marketing s'active séparément et demande un nom d'expéditeur affiché sur le téléphone du destinataire.


Regate

L'intégration est temporairement suspendue : Regate n'ouvre pas son API publiquement pour le moment. Les champs sont visibles mais désactivés. En attendant, exportez vos écritures depuis Comptabilité → Exports.


Atrium

Atrium envoie les notifications Epsylon dans vos salons d'équipe. Dans Atrium, créez un webhook (Réglages du salon → Intégrations → Créer un webhook) et collez son URL ici. Chaque destination peut être filtrée par type d'événement (réparations, SAV, documents, paiements, alertes stock, nouveaux clients, marketing, planning) ; aucun événement coché = tous les types.


Iryséon

Le logiciel de vente Iryséon (boutiques de cartes à collectionner) a son propre bloc : on y coche ce qu'il a le droit de faire (Encaisser les ventes, Ouvrir et clôturer la caisse), puis on crée un accès dont la clé et le secret se collent dans Iryséon. Les ventes sont numérotées, signées et encaissées par Epsylon. Tout est expliqué dans Iryséon.


API et notifications (Make, Zapier, n8n…)

Pour relier Epsylon à vos autres logiciels (suivi commercial, assistance client…) à travers un outil d'automatisation. Deux blocs :

  1. Une clé d'API : votre outil peut lire les clients, devis, factures, règlements et réparations du magasin, créer ou modifier une fiche client, et créer un devis brouillon. Il ne peut jamais émettre une facture ni encaisser.
  2. Des adresses de notification : Epsylon prévient votre outil à chaque événement coché (client créé, devis accepté, facture payée…).

Mode d'emploi complet et exemples de scénarios : API et notifications.

ℹ️ À ne pas confondre avec l'onglet Automatisations ci-dessous, qui envoie des e-mails et SMS à vos clients.


Automatisations

Réservé au rôle Admin système. Des messages partent tout seuls sur un événement, par email ou SMS :

Déclencheur Quand
Facture payée La facture passe au statut Payé
Réparation terminée La PEC passe au statut Terminé
Client inactif Chaque jour, aux clients sans achat depuis N jours
Anniversaire Le jour de l'anniversaire du client
Relance impayé Facture impayée depuis N jours (inactif par défaut)

Le texte accepte des variables reprises du client, du magasin et du document : {{prenom}}, {{magasin}}, {{numero_doc}}, {{montant_ttc}}, {{reste_a_payer}}…


SSO — Authentification unique (OIDC)

Réservé à la formule Enterprise et au rôle Admin système. Vos collaborateurs se connectent alors avec leur compte d'entreprise (Microsoft, Google, Okta…) plutôt qu'avec un mot de passe Epsylon.

Réglage Description
URL de l'émetteur (Issuer) L'adresse de découverte OIDC de votre fournisseur d'identité. Le bouton Tester vérifie qu'elle répond avant d'enregistrer
Client ID L'identifiant de l'application déclarée chez votre fournisseur
Client Secret Le secret de cette application — chiffré côté serveur, jamais réaffiché ensuite (laissez le champ vide pour le conserver tel quel)
Nom affiché Le nom présenté au moment de se connecter
Domaines email autorisés Séparés par des virgules : seules ces adresses peuvent passer par le SSO. Laissé vide, aucun domaine n'est exclu
Rediriger automatiquement les utilisateurs vers le SSO La connexion part directement chez le fournisseur, sans passer par le formulaire de connexion

L'URL de l'émetteur et le Client ID sont obligatoires ; le secret l'est aussi à la première configuration.

Une fois la configuration enregistrée, elle peut être basculée entre Actif et Désactivé, ou supprimée — dans ce dernier cas, les utilisateurs se reconnectent avec leur mot de passe. Un guide de configuration rapide rappelle les étapes côté Microsoft et Google, ainsi que l'URL de retour à déclarer chez votre fournisseur.


API publique Epsylon

Le connecteur Boutique E-Commerce ouvre l'API REST (base https://app-epsylon.fr/api/public/v1/shop, réponses JSON) qui permet à votre site de vente ou à un outil tiers de lire votre catalogue, vos occasions et votre flotte de location, et de créer des commandes.

Créer une clé

Depuis le panneau, + Créer une clé, puis nommez-la et cochez ses permissions. La clé est rattachée à un magasin et ne voit que son catalogue. Une clé peut ensuite être révoquée ou supprimée.

Permission Donne accès à
Lecture du catalogue Articles, occasions, magasins, suivi d'une commande par son client
Création de commandes Commandes et paiements de la boutique, retours, locations
Modification des articles Fiches, visuels et documents des articles
Modification du stock Quantités en stock envoyées par un site ou un connecteur
Lecture de toutes les commandes Liste et détail des commandes, avec nom et e-mail des clients (administration du site)
Accès complet boutique Toutes les permissions ci-dessus

⚠️ Accès complet boutique n'ouvre pas les clients, devis, factures ni réparations. Ces permissions-là servent à relier Epsylon à un CRM et se cochent une par une : voir API et notifications.

Le secret n'est affiché qu'une seule fois, à la création. Copiez-le immédiatement.

Chaque requête envoie deux en-têtes : X-API-Key et X-API-Secret.

Principaux appels

Méthode Chemin Description
GET /products Lister le catalogue
GET /products/:id Détail d'un produit
GET /products/:id/availability Disponibilité et stock
GET /stores Lister les magasins
POST /orders Créer une commande
GET /orders/:id Suivi d'une commande

Une clé absente ou invalide renvoie 401, une permission insuffisante 403.


Exports comptables

Voir Exports comptables.