Comment envoyer un PDF pour signature sans créer de modèle

La plupart des API de signature électronique vous obligent à créer un modèle avant de pouvoir envoyer quoi que ce soit à signer. Vous téléversez votre PDF, définissez vos champs, l’enregistrez comme modèle, puis créez une demande de signature à partir de ce modèle.

Ce flux de travail a du sens lorsque vous envoyez le même document encore et encore. Contrats de travail, NDA, accords fournisseurs. Tout ce que vous allez utiliser plus de quelques fois mérite un modèle.

Mais parfois, vous avez simplement besoin d'envoyer un document ponctuel. Une proposition personnalisée. Un accord juridique différent à chaque fois. Une approbation interne rapide que vous ne reproduirez jamais. Créer un modèle pour un document que vous n’utiliserez qu’une seule fois ajoute des frictions et encombre votre espace de travail.

Firma.dev prend désormais en charge les demandes de signature ponctuelles. Vous pouvez téléverser un PDF directement, définir vos destinataires et vos champs en ligne, puis l’envoyer à signer sans jamais créer de modèle. Cet article explique son fonctionnement.

Quand les modèles ont du sens (et quand ce n'est pas le cas)

Les modèles sont le bon choix lorsque vous envoyez régulièrement la même structure de document. Si vous avez une lettre d’offre envoyée à chaque nouvelle recrue, ou un NDA que chaque fournisseur signe, ou une facture mensuelle qui comporte toujours les mêmes champs aux mêmes endroits, les modèles vous font gagner du temps. Vous les configurez une fois et les réutilisez indéfiniment.

Mais les modèles deviennent une charge lorsque le document est unique. Une proposition personnalisée dont les tarifs changent pour chaque prospect. Un accord de règlement négocié puis révisé avant la signature. Un formulaire d’approbation interne différent selon la situation.

Dans ces cas, créer un modèle juste pour l’utiliser une seule fois est une tâche fastidieuse. Vous vous retrouvez avec un espace de travail rempli de modèles à usage unique que vous ne rouvrirez jamais.

Le flux de travail des demandes de signature ponctuelles

Le flux de travail ponctuel ignore complètement l’étape du modèle. Voici à quoi il ressemble :

1. Prenez votre PDF et encodez-le en base64

2. Définissez vos destinataires en ligne (nom, e-mail, s’ils sont signataires ou en copie, ordre de signature le cas échéant)

3. Définissez vos champs en ligne (zones de signature, champs de texte, dates, cases à cocher, tout ce dont vous avez besoin) avec leur position sur la page

4. Appelez le point de terminaison de création ou le point de terminaison atomique de création et d’envoi

5. Terminé. Aucun modèle requis.

La demande de signature fonctionne exactement comme une demande basée sur un modèle. Vos destinataires sont notifiés, ils signent, et vous recevez le document complété ainsi que la piste d’audit. La seule différence est que vous n’avez pas eu à créer de modèle au préalable.

Exemple : envoi d’une proposition personnalisée

Imaginons que vous êtes une entreprise SaaS envoyant une proposition tarifaire personnalisée à un prospect. La proposition est un PDF d’une page avec le nom de son entreprise, le tarif que vous avez négocié et une ligne de signature.

Voici à quoi ressemble l’appel API en utilisant le point de terminaison atomique de création et d’envoi :

{
  "name": "Proposal - Acme Corp",
  "document": "JVBERi0xLjQK...",
  "recipients": [
    {
      "id": "temp_signer_1",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@acmecorp.com",
      "designation": "Signer",
      "order": 1
    }
  ],
  "fields": [
    {
      "recipient_id": "temp_signer_1",
      "type": "signature",
      "page": 1,
      "x": 100,
      "y": 650,
      "width": 200,
      "height": 50
    },
    {
      "recipient_id": "temp_signer_1",
      "type": "date",
      "page": 1,
      "x": 320,
      "y": 650,
      "width": 100,
      "height": 30
    }
  ],
  "settings": {
    "send_signing_email": true
  }
}

{
  "name": "Proposal - Acme Corp",
  "document": "JVBERi0xLjQK...",
  "recipients": [
    {
      "id": "temp_signer_1",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@acmecorp.com",
      "designation": "Signer",
      "order": 1
    }
  ],
  "fields": [
    {
      "recipient_id": "temp_signer_1",
      "type": "signature",
      "page": 1,
      "x": 100,
      "y": 650,
      "width": 200,
      "height": 50
    },
    {
      "recipient_id": "temp_signer_1",
      "type": "date",
      "page": 1,
      "x": 320,
      "y": 650,
      "width": 100,
      "height": 30
    }
  ],
  "settings": {
    "send_signing_email": true
  }
}

{
  "name": "Proposal - Acme Corp",
  "document": "JVBERi0xLjQK...",
  "recipients": [
    {
      "id": "temp_signer_1",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@acmecorp.com",
      "designation": "Signer",
      "order": 1
    }
  ],
  "fields": [
    {
      "recipient_id": "temp_signer_1",
      "type": "signature",
      "page": 1,
      "x": 100,
      "y": 650,
      "width": 200,
      "height": 50
    },
    {
      "recipient_id": "temp_signer_1",
      "type": "date",
      "page": 1,
      "x": 320,
      "y": 650,
      "width": 100,
      "height": 30
    }
  ],
  "settings": {
    "send_signing_email": true
  }
}

Le champ document contient votre PDF encodé en base64. Le tableau recipients définit qui doit signer. Le tableau fields place une zone de signature et un champ de date sur la page 1 aux coordonnées que vous indiquez.

Un seul appel API, et Jane reçoit un e-mail lui demandant de signer. Aucune création de modèle requise.

Remarquez le schéma temp_signer_1 dans l’ID du destinataire. Lorsque vous créez des destinataires et des champs dans la même requête, vous utilisez des ID temporaires pour les relier entre eux. L’API les résout en véritables UUID après la création.

Définir des champs sans l’éditeur de modèles

Lorsque vous utilisez des modèles, vous pouvez placer les champs visuellement à l’aide de l’éditeur de modèles intégré. Avec les demandes ponctuelles, vous définissez les positions des champs directement dans l’appel API, ce qui signifie que vous devez connaître les coordonnées.

Chaque champ a besoin :

• page – quelle page du PDF (indexée à partir de 1)

• x et y – position à partir du coin inférieur gauche de la page, en points

• width et height – dimensions du champ, en points

Si vous ne savez pas où placer les champs, ouvrez votre PDF dans une visionneuse qui affiche les coordonnées (la plupart le font), ou estimez simplement puis ajustez. L’expérience de signature est suffisamment tolérante pour que vous n’ayez pas besoin d’un placement au pixel près.

Types de champs disponibles pour les demandes ponctuelles :

• signature – capture de signature

• initials – capture des initiales

• text – saisie de texte libre

• date – sélecteur de date

• checkbox – case à cocher oui/non

Vous pouvez également marquer les champs de texte comme read_only si vous souhaitez préremplir une valeur que le signataire peut voir mais pas modifier. C’est utile pour des éléments comme les montants du contrat, les numéros de référence ou toute donnée déjà convenue.

Quand utiliser les modèles à la place

Les demandes ponctuelles sont idéales pour les documents ad hoc, mais les modèles restent le meilleur choix lorsque vous envoyez la même structure de document plus de deux ou trois fois.

Les modèles vous permettent d’utiliser l’éditeur de modèles intégré pour placer les champs visuellement au lieu de calculer les coordonnées. Ils fonctionnent aussi avec l’éditeur de demandes de signature intégré, qui permet aux utilisateurs non techniques de renseigner les détails des destinataires et d’envoyer des documents sans toucher à l’API.

En règle générale : si vous allez envoyer un document plus de deux ou trois fois, créez un modèle. Si c’est une opération ponctuelle, sautez l’étape du modèle et utilisez une demande ponctuelle.

Conclusion

Les demandes de signature ponctuelles éliminent les frictions des documents ad hoc. Vous n’avez pas à créer de modèles que vous ne réutiliserez jamais, et vous n’avez pas à encombrer votre espace de travail avec des structures de documents à usage unique.

Les modèles sont toujours là lorsque vous en avez besoin. Les deux flux de travail utilisent les mêmes types de champs, les mêmes options de destinataires et le même suivi et les mêmes pistes d’audit. Vous choisissez simplement le chemin qui convient à la situation.

Si vous voulez l’essayer, le point de terminaison de création de demande de signature propose une documentation complète sur le flux de travail ponctuel. Ou utilisez le point de terminaison atomique pour créer et envoyer en un seul appel.

Commencez gratuitement avec Firma.dev – aucune carte de crédit requise.