Ver código fonte para SC 25 Criacao do Registro Y600 da ECF

[[Importacoes Dados]]

== Objetivo ==

Este Smart Component permite importar os Registros Y600 da ECF por meio de uma planilha Excel, agilizando o carregamento das informações societárias dos cooperados e participantes da entidade.

Além de reduzir lançamentos manuais, a rotina realiza validações automáticas e apura valores de Lucros e Dividendos, Juros sobre Capital Próprio e IR Retido com base nos eventos informados, contribuindo para maior confiabilidade das informações e para o correto atendimento das exigências da ECF.

== Pré-requisitos ==

* Acesso ao recurso '''1957 - Iniciar Smart Component'''.
* Acesso ao Smart Component '''25 - Criacao do Registro Y600 da ECF'''
* Existir uma ECF previamente cadastrada.
** Recurso vinculado: '''1325 - Geração Arquivo Sped ECF'''.
* Possuir cooperados devidamente cadastrados no sistema.
** Recurso vinculado: '''1529 - Cooperado'''.
* Possuir eventos de Cooperados para o período da ECF.
** Recurso vinculado: '''1526 - Evento Cooperado'''.
* Disponibilizar a planilha exclusivamente no formato Excel (.xlsx).
* Informar pelo menos um grupo de eventos de Cooperados nos parâmetros do Smart.

== Fluxo Principal ==

O processo de importação é realizado a partir da seleção de uma ECF previamente cadastrada e da definição dos eventos de Cooperado que serão utilizados na composição dos valores do Registro Y600.

# Acesse o recurso '''1957 - Iniciar Smart Component'''.
# Pesquise e selecione a ECF que receberá os registros.
# Informe os identificadores dos Tipos de Eventos de Cooperado que serão considerados na composição dos valores de Lucros e Dividendos, Juros sobre Capital Próprio e/ou IR Retido.
# Defina a forma de identificação dos participantes na planilha.
#* ID Pessoa ou ID Cooperado.
# Acione o botão "Importar Dados.
# Anexe o arquivo Excel e confirme para executar o processamento.
# Analise as inconsistências eventualmente identificadas.
# Efetue as correções necessárias.
# Execute uma nova importação, quando aplicável.
# Finalizado o processamento sem inconsistências, os registros serão vinculados à ECF selecionada.

=== Orientação para preenchimento de campos ===

{| class="wikitable"
! Nome do campo
! Objetivo
! Orientação de preenchimento
|-
| ECF
| Determinar a escrituração que receberá os registros importados
| Selecione uma ECF válida e previamente cadastrada.
|-
| Eventos de Lucros e Dividendos
| Identificar os lançamentos que compõem os valores distribuídos aos participantes
| Informe o identificador dos eventos de Cooperado que representam pagamentos de lucros e dividendos.
|-
| Eventos de Juros sobre Capital Próprio
| Identificar os lançamentos que representam remuneração por capital próprio
| Informe o identificador dos eventos de Cooperado que representam valores de Juros sobre Capital Próprio.
|-
| Eventos de IR Retido
| Determinar os valores de imposto retido associados aos participantes
| Informe o identificador dos eventos de Cooperado que representam valores de IR Retido 
|-
| Tipo de Identificação da Planilha
| Definir como o sistema localizará o cooperado
| Escolha a identificação por Pessoa ou por Colaborador, conforme a estrutura da planilha.
|-
| Arquivo de Importação
| Disponibilizar os dados para processamento
| Realize o upload exclusivamente de arquivos no formato .xlsx.
|}

== Estrutura da Planilha ==

A importação dos Registros Y600 é realizada por meio de uma planilha Excel no formato XLSX. Cada linha representa um cooperado ou participante que será considerado na geração dos registros da ECF.

A primeira linha da planilha deve ser utilizada como cabeçalho. O processamento dos dados inicia a partir da segunda linha.

É importante respeitar a ordem das colunas para que as informações sejam interpretadas corretamente durante a importação.

=== Layout Esperado ===

{| class="wikitable"
! Coluna
! Campo
! Descrição
! Obrigatório
|-
| A
| Identificador da Pessoa ou Colaborador
| Código utilizado para localizar o cooperado cadastrado no sistema.
| Sim
|-
| B
| Nome da Pessoa
| Nome do cooperado ou participante. Utilizado como apoio para conferência das informações.
| Não
|-
| C
| Data de Entrada do Cooperado
| Data de ingresso no quadro societário.
| Sim
|-
| D
| Data de Saída do Cooperado
| Data de desligamento do quadro societário, quando aplicável.
| Não
|-
| E
| Percentual sobre Capital Total
| Percentual de participação do cooperado no capital total da entidade.
| Recomendado
|-
| F
| Qualificação do Cooperado
| Código da qualificação societária que será utilizada na geração do Registro Y600.
| Sim
|}

=== Exemplo de Preenchimento ===

{| class="wikitable"
! Coluna A
! Coluna B
! Coluna C
! Coluna D
! Coluna E
! Coluna F
|-
| 1001
| João Silva
| 01/01/2025
|
| 12,50
| 01
|-
| 1002
| Maria Souza
| 15/02/2025
|
| 8,75
| 02
|}

=== Regras para Preenchimento ===

* O arquivo deve ser salvo obrigatoriamente no formato '''.xlsx'''.
* O identificador informado deve existir no cadastro de cooperados.
* A forma de identificação dependerá da configuração escolhida na importação (Pessoa ou Colaborador).
* A Data de Entrada deve conter uma data válida.
* A Data de Saída pode permanecer em branco quando não houver desligamento do cooperado.
* O Percentual sobre Capital Total aceita valores numéricos com ponto ou vírgula decimal.
* A Qualificação do Cooperado deve corresponder a um código válido para o Registro Y600.
* Linhas completamente vazias serão desconsideradas durante o processamento.

=== Validações Realizadas ===

Durante a importação, o sistema executa validações para garantir a consistência das informações:

* Existência do cooperado informado.
* Validade da Data de Entrada.
* Validade da Data de Saída, quando preenchida.
* Existência da Qualificação do Cooperado.
* Estrutura mínima da planilha com todas as colunas obrigatórias.

Caso alguma inconsistência seja identificada, o sistema disponibilizará um relatório contendo a linha da planilha e a descrição do problema encontrado, permitindo a correção antes de uma nova importação.

=== Comportamento em Reimportações ===

Ao executar uma nova importação, o sistema remove os Registros Y600 atualmente vinculados à ECF selecionada antes de processar os dados da nova planilha.

Dessa forma, a importação é tratada como uma substituição completa das informações do Y600, garantindo que os registros existentes sejam totalmente reconstruídos a partir do arquivo importado.

'''Importante:'''

* Registros Y600 existentes não são mesclados com os novos dados.
* Alterações realizadas manualmente poderão ser substituídas durante uma nova importação.
* Recomenda-se validar integralmente a planilha antes da execução do processo.
* Caso seja necessária a manutenção de registros já existentes, eles deverão estar presentes na nova planilha de importação.

== Funcionalidades ==

* '''Importação de Registros Y600''': Permite carregar informações societárias em lote por meio de uma planilha Excel, eliminando a necessidade de inclusão manual de cada registro.
* '''Apuração Automática dos Rendimentos''': Os valores de Lucros e Dividendos, Juros sobre Capital Próprio e IR Retido podem ser calculados automaticamente a partir dos eventos financeiros informados durante o processamento.
* '''Atualização da ECF''': Após a validação das informações, os registros Y600 são vinculados à ECF selecionada para utilização nos processos de escrituração.
* '''Geração de Relatório de Inconsistências''' Quando forem encontradas divergências, o sistema disponibiliza uma planilha contendo a linha da ocorrência e a descrição do problema identificado.

== Problemas e Soluções ==

{| class="wikitable"
! Problema
! Solução
|-
| ECF não localizada
| Verifique se a ECF informada está cadastrada e disponível para utilização.
|-
| Nenhum evento informado
| Informe pelo menos um grupo de eventos de Cooperado para permitir o processamento.
|-
| Arquivo não anexado
| Realize o upload da planilha antes de executar a importação.
|-
| Arquivo em formato inválido
| Utilize exclusivamente arquivos Excel com extensão .xlsx.
|-
| Cooperado não localizado
| Confirme o identificador informado e verifique se o cadastro existe no sistema.
|-
| Qualificação inválida
| Informe um código de qualificação entre 01 e 18.
|-
| Data de entrada inválida
| Corrija a informação utilizando um formato de data válido.
|-
| Data de saída inválida
| Informe uma data válida ou remova o conteúdo quando não houver saída do quadro societário.
|-
| Planilha com informações incompletas
| Verifique se todos os campos obrigatórios estão preenchidos corretamente.
|}

== Exemplos de Uso ==

* Um analista fiscal precisa importar informações de centenas de cooperados para geração da ECF. Utilizando a rotina, ele realiza a carga em lote dos registros, reduzindo significativamente o tempo de processamento.
* Um gestor contábil deseja validar os valores de lucros distribuídos durante o período da escrituração. Ao configurar corretamente os eventos financeiros, o sistema realiza a apuração automática dos valores.
* Um operador identifica inconsistências no relatório gerado após a importação. Com base nas mensagens apresentadas, realiza os ajustes necessários na planilha e efetua um novo processamento.

== Observações Gerais ==

* A planilha utilizada na importação deve estar obrigatoriamente no formato XLSX.
* Pelo menos um grupo de eventos financeiros deve ser informado para que o processamento seja executado.
* A qualificação do cooperado deve corresponder a um código válido para geração do Registro Y600.
* Caso o cooperado informado não seja localizado, o registro correspondente não será importado.
* Recomenda-se sempre analisar o relatório de inconsistências antes de realizar um novo processamento.
* Os valores financeiros são calculados com base nos eventos informados e no período de apuração da ECF.
* Datas inválidas impedem a importação do respectivo registro.
* A correta manutenção dos cadastros reduz inconsistências e retrabalho durante a escrituração.

== Benefícios do Recurso ==

* Reduz o tempo necessário para composição dos Registros Y600.
* Elimina grande parte dos lançamentos manuais.
* Aumenta a confiabilidade das informações societárias e fiscais.
* Automatiza a apuração de rendimentos vinculados aos participantes.
* Auxilia no cumprimento das obrigações acessórias.
* Diminui erros operacionais e inconsistências cadastrais.
* Proporciona maior agilidade na preparação da ECF.

== Glossário de Termos ==

* '''ECF:''' Escrituração Contábil Fiscal utilizada para apresentação de informações fiscais e societárias.
* '''Registro Y600''': Conjunto de informações relacionadas aos sócios, cooperados ou titulares e seus respectivos rendimentos.
* '''Cooperado''': Participante vinculado à cooperativa ou entidade.

== Links Relacionados ==

* [[1529 Cooperado]]
* [[1526 Evento Cooperado]]
* [[1957 Iniciar Smart Component]]