For the complete documentation index, see llms.txt. This page is also available as Markdown.

Posicionamento de assinatura

O posicionamento permite definir onde informações relacionadas aos participantes serão exibidas nas páginas do documento. Esses elementos são adicionados através da propriedade positions de cada signatário.

Quando posições são configuradas, os elementos são inseridos automaticamente nos locais definidos após a conclusão da ação do participante, eliminando a necessidade de escolher manualmente onde assinar.

O posicionamento pode ser configurado tanto durante a criação do documento (CreateDocument) quanto posteriormente através da mutation UpdateDocument.

Exemplo:

{
  "signers": [{
    "email": "troque-esse-email-que-e-publico@example.com",
    "action": "SIGN",
    "positions": [{
      "x": "5.0",
      "y": "90.0",
      "z": 1,
      "element": "SIGNATURE"
    }]
  }]
}

Cada item da lista positions representa um elemento que será exibido no documento.

Campo
Descrição

x

Posição horizontal do elemento, em percentual da largura da página.

y

Posição vertical do elemento, em percentual da altura da página.

z

Página onde o elemento será exibido.

element

Tipo de elemento que será inserido.

Os tipos de elementos disponíveis são:

Elemento
Descrição

SIGNATURE

Assinatura do participante.

INITIALS

Rúbrica do participante.

NAME

Nome completo do participante.

CPF

CPF do participante.

DATE

Data da assinatura.

É possível posicionar múltiplos elementos para o mesmo participante:

Os valores de x e y utilizam coordenadas percentuais, variando de 0 a 100, permitindo que o posicionamento seja proporcional ao tamanho da página.

Importante: quando nenhum posicionamento é informado, o documento continua podendo ser assinado normalmente através da página de assinatura da plataforma, sem a inserção automática de elementos nas páginas do PDF.

Atualizado