Table of Contents

Guide de migration

Catégorie : Core
Domaine : SalesAdministration
Service : AnnuaryUpdateAccessBasic
Méthode : AddAnnuaryContact

Contrat de la V1

Verbe : POST
URL : https://cegid-expert-webapi-core.cegid.com/SalesAdministration/AnnuaryUpdateAccessBasicWebService/AddAnnuaryContact
Paramètres : BODY
Le contrat de la V1 impose la saisie d’un objet contenant l’identifiant de la personne de l’annuaire (obligatoire) et les données concernant le contact (où le nom est obligatoire).

{
  "Id": "E3ED4407-F942-40C0-88BF-7F63730547D8",
  "Contact": {
    "LastName": "Amnell",
    "FirstName": "Kahlan",
    "Main": false,
    "Phone": "0",
    "MobilePhone": "1",
    "Email": "kalhan.amnell@legendoftheseeker.com",
    "Job": "Inquisitrice"
  }
}

Réponse :
Le retour est booléen indiquant si le contact a pu être ajouté à la personne de l'annuaire.

Note

Si la personne de l’annuaire est rattachée à un client, un contact client est créé en lieu et place du contact d’annuaire (pour compatibilité avec la GI).

Contrat de la V2

Verbe : POST
URL : https://api.cegid.com/cpa-expert-coreSalesAdministration/AnnuaryContactInsertionWebService/CreateAnnuaryContact
Paramètres : BODY
Pour procéder à l’insertion d’un contact en V2, il faut fournir le même identifiant d’annuaire et renseigner le sous-objet contenant les données du contact.

{
  "id": "E3ED4407-F942-40C0-88BF-7F63730547D8",
  "contact": {
    "lastName": "Amnell",
    "firstName": "Kahlan",
    "civility": "MME",
    "gender": 0,
    "job": "Inquisitrice",
    "phone": "0",
    "mobile": "1",
    "email": "kalhan.amnell@legendoftheseeker.com",
    "isBillingEmail": false
  }
}
Note

Pour éviter des problèmes dans la GI, la propriété « Main », spécifiant s’il s’agit du contact principal, a été retirée du contrat. Cette donnée est désormais déterminée par l’existence d’un autre contact pour la personne concernée.
Le contact est considéré comme principal s’il n’existe pas d’autre pour la personne spécifiée.

Réponse :
Le retour est un objet contenant les données permettant d’identifier le contact.

{
  "contactType": 1,
  "id": "E3ED4407-F942-40C0-88BF-7F63730547D8",
  "contactNumber": 3,
  "main": false
}
Note

Si la personne de l’annuaire est rattachée à un client, un contact client est créé en lieu et place du contact d’annuaire (pour compatibilité avec la GI).
Le cas échéant, la propriété « ContactType » aura la valeur « 2 » et la propriété «Id » contiendra le code du client rattaché à la personne de l’annuaire.
img