DRHROTPRT-990 DT Melhoria no Relatório INSS - TAF (13/08)

01. DADOS GERAIS

Produto:	TOTVS RH
Linha de Produto:	Linha Protheus
Segmento:	RH
Módulo:	GESTÃO DE PESSOAS (SIGAGPE)
Função:	WSMIDREL GPEM036A GPEM921B
Ticket:	N/A
Requisito/Story/Issue (informe o requisito relacionado) :	DRHROTPRT-990

02. SITUAÇÃO/REQUISITO

Atualmente o relatório é gerado a partir dos valores de INSS do funcionário por estabelecimento, após a alteração será gerado o valor do INSS total do funcionário por CPF, podendo o usuário visualizar ou não os dados por estabelecimento e vínculo.

Na geração de relatório de INSS apresentar na coluna INSS DCTFWEB o valor existente na tag vrCpSeg do evento S-5001.

A API poderá receber os parâmetro abaixo:

PROPRIEDADE	DESCRIÇÃO	Obrigatório?
companyId	Identificador da empresa	Sim
registrationNumber	Inscrição Estabelecimento	Não
lotationCode	Código Lotação	Não
eSocialCategory	Categoria eSocial	Não
cpfNumber	CPF	Não
eSocialRegistration	Matrícula eSocial	Não
paymentPeriod	Período Folha	Sim
tribute	Tributo	Sim

As propriedades abaixo serão retornadas:

PROPRIEDADE	DESCRIÇÃO
requestId	Id. da requisição

Criar um serviço (API REST) que será consumido pelo FrontEnd do Monitor THF/Portinari, para retornar os valores de FGTS do eSocial, de acordo com a empresa logada.

A API poderá receber os parâmetro abaixo:

PROPRIEDADE	DESCRIÇÃO	Obrigatório?
companyId	Identificador da empresa	Sim
requestId	Id. da requisição	Sim
synthetic	Analítico (False ou Sintético (True)	Não
differencesOnly	Somente divergências	Não
page	Número da Página	Não
pageSize	Qtde. de registros por página	Não

As propriedades abaixo serão retornadas:

PROPRIEDADE	DESCRIÇÃO	OBSERVAÇÃO
cpfNumber	CPF do Trabalhador
name	Nome do Trabalhador
inssGrossValue	Valor INSS - Calculado na Folha	Valor de INSS calculado pela Folha de pagamento e transmitido ao eSocial. Valor gravado na tabela RJO ao gerar o evento S-1200.
inssRetGrossValue	Valor INSS - Calculado pelo eSocial (Valor da DCTFWEB)	Valor INSS demonstrado no evento S-5001 dentro do grupo <InfoCpCalc>, trata-se da informação calculada pelo Governo e que será utilizada para recolhimento efetivo do imposto, o valor em si é retornado através da TAG <vrCpSeg> sumarizando todos os <tpCR> existentes no mesmo grupo.. Valor estará gravado na tabela RJO ao receber o evento S-5001
inssRetDescGrossValue	Valor INSS - Descontado do Colaborador em folha (enviado)	Valor INSS demonstrado no evento S-5001 dentro do grupo <InfoCpCalc>, trata-se da informação calculada pela folha e descontada do colaborador, o valor em si é retornado através da TAG <vrDescSeg> sumarizando todos os <tpCR> existentes no mesmo grupo.. Valor estará gravado na tabela RJO ao receber o evento S-5001.
inss13GrossValue	Valor INSS 13º Salário -Calculado na Folha	Valor INSS 13º Salário calculado pela Folha de pagamento e transmitido ao eSocial. Valor gravado na tabela RJO ao gerar o evento S-1200.
inss13RetGrossValue	Valor INSS 13º Salário- Calculado pelo eSocial (Valor da DCTFWEB)	Valor INSS 13º demonstrado no evento S-5001 dentro do grupo <InfoCpCalc> quando <indApuracao> igual a 2, trata-se da informação calculada pelo Governo e que será utilizada para recolhimento efetivo do imposto, o valor em si é retornado através da TAG <vrCpSeg> sumarizando todos os <tpCR> existentes no mesmo grupo. Valor gravado na tabela RJO ao gerar o evento S-1200.
inss13DescGrossValue	Valor INSS 13º - Descontado do Colaborador em folha (enviado)	Valor INSS 13º demonstrado no evento S-5001 dentro do grupo <InfoCpCalc> quando <indApuracao> igual a 2, trata-se da informação calculada pela folha e descontada do colaborador, o valor em si é retornado através da TAG <vrDescSeg> sumarizando todos os <tpCR> existentes no mesmo grupo.
familySalaryValue	Valor Salário Família – Calculado na Folha	Valor sumarizado de Salário Família calculado pela folha de pagamento
familySalaryRetValue	Valor Salário Família –Total enviado ao eSocial	Valor sumarizado do salário família referente ao trabalhador em questão, demonstrado no evento S-5001 dentro do grupo <infoBaseCS>, trata-se da informação calculada pela folha de pagamento e transmitida ao eSocial, o valor em si é retornado através da TAG <valor>, considerando o <ind13> igual a 0 e <tpValor> igual a 31.
maternitySalaryValue	Valor Salário Maternidade – Calculado na Folha	Valor sumarizado de Salário Maternidade calculado pela folha de pagamento
maternitySalaryRetValue	Valor Salário Maternidade – Total enviado ao eSocial	Valor sumarizado do salário maternidade demonstrado no evento S-5001 dentro do grupo <infoBaseCS>, trata-se da informação calculada pela folha de pagamento e transmitida ao eSocial, o valor em si é retornado através da TAG <valor>, considerando o <ind13> igual a 0 e <tpValor> igual a 32.
maternitySalary13Value	Valor Salário Maternidade 13º – Calculado na Folha	Valor sumarizado de 13º Salário Maternidade calculado pela folha de pagamento
maternitySalary13RetValue	Valor Salário Maternidade 13º – Total enviado ao eSocial	Valor sumarizado de 13º salário maternidade demonstrado no evento S-5001 dentro do grupo <infoBaseCS>, trata-se da informação calculada pela folha de pagamento e transmitida ao eSocial, o valor em si é retornado através da TAG <valor>, considerando o <ind13> igual a 1 e <tpValor> igual a 32.
divergent	Divergente	Indica se registro é divergente FOLHA vs RET

03. SOLUÇÃO

Desenvolvimento de uma API REST (INSSRETVALUES) que efetua o processamento de acordo com os requisitos citados acima e também que retorna os valores de INSS por CPF.

A consulta é realizada na tabela de verbas (RJO), com os filtros informados pelo Front-End, e assim as propriedades são retornadas no formato de String JSON.

04. DEMAIS INFORMAÇÕES

Não se aplica

05. ASSUNTOS RELACIONADOS