Histórico da Página

...

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 - Pré-requisitos:

• Empresa cadastrada no sistema com mesmo código empresa do arquivo.
• Interface Origem cadastrada no sistema com mesma sigla de interface de origem do arquivo.
• Configuração Geral devidamente preenchida com diretórios de importação e geração.

1.2 - Visão Geral do Processo:

• Disponibilização (Manual/Externa): O arquivo JSON é deve ser salvo na pasta de entrada correspondente à empresa desse arquivo, no caso da entrada via API o arquivo será armazenado na pasta referente ao código empresa passado como parâmetro.
• Detecção e Processamento (Automático): Um Job agendado varre periodicamente as pastas de entrada, cria as pastas das empresas que tiverem sido cadastradas no sistema caso não tenha sido criadas ainda, 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.

...

3 - Estrutura de Diretórios:

A estrutura de pastas segue as empresas cadastradas no sistema.

...

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

1.

...

4 - Padrão de Nomenclatura do Arquivo:

O sistema ignorará irá mover para pasta de erros arquivos que não sigam estritamente o padrão de nomenclatura abaixo.

...

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

1.

...

5 - 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).

...

• Declarante: 
  • Fonte Pagadora (Lista): 
    • Agência/Conta (Lista): 
      • Rendimentos Isentos (Lista - Tabela 02)
      • Tributação Exclusiva (Lista - Tabela 03)
      • Bens e Direitos (Lista - Tabela 04)
      • Dívidas e Ônus (Lista - Tabela 05)

Ciclo de Vida e Pastas de Saída

O sistema move o arquivo automaticamente entre pastas para indicar o status do processamento.

NÃO REMOVA arquivos das pasta processando manualmente, pois inconsistências podem ser geradas por essas movimentações.

• /entrada: Local onde o usuário deposita o arquivo. O sistema lê daqui.
• /processando: O sistema move o arquivo para cá enquanto lê e grava no banco.

Destino Final (Pós-processamento):

• /sucesso: Todos os registros foram importados corretamente.
• /aviso: O arquivo foi importado, mas alguns declarantes/itens falharam (erros de negócio) e foram ignorados. O restante foi salvo.
• /erro: Falha crítica (JSON inválido, cabeçalho incorreto, erro de banco). Nada foi salvo.

Monitoramento de Erros

Para saber o motivo de um arquivo ter ido para a pasta /erro ou /aviso, utilize a tela de Monitoramento da Importação, emita um Relatório de Erros de Importação referente àquela importação de interesse ou a API de consulta de erros.

• Erros Impeditivos (Pasta Erro): Geralmente problemas estruturais como:
  • JSON quebrado
  • CodigoEmpresa no JSON não cadastrado no sistema ou em formato inválido
  • SiglaInterface inexistente no sistema ou formato inválido
  • Permissões insuficientes para criação das pastas ou movimentação dos arquivos
• Erros de Negócio (Pasta Aviso):
  • Cliente:
    • CPF/CNPJ inválido para cliente, ou combinação inválida (informado PF, mas fornecido CNPJ e vice-versa) - obrigatório
    • Nome vazio ou excede 255 caracteres - obrigatório
    • Tipo de pessoa inválida (valores aceitos F e J) - obrigatório
  • Fonte Pagadora:
    • Nome vazio ou excede 255 caracteres - obrigatório
    • CNPJ inválido - obrigatório
  • Agência e Conta:
  • Código de Domínio (Rendimento) não existente. Esses erros são registrados individualmente na tabela de erros do sistema.

2 - Consulta Status Importação

...