Guide de migration

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

Contrat de la V1

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

{
    "Page": 1,
    "PageSize": 0,
    "CustomPageSize": 1,
    "FilterRequest": {
        "FiscalYear": "001",
        "Journal": "ACH",
        "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": 64,
    "entries": [
        {
            "journal": "ACH",
            "fiscalYear": "001",
            "entryDate": "2010-05-04T00:00:00",
            "pieceNumber": 2,
            "lineNumber": 1,
            "pieceQualification": "N  ",
            "echeanceNumber": 0,
            "regroupingOfFolioPiece": 1,
            "entryLine": {
                "generalAccount": "62610000",
                "subsidiaryAccount": "",
                "debit": 41.7500,
                "credit": 0.0000,
                "description": "ORANGE INTERNET MAI",
                "pieceNature": "OD ",
                "movementType": "DIV"
            },
            "entryReferences": {
                "internalReference": "6024",
                "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é 2 pour le journal 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.

Note

Si vous ne connaissez pas les dates de début et de fin du mois relatif, vous pouvez les déduire en appelant FiscalYearConsultationWebService/GetAllFiscalYear. .

{
    "page": {
        "pageIndex": 1,
        "pageSize": 1
    },
    "filters": [{
        "property": 1,
        "constantValue": "001",
        "comparisonOperateur": 1,
        "inversion": false,
        "logicOperator": 1
    },
    {
        "property": 2,
        "constantValue": "ACH",
        "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": 64
    },
    "accountingEntries": [
        {
            "journal": "ACH",
            "fiscalYear": "001",
            "entryDate": "2010-05-04T00:00:00",
            "pieceNumber": 2,
            "lineNumber": 1,
            "pieceQualificationId": 1,
             "pieceQualificationCode": "N",
            "pieceQualificationDescription": "Ecritures Comptables Normale",
             "echeanceNumber": 0,
            "updatedDate": "2016-09-27T10:19:13",
            "entryLine": {
                "generalAccount": "62610000",
                "debit": 41.7500,
                "credit": 0.0000,
                "description": "ORANGE INTERNET MAI",
                "pieceNatureId": 7,
                "pieceNatureCode": "OD",
                "movementType": "DIV"
            },
            "entryReferences": {
                "internalReference": "6024",
                "externalReference": "",
                "externalReferenceDate": "1900-01-01T00:00:00"
            },
            "entryLegal": {
                "businessCenter": "001",
                "regroupingOfFolioPiece": 1
            }
        }
    ]
}