Documentation API – GL Journal Entry

GL Journal Entry API

Gérez les écritures comptables du Grand Livre à travers différents systèmes ERP avec une API REST unifiée.
Créez et lisez les écritures GL pour Acomba, Avantage, Sage 50 et autres systèmes ERP.

GET/Entity/GLJournalEntry

POST/Entity/GLJournalEntry

Aperçu

L’entité GLJournalEntry (Écriture comptable GL) représente une écriture au Grand Livre dans votre système ERP.
Cette API permet d’effectuer des opérations de lecture (GET) et de création (POST) sur les écritures 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/GLJournalEntry – Récupérer une liste d’écritures comptables
GET /Entity/GLJournalEntry/{id} – Récupérer une écriture comptable spécifique
POST /Entity/GLJournalEntry – Créer une nouvelle écriture comptable

💡 Note importante

Les champs disponibles et requis varient selon le système ERP. Les écritures comptables incluent généralement un en-tête avec les informations de date et de description, ainsi que des lignes de détail avec les comptes GL, montants et directions (débit/crédit).

Matrice de Support

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

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

GET GLJournalEntry

Récupère une liste d’écritures comptables avec support de filtrage, pagination et sélection de champs.

GET/Entity/GLJournalEntry

💡 Systèmes supportés pour GET

Seuls Avantage et Sage 50 supportent la lecture des écritures comptables GL.

Paramètres de requêtes

Paramètre	Type	Requis	Description
$filter	string	Optionnel	Expression de filtrage de style OData
$select	string	Optionnel	Champs à retourner (séparés par des virgules)
$orderby	string	Optionnel	Permet de trier les résultats
$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 GLJournalEntry

GET /Entity/GLJournalEntry?$filter=DateEcriture ge '2024-01-01'&$top=50
Host: https://v4.api.onlineerp.solution.quebec/api
Content-Type: application/json

Response (200 OK)

[
    {
        "NoEcritureComptable": "EC-2024-001",
        "NoUniqueSystemeSource": "1001",
        "DateEcriture": "2024-01-15T00:00:00",
        "DescriptionÉcriture": "Écriture de régularisation - Janvier",
        "PériodeGLÉcriture": 1,
        "NoLot_Ecriture": 12,
        "Montant_Ecriture": 1500.00,
        "NoDocumentSource": "FAC-2024-001",
        "LignesÉcriture": [
            {
                "ComptesGL": {
                    "NoCompteGL": "1100",
                    "DescriptionCompte": "Comptes clients"
                },
                "Direction_DebitCredit": "Debit",
                "Montant_Écriture": 1500.00,
                "DescriptionLignes": "Débit - Comptes clients"
            },
            {
                "ComptesGL": {
                    "NoCompteGL": "4100",
                    "DescriptionCompte": "Ventes"
                },
                "Direction_DebitCredit": "Credit",
                "Montant_Écriture": 1500.00,
                "DescriptionLignes": "Crédit - Ventes"
            }
        ]
    }
]

POST GLJournalEntry (Création)

Crée une nouvelle écriture comptable dans le Grand Livre. L’écriture doit être balancée (total des débits = total des crédits).

POST/Entity/GLJournalEntry

💡 Systèmes supportés pour POST

Seuls Acomba et Sage 50 supportent la création d’écritures comptables GL.

Champs requis par ERP

Champ	Type	Acomba	Sage 50	Description
DateEcriture	datetime	✓ Required	✓ Required	Date de l’écriture comptable
DescriptionÉcriture	string	Optional	Optional	Description de l’écriture
LignesÉcriture	array	✓ Required	✓ Required	Liste des lignes d’écriture (min. 2 lignes)

Structure d’une ligne d’écriture

Champ	Type	Requis	Description
ComptesGL.NoCompteGL	string	✓ Required	Numéro du compte GL
Direction_DebitCredit	enum	✓ Required	Direction: “Debit” ou “Credit”
Montant_Écriture	decimal	✓ Required	Montant de la ligne
DescriptionLignes	string	Optional	Description de la ligne
Projet_No	string	Optional	Numéro de projet associé

Créer une écriture comptable (Acomba)

POST /Entity/GLJournalEntry
Host: https://v4.api.onlineerp.solution.quebec/api
Content-Type: application/json

{
    "DateEcriture": "2025-07-01",
    "DescriptionÉcriture": "Payer cartes de crédit",
    "PériodeGLÉcriture" : 5,

    /*Détails associés à l'entête*/
    "LignesÉcriture": [
        {
            "Montant_Écriture": -3,
            "DescriptionLignes" : "compte payable",
            "Projet_No" : "",
            "ComptesGL": {
                "NoCompteGL": "21000",/*Le numéro du Compte GL associé à l'écriture*/
                "TypeDeCompte" : "Passif" //Actif, Passif, Revenu, Dépense, Quantité, Banque, Capitaux, Multiple
            }
        },
        {
            "Montant_Écriture": 3,
            "DescriptionLignes" : "Compte à recevoir",
            "ComptesGL": {
                "NoCompteGL": "12000",
                "TypeDeCompte" : "Actif" //Actif, Passif, Revenu, Dépense, Quantité, Banque, Capitaux, Multiple
            }
        }
    ]
}

Créer une écriture comptable (Sage 50)

POST /Entity/GLJournalEntry
Host: https://v4.api.onlineerp.solution.quebec/api
Content-Type: application/json

{
    "DateEcriture": "2025-07-01",
    "DescriptionÉcriture": "Payer cartes de crédit",
    
    // Numéro de facture associé à l'écriture
    "NoDocumentSource" : "Test",
    /*Détails associés à l'entête*/

    "LignesÉcriture": [
        /*1re ligne de détails de l'écriture*/
        {
            "Montant_Écriture": 3,
            "DescriptionLignes" : "compte payable",
            "ComptesGL": {
                /*Le numéro du Compte GL associé à l'écriture*/
                "NoCompteGL": "21050"
            }
        },
        {
            "Montant_Écriture": 1.5,
            "DescriptionLignes" : "Compte actif1",
            "ComptesGL": {
                "NoCompteGL": "10800"
            }
        },
        {
            "Montant_Écriture": 1.5,
            "DescriptionLignes" : "Compte actif2",
            "ComptesGL": {
                "NoCompteGL": "10830"
            }
        }
    ]
}

Response (201 Created)

{
    "NoEcritureComptable": "35529",
    "NoUniqueSystemeSource": "3664",
    "DateEcriture": "2025-07-01T00:00:00",
    "DescriptionÉcriture": "Payer cartes de crédit",
    "PériodeGLÉcriture": 5,
    "NoLot_Ecriture": 0,
    "Montant_Ecriture": 0.0,
    "LignesÉcriture": [
        {
            "ComptesGL": {
                "NoCompteGL": "21000",
                "NomCompteGL": null,
                "NoUniqueSystemeSource": null,
                "TypeDeCompte": 2,
                "ACtifPassif": 0,
                "Fiche_DerniereModification": null,
                "AnneeCourante": [],
                "AnneePrécédente": [],
                "Budget01": [],
                "Budget02": [],
                "Budget03": []
            },
            "NoUniqueSystemeSource": null,
            "Direction_DebitCredit": 0,
            "TypeÉcriture": 0,
            "Montant_Écriture": -3.0,
            "DescriptionLignes": "compte payable",
            "Projet_No": "",
            "Projet_NoUniqueSystemesource": null,
            "Fiche_DerniereModification": null
        },
        {
            "ComptesGL": {
                "NoCompteGL": "12000",
                "NomCompteGL": null,
                "NoUniqueSystemeSource": null,
                "TypeDeCompte": 1,
                "ACtifPassif": 0,
                "Fiche_DerniereModification": null,
                "AnneeCourante": [],
                "AnneePrécédente": [],
                "Budget01": [],
                "Budget02": [],
                "Budget03": []
            },
            "NoUniqueSystemeSource": null,
            "Direction_DebitCredit": 0,
            "TypeÉcriture": 0,
            "Montant_Écriture": 3.0,
            "DescriptionLignes": "Compte à recevoir",
            "Projet_No": null,
            "Projet_NoUniqueSystemesource": null,
            "Fiche_DerniereModification": null
        }
    ],
    "Fiche_DerniereModification": null,
    "TypeEcriture": 0,
    "NoDocumentSource": null,
    "PartiePrenanteNo": null,
    "PartiePrenanteNoUniqueSystemSource": null,
    "ExtendedProperties": null
}

⚠️ Important

L’écriture comptable doit être balancée : le total des débits doit être égal au total des crédits. Si l’écriture n’est pas balancée, une erreur sera retournée.

Modèle de Données Complet

En-tête d’écriture (ÉcritureComptable_Entete)

Champ	Type	Description
NoEcritureComptable	string	Numéro de l’écriture comptable
NoUniqueSystemeSource	string	Identifiant unique du système source ERP
DateEcriture	datetime	Date de l’écriture comptable
DescriptionÉcriture	string	Description générale de l’écriture
PériodeGLÉcriture	int	Numéro de période comptable
NoLot_Ecriture	int	Numéro de lot
Montant_Ecriture	decimal	Montant total de l’écriture
NoDocumentSource	string	Numéro du document source (facture, chèque, etc.)
PartiePrenanteNo	string	Numéro de la partie prenante (client, fournisseur)
PartiePrenanteNoUniqueSystemSource	string	ID unique de la partie prenante dans le système source
LignesÉcriture	List<ÉcritureComptable_Détail>	Liste des lignes de détail de l’écriture
Fiche_DerniereModification	DateTime?	Date de dernière modification
ExtendedProperties	Dictionary<string, object>	Propriétés étendues spécifiques à l’ERP

Lignes de Détail (ÉcritureComptable_Détail)

Champ	Type	Description
ComptesGL	ComptesGL	Objet contenant les informations du compte GL
NoUniqueSystemeSource	string	Identifiant unique de la ligne dans le système source
Direction_DebitCredit	enum	Direction de l’écriture: “Debit” ou “Credit”
Montant_Écriture	decimal	Montant de la ligne
DescriptionLignes	string	Description de la ligne
Projet_No	string	Numéro de projet associé
Projet_NoUniqueSystemesource	string	ID unique du projet dans le système source
Fiche_DerniereModification	DateTime?	Date de dernière modification de la ligne

💡 ExtendedProperties

L’objet ÉcritureComptable_Entete supporte un dictionnaire ExtendedProperties pour des propriétés personnalisées ou spécifiques à un ERP.