Histórico da Página
Índice | ||||||
---|---|---|---|---|---|---|
|
Descrição
Esta Rotina, rotina tem como objetivo realizar a importação de xml XML para lucros e dividendos em atendimento aos conformidade com os leiautes da Reinf, bloco 40, contemplando os eventos R-4010 (Pagamentos/Créditos a Beneficiário PF) ou e o evento R-4020 (Pagamentos/Créditos a Beneficiário PJ).
Funcionamento
A rotina esta disponível no menu do TAF através do caminho: Miscelanea → Integração → Import. XML Lucros e Dividendos (TAFA618), com ela será possível realizar a importação dos XML's encaminhados , com esta funcionalidade, torna-se possível importar os XMLs enviados pelas instituições financeiras (bancos), e as . As informações contidas nos XML's nesses XMLs serão gravadas nas tabelas espelhos espelho do TAF para seu posterior envio, conforme os eventos da Efd 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.
Inicio da Rotina:
Ao acessar a rotina, será solicitado serão solicitados dois parâmetros, : o primeiro será é a escolha do diretório onde os arquivos XML 's estão armazenados, e o segundo é o identificador da importação (EvtAdic), ambos obrigatórios:
- Protheus
Importante que É importante selecionar a pasta com os arquivos seja selecionada e após isso, seja selecionada e, em seguida, escolher a opção de 'Salvar'.
- Diretório com os arquivos
Ao clicar em OK'Finalizar', será apresentado exibida uma tela confirmando se deseja realmente de confirmação para iniciar o processo, clicando em SIM o mesmo . Ao selecionar 'SIM', o processo será iniciado, e todos os arquivos com extensão XML na pasta serão processados.
Caso Se a importação seja for realizada com sucesso, o Protheus irá apresentar exibirá a mensagem de "'Importação realizada com sucesso!" ' e o processo é finalizado, os será concluído. Os arquivos na pasta de origem são serão movidos para uma pasta na protheus_data, no Protheus Data, no diretório: "\Protheus_data\out\xml\inproc
".
- Protheus
- Diretório com os arquivos na Protheus_Data
Caso haja algum XML com informação incorreta, o Protheus irá apresentar 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 origem serão movidos a uma pasta na protheus_data, diretório: "\Protheus_data\out\xml\inproc".
Nesse caso, na pasta origem dos arquivos, será criada uma pasta log, contendo um arquivo com extensão .log, esse arquivo contém a informação do XML que apresentou erro durante o processamento.
- Protheus
- Arquivo de log Gerado
O arquivo de log é gerado com o mesmo nome informando no campo evtadic e é criado para cada importação, desde que o nome informando 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 msgs 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 msg para cada registro que esta 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 msg:
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 msg:
- 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 img:
- 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 img 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 | C | 8 | naovazio() | 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 outra 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 |
---|---|---|---|---|---|---|---|---|---|
X1_GRUPO | X1_ORDEM | X1_PERGUNT | X1_VARIAVL | X1_TIPO | X1_TAMANHO | X1_GSC | X1_VALID | X1_VAR01 | X1_PICTURE |
TAF620REL | 01 | Periodo de Apuração ? | MV_CH1 | C | 6 | G | naovazio() | MV_PAR01 | @R 99-9999 |
TAF620REL | 02 | EvtAdic ? | MV_CH2 | C | 8 | G | naovazio() | MV_PAR02 | @! |