Buscar Histórico de Horário por Situação

GET 
/historicoHorarios/:situacao

Para realizar esta requisição, informe situacao=1 ou situacao=2 no caminho da URL e envie os demais filtros na query string.

Exemplos: /historicoHorarios/1?dataInicial=2025-08-02... e /historicoHorarios/2?dataInicial=2025-08-02....

Informe ao menos dataInicial ou dataFinal. Para situacao=1, sem atzSituacao=N, informe ambas as datas. Se a integração por empresa da folha estiver habilitada, informe codEmpresa.

A consulta direta ocorre com situacao=2 ou atzSituacao=N. Nesse caso, o período filtra dataRegistro, dataFinal considera 00:00 do dia informado e são retornados apenas registros de origem P. Nas demais combinações, são consultadas pendências. Verifique success e errors quando presentes na resposta.

Request

Path Parameters

Query Parameters

Responses

200

Lista de registros ou erros nos filtros informados.

application/json

Schema

Schema

anyOf

HistoricoHorarioListResponse

Resultado da consulta. A consulta direta retorna total e data; a consulta de pendências retorna success e data.

success booleannullable

total integernullable

data

object[]

nullable

Array [

seqRegistro int64

operacao string

codEmpresa string

matricula int64

dataHorarioTrabalho date

codHorarioTrabalho integer

codHorarioFolhaChar stringnullable

dataRegistro string

observacao stringnullable

dataAtualizacao stringnullable

origem stringnullable

usuario stringnullable

situacao stringnullable

idIntArqEnv int64nullable

]

FiltroIntfolError

success boolean

observacao string

errors

object

property name* string

Example (from schema)

{}

diretaVazia

Exemplo de resultado

{
  "total": 0,
  "data": []
}

semDatas

Exemplo de resultado

{
  "success": false,
  "errors": {
    "dataInicial": "É necessário informar data inicial ou data final válida no filtro.",
    "dataFinal": "É necessário informar data inicial ou data final válida no filtro."
  },
  "observacao": "Parâmetros inválidos."
}

situacaoInvalida

Exemplo de resultado

{
  "success": false,
  "errors": {
    "situacao": "Situação diferente de 1 ou 2."
  },
  "observacao": "Parâmetros inválidos."
}

consultaDireta

Consulta direta com um registro.

{
  "total": 1,
  "data": [
    {
      "seqRegistro": 12345,
      "operacao": "I",
      "codEmpresa": "EMP01",
      "matricula": 1001,
      "dataRegistro": "2026-10-14T08:00:00.000Z",
      "observacao": null,
      "dataAtualizacao": null,
      "origem": "P",
      "usuario": null,
      "situacao": "2",
      "idIntArqEnv": null,
      "dataHorarioTrabalho": "2026-10-14",
      "codHorarioTrabalho": 1,
      "codHorarioFolhaChar": null
    }
  ]
}

400

Empresa ausente ou inválida quando exigida pela configuração do ambiente.

application/json

Schema

Schema

message stringrequired

Example (from schema)

{
  "message": "string"
}

empresaAusente

Exemplo de resultado

{
  "message": "Operação Negada. Parâmetro codEmpresa ausente na requisição."
}

Loading...