Como gerar recibos de funcionários por integração?

O processamento de recibos para funcionários é uma das funcionalidades mais utilizadas no módulo de Recursos Humanos. Através desta operação, é possível gerar recibos em formato PDF com os valores relativos aos abonos auferidos no período selecionado.

Personalizar recibos

A funcionalidade de processamento de recibos para funcionários abrange ainda um leque de múltiplas opções que permitem a geração personalizada do recibo, nomeadamente:

• Aglomera Recibos: identifica se os recibos devem ser gerados de forma aglomerada ou separada;
• Relatório: nome do relatório que será utilizado para a geração do PDF. Encontra-se disponível um relatório de sistema, mas o utilizador poderá utilizar outro documento desde que siga a estrutura sugerida pela PRIMAVERA;
• Código do Funcionário: identificador do funcionário;
• Ano: valor referente ao ano;
• Número de Período: mês em que será processado o recibo.

Processar recibos

Este artigo tem como objetivo demonstrar como realizar um processamento de recibos utilizando os motores, através dos seguintes passos:

Passo 1 - Adicionar referências

Para a utilização dos objetos é necessário aplicar as seguintes referências para os motores de Recursos Humanos:

• RhpBE100;
• IRhpBS100.

Passo 2 - Preencher o objeto com a informação do recibo

Para gerar um recibo é necessário ter em consideração algumas configurações que permitem a criação do PDF, de acordo com as opções do utilizador.

Deverá ser preenchido o objeto “RHPBERecibo” com as propriedades necessárias.

RhpBERecibo  recibo = new RhpBERecibo

{

CodigoFuncionario = "Código do funcionário",

Ano = "Ano",

NumPeriodo = "Mês a considerar",

CodigoPeriodo = "Código do Período",

Observacoes = "Observações necessárias",

ImprAglomearar = "Validação de aglomeração",

Relatorio = "Nome do mapa, poderá ser RHPR0006",

Moeda ="0"

};

Passo 3 - Preencher o objeto com informações dos processamentos

O recibo de um funcionário pode ter mais do que um tipo de processamento, por exemplo: vencimento, subsídio de férias e de Natal. Para tal, é necessário adicionar os processamentos referentes ao recibo processado ao objeto criado no passo anterior.

Assim, deverá adicionar ao “RhpBERecibo” uma objeto do tipo “RhpBEReciboProcessamento” por cada processamento distinto.

recibo.Processamentos.Add(new.RhpBEReciboProcessamento

{

NumProc = "Numero do processamento",

TipoVencimento = "Tipo Do vencimento",

DataMovimento = "Data do Movimento",

TotalDescontos = "Total de descontos do processamento",

TotalRemuneracoes = "Total de remunerações do processamento",

TotalLiquido = TotalDescontos - TotalRemuneracoes

});

Passo 4 - Gerar recibos em PDF

Depois de realizar os passos anteriores, é possível gerar um recibo tendo em consideração o objeto preenchido. Esta operação encontra-se dividida em três etapas:

1. Abrir o motor de impressão: Realiza a abertura do motor de impressão uma única vez, permitindo uma rápida geração de múltiplos recibos sem precisar de abrir a ligação a cada processamento;

   PriEngine.Engine.RecursosHumanos.Recibos.IniciaProcessamentoRecibos();

2. Processar o Recibo;
   

   PriEngine.Engine.RecursosHumanos.Recibos.ProcessaRecibos(recibo, false);

3. Fechar o motor de impressão: Após a geração dos recibos, deverá ser fechado o motor de impressão.

   PriEngine.Engine.RecursosHumanos.Recibos.TerminaProcessamentoRecibos();

A informação dos recibos será guardada na base de dados na tabela “Recibos”, no campo PDF. A meta informação relativa aos processamentos utilizados para os recibos também é guardada na tabela “FuncRecibosProcs”.