Documentation API – GL Account

GL Account API

Accédez aux comptes du Grand Livre (GL) à travers différents systèmes ERP avec une API REST unifiée.
Extrayez les informations des comptes comptables incluant les soldes par période pour Acomba, Avantage et Sage 50.

GET/Entity/GLAccount

Aperçu

L’entité GLAccount représente un compte du Grand Livre dans votre système ERP.
Cette API permet d’effectuer des opérations de lecture (GET) sur les comptes comptables
de manière standardisée, peu importe le système ERP sous-jacent.

L’API utilise des endpoints REST standards avec les méthodes HTTP appropriées :

GET /Entity/GLAccount – Récupérer une liste de comptes GL
GET /Entity/GLAccount/{NoCompteGL} – Récupérer un compte GL spécifique

💡 Expansion des soldes

Les soldes par période (année courante, année précédente, budgets) sont disponibles via le paramètre $expand.
Sans expansion, seules les informations de base du compte sont retournées.

Matrice de Support

Opérations supportées pour l’entité GLAccount par système ERP :

Système ERP	GET	POST	PUT
Acomba	✓ Oui	✗ Non	✗ Non
QuickBooks Online	✗ Non	✗ Non	✗ Non
Avantage	✓ Oui	✗ Non	✗ Non
Sage 50	✓ Oui	✗ Non	✗ Non
Servex	✗ Non	✗ Non	✗ Non
Servicentre	✗ Non	✗ Non	✗ Non

GET GLAccount

Récupère une liste de comptes GL avec support de filtrage, pagination et expansion des soldes.

GET/Entity/GLAccount

Paramètres de requêtes

Paramètre	Type	Requis	Description
$filter	string	Optionnel	Expression de filtrage de style OData. Filtres supportés : `NoCompteGL eq`, `NoCompteGL in`, `ValeurAuCompte ne 0`
$select	string	Optionnel	Champs à retourner (séparés par des virgules)
$expand	string	Optionnel	Champs à épandre : `AnneeCourante`, `AnneePrécédente`, `Budget01`, `Budget02`, `Budget03`
$top	integer	Optionnel	Nombre maximum de résultats
$skip	integer	Optionnel	Nombre de résultats à ignorer (pagination)

💡 Note importante

Pour plus de détails sur la composition des requêtes, consultez : Composer une requête à l’API d’ERP Connector

Get GLAccount – Liste simple

GET /Entity/GLAccount?$select=NoCompteGL,NomCompteGL,TypeDeCompte
Host: https://v4.api.onlineerp.solution.quebec/api
Content-Type: application/json

Get GLAccount – Avec soldes de l’année courante

GET /Entity/GLAccount?$expand=AnneeCourante&$filter=NoCompteGL in ('1000','1100','2000')
Host: https://v4.api.onlineerp.solution.quebec/api
Content-Type: application/json

⚠️ Performance

L’expansion des soldes (AnneeCourante, Budget01, etc.) peut impacter les performances. Utilisez-la uniquement lorsque nécessaire.

Response (200 OK)

[
    {
        "NoCompteGL": "1000",
        "NomCompteGL": "Encaisse - Banque principale",
        "NoUniqueSystemeSource": "1",
        "TypeDeCompte": "Banque"
    },
    {
        "NoCompteGL": "1100",
        "NomCompteGL": "Comptes clients",
        "NoUniqueSystemeSource": "2",
        "TypeDeCompte": "Actif"
    },
    {
        "NoCompteGL": "2000",
        "NomCompteGL": "Comptes fournisseurs",
        "NoUniqueSystemeSource": "3",
        "TypeDeCompte": "Passif"
    },
    {
        "NoCompteGL": "4000",
        "NomCompteGL": "Ventes de produits",
        "NoUniqueSystemeSource": "10",
        "TypeDeCompte": "Revenu"
    },
    {
        "NoCompteGL": "5000",
        "NomCompteGL": "Coût des marchandises vendues",
        "NoUniqueSystemeSource": "15",
        "TypeDeCompte": "Dépense"
    }
]

Response avec $expand=AnneeCourante (200 OK)

[
    {
        "NoCompteGL": "1000",
        "NomCompteGL": "Encaisse - Banque principale",
        "NoUniqueSystemeSource": "1",
        "TypeDeCompte": "Banque",
        "AnneeCourante": [
            {
                "NoPeriode": 1,
                "ValeurAuCompte": 45230.75
            },
            {
                "NoPeriode": 2,
                "ValeurAuCompte": 52180.50
            },
            {
                "NoPeriode": 3,
                "ValeurAuCompte": 48920.25
            },
            {
                "NoPeriode": 4,
                "ValeurAuCompte": 55100.00
            }
        ]
    },
    {
        "NoCompteGL": "4000",
        "NomCompteGL": "Ventes de produits",
        "NoUniqueSystemeSource": "10",
        "TypeDeCompte": "Revenu",
        "AnneeCourante": [
            {
                "NoPeriode": 1,
                "ValeurAuCompte": 125000.00
            },
            {
                "NoPeriode": 2,
                "ValeurAuCompte": 138500.50
            },
            {
                "NoPeriode": 3,
                "ValeurAuCompte": 142300.75
            },
            {
                "NoPeriode": 4,
                "ValeurAuCompte": 155200.25
            }
        ]
    }
]

Modèle de Données Complet

Compte GL (ComptesGL)

Champ	Type	Description
NoCompteGL	string	Numéro du compte GL (clé d’affaires)
NomCompteGL	string	Nom descriptif du compte
NoUniqueSystemeSource	string	Identifiant unique interne du système ERP
TypeDeCompte	enum	Type de compte (voir tableau ci-dessous)
ActifPassif	enum	Classification Actif/Passif du compte
Fiche_DerniereModification	datetime?	Date de dernière modification de la fiche
AnneeCourante	List<GLPeriodValue>	Soldes par période pour l’année courante (requiert $expand)
AnneePrécédente	List<GLPeriodValue>	Soldes par période pour l’année précédente (requiert $expand)
Budget01	List<GLPeriodValue>	Valeurs budgétaires scénario 1 (requiert $expand)
Budget02	List<GLPeriodValue>	Valeurs budgétaires scénario 2 (requiert $expand)
Budget03	List<GLPeriodValue>	Valeurs budgétaires scénario 3 (requiert $expand)

Valeur par période (GLPeriodValue)

Champ	Type	Description
NoPeriode	int	Numéro de la période comptable (1-12 pour mensuel, 1-4 pour trimestriel, etc.)
ValeurAuCompte	decimal	Solde ou montant pour cette période

Types de comptes (ComptesGL_TypeCompte)

Valeur	Description
Actif	Comptes d’actifs (immobilisations, stocks, etc.)
Passif	Comptes de passifs (dettes, emprunts, etc.)
Revenu	Comptes de revenus (ventes, produits, etc.)
Dépense	Comptes de dépenses (charges, frais, etc.)
Banque	Comptes bancaires
Capitaux	Comptes de capitaux propres
Quantité	Comptes de quantité (statistiques)
Multiple	Comptes d’allocation multiple
Inconnu	Type de compte non déterminé

⚠️ Filtres supportés (Acomba)

Pour Acomba, seuls les filtres suivants sont actuellement supportés :
• NoCompteGL eq 'valeur' – Recherche par numéro de compte exact
• NoCompteGL in ('val1','val2') – Recherche par liste de numéros de comptes
• ValeurAuCompte ne 0 – Exclure les comptes avec solde à zéro