Usage Data

Un Usage Data permet de gérer les données variables d'un Contract Item.

Introduction

Dans Cn, les "Usage Data" désignent les données de consommation utilisées pour la Facturation des éléments variables d’une période à travers des Contract Item de type:

  • Usage Based Recurring Pricing / Tarification Récurrente basée sur les Usages

  • Usage Triggered Invoicing / Facturation déclenchée par les Usages

Ces Contract Item sont dits de type "variable".

A la fin de chaque période de facturation d'un Contrat Item de type variable, Cn :

  1. collecte tous les Usage Data associés

  2. utilise le Usage Data Calculator défini au niveau du Contract Item pour calculer la quantité à facturer sur la période.

Plus précisément une Usage Data est une valeur horodatée liée à un Contract ou un Contract Item.

Les Usages Data peuvent être créées et mises à jour au travers de plusieurs mécanismes:

  • via l'interface Web de Cn

  • via l'API

  • par des imports CSV

Ce document décrit l'utilisation de l'interface Web de Cn et les règles métiers valables pour tous les mécanismes de saisie.

Les Usage Data sont accessibles via le menu Cn / Usage Data / Usage Data

Structure des Usage Data

L'écran des Usage Data est structuré en plusieurs parties:

  • Statut

  • Contract Reference

  • Timestamp

  • Value

  • Notes

  • Invoicing

Statut

Le cycle de vie d'une Donnée de Consommation (DC) est le suivant:

  • Draft :

    • La Donnée (DC) est en cours de saisie

    • Tous les champs sont modifiables

  • Pending

    • la Donnée (DC) est confirmée; elle est en attente de facturation

    • Tous les champs sont bloqués sauf "Notes"

  • Collected

    • La Donnée (DC) est utilisée dans une facture. Le champ "Invoicing Schedule" permet d'y accéder.

  • Excluded : Donnée non prise en compte

Contract Reference

Les Usage Data doivent être associées à :

Contract : Lorsque que les Usage data sont affectées à un contract seulement, le champ ContractItem restant vide, les usage data seront associées à tous les contractitems et pourront être traitées par le Usage Data Calculator de chacun d'entre eux. La saisie du champ Contract est donc obligatoire.

Les Usage Data peuvent être associées à un ContractItem unique :

ContactItem : Il est possible d'associer les usages data à un seul ContractItem. Le champ External Reference permet à un système distant de définir une clef d'accès qui lui est propre. Cn permet de retrouver des Données de Consommation à partir des "External Reference".

Value

Start permet d'horodater la "Donnée de Consommation".

End permet de gérer les données de consommation correspondantes à des périodes.

Value : valeur de la donnée d'usage saisie

  • Usage Data Simple

  • Usage Data Agrégée

    Il existe 2 types de données agrégées :

    • Données agrégées Custom : Ces données ont pour vocation à être manipulées par les utilisateurs Cn285. Elles doivent donc être présentées dans l'interface de façon intelligibles à travers des champs Custom Exemple de données agrégées custom "muppy.io" : le modèle ci-dessous permet de facturer des services d'une solution Devops en fonction de plusieurs critères : nb de CPU, GB de RAM et typologie (Core, LxC, PostgreSQL)

Exemple de données agrégées de type custom
  • Données agrégées de type JSON : Ces données de type complexes, sont issues d'un autre système et n'ont pas vocation à utiliser, visualiser ou interpréter par un utilisateur. Elles sont intégrées dans un JSON

Qualifier : permet de définir la donnée d'usage (kg, Km, Mo, GigaOctet, hits, clics, minutes, ...)

Description : en cas de besoin

Analytics

permet d'affecter aux usage data des axes analytiques en vue de traitements BI futurs

Axis1 : Axe analytics

Axis2 : Axe analytics

Invoicing

Do not Invoice : bloque la facturation de l'entrée de Usage Data

Invoicing Schedule : Lorsqu'une Donnée de Consommation a été "collectée", ce champ indique l 'IS dont la quantité inclut la Donnée de Consommation

Invoicing Notes : En cas de besoin

Cas d'utilisations

Saisie d'une donnée de Consommation Simple

Le cas le plus simple correspond à la saisie d'une Donnée de Consommation liée à un Contract Item de type variable.

Pour cela, il faut saisir:

  • Contract

  • Contract Item (optionnel)

  • Start

  • Value : valeurs simples qui permettent de gérer les données de consommation et qui peuvent être exprimées sous forme de quantités numérique.

    • Par exemple:

      • des kilo octets

      • des minutes

      • des kilowattheures

    • Les valeurs simples sont transmises sous forme de listes de nombres à un Usage Data Calculator dont le rôle est de les transformer en quantité (à facturer).

  • State = Pending

Rappel la Donnée sera ignorée tant que le State sera Draft

Saisie de données de Consommation Agrégées

Les valeurs agrégées permettent de gérer les cas suivants:

  • facturation de plusieurs Contract Items d'un même Contract dont les quantités proviennent du même Usage Data.

    • Dans ce cas, les valeurs agrégées sont liées au Contract.

Ce cas correspond à la saisie d'une Donnée de Consommation composite utilisée pour calculer les quantités à facturer de plusieurs Contract Item de type variable.

Dans ce cas, il faut saisir les valeurs des champs:

  • Contract

  • Start

  • JSON Data Ensemble de données (JSON) agrégées permettant de facturer sur la base de modèle plus complexe

    • Les valeurs agrégées sont des objets JSON qui permettent de stocker des données composites ou complexes.

  • State = Pending

Rappel la Donnée sera ignorée tant que le State sera Draft

  • Exemple:

    • {

    • "espace_disque_go": 15,

    • "cpu": 8,

    • "espace_disque_backup": 13

    • }

  • facturation d'un Contract Item dont la quantité dépend de plusieurs paramètres.

    • Dans ce cas les valeurs agrégées sont liées au Contract Item

    • Exemple:

      • {

      • "espace_disque_utilisee_go": 1599,

      • "espace_disque_inclu_go": 800,

      • "tarif_go_supplementaire_euro": 1,27

      • }

      • Dans ce magine que le Usage Data Calculator doit calculer le coût des Go en dépassement (espace_disque_utilisee_go - espace_disque_inclu_go) * tarif_go_supplementaire_euro

Actuellement, un Usage Data Calculator ne peut pas accéder en même temps aux valeurs des champs Values et aux valeurs des champs JSON Data.

Notes

Il s'agit d'un champ texte dont le contenu est disponible pour impression sur les "Relevés de consommations" joints aux factures dans le cas de facturation détaillées.

Last updated