manual_usuario:outros:rh3_importador_xml_esocial
Diferenças
Aqui você vê as diferenças entre duas revisões dessa página.
Ambos lados da revisão anteriorRevisão anteriorPróxima revisão | Revisão anterior | ||
manual_usuario:outros:rh3_importador_xml_esocial [2021/10/06 12:30] – [Configuração e uso do sistema] milson.catao | manual_usuario:outros:rh3_importador_xml_esocial [2025/10/06 19:37] (atual) – [Uso do sistema] silvano.oliveira | ||
---|---|---|---|
Linha 7: | Linha 7: | ||
---- | ---- | ||
- | ### | + | |
O importador XML tem como objetivo, permitir que informações do eSocial provenientes de outros sistemas, possam ser incorporados à estrutura do eSocial existente no RH3 e assim serem validados no mesmo processo. | O importador XML tem como objetivo, permitir que informações do eSocial provenientes de outros sistemas, possam ser incorporados à estrutura do eSocial existente no RH3 e assim serem validados no mesmo processo. | ||
- | ### | + | |
====Introdução==== | ====Introdução==== | ||
Linha 16: | Linha 16: | ||
{{ : | {{ : | ||
- | ### | + | |
Este processo é validado através da importação de arquivos gerados por estes sistemas no formato XML, conforme a versão exigida pelo eSocial. | Este processo é validado através da importação de arquivos gerados por estes sistemas no formato XML, conforme a versão exigida pelo eSocial. | ||
- | ### | + | |
====O que você encontrará neste documento==== | ====O que você encontrará neste documento==== | ||
Linha 37: | Linha 37: | ||
**4.** Integrando informações de pagamento com o sistema RH3 | **4.** Integrando informações de pagamento com o sistema RH3 | ||
- | ### | + | |
O sistema permite que os dados de pagamento sejam integrados com os pagamentos realizados dentro do RH3 de forma que possam integrar a folha de pagamentos e/ou apenas envio dos dados para o e-social. | O sistema permite que os dados de pagamento sejam integrados com os pagamentos realizados dentro do RH3 de forma que possam integrar a folha de pagamentos e/ou apenas envio dos dados para o e-social. | ||
- | ### | + | |
**5.** Uso do sistema; | **5.** Uso do sistema; | ||
Linha 48: | Linha 48: | ||
---- | ---- | ||
- | ### | + | |
Os requisitos para utilização do executável são os mesmos do software RH3. Todas as configurações necessárias devem ser feitas para o funcionamento desta ferramenta. | Os requisitos para utilização do executável são os mesmos do software RH3. Todas as configurações necessárias devem ser feitas para o funcionamento desta ferramenta. | ||
- | ### | ||
- | ### | + | |
Recomendamos que o executável seja instalado na mesma pasta que o RH.exe está instalado, desda forma será necessário apenas a configuração complementar abaixo: | Recomendamos que o executável seja instalado na mesma pasta que o RH.exe está instalado, desda forma será necessário apenas a configuração complementar abaixo: | ||
- | ### | + | |
**1.1** Estrutura de diretórios | **1.1** Estrutura de diretórios | ||
Linha 77: | Linha 77: | ||
* A Última versão avaliada dos arquivos é: https:// | * A Última versão avaliada dos arquivos é: https:// | ||
- | ### | + | |
Estes são os procedimentos necessários para o funcionamento da ferramenta. Após a instalação, | Estes são os procedimentos necessários para o funcionamento da ferramenta. Após a instalação, | ||
- | ### | + | |
**Nota:** Não há controle de níveis de acesso para esta ferramenta. | **Nota:** Não há controle de níveis de acesso para esta ferramenta. | ||
Linha 86: | Linha 86: | ||
---- | ---- | ||
- | ### | + | |
O importador XML tem como objetivo, permitir que informações do e-Social provenientes de outros sistemas, possam ser incorporados à estrutura do e-Social existente no RH3 e assim serem validados no mesmo processo. | O importador XML tem como objetivo, permitir que informações do e-Social provenientes de outros sistemas, possam ser incorporados à estrutura do e-Social existente no RH3 e assim serem validados no mesmo processo. | ||
- | ### | ||
- | ### | + | |
Entretanto há duas considerações a serem levantadas, antes porém, é necessário entender que estas informações não são incorporadas ao sistema RH3 como cadastros em geral e informações de pagamento com excessão dos casos em que o colaborador tenha seu cadastro dentro do RH3, a seguir: | Entretanto há duas considerações a serem levantadas, antes porém, é necessário entender que estas informações não são incorporadas ao sistema RH3 como cadastros em geral e informações de pagamento com excessão dos casos em que o colaborador tenha seu cadastro dentro do RH3, a seguir: | ||
- | ### | + | |
**1.** Os dados enviados automaticamente para o e-social; | **1.** Os dados enviados automaticamente para o e-social; | ||
Linha 106: | Linha 106: | ||
* Nos casos em que os pagamentos importados forem de funcionários que têm cadastro no RH3, estes serão enviados pelo processo de envio tradicional do RH3, como se os pagamentos tivessem sido realizados dentro do sistema. Pois ele irá juntar as informações provenientes dos pagamentos no próprio RH3 com as informações importadas. Mais detalhes no item 4. | * Nos casos em que os pagamentos importados forem de funcionários que têm cadastro no RH3, estes serão enviados pelo processo de envio tradicional do RH3, como se os pagamentos tivessem sido realizados dentro do sistema. Pois ele irá juntar as informações provenientes dos pagamentos no próprio RH3 com as informações importadas. Mais detalhes no item 4. | ||
- | ### | + | |
O sistema também permite uma grande versatilidade, | O sistema também permite uma grande versatilidade, | ||
- | ### | ||
- | ### | + | |
Neste caso, se seu sistema tiver outras rúbricas diferentes dos registros do RH3, você poderá enviar os arquivos pelo importador, da mesma forma como o cadastro de colaboradores que não são gerenciados pelo RH3 e assim por diante. | Neste caso, se seu sistema tiver outras rúbricas diferentes dos registros do RH3, você poderá enviar os arquivos pelo importador, da mesma forma como o cadastro de colaboradores que não são gerenciados pelo RH3 e assim por diante. | ||
- | ### | ||
- | ### | + | |
É importante salientar uma vez que parte das informações são oriundas de sistemas diferentes, como registros de pagamento por exemplo, é preciso que os cadastros de colaboradores, | É importante salientar uma vez que parte das informações são oriundas de sistemas diferentes, como registros de pagamento por exemplo, é preciso que os cadastros de colaboradores, | ||
- | ### | ||
- | ### | + | |
Uma outra informação importante a ser destacada, É A NECESSIDADE de cadastrar o COLABORADOR/ | Uma outra informação importante a ser destacada, É A NECESSIDADE de cadastrar o COLABORADOR/ | ||
- | ### | + | |
====Configuração e uso do sistema==== | ====Configuração e uso do sistema==== | ||
---- | ---- | ||
- | ### | + | |
Uma vez que o sistema esteja instalado conforme as instruções anteriores, a configuração se dá pelos cadastros a seguir: | Uma vez que o sistema esteja instalado conforme as instruções anteriores, a configuração se dá pelos cadastros a seguir: | ||
- | ### | + | |
**3.1** Cadastro de SISTEMAS DE ORIGEM de informações para o eSocial | **3.1** Cadastro de SISTEMAS DE ORIGEM de informações para o eSocial | ||
Linha 132: | Linha 132: | ||
{{ : | {{ : | ||
- | ### | + | |
Este cadastro tem como objetivo fornecer a possibilidade do usuário configurar arquivos de diferentes origens a fim de adequar seu conteúdo às informações registradas no sistema RH3. | Este cadastro tem como objetivo fornecer a possibilidade do usuário configurar arquivos de diferentes origens a fim de adequar seu conteúdo às informações registradas no sistema RH3. | ||
- | ### | ||
- | ### | + | |
Sendo assim, cada arquivo poderá ter sua própria configuração frente à origem de seu sistema e ajustar o conteúdo para que seja compatível com o RH3. | Sendo assim, cada arquivo poderá ter sua própria configuração frente à origem de seu sistema e ajustar o conteúdo para que seja compatível com o RH3. | ||
- | ### | + | |
{{ : | {{ : | ||
Linha 144: | Linha 144: | ||
O cadastro permitirá configurar cada um dos campos que se faça necessário. | O cadastro permitirá configurar cada um dos campos que se faça necessário. | ||
- | ### | + | |
Todos os campos do eSocial são configuráveis para que as informações do sistema de origem possam ser adaptadas aos registros do eSocial no RH3. | Todos os campos do eSocial são configuráveis para que as informações do sistema de origem possam ser adaptadas aos registros do eSocial no RH3. | ||
- | ### | ||
- | ### | + | |
Para registrar um arquivo, é necessário que tenha ao menos 01 (uma) origem para que o sistema possa importar o XML, entretanto, caso se deseje realizar ajustes de conteúdo, isto é, alguma informação enviada pelo sistema de origem seja diferente dos cadastros do RH3 ou da informação necessária a ser enviada para o eSocial, é possível realizar a conversão a partir do cadastro DE-PARA conforme descrito a seguir: | Para registrar um arquivo, é necessário que tenha ao menos 01 (uma) origem para que o sistema possa importar o XML, entretanto, caso se deseje realizar ajustes de conteúdo, isto é, alguma informação enviada pelo sistema de origem seja diferente dos cadastros do RH3 ou da informação necessária a ser enviada para o eSocial, é possível realizar a conversão a partir do cadastro DE-PARA conforme descrito a seguir: | ||
- | ### | + | |
{{ : | {{ : | ||
- | ### | + | |
Após selecionar a versão ou o evento, o usuário deve informar ao sistema o nome do como e a informação que deseja substituir. O exemplo abaixo mostra bem esta situação. | Após selecionar a versão ou o evento, o usuário deve informar ao sistema o nome do como e a informação que deseja substituir. O exemplo abaixo mostra bem esta situação. | ||
- | ### | + | |
{{ : | {{ : | ||
- | ### | + | |
O usuário deseja modificar em todos os eventos na versão 02.04.01, o campo codCateg, quando estiver com o valor 900 trocar para 731. | O usuário deseja modificar em todos os eventos na versão 02.04.01, o campo codCateg, quando estiver com o valor 900 trocar para 731. | ||
- | ### | ||
- | ### | + | |
Abaixo é possível identificar uma estrutura do XML com várias chaves. O usuário escolhe uma delas e define as regras para a alteração da informação correta. | Abaixo é possível identificar uma estrutura do XML com várias chaves. O usuário escolhe uma delas e define as regras para a alteração da informação correta. | ||
- | ### | + | |
**3.2** Cadastro de e-mails para envio do relatório de importação | **3.2** Cadastro de e-mails para envio do relatório de importação | ||
- | ### | + | |
O sistema disponibiliza um cadastro de e-mails que serão utilizado para receber um relatório do processamento dos arquivos processados. | O sistema disponibiliza um cadastro de e-mails que serão utilizado para receber um relatório do processamento dos arquivos processados. | ||
- | ### | ||
- | ### | + | |
O sistema enviará este relatório para todos os e-mails cadastrados na lista; ele utilizará a funcionalidade de distribuição de e-mails do próprio sistema RH3. | O sistema enviará este relatório para todos os e-mails cadastrados na lista; ele utilizará a funcionalidade de distribuição de e-mails do próprio sistema RH3. | ||
- | ### | + | |
{{ : | {{ : | ||
Linha 184: | Linha 184: | ||
**3.3** Ajustes de Importação | **3.3** Ajustes de Importação | ||
- | ### | + | |
A função de ajustes de importação foi desenvolvida para permitir que os clientes que fizeram a importação dos cadastros de trabalhadores sem vínculo e posteriormente decidiram controlar o cadastro pelo RH3, ajustem estas informações no sistema para que o RH3 entenda que os registros cadastrados já foram enviados para o e-social e as alterações possam ser realizadas diretamente no RH3. | A função de ajustes de importação foi desenvolvida para permitir que os clientes que fizeram a importação dos cadastros de trabalhadores sem vínculo e posteriormente decidiram controlar o cadastro pelo RH3, ajustem estas informações no sistema para que o RH3 entenda que os registros cadastrados já foram enviados para o e-social e as alterações possam ser realizadas diretamente no RH3. | ||
- | ### | + | |
{{ : | {{ : | ||
Linha 196: | Linha 196: | ||
---- | ---- | ||
- | ### | ||
A integração com o sistema do RH3 se dá às informações referentes a programação e efetivação dos pagamentos dos colaboradores que estejam cadastrados no RH3, respectivamente os eventos S-1200 e S-1210. | A integração com o sistema do RH3 se dá às informações referentes a programação e efetivação dos pagamentos dos colaboradores que estejam cadastrados no RH3, respectivamente os eventos S-1200 e S-1210. | ||
- | ### | ||
- | ### | + | |
Todos os demais registros, mesmo que estejam cadastrados no RH3 que forem importados pela ferramenta, assim como pagamentos de colaboradores que não estejam cadastrados no RH3, serão encaminhados diretamente para o ambiente do eSocial através das tabelas do sistema RH3. | Todos os demais registros, mesmo que estejam cadastrados no RH3 que forem importados pela ferramenta, assim como pagamentos de colaboradores que não estejam cadastrados no RH3, serão encaminhados diretamente para o ambiente do eSocial através das tabelas do sistema RH3. | ||
- | ### | ||
- | ### | + | |
Quando o COLABORADOR não tiver registro no RH3, o sistema preencherá a tabela S-1200/ | Quando o COLABORADOR não tiver registro no RH3, o sistema preencherá a tabela S-1200/ | ||
- | ### | ||
- | ### | + | |
Quando o COLABORADOR tiver registro no RH3, o envio deverá ser feito pela própria tela de envio do RH3 para o evento correspondente, | Quando o COLABORADOR tiver registro no RH3, o envio deverá ser feito pela própria tela de envio do RH3 para o evento correspondente, | ||
- | ### | + | |
**Críticas na importação do XML eSocial** | **Críticas na importação do XML eSocial** | ||
Linha 250: | Linha 249: | ||
* A categoria identificada no S-1200 será utilizada nas tabelas de integração de pagamento com o RH3 | * A categoria identificada no S-1200 será utilizada nas tabelas de integração de pagamento com o RH3 | ||
- | ### | + | |
**Obs.: Alguns clientes podem enviar os registros das rubricas apenas no evento S-1200 e o total líquido a pagar no S-1210. Ocorrendo esta situação, o sistema irá substituir as datas de pagamento das rubricas para a data informada no evento S-1210 cuja a chave ideDmDev seja a mesma informada no S-1210.** | **Obs.: Alguns clientes podem enviar os registros das rubricas apenas no evento S-1200 e o total líquido a pagar no S-1210. Ocorrendo esta situação, o sistema irá substituir as datas de pagamento das rubricas para a data informada no evento S-1210 cuja a chave ideDmDev seja a mesma informada no S-1210.** | ||
- | ### | + | |
====Uso do sistema==== | ====Uso do sistema==== | ||
---- | ---- | ||
- | **5.1.** Importação dos arquivos XML para o e-social | + | **5.1.** Importação dos arquivos XML para o eSocial |
- | Esta é a tela principal do sistema que será responsável pela importação dos arquivos XML para o e-social. | + | Esta é a tela principal do sistema que será responsável pela importação dos arquivos XML para o eSocial. |
Ela está dividida em 3 áreas: | Ela está dividida em 3 áreas: | ||
Linha 275: | Linha 274: | ||
* **Versão do arquivo** – Estará disponível as versões válidas para importação; | * **Versão do arquivo** – Estará disponível as versões válidas para importação; | ||
- | * **Evento** – Evento do e-social | + | * **Evento** – Evento do eSocial |
* **Origem do arquivo** – Configuração de importação do arquivo. É importante que haja ao menos uma origem de arquivo cadastrada mesmo que não tenha nenhum campo de comparação (de-para); | * **Origem do arquivo** – Configuração de importação do arquivo. É importante que haja ao menos uma origem de arquivo cadastrada mesmo que não tenha nenhum campo de comparação (de-para); | ||
- | * **Arquivo que será importado** – Aqui você informará o arquivo que será importado para o e-social. \\ \\ **Nota**: É possível importar 1 arquivo de lote (lote modelo do próprio esocial) com até 50 registros, ou 50 registros individuais. \\ \\ Se o arquivo vier na estrutura de lote mesmo havendo menos de 50 registros, não será possível importar mais de um arquivo ao mesmo tempo; | + | * **Arquivo que será importado** – Aqui você informará o arquivo que será importado para o eSocial. \\ \\ **Nota**: É possível importar 1 arquivo de lote (lote modelo do próprio esocial) com até 50 registros, ou 50 registros individuais. \\ \\ Se o arquivo vier na estrutura de lote mesmo havendo menos de 50 registros, não será possível importar mais de um arquivo ao mesmo tempo; |
- | * **Substituir registros de pagamento** – Ao selecionar esta opção, os registros importados que tenham sidos importados anteriormente (apenas para integração) serão substituídos e será necessário importar os registros | + | * **Substituir registros de pagamento** – Ao selecionar esta opção, os registros importados que tenham sidos importados anteriormente (apenas para integração) serão substituídos e será necessário importar os registros |
**2. Grid com os registros do arquivo importado** | **2. Grid com os registros do arquivo importado** | ||
- | ### | + | |
Este grid mostrará o resultado do processamento do arquivo; ele mostrará previamente o resultado da validação antes da confirmação de importação para o sistema. | Este grid mostrará o resultado do processamento do arquivo; ele mostrará previamente o resultado da validação antes da confirmação de importação para o sistema. | ||
- | ### | + | |
Abaixo você pode conferir uma sequência de telas que poderão ser apresentadas no após o processamento. | Abaixo você pode conferir uma sequência de telas que poderão ser apresentadas no após o processamento. | ||
Linha 299: | Linha 298: | ||
* JÁ FORAM IMPORTADOS, desta forma será identificado com uma cor VERDA; | * JÁ FORAM IMPORTADOS, desta forma será identificado com uma cor VERDA; | ||
- | * JÁ PROCESSADOS PELO E-SOCIAL, neste caso o sistema identificou que o registro já foi enviado para o e-social e marca com cor AZUL; | + | * JÁ PROCESSADOS PELO eSocial, neste caso o sistema identificou que o registro já foi enviado para o e-social e marca com cor AZUL; |
* Registro COM ERRO, neste caso, identificado com algum problema de importação que será apresentado em um log de erro conforme a tela a seguir; | * Registro COM ERRO, neste caso, identificado com algum problema de importação que será apresentado em um log de erro conforme a tela a seguir; | ||
Linha 307: | Linha 306: | ||
Ao lado de cada registro, há um combo para que o usuário selecione apenas aqueles que deseja importar. | Ao lado de cada registro, há um combo para que o usuário selecione apenas aqueles que deseja importar. | ||
- | ### | + | |
Ao finalizar o processamento e o usuário decidir importar o arquivo para o sistema, será apresentada uma tela com o resultado da operação. | Ao finalizar o processamento e o usuário decidir importar o arquivo para o sistema, será apresentada uma tela com o resultado da operação. | ||
- | ### | + | |
{{ : | {{ : | ||
Linha 349: | Linha 348: | ||
**Grid principal** | **Grid principal** | ||
- | ### | + | |
Após a seleção, o sistema apresentará uma lista dos arquivos importados; nele será possível ver qual foi o evento e o status do mesmo. | Após a seleção, o sistema apresentará uma lista dos arquivos importados; nele será possível ver qual foi o evento e o status do mesmo. | ||
- | ### | ||
- | Além disso será possível ver o conteúdo do xml importado e salvar em arquivo para em meio digital para posterior conferência. | + | |
+ | Além disso será possível ver o conteúdo do XML importado e salvar em arquivo para em meio digital para posterior conferência. | ||
{{ : | {{ : | ||
Linha 363: | Linha 362: | ||
Este grid mostrará os registros do arquivo selecionado no grid principal. | Este grid mostrará os registros do arquivo selecionado no grid principal. | ||
- | ### | + | |
- | Nele será possível visualizar as ocorrências que ocorreram na importação, | + | Nele será possível visualizar as ocorrências que ocorreram na importação, |
- | ### | + | |
{{ : | {{ : |
manual_usuario/outros/rh3_importador_xml_esocial.1633523420.txt.gz · Última modificação: por milson.catao