Pessoas

O módulo Pessoas guarda quem trabalha na empresa e onde cada pessoa está: o cadastro do colaborador, a estrutura organizacional (setor, departamento, time, cargo, centro de custo), o histórico salarial e o desligamento. É o cadastro que quase toda integração toca primeiro — o ERP ou a folha de outro sistema manda as pessoas, e o BI, o sistema de acessos e o service desk querem saber quem entrou e quem saiu.

Usuário de integração Crie o usuário que o seu sistema usa para chamar a API, com o mínimo de permissões.

Sincronizar colaboradores Carga inicial, atualização incremental e conciliação com o ERP ou a folha externa.

Estrutura organizacional Espelhe o organograma de outro sistema ou leve-o para o BI, com os gestores de cada unidade.

Movimentações e salário Registre promoções e reajustes e leia o histórico salarial.

Desligamento Desligue pela API, agende a data e avise o sistema de acessos.

Contas para quem chega Abra e-mail, contas e crachá no seu sistema quando um colaborador é cadastrado.

Saúde e segurança Registre incidentes vindos de outro sistema e acompanhe o prazo da CAT.

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.

Evento	Dados (dados)
Um colaborador é cadastrado COLABORADOR_CRIADO Um colaborador novo foi cadastrado. Aceita o registro completo.	colaboradorIdcolaboradorNomegestorId
Um colaborador é desligado COLABORADOR_DESLIGADO Um colaborador foi desligado (o desligamento ficou efetivo). Aceita o registro completo.	colaboradorIdcolaboradorNomegestorIddataDesligamento
A ficha de um colaborador é alterada COLABORADOR_ALTERADO Os dados cadastrais de um colaborador foram editados (ficha, contatos ou time). Aceita o registro completo.	colaboradorIdcolaboradorNomegestorIdorigem
Um colaborador recebe uma movimentação salarial MOVIMENTACAO_SALARIAL_CRIADA Foi registrada uma movimentação salarial (promoção, mérito, reajuste…) para um colaborador.	movimentacaoIdcolaboradorIdcolaboradorNomegestorIdtipodataInicio
Uma movimentação salarial é encerrada MOVIMENTACAO_SALARIAL_ENCERRADA A vigência de uma movimentação salarial terminou (encerrada à mão ou substituída por uma nova).	movimentacaoIdcolaboradorIdcolaboradorNomegestorIdtipodataFim
Um colaborador muda de cargo COLABORADOR_MUDOU_DE_CARGO O cargo de um colaborador mudou (promoção, transferência, reenquadramento ou correção do cadastro). Aceita o registro completo.	colaboradorIdcolaboradorNomegestorIdcargoAnteriorIdcargoIdtipoorigemdataInicio
Uma trilha de carreira é criada ou revista TRILHA_CARREIRA_DEFINIDA O RH criou ou revisou uma trilha de carreira (os cargos em ordem e o que se pede para subir). Aceita o registro completo.	trilhaIdnometipoacaocargos
A empresa muda o que o colaborador vê da faixa salarial CARREIRA_FAIXA_VISIVEL_DEFINIDA O RH mudou o que aparece da faixa salarial em Minha carreira (nada, a do cargo atual ou também a dos próximos passos).	antesdepois
Uma ação de equidade salarial é registrada EQUIDADE_ACAO_REGISTRADA A empresa registrou uma ação do plano de equidade salarial entre mulheres e homens (Lei 14.611).	acaoIdempresaIdgrupoacaoresponsavelIdprazo
Uma ação de equidade salarial é concluída EQUIDADE_ACAO_CONCLUIDA Uma ação do plano de equidade salarial foi concluída, com o registro do que foi feito.	acaoIdempresaIdgrupoacaoobservacao
Um colaborador pede para atualizar o próprio cadastro ATUALIZACAO_CADASTRAL_SOLICITADA Um colaborador pediu para mudar dados do próprio cadastro em campos que exigem aprovação do RH. O valor pedido não vai no evento.	atualizacaoIdcolaboradorIdcolaboradorNomecamposexigeComprovante
Uma atualização cadastral é aprovada ATUALIZACAO_CADASTRAL_APROVADA O RH aprovou o pedido de atualização cadastral e o cadastro do colaborador foi alterado.	atualizacaoIdcolaboradorIdcolaboradorNomecampos
Uma atualização cadastral é recusada ATUALIZACAO_CADASTRAL_RECUSADA O RH recusou o pedido de atualização cadastral, com o motivo que a pessoa recebe.	atualizacaoIdcolaboradorIdcolaboradorNomecamposmotivo
A empresa muda o que o colaborador pode atualizar no próprio cadastro ATUALIZACAO_CADASTRAL_REGRAS_DEFINIDAS O RH mudou, campo a campo, se o colaborador não altera, altera direto ou pede aprovação (com ou sem comprovante).	campos
Uma campanha de recadastramento é aberta RECADASTRAMENTO_ABERTO O RH abriu uma campanha pedindo que os colaboradores confiram e atualizem o cadastro até um prazo.	campanhaIdtituloprazopublico
Uma campanha de recadastramento é encerrada RECADASTRAMENTO_ENCERRADO O RH encerrou a campanha de recadastramento.	campanhaIdtituloconfirmadospendentes
Um colaborador confere o cadastro na campanha de recadastramento CADASTRO_CONFIRMADO_NA_CAMPANHA O colaborador confirmou que os dados estão certos ou pediu alteração durante a campanha de recadastramento.	campanhaIdcolaboradorIdcolaboradorNomecomAlteracao
Um holerite importado é publicado para o colaborador HOLERITE_IMPORTADO_PUBLICADO O RH publicou o holerite de uma pessoa, vindo da folha feita em outro sistema. O valor não vai no evento.	holeriteIdcolaboradorIdcolaboradorNomecompetenciatipo
Um holerite importado é retirado HOLERITE_IMPORTADO_RETIRADO O RH tirou do ar um holerite importado já publicado (pessoa ou arquivo errado), com o motivo.	holeriteIdcolaboradorIdcolaboradorNomecompetenciatipomotivo
O colaborador dá ciência do holerite HOLERITE_IMPORTADO_CIENTE O colaborador confirmou que recebeu e viu o holerite importado.	holeriteIdcolaboradorIdcolaboradorNomecompetenciatipo
Um comunicado é publicado COMUNICADO_PUBLICADO Um comunicado interno foi publicado para o público escolhido. Aceita o registro completo.	comunicadoIdtitulodestinatariosexigeCiente
Alguém confirma a leitura de um comunicado COMUNICADO_CIENTE Uma pessoa deu ciente num comunicado que exige confirmação de leitura. Aceita o registro completo.	comunicadoIdcolaboradorIdtitulo
Uma parcela de PLR, prêmio ou bônus é fechada INCENTIVO_PARCELA_FECHADA A antecipação ou a parcela final de um programa de incentivo foi fechada: a memória de cálculo de cada pessoa ficou congelada. Aceita o registro completo.	programaIdprogramatipoparcelacompetenciaparticipantesvalorTotal
Os valores de um programa de incentivo vão para a folha INCENTIVO_LANCADO_NA_FOLHA Os valores de uma parcela fechada viraram lançamentos da folha na competência de pagamento. Aceita o registro completo.	programaIdprogramacompetencialancamentosforaDaFolha
Um contrato de experiência começa EXPERIENCIA_INICIADA O acompanhamento do contrato de experiência de uma pessoa foi iniciado. Aceita o registro completo.	contratoIdcolaboradorIdmodalidadefimPrimeiroPeriodo
A avaliação de experiência é concluída EXPERIENCIA_AVALIADA O gestor concluiu a avaliação de um período da experiência com o parecer. Aceita o registro completo.	contratoIdcolaboradorIdpareceretapa
Um plano de integração começa ONBOARDING_INICIADO O plano de onboarding de uma pessoa foi criado (na admissão ou à mão). Aceita o registro completo.	planoIdcolaboradorIdmodeloId
Um plano de integração é concluído ONBOARDING_CONCLUIDO Todas as tarefas do plano de onboarding de uma pessoa foram concluídas. Aceita o registro completo.	planoIdcolaboradorId
Os indicadores de pessoas de um mês são fechados PEOPLE_ANALYTICS_MES_FECHADO O People Analytics congelou os números de um mês (headcount, turnover, absenteísmo, 1:1, PDI, eNPS). Aceita o registro completo.	competenciaheadcountdesligamentos
Um incidente de trabalho é registrado INCIDENTE_REGISTRADO Um acidente, quase acidente ou doença ocupacional foi registrado em Saúde e Segurança. Aceita o registro completo.	incidenteIdcolaboradorIddataOcorrenciacatEmitida
Uma CAT é registrada INCIDENTE_CAT_EMITIDA A emissão da CAT (Comunicação de Acidente de Trabalho) de um incidente foi registrada. Aceita o registro completo.	incidenteIdcolaboradorIdnumeroCatdataCat
Os riscos psicossociais são registrados no inventário RISCOS_PSICOSSOCIAIS_REGISTRADOS O resultado da avaliação psicossocial (NR-01) foi levado ao inventário de riscos do PGR. Aceita o registro completo.	gruposriscosCriadosriscosAtualizadosrespondentes
Uma ação é incluída no plano de ação de um risco ACAO_RISCO_CRIADA Uma ação com responsável e prazo foi incluída no plano de ação de um risco do inventário. Aceita o registro completo.	acaoIdriscoIdriscoresponsavelIdprazo
Um exame ocupacional (ASO) é registrado EXAME_OCUPACIONAL_REGISTRADO O ASO de um exame ocupacional da NR-7 foi registrado. O resultado não vai no evento. Aceita o registro completo.	exameIdcolaboradorIdtipodataAsoproximoExame
Uma ação do plano de ação de um risco é concluída ACAO_RISCO_CONCLUIDA Uma ação do plano de ação de um risco foi concluída, com a evidência do que foi feito. Aceita o registro completo.	acaoIdriscoIdriscoresponsavelId
Uma empresa é cadastrada EMPRESA_CADASTRADO Foi cadastrada uma nova empresa. Aceita o registro completo.	empresaIdnomerazaoSocialcnpjtipoEstabelecimentomatriz_idativo
Uma empresa é alterada EMPRESA_ALTERADO Uma empresa foi alterada, ativada ou desativada. Aceita o registro completo.	empresaIdnomerazaoSocialcnpjtipoEstabelecimentomatriz_idativo
Uma empresa é excluída EMPRESA_EXCLUIDO Uma empresa foi excluída.	empresaId
Um cargo é cadastrado CARGO_CADASTRADO Foi cadastrado um novo cargo. Aceita o registro completo.	cargoIdnomecodigodepartamento_idativo
Um cargo é alterado CARGO_ALTERADO Um cargo foi alterado, ativado ou desativado. Aceita o registro completo.	cargoIdnomecodigodepartamento_idativo
Um cargo é excluído CARGO_EXCLUIDO Um cargo foi excluído.	cargoId
Um centro de custo é cadastrado CENTRO_CUSTO_CADASTRADO Foi cadastrado um novo centro de custo. Aceita o registro completo.	centroCustoIdnomecodigoempresa_idcolaborador_idativo
Um centro de custo é alterado CENTRO_CUSTO_ALTERADO Um centro de custo foi alterado, ativado ou desativado. Aceita o registro completo.	centroCustoIdnomecodigoempresa_idcolaborador_idativo
Um centro de custo é excluído CENTRO_CUSTO_EXCLUIDO Um centro de custo foi excluído.	centroCustoId
Um departamento é cadastrado DEPARTAMENTO_CADASTRADO Foi cadastrado um novo departamento. Aceita o registro completo.	departamentoIdnomeativo
Um departamento é alterado DEPARTAMENTO_ALTERADO Um departamento foi alterado, ativado ou desativado. Aceita o registro completo.	departamentoIdnomeativo
Um departamento é excluído DEPARTAMENTO_EXCLUIDO Um departamento foi excluído.	departamentoId
Um padrão de admissão TOTVS é cadastrado PADRAO_ADMISSAO_TOTVS_CADASTRADO Foi cadastrado um novo padrão de admissão TOTVS. Aceita o registro completo.	padraoAdmissaoTotvsIddescricaotipoFuncionarioprefixoSecaoativo
Um padrão de admissão TOTVS é alterado PADRAO_ADMISSAO_TOTVS_ALTERADO Um padrão de admissão TOTVS foi alterado, ativado ou desativado. Aceita o registro completo.	padraoAdmissaoTotvsIddescricaotipoFuncionarioprefixoSecaoativo
Um padrão de admissão TOTVS é excluído PADRAO_ADMISSAO_TOTVS_EXCLUIDO Um padrão de admissão TOTVS foi excluído.	padraoAdmissaoTotvsId
Um código de tabela auxiliar do TOTVS é cadastrado TABELA_AUXILIAR_TOTVS_CADASTRADO Foi cadastrado um novo código de tabela auxiliar do TOTVS. Aceita o registro completo.	tabelaAuxiliarTotvsIdtabelacodigodescricaoativo
Um código de tabela auxiliar do TOTVS é alterado TABELA_AUXILIAR_TOTVS_ALTERADO Um código de tabela auxiliar do TOTVS foi alterado, ativado ou desativado. Aceita o registro completo.	tabelaAuxiliarTotvsIdtabelacodigodescricaoativo
Um código de tabela auxiliar do TOTVS é excluído TABELA_AUXILIAR_TOTVS_EXCLUIDO Um código de tabela auxiliar do TOTVS foi excluído.	tabelaAuxiliarTotvsId

gestorId é o colaborador responsável mais próximo na estrutura: o do time, senão o do departamento, senão o do setor. Veja Estrutura organizacional. Colaborador cadastrado sai em todo cadastro — pela tela, pela API, por planilha, pela admissão ou pela contratação de um candidato; Colaborador desligado, quando o desligamento fica efetivo (na hora ou na data agendada).

O que a TAI faz sozinha

Rotina	O que faz	Começa ligada?
Desligamentos agendados (rh-processar-desligamentos)	Todo dia, efetiva os desligamentos cuja data chegou — e aí sai o evento Colaborador desligado	Sim
Prazo da CAT (sst-prazo-cat)	A cada hora, avisa os donos da conta por e-mail quando um acidente precisa de CAT e de novo se o prazo vencer. Nunca emite a CAT	Não

As rotinas se ligam e desligam em Processos › Central de Automações, em Rotinas dos módulos.

Nota

Férias, períodos aquisitivos, faltas e ausências com substituto têm guia próprio: Férias e ausências.

Recursos da API

Rota-base	Para que serve	Referência
/colaborador	Cadastro do colaborador; desligar e reverter; desligados em /colaborador/desligados/page	Colaboradores
/movimentacao-salarial	Histórico salarial: salário vigente, promoções, reajustes	Colaboradores
/setor, /departamento, /sub-departamento	Os três níveis da estrutura, cada um com o seu responsável	Estrutura organizacional
/cargo, /faixa-salarial	Cargos (com CBO e nível) e as faixas salariais de cada cargo	Estrutura organizacional
/centro-custo	Centros de custo por empresa	Estrutura organizacional
/empresa	Estabelecimentos (CNPJs) da conta	Empresas e usuários
/perfil-acesso	Perfis de acesso e quem tem cada um	Permissões
/incidentes, /riscos	Incidentes de trabalho (com CAT) e inventário de riscos da NR-01	Saúde e segurança