Registrar promoções e reajustes

O salário de um colaborador na TAI não é um campo solto do cadastro: ele é a movimentação salarial vigente. Cada admissão, promoção, reajuste ou transferência é uma movimentação com data de início; a vigente é a que não tem data de fim. Esta jornada leva para a TAI as movimentações decididas no seu sistema (ou na planilha do ciclo de mérito) e lê o histórico para BI e auditoria.

Quando usar	Promoções e reajustes acontecem em outro sistema; o BI precisa do histórico salarial
Porta	REST
Você vai precisar	Módulo PESSOAS; permissão COLABORADOR (edição para gravar, leitura para consultar)

Como funciona

seu sistema ──► GET  /movimentacao-salarial/colaborador/{id}/atual   (a vigente)
seu sistema ──► PUT  /movimentacao-salarial/encerrar/{id}?dataFim=…  (fecha a vigente)
seu sistema ──► POST /movimentacao-salarial                          (abre a nova)
BI          ◄── GET  /movimentacao-salarial/colaborador/{id}/historico

O colaborador tem uma movimentação vigente por vez. Para mudar o salário, encerre a vigente e abra a nova, nessa ordem.

Passo a passo

1. Leia a movimentação vigente do colaborador.

   GET /movimentacao-salarial/colaborador/1043/atual

   Guarde o id, o salarioBase e o tipoMovimentacao. Um colaborador recém-cadastrado pode ainda não ter nenhuma — nesse caso, pule para o passo 3 com ADMISSAO.

2. Encerre a vigente no dia anterior ao início da nova.

   curl -X PUT "https://api.taitecnologia.com/movimentacao-salarial/encerrar/5120?dataFim=2026-10-31" \
     -H "Authorization: Bearer $TAI_TOKEN"

   Uma movimentação já encerrada responde 400.

3. Abra a nova movimentação com a data em que ela passa a valer.

   POST /movimentacao-salarial
   Content-Type: application/json
   
   {
     "colaborador": { "id": 1043 },
     "tipoMovimentacao": "PROMOCAO",
     "salarioBase": 6200.00,
     "dataInicio": "2026-11-01",
     "motivo": "Promoção a Analista de RH Pleno",
     "faixaSalarial": { "id": 88 }
   }

   tipoMovimentacao aceita ADMISSAO, PROMOCAO, AUMENTO, AJUSTE, TRANSFERENCIA, REDUCAO e DEMISSAO. A faixaSalarial é opcional.

4. Se o cargo mudou, atualize o colaborador também — a movimentação registra o salário, não o cargo.

   PATCH /colaborador
   { "id": 1043, "cargo": { "id": 79 } }

Ler o histórico

Pergunta	Chamada
Qual o salário de hoje?	GET /movimentacao-salarial/colaborador/{id}/atual, ou movimentacaoSalarialAtual em GET /colaborador/{id}
Todo o histórico de uma pessoa	GET /movimentacao-salarial/colaborador/{id}/historico
O que começou num intervalo (para o BI)	GET /movimentacao-salarial/periodo?dataInicio=2026-01-01&dataFim=2026-12-31&page=0&size=100
Todas as promoções	GET /movimentacao-salarial/tipo/PROMOCAO

/periodo traz as movimentações que começaram a partir de dataInicio, das mais recentes para as mais antigas, em páginas.

Saber de cada movimentação

Quando promoções e reajustes também são lançados na TAI (pela tela, pela Tali ou por outra integração), o seu sistema fica sabendo por um webhook que assine:

• Um colaborador recebe uma movimentação salarial (MOVIMENTACAO_SALARIAL_CRIADA) — com movimentacaoId, colaboradorId, colaboradorNome, gestorId, tipo e dataInicio;
• Uma movimentação salarial é encerrada (MOVIMENTACAO_SALARIAL_ENCERRADA) — com dataFim no lugar de dataInicio; sai quando a vigente é encerrada à mão ou substituída por uma nova.

{
  "id": "evt_53511",
  "tipo": "MOVIMENTACAO_SALARIAL_CRIADA",
  "descricao": "Um colaborador recebe uma movimentação salarial",
  "versao": 1,
  "ocorridoEm": "2026-10-06T16:02:44.910Z",
  "empresa": { "id": 12, "nome": "Sua Empresa Ltda" },
  "dados": {
    "movimentacaoId": 5121,
    "colaboradorId": 1043,
    "colaboradorNome": "Ana Ribeiro",
    "gestorId": 1544,
    "tipo": "PROMOCAO",
    "dataInicio": "2026-11-01"
  }
}

O valor do salário não vai no evento — dado sensível fica fora de dados. Leia-o em GET /movimentacao-salarial/colaborador/{id}/atual, com a permissão do usuário de integração.

Pelo seu agente de IA

“Qual o salário atual da Ana Ribeiro e quando foi o último reajuste?” é uma leitura que o agente conectado por MCP responde, se a pessoa dona da credencial tem a permissão de colaboradores — o salário é um dado pessoal e segue a mesma regra da tela.

Cuidados

• Encerre antes de abrir. Duas movimentações vigentes para o mesmo colaborador deixam a consulta do salário atual sem resposta certa. Se uma chamada falhar no meio, releia /atual antes de tentar de novo.
• Datas civis em yyyy-MM-dd (datas e formatos): dataInicio é o dia em que o salário passa a valer.
• Idempotência. Guarde, no seu sistema, o id da movimentação criada. Repetir o POST cria outra movimentação igual.
• Reajuste coletivo é uma sequência de chamadas por pessoa, não um lote: espalhe as execuções e respeite os limites.