Linha RM

Atalhos

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

1. DADOS GERAIS

Produto:

RM

Linha de Produto:

Linha RM

Segmento:

RH

Módulo:TOTVS Folha de Pagamento 
Função:Integração Folha x 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.115 e superiores

03. SITUAÇÃO/REQUISITO

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

04. SOLUÇÃO

Foi implementada na API EmployeeDataContentController 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)NãoString
employeePositionCodeCargo do funcionário (PFUNC.CODFUNCAO => PCARGO.CODIGO)NãoString
costCenterCodeCentro 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

As propriedades do json podem ser encontradas  no link API.


Situações de erros tratados:

Código do statusMensagemSolução
400O parâmetro product é obrigatório.Preencher o parâmetro product.
400O parâmetro companyId é obrigatório.Preencher o parâmetro 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

Integração Afferolab.postman_collection.json

05. DEMAIS INFORMAÇÕES



  • Sem rótulos