> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.services-valid.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Marcar a posição da chancela

> Marca onde a chancela de um signatário da assinatura incremental fica em um documento.

Grava a posição da chancela deste signatário neste documento e deixa o signatário em `OPERATOR`. Com `OPERATOR`, o signatário precisa de posição em **todos** os documentos: sem isso, o [`advance`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/post-incremental-advance) para a conferência responde 409. Chamar de novo substitui a posição.

## Parâmetros

**uuid** `string` *required*

UUID da assinatura incremental em rascunho.

**signerUuid** `string` *required*

UUID do signatário.

**fileUuid** `string` *required*

UUID do documento.

**page** `integer` *required*

Página, a partir de 1.

**left** `number` *required*

Distância da borda esquerda, na unidade de `unit`.

**top** `number` *required*

Distância da borda de `origin`, na unidade de `unit`.

**unit** `enum` *required*

`fraction` (0 a 1) e `percent` (0 a 100) são relativas à página. `pt`, `mm`, `cm` e `in` são medidas do papel. `px` é relativa à página desenhada na tela e exige `renderedPageWidth` e `renderedPageHeight`.

**origin** `enum` (default: top-left)

De qual borda o `top` é medido: `top-left` ou `bottom-left`.

**renderedPageWidth** `number`

Largura, em pixels, com que a página foi desenhada. Obrigatória com `unit=px`.

**renderedPageHeight** `number`

Altura, em pixels, com que a página foi desenhada. Obrigatória com `unit=px`.

## Respostas

**signerUuid** `string`

UUID do signatário.

**fileUuid** `string`

UUID do documento.

**currentPage** `integer`

Página gravada, **a partir de 0**.

**positionLeft** `number`

Fração da largura da página, a partir da borda esquerda.

**positionTop** `number`

Fração da altura da página, a partir do topo.

## Erros

Veja [Autenticação e erros](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/erros-e-autenticacao.md).

* **400**: Posição fora da página, página inexistente, ou `px` sem o tamanho desenhado.
* **404**: Rascunho, signatário ou documento não encontrado no seu projeto.
* **409**: A assinatura já foi enviada.

```json theme={"theme":"catppuccin-latte"}
HTTP/1.1 200 OK
Content-Type: application/json

{
  "signerUuid": "6ba7b811-9dad-11d1-80b4-00c04fd430c8",
  "fileUuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "currentPage": 17,
  "positionLeft": 0.1,
  "positionTop": 0.7
}
```

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X PUT "https://api.valid.com/signer/v1/incremental-signatures/550e8400-e29b-41d4-a716-446655440000/signers/6ba7b811-9dad-11d1-80b4-00c04fd430c8/files/6ba7b810-9dad-11d1-80b4-00c04fd430c8/position" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page": 18, "left": 10, "top": 70, "unit": "percent"}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.