Guide de migration

Catégorie : Core
Domaine : SystemInfo
Service : DossierReadAccess
Méthode : GetDossierAnnuaryReference

Contrat de la V1

Verbe : GET
URL : https://cegid-expert-webapi-core.cegid.com/SystemInfo/DossierReadAccessWebService/GetDossierAnnuaryReference
Paramètres : Aucun
Le dossier est celui de l'en-tête CegidExpert-DossierConnect

Réponse :
Exemple pour le dossier 000000 :

{
    "noDossier": "000000",
    "description": "DOSSIER CABINET11 (2)",
    "typeDossier": "PRO",
    "personCode": 1,
    "personId": "4C5B7CE2-0041-11DB-BC50-0003FF5E067E",
    "typePerson": 1,
    "legalStatus": "EURL",
    "siren": "123456789",
    "nic": "00015",
    "codeINSEE": "5498",
    "codeNAF": "6920Z"
}

Contrat de la V2

Verbe : POST
URL : https://api.cegid.com/cpa-expert-coreSystemInfo/DossierConsultationWebService/ViewDossiersUsingFilter
Paramètres : BODY
Le contrat de la V2 impose la pagination.
Pour obtenir la même donnée en V2, il est possible d’ajouter un filtre sur le bon numéro de propriété.

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

Filtrer sur la propriété 1 pour le code dossier avec l’opérateur de comparaison « Egal » (1) et la bonne valeur.

{
    "page": {
        "pageIndex": 1,
        "pageSize": 1
    },
    "filters": [{
        "Property": 1,
        "ConstantValue": "000000",
        "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": {
        "pageCount": 1
    },
    "dossierCollection": [
        {
            "id": "000000",
            "description": "DOSSIER CABINET11 (2)",
            "typeId": 1,
            "typeCode": "PRO",
            "isAccountingFirm": true,
            "lastEntryModification": "1900-01-01T00:00:00",
            "legalInformation": {
                "id": "4c5b7ce2-0041-11db-bc50-0003ff5e067e",
                "legalStatus": 1,
                "legalForm": "EURL",
                "siren": "123456789",
                "nic": "00015",
                "naf": "6920Z",
                "codeInsee": "5498"
            },
            "right": {
                "isGlobalPassword": true
            },
            "applicationProtectCollection": [],
            "state": {
                "lockId": 1,
                "lockCode": "ENL",
                "lockDescription": "en ligne",
                "disable": false,
                "missing": false
            }
        }
    ]
}

> [!IMPORTANT]
> La propriété `PersonCode` de la V1 n’est pas disponible dans la V2 car cette information n'est pas utilisée dans Cegid Expert.  
> La propriété `LegalStatus` de la V1 est disponible dans la V2 dans la propriété `LegalForm`.  
> La propriété `TypePerson` de la V1 est disponible dans la V2 dans la propriété `LegalStatus`.  
> Pour résumé `LegalStatus` contient désormais le type de personne (physique ou morale) et `LegalForm` contient la forme juridique.