# Gestion des abonnements

La section Gestion des abonnements permet aux Propriétaires et aux Gestionnaires de compte du bâtiment de consulter, gérer et modifier le plan d'abonnement d'un bâtiment. Elle offre une visibilité complète sur les cycles de facturation, l'utilisation actuelle par rapport aux limites du plan, l'historique des factures et les options de changement de plan — y compris les extensions lorsque les limites d'utilisation sont atteintes.

***

## Vue d'ensemble

Chaque bâtiment sur Magma est régi par son propre abonnement. Il existe 3 plans d'abonnement :

| Plan          | Description                                                                                                                                                                 |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Essential** | Le plan d'entrée de gamme avec des limites modérées sur les parties prenantes, le stockage, les opérations API et les notifications par e-mail. Pas de support prioritaire. |
| **Premium**   | Un plan de niveau supérieur avec des limites étendues et un support prioritaire inclus.                                                                                     |
| **Infinity**  | Le plan haut de gamme avec des limites maximales ou illimitées dans toutes les dimensions et un support prioritaire.                                                        |

***

## Accès à la gestion des abonnements

La gestion des abonnements est accessible via :

* Les **paramètres du bâtiment** → onglet Abonnement.
* Le menu d'action rapide (⋯) sur la carte du bâtiment dans le Tableau de bord → Voir l'abonnement.

Seuls les **Propriétaires** et les **Gestionnaires de compte** peuvent accéder à la gestion des abonnements.

***

## Modal des détails de l'abonnement

Le modal des détails de l'abonnement est organisé en 3 onglets :

***

### Onglet 1 : Détails

L'onglet Détails fournit une vue d'ensemble complète du statut et de l'utilisation de l'abonnement actuel.

#### Plan & Statut

| Champ                      | Description                                                                    |
| -------------------------- | ------------------------------------------------------------------------------ |
| **Plan**                   | Le nom du plan actuel (Essential, Premium ou Infinity).                        |
| **Statut**                 | L'état actuel de l'abonnement (voir les statuts ci-dessous).                   |
| **Période de facturation** | La fréquence de facturation : mensuelle ou annuelle.                           |
| **Changer de plan**        | Un bouton pour initier un changement de plan (ouvre l'onglet Changer de plan). |

**Statuts d'abonnement**

| Statut       | Description                                                                                                                       |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| **Actif**    | L'abonnement est à jour et toutes les fonctionnalités sont pleinement accessibles.                                                |
| **Annulé**   | L'abonnement a été annulé. Il reste actif jusqu'à la fin de la période de facturation en cours, après quoi l'accès est restreint. |
| **En pause** | L'abonnement a été temporairement mis en pause (ex. : à la demande de l'abonné).                                                  |
| **Expiré**   | La période de facturation de l'abonnement a pris fin sans renouvellement.                                                         |

#### Période en cours

Informations sur le cycle de facturation actif :

| Champ                | Description                                                              |
| -------------------- | ------------------------------------------------------------------------ |
| **Numéro de cycle**  | Le numéro séquentiel du cycle de facturation actuel (ex. : « Cycle 7 »). |
| **Début de période** | La date de début de la période de facturation en cours.                  |
| **Fin de période**   | La date de fin de la période de facturation en cours.                    |
| **Jours restants**   | Le nombre de jours restants dans la période de facturation en cours.     |

#### Période de licence

La période de licence globale pour l'abonnement (dates de début et de fin), qui peut différer du cycle de facturation individuel si une licence pluriannuelle a été achetée.

#### Limites

Un détail des limites d'utilisation du plan actuel par rapport à l'utilisation réelle actuelle :

| Limite                       | Description                                                                  |
| ---------------------------- | ---------------------------------------------------------------------------- |
| **Parties prenantes**        | Nombre actuel de parties prenantes par rapport au maximum du plan.           |
| **Opérations API**           | Nombre d'opérations API actuelles par rapport à l'allocation du plan.        |
| **Notifications par e-mail** | Nombre actuel par rapport à l'allocation du plan.                            |
| **Stockage (Go)**            | Utilisation actuelle du stockage par rapport au plafond de stockage du plan. |
| **Support prioritaire**      | Si le support prioritaire est inclus dans le plan actuel (Oui/Non).          |

Des barres de progression ou des indicateurs de pourcentage montrent à quel point chaque dimension est proche de sa limite.

#### Informations supplémentaires

| Élément                                          | Description                                                                                                  |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| **Avertissement d'annulation en fin de période** | Si l'abonnement a été configuré pour s'annuler en fin de période, une bannière d'avertissement est affichée. |
| **Date d'annulation**                            | Si l'abonnement a été annulé, la date d'annulation est affichée.                                             |

***

### Onglet 2 : Factures

Une liste complète de toutes les factures historiques pour l'abonnement de ce bâtiment.

Chaque ligne de facture comprend :

| Colonne               | Description                                                    |
| --------------------- | -------------------------------------------------------------- |
| **Numéro de facture** | Le numéro de référence unique de la facture.                   |
| **Date**              | La date à laquelle la facture a été générée.                   |
| **Badge Payé**        | Un badge vert « Payé » si la facture a été réglée avec succès. |
| **Montant**           | Le montant total facturé.                                      |
| **Télécharger**       | Un bouton pour télécharger la facture en PDF.                  |

Les factures sont listées en ordre chronologique inverse (les plus récentes en premier).

***

### Onglet 3 : Changer de plan

L'onglet Changer de plan vous permet de mettre à niveau ou de rétrograder le plan d'abonnement.

#### Tableau de sélection de plan

Un tableau comparatif affichant tous les plans disponibles (Essential, Premium, Infinity) avec leurs fonctionnalités et tarifs. Le plan actuel est mis en évidence.

#### Aperçu de la proratisation

Lorsque vous sélectionnez un nouveau plan, un **aperçu de la proratisation** est affiché avant de confirmer. Cela indique exactement ce qui sera facturé :

| Ligne                           | Description                                                                                                   |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Crédit de l'ancien plan**     | Le crédit proratisé pour les jours restants inutilisés sur le plan actuel.                                    |
| **Facturation du nouveau plan** | La facturation proratisée pour le nouveau plan d'aujourd'hui jusqu'à la fin du cycle de facturation en cours. |
| **Montant net dû aujourd'hui**  | La différence entre la nouvelle facturation et l'ancien crédit (peut être positive ou négative).              |
| **Nouveau prix récurrent**      | Le prix complet qui sera facturé à partir du prochain cycle de facturation.                                   |

#### Avertissement de violations

Si les limites du nouveau plan sont inférieures à votre utilisation actuelle dans n'importe quelle dimension, un **avertissement de violations** est affiché avant la confirmation. Par exemple :

> « Votre nombre actuel de parties prenantes (12) dépasse la limite du plan Essential (8). Passer à ce plan restreindra la possibilité d'ajouter de nouvelles parties prenantes jusqu'à ce que le nombre soit inférieur à 8. »

Cet avertissement prévient les rétrogradations accidentelles qui restreindraient immédiatement les opérations du bâtiment.

#### Case de confirmation

Une case de confirmation obligatoire doit être cochée avant de pouvoir soumettre le changement de plan. Le texte de la case résume le changement effectué et le montant net qui sera facturé.

***

## Modal Limite atteinte

Lorsqu'une limite de plan est atteinte (Parties prenantes, Stockage, Opérations API ou Notifications par e-mail), un **modal Limite atteinte** vous guide pour ajouter de la capacité sans nécessiter une mise à niveau complète du plan. Le modal suit un flux en 4 étapes :

### Étape 1 : Voir les limites atteintes

Un résumé clair des limites atteintes et dans quelle mesure. Par exemple :

> « Vous avez atteint votre limite de Parties prenantes (8/8 utilisées). »

### Étape 2 : Sélectionner le type d'extension

Choisissez quel type de capacité ajouter :

| Type d'extension             | Description                                                                                                         |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Parties prenantes**        | Ajouter de la capacité pour plus de comptes de parties prenantes.                                                   |
| **Stockage Go**              | Ajouter une capacité de stockage de documents supplémentaire.                                                       |
| **Notifications par e-mail** | Ajouter un quota de notifications par e-mail supplémentaire.                                                        |
| **Opérations API**           | Ajouter un quota d'opérations API supplémentaire.                                                                   |
| **Paiement à l'usage**       | Pour la facturation basée sur la consommation — payez uniquement ce que vous utilisez au-delà de la limite du plan. |

### Étape 3 : Sélectionner le forfait

Choisissez parmi les tailles de forfaits disponibles pour le type d'extension sélectionné. Les forfaits sont proposés en quantités prédéfinies (ex. : +10 Parties prenantes, +50 Go de stockage). Le tarif est affiché par forfait.

### Étape 4 : Aperçu avant confirmation

Un écran de résumé final affichant :

| Élément   | Description                                                                    |
| --------- | ------------------------------------------------------------------------------ |
| **Avant** | Limites et utilisation actuelles.                                              |
| **Après** | Nouvelles limites après l'application de l'extension.                          |
| **Tarif** | Le coût supplémentaire par période de facturation pour le forfait sélectionné. |

Un bouton **Confirmer** finalise l'achat de l'extension. Le paiement est traité immédiatement avec la carte enregistrée.

***

## Conseils pour la gestion des abonnements

* **Surveillez vos limites** dans l'onglet Détails régulièrement — s'approcher d'une limite en Stockage ou en Parties prenantes est un signal pour soit mettre à niveau, soit ajouter un forfait avant que les opérations ne soient impactées.
* **Téléchargez les factures** rapidement à des fins comptables et fiscales — les PDF sont toujours disponibles dans l'onglet Factures, quelle que soit la date à laquelle elles ont été générées.
* **Examinez attentivement l'aperçu de la proratisation** avant de changer de plan — si vous êtes en milieu de cycle, le montant net dû peut être plus ou moins élevé que prévu en fonction du timing.
* **Utilisez les extensions** pour une expansion ciblée de la capacité — si vous avez uniquement besoin d'un peu plus de stockage, une extension Stockage peut être plus rentable que de mettre à niveau l'ensemble du plan.
* La **facturation annuelle** offre généralement une réduction significative par rapport à la facturation mensuelle — si le bâtiment est un engagement à long terme, passer à la facturation annuelle dans l'onglet Changer de plan peut réduire les coûts.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mymagma.com/magma-documentation/fr/fonctionnalites/subscription-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
