> For the complete documentation index, see [llms.txt](https://docs.autentique.com.br/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autentique.com.br/api/2/mutations/criando-um-documento/posicionamento-de-assinatura.md).

# 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:

```json
{
  "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.

<table><thead><tr><th width="198.16796875">Campo</th><th>Descrição</th></tr></thead><tbody><tr><td>x</td><td>Posição horizontal do elemento, em percentual da largura da página.</td></tr><tr><td>y</td><td>Posição vertical do elemento, em percentual da altura da página.</td></tr><tr><td>z</td><td>Página onde o elemento será exibido.</td></tr><tr><td>angle</td><td>Angulo de rotação do elemento.</td></tr><tr><td>scale</td><td>Escala do elemento.</td></tr><tr><td>element</td><td>Tipo de elemento que será inserido.</td></tr></tbody></table>

Os tipos de elementos disponíveis são:

<table><thead><tr><th width="197.7265625">Elemento</th><th>Descrição</th></tr></thead><tbody><tr><td>SIGNATURE</td><td>Assinatura do participante.</td></tr><tr><td>INITIALS</td><td>Rúbrica do participante.</td></tr><tr><td>NAME</td><td>Nome completo do participante.</td></tr><tr><td>CPF</td><td>CPF do participante.</td></tr><tr><td>DATE</td><td>Data da assinatura.</td></tr></tbody></table>

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

```json
{
  "positions": [
    {
      "x": "5.0",
      "y": "90.0",
      "z": 1,
      "angle": 0,
      "scale": 1.0,
      "element": "SIGNATURE"
    },
    {
      "x": "5.0",
      "y": "95.0",
      "z": 1,
      "angle": 0,
      "scale": 1.0,
      "element": "DATE"
    }
  ]
}
```

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`.

{% hint style="warning" %}
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.
{% endhint %}

{% hint style="info" %}
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.
{% endhint %}