Dictionnaire des champs

Voici un rappel du cas d'usage initial qui explique pourquoi Cloud Kicks utilise Frisbii : après leur récent succès avec Green Kicks, José a décidé de pousser la fidélisation des clients à un niveau encore plus avancé. Il souhaite envoyer aux vrais fans de Cloud Kicks un nouveau modèle de sneakers en début de chaque nouveau trimestre.

La première intéressée est Mme Jackson, la directrice de l'école de danse Jackson Mini Jazz Dance, qui est très contente des sneakers qu'elle a pu tester avec ses équipes. Elle veut que ses meilleures équipes portent de nouvelles chaussures de Cloud Kicks à chaque spectacle. Du coup, elle appelle la commerciale Candace pour en savoir plus sur les abonnements.

Vu que c'est le premier abonnement qu'elle va vendre, Candace demande à Linda de lui expliquer comment fonctionne l'abonnement dans Frisbii. Axel fait aussi partie de la formation, puisque c'est lui qui va mettre en place les abonnements à partir des offres créées par Candace.

Définition de l'abonnement

Objet	Description
Abonnement	Il s'agit d'un contrat par lequel on acquiert le bénéfice d'un service régulier moyennant un prix forfaitaire pour une durée déterminée, facturé de manière récurrente.

La relation avec les autres objets Frisbii

Voici l'extrait du Modèle Conceptuel de Données montrant l'objet Abonnement et ses relations avec les autres objets Frisbii. Il vous montre les liaisons entre les objets mentionnés et d'autres que nous allons découvrir au fur et à mesure de la lecture des articles.

Les champs de l'objet

Voici une liste des champs par section.

Informations

Compte	Référence (Compte)	Associé à l'objet Salesforce Compte (Account). Affiché sur le PDF de l'abonnement.
Donnée comptable	Référence (Donnée comptable)	Associé à l'objet Frisbii Donnée Comptable. Les informations de facturation et de comptabilité d'un compte. Affiché sur le PDF de l'abonnement. Voici le lien vers le module Les Données comptables - Dictionnaire des champs.
Contact	Référence (Contact)	Associé à l'objet Salesforce Contact.
Langue	Liste de sélection	En mettant cette balise language="{!sofactoapp__Abonnement__c.sofactoapp__Langue__c}" dans votre modèle de l'offre, la langue choisie sur l'abonnement sera appliquée aux PDF d'abonnement émis par cette raison sociale. Attention : Comme la TVA, la langue se configure à plusieurs niveaux (héritage). Vous pouvez également la configurer au niveau du compte, des données comptables, de la facture ou de l'offre.
Devise	Liste de sélection	Merci de suivre cet article Salesforce si vous voulez mettre en place une gestion multi devises. Attention : la devise peut être renseignée à plusieurs niveaux.
Raison Sociale	Référence (Raison sociale)	Associée à l'objet Frisbii Raison Sociale. Affichée sur le PDF de l'abonnement.
Date de souscription	Date	Date à laquelle le client souscrit l'abonnement.
Statut	Liste de sélection	Statut de l'abonnement : brouillon, activé, interrompu ou terminé. Il doit être activé pour pouvoir émettre des factures. Voici un article à ce sujet : Abonnements - La pré-validation des factures.
Verrouillé	Case à cocher	L'abonnement verrouillé n'est pas modifiable (utilisé notamment dans les processus asynchrones).

Options de récurrence

Abonnement précédent	Référence (Abonnement)	Utilisé pour les versions antérieures à la 3.64 : le renouvellement d'un abonnement était alors géré par création d'un nouvel abonnement et non par un avenant. Permet de lier l'abonnement à l'abonnement précédent.
Abonnement suivant	Référence (Abonnement)	Utilisé pour les versions antérieures à la 3.64 : le renouvellement d'un abonnement était alors géré par création d'un nouvel abonnement et non par un avenant. Permet de lier l'abonnement à l'abonnement suivant.
Date de début	Date	Date de début de validité d'abonnement.
Début période facturation	Date	Date de début de la période de facturation.
Date de fin initiale	Date	Date de fin prévue à la création de l'abonnement.
Périodicité	Liste de sélection	Fréquence de facturation : Mensuelle : Tous les mois Bimestrielle : Tous les 2 mois Trimestrielle : Tous les 3 mois Quadrimestrielle : Tous les 4 mois (à partir de la Spring'20) Semestrielle : Tous les 6 mois Annuelle : Tous les ans Influence le calcul du nombre d'échéances.
Nombre d'échéance	Numéro (18,0)	Alimenté en fonction de la période totale de l'abonnement et la périodicité. Vous pouvez l'ajuster manuellement.

Dates de facture

Terme de facturation	Liste de sélection	Permet de définir si les dates de facture sont définies par rapport : à la date de début de la facture (terme à échoir) ou à la date de fin de la facture (terme échu).
Jour pour calcul des dates	Numéro (3,0)	Selon l'option choisie (voir ci-après) le nombre indiqué ici permet d'ajouter un écart par rapport à cette date ou d'indiquer un jour fixe. Il s'agit d'un champ à renseigner à la main. Il est possible de mettre des nombres négatifs.
Option de calcul des dates	Liste de sélection	Jour fixe avant terme : indiquer le jour fixé souhaité avant la date de début (à échoir) ou la date de fin (échu). Jour fixe après terme : indiquer le jour fixé souhaité après la date de début (à échoir) ou la date de fin (échu) Delta par rapport au terme : "Jour pour calcul des dates" est un numéro positif : delta de jours après la date de début (à échoir) / la date de fin (échu) "Jour pour calcul des dates" est un numéro négatif : delta de jours avant la date de début (à échoir) / la date de fin (échu)

Objet de l'Abonnement

Objet	Champ de texte	À renseigner pour l'afficher sur le PDF de l'abonnement, mentionné en en-tête du tableau de facture. Champ conditionné sur le modèle de PDF : si le champ est vide, il ne sera pas affiché sur le PDF.
V/Réf.	Zone de texte	Votre référence : la référence que vous voulez renseigner pour le client (ex : numéro de bon de commande). Champ conditionné sur le modèle de PDF : si le champ est vide, il ne sera pas affiché sur le PDF.
Commentaires	Zone de texte	Champ conditionné sur le modèle de PDF : si le champ est vide, il ne sera pas affiché sur le PDF.
Conditions particulières	Zone de texte	Champ conditionné sur le modèle de PDF : si le champ est vide, il ne sera pas affiché sur le PDF.

Remise

Raison de la remise	Zone de texte (255)	Vous pouvez renseigner ici la raison de la remise appliquée. Selon votre modèle PDF de la facture, cette information est reprise sur les PDF de facture.
Taux de remise	Pourcentage (4, 6)	Taux (%) de la remise de bas de page, appliquée à l'ensemble des lignes de factures, sur toutes les factures de l'échéancier.

Date de fin

Date d'échéance contractuelle	Formule (Date)	Affiche la date de fin de l'abonnement convenue avec votre client, en suivant cette formule : Formule : Si la Date de fin avenants actifs n'est pas renseignée ou Si la Date de fin initiale est supérieure à la Date de fin avenants actifs ou Si la Date de fin initiale est affichée dans ce champ Sinon la Date de fin avenants actifs est affichée.
Fin période facturation	Formule (Date)	Affiche la date de fin de la période de facturation en suivant cette formule : Formule : Si la Date de fin des avenants éligibles n'est pas renseignée ou Si la Date de fin initiale est supérieure à la Date de fin des avenants éligibles Si la Date de fin initiale est affichée dans ce champ Sinon la Date de fin des avenants éligibles est affichée.
Date effective d'interruption	Date	Si vous avez interrompu l'abonnement grâce au bouton Interrompre, vous pouvez renseigner ici la date à laquelle l'interruption doit être effective.
Date de fin des avenants éligibles	Récapitulatif de cumul (Avenant)	Retourne la date du dernier avenant éligible à la facturation. Formule : Si la case Eligible facturation? est cochée sur l'Avenant Et la case Renouvellement? est cochée sur l'Avenant La Date Fin période facturation de l'Avenant le plus actuel qui rentre dans ces conditions est affichée.
Date de fin avenants actifs	Récapitulatif de cumul (Avenant)	Retourne la date du dernier avenant actif. Formule : Si la case Actif? est cochée sur l'Avenant ET La case Renouvellement? est cochée sur l'Avenant La Date Fin période facturation de l'Avenant le plus actuel qui rentre dans ces condition est affichée.

Règlements

Délai de paiement	Liste de sélection	Le délai convenu pour régler les sommes dues. Fait référence à un ensemble de valeurs globales. X jours nets : X jours à partir de la date de début. X jours fin de mois : X jours à partir de la date de début, en fin de mois.
Mode de paiement	Liste de sélection	Le moyen convenu pour régler les factures. À personnaliser à partir de l'ensemble de valeurs globales.
Echéancier de règlement	Référence (Echéancier)	L'échéancier de règlement concerne le cas où une facture va être réglée en plusieurs fois. Vous pouvez générer ce type d'échéancier à partir de la facture. Voici un article à ce sujet : Échéanciers - Générer un échéancier de règlement.
Coordonnées bancaires client	Référence (Coordonnées bancaires)	Permet de renseigner les coordonnées bancaires du client. Afin de le faire, il faut créer les coordonnées bancaires du client en suivant cet article : Configuration des coordonnées bancaires.
Date de signature du mandat	Date	La date de création du mandat SEPA. À partir de cette date, le prélèvement est autorisé par le client.
Référence Unique de Mandat (RUM)	Texte (35)	Un des éléments d'identification qui doit absolument figurer sur le mandat de prélèvement SEPA. Lorsqu'un débiteur émet un avis de prélèvement SEPA, il donne à son créancier cette Référence Unique de Mandat ainsi que l'Identifiant Créancier SEPA (ICS).

Indices

Indice	Référence (Indice)	Permet de renseigner un indice (créé auparavant), lorsque l'abonnement est en statut brouillon. L'indice permet de recalculer le total TTC des factures à partir d'une certaine date. Ex. d'indice : Indice Syntec, qui sert à mesurer l'évolution du coût de la main d'œuvre, essentiellement de nature intellectuelle, pour des prestations fournies.
Valeur d'indice référence	Référence (Valeur d'indice)	Relation vers la valeur d'indice utilisée comme référence. Automatiquement définie par le champ Date pour indice de référence.
Date pour indice de référence	Date	Date utilisée pour le calcul de la valeur d'indice de référence. Par défaut = date de début de l'abonnement.
Coefficient indice de référence	Numéro (5, 5)	Coefficient de référence pour le calcul du prix révisé. Automatiquement récupéré via la relation Valeur d'indice référence.

Renouvellement

Durée d'engagement renouvellement	Numéro (3, 0)	À renseigner pour automatiser le renouvellement de l'abonnement, par création d'un avenant de renouvellement. Permet de calculer la Date de fin de l'avenant de renouvellement, en fonction de l'unité choisie. Ex : si Durée d'engagement renouvellement = "1" et Unité d'engagement renouvellement = "Année" alors l'abonnement sera renouvelé pour 1 an.
Unité d'engagement renouvellement	Liste de sélection	À renseigner pour automatiser le renouvellement de l'abonnement, par création d'un avenant de renouvellement. Mois ou Année. Permet de calculer la Date de fin de l'avenant de renouvellement en fonction de l'unité choisie. Ex : si Durée d'engagement renouvellement = "1" et Unité d'engagement renouvellement = "Année" alors l'abonnement sera renouvelé pour 1 an.
Date de renouvellement	Date	Permet d'indiquer la date à laquelle l'avenant de renouvellement doit être créé.
Nombre de renouvellements	Récapitulatif de cumul (COUNT Avenant)	Affiche le nombre des avenants de renouvellement liés à l'abonnement.

Objets associées

Opportunité	Formule (Texte)	Affiche l'opportunité liée à l'abonnement, si l'abonnement a été créé à partir d'une opportunité.
Offre	Référence (Offre)	Affiche l'offre liée à l'abonnement, si l'abonnement a été créé à partir d'une offre. Permet d'associer une offre manuellement si l'abonnement n'a pas été créé à partir de l'offre.
Autres coordonnées bancaires	Référence (Coordonnées bancaires)	Permet de choisir d'autres coordonnées bancaires que les coordonnées bancaires renseignées par défaut sur la Raison Sociale.
Montant opportunité	Formule (Devise)	Si une opportunité est liée à l'abonnement, le champ Montant de l'objet Opportunité est affiché.
Montant HT de l'offre	Formule (Devise)	Si une offre est liée à l'abonnement, le champ Montant HT de l'objet Offre est affiché.
Configuration produit	Référence (Configuration produit)	Permet d'ajouter une configuration produit.

Champs à ajouter sur la présentation de page si besoin

Pour rappel : Afin d'ajouter un champ à votre présentation de page, merci de suivre ces étapes :

1. Allez dans Configuration > Gestionnaire d'objet > Abonnements.

2. Ensuite, allez sur la Présentation de page que vous avez attribué à vos utilisateurs. Attention : Potentiellement il y en a plusieurs qui sont utilisées en même temps par des profils différents.

3. Ajoutez les champs qui vous intéressent dans la section qui correspond le plus en glissant <> déposant ces champs.

4. Cliquez sur Enregistrer.

Abonnement verrouillé ?	Formule (Case à cocher)	L'abonnement est verrouillé si le statut est interrompu ou terminé.
Autre modèle	Référence (Modèle)	Permet de mettre en place un autre modèle PDF de l'abonnement, au lieu de prendre le modèle choisi par défaut sur la Raison Sociale. Ce modèle s'appliquera seulement sur cet abonnement. Voici un article à ce sujet : Mettre en place des modèles PDF packagés.
Catalogue de prix	Référence (Catalogue de prix)	Affiche le catalogue de prix lié à cet abonnement. Permet d'associer un catalogue de prix manuellement.
Conditions particulières	Texte (255)	Permet de renseigner les conditions particulières de l'abonnement. Ce champ peut être repris sur le modèle PDF de l'abonnement.
Date de dernière génération échéancier	Date	Affiche la date de la dernière génération de l'échéancier de facturation.
Date souhaitée d'interruption	Date	À utiliser dans l'automatisation Interruption de l'abonnement.
Document PDF de référence	Référence (Document Frisbii)	Lien entre l'abonnement et le PDF de l'abonnement. Ce lien est renseigné suite à la création du PDF.
Donnée Comptable	Référence (Donnée Comptable)	Associée à l'objet Frisbii Donnée Comptable. Regroupe les informations de facturation et de comptabilité d'un compte. Voici le lien vers le module : Les Données comptables - Dictionnaire des champs.
Est activé	Formule (Case à cocher)	Coché si Statut = Activé.
Est brouillon	Formule (Case à cocher)	Coché si Statut = Brouillon.
Est interrompu	Formule (Case à cocher)	Coché si Statut = Interrompu.
Langue	Liste de sélection	En mettant cette balise language="{!sofactoapp__Abonnement__c.sofactoapp__Langue__c}" dans votre modèle d'abonnement, la langue choisie sur l'abonnement sera appliquée aux PDF d'abonnement qui sont émis par cette Raison Sociale. Attention : Comme la TVA, la langue se configure à plusieurs niveaux (héritage). Vous pouvez également la configurer au niveau du compte, des données comptables, de la facture ou de l'offre.
Montant HT	Récapitulatif de cumul (SUM Poste d'abonnement)	Somme des Montants HT des Postes d'Abonnement. 2 décimales.
Montant TTC	Récapitulatif de cumul (SUM Poste d'abonnement)	Somme des Montants TTC des Postes d'Abonnement. 2 décimales.
Montant TVA	Récapitulatif de cumul (SUM Poste d'abonnement)	Somme des Montants TVA des Postes d'Abonnement. 2 décimales.
Ne pas renouveler	Case à cocher	Marque l'abonnement comme une exception pour le renouvellement. À utiliser dans le processus pour renouveler automatiquement les abonnements.
Facturation négative interdite	Case à cocher	Permet d'interdire qu'une facture de cet abonnement puisse être négative (en créant une Règle de Validation liée à cette case). Pour éviter les montants négatifs, l'utilisateur devra répartir sur la ou les prochaines factures de l'échéancier les lignes de factures négatives.
Nom de l'abonnement	Numéro automatique	Comme le numéro de facture, c'est un numéro renseigné automatiquement à la création de l'abonnement. Affiché par défaut en haut d'un enregistrement.
Nombre pour division	Numéro (4, 6)	À la création de l'abonnement depuis l'opportunité, vous pouvez renseigner ce champ afin de définir une division du montant ou de la quantité par ce nombre prédéfini. Si le champ est renseigné sur l'opportunité, il sera repris pour calculer le montant du poste d'abonnement même s'il n'est pas renseigné lors de la création de l'abonnement.
Opportunité	Référence (Opportunité)	Affiche l'opportunité liée à l'abonnement, si l'abonnement a été créé à partir d'une opportunité. Permet d'associer une opportunité manuellement si l'abonnement n'a pas été créé à partir de l'opportunité.
Remise (%)	Formule (Pourcentage)	Reprend le champ Taux de remise à deux décimales.
Renouvelé	Formule (Case à cocher)	Le champ indique si l'abonnement a été renouvelé. Si le champ Abonnement suivant est renseigné, la case est cochée (versions antérieures à la 3.64).
Tacite reconduction	Case à cocher	Indique que l'abonnement est reconductible automatiquement d'une période à une autre (si aucune des parties ne manifeste sa volonté de rompre le contrat). À utiliser dans la mise en place de l'auto-reconduction.
ID Externe	Texte (255) (ID externe) (Respect de la casse unique)	Si l'abonnement est associé à un enregistrement dans un système tiers, vous pouvez renseigner l'ID dans ce champ.
Régularisation des postes d’abonnements	Formule (Case à cocher)	Reprend la valeur du champ Régularisation de la facturation de la Raison Sociale. Cette fonction permet de régulariser la facturation lorsqu'une modification survient sur un abonnement alors que la période de facturation a déjà été facturée. Voici un article à ce sujet : La régularisation de la facturation.