Référence des fonctions Solution IES
Solution IES ajoute à Excel neuf fonctions, toutes sous le préfixe IES. — tapez =IES.
dans une cellule pour les voir. Elles lisent les données importées dans le classeur par le
volet Données comptables (feuilles CHARTE,
IESDATA_…) : aucun appel à l'API au moment du calcul, et un solde ne change qu'après une
nouvelle importation. Elles sont insensibles à la casse (=ies.gl_get_account_balance(...)
fonctionne). Dans Excel, le bouton Formules IES du ruban les explique aussi, avec des exemples
à insérer en un clic dans la cellule sélectionnée.
Conventions communes
Les paramètres entre crochets sont optionnels.
Numéro de compte — donnez-le en texte : "1000", ou $A8&"" si la cellule A8 contient
le numéro. Un numéro donné en nombre fonctionne aussi tant qu'il n'a ni zéro de tête ni préfixe.
En multi-compagnie, incluez le préfixe de la compagnie ("B_1000").
Périodes (GLPeriodNumber, GlPeriodNumberStart) :
| Valeur | Sens |
|---|---|
-1 (défaut) | La période courante de la compagnie, celle choisie dans ses Réglages (volet Données comptables) |
-2 | La période précédente (courante − 1, jamais moins que 0) |
0 à 13 | Un numéro de période explicite ; 0 = ouverture de l'exercice, 13 = période d'ajustement si votre système en a une |
Sans GlPeriodNumberStart, la fonction renvoie la valeur de la seule période demandée —
dans la convention Acomba, le mouvement net de cette période. Avec GlPeriodNumberStart, elle
cumule de cette période à GLPeriodNumber : 0 pour un solde de bilan (ouverture
comprise), 1 pour un cumul d'exercice de résultats.
Segments de projet (segment1Filter, segment2Filter, segment3Filter) — propres à Acomba,
dont les projets se découpent en trois segments. Vide ("", défaut) = tous ; une valeur =
seulement les lignes de ce segment. Sans projets importés, laissez-les vides.
CompanyID — le numéro de la compagnie dans le classeur, donné quand vous l'ajoutez dans le
volet Données comptables : 0 (défaut) pour la première, 1 pour la deuxième… Il sert à résoudre -1 et -2 (la période courante de cette
compagnie) ; le compte lui-même se distingue par son préfixe.
Erreurs — les fonctions de solde et de budget renvoient 0 quand un paramètre est
invalide (période hors de 0–13, début après la fin, numéro de budget hors de 1–3) ; les fonctions
de texte renvoient un message (Account not found, Company with id 1 not found) ;
GL_GET_GROUP_BALANCE renvoie #VALUE! quand le groupe n'existe pas.
GL_GET_ACCOUNT_BALANCE
Le solde (ou mouvement) d'un compte de grand livre pour une période ou un cumul de périodes.
Syntaxe
=IES.GL_GET_ACCOUNT_BALANCE(GLAccountNumber, [GLPeriodNumber], [segment1Filter], [segment2Filter], [segment3Filter], [GlPeriodNumberStart], [CompanyID])
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
GLAccountNumber | texte | — | Numéro du compte, préfixe compris en multi-compagnie |
GLPeriodNumber | nombre | -1 | Période demandée (ou période de fin du cumul) — voir Conventions |
segment1Filter | texte | "" | Filtre sur le segment 1 des projets (Acomba) |
segment2Filter | texte | "" | Filtre sur le segment 2 |
segment3Filter | texte | "" | Filtre sur le segment 3 |
GlPeriodNumberStart | nombre | (aucun) | Période de début du cumul ; absent = une seule période |
CompanyID | nombre | 0 | Numéro de la compagnie dans le classeur |
Résultat — un nombre. 0 si le compte n'est pas dans les données importées ou si un
paramètre est invalide.
Exemples
=IES.GL_GET_ACCOUNT_BALANCE("1000") valeur du compte 1000 à la période courante
=IES.GL_GET_ACCOUNT_BALANCE("1000", 4) valeur à la période 4
=IES.GL_GET_ACCOUNT_BALANCE("1000", -1, "", "", "", 0) solde de bilan : ouverture + périodes 1 à courante
=IES.GL_GET_ACCOUNT_BALANCE("4000", -2, "", "", "", 1) cumul des revenus, périodes 1 à précédente
=IES.GL_GET_ACCOUNT_BALANCE("5000", -1, "MTL") période courante, projets du segment 1 « MTL » seulement
=IES.GL_GET_ACCOUNT_BALANCE($A8&"") le compte inscrit en A8 (forme des gabarits)
Remarques
- Les montants suivent le signe naturel, la convention d'Acomba et du GEF : chaque compte est positif dans son sens normal (un revenu, une dépense, un passif sont positifs). Pour Acomba GO, qui renvoie débit + / crédit −, Solution IES reconnaît la compagnie et ramène ses comptes au signe naturel à l'importation : rien à régler.
- Sans filtre de segment, le solde se lit dans la charte (
CHARTE) : il ne demande pas l'option Importer données de PROJETS. - Avec Acomba GO, les valeurs par période sont calculées par la passerelle à partir des écritures transférées au grand livre ; les périodes sont les mois de l'exercice — voir Acomba GO : les comptes GL n'ont pas de solde par période.
GL_GET_GROUP_BALANCE
Le solde cumulé d'un regroupement de comptes défini dans le volet Groupes GL — la somme
de GL_GET_ACCOUNT_BALANCE sur chaque compte membre, sous-groupes compris.
Syntaxe
=IES.GL_GET_GROUP_BALANCE(GroupName, [GLPeriodNumber], [segment1Filter], [segment2Filter], [segment3Filter], [GlPeriodNumberStart], [CompanyID])
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
GroupName | texte | — | Nom du regroupement, tel qu'enregistré dans Groupes GL |
| (les six autres) | Identiques à GL_GET_ACCOUNT_BALANCE |
Résultat — un nombre : la somme des comptes du groupe et de ses sous-groupes, pour la même période ou le même cumul.
Exemple
=IES.GL_GET_GROUP_BALANCE("Ventes") total du groupe Ventes à la période courante
=IES.GL_GET_GROUP_BALANCE("Ventes", -1, "", "", "", 1) cumul d'exercice du groupe
Remarques
- Un groupe introuvable donne
#VALUE!(le journal du complément précise : Groupe « Ventes » introuvable. Définissez-le dans le panneau « Groupes GL » puis enregistrez.) Vérifiez l'orthographe exacte du nom. - Les groupes voyagent dans le classeur (feuille
IESDATA_GLGROUPS) : un classeur ouvert sur un autre poste retrouve ses groupes. - Disponible à partir de Solution IES 3.2.
GL_GET_NET_INCOME
Le bénéfice net d'une compagnie (revenus − dépenses) pour une période ou un cumul de
périodes. C'est la ligne qui fait balancer un bilan : Actif = Passif + Capitaux + bénéfice net
de l'exercice. L'équivalent du #profits du GEF d'Acomba.
Syntaxe
=IES.GL_GET_NET_INCOME([GLPeriodNumber], [GlPeriodNumberStart], [CompanyID])
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
GLPeriodNumber | nombre | -1 | Période demandée (ou période de fin du cumul) — voir Conventions |
GlPeriodNumberStart | nombre | (aucun) | Période de début du cumul ; absent = une seule période ; 0 = depuis le début de l'exercice |
CompanyID | nombre | 0 | Numéro de la compagnie dans le classeur : seuls ses comptes sont additionnés |
Résultat — un nombre arrondi au cent : la somme des comptes de catégorie Revenu moins
celle des comptes de catégorie Dépense, sur les périodes demandées. Négatif = perte. Les
comptes de bilan (Actif, Passif, Capital, Banque…) sont ignorés. Une période invalide (hors de
0–13, début après la fin) donne #VALUE!.
Exemples
=IES.GL_GET_NET_INCOME() bénéfice net de la période courante
=IES.GL_GET_NET_INCOME(-1, 0) bénéfice net de l'exercice, jusqu'à la période courante (ligne du bilan)
=IES.GL_GET_NET_INCOME(-1, 0, 1) idem pour la compagnie numéro 1 du classeur
=IES.GL_GET_NET_INCOME(6, 4) bénéfice net des périodes 4 à 6
Remarques
- Le calcul suppose le signe naturel dans la charte importée : revenus et dépenses en positif. C'est le cas d'Acomba. Pour Acomba GO, qui renvoie débit + / crédit −, Solution IES reconnaît la compagnie et ramène ses comptes au signe naturel à l'importation : rien à régler.
- Les comptes sont reconnus par leur catégorie dans la charte (
Revenu,Dépense, avec ou sans accent ni s), pas par leur numéro. - Le Bilan créé par le volet Gabarit d'état financier utilise cette fonction pour la ligne Bénéfice net de l'exercice.
- Pas de filtre de segment : le bénéfice net porte sur toute la compagnie.
- Disponible à partir de Solution IES 3.2.
GL_GET_ACCOUNT_DESCRIPTION
La description (le nom) d'un compte de grand livre.
Syntaxe
=IES.GL_GET_ACCOUNT_DESCRIPTION(glAccountNumber)
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
glAccountNumber | texte | — | Numéro du compte, préfixe compris en multi-compagnie |
Résultat — le nom du compte tel qu'il est dans votre système comptable, ou
Account not found si le compte n'est pas dans les données importées.
Exemple
=IES.GL_GET_ACCOUNT_DESCRIPTION("1000") → Encaisse
=IF($A8="","",IES.GL_GET_ACCOUNT_DESCRIPTION($A8&"")) forme utilisée par les gabarits
Remarques — un compte à zéro toute l'année n'est pas importé (voir
Ce que l'importation ramène) :
Account not found sur un compte qui existe pourtant dans votre plan comptable vient presque
toujours de là.
GL_GET_ACCOUNT_CATEGORY
La catégorie (le type) d'un compte de grand livre.
Syntaxe
=IES.GL_GET_ACCOUNT_CATEGORY(glAccountNumber)
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
glAccountNumber | texte | — | Numéro du compte, préfixe compris en multi-compagnie |
Résultat — le type de compte du modèle Conexio : Actif, Passif, Revenu, Dépense,
Banque, Capitaux, Quantité, Multiple ou Inconnu ; Account not found si le compte
n'est pas dans les données importées.
Exemple
=IES.GL_GET_ACCOUNT_CATEGORY("1000") → Banque
=IF(IES.GL_GET_ACCOUNT_CATEGORY($A8&"")="Revenu", -1, 1) inverser le signe des revenus
GL_GET_CURRENT_PERIOD
La période courante d'une compagnie.
Syntaxe
=IES.GL_GET_CURRENT_PERIOD([IesCompanyId], [GiveERPPeriod])
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
IesCompanyId | nombre | 0 | Numéro de la compagnie dans le classeur |
GiveERPPeriod | booléen | FAUX | FAUX : la période courante choisie dans les Réglages de la compagnie. VRAI : la période comptable courante selon le système comptable (fiche de la compagnie importée) |
Résultat — le numéro de période, en texte. Company with id 1 not found si aucune compagnie
du classeur ne porte ce numéro ; Multiple companies with id 1 found si la configuration du
classeur est incohérente (voir le Dépannage).
Exemple
=IES.GL_GET_CURRENT_PERIOD() → 6
=IES.GL_GET_CURRENT_PERIOD(0, TRUE) → la période courante d'après le système comptable
Remarques — c'est la période que toutes les autres fonctions utilisent pour -1. Pour
changer de période dans tout un classeur, modifiez la Période courante dans les Réglages de la
compagnie (volet Données comptables, menu ⋮) et réimportez. Avec Acomba GO, la période « selon
le système » n'existe pas telle quelle (pas de périodes dans Acomba GO) : préférez la période
courante des Réglages.
GL_GET_LAST_PERIOD
La période précédant la période courante.
Syntaxe
=IES.GL_GET_LAST_PERIOD([IesCompanyId], [GiveERPPeriod])
Paramètres — identiques à GL_GET_CURRENT_PERIOD.
Résultat — la période courante moins un, en texte ; jamais moins que 0. Company 1 not found
si aucune compagnie du classeur ne porte ce numéro.
Exemple
=IES.GL_GET_LAST_PERIOD() → 5 (quand la période courante est 6)
Remarque — c'est la période que les autres fonctions utilisent pour -2. Utile en tête de
colonne d'un comparatif « période courante / période précédente ».
GL_GET_ACCOUNT_BUDGET
Le budget d'un compte de grand livre, pour une période ou un cumul.
Syntaxe
=IES.GL_GET_ACCOUNT_BUDGET(GLAccountNumber, [GLPeriodNumber], [BudgetNumber], [GlPeriodNumberStart], [CompanyID])
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
GLAccountNumber | texte | — | Numéro du compte, préfixe compris en multi-compagnie |
GLPeriodNumber | nombre | -1 | Période demandée, ou période de fin du cumul |
BudgetNumber | nombre | 1 | Scénario de budget : 1, 2 ou 3 (Budget01 à Budget03) |
GlPeriodNumberStart | nombre | (aucun) | Période de début du cumul |
CompanyID | nombre | 0 | Numéro de la compagnie dans le classeur |
Résultat — un nombre. 0 si le compte n'est pas trouvé, si le budget demandé n'a pas été
importé, ou si un paramètre est invalide.
Exemple
=IES.GL_GET_ACCOUNT_BUDGET("4000") budget 1 du compte 4000 à la période courante
=IES.GL_GET_ACCOUNT_BUDGET("4000", -1, 2, 1) cumul du budget 2, périodes 1 à courante
=IES.GL_GET_ACCOUNT_BUDGET("B_4000") le compte 4000 de la compagnie au préfixe B_
Remarques
- Les budgets ne sont importés que si les cases Budget01 / Budget02 / Budget03 sont cochées dans les Options avant l'importation (Budget01 l'est par défaut).
- Acomba GO n'a pas de budgets : Solution IES reconnaît la compagnie et ne les lui demande
pas ; la fonction renvoie
0pour ses comptes. - Le numéro de compte se donne en texte, préfixe compris, comme pour
GL_GET_ACCOUNT_BALANCE; un numéro en nombre (4000) reste accepté. Avant la version 3.2, un compte préfixé donnait#VALUE!.
GL_GET_PROJECT_BUDGET
Le budget défini sur les projets (Acomba), filtré par segments — non ventilable par compte.
Syntaxe
=IES.GL_GET_PROJECT_BUDGET([GLPeriodNumber], [BudgetNumber], [segment1Filter], [segment2Filter], [segment3Filter], [GlPeriodNumberStart], [CompanyID])
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
GLPeriodNumber | nombre | -1 | Période demandée, ou période de fin du cumul |
BudgetNumber | nombre | 1 | Scénario de budget : 1, 2 ou 3 |
segment1Filter | texte | "" | Filtre sur le segment 1 des projets ; vide = tous |
segment2Filter | texte | "" | Filtre sur le segment 2 |
segment3Filter | texte | "" | Filtre sur le segment 3 |
GlPeriodNumberStart | nombre | (aucun) | Période de début du cumul |
CompanyID | nombre | 0 | Numéro de la compagnie dans le classeur |
Résultat — un nombre : la somme des budgets des projets retenus par les filtres. 0 si les
projets n'ont pas été importés ou si un paramètre est invalide.
Exemple
=IES.GL_GET_PROJECT_BUDGET(-1, 1, "MTL") budget 1 des projets du segment 1 « MTL », période courante
Remarques — demande l'option Importer données de PROJETS [Acomba] cochée dans les Options à l'importation. Sans objet pour Acomba GO, qui n'a ni projets à segments ni budgets.
Disponibilité par système
Les fonctions sont les mêmes quel que soit le système comptable ; ce qui varie, c'est ce que l'importation peut ramener :
| Acomba | Acomba GO | |
|---|---|---|
| Plan comptable, descriptions, catégories | oui | oui |
Valeurs par période (GL_GET_ACCOUNT_BALANCE, GL_GET_GROUP_BALANCE, GL_GET_NET_INCOME) | oui | oui, calculées à partir des écritures transférées au grand livre |
Budgets (GL_GET_ACCOUNT_BUDGET) | oui, si cochés à l'importation | non (pas de budgets dans Acomba GO) |
Projets et segments (GL_GET_PROJECT_BUDGET, filtres de segments) | oui, si Importer données de PROJETS est cochée | non |
Le support des entités par système évolue : la référence reste la colonne du système dans la matrice de support, et les particularités d'Acomba GO sont sur sa page.