📘 E Social

🎯 - Objetivo

Consultar os períodos de apuração relacionados ao fechamento de folha no eSocial e acessar as informações dos eventos de fechamento/reabertura da competência.

A tela permite pesquisar por empresa, mês e ano, listar os períodos disponíveis e abrir a modal do eSocial com os eventos relacionados ao fechamento da folha.

📋 - Campos

🔹 Filtros de Pesquisa

• Empresa: Permite selecionar a empresa para consulta dos períodos de apuração do eSocial.
• Período Competência - Mês: Permite filtrar os registros por mês de competência.
• Período Competência - Ano: Permite filtrar os registros por ano de competência. Aceita valores entre 1900 e 2999.

🔹 Grid de Fechamento eSocial

• Empresa: Exibe a razão social da empresa relacionada ao período.
• Período: Exibe o período de apuração no formato yyyy-MM para competências mensais ou yyyy para apuração anual.
• S-1260: Campo exibido apenas quando o parâmetro de Produtor Rural Pessoa Física estiver habilitado. Permite indicar se a empresa possui informação de produtor rural para o período.
• Ações: Exibe o botão eSocial, utilizado para abrir a modal com as informações dos eventos vinculados ao período.

⚙️ - Ações Disponíveis

✅ - Regras de Negócio

• A tela é acessada a partir do botão eSocial da tela principal de Fechamento de Folha.
• Ao carregar a tela, o sistema preenche automaticamente a empresa logada e carrega a lista de meses.
• A pesquisa lista períodos de cálculo com data de início menor ou igual à data atual.
• Quando o mês é informado, a tela lista competências mensais no formato yyyy-MM.
• Quando o mês não é informado, a tela também pode listar a apuração anual de dezembro no formato yyyy.
• O botão eSocial tenta gerar identificadores para os eventos S-1280, S-1298 e S-1299.
• Se pelo menos um identificador for gerado, o sistema abre a modal do eSocial.
• Se nenhum identificador for gerado, o sistema exibe a mensagem: “Erro ao gerar identificador.”
• A coluna S-1260 somente fica visível quando o parâmetro Produtor Rural Pessoa Física estiver habilitado.
• Ao alterar o campo S-1260, o sistema salva a informação de produtor rural para empresa, mês e ano do registro.

🔹 - Eventos eSocial Relacionados

🧪 - Pontos de Teste QA

• Validar se a tela abre com a empresa logada preenchida e a lista de meses carregada.
• Selecionar uma empresa e validar se a grid retorna períodos da empresa selecionada.
• Informar mês e ano e validar se a grid retorna apenas a competência correspondente.
• Informar apenas o ano e validar se a grid retorna as competências do ano e, quando aplicável, a apuração anual.
• Pesquisar filtros sem registros e validar se a grid exibe “Sem itens”.
• Clicar no botão eSocial e validar se a modal é aberta quando existirem identificadores dos eventos.
• Validar o cenário em que nenhum identificador é gerado e o sistema exibe a mensagem “Erro ao gerar identificador.”
• Validar se a coluna S-1260 aparece somente quando o parâmetro de Produtor Rural Pessoa Física estiver habilitado.
• Alterar o valor da coluna S-1260 e validar se a informação é persistida para empresa, mês e ano.
• Validar a ordenação por Empresa/Período e a navegação entre as páginas da grid.

❓ - Dúvidas Frequentes

Apareceu a mensagem Erro ao Autenticar

Ocorre pois a integração com o eSocial só está disponível no ambiente de homologação, não é possível usar esta integração no ambiente de testes, caso esteja aparecendo no ambiente de homologação então pode ser um problema a ser reportado ao Desenvolvedor

Para que serve a tela Fechamento de Folha eSocial?

Serve para consultar competências de fechamento e acessar as informações dos eventos eSocial relacionados ao fechamento ou reabertura dos eventos periódicos.

Quais eventos aparecem ao clicar no botão eSocial?

A tela busca identificadores dos eventos S-1280, S-1298 e S-1299.

Por que aparece a mensagem “Erro ao gerar identificador.”?

Porque o sistema não conseguiu montar nenhum identificador válido para os eventos S-1280, S-1298 ou S-1299 daquele período.

Quando a coluna S-1260 aparece?

A coluna aparece quando o parâmetro Produtor Rural Pessoa Física está habilitado para a empresa.

O botão eSocial envia o fechamento para o governo?

Nesta tela, o botão abre a modal de informações do eSocial para os eventos identificados. O envio e a consulta ocorrem dentro do fluxo da integração eSocial exibido na modal.

🛠️ - Observações Técnicas

• Tela Principal: A rotina está implementada na página FechamentoFolhaEsocial.aspx.
• Code-behind: A lógica da tela está em FechamentoFolhaEsocial.aspx.cs.
• Listagem: A grid é carregada pela rotina FechamentoFolha.ListarEsocial.
• Identificadores eSocial: O botão eSocial utiliza os métodos eSocialIdentificadorS1280, eSocialIdentificadorS1298 e eSocialIdentificadorS1299.
• Modal eSocial: A abertura da modal é realizada pelo método MostrarModalEsocial.
• S-1260: A visibilidade da coluna depende do parâmetro ProdutorRuralPessoaFisica.
• Produtor Rural: A alteração da flag é persistida pelo método Empresa.SalvarFlagProdutorRural.

📌 Status: Concluído 👤 Responsável: Equipe de QA