CONTEÚDO

  1. Visão Geral
  2. Menu
  3. Integração
  4. Informações Técnicas APIs
  5. Vídeos
  6. Documentos Relacionados
  7. Vídeos


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:

  • Somente estarão habilitados os meses em que o funcionário possui o evento S-1210 transmitido ao governo.


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 API

Este 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.

Importante: 

Caso utilize proxy reverso na configuração do servidor, deve ser adicionada a entrada na configuração do proxy reverso:

<LocationMatch "^/api/rh/v1/RetifPerAnt/">

    SecRuleRemoveById 911100

    SecRuleRemoveById 920420

</LocationMatch>



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]

name

Nome do funcionário

string

Não

"Sabrina"

registrationNumber

CPF do funcionário

string

Não

13175924689

type

Tipo do funcionário

string

Não

"Funcionário"

yearREctif

Ano da retificação

integer

Não

2026


A partir do filtro realizado, ao clicar editar e confirmar, os dados serão enviados para o back-end.

{
    

branchCode: "1"

companyCode: "eSo"

enableMonths: [2, 3, 5, 6, 7, 8, 9]

id: "2026-13175924689"

months: [6]

name: "Sabrina Ayla Mariana Santos"

registrationNumber: "13175924689"

type: "Funcionário"

yearRectif: 2026


}


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"
}