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

{% 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.autentique.com.br/api/2/mutations/criando-um-documento/posicionamento-de-assinatura.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.