Histórico da Página

01. DADOS GERAIS

Produto:DT - Integração RM x Feedz - Melhoria nas mensagens de Integr	RM
Linha de Produto:	Linha RM
Segmento:	RH
Módulo:	TOTVS Folha de Pagamento
Função:	Integração Quírons: API para retornar a lista do Lider direto dos empregados
País:	Brasil
Requisito/Story/Issue (informe o requisito relacionado) :	DRHROTRM-10231

02. LIBERAÇÃO

Lembrando que, será a partir dos patches:

12.1.2310.
12.1.2402.
12.1.2410 e superiores

03. SITUAÇÃO/REQUISITO

Atualmente foi disponibilizado para o cliente uma query para que dentro do LMS o gestor consiga visualizar os dados do seu subordinado, mas implementarmos essa query seria inviável, devido a performance. Pois iria prejudicar os clientes que utilizam a API e não necessitam dessa informação.

04. SOLUÇÃO

Implementada a API employeesManagerDataContent que irá retornar uma lista contendo o líder direto dos empregados, semelhante a API employeeDataContent que retorna a lista dos empregados.

A API receberá os seguintes query params:

Query Param	Descrição	Obrigatório	Tipo
companyId	Código do grupo de empresas para filtro	Sim	String
branchId	Código da filial do empregado para filtro	Sim	String
page	Página que está sendo requisitada	Não	Integer
pageSize	Quantidade de registros por página	Não	Integer
employeeCode	Código da matrícula do empregado para filtro	Não	String
employeeCostCenterCode	Código do centro de custo do(s) empregado(s) para filtro	Não	String

A API retornará as seguintes propriedades:

Propriedade	Descrição	Tipo
hasNext	Indica se há registros na próxima página	Boolean
total	Indica o total de registros retornados	Integer
items	Lista dos líderes direto dos empregados	Array

A propriedade items contém as seguintes propriedades:

Propriedade	Descrição	Tipo	Origem do valor
managerBranch	Filial do líder	String	PSECAO.CODFILIAL
managerCode	Matrícula do líder	String	PSUBSTCHEFE.CHAPASUBST, PSUBSTSUP.CHAPASUBST, PCHEFEEXTERNO.CODEXTERNO, PSUPERVEXTERNO.CODEXTERNO
managerName	Nome do líder	String	PPESSOA.NOME
managerFullName	Nome completo do líder	String	PPESSOA.NOME
managerEmail	E-mail do líder	String	PPESSOA.EMAIL
managerDepartmentCode	Código do departamento do líder	String	PSECAO.CODSECAO
managerDepartmentDescription	Descrição do departamento do líder	String	PSECAO.DESCRICAO
managerCostCenterCode	Código do centro de custo do líder	String	PCCUSTO.CODIGO
managerCostCenterDescription	Descrição do centro de custo do líder	String	PFUNC.CODCCUSTO
managerExternal	É externo?	bool	PCHEFEEXTERNO, PSUPERVEXTERNO
employeeBranch	Filial do empregado	String	PFUNC.CODFILIAL
employeeCode	Matrícula do empregado	String	PFUNC.CHAPA
employeeName	Nome do empregado	String	PPESSOA.NOME
employeeFullName	Nome completo do empregado	String	PPESSOA.NOME

Exemplos de requisição e retorno:

Requisição

Retorno

Explicação

http://localhost:8060/rest/rh/v1/employeesManagerDataContent?companyId=T2&branchId=L MG 01

Expandir origem

Retorno dos empregados e respectivos líderes da empresa T2 e filial L MG 01

http://localhost:8060/rest/rh/v1/employeesManagerDataContent?companyId=T2&branchId=L MG 01 &pageSize=6

Expandir origem

Retorno dos empregados e respectivos líderes da empresa T2 e filial L MG 01 , com paginação de 6 registros por página

http://localhost:8060/rest/rh/v1/employeesManagerDataContent?companyId=T2&branchId=L MG 01 &employeeCode=408081

Recolher origem

{
    "hasNext": false,
    "total": 1,
    "items": [
        {
            "managerBranch": "L MG 01 ",
            "managerCode": "408080",
            "managerName": "COORDENADORA",
            "managerFullName": "COORDENADORA",
            "managerEmail": "coordenadora@totvs.com.br",
            "managerDepartmentCode": "999999907",
            "managerDepartmentDescription": "SQUAD",
            "managerCostCenterCode": "1.01.01             ",
            "managerCostCenterDescription": "FOLHA DE PAGAMENTO",
            "employeeBranch": "L MG 01 ",
            "employeeCode": "408081",
            "employeeName": "ANALISTA",
            "employeeFullName": "ANALISTA"
        }
    ]
}

Retorno do empregado e respectivo líder da empresa T2, filial L MG 01 e matrícula 408081

http://localhost:8060/rest/rh/v1/employeesManagerDataContent?companyId=T2&branchId=L MG 01 &employeeCostCenterCode=1.01.01

Expandir origem

Retorno dos empregados e respectivos líderes da empresa T2, filial L MG 01 e centro de custo 1.01.01

Situações de erros tratados:

...

05. ASSUNTOS RELACIONADOS

Não há.

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 12

Nova versão 13

Chave

01. DADOS GERAIS

02. LIBERAÇÃO

03. SITUAÇÃO/REQUISITO

04. SOLUÇÃO

05. ASSUNTOS RELACIONADOS

05. DEMAIS INFORMAÇÕES