Guide de migration

Catégorie : Core
Domaine : Comptabilite
Service : EntryReadAccessBasic
Méthode : GetEntryByFiscalYearGeneralAccountPeriod

Contrat de la V1

Verbe : POST
URL : https://cegid-expert-webapi-core.cegid.com/Comptabilite/EntryReadAccessBasicWebService/GetEntryByFiscalYearGeneralAccountPeriod
Paramètres : BODY
Le contrat V1 demande de passer l’exercice, le journal, l’axe et un numéro de mois relatif au début de l’exercice dans un objet de filtre :

{
    "Page": 1,
    "PageSize": 0,
    "CustomPageSize": 1,
    "FilterRequest": {
        "FiscalYear": "001",
        "GeneralAccount": "61610000"
        "RelativeMonth": "2"
    }
}

Note

Dans cet exemple, l’exercice 001 commence le 1er avril 2010, le deuxième mois est donc le mois de mai 2010

Réponse :

{
    "nextPage": 2,
    "pageCount": 4,
    "entries": [
        {
            "journal": "B01",
            "fiscalYear": "001",
            "entryDate": "2010-05-10T00:00:00",
            "pieceNumber": 2,
            "lineNumber": 9,
            "pieceQualification": "N  ",
            "echeanceNumber": 0,
            "regroupingOfFolioPiece": 1,
            "entryLine": {
                "generalAccount": "61610000",
                "subsidiaryAccount": "",
                "debit": 74.9300,
                "credit": 0.0000,
                "description": "ADI MAI",
                "pieceNature": "OD ",
                "movementType": "DIV"
            },
            "entryReferences": {
                "internalReference": "4",
                "externalReference": "",
                "externalReferenceDate": "1900-01-01T00:00:00"
            }
        }
    ]
}

Note

Seules les écritures normales (qualification « N ») sont renvoyées.

Contrat de la V2

Verbe : POST
URL : https://api.cegid.com/cpa-expert-coreComptabilite/AccountingEntriesConsultationWebService/ViewAccountingEntriesUsingFilter
Paramètres : BODY
Le contrat de la V2 n’impose pas de filtre.
Pour obtenir les mêmes données, il est possible d’ajouter des filtres sur les bons numéros de propriétés.

Les numéros des propriétés sont affichés dans l’APIM :

Filtrer sur la propriété 1 pour l’exercice avec l’opérateur de comparaison « Egal » (1).
Filtrer sur la propriété 3 pour le compte général avec l’opérateur de comparaison « Egal » (1).
Filtrer sur la propriété 5 pour la date avec l’opérateur de comparaison « Supérieur ou égal » (5).
Filtrer sur la propriété 5 pour la date avec l’opérateur de comparaison « Inférieur à » (8).

Note

Filtrer sur la propriété 6 avec l’opérateur « Egal » (1) et la valeur « 1 » pour prendre les écritures normales uniquement.

{
    "page": {
        "pageIndex": 1,
        "pageSize": 1
    },
    "filters": [{
        "property": 1,
        "constantValue": "001",
        "comparisonOperateur": 1,
        "inversion": false,
        "logicOperator": 1
    },
    {
        "property": 3,
        "constantValue": "61610000",
        "comparisonOperateur": 1,
        "inversion": false,
        "logicOperator": 1
    },
    {
        "property": 5,
        "constantValue": "2010-05-01",
        "comparisonOperateur": 5,
        "inversion": false,
        "logicOperator": 1
    },
    {
        "property": 5,
        "constantValue": "2010-06-01",
        "comparisonOperateur": 8,
        "inversion": false,
        "logicOperator": 1
    },
    {
        "property": 6,
        "constantValue": "1",
        "comparisonOperateur": 1,
        "inversion": false,
        "logicOperator": 1
    }]
}

Réponse :
Le retour renvoie plus d’informations dans la V2.
Elles sont également organisées différemment.
Mais les informations disponibles dans la V1 le sont toujours dans la V2.

{
    "page": {
        "nextPage": 2,
        "pageCount": 4
    },
    "accountingEntries": [
        {
            "journal": "B01",
            "fiscalYear": "001",
            "entryDate": "2010-05-10T00:00:00",
            "pieceNumber": 2,
            "lineNumber": 9,
            "pieceQualificationId": 1,
             "pieceQualificationCode": "N",
            "pieceQualificationDescription": "Ecritures Comptables Normale",
             "echeanceNumber": 0,
            "updatedDate": "2016-09-27T10:19:11",
            "entryLine": {
                "generalAccount": "61610000",
                "debit": 74.9300,
                "credit": 0.0000,
                "description": "ADI MAI",
                "pieceNatureId": 7,
                "pieceNatureCode": "OD",
                "movementType": "DIV"
            },
            "entryReferences": {
                "internalReference": "4",
                "externalReference": "",
                "externalReferenceDate": "1900-01-01T00:00:00"
            },
            "entryLegal": {
                "businessCenter": "001",
                "regroupingOfFolioPiece": 1
            }
        }
    ]
}