Ajouter un champ automatique Entreprise

Un champ est l’objet qui porte l’action à effectuer par un participant. Un champ a un type qui peut être soit :

• signature (pour une demande de signature par une personne physique ou un cachet par une personne morale),
• visa (pour une demande de consultation par une personne physique),
• text (pour un champ de texte à remplir par le participant),
• label (pour un texte en lecture seule ajouté par le créateur de la transaction sur un document),
• checkbox_group (pour un groupe de cases à cocher par le participant),
• checkbox (pour une case à cocher par le participant),
• radio_group (pour un groupe de boutons radio à cocher par le participant),
• radiobutton (pour un bouton radio à cocher par le participant),
• dropdown (pour une liste déroulante dans laquelle le participant doit sélectionner une option).
• image (pour un champ image dans lequel le participant doit importer un fichier image),
• signature_date (pour un champ qui affiche la date et l’heure auxquelles le participant a signé le document),
• full_name (pour un champ qui affiche le nom complet du participant),
• email (pour un champ qui affiche l’email du participant),
• company_name (pour un champ qui affiche le nom de l’entreprise du participant),
• job_title (pour un champ qui affiche la fonction du participant).

Vous pouvez également ajouter des Paraphes.

A propos des champs automatiques « Entreprise »

Un champ automatique « Entreprise » vous permet de récupérer le nom de l’entreprise du participant à partir de la liste de contacts de votre espace de travail et de l’afficher sur le document de transaction. Le participant peut modifier le nom de son entreprise lors du parcours de signature.

Notez que vous ne pouvez pas ajouter de champs :

• sur un document qui a déjà été traité par un participant,
• sur un document qui contient déjà une signature (avant d’être importé dans la transaction).

Créer un champ automatique « Entreprise »

Pour créer un champ automatique « Email », envoyez une requête à POST /v1/transactions/{transaction_id}/documents/{document_id}/fields et transmettez company_name dans l’argument type.

Vous pouvez transmettre d’autres arguments optionnels :

curl
https://api.universign.com/v1/transactions/tx_DwYGle91EQZA/documents/doc_4dn/fields \
-d type=company_name \
-d page=1 \
-d x=328 \
-d y=580 \
-d required=false \
-d width=200 \
-d height=19

• name : le nom du champ.
• page : le numéro de la page sur laquelle vous souhaitez positionner le champ.
• x : coordonnée horizontale du champ sur la page du document (en pixels).
• y : coordonnée verticale du champ sur la page du document (en pixels).
• copy_from : à utiliser pour copier le champ. La valeur attendue est l’identifiant du champ que vous souhaitez copier. Cela crée un nouveau champ sans position sur le document. Ne pas passer si vous passez l’argument move_from
• move_from : à utiliser pour déplacer un champ vers un autre document. La valeur attendue est l’identifiant du champ que vous souhaitez déplacer. Ne pas passer si vous passez l’argument copy_from.
• height : la hauteur du champ (exprimée en unités d’espace utilisateur par défaut du PDF). La valeur par défaut est 19.
• width : la largeur du champ (exprimée en unités d’espace utilisateur par défaut du PDF). La valeur par défaut est 200.
• font_size : la taille de police du contenu du champ. Valeurs possibles comprises entre 7 et 12. La valeur par défaut est 12.
• required : indique si le participant doit remplir le champ ou non. La valeur par défaut est true.

L’API renvoie un sous-objet field.

{
  "id" : "fld_4zlL",
  "type" : "company_name",
  "position" : {
    "page" : 1,
    "x" : 328,
    "y" : 580,
    "width" : 200,
    "height" : 19
  },
  "font_size" : 12,
  "updatable" : true,
  "deletable" : false,
  "required" : false,
  "built_in" : false
}

Éditer un champ automatique « Entreprise »

Pour éditer un champ automatique « Entreprise », envoyez une requête à POST /v1/transactions/{transaction_id}/documents/{document_id}/fields/{field_id}.

curl
https://api.universign.com/v1/transactions/tx_DwYGle91EQZA/documents/doc_4dn/fields \
-d type=company \
-d page=2 \
-d x=200 \
-d y=200 \
-d required=true \
-d width=250 \
-d height=35

L’API renvoie un sous-objet field mis à jour.

{
  "id" : "fld_4zlL",
  "type" : "company_name",
  "position" : {
    "page" : 2,
    "x" : 200,
    "y" : 200,
    "width" : 250,
    "height" : 35
  },
  "font_size" : 12,
  "updatable" : true,
  "deletable" : false,
  "required" : true,
  "built_in" : false
}

---

Ajouter un champ automatique Email

← Précédent

Ajouter un champ automatique Fonction

Suivant →