Ponto eletrônico

O ponto da TAI é um REP-P (Portaria 671): registra as batidas, apura o dia, controla o banco de horas, fecha o mês com o espelho congelado e gera o AFD e o AEJ assinados. O que normalmente se integra com ele é a folha de outro sistema, que consome o mês fechado, o sistema que gera atestados e ausências, e o tablet de ponto próprio da empresa.

Jornadas

Levar o ponto fechado para a folha de outro sistema Espelhos congelados, totais, banco de horas, AFD e AEJ quando o mês fecha.

Registrar correções e ausências pela API Atestados, abonos e batidas esquecidas vindos de outro sistema, com a fila de aprovação.

Quiosque de ponto Tablet compartilhado: parear, marcar por CPF e PIN, crachá ou rosto.

Validar comprovante de ponto Conferir, sem login, um comprovante de marcação pelo código.

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)
O ponto do mês é fechado PONTO_COMPETENCIA_FECHADA A competência do ponto foi fechada.	fechamentoIdcompetencia
Um ajuste de ponto é pedido PONTO_AJUSTE_PEDIDO Alguém pediu para corrigir as batidas de um dia e o pedido foi para o gestor.	solicitacaoIdcolaboradorIddataMarcacao
Um ajuste de ponto é aprovado PONTO_AJUSTE_APROVADO Um pedido de correção das batidas foi aprovado (pelo gestor ou pela política automática da empresa).	solicitacaoIdcolaboradorIddataMarcacao
Um ajuste de ponto é recusado PONTO_AJUSTE_REJEITADO Um pedido de correção das batidas foi recusado pelo gestor.	solicitacaoIdcolaboradorIddataMarcacao
Um ajuste de ponto é cancelado PONTO_AJUSTE_CANCELADO Quem pediu a correção das batidas desistiu do pedido.	solicitacaoIdcolaboradorIddataMarcacao
Uma justificativa de ausência é pedida ABONO_PEDIDO Alguém pediu para abonar uma falta ou atraso e o pedido foi para o gestor.	abonoIdcolaboradorIdtipoAbonoIddataIniciodataFim
Uma justificativa de ausência é aprovada ABONO_APROVADO Um pedido de abono foi aprovado e o período foi recalculado.	abonoIdcolaboradorIdtipoAbonoIddataIniciodataFim
Uma justificativa de ausência é recusada ABONO_REJEITADO Um pedido de abono foi recusado pelo gestor.	abonoIdcolaboradorIdtipoAbonoIddataIniciodataFim
Uma justificativa de ausência é cancelada ABONO_CANCELADO Quem pediu o abono desistiu do pedido.	abonoIdcolaboradorIdtipoAbonoIddataIniciodataFim
Um comprovante é anexado a uma ausência ABONO_DOCUMENTO_ANEXADO Um documento (atestado, declaração) foi anexado a um pedido de abono.	abonoIdcolaboradorIdtipoAbonoIddataIniciodataFim
O ponto do mês é reaberto PONTO_COMPETENCIA_REABERTA Uma competência do ponto que estava fechada foi reaberta para correção.	fechamentoIdcompetenciadiasReabertos
O banco de horas de alguém é pago BANCO_HORAS_QUITADO O saldo positivo do banco de horas de um colaborador foi quitado em folha.	movimentoIdcolaboradorIdcompetenciaFolhaminutos
O ciclo do banco de horas é encerrado BANCO_HORAS_CICLO_ENCERRADO O ciclo do banco de horas foi encerrado e os saldos positivos foram enviados para pagamento em folha.	competenciaFolharegraIdpessoasPagasnegativosMantidosminutosPagos
Uma jornada de trabalho é cadastrada JORNADA_TRABALHO_CADASTRADO Foi cadastrada uma nova jornada de trabalho. Aceita o registro completo.	jornadaTrabalhoIdnometipocargaSemanalMinutosativo
Uma jornada de trabalho é alterada JORNADA_TRABALHO_ALTERADO Uma jornada de trabalho foi alterada, ativada ou desativada. Aceita o registro completo.	jornadaTrabalhoIdnometipocargaSemanalMinutosativo
Uma jornada de trabalho é excluída JORNADA_TRABALHO_EXCLUIDO Uma jornada de trabalho foi excluída.	jornadaTrabalhoId

O ponto do mês é fechado sai tanto no fechamento à mão quanto no automático. As batidas em si não são eventos: leia-as em /ponto/marcacao.

O que a TAI faz sozinha

Rotinas nativas, ligadas e desligadas em Processos › Central de Automações (as duas marcadas com * têm a chave em Departamento Pessoal › Ponto › Configurações › Automações).

Rotina	O que faz	Começa ligada?
ponto-apuracao-diaria	De madrugada, apura as marcações do dia anterior: horas trabalhadas, extras, faltas e banco	Sim
ponto-previa-fechamento	Avisa os gestores, antes do fechamento, das pendências do espelho	Sim
ponto-fechamento-automatico	Fecha a competência no dia configurado, se nada travar	Sim, mas só age com Fechar o mês sozinho ligado na configuração do ponto (desligado por padrão)
ponto-banco-horas-alerta	Avisa quando o banco de horas passa do limite ou tem crédito para vencer	Sim
ponto-feriados-ano-seguinte	Carrega os feriados nacionais do ano seguinte no calendário	Sim, mas só age com Feriados nacionais do ano seguinte ligado na configuração do ponto (desligado por padrão)
ponto-cobranca-fechamento *	Nos dias antes do fechamento, cobra de cada pessoa os dias pendentes e mostra ao gestor o que espera por ele	Não
ponto-alerta-jornada *	Avisa o gestor de descanso de 11 horas (Art. 66) ou intervalo (Art. 71) não respeitados	Não

Dica

GET /ponto/config-tenant devolve as chaves de automação do ponto da conta (fecharAutomatico, diaFechamentoAutomatico, enviarEspelhoAoFechar…) e PUT /ponto/config-tenant as altera — só os campos enviados mudam. Nenhuma delas aprova nada.

Recursos da API

Referência completa: Ponto eletrônico.

Rota-base	Para que serve
/ponto/fechamento	Prévia, fechamento e reabertura da competência; espelhos congelados do mês
/ponto/apuracao	Apuração diária, totais do período por pessoa e dias inconsistentes
/ponto/espelho	Espelho de uma pessoa, em JSON ou PDF
/ponto/banco-horas	Saldo, extrato, painel do time e o que o banco manda para a folha
/ponto/abono e /ponto/solicitacao-ajuste	Ausências justificadas e correções de batida, com aprovação
/ponto/marcacao	Batidas do período e comprovante de cada marcação
/ponto/afd e /ponto/aej	Arquivos fiscais da Portaria 671, com ou sem assinatura
/ponto/dispositivo	Tablets de ponto: cadastro, pareamento e revogação