Skip to main content
POST
/
ajuste-registro
/
previa
Cria uma prévia da frequência diária de um ajuste no formato de registro de ponto
curl --request POST \
  --url https://api.example.com/ajuste-registro/previa \
  --header 'Content-Type: application/json' \
  --data '
{
  "colaboradorId": "e87753cf-49d3-49b7-9206-689ed4acc9cb",
  "jornada": "01/01/2024",
  "registrosPropostos": [
    {
      "dataHora": "2024-05-02T14:22:43.230Z",
      "registroHash": "c0fc3c713f09a43384ac08f7d91fca430dcbc6466fff9284ce4571bdc2c8f9f9"
    }
  ]
}
'
{
  "data": "2023-07-23T00:00:00.000Z",
  "cargaHoraria": "8:48",
  "horasTrabalhadas": "8:00",
  "saldo": "-0:48",
  "atrasos": "0:20",
  "antecipacoes": "0:15",
  "tempoIntrajornada": "1:12",
  "tempoInterjornada": "12:00",
  "registros": [
    {
      "dataHora": "2024-05-02T14:22:43.230Z",
      "nome": "Nelson da Silva",
      "cpf": "15217510056",
      "tipo": "SIMPLE",
      "endereco": "Avenida Afonso Pena, 237, Belo Horizonte, MG",
      "NSR": "2307",
      "hashCode": "c0fc3c713f09a43384ac08f7d91fca430dcbc6466fff9284ce4571bdc2c8f9f9",
      "criadoEm": "2024-05-02T14:22:43.230Z",
      "tipoOrigem": "01",
      "online": true,
      "tipoRegistroBatida": "ENTRADA",
      "tipoAmbiente": "INDIVIDUAL",
      "fusoHorario": "SAO_PAULO",
      "criadoPorAjuste": false,
      "invalidadoPorAjuste": false,
      "inconsistencias": [
        "ENDERECO_IP_AUSENTE_OU_NAO_CADASTRADO"
      ],
      "colaboradorId": "123-456abc",
      "relogioId": "123-456abc",
      "coletorId": "123-456abc",
      "relatorioId": "123-456abc",
      "coletorDescricao": "Piso 01",
      "indevido": false,
      "statusInconstencias": "PENDENTE"
    }
  ],
  "statusVigenteColaborador": "ATIVO",
  "regraPontoVigente": {
    "id": "123-456abc",
    "tipo": "MISTO",
    "nome": "Regra de ponto 1"
  },
  "turnoVigente": {
    "tipo": "turnoFixo",
    "nome": "Horário comercial",
    "turnoId": "123-456abc",
    "tipoTurnoFlexivel": "DIARIO",
    "excecao": false,
    "excecaoId": "123-456abc"
  },
  "ocorrencias": [
    "TEMPO_INTERJORNADA_MENOR_QUE_O_MINIMO"
  ],
  "pendencias": [
    "FALTA"
  ],
  "saldoIntrajornada": "-0:08",
  "adicionalNoturno": "4:00",
  "bancoHoras": "+0:48",
  "horasExtras": "0:48",
  "horasExtrasSaldoBase": "0:30",
  "horasExtrasIntervaloSaldoBase": "0:30",
  "indenizacaoInterjornada": 30,
  "falta": 1,
  "faltaHoras": "4:00",
  "feriado": "Natal",
  "diaTurnoFixo": {
    "tipoDiaTrabalho": "NORMAL",
    "diaSemana": "SEGUNDA",
    "entrada": "8:00",
    "saida": "18:00",
    "intervaloFlexivel": true,
    "intervalos": [
      {
        "inicio": "8:00",
        "fim": "18:00",
        "minimo": "0:30",
        "maximo": "1:30"
      }
    ]
  },
  "diaRevezamento": {
    "tipoDiaTrabalho": "NORMAL",
    "mesConfig": 1,
    "diaConfig": 1,
    "entrada": "8:00",
    "saida": "18:00",
    "intervaloFlexivel": true,
    "intervalos": [
      {
        "inicio": "8:00",
        "fim": "18:00",
        "minimo": "0:30",
        "maximo": "1:30"
      }
    ]
  },
  "grupoFlexivelConfiguracao": {
    "tempoTrabalho": "8:00",
    "trabalhaSegunda": true,
    "trabalhaTerca": true,
    "trabalhaQuarta": true,
    "trabalhaQuinta": true,
    "trabalhaSexta": true,
    "trabalhaSabado": false,
    "trabalhaDomingo": false,
    "viraNoite": "1:00",
    "intervalos": [
      {
        "inicio": "8:00",
        "fim": "18:00",
        "minimo": "0:30",
        "maximo": "1:30"
      }
    ]
  },
  "ajuste": {
    "ajusteRegistroId": "123-456abc",
    "codigo": 1,
    "jornada": "2024-01-01T00:00:00.000Z",
    "status": "APROVADO",
    "formato": "REGISTRO_PONTO",
    "descricao": "Atestado",
    "createdAt": "2023-07-23T00:00:00.000Z",
    "updatedAt": "2023-07-23T00:00:00.000Z",
    "motivo": {
      "descricao": "Esqueceu de registrar o ponto",
      "tipo": "ABONO",
      "motivoAjusteRegistroId": "123-456abc",
      "descontarJornada": false,
      "descontarPreferencialmenteAdicionalNoturno": false
    },
    "titulo": "Confraternização da firma",
    "jornadas": [
      "2024-01-01T00:00:00.000Z",
      "2024-01-02T00:00:00.000Z"
    ],
    "minPeriodo": "2024-01-01T00:00:00.000Z",
    "maxPeriodo": "2024-05-31T00:00:00.000Z",
    "minMinutos": 480,
    "maxMinutos": 720,
    "considerarRegistroRealizado": false,
    "tempoFaltante": "+04:48",
    "ferias": false,
    "registrosPropostos": [
      {
        "dataHora": "2024-05-02T14:22:43.230Z",
        "registroHash": "c0fc3c713f09a43384ac08f7d91fca430dcbc6466fff9284ce4571bdc2c8f9f9"
      }
    ],
    "anexos": [
      {
        "arquivoId": "123-456abc",
        "nome": "comprovante.pdf",
        "url": "https://s3-bucket.s3.amazonaws.com/files/tenant_x/file.jpg"
      }
    ],
    "nomeGestor": "Nelson da Silva",
    "observacaoGestor": "Não se esqueça novamente de registrar ponto",
    "colaboradores": [
      {
        "colaboradorId": "123-456abc",
        "nome": "João da Silva",
        "numeroDocumento": "152.175.100-56",
        "saldoAntigo": "-04:48",
        "adicionalNoturnoAntigo": "+04:48",
        "foto": "https://s3-bucket.s3.amazonaws.com/files/tenant_x/file.jpg",
        "nomeUnidadeNegocio": "Tron",
        "logoUnidadeNegocio": "https://s3-bucket.s3.amazonaws.com/files/tenant_x/file.jpg"
      }
    ],
    "frequenciaDiariaJornada": "<unknown>"
  }
}

Body

application/json

Registros propostos

​
colaboradorId
string
required

Id do colaborador

Example:

"e87753cf-49d3-49b7-9206-689ed4acc9cb"

​
jornada
string
required

Data da jornada de trabalho (dd/MM/yyyy)

Example:

"01/01/2024"

​
registrosPropostos
object[]
required

Registros de ponto propostos

Response

Prévia de frequência

​
data
string
required

Dia dos registros

Example:

"2023-07-23T00:00:00.000Z"

​
cargaHoraria
string
required

Carga horária esperada do turno

Example:

"8:48"

​
horasTrabalhadas
string
required

Horas trabalhadas no turno

Example:

"8:00"

​
saldo
string
required

Saldo comparativo entre a carga horária esperada e as horas trabalhadas, positivo ou negativo

Example:

"-0:48"

​
atrasos
string
required

Tempo de atraso

Example:

"0:20"

​
antecipacoes
string
required

Tempo de antecipação

Example:

"0:15"

​
tempoIntrajornada
string
required

Tempo em intervalo

Example:

"1:12"

​
tempoInterjornada
string
required

Tempo entre esta jornada e a anterior

Example:

"12:00"

​
registros
object[]
required

Registros de ponto do dia

​
statusVigenteColaborador
enum<string>
default:ATIVO
required

Status em que o colaborador estava no dia

Available options:
ATIVO,
INATIVO,
RASCUNHO
​
regraPontoVigente
object
required

Regra de ponto do dia

​
turnoVigente
object
required

Turno do dia

​
ocorrencias
enum<string>[]
required

Ocorrências da jornada de trabalho

Available options:
TEMPO_INTERJORNADA_MENOR_QUE_O_MINIMO,
TEMPO_DE_INTERVALO_MAIOR_QUE_O_PLANEJADO,
TEMPO_DE_INTERVALO_MENOR_QUE_O_PLANEJADO,
NUMERO_IMPAR_DE_REGISTROS_NO_DIA,
LIMITE_DE_REGISTROS_POR_DIA_EXCEDIDO,
FALTA,
SALDO_POSITIVO,
SALDO_NEGATIVO,
HORA_EXTRA_NOTURNA
​
pendencias
enum<string>[]
required

Pendências da jornada de trabalho

Available options:
AJUSTE_PENDENTE,
FALTA,
NUMERO_IMPAR_DE_REGISTROS_NO_DIA
​
saldoIntrajornada
string

Saldo comparativo entre a carga esperada e o tempo de intervalo tirado, positivo ou negativo

Example:

"-0:08"

​
adicionalNoturno
string

Horas trabalhadas em período de adicional noturno

Example:

"4:00"

​
bancoHoras
string

Horas de banco de horas

Example:

"+0:48"

​
horasExtras
string

Horas extras

Example:

"0:48"

​
horasExtrasSaldoBase
string

Saldo base para cálculo de horas extras

Example:

"0:30"

​
horasExtrasIntervaloSaldoBase
string

Saldo base para cálculo de horas extras do intervalo separadamente

Example:

"0:30"

​
indenizacaoInterjornada
number

Tempo adicional de indenização, em minutos, de trabalho durante o período de descanso interjornada

Example:

30

​
falta
number

Falta: 1 para falta comum ou decimal para meia falta

Example:

1

​
faltaHoras
string

Meia falta em horas, a ser mostrada caso a regra de ponto estiver configurada para tal

Example:

"4:00"

​
feriado
string

Nome do feriado, caso seja um

Example:

"Natal"

​
diaTurnoFixo
object

Dados sobre o turno fixo (se existir) referente à jornada de trabalho do dia

​
diaRevezamento
object

Dados sobre o turno de revezamento (se existir) referente à jornada de trabalho do dia

​
grupoFlexivelConfiguracao
object

Dados sobre o turno flexível (se existir) referente à jornada de trabalho do grupo de dias correspondente

​
ajuste
object

Dados sobre ajuste de registro (se existir) referente à jornada de trabalho do dia