Páginas filhas
  • DT - Integração RM X Quírons - API para retornar a lista dos subordinados diretos do líder

Versões comparadas

Chave

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

...

A API receberá os seguintes query params:

Query Param

Descrição

Obrigatório

Tipo

Valor padrão

Valor de exemplo

companyIdCódigo do grupo de empresas para filtroSimString

branchIdCódigo da filial do empregado para filtroSimString

pagePágina que está sendo requisitadaNãoInteger

pageSizeQuantidade de registros por páginaNãoInteger

employeeCodeCódigo da matrícula do empregado para filtroNãoString

employeeCostCenterCodeCódigo do centro de custo do(s) empregado(s) para filtroNãoString




visionCodeCódigo da visão contendo a estrutura hierárquica quando utilizado o parâmetro MV_ORGCFG com 1 ou 2NãoString





A API retornará as seguintes propriedades:

Propriedade

Descrição

Tipo

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


A propriedade items contém as seguintes propriedades:

Propriedade

Descrição

Tipo

Origem do valor

managerBranchFilial do líderString
RA_FILIAL
PSECAO.CODFILIAL
managerCodeMatrícula do líderString
RA_MAT
PSUBSTCHEFE.CHAPASUBST, PSUBSTSUP.CHAPASUBST, PCHEFEEXTERNO.CODEXTERNO, PSUPERVEXTERNO.CODEXTERNO
managerNameNome do líderString
RA_
PPESSOA.NOME
managerFullNameNome completo do líderString
RA_NOMECMP
PPESSOA.NOME
managerEmailE-mail do líderString
RA_
PPESSOA.EMAIL
managerDepartmentCodeCódigo do departamento do líderString
RA_DEPTO
PSECAO.CODSECAO
managerDepartmentDescriptionDescrição do departamento do líderString
QB_DESCRIC
PSECAO.DESCRICAO
managerCostCenterCodeCódigo do centro de custo do líderStringRA_CC
managerCostCenterDescriptionDescrição do centro de custo do líderString
CTT_DESC01
PFUNC.CODCCUSTO
employeeBranchFilial do empregadoString
RA_FILIAL
PFUNC.CODFILIAL
employeeCodeMatrícula do empregadoString
RA_MAT
PFUNC.CHAPA
employeeNameNome do empregadoString
RA_
PPESSOA.NOME
employeeFullNameNome completo do empregadoString
RA_NOMECMP
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:

Código do status

Mensagem

Solução

400O parâmetro companyId é obrigatório.Preencher o parâmetro companyId.
400O parâmetro branchId é obrigatório.Preencher o parâmetro branchId.
400Nenhum registro localizado.Revisar os parâmetros enviados.


Situações de erros inesperados:

Código do status

Mensagem

500Ocorreu uma falha no retorno da informação.




04. DEMAIS INFORMAÇÕES

Exemplo de configuração do REST.


05. ASSUNTOS RELACIONADOS

...