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 est logique lorsque vous envoyez le même document encore et encore. Contrats de travail, NDA, accords avec les fournisseurs. Tout ce que vous allez utiliser plus de quelques fois mérite un modèle.

Mais parfois, vous avez juste besoin d'envoyer un document ponctuel. Une proposition personnalisée. Un accord légal qui est 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 frottements et encombre votre espace de travail.

Firma.dev prend désormais en charge les demandes de signature ponctuelles. 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. Cet article explique comment cela fonctionne.

Quand les Modèles Font Sens (Et Quand Ils Ne Le Font 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 qui est envoyée à chaque nouvel employé, ou un NDA que chaque fournisseur signe, ou une facture mensuelle qui a 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 pour toujours.

Mais les modèles deviennent un fardeau lorsque le document est unique. Une proposition personnalisée avec des prix qui changent pour chaque prospect. Un accord de règlement qui est négocié et révisé avant signature. Un formulaire d'approbation interne qui est différent selon la situation.

Pour 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 Demande de Signature Ponctuelle

Le flux de travail ponctuel supprime entièrement l'étape du 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 (boîtes de signature, champs de texte, dates, cases à cocher, tout ce dont vous avez besoin) avec leurs positions 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. Fait. Aucun modèle requis.

La demande de signature fonctionne exactement comme une demande basée sur un modèle. Vos destinataires sont informés, ils signent, vous recevez le document complété et le journal d'audit. La seule différence est que vous n'avez pas eu à créer un modèle d'abord.

Exemple : Envoyer une Proposition Personnalisée

Supposons que vous soyez 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, les prix que vous avez négociés 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 boîte 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 les Champs Sans l'Éditeur de Modèles

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

Chaque champ nécessite :

• page – quelle page du PDF (commençant à 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 n'êtes pas sûr de l'endroit où placer les champs, ouvrez votre PDF dans un visionneur qui montre les coordonnées (la plupart le font), ou faites simplement une estimation et ajustez. L'expérience de signature est suffisamment tolérante pour que vous n'ayez pas besoin d'un placement pixel-perfect.

Types de champs disponibles pour les demandes ponctuelles :

• 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. Ceci est utile pour des éléments tels que les montants des contrats, 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 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 visuellement les champs au lieu de calculer les coordonnées. Ils fonctionnent également avec l'éditeur de demandes 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 un événement unique, ignorez le modèle et utilisez une demande ponctuelle.

Conclusion

Les demandes de signature ponctuelles éliminent les frictions liées aux 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 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 destinataires, et les mêmes suivis et journaux d'audit. Vous choisissez simplement le chemin qui convient à la situation.

Si vous voulez essayer, le point de terminaison de demande de signature a 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 avec Firma.dev gratuitement – aucune carte de crédit requise.