Histórico da Página
1. DADOS GERAIS
| Produto: | RM |
|---|---|
| Linha de Produto: | Linha RM |
| Segmento: | RH |
| Módulo: | TOTVS Folha de Pagamento |
| Função: | Integração Folha x LMS+LXP by Afferolab |
| País: | Brasil |
| Issue: | DRHROTRM-14184 |
02. LIBERAÇÃO
Lembrando que, será a partir dos patches:
- 12.1.2502.
- 12.1.2506.
- 12.1.2510.xxx e superiores
03. SITUAÇÃO/REQUISITO
Disponibilizar filtros opcionais na API de integração entre a Folha de Pagamento e o LMS+LXP, para permitir o controle de quais funcionário devem ser integrados.
Inicialmente os filtros deverão possibilitar combinações abaixo:
- Por Departamento = PFUNC.CODSECAO => PSECAO.CODDEPARTAMENTO
- Por Seção = PFUNC.CODSECAO
- Por Cargo = PFUNC.CODFUNCAO => PCARGO.CODIGO
- Por Função = PFUNC.CODFUNCAO
04. SOLUÇÃO
Foi ajustada a API EmployeesManagerDataContent para retornar apenas os chefes cujo campo RECCREATEDON seja maior ou igual à data fornecida na requisição.
Isso garantirá que sejam utilizados filtros para controlar quais funcionarios seram integrados.
A API receberá os seguintes query params:
| 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 |
| managerCreationStartDate | Data início de pesquisa conforme a vinculação do chefe na estrutura (PSUBSTECHEFE.RECCREATEDON e PCHEFEEXTERNO.RECCREATEDON) | Não | string formato (aaaa-mm-dd) |
| managerCreationEndDate | Data fim de pesquisa conforme a vinculação do chefe na estrutura | Não | string formato (aaaa-mm-dd) |
A API retornará as seguintes propriedades:
| 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 |
Contém as seguintes propriedades:
| 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 |
Situações de erros tratados:
| 400 | O parâmetro companyId é obrigatório. | Preencher o parâmetro companyId. |
| 400 | O parâmetro branchId é obrigatório. | Preencher o parâmetro branchId. |
Situações de erros inesperados:
| 500 | Ocorreu uma falha no retorno da informação. |
05. DEMAIS INFORMAÇÕES
Exemplo de configuração do REST.