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

# Pré-visualizar template preenchido

> Renderiza o template com valores preenchidos e retorna um PDF sem criar um envelope.

Preenche um template com valores e retorna uma URL para download do PDF resultante **sem criar um envelope**. Útil para pré-visualizar ou para exportar um documento preenchido como standalone.

## Parâmetros

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

<ParamField body="values" type="object">
  Atalho para pré-preencher campos: `{ key: value }`.
</ParamField>

<ParamField body="fieldValues" type="array">
  Fine-grained field filling.

  <Expandable title="Propriedades de fieldValues[]">
    <ParamField body="key" type="string">
      Identificador do campo.
    </ParamField>

    <ParamField body="value" type="string | string[] | boolean" required>
      Valor.
    </ParamField>
  </Expandable>
</ParamField>

## Respostas

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

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

<ResponseField name="downloadUrl" type="string">
  URL assinada para download do PDF preenchido. Válida por 15 minutos.
</ResponseField>

<ResponseField name="downloadUrlExpiresAt" type="string">
  Timestamp de expiração.
</ResponseField>

## Erros

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

* **400**: Campo desconhecido ou valor inválido.
* **401**: API key inválido.
* **404**: Template não encontrado.

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

  {
    "fileUuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "filename": "contrato-preenchido.pdf",
    "downloadUrl": "https://storage.googleapis.com/bucket/fill-550e8400.pdf?X-Goog-Algorithm=...",
    "downloadUrlExpiresAt": "2025-07-27T11:00:00.000Z"
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X POST "https://signer.vcc-service.com/v1/templates/550e8400-e29b-41d4-a716-446655440000/fill" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "values": {
      "nome_cliente": "ACME Inc.",
      "data_criacao": "2025-07-27"
    }
  }'
```

## Casos de uso

* **Pré-visualizar antes de criar envelope**: veja como ficará o PDF antes de enviar para assinatura.
* **Exportar documento preenchido**: gere um PDF com valores preenchidos mas sem assinatura (para arquivos ou impressão).
* **Testes/validação**: verifique que os campos foram posicionados e preenchidos corretamente.

## Relacionado

* [`POST /v1/templates/:uuid/envelopes`](/plataforma/assinatura-digital/api/post-template-envelope) — criar envelope (versão que permite assinatura)
* [`GET /v1/templates/:uuid`](/plataforma/assinatura-digital/api/get-template-by-id) — obter template