Árvore de páginas



Descrição

Esta rotina tem como objetivo realizar a importação de XML para lucros e dividendos em conformidade com os leiautes da Reinf, bloco 40, contemplando os eventos R-4010 (Pagamentos/Créditos a Beneficiário PF) e o evento R-4020 (Pagamentos/Créditos a Beneficiário PJ).



Funcionamento

A rotina está disponível no menu do TAF através do caminho: Miscelânea → Integração → Import. XML Lucros e Dividendos (TAFA618), com esta funcionalidade, torna-se possível importar os XMLs enviados pelas instituições financeiras (bancos). As informações contidas nesses XMLs serão gravadas nas tabelas espelho do TAF para posterior envio, conforme os eventos da EFD Reinf, podendo ser o R-4010 (Pagamentos/Créditos a Beneficiário PF) ou o evento R-4020 (Pagamentos/Créditos a Beneficiário PJ).
Após a importação os eventos poderão ser transmitidos através do Painel Reinf.


Início da Rotina:



Ao acessar a rotina, serão solicitados dois parâmetros: o primeiro é a escolha do diretório onde os arquivos XML estão armazenados, e o segundo é o identificador da importação (EvtAdic)


  • Protheus


É importante selecionar a pasta com os arquivos e, em seguida, escolher a opção 'Salvar'.



  • Diretório com os arquivos


Ao clicar em 'Finalizar', será exibida uma tela de confirmação para iniciar o processo. Ao selecionar 'SIM', o processo será iniciado, e todos os arquivos com extensão XML na pasta serão processados.


Se a importação for realizada com sucesso, o Protheus exibirá a mensagem 'Importação realizada com sucesso!' e o processo será concluído. Os arquivos na pasta de origem serão movidos para uma pasta no Protheus_Data, no diretório: \Protheus_data\out\xml\inproc.

  • Protheus


  • Diretório com os arquivos na Protheus_Data


No caso de algum XML conter informações incorretas, o Protheus exibirá a mensagem de alerta 'Processo concluído, mas alguns arquivos não puderam ser importados. Favor verificar o arquivo de LOG'. Os arquivos na pasta de origem serão movidos para uma pasta no diretório Protheus Data: \Protheus_data\out\xml\inproc.
Nesse caso, na pasta de origem dos arquivos, será criada uma pasta chamada 'log', a qual conterá um arquivo com a extensão .log. Este arquivo inclui informações sobre o XML que apresentou o erro durante o processamento.


  • Protheus


  • Arquivo de log Gerado


O arquivo de log é gerado com o mesmo nome informado no campo evtadic e é criado para cada importação, desde que o nome informado no parâmetro evtadic seja diferente.


Exemplo de conteúdo informado no arquivo de Log:





Schedule


Foi criado o Job TAFA618 para uso no Schedule, abaixo será descrito um passo a passo para a configuração e também haverá informações sobre as mudanças necessárias para o funcionamento da rotina Via Job:

Foi criado no dicionário a seguinte pergunta na Sx1 para o conteúdo do EvtAdic:


  • Configuração do Schedule

Rotina de Schedule Antiga:

É necessário preencher o campo "Rotina" com o nome do Job e selecionar os parâmetros.


Rotina de Schedule Nova:

Em agendamento, clique em novo para adicionar um novo agendamento, na tela que aparecera na sequencia, informe o nome do Job "TAFA618", e clique em avançar.

Em Parâmetros, preencha o campo ideEvAdic:

A primeira tela que aparecera, será a configuração do agendamento, na próxima tela, a de parametrização, é necessário informar o ideEvAdic:

Com isso, basta escolher a recorrência e clicar em , o Job estará configurado.

Com isso, basta concluir as configurações do agendamento, e iniciar os serviços Task Manager e Queue Manager:


Após concluir a configuração, basta iniciar os serviços do Agent e Schedule e o Job estará funcionando conforme a recorrência escolhida.

Para saber mais sobre as configurações de Schedule, consulte os links Schedule-1 e Schedule-2.


  • Diretório da Pasta

A importação via rotina através do menu, permite que seja escolhida uma pasta tanto no servidor quanto local para a importação dos arquivos .xml, já na chamada por Job esse processo funciona um pouco diferente, sendo necessário a criação da pasta 'xml_import' na estrutura da Protheus_Data para o funcionamento correto do Job.

Caso a pasta 'xml_import' não seja criada manualmente, a mesma será criada na primeira execução do Job.


Nessa pasta, deverá ser colocado os arquivos .xml de lucros e dividendos para os eventos R-4010 e R-4020 para a importação, ficando da seguinte forma:


  • Console

Nesse próximo passo, será mostrado como as mensagens serão apresentadas no console durante a execução do job.

Na primeira chamada, caso a pasta contenha arquivos validos para a importação, será apresentada a seguinte mensagem no console:


Durante o processamento, será apresentada a seguinte mensagem para cada registro que está sendo importado:

  • Importação Lucros e dividendos evento R4010 
  • Importação Lucros e dividendos evento R4020 


No fim do processamento, caso não tenha sido importado algum arquivo com inconsistência no xml, ou não tenha ocorrido problema na apuração, será apresentada a seguinte mensagem:


Caso tenha sido importado algum arquivo com inconsistência no XML, ou tenha ocorrido algum problema na apuração, será apresentada a seguinte msg:


Caso a pasta 'xml_import' fique em algum momento vazia, sem nenhum arquivo xml valido, será apresentada a seguinte mensagem:


  • Arquivo de Log

A regra para a geração de arquivo de log não mudou, segue a mesma regra que a rotina TAFA618 executa, caso tenha sido importado um arquivo com inconsistência na estrutura do xml, ou caso tenha ocorrido algum problema na apuração, será gerado um arquivo .log na pasta origem da importação, nesse caso, será gerado na pasta 'xml_import', conforme imagem:




  • Conclusão

Após a realização do processo, os arquivos na pasta 'xml_import' serão excluídos da pasta origem, e serão armazenados na pasta out → xml → inproc, conforme imagem abaixo, com isso o processo de importação por Job esta finalizada, as informações estarão disponíveis no Painel Reinf, conforme o Período dos arquivos importados.


Diretório com os arquivos na Protheus_Data.


Painel Reinf


Disponibilizado o grupo de pergunta TAFA618S para utilização no Schedule. 

X1_GRUPO    

X1_ORDEM    

X1_PERGUNT    

X1_VARIAVL    

X1_TIPO    

X1_TAMANHO    

X1_VALID    

X1_VAR01    

TAFA618S     01    Informar EvtAdic ?MV_CH1    C8naovazio()MV_PAR01           





Relatórios


Com a utilização da rotina de importação de XML, se faz necessário a disponibilização de um relatório que demonstre as informações importadas dos lucros e dividendos.
Essa opção deverá ser disponibilizada em "Outras ações" nas rotinas TAFA545 (R-4010-Pagtos. de créditos a pessoa física) e TAFA546 (R-4020-Pagtos. de créditos a pessoa Jurídica).
A nova funcionalidade permitirá ao cliente especificar o caminho de armazenamento, o formato desejado (Excel ou PDF) e o conteúdo do campo IdeEvAdic.


Para realizar a impressão do relatório acesse a opção de outras ações da rotina TAFA545 (R-4010-Pagtos. de créditos a pessoa física) ou TAFA546 (R-4020-Pagtos. de créditos a pessoa Jurídica).




Em parâmetros, será possível informar o período de apuração e o EvtAdic para impressão do relatório, conforme imagens a seguir: 




Disponibilizamos o grupo de perguntas TAFA620REL para utilização no relatório. 

X1_GRUPO    

X1_ORDEM    

X1_PERGUNT    

X1_VARIAVL    

X1_TIPO    

X1_TAMANHO    

X1_GSC    

X1_VALID    

X1_VAR01    

X1_PICTURE

TAF620REL     01    Período de Apuração ?MV_CH1    C6Gnaovazio()MV_PAR01           @R 99-9999 
TAF620REL     02    EvtAdic ?MV_CH2    C8Gnaovazio()MV_PAR02           @!