Une fois le numéro du client sur lequel vous allez travailler en main, vous pouvez définir le ou les signataires qui vont prendre part à la transaction de signature électronique :
- Retrouver ou créer les signataires
- Les associer au contrat en cours
Retrouver ou créer les signataires
https://[host]/calinda/hub/selling/model/contractor/create?action=getOrCreateContractor&[paramètres]
- Paramètres obligatoires :
- customer_number : numéro de client (voir l’étape précédente)
- id : identifiant du signataire (-1 pour le créer)
- civility : civilité du signataire (valeurs possibles : MONSIEUR, MADAME, MADEMOISELLE)
- firstname : prénom du signataire (seuls les lettres, chiffres, (‘), (-) et espace sont acceptés)
- lastname : nom du signataire (seuls les lettres, chiffres, (‘), (-) et espace sont acceptés)
- email : email du signataire
- address_1 : adresse partie 1
- postal_code : code postal (5 chiffres pour la France)
- city : ville
- country : pays (ISO 3166 alpha-2 country code ou UN M.49 numeric-3 area code)
- cell_phone : téléphone mobile (chiffres uniquement, préfixe ‘+’ autorisé)
- Paramètres facultatifs :
(doivent figurer dans la requête en mode http get mais acceptent une valeur vide)- phone : téléphone du signataire
- address_2 : adresse partie 2
- company_name : nom de la société
- is_default : true si c’est le signataire par défaut pour le client, sinon false
- job_title : fonction
- registration_number : numéro de SIRET
- birthdate : date de naissance du contact
- birthplace : lieu de naissance du contact
- category : rôle
- localisation : La langue du signataire parmi ‘en_US’, ‘fr_FR’, ‘es_ES’ ou ‘de_DE’
Quand une création de signataire est demandée et que les attributs firstname, lastname, email et customer_number sont identiques à ceux d’un autre signataire, alors la création n’est pas réalisée et la fonction retourne l’identifiant du signataire trouvé.
Exemple :
https://cloud.sellandsign.com/calinda/hub/selling/model/contractor/create?action=getOrCreateContractor&customer_number=AM201603021055&id=-1&address_1=A&postal_code=13100&city=PARIS&country=FR&civility=MONSIEUR&firstname=Bernard&lastname=Sanders&email=test%40calinda.fr&cell_phone=01234567890
&company_name=®istration_number=&address_2=&phone=&job_title=&birthdate=&birthplace=&is_default=true&category=&j_token=[votre token d'authentification]
Retour :
{"id":11522,
"category":"",
"customerNumber":"AM201603021055",
"civility":"MONSIEUR",
"firstname":"Bernard",
"lastname":"Sanders",
"phone":"",
"email":"test@calinda.fr",
"address_1":"A",
"address_2":"",
"postal_code":"13100",
"city":"PARIS",
"syncTimer":1456929742803,
"lastModificationPlace":"SERVER",
"companyName":"",
"isDefault":1,
"country":"FR",
"cell_phone":"01234567890",
"jobTitle":"",
"registrationNumber":"",
"birthdate":-1,
"birthplace":""}
Définition du mode de signature des signataires
Le mode de signature des signataires peut varier d’un contrat à l’autre. Il sera donc défini à l’étape suivante : la création du contrat à faire signer !
Retrouver la liste des signataires associés à un client
Pour un client donné, vous pouvez également retrouver la liste des signataires associés à ce client en utilisant la méthode getContractorsFor :
https://[host]/calinda/hub/selling/model/contractor/read?action=getContractorsFor&number=][numero de client]&offset=0&size=100
(les paramètres offset et size peuvent vous permettre paginer de grandes quantités de donnée)