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

# Avançar no fluxo do assistente

> Move o envelope para o próximo passo. Valida se todos os requisitos foram atendidos.

Avança o envelope para o próximo passo do assistente. A operação valida os requisitos (ex.: "tem documento?" antes de avançar do passo 1) e retorna erro 409 se não puder avançar, indicando o motivo.

**Autenticação**: `x-api-key` no header. Também aceita `Authorization: Bearer`.

## Parâmetros

<ParamField path="uuid" type="string" required>
  UUID do envelope rascunho.
</ParamField>

## Respostas

Retorna o objeto `EnvelopeDraftResponse` com o novo estado.

## Erros

Veja [Autenticação e erros](/plataforma/assinatura-digital/api/erros-e-autenticacao).

* **404**: Envelope não encontrado ou não pertence ao seu projeto.
* **409**: Não pode avançar. Ex.: "Passo 1→3 exige documento" ou "Passo 3→5 exige signatário".

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

  {
    "envelopeUuid": "550e8400-e29b-41d4-a716-446655440000",
    "stateId": 3,
    "state": "Inserir signatários",
    "title": "Contrato..."
  }
  ```

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

  {
    "statusCode": 409,
    "message": "Advance to signers step requires at least one document"
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X POST "https://api.valid.com/signer/v1/envelopes/550e8400-e29b-41d4-a716-446655440000/advance" \
  -H "x-api-key: YOUR_API_KEY"
```

## Fluxo de passos

* **Passo 1 (Enviar arquivos)** → Passo 3 (Inserir signatários): exige mín. 1 documento anexado.
* **Passo 3 (Inserir signatários)** → Passo 5 (Conferência): exige mín. 1 signatário.
* **Passo 5 (Conferência)** → Passo 6 (Aguardando assinatura): chame [`POST .../send`](/plataforma/assinatura-digital/api/post-envelope-send) em vez disto.

## Relacionado

* [`POST .../:uuid/back`](/plataforma/assinatura-digital/api/post-envelope-back) — voltar um passo
* [`POST .../:uuid/send`](/plataforma/assinatura-digital/api/post-envelope-send) — enviar (passo final)


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