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

# Criar novo processo

> Cria um processo de assinatura com arquivos e signatários.

## Body

<ParamField body="title" type="string" required>
  Título do processo de assinatura. **Exemplo**: `Contrato de prestação de
      serviços`
</ParamField>

<ParamField body="code" type="string" required>
  Código único do processo. **Exemplo**: `PRC-001`
</ParamField>

<ParamField body="process_files" type="array" required>
  Lista de arquivos a serem assinados.

  <Expandable title="Propriedades do Arquivo">
    <ParamField body="code" type="string">
      Código do arquivo. **Exemplo**: `ARQ001`
    </ParamField>

    <ParamField body="filename" type="string">
      Nome do arquivo (com extensão). **Exemplo**: `documento.pdf`
    </ParamField>

    <ParamField body="extension" type="string">
      Extensão do arquivo (ex: pdf). **Exemplo**: `pdf`
    </ParamField>

    <ParamField body="mime" type="string">
      Tipo MIME (ex: application/pdf). **Exemplo**: `application/pdf`
    </ParamField>

    <ParamField body="type" type="integer">
      Tipo do arquivo. **Exemplo**: `1`
    </ParamField>

    <ParamField body="content" type="string">
      Conteúdo do arquivo em Base64. **Exemplo**: `base64_pdf_aqui`
    </ParamField>

    <ParamField body="hash" type="string">
      Hash do arquivo. **Exemplo**: `a1b2c3`
    </ParamField>

    <ParamField body="size" type="integer">
      Tamanho em bytes. **Exemplo**: `204800`
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="signers" type="array">
  Lista de signatários do processo.

  <Expandable title="Propriedades do Signatário">
    <ParamField body="code" type="string" required>
      Código do signatário. **Exemplo**: `SIG001`
    </ParamField>

    <ParamField body="name" type="string" required>
      Nome completo. **Exemplo**: `Maria Silva`
    </ParamField>

    <ParamField body="email" type="string" required>
      Endereço de e-mail. **Exemplo**: `maria@dominio.com`
    </ParamField>

    <ParamField body="identifier" type="string">
      CPF ou CNPJ. **Exemplo**: `12345678900`
    </ParamField>

    <ParamField body="restrict" type="boolean">
      Se verdadeiro, restringe o acesso. **Exemplo**: `true`
    </ParamField>

    <ParamField body="phone_country_code" type="string">
      Código do país do telefone. **Exemplo**: `55`
    </ParamField>

    <ParamField body="phone_number" type="string">
      Número de telefone. **Exemplo**: `11999999999`
    </ParamField>

    <ParamField body="birth_date" type="string">
      Data de nascimento (AAAA-MM-DD). **Exemplo**: `1980-01-01`
    </ParamField>

    <ParamField body="qualification" type="string">
      Qualificação (ex: Diretor). **Exemplo**: `Diretora`
    </ParamField>

    <ParamField body="token_type" type="integer">
      Tipo de token. **Exemplo**: `1`
    </ParamField>

    <ParamField body="files" type="array">
      Lista de códigos (code) dos arquivos que este signatário deve assinar.
      **Exemplo**: `["ARQ001"]`
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="options" type="object">
  Opções adicionais de configuração.

  <Expandable title="Opções">
    <ParamField body="auto_init" type="boolean">
      Se true, inicia o processo automaticamente após criar. **Exemplo**: `true`
    </ParamField>

    <ParamField body="send_init_emails" type="boolean">
      Se true, envia e-mails iniciais aos signatários. **Exemplo**: `true`
    </ParamField>

    <ParamField body="url_origin" type="string">
      URL de origem. **Exemplo**: `https://cliente.com.br`
    </ParamField>

    <ParamField body="url_notification" type="string">
      Webhook para notificações de status. **Exemplo**:
      `https://cliente.com.br/webhook`
    </ParamField>

    <ParamField body="period_renotify" type="integer">
      Período para notificar novamente. **Exemplo**: `3`
    </ParamField>

    <ParamField body="max_renotify" type="integer">
      Número de vezes a notificar. **Exemplo**: `5`
    </ParamField>

    <ParamField body="due_date" type="string">
      Data de vencimento do processo. **Exemplo**: `2025-06-01`
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="settings" type="array">
  Lista de configurações (strings). **Exemplo**:
  `["process-validate-token-sign"]`
</ParamField>

## Resposta

<ResponseField name="message" type="string">
  Mensagem de sucesso.
</ResponseField>

<ResponseField name="uuid" type="string">
  UUID do processo criado.
</ResponseField>

<ResponseField name="code" type="string">
  Código do processo.
</ResponseField>

<ResponseField name="signers" type="array">
  Lista de signatários criados.

  <Expandable title="Signatário">
    <ResponseField name="code" type="string">
      Código do signatário.
    </ResponseField>

    <ResponseField name="uuid" type="string">
      UUID do signatário.
    </ResponseField>

    <ResponseField name="url" type="string">
      URL de assinatura.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="files" type="array">
  Lista de arquivos criados.

  <Expandable title="Arquivo">
    <ResponseField name="code" type="string">
      Código do arquivo.
    </ResponseField>

    <ResponseField name="uuid" type="string">
      UUID do arquivo.
    </ResponseField>

    <ResponseField name="filename" type="string">
      Nome do arquivo.
    </ResponseField>

    <ResponseField name="type" type="integer">
      Tipo do arquivo.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 OK theme={"theme":"catppuccin-latte"}
  {
    "message": "Processo de assinatura inserido com sucesso.",
    "uuid": "8e3b2e50-8b9a-4d7a-9b8c-1e2f3a4b5c6d",
    "code": "PRC-2023-001",
    "signers": [
      {
        "code": "SIG-001",
        "uuid": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
        "url": "https://validsigner.com.br/signature/Token/uuid"
      }
    ],
    "files": [
      {
        "code": "DOC-001",
        "uuid": "5e6f7a8b-9c0d-1a2b-3c4d-1e2f3a4b5c6d",
        "filename": "documento.pdf",
        "type": 1
      }
    ]
  }
  ```

  ```json 400 Bad Request theme={"theme":"catppuccin-latte"}
  {
    "message": "The title field is required."
  }
  ```

  ```json 401 Não autenticado theme={"theme":"catppuccin-latte"}
  ```

  ```json 403 Não autorizado theme={"theme":"catppuccin-latte"}
  ```
</ResponseExample>