Totvs custom tabs box items |
---|
default | yes |
---|
referencia | filiais |
---|
| Filiais - api/rh/v1/HrBranches API responsável por trazer todas as filiais para serem utilizadas no filtro do Dashboard RH. Assim será possível ter uma visão macro da empresa ou apenas de uma filial em específico. Ativação/Desativação da APIPor padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST. Controle de AmbienteExige que os seguintes pontos sejam revisados: - Protheus com sua arquitetura devidamente estruturada.
Controle de VersãoO 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. SuporteO suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs. Esta API traz a funcionalidade exclusivamente para consultar todas as filiais cadastradas para serem utilizadas no filtro do Dashboard RH. CadastroEsta API contempla apenas a consulta das filiais cadastradas. ProcessosO Dashboard RH realizará o consumo da API para buscar todas as filiais. 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/HrBranches;
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 Por ser uma API que retorna todas as filiais, não existe qualquer parâmetro que precisa ser enviado.
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/HrBranches Response da API: Application/json { "Branches": [ "D MG 01 ", "D MG 02 ", "D RJ 01 ", "D RJ 02 ", "M PR 01 ", "M PR 02 ", "M SP 01 ", "M SP 02 ", "M SP 03 " ] }
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | totalfunc |
---|
| Total de Funcionários - api/rh/v1/DashbHrTotalEmployees API responsável por retornar apenas os funcionários que utilizam o ponto eletrônico, que não foram demitidos antes do período selecionado ou os funcionários demitidos dentro do período selecionado. Ativação/Desativação da APIPor padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST. Controle de AmbienteExige que os seguintes pontos sejam revisados: - Protheus com sua arquitetura devidamente estruturada.
Controle de VersãoO 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. SuporteO suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs. Esta API traz a funcionalidade exclusivamente para trazer o total de funcionários que utilizam o ponto eletrônico, que não foram demitidos antes do período selecionado ou os funcionários demitidos dentro do período selecionado. CadastroEsta API contempla apenas a consulta do cadastro de funcionários. ProcessosO Dashboard RH realizará o consumo da API para buscar e exibir a quantidade total de funcionários que utilizam o ponto eletrônico. 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/DashbHrTotalEmployees;
- Preenchimento dos parâmetros obrigatórios da API;
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 As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD
Parâmetros de Entrada: Parâmetro | Valor de Exemplo | Obrigatório | Tipo | Parâmetro | Descrição |
---|
startDate | 2022-06-01 | Sim | Date | Query | Data inicial do período | endDate | 2022-06-30 | Sim | Date | Query | Data final do período | filial | D MG 01 ou todas | Sim | String | Query | Filtro da filial | accept | application/json | Sim | String | Header |
| content-type | application/json | Sim | String | Header |
|
Image RemovedImage Added 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/DashbHrTotalEmployees Response da API: Application/json { "TotalEmployees": 3 }
Situações de Erros TratadosO envio de dados inesperados nos parâmetros de entrada da API REST pode ocasionar alguns erros. Desta forma, foram criados alguns tratamentos de erros listados abaixo, cada um com sua respectiva mensagem e solução. Mensagens de Pré-ValidaçãoCódigo | Erro | Detalhe |
---|
400 | "Parâmetros inválidos: Verifique se os parâmetros startDate, endDate e filial foram enviados." |
|
|
Totvs custom tabs box items |
---|
| Ponto Completo e Incompleto - api/rh/v1/DashbHrAttendanceControl API responsável por retornar o total de funcionários, funcionários com o ponto completo, incompleto e incompletosem marcações, que não foram demitidos antes do período selecionado ou os funcionários demitidos dentro do período selecionado. Basicamente esta API irá verificar a quantidade de marcações realizadas no período pelo funcionário e irá validar com a quantidade em que o funcionário deveria realizar de acordo com o seu turno. Por exemplo um funcionário precisa realizar a marcação do ponto 4 vezes ao dia (entrada jornada, saída para o almoço, volta do almoço e saída da jornada). Na semana o funcionário trabalha de segunda à sexta, então teremos 5 dias trabalhados, onde cada dia o funcionário precisa bater o ponto 4 vezes, totalizando 20 marcações na semana. Se o funcionário possuir 20 ou mais marcações o sistema irá contabilizar como ponto completo, caso o funcionário tenha menos de 20 marcações na semana, será considerado como ponto incompleto.
Observação: Para contabilizar se o funcionário está com o ponto completo ou incompleto foi desconsiderado o O dia da demissão , por exemplo a demissão de um funcionário ocorreu no dia 31/05/2022, para a API o dia 31/05/2022 em diante será desconsiderado para a verificação do ponto, ou seja, apenas os dias anteriores a demissão serão considerados para verificar se o ponto do funcionário está completou ou incompletodo funcionário contará como dia trabalhado, caso o funcionário seja demitido no dia 19/08/2022 e o filtro do período é de 01/08/2022 à 19/08/2022, a quantidade de marcações do dia 19/08/2022 será contabilizado normalmente. Ativação/Desativação da APIPor padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST. Controle de AmbienteExige que os seguintes pontos sejam revisados: - Protheus com sua arquitetura devidamente estruturada.
Controle de VersãoO 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. SuporteO suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs. Esta API traz a funcionalidade exclusivamente para trazer o total de funcionários, funcionários que estão com o ponto completo e o total de funcionários com o ponto incompleto. CadastroEsta API contempla as consultas do cadastro de funcionários, turnos, tabela de horário padrão e marcações realizadas pelo funcionários. ProcessosO Dashboard RH realizará o consumo da API para buscar e exibir a quantidade total de funcionários com o ponto completo e incompleto. 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/DashbHrAttendanceControl;
- Preenchimento dos parâmetros obrigatórios da API;
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 As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD
Parâmetros de Entrada: | Parâmetro | Valor de Exemplo | Obrigatório | Tipo | Parâmetro | Descrição |
---|
startDate | 2022-06-01 | Sim | Date | Query | Data inicial do período | endDate | 2022-06-30 | Sim | Date | Query | Data final do período | filial | D MG 01 ou todas | Sim | String | Query | Filtro da filial | accept | application/json | Sim | String | Header | content-type | application/json | Sim | String | Header | Image Removed 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/DashbHrAttendanceControl Response da API: Application/json { "ClockMarkingsComplete": 1, "ClockMarkingsIncomplete": 1 } Image Removed Situações de Erros TratadosO envio de dados inesperados nos parâmetros de entrada da API REST pode ocasionar alguns erros. Desta forma, foram criados alguns tratamentos de erros listados abaixo, cada um com sua respectiva mensagem e solução. Mensagens de Pré-ValidaçãoCódigo | Erro | Detalhe |
---|
400 | "Parâmetros inválidos: Verifique se os parâmetros startDate, endDate e filial foram enviados." | Totvs custom tabs box items |
---|
default | no |
---|
referencia | semmarc |
---|
| Funcionário sem Marcações - api/rh/v1/DashbHrWithoutMarkings API responsável por retornar o total de funcionários que não possuem uma única marcação, que não foram demitidos antes do período selecionado ou os funcionários demitidos dentro do período selecionado. Se o funcionário possui apenas 1 marcação no período o mesmo será contabilizado como ponto incompleto. Ativação/Desativação da APIPor padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST. Controle de AmbienteExige que os seguintes pontos sejam revisados: - Protheus com sua arquitetura devidamente estruturada.
Controle de VersãoO 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. SuporteO suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs. Esta API traz a funcionalidade exclusivamente para trazer o total de funcionários que não possuem uma única marcação., incompleto e sem marcações CadastroEsta API contempla as consultas do cadastro de funcionários, turnos, tabela de horário padrão e marcações realizadas pelo funcionários. ProcessosO Dashboard RH realizará o consumo da API para buscar e exibir a quantidade total de funcionários que não possuem marcações., funcionários que estão com o ponto completo, incompleto e sem marcações 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/DashbHrWithoutMarkingsDashbHrAttendanceControl;
- Preenchimento dos parâmetros obrigatórios da API;
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 As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD
Parâmetros de Entrada: Parâmetro | Valor de Exemplo | Obrigatório | Tipo | Parâmetro | Descrição |
---|
startDate | 2022-0608-0116 | Sim | Date | Query | Data inicial do período | endDate | 2022-0608-3017 | Sim | Date | Query | Data final do período | filial | D MG 01 ou todas | Sim | String | Query | Filtro da filial | accept | application/json | Sim | String | Header |
| content-type | application/json | Sim | String | Header |
|
Image RemovedImage Added 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/DashbHrWithoutMarkingsDashbHrAttendanceControl Response da API: Application/json {
"TotalEmployees": 5, "ClockMarkingsComplete": 3, "ClockMarkingsIncomplete": 1, "WithoutClockMarkings": 1 } Image RemovedImage Added Situações de Erros TratadosO envio de dados inesperados nos parâmetros de entrada da API REST pode ocasionar alguns erros. Desta forma, foram criados alguns tratamentos de erros listados abaixo, cada um com sua respectiva mensagem e solução. Mensagens de Pré-ValidaçãoCódigo | Erro | Detalhe |
---|
400 | "Parâmetros inválidos: Verifique se os parâmetros startDate, endDate e filial foram enviados." |
|
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | clockin |
---|
| Integrações Clock In - api/rh/v1/DashbHrClockin API responsável por retornar o total de marcações no Clock In, total de marcações integradas, total de marcações a serem integradas e o total de marcações sem NSR gerada. Ativação/Desativação da APIPor padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST. Controle de AmbienteExige que os seguintes pontos sejam revisados: - Protheus com sua arquitetura devidamente estruturada.
Controle de VersãoO 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. SuporteO suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs. Esta API traz a funcionalidade exclusivamente para trazer o total de funcionários que estão com o ponto completo e o total de funcionários com o ponto incompleto. CadastroEsta API contempla as consultas de marcações do Clock In e marcações integradas com o ERP. ProcessosO Dashboard RH realizará o consumo da API para buscar e exibir a quantidade total de marcações no Clock In, total de marcações integradas, total de marcações a serem integradas e o total de marcações sem NSR gerada. 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/DashbHrClockin;
- Preenchimento dos parâmetros obrigatórios da API;
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 As Entradas de dados tipo data(Date) acompanham o formato padrão YYYY-MM-DD
Parâmetros de Entrada: Parâmetro | Valor de Exemplo | Obrigatório | Tipo | Parâmetro | Descrição |
---|
startDate | 2022-06-01 | Sim | Date | Query | Data inicial do período | endDate | 2022-06-30 | Sim | Date | Query | Data final do período | filial | D MG 01 ou todas | Sim | String | Query | Filtro da filial | accept | application/json | Sim | String | Header |
| content-type | application/json | Sim | String | Header |
|
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/DashbHrClockin Response da API: Application/json { "TotalWhitoutNSR": 1, "TotalClockMarkings": 3, "TotalIntegrated": 2, "TotalToBeIntegrated": 0 }
Situações de Erros TratadosO envio de dados inesperados nos parâmetros de entrada da API REST pode ocasionar alguns erros. Desta forma, foram criados alguns tratamentos de erros listados abaixo, cada um com sua respectiva mensagem e solução. Mensagens de Pré-ValidaçãoCódigo | Erro | Detalhe |
---|
400 | "Parâmetros inválidos: Verifique se os parâmetros startDate, endDate e filial foram enviados." |
|
|
Totvs custom tabs box items |
---|
| Integrações Clock In - api/rh/v1/DashbHrClockin API responsável por enviar um e-mail com as informações do dashboard. Ativação/Desativação da APIPor padrão esta API estará no sistema, porém será necessário realizar a devida configuração do serviço REST. Controle de AmbienteExige que os seguintes pontos sejam revisados: - Protheus com sua arquitetura devidamente estruturada.
Controle de VersãoO 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. SuporteO suporte aos recursos da API será de responsabilidade da linha Protheus onde será analisada pela equipe de suporte da Totvs. Esta API traz a funcionalidade exclusivamente para enviar as informações exibidas no Dashboard por e-mail, gerando uma imagem do Dashboard e anexando no e-mail a ser enviado. CadastroEsta API contempla os resultados das informações exibidas no Dashboard, no caso o resultado das APIs anteriores. ProcessosO Dashboard RH realizará o consumo da API para enviar um e-mail, contendo uma imagem do Dashboard anexa. Como realizar a chamada da API REST- Preenchimento do EndPoint da API PONAPIDSB;
- Utilizar a chamada do método Post e do Serviço api/rh/v1/HrDashbEmail;
- Preenchimento dos parâmetros obrigatórios da API;
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 A Entrada de dado tipo string será um arquivo convertido para a base 64.
A string contendo o arquivo convertido na base 64 deverá ser enviado no body da requisição, conforme o exemplo demonstrado usando o Postman. Parâmetros de Entrada: Parâmetro | Valor de Exemplo | Obrigatório | Tipo | Parâmetro | Descrição |
---|
blob64 | "iVBORw0KGgoAAAANSUh..." | Sim | String | Query | Arquivo convertido para a base 64. | accept | application/json | Sim | String | Header |
| content-type | application/json | Sim | String | Header |
|
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/HrDashbEmail Response da API: Application/json { "Response": "E-mail enviado com sucesso." }
Situações de Erros TratadosO envio de dado inesperado no parâmetro de entrada da API REST pode ocasionar alguns erros. Desta forma, foram criados alguns tratamentos de erros listados abaixo, cada um com sua respectiva mensagem e solução. Mensagens de Pré-ValidaçãoCódigo | Erro | Detalhe |
---|
400 | "Falha no envio do e-mail, verifique as configurações do sistema para o envio de e-mails." |
| 401 | "A imagem do Dashboard não foi enviada." |
|
|
|