Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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

...

Totvs custom tabs box
tabs1.Visão Geral,2.Menu,3.Integração,4.Informações Técnicas - APIs,5.Documentos Relacionados,6.Vídeos
idsvisao,menu,naveg,dicionario,tech,doc,vídeos
Totvs custom tabs box items
defaultyes
referenciavisao

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:


Totvs custom tabs box items
defaultno
referenciamenu

Image RemovedImage Added

Totvs custom tabs box items
defaultno
referencianaveg

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.


Image RemovedImage Added

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

Image RemovedImage Added


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

Image RemovedImage Added


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.

doc
Totvs custom tabs box items
defaultno
referenciatech

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.


Deck of Cards
idIntegracaoAhgora
Card
idIntegAhgoraLista
labelIntegração Funcionário

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.

Expandir
titleExemplo de retorno

{
    "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": 21
}


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.

Expandir
titleExemplo do postde retorno

{
    

branchCode: "items1"

companyCode: "eSo"

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

  [
    {
      "id"id: "2026-59303411099"13175924689"

months: [6]

name: "Sabrina Ayla Mariana Santos"

registrationNumber: "13175924689"

type: "Funcionário"

yearRectif: 2026,
      "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”)

Expandir
titleExemplo de retorno

{
    "code": 500,
    "detailedMessage": "",
    "message": "Internal Server Error",
    "type": "error"
}

Totvs custom tabs box items
defaultno
referencia







Video How

To | MP - SIGAGPE integração com a AhgoraHow To | PW - Ponto Web Ahgora integração com Protheus SIGAGPE

-To

  • Este video demonstra um exemplo do uso da nova tela, realizando a retificação do S-1210 de períodos anteriores.

Totvs custom tabs box items
defaultno
referenciavídeos
Cloak
id
Cloak
id
Conector de Widget
urlhttps://www.youtube.com/watch?v=QcdyH7eXKmE

       


Templatedocumentos

...