Guide de migration

Catégorie : Core
Domaine : SalesAdministration
Service : CustomerReadAccessBasic
Méthode : GetCustomerDefaultAddress

Contrat de la V1

Verbe : GET
URL : https://cegid-expert-webapi-core.cegid.com/SalesAdministration/CustomerReadAccessBasicWebService/GetCustomerDefaultAddress
Paramètres : QUERY
Le contrat de la V1 impose la saisie d’un identifiant client via le paramètre id.
Réponse :
Retour de la V1 pour le client dont l’identifiant est « FRO001 » :

{
    "shortName": "FRODON",
    "physicalPerson": {
        "lastName": "SAQUET ",
        "firstName": "Frodon ",
        "civility": "   "
    },
    "address": {
        "address1": "3 chemin du trou dans le talus",
        "address2": "",
        "address3": "",
        "zipCode": "69000",
        "city": "HOBBITBOURG",
        "country": "FRA",
        "area": "La comté"
    }
}

Contrat de la V2

Verbe : POST
URL : https://api.cegid.com/cpa-expert-coreSalesAdministration/CustomerConsultationWebService/ViewCustomersUsingFilters
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 l’identifiant du client avec l’opérateur de comparaison « Egal » (1) et la bonne valeur.

Note

Ajouter la sélection des données d’identité légale (1) et d'adresse (2) car, comme indiqué dans l’APIM, elles ne sont pas retournées par défaut.
Vous pouvez ajouter d’autres sélections si besoin.

{
    "page": {
        "pageIndex": 1,
        "pageSize": 1
    },
    "filters": [{
        "property": 1,
        "constantValue": "FRO001",
        "comparisonOperateur": 1,
        "inversion": false,
        "logicOperator": 1
    }],
    "selection": [1,2]
}

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
    },
    "customers": [
        {
            "id": "FRO001",
            "shortName": "FRODON",
            "closed": false,
            "civilStatus": {
                "lastName": "SAQUET ",
                "firstName": "Frodon ",
                "civility": "   ",
                "siret": "",
                "duns": "",
                "nif": "",
                "naf": "",
                "exchangeNatureId": 3,
                "exchangeNatureCode": "B2C",
                "exchangeNatureDescription": "B2C"
            },
            "address": {
                "address1": "3 chemin du trou dans le talus",
                "address2": "",
                "address3": "",
                "zipCode": "69000",
                "city": "HOBBITBOURG",
                "country": "FRA",
                "area": "La comté"
            }
        }
    ]
}