Skip to main content

Defining Signature Positions

There are three ways to define signature positions in Auco; you can choose the one that best suits your needs and convenience.

1. Coordinate Specification​

You can include the parameter position inside each signProfile object to manually define the signature coordinates in the document. This parameter must be an array of objects, where each object represents a signature on a specific page.

Each position must include the following properties:

  • page: page number where the signature will be placed (starting from 1).
  • x: relative horizontal position (between 0 and 1), calculated as: (signatureX + signatureWidth) ÷ pageWidth
  • y: relative vertical position (between 0 and 1), calculated as: (signatureY + signatureHeight) ÷ pageHeight
  • w: width of the signature in points (PDF units).
  • h: height of the signature in points (PDF units).
"signProfile": [
  {
    "name": "Firmante 1",
    "email": "example@auco.ai",
    "position": [
      {
        "page": 1,
        "x": 0.65,
        "y": 0.80,
        "w": 150,
        "h": 50
      }
    ]
  }
]

2. Using a Template in Auco​

If you work with a standard PDF document where the signature locations do not change, you can create a template in Auco with the help of one of our advisors. This template will store the signature positions associated with predefined signer types (for example: manager, candidate, etc.).

Once the template is created, you only need to reference its identifier using the document field and specify the signers using the corresponding type field. This simplifies the process and avoids manually defining signature coordinates.

{
  "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. Using Signature Tags in the PDF Document​

Auco allows you to position signatures directly within the content of the PDF using special tags. This functionality is only available when sending the PDF document encoded in Base64 within the request (file field).

How does it work?​

  • In the PDF document, you must insert the tag {{signature:signerPosition}} where you want the signature to appear.
  • signerPosition corresponds to the signer’s position in the signProfile array. For example, {{signature:0}} will insert the first signer’s signature, {{signature:1}} the second’s, and so on.
  • In the request, each object in the signProfile array must include the parameter "label": true to activate the use of the tag instead of manual coordinates (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

Download example

This approach is ideal when you need visual control over the location of the signatures directly from the document editor. Make sure that the tags are not inside text boxes or graphic elements that prevent the system from reading them.