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 pour signature. Vous téléchargez 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 à plusieurs reprises. Contrats de travail, NDA, accords fournisseurs. Tout ce que vous utiliserez plus de quelques fois mérite un modèle.

Mais parfois, vous avez juste besoin d'envoyer un document unique. Une proposition personnalisée. Un accord juridique différent à chaque fois. Une approbation interne rapide que vous ne répéterez 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 uniques. Vous pouvez télécharger un PDF directement, définir vos destinataires et champs en ligne, et l'envoyer pour signature sans jamais créer de modèle. Ce post explique comment cela fonctionne.

Quand les Modèles ont un Sens (Et Quand Ils n'en Ont Pas)

Les modèles sont le bon choix lorsque vous envoyez la même structure de document de manière répétée. Si vous avez une lettre d'offre envoyée à chaque nouvel employé, ou un NDA que chaque fournisseur signe, ou une facture mensuelle ayant 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 surcharge lorsque le document est unique. Une proposition personnalisée avec un prix qui change pour chaque prospect. Un accord de règlement qui est négocié et révisé avant de signer. Un formulaire d'approbation interne différent selon la situation.

Dans ces cas, créer un modèle juste pour l'utiliser une fois est une perte de temps. Vous vous retrouvez avec un espace de travail plein de modèles à usage unique que vous ne toucherez plus jamais.

Le Flux de Travail de la Demande de Signature Unique

Le flux de travail unique passe entièrement outre l'étape de création de modèle. Voici à quoi cela ressemble :

1. Prenez votre PDF et encodez-le en base64

2. Définissez vos destinataires en ligne (nom, email, s'ils sont signataires ou en copie, ordre de signature si applicable)

3. Définissez vos champs en ligne (cases à signer, champs de texte, dates, cases à cocher, ce dont vous avez besoin) avec leurs positions sur la page

4. Appelez le point de terminaison create ou le point de terminaison create-and-send atomique

5. C'est fait. 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, vous recevez le document complété et la piste d'audit. La seule différence est que vous n'avez pas eu à créer un modèle au départ.

Exemple : Envoyer une Proposition Personnalisée

Disons que vous êtes une entreprise SaaS envoyant une proposition de prix personnalisée à un prospect. La proposition est un PDF d'une page avec le nom de leur entreprise, le prix que vous avez négocié, et une ligne de signature.

Voici à quoi ressemble l'appel de l'API en utilisant le point de terminaison create-and-send atomique :

{
  "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 case de signature et un champ de date sur la page 1 aux coordonnées que vous spécifiez.

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

Notez le motif 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 identifiants temporaires pour les lier ensemble. L'API les résout en UUID réels après la création.

Définir des Champs Sans l'Éditeur de Modèle

Lorsque vous utilisez des modèles, vous pouvez placer les champs visuellement à l'aide de l'éditeur de modèles intégré. Avec des demandes uniques, vous définissez les positions des champs dans l'appel de l'API lui-même, ce qui signifie que vous devez connaître les coordonnées.

Chaque champ nécessite :

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

• x et y – position depuis le coin inférieur gauche de la page, en points

• width et height – dimensions du champ, en points

Si vous n'êtes pas sûr de l'emplacement des champs, ouvrez votre PDF dans un visualiseur qui affiche les coordonnées (la plupart le font), ou estimez et ajustez simplement. 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 uniques :

• signature – capture de signature

• initials – capture d'initiales

• text – entrée 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 voulez pré-remplir une valeur que le signataire peut voir mais ne peut pas modifier. Cela est utile pour des éléments comme les montants de contrat, les numéros de référence, ou toute donnée déjà acceptée.

Quand Utiliser des Modèles à la Place

Les demandes uniques sont excellentes pour les documents ponctuels, mais les modèles sont toujours le meilleur choix lorsque vous envoyez la même structure de document plus de quelques 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 également avec l' éditeur de demande de signature intégré, qui permet aux utilisateurs non techniques de remplir les détails des destinataires et d'envoyer des documents sans toucher à l'API.

La 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 chose unique, passez le modèle et utilisez une demande unique.

Conclusion

Les demandes de signature uniques éliminent les frictions des documents ponctuels. Vous n'avez pas besoin de créer des modèles que vous ne réutiliserez jamais, et vous n'avez pas besoin d'encombrer votre espace de travail avec des structures de documents uniques.

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

Si vous voulez l'essayer, le point de terminaison de créer une demande de signature contient toute la documentation sur le flux de travail unique. 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.