> For the complete documentation index, see [llms.txt](https://kb.stoque.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.stoque.com.br/zeev/outras-configuracoes-avancadas/dicionario-de-tokens-de-variaveis/tokens-de-instancias-de-solicitacoes.md).

# 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 %}