Linha RM

Atalhos

Páginas filhas
  • DT - Integração Folha x Afferolab - Implementar filtro de Cargo, Departamento e Centro de Custo

Versões comparadas

Versão antiga 2

changes.mady.by.user Silvana Maria Pessoa de Melo

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Scarlet Gabriella Alves de Macedo

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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
Afferolab - Implementar filtro de Cargo, Departamento e Centro de Custo
País:Brasil
Issue:DRHROTRM-14184 | DRHROTRM-15797

02. LIBERAÇÃO

  Lembrando que, será a partir dos patches:

  • 12.1.2502.232
  • 12.1.2506.181
  • 12.1.2510.xxx 115 e superiores

03. SITUAÇÃO/REQUISITO

...

Disponibilizar filtros opcionais por departamento, cargo e centro de custo na API de integração entre a Folha de Pagamento e o LMS+LXP , para permitir by Afferolab permitindo o controle de quais funcionário devem ser integrados.

 Inicialmente os filtros deverão possibilitar combinações abaixo:

.

...


...


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.

implementada na APIEmployeeDataContentController a opção de filtrar por departamento, cargo e/ou centro de custo do funcionário.


A API receberá os

...

seguintes query params:

Query Param

DescriçãoObrigatório           Tipo               
departmentCodeDepartamento do funcionário (PFUNC.CODSECAO => PSECAO.CODDEPARTAMENTO)
companyIdCódigo do grupo de empresas para filtroSimStringbranchIdCódigo da filial do empregado para filtroSimStringpagePágina que está sendo requisitadaNãoIntegerpageSizeQuantidade de registros por páginaNãoIntegeremployeeCodeCódigo da matrícula do empregado para filtro
NãoString
employeeCostCenterCode
employeePositionCode
Código do centro de custo do(s) empregado(s) para filtro
Cargo do funcionário (PFUNC.CODFUNCAO => PCARGO.CODIGO)NãoString
managerCreationStartDate
costCenterCode
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)

managerCreationEndDateData fim de pesquisa conforme a vinculação do chefe na estruturaNão

string

formato (aaaa-mm-dd)

Centro de custo (PFUNC.NROCENCUSTOCONT=> PSECAO.NROCENCUSTOCONT)NãoString



A API retornará as seguintes propriedades:

Propriedade  DescriçãoTipo
hasNextIndica se há registros na próxima páginaBoolean
totalIndica o total de registros retornadosInteger
itemsLista dos líderes direto dos empregadosArray

Contém as seguintes propriedades:

...

As propriedades do json podem ser encontradas  no link API.


Situações de erros tratados:

Código do statusMensagemSolução
400O parâmetro product

Situações de erros tratados:

400O parâmetro companyId
é obrigatório.Preencher o parâmetro
companyId
product.
400O parâmetro
branchId
companyId é obrigatório.Preencher o parâmetro
branchId
companyId.



Situações de erros inesperados:

Código do statusMensagem
500Ocorreu uma falha no retorno da informação.



Múltiplos Filtros

É possível realizar filtros múltiplos na API via oData, combinando várias condições com os operadores lógicos.

Por exemplo: {{baseURL}} /api/rh/v1/employeeDataContent?product=RM&companyId=1&$filter=( (roleCode eq '00017') and (sectionCode eq '02.01' or sectionCode eq '01.08') )

Esse filtro retorna os funcionários da função 00017 que estão alocados nas seções 02.01 ou 01.08. Todos os critérios devem ser combinados em um único $filter para evitar erros de sintaxe.



Exemplo – Postman

View file
nameIntegração Afferolab.postman_collection.json
height250


05. DEMAIS INFORMAÇÕES

...