Consulta os grupos de empresas existentes no sistema, com base nos filtros fornecidos. - API Zen 2

Este endpoint permite consultar informações sobre os grupos de empresas cadastradas no sistema.
O parâmetro TotalRegistros pode ser utilizado para limitar o número de registros retornados.
A consulta retorna um conjunto de grupos de empresas que atendem aos filtros fornecidos.

Validações:

Verifica se o número total de registros solicitado não ultrapassa 500.

Respostas:

Sucesso: Retorna a lista de grupos de empresas conforme os filtros aplicados.

Falhas: Detalha os erros, como número de registros excedente ou falhas na validação dos filtros.

Exemplo de Requisição (GET com parâmetros na URL):

Valores e Descrições do Enum AtivoInativoEnum:

Valor	Descrição
1	Ativo
2	Inativo

Exemplo de Resposta de Sucesso (200 - OK):

{
  "sucesso": true,
  "mensagens": "Consulta realizada com sucesso",
  "dados": [
    {
      "Id": 12345,
      "NomeGrupo": "Grupo A",
      "Descricao": "Descrição do Grupo A"
    },
    {
      "Id": 12346,
      "NomeGrupo": "Grupo B",
      "Descricao": "Descrição do Grupo B"
    }
  ]
}

Exemplo de Resposta de Erro (400 - Bad Request):

{
  "sucesso": false,
  "mensagens": "Erro de validação nos dados fornecidos",
  "dados": null
}