Desenvolvimento da interface no POUI e das APIs, convergente nas 3 linhas para realizar o controle e gestão dos períodos onde foram retificados em Janeiro do ano (infoIRComplem/perAnt) . Importante Requisito para a rotina funcionar:
|

|
Ao acessar o novo menu criado, abre-se uma nova tela. Nessa nova tela, serão exibidos os funcionários que tiveram evento S-1210 transmitidos ao governo no ano anterior ao ano informado no parâmetro Ano Retificação que deve ser informado.

No parâmetro Ano Retificação, deve ser informado o ano que que será gerado o evento S-1210 com retificação de períodos anteriores, por exemplo ao informar Ano Retificação 2026, serão listados funcionários que tiveram evento S-1210 transmitidos ao governo no ano de 2025 que possuam informações complementares (dedução dependente, pensão alimentícia, previdência privada ou despesas médicas/reembolsos) e que seja necessário fazer a retificação em Janeiro de 2026 no bloco <perAnt> conforme prevê o leiaute S-1.3.
O parâmetro CPF é opcional. O botão aplicar filtros só ficará habilitado após informar o parâmetro Ano Retificação que deve ser no formado de 4 dígitos e maior ou igual a 2026 conforme o exemplo abaixo: 
Na lista, são exibidas as seguintes colunas: CPF, Nome, Tipo, Meses Retificados/a Retificar em XXXX e o botão Editar (detalhado mais adiante neste documento). O campo Tipo apresenta as seguintes classificações: Funcionário – Exibe apenas funcionários. Funcionário/Prestador – Refere-se a funcionários que também possuem registro como prestador no programa FP2160. Prestador – Prestadores com registro no programa FP2160. Prestador – Outros Sistemas – Prestadores integrados de outros sistemas ou módulos, como, por exemplo, BackOffice.
⚠️ Observação: Para os casos classificados como Prestador – Outros Sistemas, só será possível consultar os meses a serem retificados. A definição dos meses a serem retificados deve ser realizada no programa CD2014.
Exemplo informando os parâmetros Ano Retificação e CPF:

No botão Filtros Avançados é possível informar o Estabelecimento além do Ano Retificação e CPF, porém o Ano Retificação é obrigatório.


Para cada registro da lista de funcionários está disponível o botão Editar, com ícone de um lápis, onde será possível informar quais meses serão retificados. 
Ao clicar no botão Editar, a seguinte tela será exibida: 
Ao selecionar os meses desejados, o sistema registrará os períodos que deverão ser retificados. 

Exemplos de situações em que será necessário fazer retificações: - Quando for necessário alterar o CPF do beneficiário da pensão alimentícia, por exemplo, em situações em que anteriormente era informado ao eSocial o CPF do responsável, mas no processo judicial consta o CPF do alimentado:
- Anteriormente, era obrigatório informar o nome e CPF do responsável, por fins de líquido bancário, onde o depósito é realizado em sua conta.
- Com a alteração implementada no programa FP1740 - Manutenção Beneficiários Pensão Alimentícia, passou a ser possível informar o responsável pelo recebimento da pensão (nesse caso, o responsável) apenas para fins de líquido bancário.
- Já para o eSocial, será considerado o CPF do alimentado.
Exemplo: 

Gerou o S-1210 dos meses de 06/2025 a 09/2025 com a informação incorreta no bloco <penAlim> 
Para corrigir a informação retroativamente, deve ser realizado os seguintes procedimentos em Janeiro de 2026. Antes do cálculo da folha, deve ser alterado o programa FP1740 da seguinte forma: Deve ser criada uma nova pessoa física no programa FP1440 com os dados do pensionista 
Informar o código da pessoa física no programa FP1740 
Informar o nome e CPF do responsável na aba Forma Pagt quadro Responsável para Depósito Bancário 

No programa FP6100 ficará dessa forma:
Marcar na nova tela os meses que deseja retificar as informações no evento S-1210, por exemplo , agosto e setembro de 2025 
Após o cálculo da folha, gerar o evento S-1210 de Janeiro de 2026 onde serão gerados os blocos de <perAnt> com a informação do CPF ajustado 
Outra situação em que as informações do evento S-1210 podem ser retificadas é para os casos em que algum valor de informações complementares (enviado no S-1210, no bloco infoIRComplem) estejam diferentes do que foi tramitado na folha de pagamento, cujo o ajuste de valor seja necessário somente nas informações complementares do IR, e não haja necessidade de ajustes e retificação do S-1200. Exemplo: O valor de despesas médicas do titular tramitado na folha de pagamento de Mai/2025, com pagamento em Jun/2025 do funcionário foi de R$50,00, porém no prgorama FP9912, para o mês de pagamento Jun/2025 está informado um valor de R$ 40,00, no evento S-1210 de Jun/2025, no bloco infoIRComplem foi enviado valor de R$40,00 como despesas médicas do titular, nesse caso pode ser realizado o ajuste e realizado a retificação em Jan/2026.
Para funcionários desligados e que seja necessária a retificação do evento S-1210 o processo deve ser feito da seguinte forma: - Na nova tela, marcar os meses que deseja retificar;
- Corrigir a informação no produto, ou seja, alterar o FP1740 ou FP9912 por exemplo;
- Executar somente o programa FR9824 para gerar o S-1210 com os blocos de <perAnt>
Em relação à tag <nrRec1210Orig>, o conteúdo varia conforme a forma de integração utilizada: Middleware: é preenchida diretamente com o número do recibo do evento S-1210 de origem. TAF: é preenchida inicialmente com o número da mensagem de origem do evento S-1210. O TAF então realiza a conversão dessa informação para o número do recibo, que é transmitido ao governo.
|
Informações Técnicas da APIEste detalhamento tem como objetivo registrar os endpoints da interface da integração da tela desenvolvida utilizando PO-UI.
Objetivo: Busca dos dados para listagem dos funcionários e envio dos funcionários selecionados para o back-end.
Tipo de requisição: GET/PUT Endpoint: /api/rh/v1/RefificaPerAnt
Get: Query Params: Nome | Descrição | Tipo | Obrigatório | Exemplo | page | Número da página | number | Sim | 1 | pageSize | Tamanho da página | number | Sim | 20 | yearRectif | Ano retificação | number | Sim | Maior ou igual a 2026 | registrationNumber | CPF | number | Não | 59303411099 | branchCode | Filial (Multi Valores separados por vírgula) | string | Não | “D MG 01,D MG 02” |
Estrutura de Retorno: Campo | Tipo | Exemplo | id (obrigatório) | string | "2026-59303411099" | yearRectif(obrigatório) | number | 2026 | companyCode | string | "1" | branchCode(obrigatório) | string | “02” | type | string | "Funcionário" ou "Prestador" ou "Funcionário/Prestador" | registrationNumber | string | "59303411099" | name | string | "Nome do funcionário" | enableMonths | array | [1,5,6,7,9,12]
| Months | array | [5,9,12] |
Exemplo de Requisição: GET: api/rh/v1/RefificaPerAnt?page=1&pageSize=20&yearRectif=2026 Se atentar com a paginação. { "items": [ { "id": "2026-59303411099", "yearRectif": 2026, "companyCode": "1", "branchCode": "1", "type": "Funcionário", "registrationNumber": "59303411099", "name": "Admitido Antes da Retificação e Ativo", "enableMonths": [ 1, 2, 3, 6, 7, 8, 10, 11 ], "months": [ 3, 6, 7, 8, 10, 11 ] }, { "id": "2026-59429296027", "yearRectif": 2026, "companyCode": "1", "branchCode": "1", "type": "Funcionário", "registrationNumber": "59429296027", "name": "teste paginacao 8", "enableMonths": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ], "months": [ 3, 5 ] } ], "hasNext": false, "total": 2 } |
PUT: /api/rh/v1/RefificaPerAnt Nome | Descrição | Tipo | Obrigatório | Exemplo | id (obrigatório) | Código interno do funcionário | string | Sim | "2026-59303411099" | companyCode | Empresa ou Coligada | string | Sim | "10" | branchCode | Estabelecimento ou Filial | string | Sim | "1" | months | Meses retificados | array | Sim | [1,3,5,9,12] |
A partir do filtro realizado, ao clicar editar e confirmar, os dados serão enviados para o back-end. { "items": [ { "id":"2026-59303411099", "companyCode":"10", "branchCode":"11", "months":[1,2,6,8,12]
} ] } |
Para o retorno de erro, seguir a estrutura abaixo. Campo | Tipo | code | number | message | string | detailedMessage | string | type | string (“error”, “warning”, “success”) |
{ "code": 500, "detailedMessage": "", "message": "Internal Server Error", "type": "error" } |
|
|
|
Informações Técnicas da APIEste detalhamento tem como objetivo registrar os endpoints da interface da integração da tela desenvolvida utilizando PO-UI.
Objetivo: Busca dos dados para listagem dos funcionários e envio dos funcionários selecionados para o back-end.
Tipo de requisição: GET/PUT Endpoint: /api/rh/v1/RefificaPerAnt
Get: Query Params: Nome | Descrição | Tipo | Obrigatório | Exemplo | page | Número da página | number | Sim | 1 | pageSize | Tamanho da página | number | Sim | 20 | yearRectif | Ano retificação | number | Sim | Maior ou igual a 2026 | registrationNumber | CPF | number | Não | 59303411099 | branchCode | Filial (Multi Valores separados por vírgula) | string | Não | “D MG 01,D MG 02” |
Estrutura de Retorno: Campo | Tipo | Exemplo | id (obrigatório) | string | "2026-59303411099" | yearRectif(obrigatório) | number | 2026 | companyCode | string | "1" | branchCode(obrigatório) | string | “02” | type | string | "Funcionário" ou "Prestador" ou "Funcionário/Prestador" | registrationNumber | string | "59303411099" | name | string | "Nome do funcionário" | enableMonths | array | [1,5,6,7,9,12]
| Months | array | [5,9,12] |
Exemplo de Requisição: GET: api/rh/v1/RefificaPerAnt?page=1&pageSize=20&yearRectif=2026 Se atentar com a paginação. { "items": [ { "id": "2026-59303411099", "yearRectif": 2026, "companyCode": "1", "branchCode": "1", "type": "Funcionário", "registrationNumber": "59303411099", "name": "Admitido Antes da Retificação e Ativo", "enableMonths": [ 1, 2, 3, 6, 7, 8, 10, 11 ], "months": [ 3, 6, 7, 8, 10, 11 ] }, { "id": "2026-59429296027", "yearRectif": 2026, "companyCode": "1", "branchCode": "1", "type": "Funcionário", "registrationNumber": "59429296027", "name": "teste paginacao 8", "enableMonths": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ], "months": [ 3, 5 ] } ], "hasNext": false, "total": 2 } |
PUT: /api/rh/v1/RefificaPerAnt Nome | Descrição | Tipo | Obrigatório | Exemplo | id (obrigatório) | Código interno do funcionário | string | Sim | "2026-59303411099" | companyCode | Empresa ou Coligada | string | Sim | "10" | branchCode | Estabelecimento ou Filial | string | Sim | "1" | months | Meses retificados | array | Sim | [1,3,5,9,12] |
A partir do filtro realizado, ao clicar editar e confirmar, os dados serão enviados para o back-end. { "items": [ { "id":"2026-59303411099", "companyCode":"10", "branchCode":"11", "months":[1,2,6,8,12]
} ] } |
Para o retorno de erro, seguir a estrutura abaixo. Campo | Tipo | code | number | message | string | detailedMessage | string | type | string (“error”, “warning”, “success”) |
{ "code": 500, "detailedMessage": "", "message": "Internal Server Error", "type": "error" } |
|
|
|
|