Référence des fonctions Solution IES
Solution IES ajoute à Excel huit 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 Importer (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).
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 du bloc ("B_1000").
Périodes (GLPeriodNumber, GlPeriodNumberStart) :
| Valeur | Sens |
|---|---|
-1 (défaut) | La période courante, celle choisie dans le champ Période du volet Importer |
-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 — l'index du bloc compagnie dans le volet Importer : 0 (défaut) pour le
premier, 1 pour le second… 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 | Bloc compagnie du volet Importer |
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
- Le signe est celui du système comptable : un compte de revenus est le plus souvent négatif
(créditeur). Multipliez par
-1dans vos états si vous voulez les afficher en positif. - 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_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 | Bloc compagnie du volet Importer |
GiveERPPeriod | booléen | FAUX | FAUX : la période saisie dans le champ Période à l'importation. 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 aucun bloc ne porte
cet index ; Multiple companies with id 1 found si la configuration du classeur est incohérente
(réenregistrez les blocs du volet Importer).
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 le champ Période du volet Importer 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 valeur saisie à l'importation.
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 aucun bloc ne porte cet index.
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 | nombre | — | Numéro du compte (en nombre pour cette fonction, sans préfixe) |
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 | Bloc compagnie du volet Importer |
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
Remarques
- Les budgets ne sont importés que si les cases Budget01 / Budget02 / Budget03 sont cochées dans Options générales avant l'importation (Budget01 l'est par défaut).
- Acomba GO n'a pas de budgets : la fonction renvoie
0. - Le numéro de compte est attendu en nombre : en multi-compagnie, cette fonction ne distingue pas les préfixes.
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 | Bloc compagnie du volet Importer |
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 à 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) | 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.