Buscar Histórico de Setor por Situação

GET 
/historicoSetores/:situacao

Informe situacao=1 ou situacao=2 no caminho da URL e envie os demais filtros na query string.

Exemplos: /historicoSetores/1?dataInicial=2025-08-02... e /historicoSetores/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. Os campos do histórico são retornados como datatransferencia, codempresasetor e codsetorponto. Nas demais combinações, são consultadas pendências, cujos campos correspondentes são dataTransferencia, codEmpresaSetor e codSetorPonto. 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

HistoricoSetorListResponse

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

dataTransferencia stringnullable

datatransferencia stringnullable

codEmpresaSetor stringnullable

codempresasetor stringnullable

codSetorPonto stringnullable

codsetorponto 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,
      "datatransferencia": "2026-10-14",
      "codempresasetor": "EMP01",
      "codsetorponto": "SET01"
    }
  ]
}

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...