Histórico da Página
01. DADOS GERAIS
Produto: |
| |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Linha de Produto: |
| |||||||||||||
Segmento: |
| |||||||||||||
Módulo: |
| |||||||||||||
Função: | rh.sigagpe.integration.fgtsdigital.tlpp | |||||||||||||
País: | Brasil | |||||||||||||
Ticket: | N/A | |||||||||||||
Story: | DRHROTPRT-14963 |
02. SITUAÇÃO/REQUISITO
Esta rotina tem como finalidade a geração do arquivo simplificado para recomposição do histórico do vínculo do trabalhador.
O arquivo resultante segue o leiaute estabelecido pelo governo, conforme a versão 1.0 datada de 09/08/23, disponível para consulta no seguinte link: Leiaute Recomposição Vínculo
03. SOLUÇÃO
Criação da tela do POUI e API contendo as informações solicitadas e contendo as opções de exportação do arquivo.
Card documentos Informacao Esse procedimento também pode ser realizado diretamente na plataforma do governo. A nova rotina serve apenas para facilitar este processo. Titulo Importante
04. DEMAIS INFORMAÇÕES
Um requisito para a rotina funcionar é a ativação do servidor REST na porta multiprotocolo, pelo uso da chave app_environment.
Totvs custom tabs box | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
05. ASSUNTOS RELACIONADOS
Não se aplica
Templatedocumentos |
---|
Índice |
---|
Visão Geral do Programa
O Painel de Conferência de IRRF é uma das novidades no middleware.
Esta funcionalidade tem como objetivo não ser apenas um relatório, mas uma ferramenta simples e intuitiva para a consulta dos valores de retenção de IRRF presentes na Folha (S-1200) e no evento Totalizador ( S-5002 ) enviado pelo governo. É composto pelas informações dos eventos ( S-1200, S-2299, S-2399 e S-1210) enviados para o eSocial.
A seguir iremos listar e explicar o que cada valor representado dentro do painel, bem como utilizar suas funcionalidades.
Procedimento para Uso
Menu
Miscelânea → eSocial → Monitor
Passo a Passo
Navegação
Ao acessar esta opção será exibido o menu das funcionalidades presentes no Painel eSocial, conforme imagem abaixo:
Filtros
Ao clicarmos em "Relatório de Conferência de IRRF" será exibida a seguinte tela:
Lista de campos apresentados na tela para utilização como filtro das informações a serem processadas:
...
Campo
...
Descrição
...
Ano/Mês no formato AAAA/MM, ou apenas Ano no formato AAAA, para ser considerado no processamento das informações do painel.
...
CPF do colaborador o qual se deseja buscar os valores de IRRF.
...
Parâmetro que permite listar somente os casos que apresentaram alguma divergência de valores entre as colunas Valor de Retenção RH x Valor de Retenção Governo, ou listar todos os colaboradores que possuam valor de IRRF em sua remuneração, independente de divergência ou não.
Opções:
- Sim = lista somente colaboradores com divergência de valores nas colunas de valor.
- Não = lista informações de todos os colaboradores que possuam valor de IRRF ou Base de IR em sua remuneração.
...
Parâmetro que permite listar somente os casos que apresentaram algum aviso devido diferença de valores entre os tipos de IR possíveis, seja retenção, base ou dedução
Opções:
- Sim = lista somente colaboradores com alerta nos tipos de IR
- Não = lista informações de todos os colaboradores que possuam valor de IRRF ou Base de IR em sua remuneração.
Informações | ||
---|---|---|
| ||
O painel conta com filtro adicional que pode ser encontrado clicando no botão "Busca Avançada". Neste filtro é possível adicionar a condição de categoria e quantos funcionários devem ser retornados por página. |
Lista de campos apresentados na tela de Busca Avançada:
...
Campo
...
Descrição
...
Parâmetro que permite listar somente os casos que apresentaram alguma divergência de valores entre as colunas FOLHA x Governo, ou listar todos os colaboradores que possuam valor de IRRF em sua remuneração, independente de divergência ou não.
Opções:
- Sim = lista somente colaboradores com divergência de valores nas colunas de valor.
- Não = lista informações de todos os colaboradores que possuam valor de IRRF ou Base de IR em sua remuneração.
...
CPF do colaborador o qual se deseja buscar os valores de IRRF.
...
Processamento
Ao aplicarmos os filtros será apresentada a seguinte tela:
Apresentação das Informações
Cards Totalizadores da Consulta
Estes cards totalizam os valores de retenção de IR encontrados nas duas fontes de informação ( RH e Governo ) e demonstra de forma sintética os resultados, desta forma, já é possível identificar se existem divergências nos valores.
Lista de Funcionários
Abaixo do quadro de totalizadores temos a lista de funcionário, sendo possível consultar o valor total de IR Retido de cada um deles, com os valores presentes na folha e no Governo.
Ao expandir cada funcionário será possível consultar os valores de retenção de IR de cada recibo de pagamento
Detalhamento do demonstrativo
Ao clicar sobre o demonstrativo será apresenta demais dados sobre os tipos de IR existente em no demonstrativo selecionado. Informações apresentadas:
- No cabeçalho é possível visualizar a qual demonstrativo se referem os dados apresentados;
- Na lista de consolidação são apresentados os tipos de IR existentes no demonstrativo, podendo expandir cada um deles para visualização;
- A descrição de cada tipo de IR está relacionada a incidência IR indicada nas rubricas existente em cada recibo, consulta esta relação em "observações".
Abaixo o resultado da expansão do item "Rendimentos tributáveis"
- Neste exemplo a descrição Remuneração Mensal ocorre devido a existência de rubricas com incidência IR 11 neste demonstrativo;
- A descrição apresentada tem origem na tabela S138, é a mesma ao selecionar este código no cadastro de verbas.
Detalhamento do Funcionário
Ao clicar sobre o funcionário será apresenta demais dados sobre os tipos de IR existente totalizados. Informações apresentadas:
- No cabeçalho é possível visualizar a quais demonstrativos se referems os dados apresentados;
- Na lista de consolidação são apresentados os tipos de IR existentes, podendo expandir cada um deles para visualização;
- A descrição de cada tipo de IR está relacionada a incidência IR indicada nas rubricas existente em cada recibo, consulta esta relação em "observações".
Observações
Abaixo algumas considerações importantes para o correto funcionamento do Painel de Conferência de IRRF.
...
title | Importante |
---|
O Pacote da expedição contínua a partir de 25/08/2023 deve estar aplicada.
- Os valores Folha são capturados dos eventos S-1200, S-2299 e S-2399 gravados na tabela RJO atualizados a partir da expedição contínua citada, portanto os meses anteriores podem não ser apresentados.
- Os valores Governo são capturados do evento S-5002, esse evento é recepcionado ao transmitir o evento S-1210 e seus valores também são gravados na tabela RJO, portanto somente os meses que possuem dados para este evento na tabela citada são apresentados no relatório.
IMPORTANTE:
A Visualização do detalhamento de cada demonstrativo de pagamento, assim como a exportação analítica e o filtro por aviso estão disponíveis na expedição contínua a partir de 12/01/2024.
Tipos de IR vs Incidência IR:
- A descrição da tabela abaixo representando o grupo dos códigos relacionados;
- A descrição de cada código da tabela abaixo está na tabela S138, caso seja um código não existente nesta tabela, o texto apresentado será o mesmo descrito na documentação técnica do evento S-5002
- Alguns códigos são aglutinados em outro. Exemplos.:
- 11 - Remuneração e 13 - Férias. No evento S-5002 e no relatório são aglutinados no código 11,
- 31 - Remuneração e 33 - Férias. No evento S-5002 e no relatório são aglutinados no código 31,
- Documentação técnica do governo
...
Detalhamento do grupo de colunas da Lista de Funcionários
...
Campos
...
Descrição
...
Atributo
...
Campo | Detalhamento
...
Detalhamento ao expandir o grupo Lista de Funcionários
...
Campos
...
Descrição
...
Atributo
...
Campo | Detalhamento
...
Informações Técnicas da API
Este detalhamento tem como objetivo registrar os endpoints da interface de FGTS Digital, desenvolvida utilizando PO-UI. Para o endpoint principal, adotamos a nomenclatura presente no leiaute oficial fornecido pelo governo, disponível no seguinte link:
FGTS Digital - Leiaute do Arquivo de Recomposição Histórico do Vínculo
No PO-UI, é padrão que, ao recebermos uma lista, esta esteja encapsulada dentro de uma propriedade denominada "items".
Embora eu tenha omitido essa informação nos dois endpoints a seguir, ela pode ser visualizada no JSON de retorno dos exemplos.
...
id | FGTSDigital |
---|
...
id | FGTSDigitalLista |
---|---|
label | FGTS Digital - Lista |
...
id | GPEreportEsocialBaseConfer |
---|
...
id | GPEreportEsocialBaseConfer |
---|---|
label | GPEreportEsocialBaseConfer |
Exemplo de EndPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer
Requisição POST
...
Identificador da empresa
...
(1-1)
...
companyId
...
string
...
Código da Empresa
...
Período
...
(1-1)
...
paymentPeriod
...
string
...
Período de apuração
...
Tipo de Tributo
...
(0-1)
...
tribute
...
string (default: 0)
...
1 - Relatório de INSS
2 - Relatório de FGTS
3 - Relatório de IRRF
...
Somente divergências
...
(0-1)
...
differencesOnly
...
boolean (default: false)
...
Indica se os funcionários com diferenças devem ser retornados ou não
Expandir | ||
---|---|---|
| ||
{ |
Expandir | ||
---|---|---|
| ||
{ |
...
id | IRRFRetValues |
---|---|
label | IRRFRetValues |
A API IRRFRetValues retorna os dados utilizados no relatório de conferência IRRF.
Abaixo dados dos parâmetros usados pela API
Parâmetros GET:
...
Identificador da empresa
...
(1-1)
...
companyId
...
string
...
Código da Empresa
...
Id. da requisição
...
(1-1)
...
requestId
...
string
...
Id da Requisição
...
Nível das Informações
...
(0-1)
...
level
...
string (default: 0)
...
0 - Total por Empresa
1 - Total por Funcionário,
2 - Total do Funcionário por demonstrativo,
9 - Todos os níveis
...
Somente divergências
...
(0-1)
...
differencesOnly
...
boolean (default: false)
...
Indica se os funcionários com diferenças devem ser retornados ou não (exceto para o nível 0)
...
Cpf
...
(0-1)
...
cpfNumber
...
string
...
Cpf do funcionário a ser retornado (exceto para o nível 0)
...
Página para controle de paginação
...
(0-1)
...
page
...
number (default: 1)
...
Número
da página a ser retornada
...
Tamanho da página
...
(0-1)
...
pageSize
...
number (default: 30)
...
Número de itens que devem ser retornados na página
Abaixo o exemplo de uso e retorno para cada nível de informações
...
id | IRRFRetValues |
---|
...
id | IRRFRetValuesErros |
---|---|
label | Tratamento de Exceções |
...
title | Ambiente Desatualizado |
---|
- Exemplo endPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=0&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Query Params preenchidos corretamente:
- Retorno
{
"code": 400,
"message": "Ambiente desatualizado.",
"detailedMessage": "Aplique a última atualização da expedição contínua do RH. Para correta execução do relatório as tabelas RU4 e RU5 devem existir no ambiente."
}
...
title | Ausência companyId |
---|
- Exemplo endPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?level=0&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Query Params sem o companyId :
- Retorno
{
"code": 400,
"message": "Empresa|Filial não informado no parâmetro 'companyId'.",
"detailedMessage": ""
}
...
title | companyId inválido |
---|
- Exemplo endPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7AARS 001&level=0&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Query Params com o companyId preenchido incorretamente, sem a quebra de grupo e filial com pipe ("|"):
- Retorno
{
"code": 400,
"message": "Empresa|Filial não informado no parâmetro 'companyId'.",
"detailedMessage": ""
}
...
title | companyId com Grupo/Filial inexistente |
---|
- Exemplo endPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T9|AARS 001&level=0&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Query Params com o companyId preenchido com dados que não existem no cadastro da empresa.
- Retorno
{
"code": 400,
"message": "Falha na preparação do ambiente para a Empresa 'T9' e Filial 'AARS 001'.",
"detailedMessage": ""
}
...
title | ResquetId inválido |
---|
- Exemplo endPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=0&page=1&pageSize=15&requestId=teste
- Query Params com o requestId inválido.
- Retorno
{
"code": 400,
"message": "A Identificação da Requisição 'teste' informado no parâmetro 'requestId' não existe.",
"detailedMessage": ""
}
...
title | ResquetId inexistente |
---|
- Exemplo endPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=0&page=1&pageSize=15&requestId=teste
- Query Params com o requestId inválido.
- Retorno
{
"code": 400,
"message": "Identificação da Requisição não informada no parâmetro 'requestId'.",
"detailedMessage": ""
}
...
id | IRRFRetValues0 |
---|---|
label | Nível 0 - Total por Empresa |
- Exemplo de EndPoint:
http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=0&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Exemplo de retorno da execução
{
"items": [
{
"totalIRRFCompany": {
"erpValue": 2875.76,
"retValue": 2875.76
}
}
],
"hasNext": false
}
...
id | IRRFRetValues1 |
---|---|
label | Nível 1 - Total por Funcionário, |
- Exemplo de EndPoint:
http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=1&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Exemplo de retorno da execução
{
"items": [
{
"employees": [
{
"cpfNumber": "30307422020",
"name": "DRHROTPRT-11682 DOIS ",
"period": "2023-06",
"totalIrrfRetention": {
"erpValue": 46.87,
"retValue": 46.87
},
"divergent": false
},
{
"cpfNumber": "35541406358",
"name": "DRHROTPRT-11682 UM ",
"period": "2023-06",
"totalIrrfRetention": {
"erpValue": 413.85,
"retValue": 413.85
},
"divergent": false
},
{
"cpfNumber": "43611791075",
"name": "DRHROTPRT-11682 TSV DOIS ",
"period": "2023-06",
"totalIrrfRetention": {
"erpValue": 0,
"retValue": 0
},
"divergent": false
},
{
"cpfNumber": "53247550283",
"name": "DRHROTPRT-11682 TRES ",
"period": "2023-06",
"totalIrrfRetention": {
"erpValue": 0,
"retValue": 0
},
"divergent": false
},
{
"cpfNumber": "81125476702",
"name": "DRHROTPRT-11682 TSV ",
"period": "2023-06",
"totalIrrfRetention": {
"erpValue": 2415.04,
"retValue": 2415.04
},
"divergent": false
}
]
}
],
"hasNext": false
}
...
id | IRRFRetValues2 |
---|---|
label | Nível 2 - Total do Funcionário por demonstrativo, |
- Exemplo de EndPoint:
http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=2&page=1&pageSize=1&requestId=41412f0c-2627-cf86-c445-b683454c1d54&cpfNumber=53247550283
- Exemplo de retorno da execução
{
"items": [
{
"employees": [
{
"cpfNumber": "53247550283",
"name": "DRHROTPRT-11682 TRES ",
"period": "2023-06",
"demonstrative": [
{
"demonstrativeId": "AARS 00120230620202306PLR ",
"category": "101",
"referencePeriod": "2023-06",
"origin": "S-1200",
"payday": "2023-06-20",
"irrfRetention": {
"erpValue": 0,
"retValue": 0
}
},
{
"demonstrativeId": "AARS 00120230630202306FOL ",
"category": "101",
"referencePeriod": "2023-06",
"origin": "S-1200",
"payday": "2023-06-30",
"irrfRetention": {
"erpValue": 0,
"retValue": 0
}
}
],
"divergent": false
}
]
}
],
"hasNext": true
}
...
id | IRRFRetValues9 |
---|---|
label | Nível 9 - Todos os níveis |
- Exemplo de EndPoint:
http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=9&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Exemplo de retorno da execução
{
"items": [
{
"totalIRRFCompany": {
"erpValue": 2875.76,
"retValue": 2875.76
}
},
{
"employees": [
{
"cpfNumber": "30307422020",
"name": "DRHROTPRT-11682 DOIS ",
"period": "2023-06",
"demonstrative": [
{
"demonstrativeId": "RT7AARS 001000083 ",
"category": "101",
"referencePeriod": "2023-06",
"origin": "S-2299",
"payday": "2023-06-27",
"irrfRetention": {
"erpValue": 46.87,
"retValue": 46.87
}
}
],
"totalIrrfRetention": {
"erpValue": 46.87,
"retValue": 46.87
},
"divergent": false
},
{
"cpfNumber": "35541406358",
"name": "DRHROTPRT-11682 UM ",
"period": "2023-06",
"demonstrative": [
{
"demonstrativeId": "AARS 00120230608202306FER ",
"category": "101",
"referencePeriod": "2023-06",
"origin": "S-1200",
"payday": "2023-06-08",
"irrfRetention": {
"erpValue": 157.72,
"retValue": 157.72
}
},
{
"demonstrativeId": "AARS 00120230615202306ADI ",
"category": "101",
"referencePeriod": "2023-06",
"origin": "S-1200",
"payday": "2023-06-15",
"irrfRetention": {
"erpValue": 154.96,
"retValue": 154.96
}
},
{
"demonstrativeId": "AARS 00120230620202306PLR ",
"category": "101",
"referencePeriod": "2023-06",
"origin": "S-1200",
"payday": "2023-06-20",
"irrfRetention": {
"erpValue": 101.17,
"retValue": 101.17
}
},
{
"demonstrativeId": "AARS 00120230630202306FOL ",
"category": "101",
"referencePeriod": "2023-06",
"origin": "S-1200",
"payday": "2023-06-30",
"irrfRetention": {
"erpValue": 0,
"retValue": 0
}
}
],
"totalIrrfRetention": {
"erpValue": 413.85,
"retValue": 413.85
},
"divergent": false
},
{
"cpfNumber": "43611791075",
"name": "DRHROTPRT-11682 TSV DOIS ",
"period": "2023-06",
"demonstrative": [
{
"demonstrativeId": "AARS 00120230630202306AUT ",
"category": "701",
"referencePeriod": "2023-06",
"origin": "S-1200",
"payday": "2023-06-30",
"irrfRetention": {
"erpValue": 0,
"retValue": 0
}
}
],
"totalIrrfRetention": {
"erpValue": 0,
"retValue": 0
},
"divergent": false
},
{
"cpfNumber": "53247550283",
"name": "DRHROTPRT-11682 TRES ",
"period": "2023-06",
"demonstrative": [
{
"demonstrativeId": "AARS 00120230620202306PLR ",
"category": "101",
"referencePeriod": "2023-06",
"origin": "S-1200",
"payday": "2023-06-20",
"irrfRetention": {
"erpValue": 0,
"retValue": 0
}
},
{
"demonstrativeId": "AARS 00120230630202306FOL ",
"category": "101",
"referencePeriod": "2023-06",
"origin": "S-1200",
"payday": "2023-06-30",
"irrfRetention": {
"erpValue": 0,
"retValue": 0
}
}
],
"totalIrrfRetention": {
"erpValue": 0,
"retValue": 0
},
"divergent": false
},
{
"cpfNumber": "81125476702",
"name": "DRHROTPRT-11682 TSV ",
"period": "2023-06",
"demonstrative": [
{
"demonstrativeId": "AARS 00120230630202306AUT ",
"category": "701",
"referencePeriod": "2023-06",
"origin": "S-1200",
"payday": "2023-06-30",
"irrfRetention": {
"erpValue": 2415.04,
"retValue": 2415.04
}
}
],
"totalIrrfRetention": {
"erpValue": 2415.04,
"retValue": 2415.04
},
"divergent": false
}
]
}
],
"hasNext": false
}
Exemplo de EndPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer
Requisição POST
...
Identificador da empresa
...
(1-1)
...
companyId
...
string
...
Código da Empresa
...
Período
...
(1-1)
...
paymentPeriod
...
string
...
Período de apuração
...
Tipo de Tributo
...
(0-1)
...
tribute
...
string (default: 0)
...
1 - Relatório de INSS
2 - Relatório de FGTS
3 - Relatório de IRRF
...
Somente divergências
...
(0-1)
...
differencesOnly
...
boolean (default: false)
...
Indica se os funcionários com diferenças devem ser retornados ou não
Expandir | ||
---|---|---|
| ||
{ |
Expandir | ||
---|---|---|
| ||
{ |
...
id | FGTSDigitalBranches |
---|---|
label | FGTS Digital - Branches |
A API IRRFRetValues retorna os dados utilizados no relatório de conferência IRRF.
Abaixo dados dos parâmetros usados pela API
Parâmetros GET:
...
Identificador da empresa
...
(1-1)
...
companyId
...
string
...
Código da Empresa
...
Id. da requisição
...
(1-1)
...
requestId
...
string
...
Id da Requisição
...
Nível das Informações
...
(0-1)
...
level
...
string (default: 0)
...
0 - Total por Empresa
1 - Total por Funcionário,
2 - Total do Funcionário por demonstrativo,
9 - Todos os níveis
...
Somente divergências
...
(0-1)
...
differencesOnly
...
boolean (default: false)
...
Indica se os funcionários com diferenças devem ser retornados ou não (exceto para o nível 0)
...
Cpf
...
(0-1)
...
cpfNumber
...
string
...
Cpf do funcionário a ser retornado (exceto para o nível 0)
...
Página para controle de paginação
...
(0-1)
...
page
...
number (default: 1)
...
Número
da página a ser retornada
...
Tamanho da página
...
(0-1)
...
pageSize
...
number (default: 30)
...
Número de itens que devem ser retornados na página
Abaixo o exemplo de uso e retorno para cada nível de informações
...
id | IRRFRetValues |
---|
...
id | IRRFRetValuesErros |
---|---|
label | Tratamento de Exceções |
...
title | Ambiente Desatualizado |
---|
- Exemplo endPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=0&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Query Params preenchidos corretamente:
- Retorno
{
"code": 400,
"message": "Ambiente desatualizado.",
"detailedMessage": "Aplique a última atualização da expedição contínua do RH. Para correta execução do relatório as tabelas RU4 e RU5 devem existir no ambiente."
}
...
title | Ausência companyId |
---|
- Exemplo endPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?level=0&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Query Params sem o companyId :
- Retorno
{
"code": 400,
"message": "Empresa|Filial não informado no parâmetro 'companyId'.",
"detailedMessage": ""
}
...
title | companyId inválido |
---|
- Exemplo endPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7AARS 001&level=0&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Query Params com o companyId preenchido incorretamente, sem a quebra de grupo e filial com pipe ("|"):
- Retorno
{
"code": 400,
"message": "Empresa|Filial não informado no parâmetro 'companyId'.",
"detailedMessage": ""
}
...
title | companyId com Grupo/Filial inexistente |
---|
- Exemplo endPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T9|AARS 001&level=0&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Query Params com o companyId preenchido com dados que não existem no cadastro da empresa.
- Retorno
{
"code": 400,
"message": "Falha na preparação do ambiente para a Empresa 'T9' e Filial 'AARS 001'.",
"detailedMessage": ""
}
...
title | ResquetId inválido |
---|
- Exemplo endPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=0&page=1&pageSize=15&requestId=teste
- Query Params com o requestId inválido.
- Retorno
{
"code": 400,
"message": "A Identificação da Requisição 'teste' informado no parâmetro 'requestId' não existe.",
"detailedMessage": ""
}
...
title | ResquetId inexistente |
---|
- Exemplo endPoint: http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=0&page=1&pageSize=15&requestId=teste
- Query Params com o requestId inválido.
- Retorno
{
"code": 400,
"message": "Identificação da Requisição não informada no parâmetro 'requestId'.",
"detailedMessage": ""
}
...
id | IRRFRetValues0 |
---|---|
label | Nível 0 - Total por Empresa |
- Exemplo de EndPoint:
http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=0&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Exemplo de retorno da execução
{
"items": [
{
"totalIRRFCompany": {
"erpValue": 2875.76,
"retValue": 2875.76
}
}
],
"hasNext": false
}
...
id | IRRFRetValues1 |
---|---|
label | Nível 1 - Total por Funcionário, |
- Exemplo de EndPoint:
http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=1&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Exemplo de retorno da execução
{
"items": [
{
"employees": [
{
"cpfNumber": "30307422020",
"name": "DRHROTPRT-11682 DOIS ",
"period": "2023-06",
"totalIrrfRetention": {
"erpValue": 46.87,
"retValue": 46.87
},
"divergent": false
},
{
"cpfNumber": "35541406358",
"name": "DRHROTPRT-11682 UM ",
"period": "2023-06",
"totalIrrfRetention": {
"erpValue": 413.85,
"retValue": 413.85
},
"divergent": false
},
{
"cpfNumber": "43611791075",
"name": "DRHROTPRT-11682 TSV DOIS ",
"period": "2023-06",
"totalIrrfRetention": {
"erpValue": 0,
"retValue": 0
},
"divergent": false
},
{
"cpfNumber": "53247550283",
"name": "DRHROTPRT-11682 TRES ",
"period": "2023-06",
"totalIrrfRetention": {
"erpValue": 0,
"retValue": 0
},
"divergent": false
},
{
"cpfNumber": "81125476702",
"name": "DRHROTPRT-11682 TSV ",
"period": "2023-06",
"totalIrrfRetention": {
"erpValue": 2415.04,
"retValue": 2415.04
},
"divergent": false
}
]
}
],
"hasNext": false
}
...
id | IRRFRetValues2 |
---|---|
label | Nível 2 - Total do Funcionário por demonstrativo, |
- Exemplo de EndPoint:
http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=2&page=1&pageSize=1&requestId=41412f0c-2627-cf86-c445-b683454c1d54&cpfNumber=53247550283
- Exemplo de retorno da execução
{
"items": [
{
"employees": [
{
"cpfNumber": "53247550283",
"name": "DRHROTPRT-11682 TRES ",
"period": "2023-06",
"demonstrative": [
{
"demonstrativeId": "AARS 00120230620202306PLR ",
"category": "101",
"referencePeriod": "2023-06",
"origin": "S-1200",
"payday": "2023-06-20",
"irrfRetention": {
"erpValue": 0,
"retValue": 0
}
},
{
"demonstrativeId": "AARS 00120230630202306FOL ",
"category": "101",
"referencePeriod": "2023-06",
"origin": "S-1200",
"payday": "2023-06-30",
"irrfRetention": {
"erpValue": 0,
"retValue": 0
}
}
],
"divergent": false
}
]
}
],
"hasNext": true
}
...
id | IRRFRetValues9 |
---|---|
label | Nível 9 - Todos os níveis |
- Exemplo de EndPoint:
http://localhost:8104/rest/api/rh/esocial/v1/GPEreportEsocialBaseConfer/IRRFRetValues?companyId=T7|AARS 001&level=9&page=1&pageSize=15&requestId=41412f0c-2627-cf86-c445-b683454c1d54
- Exemplo de retorno da execução
...