Aller au contenu principal

Définir les positions de signature

Il existe trois façons de définir les positions de signature dans Auco ; vous pouvez choisir celle qui correspond le mieux à vos besoins et à votre confort.

1. Spécification par coordonnées​

Vous pouvez inclure le paramètre position dans chaque objet signProfile afin de définir manuellement les coordonnées de la signature dans le document. Ce paramètre doit être un tableau d'objets, où chaque objet représente une signature sur une page donnée.

Chaque position doit inclure les propriétés suivantes :

  • page : numéro de la page où la signature sera placée (à partir de 1).
  • x : position horizontale relative (entre 0 et 1), calculée ainsi : (signatureX + signatureWidth) ÷ pageWidth
  • y : position verticale relative (entre 0 et 1), calculée ainsi : (signatureY + signatureHeight) ÷ pageHeight
  • w : largeur de la signature en points (unités PDF).
  • h : hauteur de la signature en points (unités PDF).
"signProfile": [
  {
    "name": "Firmante 1",
    "email": "example@auco.ai",
    "position": [
      {
        "page": 1,
        "x": 0.65,
        "y": 0.80,
        "w": 150,
        "h": 50
      }
    ]
  }
]

2. Utiliser un modèle dans Auco​

Si vous travaillez avec un document PDF standard dont les emplacements de signature ne changent pas, vous pouvez créer un modèle dans Auco avec l'aide de l'un de nos conseillers. Ce modèle conservera les positions de signature associées à des types de signataires prédéfinis (par exemple : responsable, candidat, etc.).

Une fois le modèle créé, il suffit de référencer son identifiant dans le champ document et d'indiquer les signataires à l'aide du champ type correspondant. Cela simplifie le processus et évite de définir manuellement les coordonnées des signatures.

{
  "document": "TEMPLATE_ID",  // ID of the template containing the signature positions
  "signProfile": [
    {
      "type": "gerente",       // Signer type defined in the template
      "name": "Firmante 1",
      "email": "example@auco.ai",
      "phone": "+573123456789"
    },
    {
      "type": "candidato",     // Another signer type defined in the template
      "name": "Firmante 2",
      "email": "example@auco.ai",
      "phone": "+573123456789"
    }
  ]
}

3. Utiliser des balises de signature dans le document PDF​

Auco permet de positionner les signatures directement dans le contenu du PDF à l'aide de balises spéciales. Cette fonctionnalité n'est disponible que lorsque le document PDF est envoyé encodé en Base64 dans la requête (champ file).

Comment cela fonctionne-t-il ?​

  • Dans le document PDF, vous devez insérer la balise {{signature:signerPosition}} à l'endroit où vous souhaitez que la signature apparaisse.
  • signerPosition correspond à la position du signataire dans le tableau signProfile. Par exemple, {{signature:0}} insérera la signature du premier signataire, {{signature:1}} celle du deuxième, et ainsi de suite.
  • Dans la requête, chaque objet du tableau signProfile doit inclure le paramètre "label": true pour activer l'utilisation de la balise à la place des coordonnées manuelles (position).
{
  "file": "base64-encoded-pdf",
  "signProfile": [
    {
      "name": "Firmante 1",
      "email": "example@auco.ai",
      "phone": "+573123456789",
      "label": true
    },
    {
      "name": "Firmante 2",
      "email": "example@auco.ai",
      "phone": "+573123456789",
      "label": true
    }
  ]
}
info

Télécharger l'exemple

Cette approche est idéale lorsque vous avez besoin d'un contrôle visuel sur l'emplacement des signatures directement depuis l'éditeur de documents. Assurez-vous que les balises ne se trouvent pas dans des zones de texte ou des éléments graphiques qui empêchent le système de les lire.