Skip to main content
POST
/
ajuste-registro
curl --request POST \
  --url https://api.example.com/ajuste-registro \
  --header 'Content-Type: application/json' \
  --data '
{
  "colaboradorIds": [
    "123-abc"
  ],
  "jornada": "01/01/2024",
  "formato": "INTERVALO_HORARIO",
  "descricao": "Exemplo de formato intervalo de horário das 8:00 às 9:00"
}
'
{
  "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": {
    "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": "<unknown>"
  }
}

Body

application/json

Formato do ajuste de registro

​
jornada
string
required

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

Example:

"01/01/2024"

​
formato
enum<string>
default:REGISTRO_PONTO
required

Formato do ajuste

Available options:
INTERVALO_DATAS,
INTERVALO_HORARIO,
TEMPO_FALTANTE,
REGISTRO_PONTO
​
descricao
string
required

Uma descrição da razão do ajuste

Example:

"Atestado"

​
colaboradorIds
string[]
required

ID do colaborador

Example:
["123-456abc"]
​
motivoId
string

ID do motivo do ajuste. Obrigatório caso não seja um ajuste de férias

Example:

"123-456abc"

​
anexos
object[]

Arquivos em anexo

​
jornadas
string[]

Datas de jornadas de trabalho (dd/MM/yyyy), caso formato tempo faltante

Example:

"01/01/2024"

​
minPeriodo
string

Data inicial do periodo de ajuste (dd/MM/yyyy), caso formato intervalo de datas

Example:

"01/05/2024"

​
maxPeriodo
string

Data final do periodo de ajuste (dd/MM/yyyy), caso formato intervalo de datas

Example:

"31/05/2024"

​
minMinutos
number

Horário inicial, em minutos, para o ajuste, caso formato intervalo de horário

Example:

480

​
maxMinutos
number

Horário final, em minutos, para o ajuste, caso formato intervalo de horário

Example:

720

​
considerarRegistroRealizado
boolean

Considerar o saldo dos registros realizados no período, caso formato intervalo de datas

Example:

false

​
registrosPropostos
object[]

Registros de ponto propostos, para o ajuste, caso formato inclusão de registros de ponto

​
ferias
boolean

Indica se o ajuste é de férias

Example:

false

​
titulo
string

Título do ajuste

Example:

"Confraternização da firma"

Response

Ajuste criado

​
ajusteRegistroId
string
required

ID do ajuste

Example:

"123-456abc"

​
codigo
number
required

Código do ajuste

Example:

1

​
jornada
string
required

ISO string da data da jornada de trabalho (dd/MM/yyyy)

Example:

"2024-01-01T00:00:00.000Z"

​
status
enum<string>
default:APROVADO
required

Status do ajuste

Available options:
APROVADO,
PENDENTE,
CANCELADO,
REJEITADO
​
formato
enum<string>
default:REGISTRO_PONTO
required

Formato do ajuste

Available options:
INTERVALO_DATAS,
INTERVALO_HORARIO,
TEMPO_FALTANTE,
REGISTRO_PONTO
​
descricao
string
required

Uma descrição da razão do ajuste

Example:

"Atestado"

​
createdAt
string<date-time>
required

Data de criação do ajuste

Example:

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

​
updatedAt
string<date-time>
required

Data de atualização do ajuste

Example:

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

​
motivo
object

Motivo do ajuste

​
titulo
string

Título do ajuste

Example:

"Confraternização da firma"

​
jornadas
string[]

ISO string das datas de jornadas de trabalho (dd/MM/yyyy), caso formato tempo faltante

Example:
[
  "2024-01-01T00:00:00.000Z",
  "2024-01-02T00:00:00.000Z"
]
​
minPeriodo
string

ISO string da data inicial do periodo de ajuste (dd/MM/yyyy), caso formato intervalo de datas

Example:

"2024-01-01T00:00:00.000Z"

​
maxPeriodo
string

ISO string da data final do periodo de ajuste (dd/MM/yyyy), caso formato intervalo de datas

Example:

"2024-05-31T00:00:00.000Z"

​
minMinutos
number

Horário inicial, em minutos, para o ajuste, caso formato intervalo de horário

Example:

480

​
maxMinutos
number

Horário final, em minutos, para o ajuste, caso formato intervalo de horário

Example:

720

​
considerarRegistroRealizado
boolean

Considerar o saldo dos registros realizados no período, caso formato intervalo de datas

Example:

false

​
tempoFaltante
string

Quantidade de horas utilizadas para zerar o saldo, caso formato tempo faltante

Example:

"+04:48"

​
ferias
boolean

Indica se o ajuste é de férias

Example:

false

​
registrosPropostos
object[]

Registros de ponto propostos, para o ajuste, caso formato inclusão de registros de ponto

​
anexos
object[]

Arquivos em anexo

​
nomeGestor
string

Nome do gestor

Example:

"Nelson da Silva"

​
observacaoGestor
string

Observação do gestor

Example:

"Não se esqueça novamente de registrar ponto"

​
colaboradores
object[]

Colaboradores vinculados ao ajuste

​
frequenciaDiariaJornada
object

Frequência diária da jornada, caso formato registro de ponto