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,
"angle": 0,
"scale": 1.0,
"element": "SIGNATURE"
}]
}]
}Cada item da lista positions representa um elemento que será exibido no documento.
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.
angle
Angulo de rotação do elemento.
scale
Escala do elemento.
element
Tipo de elemento que será inserido.
Os tipos de elementos disponíveis sã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.
O valor de angle representa a rotação do elemento, em graus, variando de 0 a 360.
O valor de scale representa um multiplicador da escala do elemento, sendo 1.0 a escala padrão, com mínimo de 0.5 e maximo de 4.0.
Importante: apenas o criador do documento ou a integração responsável pelo documento podem definir ou alterar posicionamentos. Os participantes não podem mover, editar ou escolher a localização dos elementos configurados.
Atualizado