ESocial - Cadastros e Importação de Dados para os Prestadores

Características do Requisito

Descrição

O eSocial refere-se a uma parte da implantação do SPED, que envolve a receita federal, ministério do trabalho, INSS e caixa econômica federal e tem o objetivo de consolidar toda a comunicação das obrigações trabalhistas.

Nesta primeira entrega o foco do GPS é adaptar as manutenções do sistema para receber e compreender as novas informações que são obrigatórias para contemplar a integração com o governo.

O sistema receberá estas informações de duas formas: cadastro manual no sistema GPS ou através de importação de arquivo CSV.

Procedimento para Implantação

A implementação descrita no documento estará disponível a partir da atualização do pacote no cliente.

O pacote está disponível no portal (https://suporte.totvs.com/download).

Importante:

Antes de executar a atualização é recomendável realizar o backup do banco de dados bem como dos arquivos do Sistema (executáveis, .dlls e arquivos de configuração).

Realizar a atualização antes no ambiente de homologação e posterior a devida validação, no ambiente de produção.

Procedimento para Configuração 

CONFIGURAÇÃO DE MENUS

Deve ser importado o menu men_hcg.d, alteração conforme abaixo:

Devem ser executados os seguintes spp:

• spp/carga-dominios-esocial.p
  • Irá carregar os valores padrões referentes aos domínios do eSocial;
• spp/sp-atua-pfis-esocial.p
  • Irá ajustar a nova tabela de pessoa-esocial com dados referentes à pessoa física;
• spp/spatua-pais-esocial.p
  • Ajustar o código do país eSocial no cadastro de estados;

Versões de retrofit 12.1.16 e 12.1.17

A instalação do pacote de retrofit deve seguir os seguintes passos:

1. Copiar por cima do EAR atual, instalado no diretório <instalação_do_JBoss>/server/<instancia>/deploy, o EAR correspondente à versão datasul-byyou-12.1.16-SNAPSHOT.ear ou datasul-byyou-12.1.17-SNAPSHOT.ear;
2. Copiar por cima da pasta datasul-rest, contida no diretório <instalação_do_JBoss>/server/<instancia>;
3. Acessar o endereço: http://<ambiente-Totvs>:<porta>/dts/datasul-rest/loadAllJSON?reload=true  
   1. Deve abrir uma página com o seguinte conteúdo:
   2. 
4. Instalar dois componentes para duas novas telas HTML:
   1. No botão Escolher arquivo, acessar o diretório de instalação do datasul-rest, no Passo 2, <instalação_do_JBoss>/server/<instancia>/datasul-rest/fch/fchsau/hcg;
   2. Selecionar o arquivo fchsauesocialdomain.json:
   3. Em File PATH, informar o seguinte conteúdo fixo: "fch/fchsau/hcg" (sem as aspas);
   4. Clicar em Upload and Decode;
   5. No botão Escolher arquivo, acessar o diretório de instalação do datasul-rest, no Passo 2, <instalação_do_JBoss>/server/<instancia>/datasul-rest/fch/fchsau/hcg;
   6. Selecionar o arquivo fchsauimportacsvesocial.json:
   7. Em File PATH, informar o seguinte conteúdo fixo: "fch/fchsau/hcg" (sem as aspas);
   8. Clicar em Upload and Decode;

Procedimento para Utilização

Indicação de envio ao eSocial

Foram incluídos os campos "Envia eSocial" no programa Manutenção Grupo de Prestadores e "Indica envio do prestador ao eSocial" no Cadastro de Prestadores.

O parâmetro no Grupo de Prestadores indica se os prestadores serão exportados na geração do eSocial, servindo como um facilitador. O parâmetro no cadastro do prestador é onde se define se o mesmo será exportado. Possui as opções "0 - Grupo Prestador", "1 - Sim" ou "2 - Não", descritas a seguir:

• 0 - Grupo de Prestador: o prestador será exportado conforme a indicação no seu grupo, esse é o valor padrão;
• 1 - Sim: o prestador será exportado, independente do que o seu grupo indicar;
• 2 - Não: o prestador não será exportado, independente do que o seu grupo indicar;

Manutenção Grupo de Prestadores.

Detalhes do Grupo de Prestador.

Atenção:

A alteração do programa Manutenção Grupo de Prestadores será disponibilizada apenas na 12.1.19. Nas versões 12.1.16, 12.1.17 e 12.1.18 foi criado o programa Progress spp/sp-atua-gr-inst-prestador.p que permite ao usuário configurar o indicador de envio ao eSocial nos grupos de prestadores. 

Manutenção de Prestadores

Foram incluídos os novos campos para o eSocial na Manutenção de Prestadores, conforme tabelas a seguir.

Novas telas na Manutenção de Prestadores.

Dependentes do Prestador

Esse novo cadastro permite cadastrar os dependentes do prestador. Os dependentes são pessoas físicas associadas à pessoa física do prestador, de modo que um dependente criado pode ser consultado e alterado no programa Manutenção Pessoa Física.

Para incluir os dependentes dos prestadores deve acessar a função "F6 - Tabelas Associadas" no programa de menu "Manutenção de Prestadores", conforme segue ilustrado.

Na Função "10 Dependentes dos Prestadores", é possível realizar as operações de Adicionar, Alterar e Remover dependentes para o prestador, conforme imagem abaixo.

Ao Adicionar ou Alterar um dependente o sistema solicita algumas informações, conforme segue.

Importante: O cadastro de dependente não possui campos para endereço, desta forma os dependentes são cadastrados com o endereço do prestador.

Manutenção das Tabelas de Domínios do eSocial

Foi criado o novo programa Manutenção das Tabelas de Domínios do eSocial (hcg.eSocialDomainType), que manterá os domínios do layout eSocial utilizados pelo GPS.

Alguns domínios são fixos, isto é, o usuário não pode alterar pois pode afetar regras do sistema associadas ao valor. Outros domínios o usuário são livres para alteração, permitindo ao usuário atualizar o domínio caso conforme novas versões do layout eSocial.

Foi liberado o programa spp/carga-dominios-esocial.p que irá carregar todos os domínios referentes ao layout 2.3 do eSocial utilizados pelo GPS.

Exemplo de domínio que não pode ser alterado:

Exemplo de domínio que pode ser alterado, possui funções de Inclusão, Remoção e Edição:

Atualiza Dados do Prestador para o eSocial:

Foi criado o programa Atualização de Dados dos Prestadores para o eSocial (hcg.eSocialImportaCSV) para realizar a importação do arquivo CSV que irá atualizar os dados dos prestadores com as informações necessárias para o eSocial.

O programa exibe o layout do CSV e permite a seleção de um arquivo para atualização dos registros na base.

O processo importa parcialmente. Isso significa que todos os registros que não apresentarem erros, ou possuírem apenas avisos, são atualizados, enquanto os registros que possuem ao menos um erro não serão atualizados.

Como resultado, são gerados 3 arquivos na Central de Documentos:

• relErrosAtualizacao.csv - relatório de erros e avisos do processo. Registros com erros não são atualizados. Registros apenas com avisos são atualizados;
• relRegistrosAtualizados.csv - relatório com os registros atualizados com sucesso. Registros sem erros e com avisos ou registros sem erros nem avisos;
• relRegistrosNaoAtualizados.csv - arquivo contendo todos os registros não importados. Permitindo ao usuário ajustar o arquivo e importa-lo novamente;

Tipo de Registro 1 - Dados do Prestador

Esse tipo de registro exige que seja informado um código da unidade e prestador válidos, e o prestador deve ser uma pessoa física, pois não são criados novos prestadores, apenas atualizados as informações referentes ao eSocial.

Os campos a seguir não são atualizados. Se informados no arquivo de atualização, apenas consistem com o que está cadastrado no sistema, gerando um aviso para o usuário de divergência caso ocorra.

• Nome do Prestador;
• CPF;
• Data de nascimento;

Exemplo: Se no arquivo foi informado a data de nascimento 01/02/1970 e o prestador em questão está cadastrado como 05/05/1970, então será gerado o aviso "Pessoa fisica com Data de nascimento diferente. Data atual '05/05/1970'." no arquivo de erros. Entretanto o restante dos dados do prestador serão atualizados.

Os campos a seguir, se informados em branco no arquivo, serão mantidos a informação cadastral existente, ou seja, não são zerados nesse processo de atualização.

• Número do PIS/PASEP;
• Estado Civil;
• Nome da mãe;
• Nome do pai;
• Raça;
• Município de Nascimento;

Tipo de registro 2 - Dependentes

Os registros de dependentes são associados aos prestadores através dos campos de unidade e prestador, porém um registro de dependente não é vinculado a um registro de prestador. Isto é, o arquivo não precisa conter um registro do tipo 1 de um determinado prestador para que se possa criar seus dependentes.

Um registro do tipo 2 sempre irá criar um novo registro de dependente associado ao prestador, desde que não ocorra nenhum erro durante o processamento do arquivo. Caso ocorra, o dependente não será cadastrado, no relatório relErrosAtualizacao.csv serão gerados os erros correspondentes e o registro será exportado no arquivo relRegistrosNaoAtualizados.csv.

A criação dos dependentes gera uma nova pessoa física na base, com endereço igual ao de prestador.

SP para Atualizar Dados do Prestador para o eSocial:

Para usuários que não possuam o arquivo CSV, foi disponibilizado este SP (sp-atua-prestador-esocial) que visa facilitar a entrada de dados do eSocial de prestadores já cadastrados na base de dados.

ESocial - Cadastros e Importação de Dados para os Prestadores

Características do Requisito

Descrição

O eSocial refere-se a uma parte da implantação do SPED, que envolve a receita federal, ministério do trabalho, INSS e caixa econômica federal e tem o objetivo de consolidar toda a comunicação das obrigações trabalhistas.

Nesta primeira entrega o foco do GPS é adaptar as manutenções do sistema para receber e compreender as novas informações que são obrigatórias para contemplar a integração com o governo.

O sistema receberá estas informações de duas formas: cadastro manual no sistema GPS ou através de importação de arquivo CSV.

Procedimento para Implantação

A implementação descrita no documento estará disponível a partir da atualização do pacote no cliente.

O pacote está disponível no portal (https://suporte.totvs.com/download).

Importante:

Antes de executar a atualização é recomendável realizar o backup do banco de dados bem como dos arquivos do Sistema (executáveis, .dlls e arquivos de configuração).

Realizar a atualização antes no ambiente de homologação e posterior a devida validação, no ambiente de produção.

Procedimento para Configuração 

CONFIGURAÇÃO DE MENUS

Deve ser importado o menu men_hcg.d, alteração conforme abaixo:

Devem ser executados os seguintes spp:

• spp/carga-dominios-esocial.p
  • Irá carregar os valores padrões referentes aos domínios do eSocial;
• spp/sp-atua-pfis-esocial.p
  • Irá ajustar a nova tabela de pessoa-esocial com dados referentes à pessoa física;
• spp/spatua-pais-esocial.p
  • Ajustar o código do país eSocial no cadastro de estados;

Versões de retrofit 12.1.16 e 12.1.17

A instalação do pacote de retrofit deve seguir os seguintes passos:

1. Copiar por cima do EAR atual, instalado no diretório <instalação_do_JBoss>/server/<instancia>/deploy, o EAR correspondente à versão datasul-byyou-12.1.16-SNAPSHOT.ear ou datasul-byyou-12.1.17-SNAPSHOT.ear;
2. Copiar por cima da pasta datasul-rest, contida no diretório <instalação_do_JBoss>/server/<instancia>;
3. Acessar o endereço: http://<ambiente-Totvs>:<porta>/dts/datasul-rest/resources/api/application.wadl/add

1. Copiar por cima da pasta datasul-rest, contida no diretório <instalação_do_JBoss>/server/<instancia>;
2. Acessar o endereço: http://<ambiente-Totvs>:<porta>/dts/datasul-rest/resources/api/application.wadl/add

Procedimento para Utilização

Indicação de envio ao eSocial

Foram incluídos os campos "Envia eSocial" no programa Manutenção Grupo de Prestadores e "Indica envio do prestador ao eSocial" no Cadastro de Prestadores.

O parâmetro no Grupo de Prestadores indica se os prestadores serão exportados na geração do eSocial, servindo como um facilitador. O parâmetro no cadastro do prestador é onde se define se o mesmo será exportado. Possui as opções "0 - Grupo Prestador", "1 - Sim" ou "2 - Não", descritas a seguir:

• 0 - Grupo de Prestador: o prestador será exportado conforme a indicação no seu grupo, esse é o valor padrão;
• 1 - Sim: o prestador será exportado, independente do que o seu grupo indicar;
• 2 - Não: o prestador não será exportado, independente do que o seu grupo indicar;

Manutenção Grupo de Prestadores.

Detalhes do Grupo de Prestador.

Atenção:

A alteração do programa Manutenção Grupo de Prestadores será disponibilizada apenas na 12.1.19. Nas versões 12.1.16, 12.1.17 e 12.1.18 foi criado o programa Progress spp/sp-atua-gr-inst-prestador.p que permite ao usuário configurar o indicador de envio ao eSocial nos grupos de prestadores. 

Manutenção de Prestadores

Foram incluídos os novos campos para o eSocial na Manutenção de Prestadores, conforme tabelas a seguir.

Novas telas na Manutenção de Prestadores.

Dependentes do Prestador

Esse novo cadastro permite cadastrar os dependentes do prestador. Os dependentes são pessoas físicas associadas à pessoa física do prestador, de modo que um dependente criado pode ser consultado e alterado no programa Manutenção Pessoa Física.

Para incluir os dependentes dos prestadores deve acessar a função "F6 - Tabelas Associadas" no programa de menu "Manutenção de Prestadores", conforme segue ilustrado.

Na Função "10 Dependentes dos Prestadores", é possível realizar as operações de Adicionar, Alterar e Remover dependentes para o prestador, conforme imagem abaixo.

Ao Adicionar ou Alterar um dependente o sistema solicita algumas informações, conforme segue.

Importante: O cadastro de dependente não possui campos para endereço, desta forma os dependentes são cadastrados com o endereço do prestador.

Manutenção das Tabelas de Domínios do eSocial

Foi criado o novo programa Manutenção das Tabelas de Domínios do eSocial (hcg.eSocialDomainType), que manterá os domínios do layout eSocial utilizados pelo GPS.

Alguns domínios são fixos, isto é, o usuário não pode alterar pois pode afetar regras do sistema associadas ao valor. Outros domínios o usuário são livres para alteração, permitindo ao usuário atualizar o domínio caso conforme novas versões do layout eSocial.

Foi liberado o programa spp/carga-dominios-esocial.p que irá carregar todos os domínios referentes ao layout 2.3 do eSocial utilizados pelo GPS.

Exemplo de domínio que não pode ser alterado:

Exemplo de domínio que pode ser alterado, possui funções de Inclusão, Remoção e Edição:

Atualiza Dados do Prestador para o eSocial:

Foi criado o programa Atualização de Dados dos Prestadores para o eSocial (hcg.eSocialImportaCSV) para realizar a importação do arquivo CSV que irá atualizar os dados dos prestadores com as informações necessárias para o eSocial.

O programa exibe o layout do CSV e permite a seleção de um arquivo para atualização dos registros na base.

O processo importa parcialmente. Isso significa que todos os registros que não apresentarem erros, ou possuírem apenas avisos, são atualizados, enquanto os registros que possuem ao menos um erro não serão atualizados.

Como resultado, são gerados 3 arquivos na Central de Documentos:

• relErrosAtualizacao.csv - relatório de erros e avisos do processo. Registros com erros não são atualizados. Registros apenas com avisos são atualizados;
• relRegistrosAtualizados.csv - relatório com os registros atualizados com sucesso. Registros sem erros e com avisos ou registros sem erros nem avisos;
• relRegistrosNaoAtualizados.csv - arquivo contendo todos os registros não importados. Permitindo ao usuário ajustar o arquivo e importa-lo novamente;

Tipo de Registro 1 - Dados do Prestador

Esse tipo de registro exige que seja informado um código da unidade e prestador válidos, e o prestador deve ser uma pessoa física, pois não são criados novos prestadores, apenas atualizados as informações referentes ao eSocial.

Os campos a seguir não são atualizados. Se informados no arquivo de atualização, apenas consistem com o que está cadastrado no sistema, gerando um aviso para o usuário de divergência caso ocorra.

• Nome do Prestador;
• CPF;
• Data de nascimento;

Exemplo: Se no arquivo foi informado a data de nascimento 01/02/1970 e o prestador em questão está cadastrado como 05/05/1970, então será gerado o aviso "Pessoa fisica com Data de nascimento diferente. Data atual '05/05/1970'." no arquivo de erros. Entretanto o restante dos dados do prestador serão atualizados.

Os campos a seguir, se informados em branco no arquivo, serão mantidos a informação cadastral existente, ou seja, não são zerados nesse processo de atualização.

• Número do PIS/PASEP;
• Estado Civil;
• Nome da mãe;
• Nome do pai;
• Raça;
• Município de Nascimento;

Tipo de registro 2 - Dependentes

Os registros de dependentes são associados aos prestadores através dos campos de unidade e prestador, porém um registro de dependente não é vinculado a um registro de prestador. Isto é, o arquivo não precisa conter um registro do tipo 1 de um determinado prestador para que se possa criar seus dependentes.

Um registro do tipo 2 sempre irá criar um novo registro de dependente associado ao prestador, desde que não ocorra nenhum erro durante o processamento do arquivo. Caso ocorra, o dependente não será cadastrado, no relatório relErrosAtualizacao.csv serão gerados os erros correspondentes e o registro será exportado no arquivo relRegistrosNaoAtualizados.csv.

A criação dos dependentes gera uma nova pessoa física na base, com endereço igual ao de prestador.

SP para Atualizar Dados do Prestador para o eSocial:

Para usuários que não possuam o arquivo CSV, foi disponibilizado este SP (sp-atua-prestador-esocial) que visa facilitar a entrada de dados do eSocial de prestadores já cadastrados na base de dados.