Validar comprovante de ponto

Todo comprovante de marcação de ponto emitido pela TAI traz um código de verificação (e um QR code) que qualquer pessoa confere sem login: o trabalhador, o auditor fiscal, o departamento jurídico, um sistema de terceiros que recebeu o comprovante.

Quando usar	Conferir se um comprovante apresentado é autêntico e corresponde a uma marcação registrada
Porta	Página pública (sem token)
Você vai precisar	Só o código de verificação impresso no comprovante

Como funciona

comprovante (papel, PDF, e-mail) ─► código de verificação
        │
        ▼
GET /ponto/comprovante/publico/{codigo}      ──► dados da marcação (JSON)
GET /ponto/comprovante/publico/{codigo}/pdf  ──► comprovante em PDF

O código tem 128 bits aleatórios: não dá para adivinhar nem percorrer códigos em sequência.

Consultar

curl https://api.taitecnologia.com/ponto/comprovante/publico/7f3c9a…

Devolve os dados do comprovante, conforme a Portaria 671:

Campo	Conteúdo
nsr	Número sequencial do registro
razaoSocial, cnpj, ceiCnoCaepf, localPrestacao	Empregador
nomeColaborador, cpf	Trabalhador
dataHora, fusoHorario	Momento da marcação
origemColeta	Como a marcação foi coletada (WEB, MOBILE, QUIOSQUE)
hashRegistro, versaoHash	Integridade do registro
nomePrograma, registroInpi, versaoPrograma	Programa de tratamento de registro de ponto
codigoVerificacao, urlValidacao	Para nova conferência — urlValidacao é a página pública de validação no app
assinaturaDisponivel	Se há PDF assinado digitalmente

Um código inexistente responde 404.

Baixar o PDF

GET /ponto/comprovante/publico/{codigo}/pdf

Devolve o comprovante em PDF.

Comprovantes de quem usa a plataforma

Com login, cada pessoa e quem enxerga o ponto dela também obtêm o comprovante pela marcação: GET /ponto/marcacao/{id}/comprovante (JSON) e GET /ponto/marcacao/{id}/comprovante/pdf. Veja a referência do ponto.

Cuidados

• A resposta traz o CPF e o nome do trabalhador. Quem tem o código vê a marcação: trate o código como você trataria o próprio comprovante.
• Validar não é auditar o mês. O comprovante prova uma batida. Para o conjunto das marcações do período, a prova é o AFD — veja Levar o ponto fechado para a folha de outro sistema.