# Concepts clés

Cette page présente les principaux concepts One Platform utilisés dans les flux de gestion client, d'activation de service, de suivi et de facturation.

## Concepts principaux

| Concept | Description |
|  --- | --- |
| Organization | Périmètre opérationnel utilisé pour gérer les utilisateurs, services et clients. |
| User | Identité MyNamirial ayant accès aux fonctions One Platform. |
| Consumer | Entité pouvant représenter un client, une entité légale, un partenaire ou une unité interne. |
| Contract | Accord utilisé pour activer un ou plusieurs services pour un client. |
| Business Relation | Lien entre produit, entité légale, chemin client et intégrateur. |
| Consumption | Valeur d'utilisation enregistrée pour une relation commerciale et une métrique produit. |
| Product Metric | Définition de ce qui est mesuré pour un produit, par exemple transactions, documents ou volume. |


Les termes techniques comme attributs, compteurs et modèles de prix ne sont introduits que lorsqu'ils sont nécessaires.

## Clients

Un client est une personne ou une société impliquée dans le flux d'achat ou de vente d'un produit Namirial.

Le terme inclut :

- les clients directs ;
- les clients indirects ;
- les utilisateurs finaux ;
- les revendeurs.


Les données client sont organisées dans les groupes principaux suivants :

| Groupe de données | Objectif |
|  --- | --- |
| Données de base | Données minimales requises pour chaque consommateur, comme l'identifiant, le nom, le pays et le type de client. |
| Données fiscales | Informations fiscales utilisées pour définir le statut fiscal du client. |
| Données de facturation | Données requises lorsque le client est facturable. |
| Données de naissance | Informations de naissance pour les clients personnes physiques. |
| Données de résidence | Informations de résidence pour les clients personnes physiques. |
| Coordonnées | E-mails, adresses PEC et numéros de téléphone. |
| Données personnalisées | Métadonnées et attributs spécifiques à une ligne produit. |


Les fiches client peuvent représenter différents rôles commerciaux selon la relation avec le produit ou le service.

## Contrats

Un contrat est le modèle d'activation de service pour un client.

Un contrat contient le contexte client et les services à activer. Chaque ligne de service peut inclure des données de provisionnement, des données de prix, un état de cycle de vie et la relation commerciale utilisée pour la mesure et la facturation.

Les contrats servent à prendre en charge :

- l'activation des services ;
- les flux de signature numérique ;
- le provisionnement des produits ;
- le reporting et le support de facturation.


## Consommations

Une consommation est un ensemble de valeurs de métriques représentant l'utilisation d'un produit pour une relation commerciale spécifique.

### Métriques

Les métriques définissent ce qui est mesuré pour une ligne produit.

Exemples :

- nombre de documents ;
- taille des documents ;
- nombre de transactions.


Une métrique peut inclure une unité de mesure.

### Types de métriques

| Type | Comportement |
|  --- | --- |
| Incremental | Les valeurs sont ajoutées aux consommations précédentes. |
| Total | La dernière valeur remplace le total précédent pour la même période. Les totaux manquants comptent pour zéro. |
| Total persistent | Similaire à total, mais continue d'utiliser la dernière consommation envoyée jusqu'à ce qu'une valeur plus récente soit disponible. |


### Attributs

Les attributs décrivent les dimensions qualitatives d'une consommation.

Les relations commerciales répondent à la question de qui a produit la consommation. Les attributs décrivent à quoi la consommation se rapporte.

Par exemple, un produit Archive peut utiliser des attributs pour regrouper les métriques par type de document.

### Timestamp et datestamp

- **Timestamp** identifie le moment où la consommation a été effectuée.
- **Datestamp** identifie la date de publication utilisée pour regrouper l'utilisation par jour.