O que é gatilho por etapa em processo administrativo

Gatilho por etapa é uma regra configurada no processo administrativo eletrônico que dispara automaticamente uma ação — emitir uma guia, notificar um setor, chamar outro sistema — no momento exato em que o processo chega a uma etapa definida, sem que um servidor precise lembrar de executá-la. O evento que aciona a ação é a mudança de etapa, não um horário fixo nem uma digitação manual.

Gatilho por etapa na prática

Em um órgão sem gatilho, a conclusão de uma etapa depende de alguém avisar o próximo setor, abrir outro sistema e repetir dados já informados. Com gatilho, a própria passagem do processo para a etapa seguinte é o comando: a aprovação técnica de um pedido pode gerar a guia de cobrança, o despacho de deferimento pode acionar a emissão do documento final, a chegada numa etapa de pagamento pode consultar o sistema financeiro.

Três elementos definem um gatilho: a etapa que o aciona, a ação executada e os dados que a ação leva consigo. Se qualquer um dos três estiver indefinido, o que existe é uma rotina informal, não um gatilho.

Gatilho por etapa × integração em lote

A confusão mais comum é tratar gatilho como sinônimo de integração entre sistemas. Não é. A integração em lote troca dados em horário fixo — por exemplo, uma carga noturna — e cria um intervalo em que o processo já avançou, mas o outro sistema ainda não sabe. O gatilho por etapa age no evento: a chamada acontece quando o processo chega ao estágio, e o retorno do outro sistema volta para dentro do mesmo processo.

Para quem decide, a diferença aparece no controle: no lote, a divergência é descoberta depois; no gatilho, a etapa só é considerada cumprida quando a ação associada a ela foi concluída.

Casos de uso comuns

• Emissão de guia ou boleto de taxa quando o processo chega à etapa de cobrança — veja como integrar o processo eletrônico ao sistema financeiro para emissão de guias.
• Geração da taxa a partir da aprovação técnica ou do deferimento — veja como automatizar a emissão de taxa a partir da etapa do processo.
• Liberação da etapa seguinte somente após a confirmação de pagamento — veja como condicionar o protocolo ao pagamento prévio de taxa.
• Criação do registro no repositório documental ao encerrar o processo, quando o órgão mantém outro sistema como arquivo final.
• Encaminhamento automático para a caixa do setor responsável quando o processo entra em determinada fase.

O que a legislação diz

Não existe norma que obrigue o uso de gatilhos em si. O que há é a diretriz de digitalização e interoperabilidade entre sistemas públicos da Lei do Governo Digital (Lei nº 14.129/2021), que sustenta a eliminação de retrabalho e de redigitação entre bases. A escolha de quais etapas terão gatilho, e de quais ações eles executam, é decisão de gestão e deve respeitar a legislação municipal que define taxas, prazos e competências.

Como o Aprova aplica o gatilho por etapa

• A chegada a uma etapa do processo eletrônico pode acionar, por API, a emissão de guia no sistema financeiro do município, com os dados do requerente já preenchidos.
• O status de pagamento volta ao processo, o que permite bloquear a etapa seguinte até a confirmação.
• A integração com o SEI gera o registro correspondente ao final do processo, mantendo o repositório documental do órgão.
• Cada etapa concluída fica registrada no histórico do processo, com data e responsável, como descrito em esteira processual no Aprova.

FAQ sobre gatilho por etapa

Gatilho por etapa exige sistema financeiro integrado?

Não necessariamente. O gatilho pode executar ações internas, como encaminhar o processo a uma caixa de entrada ou notificar um setor. A integração com sistema financeiro é apenas um dos usos, o mais frequente em cobrança de taxas.

Qual a diferença entre gatilho e prazo automático?

O prazo automático é disparado pelo tempo: o processo ficou parado por X dias. O gatilho é disparado por um evento do fluxo: o processo chegou a uma etapa. Os dois podem coexistir na mesma esteira.

O que acontece se a ação do gatilho falhar?

Depende da parametrização. O desenho recomendado é manter o processo na etapa até que a ação seja concluída, com o erro visível para a equipe, em vez de avançar e deixar a pendência escondida em outro sistema.

Dá para usar gatilho em órgãos que ainda mantêm sistemas legados?

Sim. Se o sistema legado expõe uma API, ele pode ser chamado pelo gatilho sem ser substituído. Esse é justamente o cenário em que o gatilho evita a troca total de sistemas.

Quem define em quais etapas o gatilho atua?

A área responsável pelo processo, em conjunto com a tecnologia. O gatilho deve refletir o rito processual já definido, não criar um rito paralelo.

Conclusão

Gatilho por etapa transforma a mudança de etapa em evento de gestão: o que antes dependia de lembrança e de redigitação passa a acontecer no momento certo, com registro. Para ver como isso funciona em processos de arrecadação, licenciamento e comunicação oficial, agende uma demonstração da Aprova.