Registrar ausências e correções de ponto

O atestado chega pelo sistema de saúde ocupacional, a licença é registrada no portal de RH, a portaria anota quem saiu sem bater. Esta jornada leva essas ocorrências para o ponto da TAI em nome de cada pessoa: a ausência justificada (abono) e a correção de batida entram na fila de aprovação, e o dia é recalculado quando o pedido é aprovado.


Quando usar	Ausências e correções nascem em outro sistema e precisam refletir no espelho de ponto antes do fechamento
Porta	REST · Webhook · Agente (MCP)
Você vai precisar	Módulo `PONTO`; permissão `PONTO_TRATAR` com nível de edição para registrar em nome de outra pessoa e para aprovar; `PONTO` para recalcular e ajustar o banco de horas; usuário de integração com token JWT

Como funciona

seu sistema ──► POST /ponto/abono  (ou /ponto/solicitacao-ajuste)
                   colaborador = a pessoa, não o usuário de integração
                        │
                        ▼
           pedido PENDENTE (ou AGUARDANDO_DOCUMENTO) ─► e-mail ao gestor
                        │
          aprovação: gestor na tela, Tali, ou PUT …/aprovar pela API
                        │
                        ▼
           dia recalculado ─► espelho, banco de horas e fechamento do mês

As marcações originais do relógio nunca são alteradas: uma correção acrescenta uma batida tratada ou pede que uma original seja desconsiderada, e o AEJ declara as duas.

Passo a passo

Descubra os tipos de ausência. Cada empresa tem os seus motivos (atestado, falecimento, casamento, folga do banco…):
Terminal window
```
curl https://api.taitecnologia.com/ponto/tipo-abono \
  -H "Authorization: Bearer $TAI_TOKEN"
```
Guarde o id de cada tipo e repare em exigeDocumento (o pedido só vai ao gestor com o comprovante anexado), limiteDiasPorAno e compensaBanco (folga descontada do banco de horas).
Registre a ausência em nome da pessoa. Informe o colaborador no corpo — sem ele, o pedido seria do próprio usuário de integração:
Terminal window
```
curl -X POST https://api.taitecnologia.com/ponto/abono \
  -H "Authorization: Bearer $TAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "colaborador": { "id": 812 },
    "tipoAbonoId": 4,
    "dataInicio": "2026-10-06",
    "dataFim": "2026-10-08",
    "justificativa": "Atestado médico recebido pelo SESMT"
  }'
```
A resposta traz o id e o status: PENDENTE (foi para a fila do gestor) ou AGUARDANDO_DOCUMENTO (o tipo exige comprovante). Para ausência de parte do dia, envie "parcial": true com horaInicio e horaFim em HH:mm — vale para um único dia.
Anexe o comprovante, quando o tipo exigir. PDF, JPG ou PNG de até 10 MB, em multipart/form-data:
Terminal window
```
curl -X POST https://api.taitecnologia.com/ponto/abono/1530/documento \
  -H "Authorization: Bearer $TAI_TOKEN" \
  -F "arquivo=@atestado.pdf"
```
Com o anexo, o pedido passa a PENDENTE e o gestor é avisado.
Registre uma correção de batida, quando for o caso. Cada item da correção inclui uma batida esquecida ou desconsidera uma batida original:
- Incluir batida esquecida
- Desconsiderar batida
POST /ponto/solicitacao-ajuste { "colaborador": { "id": 812 }, "dataMarcacao": "2026-10-06", "justificativa": "Saída registrada na portaria às 18:02", "itens": [ { "tipo": "INCLUSAO", "dataHoraProposta": "2026-10-06T18:02:00-03:00" } ] }
POST /ponto/solicitacao-ajuste { "colaborador": { "id": 812 }, "dataMarcacao": "2026-10-06", "justificativa": "Batida em duplicidade", "itens": [ { "tipo": "DESCONSIDERACAO", "marcacaoOriginalId": 99120 } ] }
O marcacaoOriginalId vem de GET /ponto/marcacao?colaboradorId=812&dataInicio=2026-10-06&dataFim=2026-10-06 e precisa ser uma batida da mesma pessoa.
A correção nasce PENDENTE — ou já APROVADA, com o dia recalculado, quando a conta tem a aprovação automática das correções simples ligada e o pedido cabe nela (veja Automatize).
Aprove ou rejeite, se a decisão também é do seu sistema. Senão, deixe para o gestor na tela.
```
PUT /ponto/abono/1530/aprovar
PUT /ponto/solicitacao-ajuste/2210/aprovar

PUT /ponto/abono/1530/rejeitar?motivo=Atestado%20ileg%C3%ADvel
```
A aprovação recalcula os dias afetados. As filas do que espera decisão estão em GET /ponto/abono/pendentes e GET /ponto/solicitacao-ajuste/pendentes.

Outros ajustes

Chamada	Quando usar
`POST /ponto/banco-horas/ajuste-manual?colaboradorId=812&minutos=-120&observacao=…`	Creditar (minutos positivos) ou debitar (negativos) o banco de horas, com observação obrigatória que fica no extrato. Exige `PONTO`
`POST /ponto/apuracao/recalcular?colaboradorId=812&dataInicio=2026-10-01&dataFim=2026-10-15`	Refazer a apuração de uma pessoa num período de até 92 dias — por exemplo, depois de mudar a jornada. Dias de mês fechado não são recalculados. Exige `PONTO`
`POST /ponto/abono/{id}/conferir-atestado`	Pedir à IA que confira o atestado anexado (é atestado, o nome e o período batem): devolve `iaConferencia` (`CONFERE`, `DIVERGE`, `ILEGIVEL`, `NAO_LIDO`) e `iaResumo`. Só informa, não aprova; o diagnóstico (CID) não é lido. Exige `PONTO_TRATAR` e a leitura de atestados autorizada pela empresa em Processos › Central de Automações › IA
`GET /ponto/apuracao/inconsistencias?dataInicio=2026-10-01&dataFim=2026-10-31`	Os dias com problema (batida faltando, pessoa sem jornada ou sem regra) — os que travam o fechamento

Automatize

Os avisos já são da TAI: o pedido criado vai por e-mail ao gestor, e a decisão vai a quem pediu. Na tela, o gestor decide em Minha equipe › Ponto da equipe, aba Aprovar.

A conta pode aprovar sozinha as correções simples: com aprovarAjusteAutomatico ligado na configuração do ponto (PUT /ponto/config-tenant, campos margemAjusteMinutos e limiteAjusteAutomaticoMes), a correção que só inclui batidas, cada uma a até a margem do horário da escala, é aprovada na hora — até o limite mensal por pessoa. Desconsiderar uma batida, passar da margem ou do limite leva o pedido ao gestor. Só o dono da conta (ou um administrador) liga ou muda essa política; para os demais, a alteração responde 403.

Devolver a decisão ao seu sistema. Crie um webhook que assine os eventos do pedido que o seu sistema criou:

Pedido	Eventos
Ausência (abono)	`ABONO_PEDIDO`, `ABONO_DOCUMENTO_ANEXADO`, `ABONO_APROVADO`, `ABONO_REJEITADO`, `ABONO_CANCELADO`
Correção de batida	`PONTO_AJUSTE_PEDIDO`, `PONTO_AJUSTE_APROVADO`, `PONTO_AJUSTE_REJEITADO`, `PONTO_AJUSTE_CANCELADO`

A decisão sobre o atestado do passo 2 chega assim:

{
  "id": "evt_57203",
  "tipo": "ABONO_APROVADO",
  "descricao": "Uma justificativa de ausência é aprovada",
  "versao": 1,
  "ocorridoEm": "2026-10-07T11:26:48.355Z",
  "empresa": { "id": 12, "nome": "Sua Empresa Ltda" },
  "dados": {
    "abonoId": 1530,
    "colaboradorId": 812,
    "tipoAbonoId": 4,
    "dataInicio": "2026-10-06",
    "dataFim": "2026-10-08"
  }
}

Case pelo abonoId (ou solicitacaoId, na correção) que você guardou. O motivo da recusa não vem no evento: leia o pedido pela API (motivoRejeicao). A correção aprovada pela política automática também publica Um ajuste de ponto é aprovado. Para quedas mais longas que as novas tentativas, mantenha uma reconciliação que consulte os pedidos ainda abertos pelo id.

Antes do fechamento, a rotina ponto-previa-fechamento avisa os gestores do que ainda trava o mês, e ponto-cobranca-fechamento (desligada por padrão) cobra cada pessoa dos dias pendentes.

Pelo seu agente de IA

“Registre um atestado de 6 a 8 de outubro para a Ana Ribeiro.”

Com escopo de escrita, o agente cria o pedido de ausência — o seu cliente de IA pede sua aprovação antes. Aprovar e rejeitar são de confirmação forte e o agente externo não os executa pelo MCP; o gestor decide na plataforma ou pela Tali. O agente também não anexa arquivo: se o tipo exige documento, o pedido fica aguardando o comprovante. Veja Escrita e segurança.

Cuidados

Alcance do usuário. Registrar em nome de alguém exige PONTO_TRATAR com edição e que a pessoa esteja no alcance do usuário: os liderados pela estrutura, ou todos para o dono da conta e administradores. Fora do alcance, a resposta é 403.
Mês fechado não aceita pedido. Um dia de competência já fechada responde 400 — a correção exige reabrir o mês ou entra como ajuste no mês seguinte.
Limites de período. Um abono cobre até 92 dias; o tipo pode ter limiteDiasPorAno, e ultrapassá-lo responde 400.
Quem aprova precisa enxergar o solicitante e não pode aprovar um pedido próprio (o dono da conta e os administradores são a exceção).
Aprovar sem documento é recusado quando o tipo exige comprovante, mesmo pela API.
Idempotência é sua. A API não deduplica pedidos de ausência: guarde o id devolvido ao lado do registro de origem e não reenvie o mesmo atestado.
Datas. dataInicio, dataFim e dataMarcacao são dias civis (yyyy-MM-dd); dataHoraProposta é um instante — envie com o fuso (-03:00). Veja Datas e formatos.

Referência gerada do contrato da API em 30 de outubro de 2026. taitecnologia.com · Termos de uso · Privacidade