Guide de migration

Catégorie : Core
Domaine : Comptabilite
Service : EntryAccountBalance
Méthode : GetCollectiveAccountRangeBalance

Contrat de la V1

Verbe : POST
URL : https://cegid-expert-webapi-core.cegid.com/Comptabilite/EntryAccountBalanceWebService/GetCollectiveAccountRangeBalance
Paramètres : BODY
Le contrat de la V1 impose la saisie d'un compte général collectif.
Il est également nécessaire de préciser des informations permettant de calculer la période sur laquelle on souhaite obtenir le solde et sur quels types d'écritures
D'autres paramètres sont disponibles comme la possibilité de rechercher ou non sur les écritures d'à-nouveau ou la possibilité de choisir le journal à prendre en compte.
Les types d’écritures à rechercher sont les écritures normales (1), les écritures de simulation (2) et les écritures de situations (4).
Ces valeurs sont des puissances de 2 afin de pouvoir les combiner avec une opération binaire.
Par exemple, la valeur 7 est la combinaison des valeur 1, 2 et 4.
Ici, seules les écritures normales sont demandées.
On prend en compte les écriture des 4 premiers mois de l'exercice courant (FiscalYearType=0, PeriodType=6, NumberInPeriode=4, FiscalYearDateRangeBoundaryType=2). Sur ces écritures, on recherche uniquement celle dont le compte général est collectif et commence par "401" et dont le compte auxiliaire commence par "F".

{
  "CollectiveGeneralAccount": "401",
  "SubsidiaryAccount": "F",
  "EntryType": 1,
  "PeriodType": 6,
  "FiscalYearDateRangeBoundaryType": 2,
  "NumberInPeriode": 4,
  "FiscalYearType": 0,
  "CarryForwardKindType": 0,
  "Currency": "",
  "CurrencyType": 0,
  "Journal": "ANO"
}

Réponse :
Le retour se présente sous la forme d’un objet présentant une unique propriété correspondant au solde.

{
  "AccountReport": -4645.0000
}

Note

Le journal ANO correspond, ici au journal d'à nouveau.
On aurait donc pu obtenir le même résultat avec CarryForwardKindType à 2 et aucun code journal.

Contrat de la V2

Verbe : POST
URL : https://api.cegid.com/cpa-expert-coreComptabilite/AccountingEntriesBalanceWebService/GetCollectiveAccountRangeBalanceWithFilters
Paramètres : BODY
Le contrat de la V2 est similaire.
La principale différence réside dans le fait que le code journal a été déplacé dans un filtre.

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

Le contrat de la V2 diffère dans le choix des types d’écritures à rechercher. Au lieu de combiner les valeurs, on les place dans une collection. Pour cette raison, les valeurs n’ont pas besoin d’être des puissances de 2, elles se suivent.
La valeur 7 de la V1 correspond donc à la collection [1,2,3].
Ici, seules les écritures normales sont demandées.

Filtrer sur la propriété 1 pour le journal avec l’opérateur de comparaison « Egal » (1).

{
  "CollectiveGeneralAccount": "401",
  "SubsidiaryAccount": "F",
  "EntryTypes": [1],
  "PeriodKind": 6,
  "BoundaryKind": 2,
  "NumberInPeriod": 4,
  "FiscalYearKind": 0,
  "CarryForwardKind": 0,
  "Currency": "",
  "CurrencyType": 0,
  "Filters": [
        {
            "Property": 1,
            "ConstantValue": "ANO",
            "ComparisonOperateur": 1,
            "Inversion": false,
            "LogicOperator": 1
        }
    ]
}

Réponse :

{
  "balance": -4645.0000
}

Note

Ici encore, le journal ANO correspond, ici au journal d'à nouveau.
On aurait donc pu obtenir le même résultat avec CarryForwardKind à 2 et aucun filtre.