Pular para o conteúdo principal

Definindo as posições de assinatura

Existem três maneiras de definir as posições de assinatura no Auco; você pode escolher a que melhor atende às suas necessidades e conveniência.

1. Especificação por coordenadas​

Você pode incluir o parâmetro position dentro de cada objeto signProfile para definir manualmente as coordenadas da assinatura no documento. Esse parâmetro deve ser um array de objetos, em que cada objeto representa uma assinatura em uma página específica.

Cada posição deve incluir as seguintes propriedades:

  • page: número da página onde a assinatura será colocada (a partir de 1).
  • x: posição horizontal relativa (entre 0 e 1), calculada como: (signatureX + signatureWidth) ÷ pageWidth
  • y: posição vertical relativa (entre 0 e 1), calculada como: (signatureY + signatureHeight) ÷ pageHeight
  • w: largura da assinatura em pontos (unidades do PDF).
  • h: altura da assinatura em pontos (unidades do PDF).
"signProfile": [
  {
    "name": "Firmante 1",
    "email": "example@auco.ai",
    "position": [
      {
        "page": 1,
        "x": 0.65,
        "y": 0.80,
        "w": 150,
        "h": 50
      }
    ]
  }
]

2. Usando um modelo no Auco​

Se você trabalha com um documento PDF padrão em que os locais de assinatura não mudam, pode criar um modelo no Auco com a ajuda de um de nossos consultores. Esse modelo armazenará as posições de assinatura associadas a tipos de signatário predefinidos (por exemplo: gerente, candidato etc.).

Depois que o modelo for criado, basta referenciar o identificador dele no campo document e indicar os signatários usando o campo type correspondente. Isso simplifica o processo e evita definir manualmente as coordenadas das assinaturas.

{
  "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. Usando tags de assinatura no documento PDF​

O Auco permite posicionar as assinaturas diretamente no conteúdo do PDF usando tags especiais. Essa funcionalidade só está disponível ao enviar o documento PDF codificado em Base64 na requisição (campo file).

Como funciona?​

  • No documento PDF, você deve inserir a tag {{signature:signerPosition}} no local onde deseja que a assinatura apareça.
  • signerPosition corresponde à posição do signatário no array signProfile. Por exemplo, {{signature:0}} inserirá a assinatura do primeiro signatário, {{signature:1}} a do segundo, e assim por diante.
  • Na requisição, cada objeto do array signProfile deve incluir o parâmetro "label": true para ativar o uso da tag em vez das coordenadas manuais (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

Baixar exemplo

Essa abordagem é ideal quando você precisa de controle visual sobre o local das assinaturas diretamente no editor do documento. Certifique-se de que as tags não estejam dentro de caixas de texto ou elementos gráficos que impeçam o sistema de lê-las.