API : Définition des signataires

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 :

  1. Retrouver ou créer les signataires
  2. 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)