Férias e ausências

A TAI controla o direito a férias de cada colaborador pela CLT: o período aquisitivo (12 meses de trabalho que dão direito a 30 dias), o prazo para tirar as férias (os 12 meses seguintes), a programação e a aprovação. Também registra as faltas, que reduzem os dias de direito, e as ausências com substituto, que repassam o trabalho de quem está fora. O que se integra com ele, normalmente, é o portal ou o sistema onde as pessoas pedem férias e a folha de outro sistema, que precisa das datas para pagar.

Solicitar e aprovar férias Programe férias a partir de outro sistema, aprove e avise quem precisa saber.

Levar férias para a folha externa Leia programação, períodos aquisitivos e prazos para a folha de outro sistema.

Faltas e ausências Registre faltas vindas do ponto, recalcule o direito a férias e delegue o trabalho de quem se ausenta.

Nota

Não há uma tela própria de férias na plataforma: as pessoas programam, aprovam e consultam férias pela Tali, na conversa. A API e o servidor MCP usam as mesmas operações.

O que a TAI avisa

Assine estes eventos num webhook ou use-os num fluxo automatizado — veja Da TAI para o seu sistema.

Evento	Dados (dados)
Alguém pede férias FERIAS_SOLICITADAS Um colaborador pediu férias. Aceita o registro completo.	solicitacaoIdcolaboradorIdcolaboradorNomegestorIddataIniciodias
Férias são aprovadas FERIAS_APROVADAS Uma solicitação de férias foi aprovada. Aceita o registro completo.	solicitacaoIdcolaboradorIdcolaboradorNomegestorIddataIniciodias
O prazo para tirar férias está vencendo FERIAS_PRAZO_CONCESSIVO O prazo para o colaborador tirar as férias de um período está perto de vencer (60, 30 ou 15 dias) ou venceu (férias em dobro).	periodoIdcolaboradorIdcolaboradorNomegestorIdsituacaodiasRestantesdataLimitesaldoDias
Uma ausência começa AUSENCIA_INICIADA A ausência de um colaborador começou e o substituto passou a responder por ele. Aceita o registro completo.	ausenciaIdcolaboradorIdcolaboradorNomegestorIdsubstitutoIddataIniciodataFimPrevista
Uma ausência termina AUSENCIA_ENCERRADA A ausência de um colaborador foi encerrada e as tarefas voltaram para ele. Aceita o registro completo.	ausenciaIdcolaboradorIdcolaboradorNomegestorIdsubstitutoIddataFimReal
Férias são canceladas FERIAS_CANCELADAS Férias pedidas ou aprovadas foram canceladas e os dias voltaram para o saldo. Aceita o registro completo.	feriasIdcolaboradorIdcolaboradorNomegestorIddataIniciodiasmotivo
Um colaborador volta das férias FERIAS_RETORNO_REGISTRADO As férias de um colaborador terminaram e o retorno ao trabalho foi registrado. Aceita o registro completo.	feriasIdcolaboradorIdcolaboradorNomegestorIddataRetornoorigem
Um pedido de férias é recusado FERIAS_SOLICITACAO_REPROVADA O gestor ou o RH recusou um pedido de férias. Aceita o registro completo.	solicitacaoIdcolaboradorIdcolaboradorNomegestorIddataIniciodiasreprovadoPorIdmotivo
Um pedido de férias entra para aprovação FERIAS_PEDIDO_CRIADO Um colaborador pediu férias (pela tela Minhas férias, pela Tali ou pelo RH) e o pedido espera quem aprova. Aceita o registro completo.	solicitacaoIdcolaboradorIdcolaboradorNomegestorIddataIniciodataFimdiasdiasAbonoorigem
Um pedido de férias é retirado FERIAS_PEDIDO_CANCELADO O próprio colaborador desistiu de um pedido de férias que ainda esperava aprovação. Aceita o registro completo.	solicitacaoIdcolaboradorIdcolaboradorNomegestorIddataIniciodias
Férias coletivas são confirmadas FERIAS_COLETIVAS_CONFIRMADAS O RH confirmou férias coletivas: cada participante ganhou as suas férias aprovadas (CLT art. 139). Aceita o registro completo.	feriasColetivasIdnomedataIniciodataFimdiasparticipantes
Férias coletivas são canceladas FERIAS_COLETIVAS_CANCELADAS Férias coletivas já confirmadas foram canceladas; as férias de cada participante foram canceladas. Aceita o registro completo.	feriasColetivasIdnomedataIniciomotivo
Um documento de férias é assinado FERIAS_DOCUMENTO_ASSINADO Um documento das férias (aviso, recibo) foi assinado. Aceita o registro completo.	documentoIdferiasIdcolaboradorIdcolaboradorNomegestorIdtipoDocumento

Em Alguém pede férias e Férias são aprovadas, solicitacaoId é o id do registro em /ferias; em Férias são canceladas, Um colaborador volta das férias e Um documento de férias é assinado, o mesmo id vem em feriasId. Já Um pedido de férias é recusado sai dos pedidos em /solicitacao-ferias, e ali solicitacaoId é o id do pedido. O modelo pronto Aviso de férias aprovadas avisa o colaborador e o gestor, sem integração.

O que a TAI faz sozinha

Rotina	O que faz	Começa ligada?
Guardião de férias (ferias-guardiao)	Todo dia de manhã e no cadastro do colaborador: gera os períodos aquisitivos a partir da admissão, avisa o gestor e os donos da conta 60, 30 e 15 dias antes do prazo (e publica Prazo de férias vencendo), marca os períodos vencidos e atualiza o status das férias programadas. Nunca concede férias	Não

A rotina se liga em Processos › Central de Automações › Rotinas dos módulos. Com ela desligada, os períodos aquisitivos são criados pela API e o status das férias não muda sozinho.

Recursos da API

Rota-base	Para que serve	Referência
/ferias	Programar, aprovar, cancelar e consultar férias	Férias e ausências
/periodo-aquisitivo	Períodos aquisitivos, saldo de dias, prazos e vencidos	Colaboradores
/falta	Faltas justificadas e injustificadas	Férias e ausências
/colaborador-ausencia	Ausências com substituto, que repassam os cards de processo	Colaboradores
/documento-ferias	Documentos das férias (aviso, recibo)	Férias e ausências