• qua, 03/06/2024 - 17:19
  • /gabriel.kresin@...

(GET) employeejourney/queries/getCostCenter

https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/hcm/employeejourney/queries/getCostCenter

Um "CostCenter", para o HCM, é uma entidade que representa as informações de Centro de Custo cadastradas - mesmo sem colaboradores vinculados. Algumas dessas informações são ID, nome, data de criação, código, descrição do código, data de expiração e empresa.

Esse endpoint é utilizado para obter as informações dos Centros de Custos cadastrados na base do HCM. Todos os endpoints do serviço da jornada do colaborador só podem ser acessados por usuários ou aplicações com o permissionamento correto e possuem um limite máximo de 100 itens por página de retorno. Campos não preenchidos não são retornados.

O payload de cada Centros de Custo consiste de:

{ "totalPages": "Número total de páginas", "totalElements": "Número total de centro de custos encontrados", "contents": [ { "id": "id centro de custo", "name": "nome", "codccu": "codigo do centro de custo", "creationDate": "data de criação", "company": { "id": "id Compania", "numemp": Número da compania, "tradingName": "Nome Comercial", "companyName": "Nome Compania", "cnpj": "CNPJ" },... ] }

Uso dos filtros:

É possível filtrar os resultados seguindo estas diretivas.

Casos de uso:

  • Buscar todos os centros de custo cadastrados no sistema:

    .../queries/getCostCenter

  • Buscar todos os centros de custo que possuem uma empresa cadastrada:

    .../getCostCenter?filter=company.id is not null

  • Buscar os centros de custo que possuem empresa com um determinado nome comercial:

    .../getCostCenter?filter=company.tradingName='Nome Comercial'

  • Buscar centros de custo pelo nome:

    .../getCostCenter?filter=name='Nome Centro de custo'

  • Buscar centros de custo pelo código:

    .../getCostCenter?filter=codccu='codigo'

  • Buscar todos os centros de custo com determinado nome usando containing:

    .../getCostCenter?filter=containing(name, 'nome departamento')

  • Filtrando centros de custo por quantidade de retorno por página, usando ordenação:

    .../getCostCenter?size=6&offset=0&orderby=name