1 - Importação de dados

A importação de dados para o Informe de Rendimentos padrão é realizada por uma rotina de monitoramento de diretórios. Para o correto funcionamento dessa rotina os arquivos devem ser depositados na pasta de entrada da empresa correspondente àquele arquivo.

Também é possível efetuar a importação de um arquivo de até 1MB via API externa conforme documentado na página de DR - 01 - Especificação API - (STIR), e assim esse arquivo poderá ser lido pela rotina automática de acordo com o tempo especificado nas Configurações Gerais.

O sistema espera receber o arquivo JSON de uma competência específica com o seguinte padrão de nomenclatura: AAAAMM_SIGLA_SEQUENCIAL.json (ex.: 202513_CC_00001.json). 

Inicialmente só serão aceitas competências anuais para processamento, portanto, é imprescindível que os arquivos importados estejam no formato de competência anual com os dígitos finais referentes ao mês com o valor "13", conforme exemplo acima.

1.1 - Visão Geral do Processo:

• Disponibilização (Manual/Externa): O arquivo JSON é salvo na pasta de entrada correspondente à empresa desse arquivo.
• Detecção e Processamento (Automático): Um Job agendado varre periodicamente as pastas de entrada, valida os arquivos, processa o conteúdo (pasta processando) e move os arquivos para as pastas de destino conforme o resultado (sucesso, aviso ou erro).

1.2 - Estrutura de Diretórios:

A estrutura de pastas segue as empresas cadastradas no sistema.

• Padrão de entrada: {Diretorio_Raiz_Configurado}/{CODIGO_EMPRESA}/entrada/
• Diretorio_Raiz_Configurado: Caminho base definido nas Configurações Gerais do sistema.
• CODIGO_EMPRESA: Código numérico da empresa (ex: 12345).

Exemplo: Se o diretório raiz for C:\Users\usuario\produto_informe_rendimentos\dados\importacao e a empresa for 11111, o arquivo deve ser salvo em: C:\Users\usuario\produto_informe_rendimentos\dados\importacao\11111\entrada\

Veja mais detalhes da estrutura de pastas na página correspondente em DR - 02 - Estrutura de Pastas (importação) - (STIR).

1.3 - Padrão de Nomenclatura do Arquivo:

O sistema ignorará arquivos que não sigam estritamente o padrão de nomenclatura abaixo.

• Formato: AAAAMM_CC_NNNNN.json
• AAAAMM: Competência (Ano e Mês). Ex: 202513 (Anual).
• CC: Sigla da Interface de Origem (2 letras maiúsculas). Ex: DP, MN.
• NNNNN: Sequencial numérico (5 dígitos). Ex: 00001.
• Extensão: Obrigatório ser .json.

Exemplos:

202513_CC_00001.json (Válido)

202113_CF_99999.json (Válido)

202513_CC_1.json (Inválido - sequencial curto)

dados_importacao.json (Inválido - fora do padrão)

1.4 - Detalhes do Arquivo:

O conteúdo do arquivo deve estar em formato JSON válido e conter a estrutura abaixo. Veja a estrutura completa na página de DR - 03 - Instruções para preenchimento do arquivo de entrada (JSON) - (STIR).

{
  "Empresa": {
    "CodigoEmpresa": "12345",       // Deve existir no sistema empresa com tal código
    "SiglaInterface": "CC",         // Deve existir na tabela de interfaces de origem
    "Competencia": "202513",        // Formato AAAAMM (13 = Anual) - sem acento
    "ListaDeclarantes": [...]
  }
}

Validação de Cabeçalho (Erro Impeditivo)
Os dados dentro do objeto Empresa são validados contra o banco de dados:

• CodigoEmpresa: precisa existir empresa com mesmo código cadastrada no sistema
• SiglaInterface: precisa existir interface de origem cadastrada no sistema com mesma sigla 
• Competencia: precisa estar no mesmo formato da nomenclatura do arquivo AAAAMM (13 = Anual).

Se houver divergência, o arquivo é movido imediatamente para a pasta erro e nada é processado.

2 - Consulta Status Importação

3 - Geração de informe

4 - Consultar resultado de geração