Histórico da Página

Gestores - api/rh/v1/DbHrManagers

API responsável por trazer todos os gestores para serem utilizados no filtro do Dashboard RH. Assim será possível realizar filtros dos funcionários separados por gestor ou gestores.

Ativação/Desativação da API

Por padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST.

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância da linha Protheus.

Suporte

O suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs.

Fluxo das Informações

Esta API traz a funcionalidade exclusivamente para consultar todos os gestores cadastrados para serem utilizadas no filtro do Dashboard RH.

Cadastro

Esta API contempla apenas a consulta dos gestores cadastrados.

Processos

O Dashboard RH realizará o consumo da API para buscar todos os gestores.

Como realizar a chamada da API REST

• Preenchimento do EndPoint da API PONAPIDSB;
• Utilizar a chamada do método GET e do Serviço api/rh/v1/DbHrManagers

Saldo Banco de Horas - api/rh/v1/Balance

API responsável por trazer os saldos (Total, Positivo e Negativo) do banco de horas dos funcionários.

Ativação/Desativação da API

Por padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST.

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância da linha Protheus.

Suporte

O suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs.

Fluxo das Informações

Esta API traz a funcionalidade exclusivamente para consultar os saldos (Total, Positivo e Negativo) do banco de horas dos funcionários.

Cadastro

Esta API contempla apenas a consulta dos saldos (Total, Positivo e Negativo) do banco de horas dos funcionários.

Processos

O Dashboard RH realizará o consumo da API para buscar todos os saldos (Total, Positivo e Negativo) do banco de horas dos funcionários.

Como realizar a chamada da API REST

• Preenchimento do EndPoint da API PONAPIDSB(Veriricar nome do fonte posteriormente);
• Utilizar a chamada do método GET e do Serviço api/rh/v1/Balance;

Internamente o Protheus identifica automaticamente o endereço do servidor REST, porém para que isso aconteça será necessário habilitar a porta multiprotocolo do Appserver. Para mais informações sobre a porta multiprotocolo acesse o link abaixo:
https://tdn.totvs.com/x/jIUoI

Formatos de Data

As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD.

Parâmetros de Entrada:

{
	"managers": [
		"GESTOR FINANCEIRO D MG (D MG 01  - 000001)",
		"GESTOR RH M SP (M SP 01  - 000001)",
		"GESTOR TI D MG (D MG 01  - 000002)"
	]
}

Saldo Banco de Horas - api/rh/v1/DbHrBalanceIndicator

API responsável por trazer os saldos (Total, Positivo e Negativo) do Banco de Horas dos funcionários.

Ativação/Desativação da API

Por padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST.

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância da linha Protheus.

Suporte

O suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs.

Fluxo das Informações

Esta API traz a funcionalidade exclusivamente para consultar os saldos (Total, Positivo e Negativo) do Banco de Horas dos funcionários.

Cadastro

Esta API contempla apenas a consulta dos saldos (Total, Positivo e Negativo) do Banco de Horas dos funcionários.

Processos

O Dashboard RH realizará o consumo da API para buscar todos os saldos (Total, Positivo e Negativo) do Banco de Horas dos funcionários.

Como realizar a chamada da API REST

• Preenchimento do EndPoint da API PONAPIDSB (Veriricar nome do fonte posteriormente);
• Utilizar a chamada do método POST e do Serviço api/rh/v1/DbHrBalanceIndicator;

Internamente o Protheus identifica automaticamente o endereço do servidor REST, porém para que isso aconteça será necessário habilitar a porta multiprotocolo do Appserver. Para mais informações sobre a porta multiprotocolo acesse o link abaixo:
https://tdn.totvs.com/x/jIUoI

Formatos de Data

As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD.

Formatos de Hora

O retorno da API refente as horas deverá ser um número real onde as casas decimais são os minutos.
Exemplos:
6.59 = 6 horas e 59 minutos
5.27 = 5 horas e 27 minutos
-4.33 = Menos 4 horas e 33 minutos

Parâmetros de Entrada:

Saldo Banco de Horas - api/rh/v1/BalanceHours

API responsável por trazer os funcionários com horas à vencer ou com horas vencidas.

Ativação/Desativação da API

Por padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST.

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância da linha Protheus.

Suporte

O suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs.

Fluxo das Informações

Esta API traz a funcionalidade exclusivamente para consultar os funcionários com horas à vencer ou com horas vencidas.

Cadastro

Esta API contempla apenas a consulta funcionários com horas à vencer ou com horas vencidas.

Processos

O Dashboard RH realizará o consumo da API para buscar todos os funcionários com horas à vencer ou com horas vencidas.

Como realizar a chamada da API REST

• Preenchimento do EndPoint da API PONAPIDSB(Veriricar nome do fonte posteriormente);
• Utilizar a chamada do método GET e do Serviço api/rh/v1/BalanceHours;

Internamente o Protheus identifica automaticamente o endereço do servidor REST, porém para que isso aconteça será necessário habilitar a porta multiprotocolo do Appserver. Para mais informações sobre a porta multiprotocolo acesse o link abaixo:
https://tdn.totvs.com/x/jIUoI

Formatos de Data

As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD.

Parâmetros de Entrada:

Parâmetros e Chamada do Método:

Para a realização de testes foi utilizado a ferramenta Postman e após a configuração do server protheus a API Rest, a requisição deverá ser semelhante a imagem abaixo:

{protocolo}://{host}:{porta}/{endereço Rest}/api/rh/v1/BalanceHours

Response da API:

{
	"results": [
		{
			"indicatorType": "hoursToExpire",
			"hours": 150.59
		},
		{
			"indicatorType": "expiredHours",
			"hours": 100.47
		}
	]
}

(branch, departament costCenter, manager) vazios:

Caso branch seja enviado para a API [" "], isso significa q o filtro é "todas as filiais".
Caso departament seja enviado para a API [" "], isso significa q o filtro é "todos os departamentos".
Caso costCenter seja enviado para a API [" "], isso significa q o filtro é "todos os centros de custo".
Caso manager seja enviado para a API [" "], isso significa q o filtro é "todos os gestores".

Parâmetros e Chamada do Método:

Para a realização de testes foi utilizado a ferramenta Postman e após a configuração do server Protheus a API Rest, a requisição deverá ser semelhante a imagem abaixo:

{protocolo}://{host}:{porta}/{endereço Rest}/api/rh/v1/DbHrBalanceIndicator

Response da API:

{
	"results": [
		{
			"indicatorType": "CurrentBalance", // Saldo atual do banco de horas.
			"hours": 100.02
		},
		{
			"indicatorType": "balance", // Saldo do período selecionado nos filtros do Dashboard
			"hours": 200.15,
			"totalEmployees": 10
		}, 
		{   
			"indicatorType": "positiveBalance", // Saldo positivo do período selecionado nos filtros do Dashboard
			"hours": 300.45,
			"totalEmployees": 5
		}, 
		{   
			"indicatorType": "negativeBalance", // Saldo negativo do período selecionado nos filtros do Dashboar
			"hours": -100.30,
		 	"totalEmployees": 5
		}
	]
}

Saldo Banco de Horas - api/rh/v1/DbHrHoursIndicator

API responsável por trazer os funcionários com horas à vencer ou com horas vencidas.

Ativação/Desativação da API

Por padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST.

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância da linha Protheus.

Suporte

O suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs.

Fluxo das Informações

Esta API traz a funcionalidade exclusivamente para consultar os funcionários com horas à vencer ou com horas vencidas.

Cadastro

Esta API contempla apenas a consulta funcionários com horas à vencer ou com horas vencidas.

Processos

O Dashboard RH realizará o consumo da API para buscar todos os funcionários com horas à vencer ou com horas vencidas.

Como realizar a chamada da API REST

• Preenchimento do EndPoint da API PONAPIDSB (Veriricar nome do fonte posteriormente);
• Utilizar a chamada do método POST e do Serviço api/rh/v1/DbHrHoursIndicator;

Internamente o Protheus identifica automaticamente o endereço do servidor REST, porém para que isso aconteça será necessário habilitar a porta multiprotocolo do Appserver. Para mais informações sobre a porta multiprotocolo acesse o link abaixo:
https://tdn.totvs.com/x/jIUoI

Formatos de Data

As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD.

Formatos de Hora

O retorno da API refente as horas deverá ser um número real onde as casas decimais são os minutos.
Exemplos:
6.59 = 6 horas e 59 minutos
5.27 = 5 horas e 27 minutos
-4.33 = Menos 4 horas e 33 minutos

Parâmetros de Entrada:

Saldo Banco de Horas - api/rh/v1/DetailsBalance

API responsável por trazer o detalhamento do indicador selecionado (Saldo, Horas Positivas, Horas Negativas, Horas à Vencer e Horas Vencidas).

Ativação/Desativação da API

Por padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST.

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância da linha Protheus.

Suporte

O suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs.

Fluxo das Informações

Esta API traz a funcionalidade exclusivamente para consultar o detalhamento do indicador selecionado (Saldo, Horas Positivas, Horas Negativas, Horas à Vencer e Horas Vencidas).

Cadastro

Esta API contempla apenas a consulta do detalhamento do indicador selecionado (Saldo, Horas Positivas, Horas Negativas, Horas à Vencer e Horas Vencidas).

Processos

O Dashboard RH realizará o consumo da API para buscar o detalhamento do indicador selecionado (Saldo, Horas Positivas, Horas Negativas, Horas à Vencer e Horas Vencidas).

Como realizar a chamada da API REST

• Preenchimento do EndPoint da API PONAPIDSB(Veriricar nome do fonte posteriormente);
• Utilizar a chamada do método GET e do Serviço api/rh/v1/DetailsBalance;

Internamente o Protheus identifica automaticamente o endereço do servidor REST, porém para que isso aconteça será necessário habilitar a porta multiprotocolo do Appserver. Para mais informações sobre a porta multiprotocolo acesse o link abaixo:
https://tdn.totvs.com/x/jIUoI

Formatos de Data

As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD.

Parâmetros de Entrada:

Parâmetros e Chamada do Método:

Para a realização de testes foi utilizado a ferramenta Postman e após a configuração do server protheus a API Rest, a requisição deverá ser semelhante a imagem abaixo:

{protocolo}://{host}:{porta}/{endereço Rest}/api/rh/v1/BalanceHours

Response da API:

(branch, departament costCenter, manager) vazios:

Caso branch seja enviado para a API [" "], isso significa q o filtro é "todas as filiais".
Caso departament seja enviado para a API [" "], isso significa q o filtro é "todos os departamentos".
Caso costCenter seja enviado para a API [" "], isso significa q o filtro é "todos os centros de custo".
Caso manager seja enviado para a API [" "], isso significa q o filtro é "todos os gestores".

Parâmetros e Chamada do Método:

Para a realização de testes foi utilizado a ferramenta Postman e após a configuração do server Protheus a API Rest, a requisição deverá ser semelhante a imagem abaixo:

{protocolo}://{host}:{porta}/{endereço Rest}/api/rh/v1/DbHrHoursIndicator

Response da API:

{
	"results": [
		{
			"indicatorType": "hoursToExpire

{
	"totalPages": 2,
	"rows": [
		{
			"company": "Totvs",
			"branch": "D MG 01",
			"name": "João",
			"registration": "000001",
			"position": "Analisa Desenvolvedor",
			"costCenters": "00000001 - RH",
			"managerhours": "Taka"150.59,
		 	"departmenttotalEmployees": "Desenvolvimento RH"10
		},
		{
			"totalHoursindicatorType": 7"expiredHours",
			"detailshours": [100.47,
				{
					"hours"totalEmployees": 3,5
					"deadLine": "2024-08-15"
				},
				{
					"hours": 2,
					"deadLine": "2024-08-17"
				},
				{
					"hours": 2,
					"deadLine": "2024-08-18"
				}
			]
		},
		{
			"company": "Totvs",
			"branch": "D MG 01",
			"name": "José",
			"registration": "000002",
			"position": "Analisa Desenvolvedor",
			"costCenters": "00000001 - RH",
			"manager": "Taka",
			"department": "Desenvolvimento RH",
			"totalHours": 5.35,
			"details": [
				{
					"hours": 3.15,
					"deadLine": "2024-08-15"
				},
				{
					"hours": 2.2,
					"deadLine": "2024-08-15"
				}
			]
		},
		{
			"company": "Totvs",
			"branch": "M SP 01",
			"name": "Maria",
			"registration": "000001",
			"position": "Analisa Desenvolvedor",
			"costCenters": "00000001 - RH",
			"manager": "Taka",
			"department": "Desenvolvimento RH",
			"totalHours": -5:59,
			"details": [
				{
					"hours": -3.30,
					"deadLine": "2024-08-15"
				},
				{
					"hours": -2.29,
					"deadLine": "2024-08-15"
				}
			]
		}
	]
}]
}

Saldo Banco de Horas - api/rh/v1/DbHrDetailsBalance

API responsável por trazer o detalhamento do indicador selecionado (Saldo, Horas Positivas, Horas Negativas, Horas à Vencer e Horas Vencidas).

Ativação/Desativação da API

Por padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST.

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância da linha Protheus.

Suporte

O suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs.

Fluxo das Informações

Esta API traz a funcionalidade exclusivamente para consultar o detalhamento do indicador selecionado (Saldo, Horas Positivas, Horas Negativas, Horas à Vencer e Horas Vencidas).

Cadastro

Esta API contempla apenas a consulta do detalhamento do indicador selecionado (Saldo, Horas Positivas, Horas Negativas, Horas à Vencer e Horas Vencidas).

Processos

O Dashboard RH realizará o consumo da API para buscar o detalhamento do indicador selecionado (Saldo, Horas Positivas, Horas Negativas, Horas à Vencer e Horas Vencidas).

Como realizar a chamada da API REST

• Preenchimento do EndPoint da API PONAPIDSB (Veriricar nome do fonte posteriormente);
• Utilizar a chamada do método POST e do Serviço api/rh/v1/DbHrDetailsBalance;

Internamente o Protheus identifica automaticamente o endereço do servidor REST, porém para que isso aconteça será necessário habilitar a porta multiprotocolo do Appserver. Para mais informações sobre a porta multiprotocolo acesse o link abaixo:
https://tdn.totvs.com/x/jIUoI

Formatos de Data

As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD.

Formatos de Hora

O retorno da API refente as horas deverá ser um número real onde as casas decimais são os minutos.
Exemplos:
6.59 = 6 horas e 59 minutos
5.27 = 5 horas e 27 minutos
-4.33 = Menos 4 horas e 33 minutos

Parâmetros de Entrada:

Parâmetros (branch, departament costCenter, manager) vazios:

Caso branch seja enviado para a API [" "], isso significa q o filtro é "todas as filiais".
Caso departament seja enviado para a API [" "], isso significa q o filtro é "todos os departamentos".
Caso costCenter seja enviado para a API [" "], isso significa q o filtro é "todos os centros de custo".
Caso manager seja enviado para a API [" "], isso significa q o filtro é "todos os gestores".

Saldo Banco de Horas - api/rh/v1/Charts

API responsável por trazer os dados que serão exibidos nos gráficos (Evolução por Filial, Evolução por Departamento, Evolução por Centro de Custo, Horas por Gestor, Evolução por Gestor).

Ativação/Desativação da API

Por padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST.

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância da linha Protheus.

Suporte

O suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs.

Fluxo das Informações

Esta API traz a funcionalidade exclusivamente para consultar os dados que serão exibidos nos gráficos (Evolução por Filial, Evolução por Departamento, Evolução por Centro de Custo, Horas por Gestor, Evolução por Gestor).

Cadastro

Esta API contempla apenas a consulta dos dados que serão exibidos nos gráficos (Evolução por Filial, Evolução por Departamento, Evolução por Centro de Custo, Horas por Gestor, Evolução por Gestor).

Processos

O Dashboard RH realizará o consumo da API para buscar os dados que serão exibidos nos gráficos (Evolução por Filial, Evolução por Departamento, Evolução por Centro de Custo, Horas por Gestor, Evolução por Gestor).

Como realizar a chamada da API REST

• Preenchimento do EndPoint da API PONAPIDSB(Veriricar nome do fonte posteriormente);
• Utilizar a chamada do método GET e do Serviço api/rh/v1/Charts;

Internamente o Protheus identifica automaticamente o endereço do servidor REST, porém para que isso aconteça será necessário habilitar a porta multiprotocolo do Appserver. Para mais informações sobre a porta multiprotocolo acesse o link abaixo:
https://tdn.totvs.com/x/jIUoI

Formatos de Data

As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD.

Parâmetros de Entrada:

Saldo Banco de Horas - api/rh/v1/DbHrCharts

API responsável por trazer os dados que serão exibidos nos gráficos Evolução por Filial, Evolução por Departamento, Evolução por Centro de Custo, Horas por Gestor e Evolução por Gestor.

Ativação/Desativação da API

Por padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST.

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância da linha Protheus.

Suporte

O suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs.

Fluxo das Informações

Esta API traz a funcionalidade exclusivamente para consultar os dados que serão exibidos nos gráficos Evolução por Filial, Evolução por Departamento, Evolução por Centro de Custo, Horas por Gestor e Evolução por Gestor.

Cadastro

Esta API contempla apenas a consulta dos dados que serão exibidos nos gráficos Evolução por Filial, Evolução por Departamento, Evolução por Centro de Custo, Horas por Gestor e Evolução por Gestor.

Processos

O Dashboard RH realizará o consumo da API para buscar os dados que serão exibidos nos gráficos Evolução por Filial, Evolução por Departamento, Evolução por Centro de Custo, Horas por Gestor e Evolução por Gestor.

Como realizar a chamada da API REST

• Preenchimento do EndPoint da API PONAPIDSB(Veriricar nome do fonte posteriormente);
• Utilizar a chamada do método POST e do Serviço api/rh/v1/DbHrCharts;

Internamente o Protheus identifica automaticamente o endereço do servidor REST, porém para que isso aconteça será necessário habilitar a porta multiprotocolo do Appserver. Para mais informações sobre a porta multiprotocolo acesse o link abaixo:
https://tdn.totvs.com/x/jIUoI

Formatos de Data

As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD.

Formatos de Hora

O retorno da API refente as horas deverá ser um número real onde as casas decimais são os minutos.
Exemplos:
6.59 = 6 horas e 59 minutos
5.27 = 5 horas e 27 minutos
-4.33 = Menos 4 horas e 33 minutos

Destaques do Banco de Horas (Maior Redução e Maior Aumento):

Para realizar o cálculo de maior redução ou aumento deverá ser considerada o volume do banco de horas, por exemplo, um funcionário possui 10 horas positivas no inicio do período e no final do período possui 10 horas negativas. O volume do banco de horas não aumentou e nem diminiu, pois continua sendo as 10 horas, independentemente se é positivo ou negativo. Caso o funcionário possua 10 horas positivas e foi para 9 horas negativas, com isso o funcionário teve uma redução no seu volume de horas de 10 para 9, sendo 10% de diminuição que equivale a 1 hora.

Parâmetros de Entrada:

Parâmetros (branch, departament costCenter, manager) vazios:

Caso branch seja enviado para a API [" "], isso significa q o filtro é "todas as filiais".
Caso departament seja enviado para a API [" "], isso significa q o filtro é "todos os departamentos".
Caso costCenter seja enviado para a API [" "], isso significa q o filtro é "todos os centros de custo".
Caso manager seja enviado para a API [" "], isso significa q o filtro é "todos os gestores".

Parâmetros e Chamada do Método:

Para a realização de testes foi utilizado a ferramenta Postman e após a configuração do server Protheus a API Rest, a requisição deverá ser semelhante a imagem abaixo:

{protocolo}://{host}:{porta}/{endereço Rest}/api/rh/v1/DbHrCharts

Response da API:

{
	"highlights": [
		{
			"highlight": "branches",
			"totalHours": 300,
			"biggestIncrease":
				{
					"data": "",
					"value": 0,
					"hours": 0
				},
			"biggestReduction":
				{
					"data": "",
					"value": 0,
					"hours": 0
				}
		},
		{
			"highlight": "departaments",
			"totalHours": 300,
			"biggestIncrease":
				{
					"data": "Recursos Humanos",
					"value": 60,
					"hours": 100
				},
			"biggestReduction":
				{
					"data": "Financeiro",
					"value": 40,
					"hours": 200
				}
		},
		{
			"highlight": "costCenters",
			"totalHours": 300,
			"biggestIncrease":
				{
					"data": "Desenvolvimento Jornadas",
					"value": 60,
					"hours": 100
				},
			"biggestReduction":
				{
					"data": "Desenvolvimento Rotinas",
					"value": 40,
					"hours": 200
				}
		},
		{
			"highlight": "managers",
			"totalHours": 300,
			"biggestIncrease":
				{
					"data": "Fulano",
					"value": 60,
					"hours": 100
				},
			"biggestReduction":
				{
					"data": "Beltrano",
					"value": 40,
					"hours": 200
				}
		}
	],
	"charts":[
		{
			"chartType": "branches",
			"data":[
				{
					"item": "D MG 01",
					"data": [
						["Jan/2024",367.43],
						["Fev/2024",321],
						["Mar/2024",298],
						["Abr/2024",240]
					]
				},
				{
					"item": "M SP 01",
					"data": [
						["Jan/2024",500],
						["Fev/2024",400],
						["Mar/2024",300],
						["Abr/2024",200]
					]
				}
			]
		},
		{
			"chartType": "departaments",
			"data": [
				{
					"item": "Recursos Humanos",
					"data": [
						["1º Semana",500],
						["2º Semana",400],
						["3º Semana",300],
						["4º Semana",200]
					]
				},
				{
					"item": "Financeiro",
					"data": [
						["1º Semana",500],
						["2º Semana",400],
						["3º Semana",300],
						["4º Semana",200]
					]
				}
			]
		},
		{
			"chartType": "costCenters",
			"data":[
				{
					"item": "Desenvolvimento Jornadas",
					"data": [
						["Jan/2024",500],
						["Fev/2024",400],
						["Mar/2024",300],
						["Abr/2024",200]
					]
				},
				{
					"item": "Desenvolvimento Rotinas",
					"data": [
						["Jan/2024",500],
						["Fev/2024",400],
						["Mar/2024",300],
						["Abr/2024",200]
					]
				}
			]
		},
		{
			"chartType": "managersPieChart",
			"data":[
				{
					"manager": "Fulano",
					"hours": 105.15
				},
				{
					"manager": "Fulano",
					"hours": -50.30
				}
			]
		},
		{
			"chartType": "managers",
			"data": [
				{
					"item": "Fulano",
					"data": [
						["Jan/2024",500],
						["Fev/2024",400],
						["Mar/2024",300],
						["Abr/2024",200]
					]
				},
				{
					"item": "Beltrano",
					"data": [
						["Jan/2024",500],
						["Fev/2024",400],
						["Mar/2024",300],
						["Abr/2024",200]
					]
				}
			]
		}
	]
}

Saldo Banco de Horas - api/rh/v1/DbHrDetailsCharts

API responsável por trazer o detalhamento dos gráficos Evolução por Filial, Evolução por Departamento e Evolução por Centro de Custo.

Ativação/Desativação da API

Por padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST.

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância da linha Protheus.

Suporte

O suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs.

Fluxo das Informações

Esta API traz a funcionalidade exclusivamente para consultar o detalhamento dos gráficos Evolução por Filial, Evolução por Departamento e Evolução por Centro de Custo.

Cadastro

Esta API contempla apenas a consulta o detalhamento dos gráficos Evolução por Filial, Evolução por Departamento e Evolução por Centro de Custo.

Processos

O Dashboard RH realizará o consumo da API para buscar o detalhamento dos gráficos Evolução por Filial, Evolução por Departamento e Evolução por Centro de Custo.

Como realizar a chamada da API REST

• Preenchimento do EndPoint da API PONAPIDSB(Veriricar nome do fonte posteriormente);
• Utilizar a chamada do método POST e do Serviço api/rh/v1/DbHrDetailsCharts;

Internamente o Protheus identifica automaticamente o endereço do servidor REST, porém para que isso aconteça será necessário habilitar a porta multiprotocolo do Appserver. Para mais informações sobre a porta multiprotocolo acesse o link abaixo:
https://tdn.totvs.com/x/jIUoI

Formatos de Data

As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD.

Formatos de Hora

O retorno da API refente as horas deverá ser um número real onde as casas decimais são os minutos.
Exemplos:
6.59 = 6 horas e 59 minutos
5.27 = 5 horas e 27 minutos
-4.33 = Menos 4 horas e 33 minutos

Parâmetros de Entrada:

Parâmetros (branch, departament costCenter, manager) vazios:

Caso branch seja enviado para a API [" "], isso significa q o filtro é "todas as filiais".
Caso departament seja enviado para a API [" "], isso significa q o filtro é "todos os departamentos".
Caso costCenter seja enviado para a API [" "], isso significa q o filtro é "todos os centros de custo".
Caso manager seja enviado para a API [" "], isso significa q o filtro é "todos os gestores".

Parâmetros e Chamada do Método:

Para a realização de testes foi utilizado a ferramenta Postman e após a configuração do server Protheus a API Rest, a requisição deverá ser semelhante a imagem abaixo:

{protocolo}://{host}:{porta}/{endereço Rest}/api/rh/v1/DbHrDetailsCharts

Response da API:

{
	"totalPages": 2
	"rows": [
		{
			"company": "TOTVS SA",
			"data": "D MG 01", (A propiedade data será a descrição da Filial, Departamento ou Centro de Custo, por exemplo "data": "D MG 01" ou "data": "Recursos Humanos" ou "data": "Desenvolvimento Jornadas")
			"totalBalance": [
				["Jan/2024",9],
				["Fev/2024",10,3],
				["Mar/2024",20,59],
				["Abr/2024",-10,30]
			],
			"details": [
				{
					"employeeName": "Marco",
					"balance": [
						["Jan/2024",4.3],
						["Fev/2024",5.15],
						["Mar/2024",10.29],
						["Abr/2024",-5.15]
					]
				},
				{
					"employeeName: "Cicero",
					"balance: [
						["Jan/2024",4.3],
						["Fev/2024",5.15],
						["Mar/2024",10.30],
						["Abr/2024",-5.15]
					]
				}
			]
		},
		{
			"company": "TOTVS SA",    
			"data": "M SP 01", (A propiedade data será a descrição da Filial, Departamento ou Centro de Custo, por exemplo "data": "M SP 01" ou "data": "Recursos Humanos" ou "data": "Desenvolvimento Jornadas")
			"totalBalance": [
				["Jan/2024",9],
				["Fev/2024",10,3],
				["Mar/2024",20,59],
				["Abr/2024",-10,30]
			],
			"details": [
				{
					"employeeName": "Lourdes"
					"balance": [
						["Jan/2024",4.3],
						["Fev/2024",5.15],
						["Mar/2024",10.29],
						["Abr/2024",-5.15]
					]
				},
				{
					"employeeName": "Cleber"
					"balance": [
						["Jan/2024",4.3],
						["Fev/2024",5.15],
						["Mar/2024",10.30],
						["Abr/2024",-5.15]
					]
				}
			]
		}
	]
}

Saldo Banco de Horas - api/rh/v1/DbHrDetailsManagersCharts

API responsável por trazer o detalhamento dos gráficos Horas por Gestor e Evolução por Gestor.

Ativação/Desativação da API

Por padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST.

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância da linha Protheus.

Suporte

O suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs.

Fluxo das Informações

Esta API traz a funcionalidade exclusivamente para consultar o detalhamento dos gráficos Horas por Gestor e Evolução por Gestor.

Cadastro

Esta API contempla apenas a consulta o detalhamento dos gráficos Horas por Gestor e Evolução por Gestor.

Processos

O Dashboard RH realizará o consumo da API para buscar o detalhamento dos gráficos Horas por Gestor e Evolução por Gestor.

Como realizar a chamada da API REST

• Preenchimento do EndPoint da API PONAPIDSB (Veriricar nome do fonte posteriormente);
• Utilizar a chamada do método POST e do Serviço api/rh/v1/DbHrDetailsManagersCharts;

Internamente o Protheus identifica automaticamente o endereço do servidor REST, porém para que isso aconteça será necessário habilitar a porta multiprotocolo do Appserver. Para mais informações sobre a porta multiprotocolo acesse o link abaixo:
https://tdn.totvs.com/x/jIUoI

Formatos de Data

As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD.

Formatos de Hora

O retorno da API refente as horas deverá ser um número real onde as casas decimais são os minutos.
Exemplos:
6.59 = 6 horas e 59 minutos
5.27 = 5 horas e 27 minutos
-4.33 = Menos 4 horas e 33 minutos

Parâmetros de Entrada:

Parâmetros (branch, departament costCenter, manager) vazios:

Caso branch seja enviado para a API [" "], isso significa q o filtro é "todas as filiais".
Caso departament seja enviado para a API [" "], isso significa q o filtro é "todos os departamentos".
Caso costCenter seja enviado para a API [" "], isso significa q o filtro é "todos os centros de custo".
Caso manager seja enviado para a API [" "], isso significa q o filtro é "todos os gestores".

Parâmetros e Chamada do Método:

Para a realização de testes foi utilizado a ferramenta Postman e após a configuração do server Protheus a API Rest, a requisição deverá ser semelhante a imagem abaixo:

{protocolo}://{host}:{porta}/{endereço Rest}/api/rh/v1/DbHrDetailsManagersCharts

Response da API:

Saldo Banco de Horas - api/rh/v1/DetailsCharts

API responsável por trazer o detalhamento do gráfico selecionado (Evolução por Filial, Evolução por Departamento, Evolução por Centro de Custo, Horas por Gestor, Evolução por Gestor).

Ativação/Desativação da API

Por padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST.

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância da linha Protheus.

Suporte

O suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs.

Fluxo das Informações

Esta API traz a funcionalidade exclusivamente para consultar o detalhamento do gráfico selecionado (Evolução por Filial, Evolução por Departamento, Evolução por Centro de Custo, Horas por Gestor, Evolução por Gestor).

Cadastro

Esta API contempla apenas a consulta o detalhamento do gráfico selecionado (Evolução por Filial, Evolução por Departamento, Evolução por Centro de Custo, Horas por Gestor, Evolução por Gestor).

Processos

O Dashboard RH realizará o consumo da API para buscar o detalhamento do gráfico selecionado (Evolução por Filial, Evolução por Departamento, Evolução por Centro de Custo, Horas por Gestor, Evolução por Gestor).

Como realizar a chamada da API REST

• Preenchimento do EndPoint da API PONAPIDSB(Veriricar nome do fonte posteriormente);
• Utilizar a chamada do método GET e do Serviço api/rh/v1/DetailsCharts;

Internamente o Protheus identifica automaticamente o endereço do servidor REST, porém para que isso aconteça será necessário habilitar a porta multiprotocolo do Appserver. Para mais informações sobre a porta multiprotocolo acesse o link abaixo:
https://tdn.totvs.com/x/jIUoI

Formatos de Data

As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD.

Parâmetros de Entrada: