O que é
A importação via CSV permite cadastrar grandes volumes de dados no Quírons sem precisar incluir cada registro manualmente.
O processo é realizado em duas etapas: primeiro, o arquivo passa por uma pré-validação, permitindo identificar e corrigir problemas antes da importação. Após a confirmação, os registros são processados e gravados no sistema.
Passo a passo
Etapa 1 — Pré-validação
Acesse Minha conta > Organização > Importação de Dados.
Selecione CSV e clique em Importar.
Escolha o tipo de entidade que deseja importar.
Faça o upload do arquivo CSV.
Aguarde a análise do arquivo.
Após a análise, o sistema apresentará:
Total de linhas encontradas;
Quantidade de linhas válidas;
Quantidade de linhas inválidas;
Número da linha e motivo do erro para cada registro inválido.
Você pode revisar os erros e corrigir o arquivo antes de confirmar a importação.
Geração do S-2220 na importação de ASO
Ao importar a entidade ASO, também será apresentada a opção Gerar evento S-2220.
Habilite essa opção quando desejar que, além da importação dos ASOs, sejam gerados os respectivos eventos S-2220 para envio ao eSocial.
Etapa 2 — Confirmação
Após confirmar, a importação será iniciada em segundo plano e o progresso poderá ser acompanhado pela própria tela.
Cada importação confirmada gera um lote de processamento, permitindo acompanhar o andamento da importação e, quando aplicável, da geração dos eventos S-2220.
Ao final, o lote apresentará um dos seguintes status:
Status | Significado |
Em processamento | A importação ainda está em andamento |
Concluída | Todos os registros foram processados com sucesso |
Concluída com erros | Parte dos registros foi processada e os registros com erro podem ser consultados no arquivo gerado |
Falhou | A importação não pôde ser concluída |
Ao final do processamento, é disponibilizado um arquivo CSV contendo as colunas originais da importação e as informações Importou, Gerou XML, Motivo e Erro.
Esse arquivo permite identificar o resultado de cada registro e, quando necessário, corrigir as linhas com erro para realizar uma nova importação.
Os arquivos gerados ficam disponíveis para consulta por 72 horas.
Formato do arquivo
O arquivo utilizado na importação deve seguir o seguinte padrão:
Atributo | Valor |
Extensão |
|
Separador de colunas |
|
Delimitador de texto |
|
Codificação | UTF-8 |
Primeira linha | Cabeçalho com os nomes das colunas |
As colunas obrigatórias e os formatos esperados podem variar de acordo com a entidade selecionada. Consulte a estrutura específica de cada entidade antes de preparar o arquivo.
Limites e recomendações
São suportados arquivos de até 50 MB.
Embora não exista um limite geral fixo de linhas, para arquivos com grande volume de informações é recomendado realizar a importação em lotes menores, preferencialmente de até 10.000 linhas.
Essa divisão facilita o acompanhamento do processamento e a identificação e correção de possíveis erros.
Importante!
Caso o processamento seja interrompido, os registros que já tiverem sido gravados permanecerão no sistema. Por isso, para grandes volumes, dividir a importação em arquivos menores torna o processo mais fácil de controlar.
Validações aplicadas
As validações podem ocorrer em dois momentos: durante a pré-validação do arquivo ou durante o processamento dos registros.
Pré-validação
Antes da confirmação, o sistema verifica a estrutura e o preenchimento do arquivo.
Validação | Regra |
Campo obrigatório | Não pode estar em branco quando definido como obrigatório para a entidade |
CPF | Deve respeitar o formato |
CNPJ | Deve respeitar o formato |
Data | Deve utilizar |
Campo composto | Deve respeitar a estrutura e os separadores definidos para a entidade |
Caso sejam encontrados erros nessa etapa, eles serão apresentados antes da confirmação da importação.
Validações durante o processamento
Algumas regras dependem das informações já existentes no sistema e são verificadas somente durante a gravação.
Entre elas está a validação de datas anteriores a 20 anos.
Quando um registro apresenta erro durante o processamento, ele é identificado no arquivo de resultado e os demais registros válidos continuam sendo processados.