Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

Link para esta página de comparações

Ambos lados da revisão anterior Revisão anterior
Próxima revisão
Revisão anterior
manual_usuario:outros:rh3_importador_xml_esocial [2018/10/10 01:05]
administrador
manual_usuario:outros:rh3_importador_xml_esocial [2021/10/06 12:35] (atual)
milson.catao [Uso do sistema]
Linha 8: Linha 8:
  
 ### ###
-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 eSocial ​provenientes de outros sistemas, possam ser incorporados à estrutura do eSocial ​existente no RH3 e assim serem validados no mesmo processo. ​
 ### ###
  
Linha 14: Linha 14:
 ---- ----
  
-{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_1.png?​400 |}}+{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_1.png?​600 |}}
  
 ### ###
-Este processo é validado através da importação de arquivos gerados por estes sistemas no formato XML, conforme a versão exigida pelo E-SOCIAL+Este processo é validado através da importação de arquivos gerados por estes sistemas no formato XML, conforme a versão exigida pelo eSocial
 ### ###
  
Linha 58: Linha 58:
 **1.1** Estrutura de diretórios **1.1** Estrutura de diretórios
  
-Adicionar na pasta onde o executável “ImportadorXML.exe” está, a seguinte estrutura: **esocial\schemas\v02_04_02**+Adicionar na pasta onde o executável “ImportadorXML.exe” está, a seguinte estrutura: **esocial\schemas\v02_05_00**
  
 **1.2** Arquivo de configuração **1.2** Arquivo de configuração
Linha 71: Linha 71:
   * Baixar os arquivos de validação (XSD) do eSocial vigente;   * Baixar os arquivos de validação (XSD) do eSocial vigente;
  
-  * Os arquivos podem ser encontrados no seguinte endereço: ​http://portal.esocial.gov.br/institucional/​documentacao-tecnica+  * Os arquivos podem ser encontrados no seguinte endereço: ​https://www.gov.br/esocial/​pt-br/​documentacao-tecnica/​documentacao-tecnica
  
   * Adicionar nesta pasta, o arquivo XSD adicional disponibilizado junto com o executável xmldsig-core-schema.xsd   * Adicionar nesta pasta, o arquivo XSD adicional disponibilizado junto com o executável xmldsig-core-schema.xsd
  
-  * A Última versão avaliada dos arquivos é: http://portal.esocial.gov.br/manuais/novos-esquemas-xsd-v2-4-02.zip+  * A Última versão avaliada dos arquivos é: https://www.gov.br/esocial/pt-br/​documentacao-tecnica/​manuais/​2021-03-30_esquemas_xsd_v02_05_00_nt21.zip
  
 ### ###
Linha 96: Linha 96:
 **1.** Os dados enviados automaticamente para o e-social; **1.** Os dados enviados automaticamente para o e-social;
  
-  * Todas as informações são enviadas pelo processo interno do RH3 sem integrar os dados importados +  * Todas as informações são enviadas pelo processo interno do RH3 sem integrar os dados importados; 
-Desta forma, cadastros de rúbricas, colaboradores,​ pagamentos etc. Apenas serão enviados automaticamente para e-social e não integrados ao RH3.+ 
 +  * Desta forma, cadastros de rúbricas, colaboradores,​ pagamentos etc. Apenas serão enviados automaticamente para e-social e não integrados ao RH3.
  
 **2.** Os dados são intermediados e integrados com o RH3; **2.** Os dados são intermediados e integrados com o RH3;
Linha 117: Linha 118:
 ### ###
  
 +###
 +Uma outra informação importante a ser destacada, É A NECESSIDADE de cadastrar o COLABORADOR/​AUTÔNOMO que tenha outro vínculo além do RH3 também no sistema. Isto é,  deverá ser cadastrado o OUTRO TIPO DE VÍNCULO no RH3 para que o sistema identifique-o corretamente e junte as informações no lote de remuneração (S-1200) e pagamento (S-1210).
 +###
 ====Configuração e uso do sistema==== ====Configuração e uso do sistema====
 ----  ---- 
Linha 124: Linha 128:
 ### ###
  
-**3.1**Cadastro de SISTEMAS DE ORIGEM de informações para o E-SOCIAL ​+**3.1** Cadastro de SISTEMAS DE ORIGEM de informações para o eSocial ​
  
-{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_2.png?​400 |}}+{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_2.png?​600 |}}
  
 ### ###
Linha 136: Linha 140:
 ### ###
  
-{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_3.png?​400 |}}+{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_3.png?​600 |}}
  
 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 E-SOCIAL ​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 E-SOCIAL, é 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: 
 +###
  
-{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_4.png?​400 |}}+{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_4.png?​600 |}}
  
 +###
 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.
 +###
  
 {{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_5.png?​400 |}} {{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_5.png?​400 |}}
  
 +###
 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 Emails ​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.
 +###
  
-{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_6.png?​400 |}}+{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_6.png?​600 |}} 
 + 
 +{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_7.png?​600 |}} 
 + 
 +**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. 
 +### 
 + 
 +{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_AjusteImportador_1.png?​500 |}} 
 + 
 +{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_AjusteImportador_2.png?​500 ​|}}
  
-{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_7.png?​400 |}} 
  
 ====Integrando informações de pagamento com o sistema RH3==== ====Integrando informações de pagamento com o sistema RH3====
 ---- ----
  
 +###
 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 e-Social ​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 ​S1200/S1210 e irá enviar para o E-Social ​automaticamente.+### 
 +Quando o COLABORADOR não tiver registro no RH3, o sistema preencherá a tabela ​S-1200/S-1210 ​e irá enviar para o eSocial ​automaticamente. 
 +###
  
 +###
 Quando o COLABORADOR tiver registro no RH3, o envio deverá ser feito pela própria tela de envio do RH3 para o evento correspondente,​ onde será feito a junção das informações importadas. Quando o COLABORADOR tiver registro no RH3, o envio deverá ser feito pela própria tela de envio do RH3 para o evento correspondente,​ onde será feito a junção das informações importadas.
 +###
  
-**Críticas na importação do XML e-Social**+**Críticas na importação do XML eSocial**
  
   * Valida se o arquivo importado é referente à mesma hierarquia selecionada para importação   * Valida se o arquivo importado é referente à mesma hierarquia selecionada para importação
Linha 182: Linha 219:
   * As validações de XML assim como a estrutra do arquivo validado com o XSD permanecem   * As validações de XML assim como a estrutra do arquivo validado com o XSD permanecem
  
-**4.1.** Validações Integração com o RH3 (registros de pagamento ​S1200 S1210)+**4.1.** Validações Integração com o RH3 (registros de pagamento ​S-1200 ​S-1210)
  
   * Verifica se o período está fechado   * Verifica se o período está fechado
-    * Validação realizada verificando se o mês de competência do e-social ​já foi fechado  +    * Validação realizada verificando se o mês de competência do eSocial ​já foi fechado  
-    * Verifica se o registro ​S1299 foi enviado e validado +    * Verifica se o registro ​S-1299 ​foi enviado e validado 
-  * É obrigatória a categoria do esocial ​informada ser a mesma cadastrada no RH3+  * É obrigatória a categoria do eSocial ​informada ser a mesma cadastrada no RH3
   * É obrigatória a rúbrica informada no evento estar cadastrada no RH3   * É obrigatória a rúbrica informada no evento estar cadastrada no RH3
   * A tag <​ideTabRubr>​ deve estar preenchida com o conteúdo "​RH3"​   * A tag <​ideTabRubr>​ deve estar preenchida com o conteúdo "​RH3"​
Linha 193: Linha 230:
   * É obrigatório o processo da FOLHA estar cadastrada para o COLABORADOR/​COOPERADO   * É obrigatório o processo da FOLHA estar cadastrada para o COLABORADOR/​COOPERADO
     * O processo é identificado a partir do grupo de pagamentos     * O processo é identificado a partir do grupo de pagamentos
-  * [OBSERVAÇÃO] Se for importado o EVENTO ​S1200, a data de pagamento utilizada para +  * [OBSERVAÇÃO] Se for importado o EVENTO ​S-1200, a data de pagamento utilizada para 
   carregar a tabela intermediária será a DATA DE PAGAMENTO DO PROCESSO DA FOLHA   carregar a tabela intermediária será a DATA DE PAGAMENTO DO PROCESSO DA FOLHA
  
Linha 199: Linha 236:
  
   * [ADVERTÊNCIA] Mesmo que o processo da FOLHA esteja fechado, o sistema irá importar o registro.   * [ADVERTÊNCIA] Mesmo que o processo da FOLHA esteja fechado, o sistema irá importar o registro.
-    * Como este processo não exige cálculo, apenas será necessário que o registro de fechamento ​S1299 não tenha sido enviado.+    * Como este processo não exige cálculo, apenas será necessário que o registro de fechamento ​S-1299 ​não tenha sido enviado.
  
 **4.1.2.** Para as informações que serão calculadas pelo RH3 **4.1.2.** Para as informações que serão calculadas pelo RH3
Linha 207: Linha 244:
     * Apenas informativo,​ não bloqueia a importação     * Apenas informativo,​ não bloqueia a importação
  
-**4.2.** Importando o S1210+**4.2.** Importando o S-1210
  
-* É obrigatório a importação do registro ​S1200 correspondente antes do registro ​S1210 +* É obrigatório a importação do registro ​S-1200 ​correspondente antes do registro ​S-1210 
-  * Esta validação é necessária para identificar a CATEGORIA do colaborador que só é informada no registro ​S1200 +  * Esta validação é necessária para identificar a CATEGORIA do colaborador que só é informada no registro ​S-1200 
-  * A categoria identificada no S1200 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 rúbricas ​apenas no evento ​S1200 e o total líquido a pagar no S1210. Ocorrendo esta situação, o sistema irá substituir as datas de pagamento das rúbricas ​para a data informada no evento ​S1210 cuja a chave ideDmDev seja a mesma informada no S1210.**+### 
 +**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 eSocial.
-Esta é a tela principal do sistema que será responsável pela importação dos arquivos XML para o e-social.+
  
 Ela está dividida em 3 áreas: Ela está dividida em 3 áreas:
Linha 229: Linha 267:
   -  Botões de operação da tela.   -  Botões de operação da tela.
  
 +{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_8.png?​600 |}}
 +
 +**1. Definição das informações importadas**
 +
 +  * **Hierarquia** – Selecione a hierarquia para qual o arquivo está configurado;​
 +
 +  * **Versão do arquivo** – Estará disponível as versões válidas para importação;​
 +
 +  * **Evento** – Evento do eSocial a ser importado;
 +
 +  * **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 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 S-1210 correspondentes novamente.
 +
 +**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.
 +###
 +
 +Abaixo você pode conferir uma sequência de telas que poderão ser apresentadas no após o processamento.
 +
 +{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_9.png?​600 |}}
 +
 +Ao processar o arquivo, o grid apresentará uma lista de todos os registros identificados.
 +
 +Os registros poderão ter 3 situações após o processamento:​
 +
 +  * JÁ FORAM IMPORTADOS, desta forma será identificado com uma cor VERDA;
 +
 +  * 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;
 +
 +{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_10.png?​600 |}}
 +
 +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.
 +###
 +
 +{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_11.png?​600 |}}
 +
 +**3. Botões de operação da tela**
 +
 +**Importar**
 +
 +Após o processamento,​ o usuário poderá importar os registros marcados (combos marcados em cada registro) para o sistema.
 +
 +**Reiniciar**
 +
 +O usuário poderá habilitar o reprocessamento dos arquivos novamente.
 +
 +**Ver erros**
 +
 +Mostra os erros identificados no processamento do arquivo após o processamento.
 +
 +**Fechar**
 +
 +Fecha a tela de processameto
 +
 +**Log de processamento**
 +
 +Chama uma consulta de processamentos já importados no sistema.
 +
 +**Log de processamento dos arquivos XML para o e-social**
 +
 +{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_12.png?​600 |}}
 +
 +Esta é a tela permite que o usuário possa consultar importações anteriores.
 +
 +Ela está dividida em 3 áreas:
 +
 +  - Filtros para consulta; \\ \\ 
 +  - Grid principal com os arquivos importados; \\ \\
 +  - Grid secundário com os registros de cada arquivo selecionado no 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.
 +###
 +
 +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.
 +
 +{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_13.png?​600 |}}
 +
 +{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_14.png?​600 |}}
 +
 +**Grid secundário**
 +
 +Este grid mostrará os registros do arquivo selecionado no grid principal.
 +
 +###
 +Nele será possível visualizar as ocorrências que ocorreram na importação,​ assim como o XML parcial apenas do registro selecionado.
 +###
 +
 +{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_15.png?​600 |}}
 +
 +{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_16.png?​600 |}}
 +
 +**Relatório**
 +
 +Um botão de impressão de relatório será disponibilizado após a aplicação do filtro de consulta;
 +
 +Este relatório irá mostrar todos os registros apresentados na tela.
  
 +{{ :​manual_usuario:​outros:​rh3_Importador_XML_ESOCIAL_v2_17.png?​700 |}}