# Tokens de instâncias de solicitações

## Instância da solicitação

Os tokens de instância de solicitação trazem informações sobre a solicitação em execução no momento.  Eles podem ser usados em:

* [Configuração de eventos de e-mail / mensagem](/zeev/como-construir-processos/como-desenhar-processos/como-usar-eventos/como-configurar-eventos-de-mensagens.md)
* [Configuração de caixa de entrada](/zeev/como-construir-processos/como-validar-aplicativos-antes-de-publica-los/o-que-e-a-caixa-de-entrada-e-como-configurar.md)
* [Integrações](/zeev/integracoes/como-criar-integracoes.md), desde que estejam rodando dentro da instância de solicitação

{% hint style="info" %}
Os tokens de instâncias de solicitações **não funcionam corretamente se forem usados como valor padrão em um campo no Evento de Início do aplicativo**. Isso ocorre porque, nesse estágio, o aplicativo está apenas sendo iniciado, e a solicitação **ainda não foi registrada no banco de dados**. Como a solicitação ainda não existe, os tokens não conseguem exibir informações, pois **esses dados ainda não foram gerados**. Apenas após a criação da solicitação (quando a instância é efetivamente registrada no sistema), os tokens conseguem acessar e exibir as informações corretamente.

Para utilizar os tokens de instâncias de forma eficiente, **é recomendável fazê-lo em eventos subsequentes ao início do aplicativo**, onde a solicitação já estará criada e as informações estarão disponíveis para uso.
{% endhint %}

#### A instância de uma solicitação é uma execução única. Por exemplo, Solicitação "Pedido de compras" realizada em 31/12, por John Doe, de número 1234".

<table data-header-hidden><thead><tr><th width="263.3333333333333">Token</th><th>Descrição</th><th>Exemplo de valor</th></tr></thead><tbody><tr><td>Token</td><td>Descrição</td><td>Exemplo de valor</td></tr><tr><td><strong>{Instance.FlowId}</strong></td><td>Código identificador único do aplicativo de processo</td><td>1234</td></tr><tr><td><strong>{Instance.Id}</strong></td><td>Código identificador único da solicitação</td><td>5678</td></tr><tr><td><strong>{Instance.UID}</strong></td><td>Guid único de identificação da solicitação</td><td>63f62bb6-c1dc - 48eb-b8d2 -d9315c20d80d</td></tr><tr><td><strong>{Instance.StartDate}</strong></td><td>Data da solicitação</td><td>20/05/2020</td></tr><tr><td><strong>{Instance.StartDateTime}</strong></td><td>Data e hora da solicitação </td><td>20/05/2020 20:55</td></tr><tr><td><strong>{Instance.EndDate}</strong></td><td>Data de finalização</td><td>21/05/2020</td></tr><tr><td><strong>{Instance.EndDateTime}</strong></td><td>Data e hora de finalização </td><td>21/05/2020 20:55</td></tr><tr><td><strong>{Instance.Simulation}</strong></td><td>Indicador se é uma simulação</td><td>S / N</td></tr><tr><td><strong>{Instance.FlowName}</strong></td><td>Nome do aplicativo de processo</td><td>Solicitação de compras</td></tr><tr><td><strong>{Instance.FlowVersion}</strong></td><td>Versão do aplicativo de processo</td><td>2</td></tr><tr><td><strong>{Instance.ConfirmationCode}</strong></td><td>Código de verificação para acesso ao relatório da solicitação</td><td>RF9LX8</td></tr><tr><td><strong>{Instance.LinkReport}</strong></td><td>Link para acesso ao relatório de detalhamento da solicitação</td><td>https://suaempresa....</td></tr><tr><td><strong>{Instance.Team}</strong></td><td>Nome do time do solicitante</td><td>Compras</td></tr><tr><td><strong>{Instance.Position}</strong></td><td>Nome da função do solicitante</td><td>Diretor</td></tr><tr><td><strong>{Instance.Xml}</strong></td><td>Xml do aplicativo de processo</td><td>&#x3C;?xml version="1.0" encoding="ISO-8859-1" ?>&#x3C;workflow>&#x3C;execute...</td></tr><tr><td><strong>{Instance.LastReason}</strong></td><td>A última justificativa de ação preenchida por uma pessoa ao clicar em botão de tarefa humana.</td><td>A solicitação está sendo rejeitada por falta de verba.</td></tr><tr><td><strong>{Instance.InstanceTaskId}</strong></td><td>Código único de identificação da instância da tarefa atual.</td><td>14566</td></tr></tbody></table>

{% hint style="warning" %}
Para que os tokens **`{Instance.Team}`** e **`{Instance.Position}`** funcionem é necessário que a pessoa cadastrada no Zeev possua um time e função vinculado ao seu usuário e que, no controle de acesso ao aplicativo, tenha configurações definidas.
{% endhint %}

{% hint style="danger" %}
ATENÇÃO: ao copiar um token diretamente do manual, a informação é copiada exatamente com os mesmos estilos e configurações do conteúdo copiado. Como, para destacar os tokens, utilizamos o negrito, ao colar esta informação em um editor de texto HTML (como o "Corpo da mensagem" do **Evento de mensagem**), a informação é inserida com o mesmo conteúdo (html) copiado.\
Assim, utilizar **CTRL + C > CTRL + V** deixará o token não funcional.

Por isso temos 2 alternativas:

1. Utilizar o atalho **Ctrl + Shift + V** ao colar os tokens no campo "Corpo da mensagem" ou editores HTML, garantindo que apenas o texto sem formatação seja inserido.
2. Utilizar o **seletor de tokens** disponível no canto superior direito aos campos nos quais os tokens estão disponíveis, facilitando a inserção correta dos tokens.
   {% endhint %}


---

# Agent Instructions: 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:

```
GET https://kb.stoque.com.br/zeev/outras-configuracoes-avancadas/dicionario-de-tokens-de-variaveis/tokens-de-instancias-de-solicitacoes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.