> For the complete documentation index, see [llms.txt](https://docs.vrsoft.com.br/vrmaster/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vrsoft.com.br/vrmaster/manual-do-sistema/manual-do-sistema-vr-master/manual-do-sistema-vr-master-versoes/manual-do-sistema-vr-master-ferramentas-v4-6/manual-do-sistema-vr-master-ferramentas-v4-6-fiscal-retencao-tributo-efd-reinf/manual-do-sistema-vr-master-ferramentas-v4-6-fiscal-retencao-tributo-efd-reinf-geracao.md).

# Geração

## **INTRODUÇÃO**

A funcionalidade Retenção Tributo (EFD-Reinf) – Geração faz parte do módulo fiscal da ferramenta e tem como objetivo facilitar a apuração e o envio das informações de retenções tributárias exigidas pelo ambiente do eSocial / EFD-Reinf, atendendo à obrigatoriedade de escrituração dos eventos periódicos (R-4010, R-4020 etc.).

Por meio dessa opção, o usuário pode:

* Carregar retenções de tributos federais incidentes sobre serviços e aquisições;
* Gerar e validar os dados necessários para compor os eventos da EFD-Reinf;
* Configurar parâmetros como a data do fato gerador e o agrupamento de impostos;
* Gerar os arquivos XML prontos para envio ao ambiente da Receita Federal.

Essa rotina é essencial para garantir o cumprimento das obrigações acessórias, evitando inconsistências ou autuações fiscais.

## **RECURSOS E PARAMETRIZAÇÃO**

![](/files/m9woU7dXMZcH11F97UAI) - Consultar (Teclas de atalho F1 ou ALT+C ). Preencha os filtros da tela como desejar em seguida clique neste botão para trazer o resultado de sua consulta. O resultado dessa pesquisa aparecerá em seguida no centro da tela.

![](/files/NNPgFoq0PDbSjXEpnoSF)

***NOTA: A imagem acima pode ser utilizada como um modelo de cadastro real para sua empresa. Em caso de dúvidas, consulte o setor fiscal de sua empresa.***

![](/files/KcGVRpqAZYYgLvASl23e) - Exportações (Sem teclas de atalho). Utilize as exportações de Relatório, Arquivo e Planilha para uma lista ou consulta realizada. [Clique aqui e veja como funciona cada uma das exportações.](/vrmaster/equipamentos-homologados/instalacao-impressora-sweda-si-300s-windows/manual-do-sistema-vr-setup-pdv-instalacao-e-configuracao/instalacao-pdv/manual-do-sistema-vr-concentrador-ferramentas/manual-do-sistema-vr-master-cadastro-operacional-usuario/exportacoes-do-sistema.md)

![](/files/pE7BkPyShd4jdqcEFZOB) - Permissão (Sem teclas de atalho). Clique neste botão para dar permissão a usuários em ações da tela. [Clique aqui e veja o manual completo de permissões.](/vrmaster/equipamentos-homologados/instalacao-impressora-sweda-si-300s-windows/manual-do-sistema-vr-setup-pdv-instalacao-e-configuracao/instalacao-pdv/manual-do-sistema-vr-concentrador-ferramentas/manual-do-sistema-vr-master-cadastro-operacional-usuario/permissoes-do-sistema.md)

![](/files/KcoqHnEz0UnTlXzRLv2K) - Calendário (Teclas de atalho F6). Clique neste botão para abrir um calendário e selecionar uma data.

![](/files/5r7tj50Il7nFjcPTcyUZ) - Incluir (Teclas de atalho F2 ou ALT+I). Clique neste botão para realizar um novo cadastro de Alíquota;

![](/files/2in2QnCIasFj0RsnAnDH) - Excluir (Teclas de atalho F7 ou ALT+X). Após realizar a pesquisa selecione a alíquota e clique neste botão para excluir;

![](/files/Cf8gYgdNyp1QceX15GCW) - Filtro (Teclas de Atalho ALT+L). Utilize essa ferramenta para atribuir mais filtros a pesquisa que deseja realizar.

![](/files/nujdCyY0DzmCYpQCT2se) - Editar (Teclas de Atalho ALT+D). Após realizar a pesquisa selecione um item na lista e clique neste botão para realizar a modificação do cadastro de alíquota.

**Campos e funcionalidades:**

* Tipo Data: define o critério de apuração da retenção:
* Competência: considera o mês de competência do lançamento.
* Vencimento: considera a data de vencimento da retenção.
* Pagamento: considera a data em que o tributo foi efetivamente pago.
* Período: define o intervalo de tempo dos registros a serem exibidos na tela.
* Nº Documento: permite filtrar a busca por um número de documento específico.
* Código Recolhimento: campo destinado à filtragem por código de recolhimento do tributo, caso aplicável.

**Situação:** permite selecionar os registros conforme o status do processo: Pendente, Finalizado ou Todos

**Selecionar todos:** caixa de seleção para marcar todos os documentos listados na grid.

**Grid de documentos:**

* Selecionado: permite marcar individualmente os documentos desejados para ações futuras (ex: geração de XML).
* Nº Documento: número identificador do lançamento.
* Competência: mês/ano de referência do lançamento.
* Vencimento: data de vencimento do tributo.
* Valor: valor total da retenção.
* Situação: status atual da retenção (ex: FINALIZADO).
* Período Competência: indica se o recolhimento é Mensal, Decendial, etc.
* Botão "Consultar": atualiza a visualização da grid conforme os filtros selecionados.
* Botão "Sair": fecha a tela de consulta.

\*\*📌 Observações: \*\* A grid exibe apenas os documentos dentro do período informado, com base no critério de data selecionado. É possível selecionar documentos específicos para geração de eventos XML na próxima etapa. Os registros com situação "FINALIZADO" indicam que já passaram pelo processo de geração e validação.

**Consulta de Retenção Tributo Geração**

![](/files/NKV2vASCoSq9MhHK86NE)

* Campo de seleção Tipo Retenção - Permite a seleção de quais registros de retenções o cliente deseja ver.

## **RECURSOS E PARAMETRIZAÇÃO**

Esta tela é aberta ao clicar duas vezes sobre um documento listado na Consulta de Geração Retenção Tributo. A tela exibe os detalhes do documento de retenção selecionado, permitindo a visualização das informações por competência, valores gerados, fornecedores envolvidos e os tributos retidos. É ideal para verificar a composição do valor total gerado e a situação dos registros perante a EFD-Reinf.

\*\*Campos e funcionalidades: \*\*

\*\* Dados do Documento: \*\*

* Nº Documento: número sequencial do documento gerado.
* Competência: mês/ano de referência.
* Período Competência: tipo de periodicidade da retenção (ex: Mensal).
* Vencimento: data em que a retenção deve ser quitada.
* Valor: soma dos valores de retenção listados no quadro inferior.
* Situação: status do documento (ex: Finalizado, Pendente), que pode ser definido automaticamente pelo sistema.

\*\*Quadro: Retenções \*\*

**Tabela que lista os fornecedores e respectivos valores de retenções incluídas neste documento:**

* Selecionar todos: marca todos os registros da lista.
* Selecionado: marcação individual de cada linha para execução de ações.
* Fornecedor: exibe o código do fornecedor, com link clicável que direciona ao cadastro correspondente.
* Loja: identifica a filial/empresa vinculada à retenção.
* Retenções: exibe o tipo de tributo retido (neste caso, CSRF - PIS/COFINS/CSLL/IRRF).
* Valor Impostos: valor total da retenção para aquele fornecedor.
* Situação EFD Reinf: status da integração com o sistema da EFD-Reinf (pode estar em branco, transmitido, validado, etc.).

**Botões de ação (rodapé da grade):**

* Marcar/Incluir ![](/files/5r7tj50Il7nFjcPTcyUZ): ícone para indicar ou marcar retenções para geração.
* Extornar ![](/files/L96O5rLz7x4DeZz1ISZF): serve para reverter ou anular uma ação ou lançamento que já foi finalizado no sistema.
* Exportar: gera os dados em documento, planilha ou arquivo para impressão
* Transmitir ![](/files/H1ERMS7exqv595ThEdjV) : tem a função de enviar oficialmente as informações de retenção de tributos para a EFD-Reinf (Escrituração Fiscal Digital de Retenções e Outras Informações Fiscais).

## **CONFIGURAÇÃO**

![](/files/3smIXS8KwOMxVf4OTeQT)

* Grupo Econômico: Define o agrupamento da empresa, se houver controle por grupos (campo opcional).
* Classificação Tributária: Informa o enquadramento fiscal da empresa (ex: Lucro Real, Presumido, Simples).
* Contabilista: Campo para vincular o contador responsável.
* Representante: Campo para associar o representante legal da empresa.
* Tipo Ambiente: Define se o ambiente é de Produção (real) ou Homologação (teste).
* Obrigatoriedade ECD: Informa se a empresa é obrigada a entregar a ECD (Escrituração Contábil Digital).
* Desoneração da Folha: Indica se a empresa possui desoneração da folha de pagamento.
* Situação PJ: Mostra a situação da Pessoa Jurídica, como Normal, Inativa, etc.

## **R-4010 e R-4020**

**Geração do Registro R-4020 agregado e configuração da Data do Fato Gerador para R-4010 e R-4020.** O que foi alterado: O imposto IRRF foi removido do agrupamento do registro R-4020. Agora, o agrupamento considera apenas os tributos CSRF (PIS, COFINS e CSLL). Foi implementada a opção "Tipo Data" na geração de retenções, permitindo ao usuário definir a origem da data do fato gerador.

Essa atualização pode ser vista também em Financeiro > Contas Pagar > Fornecedor como base para a geração do REINF

![](/files/LG78llICVrCz11pfo90j)

O que essa atualização faz: Ao selecionar "Pagamento" como Tipo Data, o sistema utiliza a data de pagamento da parcela do fornecedor como data do fato gerador, refletida na tag do XML. Se outra opção for selecionada (como "Entrada"), o sistema considera a data de entrada do documento. Essa flexibilização garante a geração correta dos eventos R-4020 de acordo com a realidade fiscal da empresa.

**Retenção de Tributo EFD-Reinf (Evento R-4020 – Agregado)** A funcionalidade de geração do evento R-4020 da EFD-Reinf foi aprimorada com suporte ao envio de valores agregados.

Na tela "Cadastro de Geração Retenção Tributo" (Fiscal > Retenção Tributo (EFD Reinf) > Geração), ao carregar uma retenção do tipo CSRF (PIS/COFINS/CSLL), o sistema agora verifica se a flag "Agregado" está marcada no código de natureza de rendimento.

Caso esteja, durante a geração do XML, serão incluídas automaticamente as novas tags:

* – com o valor da base de cálculo utilizado na NF-e de Despesa;
* – com o somatório dos valores dos tributos CSRF (PIS/COFINS/CSLL/IRRF).

Essa atualização garante maior conformidade com a exigência de detalhamento para retenções agregadas conforme os padrões da EFD-Reinf.

**Retenção Tributo EFD Reinf – Otimizações na Geração de Retenções** Caminho: Fiscal > Retenção Tributo (EFD Reinf) > Geração

![](/files/hEME4WyqmNgDm2Mw8XDP)

Foram aplicadas melhorias no processo de geração de retenções vinculadas ao evento R-4020 da EFD Reinf, com foco na segurança e automação das seleções. Veja o que mudou:

\*\*1. Prevenção de carregamento duplicado \*\* Retenções que já foram vinculadas a documentos não serão mais exibidas no grid de carregamento. Isso evita que a mesma retenção seja usada em múltiplos cadastros, garantindo integridade das informações.

**2. Validação automática no cadastro** Ao salvar um novo cadastro de retenção, o sistema agora executa automaticamente a validação do método validarRetencaoTributoFornecedor(), que já era aplicada na etapa de carregamento. Isso previne inconsistências e reforça a conferência dos dados do fornecedor no momento da gravação

**3. Registro R-4020 com seleção e bloqueio automáticos** Quando o campo Registro estiver definido como R-4020, o sistema: Desabilita a edição do campo "Tipo Retenção". Deixa pré-selecionados os impostos CSLL, PIS, COFINS e IRRF, alinhando com a natureza agregada do evento.

**4. Seleção automática de impostos agregados** Ao selecionar uma retenção do tipo PIS, COFINS ou CSLL, o sistema seleciona automaticamente os demais tributos CSRF da mesma nota fiscal. Exemplo: se a retenção do PIS for marcada, o sistema marcará também COFINS e CSLL correspondentes àquela nota.

## **NOVIDADES DA VERSÃO**

**R-4010 - LUCROS E DIVIDENDOS** Na tela de ‘Cadastro de Geração Retenção Tributo’ (Fiscal > Retenção Tributo (EFD - REINF) > Geração), adicionar um botão com tooltip chamado ‘Distribuição de Lucros e Dividendos’.

![](/files/y6LQtZs4JzFbV8AJBreO)

Ação: Ao clicar no botão ‘Lucros e Dividendos’, o sistema abre a tela de ‘Distribuição de Lucros e Dividendos’ e deve conter os seguintes campos:

* Botão Importar;
* Botão Adicionar;
* Botão Remover;
* Botão Salvar;
* Botão Sair;
* Tabela com a exibição das colunas: Beneficiário, Data Fato Gerador, Natureza Rendimento, Valor Rendimento e Loja;
* Tabela totalizadora com a coluna Valor Total Rendimento;

![](/files/RdXHaQh0Viul3ULpDkY1)

Tela de Cadastro de Distribuição de Lucros e Dividendos: Ao clicar no botão ‘Adicionar’, o sistema abre a tela de ‘Cadastro de Distribuição de Lucros e Dividendos’ e contêm os seguintes campos essenciais para registro e transmissão correta das informações fiscais:

* Loja: Combobox exibindo todas as lojas existentes no banco de dados.
* Beneficiário: Campo de texto com botão CNS que, ao ser clicado, direciona para a tela de Consulta de Cadastro de Fornecedor.
* Data do Fato Gerador: Campo do tipo data para informar a data relevante para apuração fiscal.
* Natureza de Rendimento: Campo de texto com botão CNS que, ao ser clicado, direciona para a tela de Consulta de Código de Natureza de Rendimento - Pagamentos. Como padrão deve carregar o código de Natureza 12001;
* Valor do Rendimento: Campo numérico, sem limitação de caracteres, permitindo até duas casas decimais após a vírgula.

![](/files/5pYeVoeXIjGisx9pLmiM)

Na tela de ‘Distribuição de Lucros e Dividendos’, ao clicar em ‘Salvar’, o sistema gera um lançamento na tela de ‘Cadastro de Geração Retenção Tributo’, no frame ‘Retenções’. Na coluna ‘Retenções’, é exibida a descrição padrão ‘IRRF - Lucros e Dividendos’ quando o lançamento for proveniente da Distribuição de Lucros e Dividendos.

![](/files/f1drlb0v58WtkNBwvjCp)

Sobre o funcionamento de gerar XML : Na tela de ‘Cadastro de Geração de Retenções de Tributos’, após o carregamento dos valores de IRRF - Lucros e Dividendos, ao clicar em ‘Transmitir’, o sistema gera o XML do evento R-4010 seguindo a estrutura especificada abaixo:

![](/files/wk9L8HOVHlfCPA7VJjak)

**ADEQUAÇÃO PARA RETENÇÃO DO FUNRURAL (NOTA ENTRADA R-2055 DO REINF)**

A atualização permite que o VRMaster realize a retenção do Funrural (R-2055 do REINF) em ambos os casos:

1. Entrada de NF-e sem emissão de contra nota.
2. Entrada de NF-e com emissão de contra nota.

Na tela ‘Consulta de Retenção Tributo Geração’ (Caminho: Fiscal > Retenção Tributo (EFD Reinf) > Geração > Cadastro > Botão Carregar), ao consultar o Registro R-2055 e quando o Tipo de Retenção for igual a ‘Produtor Rural Pessoa Jurídica’, o sistema retorna as Notas Fiscais de Entrada e os valores retidos de Funrural.

![](/files/vQCXviUxE4RFIj1XaMW3)

Na tela ‘Consulta de Produtor Rural’ (Caminho: Fiscal > G.P.S. > Produtor Rural), o sistema aplica a mesma regra de negócio descrita na etapa acima desta análise para operações de NF-e de Entrada com fornecedores classificados como Produtor Rural Pessoa Jurídica que não exigem contra-nota (Nota de Saída). Adicionalmente, a tela exibe os valores retidos de Funrural, seguindo as condições previamente estabelecidas.

![](/files/ipf9qoeOFQi44rzo1vdV)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.vrsoft.com.br/vrmaster/manual-do-sistema/manual-do-sistema-vr-master/manual-do-sistema-vr-master-versoes/manual-do-sistema-vr-master-ferramentas-v4-6/manual-do-sistema-vr-master-ferramentas-v4-6-fiscal-retencao-tributo-efd-reinf/manual-do-sistema-vr-master-ferramentas-v4-6-fiscal-retencao-tributo-efd-reinf-geracao.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
