qual API para consultar a lista de employee?

[Bruno Rosa]

# 3 anos, 6 meses atrás

Acessando a API PRIVADA platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/hcm/payroll​/queries​/employee, não retorna nenhum resultado:
RESPONSE:
{
“totalPages”: 0,
“totalElements”: 0,
“contents”: []
}

Por qual API consigo a lista de funcionários?

[Luciano Burkhard]

# 3 anos, 6 meses atrás

Olá Bruno,
A seguir estão duas API\’s que retornam lista de colaboradores e outras que retornam dados de um determinado colaborador pelo id.

– Retornar lista de todos colaboradores
API: https://hcm-api.senior.com.br/frontend-api/employee
Exemplo:
Método: GET
URL: https://hcm-api.senior.com.br/frontend-api/employee

– Retornar lista de todos colaboradores (com paginação)
API: https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/hcm/payroll/queries/employeeListQuery
Exemplo:
Método: POST
URL: https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/hcm/payroll/queries/employeeListQuery
Content type: application/json
Input body:
{
\”page\”: {
\”current\”: 1,
\”size\”: 10,
\”orderBy\”: [
{
\”field\”: \”personName\”,
\”direction\”: \”ASC\”
}
]
}
}

Documentação: https://dev.senior.com.br/api_privada/hcm_payroll/

– Retornar dados de um colaborador (opção 1)
API: https://hcm-api.senior.com.br/frontend-api/employee/{id}
Exemplo:
Método: GET
URL: https://hcm-api.senior.com.br/frontend-api/employee/384B83C5D3FF4F8893AC81D28ECF2B0A

– Retornar dados de um colaborador (opção 2)
API: https://hcm-api.senior.com.br/frontend-api/employee/{id}/summary
Exemplo:
Método: GET
URL: https://hcm-api.senior.com.br/frontend-api/employee/384B83C5D3FF4F8893AC81D28ECF2B0A/summary

– Retornar dados de um colaborador (opção 3)
API: https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/hcm/payroll/queries/employeeQuery
Exemplo:
Método: POST
URL: https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/hcm/payroll/queries/employeeQuery
Content type: application/json
Input body:
{
\”employeeId\”: \”384B83C5D3FF4F8893AC81D28ECF2B0A\”
}

Documentação: https://dev.senior.com.br/api_publica/hcm_payroll/

[Bruno Rosa]

# 3 anos, 6 meses atrás

Olá Luciano,

Obrigado pelo retorno.

As APIs de hcm-api.senior.com.br não aparecem no dev.senior.com.br, e ao tentar um get em https://hcm-api.senior.com.br/frontend-api/employee, tenho o seguinte retorno:
{
“errorCode”: “403.invalid-integrator-signature”,
“message”: “Signature of invalid API call. Check the .pem file.”,
“locale”: “en-US”
}

Também testei o POST em https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/hcm/payroll/queries/employeeListQuery, esse endpoint não retorna erro, mas também não me tras resultado algum:
{
“result”: {
“employees”: [],
“countResult”: 0,
“numberPages”: 0,
“_discriminator”: “pagedEmployeeListQuery”
}
}

Estou suspeitando de que não temos consultas de API disponíveis para nossos dados…

Teria alguma dica?

[Luciano Burkhard]

# 3 anos, 6 meses atrás

Olá Bruno,
Em todas as chamadas de API você precisa passar o token de autenticação.

Esse tutorial explica como consumir uma API e usar o Bearer token:

Consumindo uma API

Sobre a API employeeListQuery provavelmente são os parâmetros informados. Nessa API você consegue filtrar por departamento (“departmentId”) e outras características, mas no exemplo da resposta anterior eu não usei nenhum filtro, apenas os parâmetros de paginação (“page”).

[Bruno Rosa]

# 3 anos, 6 meses atrás

Oi Luciano,

Então, estou passando o Bearer ao tentar a API https://hcm-api.senior.com.br/frontend-api/employee, porém me retorna esse erro:

{
“errorCode”: “403.invalid-integrator-signature”,
“message”: “Signature of invalid API call. Check the .pem file.”,
“locale”: “en-US”
}

Já sobre o employeeListQuery, não passei parametros de filtros também, pois gostaria de retornar a lista inteira.
Meus parametros foram:

{
	"page": {
		"current": 1,
		"size": 10,
		"orderBy": 
		[
			{
				"field": "personName",
				"direction": "ASC"
			}
		]
	}
}

E meu retorno foi:

{
  "result": {
    "employees": [],
    "countResult": 0,
    "numberPages": 0,
    "_discriminator": "pagedEmployeeListQuery"
  }
}

Então vejo duas coisas nessas tentativas:
1) hcm-api.senior.com.br/frontend-api não parece estar disponível mesmo usando autenticação;
2) employeeListQuery não retorna nenhum resultado, mesmo estando devidamente autenticado.

Tens alguma ideia sobre como resolver?

Obrigado.

[Luciano Burkhard]

# 3 anos, 6 meses atrás

Olá Bruno,
Conforme conversamos, o ambiente que você está acessando não está com o HCM Painel de Gestão implantado, com isso a tabela de colaboradores está vazia.

Se você quiser consultar os dados do HCM Administração de pessoal podem ser usados os web services do módulo.
A documentação para isso está em:
https://documentacao.senior.com.br/gestao-de-pessoas-hcm/6.2.35/#webservices/gestao_pessoas.htm