Folha de pagamento

A folha da TAI calcula a competência de cada empresa (mensal, adiantamento, férias, rescisão, 13º, PLR), gera holerites, guias, a remessa bancária, os eventos do eSocial e os lançamentos contábeis. O que normalmente se integra com ela: as verbas variáveis que nascem em outro sistema (comissões, prêmios, descontos), o financeiro ou o banco que precisa saber quando a folha foi aprovada e paga, o ERP contábil que recebe os lançamentos e o BI que lê holerites e resumos.

Jornadas

Enviar lançamentos variáveis Comissões, prêmios, descontos e horas avulsas vindos de outro sistema, com a aprovação da competência.

Conduzir o ciclo da competência Abrir, calcular, aprovar e pagar pela API, e avisar o financeiro e o banco a cada etapa.

Levar holerites e relatórios para outro sistema Holerites, resumo gerencial, informe de rendimentos, guias e provisões para o BI ou o arquivo.

Levar a contabilização da folha para o ERP Lote contábil da folha aprovada, conferido e exportado no leiaute do seu ERP.

Acompanhar o eSocial O que a TAI gera e transmite, o retorno do governo e o que consultar pela API.

O que a TAI avisa

Assine estes eventos num webhook ou use-os num fluxo automatizado — o caminho de cada um está em Da TAI para o seu sistema. Os campos listados chegam em dados (e em {{gatilho.<campo>}} nos fluxos automatizados).

Evento	Dados (dados)
A folha é calculada FOLHA_CALCULADA Uma folha foi calculada (pela pessoa ou pela automação da madrugada). Aceita o registro completo.	processamentoIdempresaIdcompetenciatipoholeritesComErro
A folha é aprovada FOLHA_APROVADA Uma folha foi aprovada. Aceita o registro completo.	processamentoIdempresaIdcompetenciatipo
A folha é paga FOLHA_PAGA O pagamento de uma folha foi registrado.	empresaIdcompetencia
Uma folha é aberta FOLHA_PROCESSAMENTO_ABERTO Uma folha (mensal, férias, rescisão, 13º, adiantamento…) foi aberta para a competência. Aceita o registro completo.	processamentoIdempresaIdcompetenciatipo
A folha é encerrada FOLHA_PROCESSAMENTO_FECHADO Uma folha já paga foi encerrada e não muda mais. Aceita o registro completo.	processamentoIdempresaIdcompetenciatipo
Uma folha é cancelada FOLHA_PROCESSAMENTO_CANCELADO Uma folha ainda não aprovada foi cancelada e os lançamentos voltaram para a próxima. Aceita o registro completo.	processamentoIdempresaIdcompetenciatipo
Uma folha é reaberta FOLHA_PROCESSAMENTO_REABERTO Uma folha aprovada voltou para correção antes do pagamento. Aceita o registro completo.	processamentoIdempresaIdcompetenciatipo
Uma rescisão é iniciada RESCISAO_CRIADA O desligamento de um colaborador foi registrado na folha e a rescisão está em elaboração. Aceita o registro completo.	rescisaoIdcolaboradorIdempresaIddataDesligamentomotivoDesligamentodataPagamento
Uma rescisão é paga RESCISAO_PAGA O pagamento do acerto de rescisão (TRCT) foi registrado. Aceita o registro completo.	rescisaoIdcolaboradorIdempresaIddataDesligamentomotivoDesligamentodataPagamento
Uma rescisão é cancelada RESCISAO_CANCELADA Uma rescisão foi cancelada; se nenhuma outra sustenta o desligamento, o colaborador volta a ativo. Aceita o registro completo.	rescisaoIdcolaboradorIdempresaIddataDesligamentomotivoDesligamentodataPagamento
Um lançamento da folha é aprovado LANCAMENTO_FOLHA_APROVADO Um lançamento variável (hora extra, comissão, desconto…) foi aprovado e entra no próximo cálculo. Aceita o registro completo.	lancamentoIdcolaboradorIdrubricaIdcompetencia
Um lançamento da folha é recusado LANCAMENTO_FOLHA_REJEITADO Um lançamento variável foi recusado e não entra na folha. Aceita o registro completo.	lancamentoIdcolaboradorIdrubricaIdcompetencia
Uma guia da folha é paga OBRIGACAO_FOLHA_PAGA O pagamento de uma guia da folha (FGTS, INSS, IRRF, sindical, DAS…) foi registrado.	obrigacaoIdempresaIdcompetenciatipodataVencimentodataPagamentovalorPago
Uma guia da folha é cancelada OBRIGACAO_FOLHA_CANCELADA Uma guia da folha foi cancelada.	obrigacaoIdempresaIdcompetenciatipodataVencimentodataPagamentovalorPago
O arquivo de pagamento é enviado ao banco REMESSA_FOLHA_ENVIADA Uma remessa bancária da folha foi marcada como enviada ao banco. Aceita o registro completo.	remessaIdempresaIdprocessamentoIdstatusdataPagamentoqtdConfirmadosqtdRejeitados
O banco devolve o retorno do pagamento REMESSA_FOLHA_RETORNO_PROCESSADO O arquivo de retorno do banco foi lido: pagamentos confirmados ou rejeitados. Aceita o registro completo.	remessaIdempresaIdprocessamentoIdstatusdataPagamentoqtdConfirmadosqtdRejeitados
Um colaborador volta de afastamento AFASTAMENTO_ENCERRADO Um afastamento foi encerrado com a data real de retorno.	afastamentoIdcolaboradorIddataIniciodataFimReal
O eSocial aceita um envio ESOCIAL_EVENTO_ACEITO O governo aceitou um evento do eSocial (admissão, remuneração, desligamento, tabela…) e devolveu o recibo. Aceita o registro completo.	esocialEventoIdtipoEsocialoperacaoempresaIdperApurloteIdnrRecibo
O eSocial recusa um envio ESOCIAL_EVENTO_RECUSADO O governo recusou um evento do eSocial; ele precisa ser corrigido e enviado de novo. Aceita o registro completo.	esocialEventoIdtipoEsocialoperacaoempresaIdperApurloteIdnrRecibo
Um evento do eSocial falha no esquema oficial ESOCIAL_EVENTO_INVALIDO_ESQUEMA A conferência contra o esquema XSD oficial barrou um evento antes da transmissão; ele fica fora do lote até ser corrigido. Aceita o registro completo.	esocialEventoIdtipoEsocialoperacaoempresaIdperApurloteIdnrRecibo
Um lote é enviado ao eSocial ESOCIAL_LOTE_TRANSMITIDO Um lote de eventos foi transmitido ao eSocial e recebeu protocolo; o retorno chega depois.	loteIdempresaIdgrupoqtdEventosprotocolo
O mês é fechado no eSocial ESOCIAL_COMPETENCIA_FECHADA O fechamento da competência (S-1299) foi gerado e segue para o eSocial.	empresaIdperApurindApuracaoorigem
O mês é reaberto no eSocial ESOCIAL_COMPETENCIA_REABERTA A reabertura da competência (S-1298) foi gerada — pela pessoa ou porque a folha foi reaberta.	empresaIdperApurindApuracaoorigem
Uma rubrica é cadastrada RUBRICA_CADASTRADO Foi cadastrada uma nova rubrica. Aceita o registro completo.	rubricaIdcodigonometipoativo
Uma rubrica é alterada RUBRICA_ALTERADO Uma rubrica foi alterada, ativada ou desativada. Aceita o registro completo.	rubricaIdcodigonometipoativo
Uma rubrica é excluída RUBRICA_EXCLUIDO Uma rubrica foi excluída.	rubricaId

O que a TAI faz sozinha

Rotinas nativas, ligadas e desligadas em Processos › Central de Automações.

Rotina	O que faz	Começa ligada?
folha-automatica	De madrugada, a partir do dia configurado, abre e calcula a folha mensal e a recalcula quando entram variáveis aprovadas. Nunca aprova nem paga	Sim, mas só age na empresa com folhaAutomatica ligado na configuração da folha (desligado por padrão)
folha-guardiao-prazos	Avisa quem processa a folha dos prazos que chegam ou passaram: guias, rescisões, salário do mês, fechamento do eSocial e o 13º	Não
esocial-consulta-retorno	Consulta o retorno dos lotes enviados ao eSocial e marca cada evento como aceito ou recusado	Sim
esocial-aviso-recusa	Manda e-mail aos donos da conta quando o governo recusa um evento, com o que ele apontou	Não
esocial-alerta-certificado	Avisa quando o certificado digital da empresa está perto de vencer	Não

Além das rotinas, a configuração da folha de cada empresa (GET/PUT /folha/config/empresa/{empresaId}) tem chaves que encadeiam etapas — todas desligadas por padrão:

Chave	Efeito
apurarGuiasAoAprovar	Ao aprovar a folha, apura as guias da competência (INSS, FGTS, IRRF)
gerarEsocialAoPagar	Ao pagar a folha, gera os eventos periódicos do eSocial da competência (não transmite)
contabilizarAutomatico	De madrugada, gera os lotes contábeis do mês anterior — um por folha aprovada sem lote e o do financeiro. Não exporta

Dica

GET /folha/mes?empresaId=3&competencia=2026-10 devolve a competência inteira etapa a etapa — variáveis, cálculo, aprovação e pagamento, guias, eSocial, contabilidade —, os cartões das folhas e o que precisa de alguém. É a melhor primeira leitura para um painel externo.

Recursos da API

Referências completas: Folha de pagamento, eSocial e Contabilização.

Rota-base	Para que serve
/folha/lancamento	Lançamentos variáveis da competência, com aprovação
/folha/processamento	O ciclo da folha: abrir, calcular, revisar, aprovar, pagar, fechar
/folha/holerite	Holerites em JSON e PDF, por folha ou por pessoa
/folha/resumo	Resumo gerencial (sintético e analítico) e conciliação de provisões
/folha/obrigacao e /folha/remessa	Guias da competência e a remessa bancária CNAB 240
/folha/rubrica	As verbas da folha, com código e incidências
/esocial/evento e /esocial/lote	Eventos gerados, lotes transmitidos e o retorno do governo
/contabil/lote e /contabil/layout	Lotes contábeis da folha e o leiaute do arquivo para o ERP