Six étapes pour activer votre premier module Asterio
Vingt minutes suffisent pour passer d’un compte Asterio nu à un module Asteriomod en production. Voici la séquence recommandée par notre équipe intégration.
Ouverture du compte Asteriomod — 5 min
Passez commande depuis la page /catalog en sélectionnant un premier module. L’ouverture du compte se fait à la volée : nom, e-mail professionnel, raison sociale, numéro de TVA le cas échéant. Aucun mot de passe : l’accès se fait par lien magique par e-mail. Vous recevez immédiatement votre numéro de dossier (format AS-XXXX).
Génération d’une clé API dédiée dans Asterio — 3 min
Dans votre PMS Asterio, ouvrez Paramètres → API → Clés d’intégration. Cliquez sur « Générer une clé », nommez-la explicitement (par exemple « ABS — Facture PDF — Prod ») et notez la valeur affichée. Cette valeur ne sera plus jamais visible en clair une fois la fenêtre fermée.
Connexion du module à votre compte Asterio — 4 min
De retour dans votre espace Asteriomod, ouvrez la fiche du module que vous venez d’acheter. Collez la clé API dans le champ dédié, saisissez l’identifiant de propriété (property id) puis cliquez sur « Vérifier la connexion ». Un contrôle en trois points s’exécute : validité, autorisations, latence.
Configuration du module — 6 min
Chaque module propose un assistant en trois panneaux. Le deuxième panneau contient les paramètres fonctionnels (par exemple : mode de numérotation des factures, canaux Slack cibles, périmètre des propriétés à inclure). Les valeurs par défaut sont recommandées pour un premier usage : vous pouvez les affiner ensuite.
Test de bout en bout — 2 min
Toujours dans l’assistant, ouvrez le troisième panneau et lancez « Test de bout en bout ». Le module tire un jeu de données de test réel, applique sa logique et vous restitue le résultat à l’écran. Aucune écriture n’est encore faite dans Asterio à ce stade : il s’agit d’une simulation contrôlée.
Activation en production — 1 min
Si le test est concluant, cliquez sur « Activer en production ». Le module bascule au statut « Actif ». La première synchronisation complète démarre dans les quinze minutes suivantes. Vous recevez une notification e-mail de bienvenue qui rappelle le calendrier de rotation de clé et les liens vers vos journaux d’appels.
Après la mise en route
Une fois votre premier module actif, revenez à cette page pour ajouter un second module. Chaque nouvelle activation suit la même séquence, avec la même durée moyenne de vingt minutes. Nous recommandons d’espacer les activations de 24 à 48 heures : vous laissez ainsi le temps aux journaux de remonter et vous validez la stabilité avant d’ajouter une nouvelle charge.
Pour aller plus loin, la Leçon 2 de l’Académie détaille les bonnes pratiques d’usage de l’API Asterio en production : rotation des clés, rate-limiting, journalisation et dépannage.