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.
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:
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: 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.
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
{
"positions": [
{
"x": "5.0",
"y": "90.0",
"z": 1,
"element": "SIGNATURE"
},
{
"x": "5.0",
"y": "95.0",
"z": 1,
"element": "DATE"
}
]
}