Buscar detalhes de cadastros diversos (Queries) — APIs da Admissão Digital

Queries retornam os dados básicos de diversos tipos de cadastros e registros da base, como por exemplo: empresas, países, estados e cidades.

Esta documentação lista as queries que estão disponíveis nas APIs da Admissão Digital.


URL

POST <url_plataforma>/t/senior.com.br/bridge/1.0/rest/hcm/onboarding/actions/<query>

Substitua <url_plataforma> pela URL correspondente ao seu ambiente. Se for o ambiente de produção, substitua por: https://platform.senior.com.br

Substitua <query> pelo nome de uma das queries abaixo, referente ao registro que quer buscar com a API.

Cabeçalho (Header)

Authorization Bearer​ <access_token>
Content-Type application/json

Substitua <access_token> pela chave de acesso obtida a partir da API de autenticação na plataforma.


countryListQuery

Retorna as informações básicas do cadastro de países.

Parâmetros (opcionais):

Nome Tipo Descrição
size Integer Tamanho das páginas.
offset Integer Indicativo da página atual.
filter String Filtro a ser aplicado na pesquisa, baseado no nome do modelo.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
totalElements Integer Total de registros encontrados.
totalPages Integer Total de páginas encontradas.
contents { } Relação dos países.
  id String Identificador do país.
  name String Nome do país.
  abbreviation String Abreviação do nome do país.
  createdBy String  
  createdDate String  
  lastModifiedBy String  
  lastModifiedDate String  
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

stateListQuery

Retorna as informações básicas do cadastro de estados/unidades federativas.

Parâmetros (opcionais):

Nome Tipo Descrição
size Integer Tamanho das páginas.
offset Integer Indicativo da página atual.
filter String Filtro a ser aplicado na pesquisa, baseado no nome do modelo.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
totalElements Integer Total de registros encontrados.
totalPages Integer Total de páginas encontradas.
contents { } Relação dos estados/unidades federativas.
  id String Identificador do estado.
  name String Nome do estado.
  abbreviation String Abreviação do nome do estado.
  country String País ao qual o estado pertence.
  createdBy String  
  createdDate String  
  lastModifiedBy String  
  lastModifiedDate String  
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

cityListQuery

Retorna as informações básicas do cadastro de cidades.

Parâmetros (opcionais):

Nome Tipo Descrição
size Integer Tamanho das páginas.
offset Integer Indicativo da página atual.
filter String Filtro a ser aplicado na pesquisa, baseado no nome do modelo.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
totalElements Integer Total de registros encontrados.
totalPages Integer Total de páginas encontradas.
contents { } Relação das cidades.
  id String Identificador da cidade.
  name String Nome da cidade.
  state String Estado ao qual a cidade pertence.
  createdBy String  
  createdDate String  
  lastModifiedBy String  
  lastModifiedDate String  
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

nationalityListQuery

Retorna as informações básicas do cadastro de nacionalidades.

Parâmetros (opcionais):

Nome Tipo Descrição
size Integer Tamanho das páginas.
offset Integer Indicativo da página atual.
filter String Filtro a ser aplicado na pesquisa, baseado no nome do modelo.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
totalElements Integer Total de registros encontrados.
totalPages Integer Total de páginas encontradas.
contents { } Relação das nacionalidades.
  id String Identificador da nacionalidade.
  code Integer Código da nacionalidade.
  name String Nome da nacionalidade.
  type String

Tipo da nacionalidade.

  createdBy String  
  createdDate String  
  lastModifiedBy String  
  lastModifiedDate String  
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

religionListQuery

Retorna as informações básicas do cadastro de religiões.

Parâmetros (opcionais):

Nome Tipo Descrição
size Integer Tamanho das páginas.
offset Integer Indicativo da página atual.
filter String Filtro a ser aplicado na pesquisa, baseado no nome do modelo.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
totalElements Integer Total de registros encontrados.
totalPages Integer Total de páginas encontradas.
contents { } Relação das religiões.
  id String Identificador da religião.
  code Integer Código da religião.
  name String Descrição da religião.
  createdBy String  
  createdDate String  
  lastModifiedBy String  
  lastModifiedDate String  
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

bankListQuery

Retorna as informações básicas do cadastro de bancos.

Parâmetros (opcionais):

Nome Tipo Descrição
size Integer Tamanho das páginas.
offset Integer Indicativo da página atual.
filter String Filtro a ser aplicado na pesquisa, baseado no nome do modelo.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
totalElements Integer Total de registros encontrados.
totalPages Integer Total de páginas encontradas.
contents { } Relação dos bancos.
  id String Identificador do banco.
  code Integer Número do banco.
  name String Descrição do banco.
  createdBy String  
  createdDate String  
  lastModifiedBy String  
  lastModifiedDate String  
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

degreeOfEducationListQuery

Retorna as informações básicas do cadastro de graus de instrução.

Parâmetros (opcionais):

Nome Tipo Descrição
size Integer Tamanho das páginas.
offset Integer Indicativo da página atual.
filter String Filtro a ser aplicado na pesquisa, baseado no nome do modelo.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
totalElements Integer Total de registros encontrados.
totalPages Integer Total de páginas encontradas.
contents { } Relação dos graus de instrução.
  id String Identificador único do grau de instrução.
  code Integer Código do grau de instrução.
  name String Nome do grau de instrução.
  type String

Tipo do grau de instrução.

  createdBy String  
  createdDate String  
  lastModifiedBy String  
  lastModifiedDate String  
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

companyListQuery

Retorna as informações básicas do cadastro de empresas.

Parâmetros (opcionais):

Nome Tipo Descrição
size Integer Tamanho das páginas.
offset Integer Indicativo da página atual.
filter String Filtro a ser aplicado na pesquisa, baseado no nome do modelo.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
totalElements Integer Total de registros encontrados.
totalPages Integer Total de páginas encontradas.
contents { } Relação das empresas.
  id String Identificador da empresa.
  companyName String Nome da empresa.
  code String Código externo da empresa.
  enabled String

Indicativo se a empresa está ativa ou não.

  branchOffice { } Filiais da empresa.
    id String Identificador único do registro.
    company { } - Estabelecimento matriz.
    branchOfficeName String Razão social.
    tradingName String Nome fantasia.
    enabled String

Indicativo se a filial está ativa ou não.

    code String Código do sistema externo.
    createdBy String  
    createdDate String  
    lastModifiedBy String  
    lastModifiedDate String  
  createdBy String  
  createdDate String  
  lastModifiedBy String  
  lastModifiedDate String  
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

companyQuery

Retorna uma lista das empresas existentes.

Parâmetros:

* Obrigatórios

Nome Tipo Descrição
size * Integer Tamanho das páginas.
offset * Integer Indicativo da página atual.
filter * String Filtro a ser aplicado na pesquisa, baseado no nome do modelo.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
result { } Relação das empresas.
  id String Identificador único da empresa.
  companyName String Nome da empresa.
  code String Código do sistema externo.
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

branchOfficeListQuery

Retorna as informações básicas do cadastro de filiais.

Parâmetros (opcionais):

Nome Tipo Descrição
size Integer Tamanho das páginas.
offset Integer Indicativo da página atual.
filter String Filtro a ser aplicado na pesquisa, baseado no nome do modelo.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
totalElements Integer Total de registros encontrados.
totalPages Integer Total de páginas encontradas.
contents { } Relação das empresas.
  id String Identificador único do registro.
  company { } Estabelecimento matriz.
    id String Identificador da empresa.
    companyName String Nome da empresa.
    code String Código externo da empresa.
    enabled String

Indicativo se a empresa está ativa ou não.

    branchOffice { } - Filiais.
    createdBy String  
    createdDate String  
    lastModifiedBy String  
    lastModifiedDate String  
  branchOfficeName String Razão social.
  tradingName String Nome fantasia.
  enabled String

Indicativo se a filial está ativa ou não.

  code String Código do sistema externo.
  createdBy String  
  createdDate String  
  lastModifiedBy String  
  lastModifiedDate String  
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

branchOfficeQuery

Retorna uma lista das filiais existentes.

Parâmetros:

* Obrigatórios

Nome Tipo Descrição
size * Integer Tamanho das páginas.
offset * Integer Indicativo da página atual.
filter * String Filtro a ser aplicado na pesquisa, baseado no nome do modelo.
company * String

Identificador (ID) da empresa vinculada às filiais.

Para obter os identificadores das empresas, você pode fazer uma requisição para o endpoint companyListQuery.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
result { } Relação das filiais.
  id String Identificador único da filial.
  branchOfficeName String Razão social.
  tradingName String Nome fantasia.
  code String Código do sistema externo.
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

jobPositionListQuery

Retorna as informações básicas do cadastro de cargos.

Parâmetros (opcionais):

Nome Tipo Descrição
size Integer Tamanho das páginas.
offset Integer Indicativo da página atual.
filter String Filtro a ser aplicado na pesquisa, baseado no nome do modelo.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
totalElements Integer Total de registros encontrados.
totalPages Integer Total de páginas encontradas.
contents { } Relação dos cargos.
  id String Identificador único do registro.
  name String Nome do cargo.
  enabled String

Indicativo se o cargo está ativo ou não.

  code String Código externo.
  createdBy String  
  createdDate String  
  lastModifiedBy String  
  lastModifiedDate String  
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

jobPositionQuery

Retorna uma lista dos cargos existentes.

Parâmetros:

* Obrigatórios

Nome Tipo Descrição
size * Integer Tamanho das páginas.
offset * Integer Indicativo da página atual.
filter * String Filtro a ser aplicado na pesquisa, baseado no nome do modelo.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
result { } Relação de cargos.
  id String Identificador único do registro.
  name String Nome do cargo.
  code String Código do sistema externo.
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

areaListQuery

Retorna uma lista das áreas (locais) existentes na empresa.

Parâmetros:

* Obrigatórios

Nome Tipo Descrição
size * Integer Tamanho das páginas.
offset * Integer Indicativo da página atual.
filter * String Filtro a ser aplicado na pesquisa, baseado no nome da área (local).
company String

Identificador (ID) da empresa.

Para obter os identificadores das empresas, você pode fazer uma requisição para o endpoint companyListQuery.

Respostas:

Código Descrição Campos da resposta
200 Ok
Campo Tipo Descrição
totalElements Integer Total de registros encontrados.
totalPages Integer Total de páginas encontradas.
contents { } Relação das áreas da empresa.
  id String Identificador único do registro.
  company { } Estabelecimento matriz.
    id String Identificador da empresa.
    companyName String Nome da empresa.
    code String Código do sistema externo (empresa).
    enabled String

Indicativo se a empresa está ativa ou não.

    createdBy String E-mail do usuário que criou o registro.
    createdDate String Data e hora em que o registro foi criado.
    lastModifiedBy String E-mail do usuário que fez a modificação mais recente no registro.
    lastModifiedDate String Data e hora em que a modificação mais recente foi feita no registro.
  name String Nome da área da empresa.
  enabled String

Indicativo se a área está ativa ou não.

  code String Código do sistema externo (área).
  createdBy String E-mail do usuário que criou o registro.
  createdDate String Data e hora em que o registro foi criado.
  lastModifiedBy String E-mail do usuário que fez a modificação mais recente no registro.
  lastModifiedDate String Data e hora em que a modificação mais recente foi feita no registro.
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

Filtros adicionais (opcionais)

Os filtros listados a seguir permitem restringir os resultados retornados pelas queries. Para usar estes filtros, você precisa concatená-los na URL da requisição.

Nome do filtro Tipo esperado Descrição do filtro
size Integer Tamanho das páginas.
offset Integer Indicativo da página atual.
filter String

Filtro Open Data Protocol (OData) da XPlatform que pode ser aplicado na pesquisa.

Para entender como aplicar este filtro na requisição, consulte a documentação de filtros no Portal de APIs da Senior.

Exemplo:

https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/hcm/onboarding/actions/countryListQuery?size=10&offset=1&filter=id gt 2 and id lt 5

Este artigo ajudou você?