Mise en route de votre premier module Asterio

Objectif de la leçon

À la fin de cette leçon, vous aurez un module Asteriomod actif, connecté à votre compte Asterio via une clé API dédiée, et vous saurez lire les indicateurs de santé de la connexion depuis votre tableau de bord. Nous prenons pour exemple le Module Facture Client PDF (25 €/mois), mais la procédure est identique pour les dix modules du catalogue.

Prérequis

• Un compte Asterio actif, plan Standard ou supérieur, avec accès API activé côté PMS.
• Une adresse e-mail professionnelle valide pour l’ouverture du compte Asteriomod.
• Les identifiants de facturation de votre structure (raison sociale, numéro de TVA intracommunautaire pour les entités assujetties, adresse postale).
• Environ vingt minutes disponibles, sans interruption, pour enchaîner les quatre étapes.

Étape 1 — Création du compte Asteriomod

Rendez-vous sur notre page commande et sélectionnez le module que vous souhaitez activer. Renseignez votre nom complet, votre adresse e-mail professionnelle, la raison sociale et, le cas échéant, votre numéro de TVA. Notre plateforme fonctionne en accès par e-mail : aucun mot de passe ne vous est demandé à la création. Un lien magique vous sera envoyé à chaque connexion. Cochez l’acceptation des Conditions et de la politique RGPD, puis validez.

Le paiement s’effectue immédiatement pour la première mensualité. Vous recevez en moins de deux minutes un e-mail de confirmation contenant votre numéro de dossier (format AS-XXXX) et un premier lien d’accès à votre espace personnel.

Étape 2 — Ajout du module dans votre espace

Cliquez sur le lien d’accès reçu par e-mail. Votre espace personnel s’ouvre sur la vue Modules. Le module que vous venez d’acheter y apparaît avec le statut « À configurer ». Cliquez sur son intitulé pour ouvrir la fiche de configuration ; l’écran vous présente un assistant en trois panneaux : Connexion Asterio, Paramètres du module, Test de bout en bout.

Restez sur le premier panneau. Aucune donnée ne circule tant que la clé API n’a pas été enregistrée : vous pouvez fermer et rouvrir l’écran sans crainte, l’assistant reprend là où vous étiez.

Étape 3 — Saisie de la clé API Asterio

Ouvrez en parallèle votre PMS Asterio dans un autre onglet du navigateur. Dans Asterio, allez dans Paramètres → API → Clés d’intégration et cliquez sur « Générer une clé ». Nommez la clé « Asteriomod » pour la retrouver facilement dans vos journaux d’audit. Copiez la valeur affichée : elle ne sera plus jamais visible en clair après cette étape, conformément à la politique de sécurité d’Asterio.

Revenez dans votre espace Asteriomod. Collez la clé dans le champ « Clé API Asterio » puis saisissez l’identifiant de propriété (property id) qui figure juste au-dessus du bloc Clés dans votre compte Asterio. Cliquez sur « Vérifier la connexion ». Un contrôle en trois points s’exécute : validité de la clé, autorisations attribuées, latence moyenne. Un feu vert signifie que le module peut lire et écrire dans le périmètre nécessaire.

Étape 4 — Première synchronisation

Passez au deuxième panneau (Paramètres du module) et acceptez les valeurs proposées par défaut : elles correspondent aux réglages recommandés pour un premier usage. Ouvrez le troisième panneau et lancez « Test de bout en bout ». L’assistant tire un jeu de données de test (une ou deux réservations récentes), applique la logique du module et vous restitue le résultat à l’écran. Aucune facture n’est encore émise et aucune écriture n’est faite dans Asterio à ce stade.

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 qui suivent et se répète ensuite selon la fréquence propre à chaque module (temps réel, quart d’heure ou nuit).

Vérification finale

• Le module apparaît en statut « Actif » dans votre espace.
• La page « Journaux API » affiche des appels réussis (code 200) toutes les quelques minutes.
• Une notification e-mail de bienvenue vous confirme la mise en service et rappelle la procédure de rotation de clé.

Vous êtes prêt pour la Leçon 2 — Bonnes pratiques d’usage de l’API Asterio, qui aborde la gestion des clés, le rate-limiting et la journalisation.