Lista de Instâncias
/process-instances — histórico completo de todas as instâncias (ativas e terminadas).
Contadores de estado: total, a correr, canceladas e concluídas.
Colunas da tabela:
| Coluna | Descrição |
|---|---|
| Processo | Nome e chave do processo |
| Business Key | Identificador de negócio da instância (ex: número do pedido) |
| Iniciado Por | Utilizador ou serviço que iniciou a instância |
| Versão | Versão do processo em execução |
| Iniciado Em | Data/hora de início |
| Duração | Tempo decorrido desde o início (instâncias ativas) ou total (concluídas) |
| Estado | A correr, suspenso, cancelado, concluído |
Filtros: estado, processo, versão, intervalo de datas de início.

Detalhe da Instância
/process-instances/[id] — página completa de inspeção de uma instância específica.
Cabeçalho: nome do processo (título), número de negócio da instância (process.number, subtítulo), badge de estado.
Cards de resumo
Quatro métricas no topo da página:
| Card | Ícone | O que mostra |
|---|---|---|
| Business Key | GitBranch | Identificador único da instância (número do processo) |
| Iniciado Por | User | Utilizador ou serviço que iniciou a instância |
| Iniciado em | Calendar | Data/hora de início + duração relativa (ex: "há 3 dias") |
| Duração | Clock | Tempo total desde o início; se concluída, mostra também a data de fim (endedAt) |
Tabs de detalhe
Mostra a sequência cronológica de todos os eventos da instância: início do processo, entradas e saídas de tarefas, passagens por gateways, erros e fim.
- N eventos registados (contador no cabeçalho da tab)
- Cada linha: tipo de evento, nome do elemento BPMN, data/hora
- Útil para perceber o caminho percorrido no diagrama e o tempo gasto em cada atividade

Depuração com variáveis
O separador Variáveis mostra o estado atual em tempo real. Usa-o para perceber porque é que um gateway escolheu um caminho específico ou para verificar dados recebidos de um delegate.
Iniciar uma instância via API
Além da interface, qualquer serviço pode iniciar (criar e arrancar) uma instância com um token M2M:
POST /process-instances
Authorization: Bearer <m2m-token>
Content-Type: application/json
{
"processKey": "registo-entidade",
"applicationBase": "registos",
"businessKey": "REG-EXT-0001",
"priority": 1,
"variables": [
{ "name": "nomeEntidade", "value": "Exemplo, Lda." },
{ "name": "nif", "value": "123456789" }
]
}Os caminhos são relativos à rota do gateway do process-management-api (http://<slug>:2575/gateway-api/<serviço>-process-management-api, sem /api/v1). processKey e applicationBase são obrigatórios; as variáveis vão como lista name/value. Para criar a instância sem a arrancar usa POST /process-instances/create e depois POST /process-instances/{id}/start.
O m2m-token é um JWT client_credentials obtido do Access Management. Ver API M2M para o fluxo completo.
Última atualização:
