header API

API : Fusionner plusieurs PDF

Vous voulez faire signer plusieurs documents en un seul effort de consentement. Vous avez deux choix possibles :

  • la liasse de documents qui vous fournit des dossiers de preuves juridiques indépendants et
  • la fusion de PDF, ou qui vous fournit un dossier de preuve juridique solidaire.

Pour créer une liasse, suivez les indications de la page suivante : https://doc.sellandsign.com/fr/api-creation-usage-liasses/

Pour la fusion de PDF, la simple utilisation des méthodes addContractPart et getContractPartsFor fusionne les documents lorsque vous en ajoutez plusieurs.

Pour charger un PDF, avant d’en personnaliser éventuellement les champs et de l’envoyer en signature, on peut donc utiliser successivement ces méthodes :

  • addContractPart vise à transmettre des parties d’un contrat sous la forme d’un PDF au serveur pour ajouter à la partie précédente.
  • getContractPartsFor récupère l’ensemble des parties constituant un contrat

La notion de ContractPart signifie que le document peut être une partie d’un ensemble de documents qui seront fusionnés pour faire signer en un seul effort de consentement, constituant un dossier de preuve juridique solidaire (contrairement à la liasse où plusieurs documents signés conjointement constituent des dossiers de preuve juridique indépendants).

Une façon rapide d’appeler ces méthodes est d’utiliser l’API REST sous la forme d’un HTTP POST puis d’un HTTP GET.

Cette fonctionnalité est disponible à partir de SELL&SIGN version 4.0.

Ajouter une partie au contrat

Il faut connaître l’identifiant du contrat (id de l’objet), et faire l’appel suivant en HTTP POST.

https://[host]/calinda/hub/selling/do?m=addContractPart&contract_id=153

    Query String Parameters : 

    {
    "contract_id" : 153,
    }
    • contract_id :  correspond à l’identifiant du contrat pour lequel vous souhaitez ajouter un document PDF.

    Dans le body, il faudra définir le binaire du pdf d’une part application/pdf d’un body en multipart/form-data.

    Récupérer l’ensemble des parties d’un contrat

    Il suffit à présent d’utiliser la méthode GET pour récupérer toutes les parties à fusionner.

    https://[host]/calinda/hub/selling/model/contractpart/list?action=getContractPartsFor&contract_id=153&offset=0&size=999999&without_deleted=true

      Query String Parameters :

      {
      "action" : getContractPartsFor,
      "contract_id" : 153,
      "offset" : 0,
      "size" : 999999,
      "without_deleted" : true,
      }
        • action concerne la méthode que vous êtes en train d’utiliser.
        • contract_id correspond à l’identifiant du contrat pour lequel vous souhaitez utiliser un document PDF.
        • offset est l’index du premier résultat (avec size, cela permet de se déplacer par bloc dans le résultat).
        • size est la taille du bloc de résultat à retourner.
        • without_deleted permet d’inclure dans la liste les parties qui ont été supprimées logiquement. Nous les gardons pour proposer à l’utilisateur la reprise automatique de ses anciennes saisies de Smartfields®.

      En cas d'erreur HTTP

      Une erreur HTTP 400 peut indiquer le manque d’un attribut, d’une valeur inappropriée. Le message joint à l’erreur vous permettra de trouver sa cause.En cas d’erreur HTTP 500, vous pouvez contacter le support ici : https://support.sellandsign.com en insérant votre requête dans le ticket.