Recursos humanos

Fichas, contratos, assiduidade e o processamento de salários.

O processamento é seguro de repetir: apaga os recibos e volta a calcular tudo. Fechar é que é definitivo, e a partir daí só por retificação. Desligar alguém não apaga a ficha, porque a folha dos meses passados tem de continuar a fazer sentido: o que se fecha é a conta de acesso.

O que a licença destranca#

Este módulo exige a funcionalidade rh na licença. Sem ela, as rotas dele respondem 403 e o menu não o mostra.

Aproveita: comercial, contabilidade, tesouraria. Sem eles funciona, e faz menos.

O que se consegue ver a acontecer#

• Um registo de ponto por pessoa e por dia, e o segundo corrige o primeiro
• Uma falta justifica-se com documento, e a justificação aprova-se ou rejeita-se
• A folha do mês processa-se, e o recibo sai em PDF por pessoa
• O IRT e a Segurança Social calculam-se pelas tabelas angolanas
• Quem trabalha por escala é medido contra o turno dele, e não contra as oito horas de um escritório: quem entra às 14:00 não é acusado de atraso
• Um acidente de trabalho regista-se, os dias perdidos entram na assiduidade sem serem falta injustificada, e o mapa anual sai sozinho
• O leitor de impressão digital marca a entrada e a saída sozinho, e o dedo fica guardado cifrado: quem não o tiver registado marca pelos outros meios, e o leitor em baixo não impede ninguém de trabalhar

Os 89 endpoints#

Saem da árvore de rotas montada, que é a mesma que serve os pedidos. A referência completa, com corpos e respostas, está em /api.

Método	Caminho	O que faz
POST	/api/v1/rh/abonos	Lança um abono ou desconto pontual do mês
POST	/api/v1/rh/acidentes	Regista um acidente de trabalho
GET	/api/v1/rh/atrasos	Lista os pedidos de justificação de atraso
POST	/api/v1/rh/atrasos	Pede a justificação de um atraso
POST	/api/v1/rh/atrasos/:id/aprovar	Aceita a justificação de um atraso
POST	/api/v1/rh/atrasos/:id/recusar	Recusa a justificação de um atraso, com motivo
POST	/api/v1/rh/avaliacoes	Guarda uma avaliação de desempenho
POST	/api/v1/rh/avaliacoes/:id/conhecida	Regista que o avaliado leu a avaliação
POST	/api/v1/rh/candidaturas/:id/funcionario	Liga a candidatura ao funcionário admitido
POST	/api/v1/rh/candidaturas/:id/mover	Avança o candidato no processo
GET	/api/v1/rh/cargos	Lista os cargos
POST	/api/v1/rh/cargos	Cria um cargo
POST	/api/v1/rh/consultas-saude	Regista uma consulta de medicina do trabalho
POST	/api/v1/rh/contratos	Abre um contrato de trabalho
GET	/api/v1/rh/contratos/:id	Mostra um contrato
POST	/api/v1/rh/contratos/:id/cessar	Acaba o vínculo e calcula o que se paga
POST	/api/v1/rh/contratos/:id/renovar	Prolonga um contrato a termo
GET	/api/v1/rh/contratos/:id/simular-cessacao	Quanto custaria cessar este contrato
GET	/api/v1/rh/contratos/a-expirar	Os contratos que acabam nos próximos dias
GET	/api/v1/rh/definicoes	Subsídios e limites de isenção da empresa
PUT	/api/v1/rh/definicoes	Guarda subsídios e limites de isenção
GET	/api/v1/rh/departamentos	Lista os departamentos
POST	/api/v1/rh/departamentos	Cria um departamento
DELETE	/api/v1/rh/documentos/:id	Apaga um documento
POST	/api/v1/rh/doencas-profissionais	Regista uma doença profissional
GET	/api/v1/rh/escalas	Lista as escalas
POST	/api/v1/rh/escalas	Abre uma escala, em rascunho
GET	/api/v1/rh/escalas/:id	Mostra uma escala com as suas linhas
POST	/api/v1/rh/escalas/:id/publicar	Publica a escala, e é a partir daí que o ponto a compara
POST	/api/v1/rh/escalas/:id/turnos	Põe uma pessoa num turno num dia
GET	/api/v1/rh/escalas/semana	A escala publicada, por funcionário e por semana
GET	/api/v1/rh/faltas	Lista faltas
POST	/api/v1/rh/faltas	Lança uma falta
POST	/api/v1/rh/faltas/:id/aprovar	Justifica uma falta
GET	/api/v1/rh/ferias	Lista pedidos de férias
POST	/api/v1/rh/ferias	Pede férias
POST	/api/v1/rh/ferias/:id/aprovar	Aprova um pedido de férias
POST	/api/v1/rh/ferias/:id/rejeitar	Rejeita um pedido de férias
GET	/api/v1/rh/ferias/calendario	Calendário de férias do ano
GET	/api/v1/rh/ferias/saldo	Saldo de férias de uma pessoa
PUT	/api/v1/rh/ferias/saldo	Define o saldo de férias de uma pessoa
GET	/api/v1/rh/folhas	Lista as folhas salariais
POST	/api/v1/rh/folhas	Abre a folha de um mês
POST	/api/v1/rh/folhas/:id/fechar	Fecha a folha
POST	/api/v1/rh/folhas/:id/processar	Processa a folha
GET	/api/v1/rh/folhas/:id/recibos	Recibos de uma folha
POST	/api/v1/rh/folhas/:id/retificacao	Abre uma folha de retificação
POST	/api/v1/rh/formacoes	Regista uma ação de formação, com os participantes
GET	/api/v1/rh/funcionarios	Lista o ficheiro de pessoal
POST	/api/v1/rh/funcionarios	Admite um funcionário
GET	/api/v1/rh/funcionarios/:id	Mostra a ficha de um funcionário
PUT	/api/v1/rh/funcionarios/:id	Atualiza a ficha
GET	/api/v1/rh/funcionarios/:id/avaliacoes	O histórico de avaliações de um funcionário
GET	/api/v1/rh/funcionarios/:id/contratos	O histórico de vínculos de um funcionário
POST	/api/v1/rh/funcionarios/:id/desligar	Desliga um funcionário
GET	/api/v1/rh/funcionarios/:id/documentos	Documentos anexados à ficha
POST	/api/v1/rh/funcionarios/:id/documentos	Anexa um documento
GET	/api/v1/rh/funcionarios/:id/saude	O processo de saúde de uma pessoa
GET	/api/v1/rh/ocorrencias-saude	Lista acidentes e doenças profissionais
PUT	/api/v1/rh/ocorrencias-saude/:id/dias-perdidos	Corrige quantos dias a ocorrência custou
GET	/api/v1/rh/ponto	Lista registos de ponto
POST	/api/v1/rh/ponto	Marca ou corrige o ponto de um dia
GET	/api/v1/rh/ponto/dedos	Lista a biometria registada
POST	/api/v1/rh/ponto/dedos	Inscreve o dedo de uma pessoa no leitor
DELETE	/api/v1/rh/ponto/dedos/:id	Apaga a biometria de uma pessoa
GET	/api/v1/rh/ponto/leitores	Lista os leitores de impressão digital
POST	/api/v1/rh/ponto/leitores	Regista um leitor de impressão digital
PUT	/api/v1/rh/ponto/leitores/:id	Atualiza a ficha de um leitor
POST	/api/v1/rh/ponto/leitores/:id/sincronizar	Traz agora as picagens que estão no aparelho
POST	/api/v1/rh/ponto/leitores/:id/testar	Fala com o aparelho e traz a ficha dele
GET	/api/v1/rh/ponto/picagens	Lista o livro das picagens, tal como o aparelho as contou
GET	/api/v1/rh/recibos/:id	Mostra um recibo com as suas rubricas
GET	/api/v1/rh/recibos/:id/pdf	Recibo de vencimento em PDF
GET	/api/v1/rh/relatorios/absentismo	Absentismo por departamento
GET	/api/v1/rh/relatorios/custo-departamento	Custo com pessoal por departamento
GET	/api/v1/rh/relatorios/historico-salarial	Histórico salarial de uma pessoa
GET	/api/v1/rh/relatorios/mapa-acidentes	Mapa anual de acidentes de trabalho
GET	/api/v1/rh/relatorios/mapa-ferias	Mapa de férias do ano
GET	/api/v1/rh/relatorios/mapa-pessoal	Mapa de pessoal
GET	/api/v1/rh/taxas	Taxas de INSS e escalões de IRT em vigor
POST	/api/v1/rh/taxas/angola	Instala as tabelas publicadas de Angola
POST	/api/v1/rh/taxas/inss	Publica novas taxas de INSS
PUT	/api/v1/rh/taxas/irt	Publica uma tabela de IRT
GET	/api/v1/rh/trocas-de-turno	O trilho das trocas de turno
POST	/api/v1/rh/trocas-de-turno	Troca os turnos de duas pessoas num dia
GET	/api/v1/rh/turnos	Lista os turnos de trabalho
POST	/api/v1/rh/turnos	Cria um turno de trabalho
POST	/api/v1/rh/vagas	Abre um lugar por preencher
POST	/api/v1/rh/vagas/:id/candidaturas	Regista um candidato