Orientações para Preenchimento das Planilhas de Importação
Sumário
Introdução
Este artigo tem como objetivo orientar o preenchimento correto das planilhas utilizadas na importação de dados para o iScholar. Ao seguir estas orientações, você garante que suas informações sejam importadas com sucesso, evitando erros e retrabalho.
Atualização de registros existentes (coluna atualizar)
Em qualquer planilha em que a coluna seja suportada, você pode incluir uma coluna opcional chamada atualizar para controlar o que acontece quando o registro já existe no banco:
1: o registro existente é atualizado com os dados da linha da planilha.0(ou coluna ausente): o registro existente é ignorado, e nada é alterado para aquela linha. Esse é o comportamento padrão.
Onde a coluna atualizar tem efeito: nas planilhas de Alunos, Responsáveis, Professores, Unidades, Períodos Letivos, Fornecedores, Matrículas, Currículos × Disciplinas, Alunos × Currículos, Professores × Turmas, Notas por Divisão, Notas Finais, Diário de Faltas, Ocorrências, Bibliografias e Exemplares da Biblioteca.
Onde a coluna atualizar NÃO tem efeito: nas planilhas do bloco financeiro — Parcelas, Boletos, Contas a Pagar e Contas a Receber — e em Horários de Professor. Nessas planilhas, registros que já existem no banco seguem o comportamento padrão da entidade e não são sobrescritos pela importação.
Campos personalizados
Os campos personalizados são campos criados pela própria escola nas telas do iScholar, fora do conjunto padrão de campos do sistema. Podem existir em várias entidades — alunos, responsáveis, professores, turmas, matrículas, entre outras — e aparecem nos formulários do iScholar junto aos campos padrão.
O importador não processa campos personalizados automaticamente. Quando a planilha traz colunas que não correspondem a campos padrão da entidade, o importador apenas as ignora — os dados padrão são gravados normalmente, mas os valores dos campos personalizados não. Para que esses valores entrem no sistema, é necessária uma importação manual feita pela equipe iScholar.
Como incluir campos personalizados na planilha:
Adicione uma coluna na planilha com o nome exatamente igual ao rótulo do campo como ele aparece na tela do iScholar. Recomendamos copiar e colar o nome do campo direto da tela para evitar erros de digitação, acentuação ou espaços.
Inclua o campo personalizado apenas na planilha da entidade correspondente. Por exemplo: um campo personalizado criado no cadastro de alunos deve entrar somente na planilha de alunos; um campo personalizado de turmas, somente na planilha de turmas; e assim por diante.
Preencha normalmente os valores em cada linha.
Como concluir a importação: após enviar a planilha pela ferramenta de Importação de Dados normalmente, entre em contato com a equipe de atendimento do iScholar e informe que sua planilha contém campos personalizados. A equipe fará a importação manual desses valores para os registros correspondentes.
Custos: a importação manual de campos personalizados é um serviço executado pela equipe iScholar e pode envolver cobrança adicional. Para conhecer o valor exato aplicável ao seu caso, fale com nossa equipe de atendimento.
O que é a Importação de Dados?
A ferramenta de Importação de Dados permite que sua escola transfira informações — como cadastros de alunos, professores, turmas, notas e dados financeiros — para o iScholar por meio de planilhas no formato Excel (.xlsx).
O processo é dividido em 6 etapas, que devem ser seguidas na ordem apresentada, pois os dados de etapas anteriores são utilizados nas etapas seguintes. Por exemplo, para importar turmas (Etapa 3), é necessário que os cursos e currículos da Etapa 2 já tenham sido importados.
Como Acessar a Ferramenta
No menu principal do iScholar, clique em Administração e, em seguida, em Importação de Dados.
A tela exibirá todas as etapas e, dentro de cada etapa, as entidades disponíveis para importação. Clique sobre o nome de uma entidade para expandir e ver as opções disponíveis.
Etapas da Importação
Etapa | Conteúdo |
Etapa 1 | Unidades escolares, salas, alunos, responsáveis, professores, períodos letivos, disciplinas |
Etapa 2 | Cursos, grupos de horário, horários, currículos, currículos plenos, histórico escolar |
Etapa 3 | Sistemas avaliativos, divisões, avaliações, calendários, turmas, vínculo de alunos a currículos |
Etapa 4 | Matrículas, quadro de horários, professores por turma e por horário, diário de conteúdo |
Etapa 5 | Financeiro (parcelas, boletos), ocorrências, notas (final, por divisão, por avaliação), faltas, contas a pagar |
Etapa 6 | Biblioteca (bibliografias e exemplares) |
Botões Disponíveis por Entidade
Ao expandir uma entidade, você encontrará dois botões principais:
Botão "Nova Importação"
Permite enviar uma planilha .xlsx com os dados a serem importados para aquela entidade. Após o envio, o sistema processa os registros e exibe o resultado na lista abaixo.
Botão "Opções"
Contém as seguintes opções:
Modelo e exemplos — Baixa uma planilha pronta com os nomes de todas as colunas disponíveis, já preenchida com 5 linhas de exemplo:
As 3 primeiras linhas trazem exemplos mais completos, com a maioria dos campos preenchidos.
As 2 últimas linhas trazem exemplos mínimos, com apenas os campos obrigatórios.
Atenção: as linhas de exemplo são apenas para ilustração. Não as inclua na planilha que você vai enviar para importação — apague-as antes de preencher com seus dados reais.
Orientações de preenchimento — Abre este artigo de ajuda diretamente na seção correspondente à entidade, em uma nova aba do navegador.
Acompanhando as Importações Realizadas
Para cada planilha enviada, o sistema registra uma linha na listagem da entidade com as seguintes informações:
Data e hora do envio
Total de linhas lidas
Cadastros, atualizações, registros sem ação e erros
Status da importação (processando, finalizado etc.)
Cada registro na listagem também possui um botão "Opções" com as seguintes ações:
Baixar arquivo — Faz o download da planilha enviada originalmente.
Re-enviar log — Reprocessa o envio dos arquivos de log para armazenamento. Útil quando os arquivos de log foram gerados mas estão indisponíveis para download por algum problema de envio.
Baixar log — Baixa um pacote compactado (
.tar.gz) contendo as planilhas de log geradas após o processamento.
Entendendo os Arquivos de Log
Após cada importação, o sistema gera arquivos de log que permitem verificar o que aconteceu com cada registro enviado.
Tipos de planilhas de log
O pacote baixado pelo botão "Baixar log" pode conter dois tipos de planilhas:
1. Planilha de log geral Contém todos os registros da planilha enviada, incluindo: - Os dados originais de cada linha - O status de cada registro (cadastrado, atualizado, sem ação ou com erro) - A mensagem de erro, quando houver
2. Planilha de log de erros Contém apenas os registros que apresentaram erro. Além dos mesmos dados da planilha geral, inclui uma coluna extra chamada linha_planilha, que indica o número da linha correspondente na planilha de log geral (ou na planilha enviada). Isso facilita a localização e correção dos problemas, especialmente em arquivos com muitos registros.
Se não houver erros em uma faixa de registros, a planilha de erros correspondente não é gerada — o pacote não incluirá arquivos desnecessários.
Nome dos arquivos de log
Quando a planilha enviada possui muitos registros, os arquivos de log são divididos em lotes de até 500 registros cada, para facilitar a leitura. Os nomes dos arquivos seguem o padrão:
0000000001-0000000500.xlsx ← log geral, registros 1 a 500 0000000001-0000000500_erros.xlsx ← log de erros, registros 1 a 500 0000000501-0000001000.xlsx ← log geral, registros 501 a 1000 0000000501-0000001000_erros.xlsx ← log de erros, registros 501 a 1000
Os números no nome indicam o intervalo de registros coberto por aquela planilha, sempre com 10 dígitos (com zeros à esquerda).
Regras Gerais de Preenchimento
Antes de detalhar cada entidade, é importante observar algumas regras que valem para todas as planilhas:
1. Formato do arquivo
Envie sempre no formato Excel (.xlsx). Outros formatos, como .xls, .csv ou .ods, não são aceitos.
2. Campos obrigatórios e opcionais
Cada entidade possui campos obrigatórios (sem os quais o registro não pode ser importado) e campos opcionais. A planilha modelo destaca quais são obrigatórios. Campos opcionais podem ser deixados em branco, mas a coluna deve estar presente na planilha.
Atenção: a ordem das colunas importa. O sistema lê os valores pela posição de cada coluna, não pelo nome. Use sempre a planilha modelo como base e não altere a ordem das colunas.
3. Linha de cabeçalho
A primeira linha da planilha deve conter os nomes das colunas, exatamente como aparecem na planilha modelo. Os dados começam a partir da segunda linha.
4. Sem linhas de exemplo
Como mencionado, remova as linhas de exemplo antes de enviar a planilha. Envie apenas os dados reais da sua escola.
5. Comportamento em caso de registro já existente
O importador verifica se o registro já existe no sistema com base em uma chave de identificação (que varia por entidade). Se o registro já existir: - Por padrão, ele é atualizado com os novos dados. - Se não houver nenhuma alteração, o registro é contabilizado como "sem ação".
6. Tratamento de erros na importação
Se um registro tiver erro, ele é registrado no log, mas o processamento continua normalmente para os demais registros. Ao final, você pode baixar o log de erros, corrigir apenas as linhas com problema e reenviar somente elas.
Atenção: existe um limite de segurança — se a importação atingir 100 erros, o processamento é interrompido automaticamente e os registros restantes da planilha deixam de ser processados. Se isso acontecer, baixe o log de erros, corrija os problemas apontados e reenvie a planilha.
7. Recomendações de boa prática
Além das regras acima, siga estas recomendações para evitar erros de dependência entre os dados e garantir um processamento mais rápido e estável:
Siga a ordem das etapas e entidades. Importe sempre na sequência apresentada na tela — da Etapa 1 à Etapa 6 e, dentro de cada etapa, na ordem em que as entidades aparecem. Os dados de uma etapa servem de base para as seguintes.
Conclua uma entidade antes de passar para a próxima. Só avance depois que a importação da entidade anterior estiver finalizada e sem erros pendentes — assim os vínculos entre os registros são criados corretamente.
Evite planilhas muito grandes. Recomendamos não enviar planilhas com mais de 50.000 (cinquenta mil) linhas por vez. Arquivos muito grandes tornam o processamento mais lento e dificultam a análise dos logs. Se você tiver mais registros, divida-os em planilhas menores.
Próximas Seções
Nas próximas seções deste artigo, você encontrará as orientações detalhadas para cada entidade, organizadas por etapa:
Etapa 1 — Dados Básicos
Esta etapa importa os registros mais fundamentais do sistema: as unidades escolares e suas salas, as pessoas (alunos, responsáveis e funcionários), os períodos letivos e as disciplinas. Todos os outros dados das etapas seguintes dependem desses registros, por isso a Etapa 1 deve ser concluída primeiro.
1.1 - Unidades Escolares
Cada unidade escolar representa uma escola ou filial. Se sua rede possui mais de uma unidade, importe todas aqui antes de prosseguir.
Chave de identificação: nome_unidade — se já existir uma unidade com esse nome, os dados serão atualizados.
Identificação e operação
Campo | Obrig. | Formato | Valores aceitos / Observação |
nome_unidade | ✓ | Texto | Nome da unidade escolar |
razao_social | ✓ | Texto | Razão social (para emissão de documentos) |
modo_geracao | ✓ | Lista |
|
situacao_funcionamento | ✓ | Lista |
|
cnpj | Texto | Formato: | |
cgc_mf | Texto | Inscrição estadual ou municipal | |
codigo_escola_inep | Texto | Código de 8 dígitos atribuído pelo INEP | |
codigo_ies | Texto | Código da instituição de ensino superior (quando aplicável) | |
codigo_orgao_regional | Texto | ||
codigo_escola_sede | Texto | Preencher apenas se esta unidade for vinculada a uma escola-sede | |
vinculada_basica_superior | Lista |
| |
regulamentacao | Texto | Ato normativo de regulamentação da unidade |
Endereço
Campo | Obrig. | Formato | Observação |
end_tipo_logradouro | Texto | Ex: | |
end_endereco | Texto | Nome do logradouro | |
end_numero | Texto | ||
end_complemento | Texto | ||
end_bairro | Texto | ||
end_municipio | Texto | Nome do município | |
end_distrito | Texto | ||
end_cep | Texto | Formato: | |
end_cx_postal | Texto | Caixa postal | |
end_localizacao | Lista |
| |
end_localizacao_diferenciada | Lista |
|
Contato e apresentação
Campo | Obrig. | Formato | Observação |
telefones | Texto | Formato: | |
Texto | |||
nome_responsavel | Texto | Nome do responsável pela unidade | |
descricao | Texto | Descrição ou observações gerais | |
cabecalho | Texto | Cabeçalho personalizado para documentos e relatórios | |
cabecalho_padrao | Texto | Cabeçalho padrão alternativo | |
ass_secretaria | Texto | Nome e cargo para assinatura da secretaria em documentos | |
ass_direcao | Texto | Nome e cargo para assinatura da direção em documentos | |
senha | Texto | Senha de acesso da unidade | |
exibir_logomarca_carne_escolar | Lista |
| |
observacoes_fixas_historico_escolar | Texto | Texto fixo exibido em todos os históricos escolares emitidos |
Gestor escolar
Campo | Obrig. | Formato | Observação |
gestor_nome | Texto | ||
gestor_cpf | Texto | ||
gestor_email | Texto | ||
gestor_cargo | Texto | ||
gestor_dt_nascimento | Data | DD/MM/AAAA | |
gestor_nome_mae | Texto | ||
gestor_nome_pai | Texto | ||
gestor_sexo | Lista |
| |
gestor_cor_raca | Lista |
| |
gestor_nacionalidade | Lista |
| |
gestor_pais_origem | Texto | ||
gestor_naturalidade_municipio | Texto | ||
gestor_deficiencia | Lista | Múltiplos por vírgula: | |
gestor_nivel_escolaridade | Lista |
| |
gestor_tipo_ensino_medio | Lista |
| |
gestor_curso_superior | Texto | Nome do curso superior concluído | |
gestor_ano_conclusao_curso_superior | Número | Ano de conclusão | |
gestor_ies | Texto | Nome da IES | |
gestor_pos_graducao | Lista |
| |
gestor_cursos_especificos | Lista | Múltiplos por vírgula — ver valores abaixo | |
gestor_criterio_acesso_cargo | Texto | ||
gestor_especificacao_criterio_acesso_cargo | Texto | ||
gestor_regime_contratacao | Lista |
|
Valores para gestor_cursos_especificos (múltiplos separados por vírgula, carga mínima de 80h): nenhum_curso · creche · pre_escola · anos_iniciais_ef · anos_finais_ef · ensino_medio · educacao_jovens_adultos · educacao_especial · educacao_indigena · educacao_campo · educacao_ambiental · educacao_direitos_humanos · diversidade_sexual · educacao_dir_crianca_adolescente · educacao_etnicorraciais · outros
Dados para o Censo Escolar
Os campos abaixo são utilizados exclusivamente para a transmissão do Censo Escolar. Se sua escola não realiza o censo pelo iScholar, pode ignorar esta seção inteiramente.
Classificação administrativa
Campo | Formato | Valores aceitos |
dependencia_administrativa | Lista |
|
categoria_escola_privada | Lista |
|
mantenedora_escola_privada | Lista | Múltiplos por vírgula: |
local_funcionamento | Lista | Múltiplos por vírgula: |
forma_ocupacao | Lista |
|
predio_compartilhado | Lista |
|
codigo_inep_escola_compartilhada | Texto | Código INEP da escola com quem compartilha o prédio |
forma_organizacao_ensino | Lista |
|
modalidade_censo | Lista | Múltiplos por vírgula: |
ciclos | Lista |
|
orgao_vinculo_escola_publica | Lista |
|
organizacao_sociedade_civil | Lista |
|
efera_ou_orgao_responsavel_pela_regulamentacao | Lista | Múltiplos por vírgula: |
reserva_vaga_cota | Lista | Múltiplos por vírgula: |
cede_espaco_brasil_alfabetizado | Lista |
|
aberto_final_semana | Lista |
|
proposta_pedagogica_alternancia | Lista |
|
Infraestrutura
Campo | Formato | Valores aceitos |
agua_consumida | Lista |
|
abastecimento_agua | Lista | Múltiplos por vírgula: |
abastecimento_energia | Lista | Múltiplos por vírgula: |
esgoto_sanitario | Lista | Múltiplos por vírgula: |
destinacao_lixo | Lista | Múltiplos por vírgula: |
tratamento_lixo | Lista | Múltiplos por vírgula: |
dependencia_existente | Lista | Múltiplos por vírgula — ver valores abaixo |
recurso_acessibilidade_deficiencia | Lista | Múltiplos por vírgula: |
equipamentos | Lista | Múltiplos por vírgula: |
acesso_internet | Lista | Múltiplos por vírgula: |
internet_banda_larga | Lista |
|
equipamentos_uso_aluno | Lista |
|
rede_local | Lista | Múltiplos por vírgula: |
Valores para dependencia_existente (múltiplos separados por vírgula): sala_diretoria · sala_professor · sala_secretaria · laboratorio_informatica · laboratorio_ciencias · sala_aee · quadra_coberta · quadra_descoberta · cozinha · biblioteca · sala_leitura · parque_infantil · bercario · banheiro_fora_predio · banheiro_dentro_predio · banheiro_infantil · banheiro_deficiente · dependencia_acessibilidade · banheiro_chuveiro · refeitorio · despensa · almoxarifado · auditorio · patio_coberto · patio_descoberto · alojamento_aluno · alojamento_professor · area_verde · lavanderia · banheiro_funcionario · piscina · sala_repouso_aluno · sala_artes · sala_musica · sala_danca · sala_multiuso · terreirao · viveiro · nenhuma
Programas e atividades
Campo | Formato | Valores aceitos |
alimentacao_escolar | Lista |
|
aee | Lista |
|
atividade_complementar | Lista |
|
material_didatico | Texto | |
educacao_indigena | Lista |
|
lingua_ensino_indigena | Lista |
|
lingua_ensino_portugues | Lista |
|
codigo_lingua_indigena | Número | Código da língua indígena utilizada |
orgao_colegiado | Lista | Múltiplos por vírgula: |
instrumentos_materiais | Texto |
Quantitativos de pessoal — todos os campos abaixo são do tipo Número inteiro:
total_auxiliares_de_secretaria · total_auxiliar_servicos_gerais · total_bibliotecario · total_profissional_saude · total_coordenador_turno · total_fonoaudiologo · total_nutricionista · total_psicologo_escolar · total_profissional_preparacao_seguranca_alimentar · total_profissional_apoio_supervisao_pedagogica · total_secretario_escolar · total_seguranca · total_tecnicos · total_vice_diretor · total_orientador_comunitario · total_computadores_mesa · total_computadores_portateis · total_tablets
Responsável legal
Campo | Formato | Observação |
responsavel_cpf | Texto | CPF do responsável legal pela escola |
responsavel_rg_numero | Texto | |
responsavel_rg_expedicao | Data | DD/MM/AAAA |
responsavel_rg_orgao | Texto | Órgão emissor do RG |
1.2 - Salas de Aula
Cada sala fica vinculada a uma unidade escolar. Importe todas as salas antes de criar turmas na Etapa 3.
Chave de identificação: unidade_nome + descricao — todos os três campos são obrigatórios.
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | Deve corresponder exatamente ao |
descricao | ✓ | Texto | Nome ou identificação da sala (ex: |
capacidade_maxima | ✓ | Número | Capacidade máxima de alunos |
1.3 - Alunos
Importa o cadastro dos alunos. Somente nome_completo é tecnicamente obrigatório, mas recomendamos incluir sempre a dt_nascimento — ela compõe a chave de identificação e, sem ela, alunos homônimos serão tratados como o mesmo registro.
Chave de identificação: nome_completo + dt_nascimento
Identificação e dados pessoais
Campo | Obrig. | Formato | Valores aceitos / Observação |
nome_completo | ✓ | Texto | Nome completo do aluno |
dt_nascimento | Data | DD/MM/AAAA — fortemente recomendado | |
nome_social | Texto | Nome social, se diferente do nome de registro | |
sexo | Lista |
| |
cor_raca | Lista |
| |
estado_civil_aluno | Lista |
| |
data_ingresso | Data | DD/MM/AAAA — data de ingresso na escola | |
registro_escolar | Texto | Número de registro interno | |
profissao_aluno | Texto | ||
telefones | Texto | Formato: | |
Texto | |||
id_censo | Texto | Código no Censo Escolar | |
religiao | Texto | ||
outras_informacoes | Texto | Campo livre | |
origem | Texto | Escola de origem | |
colegio_origem | Texto | ||
colegio_origem_ano | Número | Ano letivo de origem | |
colegio_origem_curso | Texto | Curso/série na escola de origem |
Endereço
Campo | Obrig. | Formato | Valores aceitos / Observação |
end_zona | Lista |
| |
end_cep | Texto | Formato: | |
end_logradouro | Texto | ||
end_numero | Texto | ||
end_complemento | Texto | ||
end_bairro | Texto | ||
end_municipio_nome | Texto | ||
end_municipio_ibge | Texto | Código IBGE do município | |
end_estado_nome | Texto | Sigla do estado (ex: | |
nacionalidade_aluno | Lista |
| |
pais_origem | Texto | ||
dt_entrada_pais | Data | DD/MM/AAAA — data de entrada no Brasil | |
naturalidade_municipio | Texto | Município de nascimento | |
naturalidade_estado | Texto | Sigla do estado de nascimento |
Documentos
Campo | Obrig. | Formato | Observação |
doc_rg_numero | Texto | ||
doc_rg_dt_expedicao | Data | DD/MM/AAAA | |
doc_rg_orgao | Texto | Órgão emissor | |
doc_rg_uf | Texto | Sigla do estado emissor | |
doc_cpf_numero | Texto | ||
doc_nis_numero | Texto | NIS / PIS / PASEP | |
doc_cc_nr_termo | Texto | Certidão de nascimento — número do termo | |
doc_cc_folha | Texto | ||
doc_cc_livro | Texto | ||
doc_cc_dt_emissao | Data | DD/MM/AAAA | |
doc_cc_uf_cartorio | Texto | Sigla do estado do cartório | |
doc_cc_orgao | Texto | Nome do cartório | |
doc_cc_municipio | Texto | ||
doc_cc_matricula | Texto | ||
doc_titulo_numero | Texto | Título de eleitor | |
doc_titulo_zona | Texto | ||
doc_titulo_secao | Texto | ||
doc_titulo_municipio | Texto | ||
doc_titulo_uf | Texto | ||
doc_titulo_data_emissao | Data | DD/MM/AAAA | |
doc_militar_tipo | Lista |
| |
doc_militar_numero | Texto | ||
doc_militar_orgao_emissor | Texto | ||
doc_militar_uf | Texto |
Dados de saúde
Campo | Obrig. | Formato | Valores aceitos / Observação |
tipo_sanguineo | Lista |
| |
alergia | Texto | ||
doencas | Texto | ||
necessidades_especiais | Texto | ||
medicamento_controlado | Texto | ||
restricao_alimentar | Texto | ||
nome_hospital | Texto | Hospital de preferência | |
cartao_sus_numero | Texto | ||
plano_saude | Texto | Nome do plano de saúde | |
plano_saude_dt_venc_cartao | Data | DD/MM/AAAA | |
plano_saude_nr_cartao | Texto | ||
medico_familia | Texto | ||
tel_medico | Texto | ||
remedios_ministrados | Texto | Medicamentos que podem ser administrados na escola |
Dados profissionais
Campo | Obrig. | Formato | Observação |
empresa_nome | Texto | ||
cargo | Texto | ||
empresa_telefone | Texto | ||
end_empresa_logradouro | Texto | ||
end_empresa_numero | Texto | ||
end_empresa_complemento | Texto | ||
end_bairro_empresa | Texto | ||
end_empresa_municipio_nome | Texto | ||
end_empresa_municipio_ibge | Texto | ||
end_empresa_estado_nome | Texto | Sigla do estado | |
end_empresa_cep | Texto |
Filiação 1
Campo | Obrig. | Formato | Valores aceitos / Observação |
filiacao1_nome | Texto | ||
filiacao1_tipo | Lista |
| |
filiacao1_dt_nascimento | Data | DD/MM/AAAA | |
filiacao1_naturalidade | Texto | ||
filiacao1_estado_civil | Lista |
| |
filiacao1_tel | Texto | ||
filiacao1_email | Texto | ||
filiacao1_end_cep | Texto | ||
filiacao1_end_logradouro | Texto | ||
filiacao1_end_numero | Texto | ||
filiacao1_end_complemento | Texto | ||
filiacao1_end_bairro | Texto | ||
filiacao1_end_municipio_nome | Texto | ||
filiacao1_end_municipio_ibge | Texto | ||
filiacao1_end_estado_nome | Texto | Sigla do estado | |
filiacao1_nacionalidade | Lista |
| |
filiacao1_pais_origem | Texto | ||
filiacao1_cpf | Texto | ||
filiacao1_profissao | Texto | ||
filiacao1_local_trabalho | Texto | ||
filiacao1_religiao | Texto | ||
filiacao1_rg_numero | Texto | ||
filiacao1_rg_orgao | Texto | ||
filiacao1_rg_dt_expedicao | Data | DD/MM/AAAA | |
filiacao1_grau_instrucao | Texto |
Filiação 2
Os mesmos campos da Filiação 1, com prefixo filiacao2_ (ex: filiacao2_nome, filiacao2_tipo, etc.).
Descontos
Até 4 descontos podem ser vinculados diretamente ao cadastro do aluno.
Campo | Obrig. | Formato | Observação |
desconto1_descricao | Texto | Ex: | |
desconto1_valor | Número | Percentual (ex: | |
desconto2_descricao | Texto | ||
desconto2_valor | Número | ||
desconto3_descricao | Texto | ||
desconto3_valor | Número | ||
desconto4_descricao | Texto | ||
desconto4_valor | Número |
Autorização de saída
Campo | Obrig. | Formato | Observação |
dados_pessoas_autorizadas | Texto | Nomes das pessoas autorizadas a buscar o aluno |
1.4 - Responsáveis
Importa responsáveis financeiros e legais dos alunos. O vínculo entre responsável e aluno é feito na Etapa 4 (matrícula).
Chave de identificação: nome_completo + dt_nascimento
Responsáveis podem ser pessoa física (F) ou pessoa jurídica (J) — use o campo tipo_responsavel para indicar.
Identificação
Campo | Obrig. | Formato | Valores aceitos / Observação |
nome_completo | ✓ | Texto | |
dt_nascimento | Data | DD/MM/AAAA — recomendado para evitar duplicatas | |
tipo_responsavel | Lista |
| |
sexo | Lista |
| |
cor_raca | Lista |
| |
estado_civil | Lista |
| |
escolaridade | Lista |
| |
nacionalidade | Texto | ||
nacionalidade_resp | Texto | ||
dt_entrada_pais | Data | DD/MM/AAAA | |
naturalidade_municipio | Texto | ||
naturalidade_estado | Texto | Sigla do estado | |
Texto | |||
telefones | Texto | Formato: |
Documentos
Campo | Obrig. | Formato | Observação |
doc_rg_numero | Texto | ||
doc_rg_dt_expedicao | Data | DD/MM/AAAA | |
doc_rg_orgao | Texto | ||
doc_cpf_numero | Texto | CPF (pessoa física) | |
cnpj | Texto | CNPJ (pessoa jurídica) | |
inscricao_municipal | Texto | ||
iss_retido | Lista |
|
Endereço residencial
Campo | Obrig. | Formato | Observação |
end_cep | Texto | ||
end_logradouro | Texto | ||
end_numero | Texto | ||
end_complemento | Texto | ||
end_bairro | Texto | ||
end_municipio_nome | Texto | ||
end_municipio_ibge | Texto | ||
end_estado_nome | Texto | Sigla do estado |
Dados comerciais e endereço comercial
Campo | Obrig. | Formato | Observação |
empresa_nome | Texto | ||
profissao | Texto | ||
empresa_telefone | Texto | ||
endc_cep | Texto | ||
endc_logradouro | Texto | ||
endc_numero | Texto | ||
endc_complemento | Texto | ||
endc_bairro | Texto | ||
endc_municipio_nome | Texto | ||
endc_municipio_ibge | Texto | ||
endc_estado_nome | Texto | Sigla do estado |
Filiação
Campo | Obrig. | Formato | Observação |
filiacao1_nome | Texto | ||
filiacao1_tipo | Texto | Ex: | |
filiacao2_nome | Texto | ||
filiacao2_tipo | Texto | Ex: |
1.5 - Funcionários
Importa o cadastro de todos os funcionários — professores e não-docentes. O campo professor define quem pode ser vinculado a turmas, notas e diário de classe.
Chave de identificação: nome_completo + dt_nascimento
Identificação e dados pessoais
Campo | Obrig. | Formato | Valores aceitos / Observação |
nome_completo | ✓ | Texto | |
dt_nascimento | Data | DD/MM/AAAA — recomendado para evitar duplicatas | |
apelido | Texto | ||
sexo | Lista |
| |
cor_raca | Lista |
| |
estado_civil | Lista |
| |
nome_conjuge | Texto | ||
nacionalidade | Texto | ||
nacionalidade_funcionario | Texto | ||
pais_origem | Texto | ||
dt_entrada_pais | Data | DD/MM/AAAA | |
naturalidade_municipio | Texto | ||
naturalidade_estado | Texto | Sigla do estado | |
Texto | |||
telefones | Texto | Formato: | |
id_censo | Texto | ||
professor | Lista |
| |
inativo | Lista |
|
Filiação
Campo | Obrig. | Formato | Observação |
filiacao1_nome | Texto | ||
filiacao1_tipo | Texto | Ex: | |
filiacao2_nome | Texto | ||
filiacao2_tipo | Texto | Ex: |
Endereço
Campo | Obrig. | Formato | Observação |
end_cep | Texto | ||
end_logradouro | Texto | ||
end_numero | Texto | ||
end_complemento | Texto | ||
end_bairro | Texto | ||
end_municipio_nome | Texto | ||
end_municipio_ibge | Texto | ||
end_estado_nome | Texto | Sigla do estado |
Documentos e dados bancários
Campo | Obrig. | Formato | Observação |
doc_rg_numero | Texto | ||
doc_rg_dt_expedicao | Data | DD/MM/AAAA | |
doc_rg_orgao | Texto | ||
doc_cpf_numero | Texto | ||
numero_pis | Texto | PIS/PASEP | |
doc_ctps_numero | Texto | Carteira de Trabalho | |
doc_ctps_serie | Texto | ||
doc_ctps_dt_emissao | Data | DD/MM/AAAA | |
doc_ctps_uf | Texto | Sigla do estado | |
doc_te_numero | Texto | Título de eleitor | |
doc_te_zona | Texto | ||
doc_te_secao | Texto | ||
doc_te_cidade | Texto | ||
banco | Texto | Código ou nome do banco | |
agencia | Texto | ||
n_conta | Texto | Número da conta corrente | |
operacao | Texto | Dígito de operação (alguns bancos) |
Formação acadêmica
Campo | Obrig. | Formato | Observação |
setor_atuacao | Texto | Área de atuação | |
tecnologo | Texto | Curso tecnólogo concluído | |
dt_tecnologo | Data | DD/MM/AAAA | |
instituicao_tecnologo | Texto | ||
graduacao | Texto | Curso de graduação | |
dt_graduacao | Data | DD/MM/AAAA | |
instituicao_graduacao | Texto | ||
especializacao | Texto | ||
dt_especializacao | Data | DD/MM/AAAA | |
instituicao_especializacao | Texto | ||
mestrado | Texto | ||
dt_mestrado | Data | DD/MM/AAAA | |
instituicao_mestrado | Texto | ||
doutorado | Texto | ||
dt_doutorado | Data | DD/MM/AAAA | |
instituicao_doutorado | Texto | ||
pos_doutorado | Texto | ||
dt_pos_doutorado | Data | DD/MM/AAAA | |
instituicao_pos_doutorado | Texto |
Dados profissionais
Campo | Obrig. | Formato | Observação |
cargo | Texto | ||
descricao_cargo | Texto | ||
dt_admissao | Data | DD/MM/AAAA | |
dt_demissao | Data | DD/MM/AAAA | |
salario | Número | ||
valor_hora_aula | Número | ||
regime_contratacao | Texto | ||
observacoes | Texto |
1.6 - Períodos Letivos
Define os anos ou semestres letivos utilizados em calendários e matrículas. Todos os campos são obrigatórios.
Chave de identificação: descricao
Campo | Obrig. | Formato | Observação |
descricao | ✓ | Texto | Nome do período (ex: |
dt_inicio | ✓ | Data | DD/MM/AAAA — início do período letivo |
dt_termino | ✓ | Data | DD/MM/AAAA — término do período letivo |
dt_painel | ✓ | Data | DD/MM/AAAA — data de abertura das matrículas no painel de acesso |
matriculas_termino | ✓ | Data | DD/MM/AAAA — prazo final para encerramento de matrículas |
1.7 - Disciplinas
Cadastra as disciplinas que serão vinculadas às grades curriculares na Etapa 2. Ambos os campos são obrigatórios.
Chave de identificação: disciplina_nome
Campo | Obrig. | Formato | Observação |
disciplina_nome | ✓ | Texto | Nome completo da disciplina (ex: |
disciplina_abrev | ✓ | Texto | Abreviação para relatórios e boletins (ex: |
Etapa 2 — Cursos e Currículos
Esta etapa define a estrutura acadêmica da escola: cursos, horários, grades curriculares e currículos plenos. Também importa os históricos escolares de alunos vindos de outras instituições. Os dados desta etapa dependem das unidades, disciplinas e alunos já cadastrados na Etapa 1.
2.1 - Cursos
Cada curso representa uma série, ano ou programa de estudo (ex: 1º ANO, 1ª SÉRIE, PEDAGOGIA). Um mesmo curso pode ser vinculado a mais de uma unidade.
Chave de identificação: modalidade + curso_nome
Campo | Obrig. | Formato | Valores aceitos / Observação |
modalidade | ✓ | Lista | Ver valores abaixo |
curso_nome | ✓ | Texto | Nome da série ou programa (ex: |
unidade_nomes | Texto | Nomes das unidades separados por vírgula; se vazio, aplica-se a todas as unidades | |
curso_abrev | Texto | Abreviação para uso em relatórios (ex: | |
curso_descricao | Texto | Descrição detalhada do curso |
Valores para modalidade: EDUCAÇÃO INFANTIL · ENSINO FUNDAMENTAL I · ENSINO FUNDAMENTAL II · ENSINO FUNDAMENTAL ANOS INICIAIS · ENSINO FUNDAMENTAL ANOS FINAIS · ENSINO MÉDIO · PRÉ-VESTIBULAR · TÉCNICO · PROFISSIONALIZANTE · EAD · EJA · IDIOMA · PÓS-GRADUAÇÃO · FORMAÇÃO LIVRE · ENSINO SUPERIOR
2.2 - Grupos de Horários
Agrupa os horários de aula (ex: Matutino, Vespertino, Noturno). Um grupo de horários é compartilhado entre turmas com o mesmo padrão de horários.
Chave de identificação: nome_grupo
Campo | Obrig. | Formato | Observação |
nome_grupo | ✓ | Texto | Nome do grupo (ex: |
unidade_nomes | Texto | Nomes das unidades separados por vírgula; se vazio, disponível para todas |
2.3 - Horários
Define os horários individuais de aula dentro de um grupo (ex: 1ª Aula: 07:30–08:20). Importe primeiro os grupos de horários (2.2) e, em seguida, seus horários aqui.
Chave de identificação: horario_grupo_nome + inicio + fim — todos os campos são obrigatórios.
Campo | Obrig. | Formato | Observação |
horario_grupo_nome | ✓ | Texto | Deve corresponder exatamente ao |
inicio | ✓ | Hora | HH:MM:SS — horário de início da aula |
fim | ✓ | Hora | HH:MM:SS — horário de término da aula |
descricao | ✓ | Texto | Identificação do horário (ex: |
2.4 - Grades Curriculares
Define as grades curriculares (estrutura de disciplinas) utilizadas pelas turmas. Uma grade pode ser vinculada a uma ou mais unidades.
Chave de identificação: curriculo_nome
Campo | Obrig. | Formato | Observação |
curriculo_nome | ✓ | Texto | Nome da grade (ex: |
unidade_nomes | Texto | Nomes das unidades separados por vírgula | |
carga_horaria_total | Hora | Carga horária total no formato | |
conteudo_prog | Texto | Descrição ou ementa geral da grade curricular |
2.5 - Disciplinas da Grade
Vincula disciplinas a uma grade curricular, definindo carga horária, obrigatoriedade e demais configurações pedagógicas. Importe após as grades (2.4) e as disciplinas (1.7).
Chave de identificação: curriculo_nome + disciplina_nome
Campos obrigatórios e principais
Campo | Obrig. | Formato | Valores aceitos / Observação |
curriculo_nome | ✓ | Texto | Deve corresponder a uma grade já cadastrada |
disciplina_nome | ✓ | Texto | Deve corresponder a uma disciplina já cadastrada |
carga_horaria | ✓ | Hora | Formato |
conteudo_ministrado | ✓ | Lista |
|
obrigatoria | ✓ | Lista |
|
ordem | Número | Posição de exibição no boletim | |
tipo | Lista |
| |
tipo_avaliacao | Lista |
| |
oferta | Lista |
| |
nao_reprova | Lista |
| |
enviar_censo_escolar | Lista |
| |
area_de_conhecimento | Lista | Ver valores abaixo |
Valores para area_de_conhecimento: LINGUAGENS E SUAS TECNOLOGIAS · MATEMÁTICA E SUAS TECNOLOGIAS · CIÊNCIAS DA NATUREZA E SUAS TECNOLOGIAS · CIÊNCIAS HUMANAS E SOCIAIS APLICADAS · FORMAÇÃO TÉCNICA E PROFISSIONAL
Campos pedagógicos (opcionais)
Campo | Obrig. | Formato | Observação |
ementa | Texto | Descrição resumida do conteúdo da disciplina | |
objetivos | Texto | Objetivos de aprendizagem | |
atividade_discente | Texto | Descrição das atividades desenvolvidas pelos alunos | |
procedimento_avaliacao | Texto | Descrição dos critérios e instrumentos de avaliação | |
bibliografia_basica | Texto | Referências bibliográficas obrigatórias | |
bibliografia_complementar | Texto | Referências bibliográficas complementares | |
periodo_origem | Texto | Período/semestre de origem (ensino superior) | |
codigo_disciplina | Texto | Código interno da disciplina | |
creditos | Número | Número de créditos (ensino superior) | |
carga_horaria_teorica | Hora | Formato | |
carga_horaria_pratica | Hora | Formato | |
carga_horaria_estagio | Hora | Formato | |
tipo_opcional | Texto | Classificação da disciplina optativa |
2.6 - Currículos Plenos
Atenção: esta entidade é exclusiva para cursos de Ensino Superior. Não importar para outros níveis de ensino.
Define a estrutura curricular completa de um curso superior, agrupando uma ou mais grades curriculares. A chave de identificação é a descricao (nome do currículo pleno).
Chave de identificação: descricao
Campo | Obrig. | Formato | Valores aceitos / Observação |
grades_curriculares_nomes | ✓ | Texto | Nomes das grades separados por vírgula — devem corresponder a grades já cadastradas |
curso_nome | ✓ | Texto | Deve corresponder a um curso já cadastrado |
curso_modalidade | ✓ | Lista |
|
descricao | ✓ | Texto | Nome do currículo pleno (ex: |
ativo | ✓ | Lista |
|
disciplinas_optativas | Texto | Nomes de disciplinas optativas separados por ponto-e-vírgula ( | |
dt_aprovacao | Data | AAAA-MM-DD — data de aprovação do currículo | |
prazo_minimo | Número | Prazo mínimo de integralização em semestres | |
prazo_maximo | Número | Prazo máximo de integralização em semestres | |
ch_ativ_complementar | Hora | Carga horária de atividades complementares (ex: | |
ch_ativ_extensao | Hora | Carga horária de atividades de extensão | |
ch_ativ_optativa | Hora | Carga horária de disciplinas optativas |
2.7 - Históricos Escolares
Importa o histórico escolar de alunos provenientes de outras instituições ou de anos anteriores ao sistema. Cada linha representa um ano letivo cursado pelo aluno.
Chave de identificação: aluno_nome_completo + aluno_dt_nascimento + ano_letivo + semestre + ensino + curso + estabelecimento
Campo | Obrig. | Formato | Valores aceitos / Observação |
aluno_nome_completo | ✓ | Texto | Deve corresponder a um aluno já cadastrado |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA — necessário para identificar o aluno corretamente |
ano_letivo | ✓ | Número | Ano letivo (ex: |
ensino | ✓ | Lista | Mesmo valores de |
curso | ✓ | Texto | Nome da série/curso (ex: |
estabelecimento | ✓ | Texto | Nome da instituição onde o aluno cursou o ano letivo |
estado | ✓ | Texto | Sigla do estado da instituição (ex: |
municipio | ✓ | Texto | Município da instituição |
semestre | ✓ | Lista |
|
resultado | Lista | Ver valores abaixo — fortemente recomendado | |
dias_letivos | Número | Total de dias letivos do período — fortemente recomendado | |
chtotal | Hora | Carga horária total no formato | |
minimo_aprovacao | Número | Nota mínima para aprovação (ex: | |
observacao | Texto | Observações sobre o período letivo | |
tipo_frequencia | Lista |
| |
faltas | Número | Valor interpretado conforme | |
trans | Lista |
| |
total_nota | Número | Total de pontos do período (ex: | |
dt_conclusao | Data | AAAA-MM-DD — data de conclusão do período |
Valores para resultado: APROVADO · APROVADO COM PROGRESSÃO PARCIAL · APROVADO COM PROGRESSÃO CONTINUADA · APROVADO PELO CONSELHO · APTO · CONCLUINTE · CURSANDO · DESISTENTE · EM CONTINUAÇÃO · NÃO CONCLUINTE · PROMOVIDO · RECLASSIFICADO · REPROVADO · TRANSFERIDO
2.8 - Disciplinas do Histórico
Detalha as notas e frequência por disciplina dentro de um histórico escolar. Cada linha representa uma disciplina de um determinado ano letivo do aluno. Importe após os históricos (2.7) e as disciplinas (1.7).
Chave de identificação: campos do histórico pai (aluno_nome_completo + aluno_dt_nascimento + historico_ano_letivo + historico_semestre + historico_ensino + historico_curso + historico_estabelecimento) + disciplina_nome + tipo
Campo | Obrig. | Formato | Valores aceitos / Observação |
aluno_nome_completo | ✓ | Texto | |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA |
historico_ano_letivo | ✓ | Número | Deve corresponder a um histórico já importado |
historico_semestre | ✓ | Lista |
|
historico_ensino | ✓ | Texto | Deve ser igual ao |
historico_curso | ✓ | Texto | Deve ser igual ao |
historico_estabelecimento | ✓ | Texto | Deve ser igual ao |
disciplina_nome | ✓ | Texto | Deve corresponder a uma disciplina já cadastrada |
tipo | ✓ | Lista |
|
aproveitamento | Texto | Nota numérica (ex: | |
carga_horaria | Hora | Formato | |
faltas | Número | Número de faltas na disciplina | |
areadeconhecimento | Lista |
| |
tipo_opcional | Texto | Classificação da disciplina optativa |
Etapa 3 — Calendários e Turmas
Esta etapa configura a estrutura de avaliação e de funcionamento das turmas: sistemas avaliativos com suas divisões e avaliações, calendários escolares com os dias letivos, e a criação das turmas. Também vincula alunos a currículos plenos (ensino superior). Os dados das Etapas 1 e 2 devem estar completos antes de iniciar esta etapa.
3.1 - Sistemas Avaliativos
Define as regras de avaliação de um conjunto de turmas: nota máxima, mínimo para aprovação, frequência mínima e fórmula de cálculo. Cada turma é vinculada a um sistema avaliativo através do calendário (3.4).
Chave de identificação: nome
Campo | Obrig. | Formato | Valores aceitos / Observação |
nome | ✓ | Texto | Nome do sistema (ex: |
minimo_aprovacao | ✓ | Número | Nota mínima para aprovação (ex: |
assiduidade_minima | ✓ | Número | Frequência mínima em percentual (ex: |
valor | Número | Valor máximo da nota — fortemente recomendado; padrão assumido: | |
progressao_parcial | Número | Número máximo de disciplinas em progressão parcial permitidas ( |
3.2 - Divisões
Define os períodos de avaliação dentro de um sistema avaliativo (ex: 1º Bimestre, 2º Semestre). Cada divisão tem um valor que compõe a nota final. Importe após os sistemas avaliativos (3.1).
Chave de identificação: sistema_avaliacao_nome + descricao
Campo | Obrig. | Formato | Valores aceitos / Observação |
sistema_avaliacao_nome | ✓ | Texto | Deve corresponder a um sistema avaliativo já cadastrado |
descricao | ✓ | Texto | Nome da divisão (ex: |
ordem | ✓ | Número | Número inteiro maior que zero, único dentro do sistema avaliativo. Define a ordem de exibição no boletim e o apelido interno da divisão ( |
valor_divisao | ✓ | Número | Valor máximo da divisão (ex: |
legenda_divisao_painel | Texto | Texto exibido no painel de notas | |
calculo_divisao | Texto | Fórmula de cálculo da nota da divisão | |
recuperacao | Lista |
| |
bloqueado | Lista |
| |
ultrapassa_valor | Lista |
| |
dt_limite_lancamento | Data | AAAA-MM-DD — prazo para lançamento de notas | |
dt_publicacao | Data | AAAA-MM-DD — data de publicação das notas para alunos/responsáveis |
3.3 - Avaliações
Define as avaliações individuais dentro de uma divisão (ex: Prova, Trabalho). O somatório dos valores das avaliações de uma divisão deve ser igual ao valor_divisao. Importe após as divisões (3.2).
Chave de identificação: sistema_avaliacao_nome + divisao_nome + nome_avaliacao
Campo | Obrig. | Formato | Valores aceitos / Observação |
sistema_avaliacao_nome | ✓ | Texto | Deve corresponder a um sistema avaliativo já cadastrado |
divisao_nome | ✓ | Texto | Deve corresponder a uma divisão do sistema indicado |
nome_avaliacao | ✓ | Texto | Nome da avaliação (ex: |
valor | ✓ | Número | Valor numérico máximo da avaliação |
ordem | ✓ | Número | Número inteiro maior que zero, único dentro da divisão. Define a ordem de exibição e o apelido interno da avaliação ( |
isolada | Lista |
| |
restringir_disciplinas | Texto | Nomes de disciplinas separados por ponto-e-vírgula; se preenchido, a avaliação só aparece nessas disciplinas |
3.4 - Calendários Escolares
Vincula um período letivo a um sistema avaliativo, formando o calendário de uma ou mais turmas. Todos os campos são obrigatórios.
Chave de identificação: nome
Campo | Obrig. | Formato | Observação |
periodo_descricao | ✓ | Texto | Deve corresponder a um período letivo já cadastrado (ex: |
sistema_avaliacao_nome | ✓ | Texto | Deve corresponder a um sistema avaliativo já cadastrado |
nome | ✓ | Texto | Nome do calendário (ex: |
dt_fechamento_notas | ✓ | Data | AAAA-MM-DD — prazo global para fechamento do boletim |
3.5 - Dias Letivos
Registra os dias de aula de um calendário escolar, associando cada dia a uma divisão (período de avaliação). Os dias letivos são necessários para o diário de classe e para o cálculo de faltas.
Chave de identificação: calendario_nome + sistema_avaliacao_nome + divisao_nome + dia
Campo | Obrig. | Formato | Observação |
calendario_nome | ✓ | Texto | Deve corresponder a um calendário já cadastrado |
dia | ✓ | Data | AAAA-MM-DD — data do dia letivo |
sistema_avaliacao_nome | ✓ | Texto | Sistema avaliativo ao qual a divisão pertence |
divisao_nome | ✓ | Texto | Divisão à qual o dia letivo está vinculado (ex: |
reposicao_dia | Data | AAAA-MM-DD — se preenchido, o dia é marcado como reposição de outra data | |
descricao | Texto | Descrição opcional do dia letivo |
3.6 - Turmas
Cria as turmas do ano letivo, vinculando calendário, grade curricular, curso, sala e grupo de horários. Todos os campos são obrigatórios.
Chave de identificação: unidade_nome + descricao + curso_nome + curso_modalidade + calendario_nome + sala_descricao + horario_grupo_nome
Campo | Obrig. | Formato | Valores aceitos / Observação |
unidade_nome | ✓ | Texto | Deve corresponder a uma unidade já cadastrada |
descricao | ✓ | Texto | Nome da turma (ex: |
curso_nome | ✓ | Texto | Deve corresponder a um curso já cadastrado |
curso_modalidade | ✓ | Lista | Mesmos valores de |
calendario_nome | ✓ | Texto | Deve corresponder a um calendário já cadastrado |
curriculo_nome | ✓ | Texto | Deve corresponder a uma grade curricular já cadastrada |
sala_descricao | ✓ | Texto | Deve corresponder a uma sala já cadastrada na unidade informada |
horario_grupo_nome | ✓ | Texto | Deve corresponder a um grupo de horários já cadastrado |
capacidade_definida | ✓ | Número | Capacidade máxima da turma |
turno | ✓ | Lista |
|
3.7 - Currículos Plenos do Aluno
Atenção: esta entidade é exclusiva para alunos de Ensino Superior. Vincula um aluno a um currículo pleno e registra informações acadêmicas como datas de início, conclusão, colação e dados do ENADE.
Chave de identificação: curriculo_pleno_descricao + aluno_nome_completo + aluno_dt_nascimento
Campos de identificação e vínculo
Campo | Obrig. | Formato | Observação |
aluno_nome_completo | ✓ | Texto | Deve corresponder a um aluno já cadastrado |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA |
curriculo_pleno_descricao | ✓ | Texto | Deve corresponder a um currículo pleno já cadastrado |
Datas do curso
Campo | Obrig. | Formato | Observação |
dt_inicio | Data | AAAA-MM-DD — data de início no curso | |
dt_trancado | Data | AAAA-MM-DD — data de trancamento (se houver) | |
dt_cancelado | Data | AAAA-MM-DD — data de cancelamento (se houver) | |
dt_termino | Data | AAAA-MM-DD — data prevista de término | |
dt_conclusao | Data | AAAA-MM-DD — data de conclusão do curso | |
dt_colacao | Data | AAAA-MM-DD — data da colação de grau | |
dt_emissao_historico | Data | AAAA-MM-DD — data de emissão do histórico | |
dt_diploma | Data | AAAA-MM-DD — data de emissão do diploma |
Processo seletivo e ingresso
Campo | Obrig. | Formato | Valores aceitos / Observação |
forma_ingresso | Lista |
| |
vestibular_pontuacao | Número | Pontuação no processo seletivo | |
vestibular_classificacao | Número | Classificação no processo seletivo | |
proc_sel_local | Texto | Local de realização do processo seletivo | |
proc_sel_mes_ano | Texto | Mês/ano do processo seletivo (ex: | |
bolsa | Lista |
|
Diploma
Campo | Obrig. | Formato | Observação |
diploma_registro | Texto | Número de registro do diploma | |
diploma_livro | Texto | Livro do registro do diploma | |
diploma_folha | Texto | Folha do registro do diploma |
ENADE
Campo | Obrig. | Formato | Observação |
enade_dt_prova_ingressante | Data | AAAA-MM-DD | |
enade_situacao_ingressante | Texto | Situação no ENADE como ingressante | |
enade_observacao_ingressante | Texto | ||
enade_dt_prova_concluinte | Data | AAAA-MM-DD | |
enade_situacao_concluinte | Texto | Situação no ENADE como concluinte | |
enade_observacao_concluinte | Texto |
Outras informações
Campo | Obrig. | Formato | Observação |
outras_informacoes | Texto | ||
mais_informacoes | Texto | Campo livre adicional |
3.8 - Dispensas e Equivalências
Atenção: esta entidade é exclusiva para alunos de Ensino Superior. Registra dispensas ou aproveitamentos de disciplinas cursadas em outras instituições ou em períodos anteriores ao iScholar.
Chave de identificação: disciplina_nome + curriculo_pleno_descricao + aluno_nome_completo + aluno_dt_nascimento
Campos de identificação
Campo | Obrig. | Formato | Valores aceitos / Observação |
aluno_nome_completo | ✓ | Texto | Deve corresponder a um aluno vinculado ao currículo pleno indicado |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA |
curriculo_pleno_descricao | ✓ | Texto | Deve corresponder a um currículo pleno já cadastrado |
disciplina_nome | ✓ | Texto | Disciplina dispensada no currículo pleno |
motivo | ✓ | Lista |
|
instituicao_origem | ✓ | Texto | Nome da instituição de origem |
disciplina_equivalente | ✓ | Texto | Nome da disciplina equivalente na instituição de origem |
Resultado e frequência
Campo | Obrig. | Formato | Valores aceitos / Observação |
situacao | Lista |
| |
nota | Número | Nota obtida na disciplina de origem | |
tipo_frequencia | Lista |
| |
frequencia | Número | Frequência; interpretada conforme | |
tipo_disciplina | Lista |
|
Dados da disciplina de origem
Campo | Obrig. | Formato | Observação |
carga_horaria | Hora | Carga horária no formato | |
ch_origem | Hora | Carga horária da disciplina na instituição de origem | |
ano | Número | Ano em que a disciplina foi cursada | |
semestre | Lista |
| |
periodo | Texto | Período/semestre (descrição livre) |
Responsável pela homologação
Campo | Obrig. | Formato | Observação |
funcionario_nome_completo | Texto | Funcionário responsável pela homologação da dispensa | |
funcionario_dt_nascimento | Data | DD/MM/AAAA — necessário se houver funcionários homônimos |
Etapa 4 — Matrículas e Horários
Esta etapa registra os vínculos dos alunos com as turmas, organiza os quadros de horários das turmas, aloca professores por disciplina e, opcionalmente, importa o histórico do diário de conteúdo. Todas as entidades das Etapas 1, 2 e 3 devem estar importadas antes de iniciar esta etapa.
# | Entidade | Obrigatória? |
4.1 | Sim | |
4.2 | Condicional — apenas quando há disciplinas optativas | |
4.3 | Sim | |
4.4 | Sim | |
4.5 | Condicional — necessário para o diário de classe | |
4.6 | Condicional — apenas se a migração incluir o diário |
4.1 - Matrículas
Vincula cada aluno a uma turma. É o registro central do período letivo: sem matrícula, o aluno não aparece nas turmas, boletins ou financeiro.
Chave de identificação: combinação de unidade_nome + turma_descricao + curso_nome + curso_modalidade + calendario_nome + sala_descricao + horario_grupo_nome + aluno_nome_completo + aluno_dt_nascimento
Localização da turma
Estes campos identificam a turma na qual o aluno será matriculado. Os valores devem corresponder exatamente aos registrados nas Etapas 1, 2 e 3.
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | Nome da unidade escolar (Etapa 1) |
turma_descricao | ✓ | Texto | Descrição da turma (Etapa 3) |
curso_nome | ✓ | Texto | Nome do curso (Etapa 2) |
curso_modalidade | ✓ | Texto | Modalidade do curso (Etapa 2) |
calendario_nome | ✓ | Texto | Nome do calendário (Etapa 3) |
sala_descricao | ✓ | Texto | Descrição da sala (Etapa 1) |
horario_grupo_nome | ✓ | Texto | Nome do grupo de horários (Etapa 2) |
Aluno
Campo | Obrig. | Formato | Observação |
aluno_nome_completo | ✓ | Texto | Nome completo do aluno (Etapa 1) |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA — obrigatório para distinguir alunos homônimos |
Responsável principal
Campo | Obrig. | Formato | Valores aceitos / Observação |
responsavel_nome_completo | ✓ | Texto | Nome completo do responsável (Etapa 1) |
responsavel_dt_nascimento | ✓ | Data | DD/MM/AAAA — obrigatório para distinguir responsáveis homônimos |
parentesco | ✓ | Lista | Ver valores abaixo |
Valores para parentesco: PAI · MÃE · MÃE DE CRIAÇÃO · PADRASTO · MADRASTA · TIO(A) · IRMÃO|IRMÃ · PRIMO(A) · AVÔ(Ó) · NENHUM · ELE MESMO · EMPRESA · ESPOSO(A)
Status de entrada
Campo | Obrig. | Formato | Valores aceitos / Observação |
status_entrada | ✓ | Lista |
|
dt_status_entrada | ✓ | Data | DD/MM/AAAA — data em que o status foi atribuído |
Responsável secundário
Campo | Obrig. | Formato | Valores aceitos / Observação |
responsavel_nome_completo_segundo | Texto | Nome do segundo responsável (Etapa 1) | |
responsavel_dt_nascimento_segundo | Data | DD/MM/AAAA | |
segundo_parentesco | Lista | Mesmos valores de |
Situação e saída
Campo | Obrig. | Formato | Valores aceitos / Observação |
status_saida | Lista |
| |
dt_status_saida | Data | DD/MM/AAAA — data da saída | |
situacao_academica | Texto | Ex: | |
dt_situacao_academica | Data | DD/MM/AAAA |
Informações adicionais
Campo | Obrig. | Formato | Observação |
numero_re | Texto | Número de matrícula/registro do aluno | |
observacoes | Texto | Observações gerais sobre a matrícula | |
observacao_declaracao_transferencia | Texto | Motivo ou destino; preencher quando |
4.2 - Matrículas de Disciplinas Optativas
Registra o vínculo de um aluno com uma disciplina optativa dentro de sua turma. Só é necessário quando o currículo da turma possui disciplinas com obrigatoria = 0 (configurado na Etapa 2 em Currículo Disciplina).
Chave de identificação: identificação da matrícula (turma + aluno) + disciplina_nome
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | Nome da unidade escolar (Etapa 1) |
disciplina_nome | ✓ | Texto | Nome da disciplina optativa — deve ter |
turma_descricao | ✓ | Texto | Descrição da turma (Etapa 3) |
curso_nome | ✓ | Texto | Nome do curso (Etapa 2) |
curso_modalidade | ✓ | Texto | Modalidade do curso (Etapa 2) |
calendario_nome | ✓ | Texto | Nome do calendário (Etapa 3) |
sala_descricao | ✓ | Texto | Descrição da sala (Etapa 1) |
horario_grupo_nome | ✓ | Texto | Nome do grupo de horários (Etapa 2) |
aluno_nome_completo | ✓ | Texto | Nome completo do aluno (Etapa 1) |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA — necessário para identificar a matrícula corretamente |
dt_matricula_optativa | Data | DD/MM/AAAA — data em que o aluno optou pela disciplina |
4.3 - Quadros de Horários
Define os períodos de vigência dos horários de uma turma. Toda turma precisa de ao menos um quadro de horários, e os quadros da mesma turma não podem ter datas sobrepostas. Se não for possível determinar as datas exatas, use as datas de início e término do período letivo da turma.
Chave de identificação: localização da turma + dt_inicio + dt_termino
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | Nome da unidade escolar (Etapa 1) |
turma_descricao | ✓ | Texto | Descrição da turma (Etapa 3) |
curso_nome | ✓ | Texto | Nome do curso (Etapa 2) |
curso_modalidade | ✓ | Texto | Modalidade do curso (Etapa 2) |
calendario_nome | ✓ | Texto | Nome do calendário (Etapa 3) |
sala_descricao | ✓ | Texto | Descrição da sala (Etapa 1) |
horario_grupo_nome | ✓ | Texto | Nome do grupo de horários (Etapa 2) |
dt_inicio | ✓ | Data | DD/MM/AAAA — início da vigência do quadro |
dt_termino | ✓ | Data | DD/MM/AAAA — término da vigência do quadro |
nome_quadro | Texto | Nome descritivo do quadro (ex: |
4.4 - Professor Turma
Vincula um funcionário (professor) a uma disciplina dentro de uma turma e de um quadro de horários específico. Cada combinação turma + disciplina + professor + quadro deve ser única.
Chave de identificação: localização da turma + disciplina_nome + funcionario_nome_completo + funcionario_dt_nascimento + datas do quadro (quadro_horario_dt_inicio + quadro_horario_dt_fim)
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | Nome da unidade escolar (Etapa 1) |
disciplina_nome | ✓ | Texto | Nome da disciplina (Etapa 1) |
turma_descricao | ✓ | Texto | Descrição da turma (Etapa 3) |
curso_nome | ✓ | Texto | Nome do curso (Etapa 2) |
curso_modalidade | ✓ | Texto | Modalidade do curso (Etapa 2) |
calendario_nome | ✓ | Texto | Nome do calendário (Etapa 3) |
sala_descricao | ✓ | Texto | Descrição da sala (Etapa 1) |
horario_grupo_nome | ✓ | Texto | Nome do grupo de horários (Etapa 2) |
funcionario_nome_completo | ✓ | Texto | Nome completo do professor/funcionário (Etapa 1) |
funcionario_dt_nascimento | ✓ | Data | DD/MM/AAAA — necessário para identificar corretamente o funcionário |
quadro_horario_dt_inicio | ✓ | Data | DD/MM/AAAA — deve corresponder ao |
quadro_horario_dt_fim | ✓ | Data | DD/MM/AAAA — deve corresponder ao |
4.5 - Professor Horário
Define em quais horários semanais o professor leciona a disciplina na turma. Necessário para o funcionamento do diário de classe e para o quadro de horários do sistema.
Chave de identificação: identificação do professor_turma + horario_inicio + horario_fim + dia_semana
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | Nome da unidade escolar (Etapa 1) |
disciplina_nome | ✓ | Texto | Nome da disciplina (Etapa 1) |
turma_descricao | ✓ | Texto | Descrição da turma (Etapa 3) |
sala_descricao | ✓ | Texto | Descrição da sala (Etapa 1) |
funcionario_nome_completo | ✓ | Texto | Nome completo do professor/funcionário (Etapa 1) |
funcionario_dt_nascimento | ✓ | Data | DD/MM/AAAA |
quadro_horario_dt_inicio | ✓ | Data | DD/MM/AAAA — datas do quadro ao qual este horário pertence |
quadro_horario_dt_fim | ✓ | Data | DD/MM/AAAA |
horario_grupo_nome | ✓ | Texto | Nome do grupo de horários (Etapa 2) |
horario_inicio | ✓ | Hora |
|
horario_fim | ✓ | Hora |
|
dia_semana | ✓ | Lista |
|
curso_nome | ✓ | Texto | Nome do curso (Etapa 2) |
curso_modalidade | ✓ | Texto | Modalidade do curso (Etapa 2) |
calendario_nome | ✓ | Texto | Nome do calendário (Etapa 3) |
4.6 - Diário de Conteúdo
Registra os conteúdos ministrados por disciplina, professor e dia letivo. Importar apenas se a migração incluir o histórico do diário de classe; não é obrigatório para o funcionamento do sistema.
Chave de identificação: combinação de todos os campos de localização + conteudo (chave natural extensa — cada linha de conteúdo é um registro único)
Localização da turma e horário
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | Nome da unidade escolar (Etapa 1) |
turma_descricao | ✓ | Texto | Descrição da turma (Etapa 3) |
curso_nome | ✓ | Texto | Nome do curso (Etapa 2) |
curso_modalidade | ✓ | Texto | Modalidade do curso (Etapa 2) |
calendario_nome | ✓ | Texto | Nome do calendário (Etapa 3) |
sala_descricao | ✓ | Texto | Descrição da sala (Etapa 1) |
horario_grupo_nome | ✓ | Texto | Nome do grupo de horários (Etapa 2) |
horario_inicio | ✓ | Hora |
|
horario_fim | ✓ | Hora |
|
Disciplina e professor
Campo | Obrig. | Formato | Observação |
disciplina_nome | ✓ | Texto | Nome da disciplina (Etapa 1) |
funcionario_nome_completo | ✓ | Texto | Nome do professor responsável pelo registro (Etapa 1) |
funcionario_dt_nascimento | ✓ | Data | DD/MM/AAAA |
Sistema de avaliação e divisão
Campo | Obrig. | Formato | Observação |
sistema_avaliacao_nome | ✓ | Texto | Nome do sistema de avaliação (Etapa 3) |
divisao_nome | ✓ | Texto | Nome da divisão (bimestre/trimestre) em que o conteúdo foi ministrado (Etapa 3) |
Dia do calendário
Campo | Obrig. | Formato | Observação |
calendario_dia_calendario_nome | ✓ | Texto | Nome do calendário ao qual o dia pertence (Etapa 3) |
calendario_dia_divisao_nome | ✓ | Texto | Nome da divisão à qual o dia está vinculado (Etapa 3) |
calendario_dia_dia | ✓ | Data | DD/MM/AAAA — data exata da aula |
Conteúdo
Campo | Obrig. | Formato | Observação |
conteudo | ✓ | Texto | Descrição do conteúdo ministrado na aula |
Etapa 5 — Financeiro, Avaliações e Ocorrências
Esta etapa registra os dados financeiros das matrículas (parcelas e boletos), as notas acadêmicas em seus diferentes níveis, faltas, ocorrências, fornecedores, contas a pagar e a situação acadêmica por disciplina. Todas as entidades das Etapas 1 a 4 devem estar importadas.
# | Entidade | Obrigatória? |
5.1 | Condicional — para migração financeira | |
5.2 | Condicional — apenas se há dados bancários de boletos | |
5.3 | Condicional | |
5.4 | Condicional — para migração de histórico acadêmico | |
5.5 | Condicional | |
5.6 | Condicional | |
5.7 | Condicional | |
5.8 | Condicional | |
5.9 | Condicional — deve preceder Contas a Pagar | |
5.10 | Condicional | |
5.11 | Condicional |
5.1 - Parcelas
Registra as parcelas financeiras de cada matrícula. É a principal entidade da migração financeira.
Chave de identificação: localização da matrícula + dt_vencimento + dt_inicio + itens_parcela + descricao
Localização da matrícula
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | |
turma_descricao | ✓ | Texto | |
curso_nome | ✓ | Texto | |
curso_modalidade | ✓ | Texto | |
calendario_nome | ✓ | Texto | |
sala_descricao | ✓ | Texto | |
horario_grupo_nome | ✓ | Texto | |
aluno_nome_completo | ✓ | Texto | |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA |
responsavel_nome_completo | ✓ | Texto | Responsável financeiro da matrícula |
responsavel_dt_nascimento | ✓ | Data | DD/MM/AAAA |
Dados da parcela
Campo | Obrig. | Formato | Observação |
dt_vencimento | ✓ | Data | DD/MM/AAAA |
dt_inicio | ✓ | Data | DD/MM/AAAA — início da competência |
valor_parcela | ✓ | Número | Valor líquido (com desconto) — ex: |
valor_parcela_cheio | ✓ | Número | Valor bruto (sem desconto) — ex: |
finalizada | ✓ | Lista |
|
itens_parcela | ✓ | Texto | Ver formato abaixo |
descricao | ✓ | Texto | Descrição da cobrança — ex: |
mes_competencia | ✓ | Texto | Mês de referência no formato |
Formato de itens_parcela: NOME_ITEM(valor_com_desconto#valor_cheio) — múltiplos itens separados por ;
Exemplos: MENSALIDADE(800.00#900.00) · MENSALIDADE(800.00#800.00);MATERIAL(150.00#150.00)
Pagamento
Campo | Obrig. | Formato | Observação |
dt_pagamento | Data | DD/MM/AAAA — obrigatório quando | |
dt_credito | Data | DD/MM/AAAA — data do crédito na conta | |
valor_pago | Número | Valor efetivamente recebido | |
multa_juros_pago | Número | Total de multa e juros cobrados na baixa | |
desconto_concedido_baixa | Número | Desconto concedido no momento da baixa | |
desconto_perdido_pago | Número | Desconto não aproveitado | |
conta_movimentacao_pago | Texto | Nome da conta de movimentação (caixa/banco) usada no registro do pagamento |
Dados bancários / boleto
Campo | Obrig. | Formato | Observação |
banco | Texto | Nome do banco | |
agencia | Texto | Número da agência | |
conta_corrente | Texto | Número da conta corrente | |
nosso_numero | Texto | Nosso número do boleto | |
status_boleto | Texto | Ex: | |
data_liquidacao | Data | DD/MM/AAAA | |
multa | Número | Percentual de multa por atraso | |
mora_diaria | Número | Percentual de mora diária | |
data_multa_mora | Data | DD/MM/AAAA — data a partir da qual multa e mora passam a ser cobradas |
Descontos antecipados
Campo | Obrig. | Formato | Observação |
desc1_data | Data | DD/MM/AAAA — data-limite para o 1º desconto | |
desc1_valor | Número | Valor do 1º desconto | |
desc2_data | Data | DD/MM/AAAA | |
desc2_valor | Número | Valor do 2º desconto | |
desc3_data | Data | DD/MM/AAAA | |
desc3_valor | Número | Valor do 3º desconto |
Estorno e informações adicionais
Campo | Obrig. | Formato | Observação |
estornada | Lista |
| |
motivo_estorno | Texto | Obrigatório quando | |
usuario_estorno | Texto | Usuário responsável pelo estorno | |
data_estorno | Data | DD/MM/AAAA | |
dt_termino | Data | DD/MM/AAAA — término da vigência | |
observacoes | Texto |
5.2 - Boletos
Registra os dados bancários dos boletos vinculados às parcelas. Importar apenas quando a migração incluir o histórico de boletos gerados.
Chave de identificação: localização da matrícula + dt_vencimento + dt_inicio + itens_parcela + descricao
Pré-requisito: as parcelas correspondentes (Etapa 5.1) devem estar importadas.
Localização da matrícula
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | |
turma_descricao | ✓ | Texto | |
curso_nome | ✓ | Texto | |
curso_modalidade | ✓ | Texto | |
calendario_nome | ✓ | Texto | |
sala_descricao | ✓ | Texto | |
horario_grupo_nome | ✓ | Texto | |
aluno_nome_completo | ✓ | Texto | |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA |
responsavel_nome_completo | ✓ | Texto | |
responsavel_dt_nascimento | ✓ | Data | DD/MM/AAAA |
Dados da parcela
Campo | Obrig. | Formato | Observação |
dt_vencimento | ✓ | Data | DD/MM/AAAA |
dt_inicio | ✓ | Data | DD/MM/AAAA |
valor_parcela_cheio | ✓ | Número | Valor bruto (face do boleto) |
valor_parcela | ✓ | Número | Valor líquido |
itens_parcela | ✓ | Texto | Mesmo formato de |
descricao | ✓ | Texto |
Dados bancários
Campo | Obrig. | Formato | Observação |
banco | ✓ | Texto | Nome do banco emissor |
agencia | ✓ | Texto | Número da agência |
conta_corrente | ✓ | Texto | Número da conta corrente |
nosso_numero | ✓ | Texto | Código de barras / nosso número |
status_boleto | ✓ | Lista |
|
multa | ✓ | Número | Percentual de multa |
mora_diaria | ✓ | Número | Percentual de mora diária |
data_multa_mora | ✓ | Data | DD/MM/AAAA |
data_liquidacao | Data | DD/MM/AAAA — data da liquidação do boleto |
5.3 - Ocorrências
Registra ocorrências disciplinares, comportamentais ou pedagógicas associadas a um aluno e turma.
Chave de identificação: localização da matrícula + ocorrencia_tipo + dt_ocorrencia
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | |
turma_descricao | ✓ | Texto | |
curso_nome | ✓ | Texto | |
curso_modalidade | ✓ | Texto | |
calendario_nome | ✓ | Texto | |
sala_descricao | ✓ | Texto | |
horario_grupo_nome | ✓ | Texto | |
aluno_nome_completo | ✓ | Texto | |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA |
ocorrencia_tipo | ✓ | Texto | Tipo ou categoria da ocorrência — texto livre |
dt_ocorrencia | ✓ | Data | DD/MM/AAAA |
ocorrencia_obs | ✓ | Texto | Descrição/observação da ocorrência |
disciplina_nome | Texto | Disciplina relacionada (quando aplicável) | |
funcionario_nome_completo | Texto | Funcionário que registrou a ocorrência | |
funcionario_dt_nascimento | Data | DD/MM/AAAA — necessário se houver funcionários homônimos |
5.4 - Notas Finais
Registra a nota final do aluno em cada disciplina da turma, após todos os cálculos e avaliações do período letivo.
Chave de identificação: localização da turma + disciplina_nome + identificação do aluno
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | |
disciplina_nome | ✓ | Texto | |
turma_descricao | ✓ | Texto | |
curso_nome | ✓ | Texto | |
curso_modalidade | ✓ | Texto | |
calendario_nome | ✓ | Texto | |
sala_descricao | ✓ | Texto | |
horario_grupo_nome | ✓ | Texto | |
aluno_nome_completo | ✓ | Texto | |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA |
valor_numerico | ✓ | Número | Nota final numérica — ex: |
valor_conceitual | Texto | Nota conceitual — ex: |
5.5 - Notas por Divisão
Registra a nota do aluno em uma divisão específica (bimestre, trimestre, semestre). Representa a média ou nota calculada dentro da divisão.
Chave de identificação: turma + disciplina + aluno + sistema_avaliacao_nome + divisao_nome
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | |
disciplina_nome | ✓ | Texto | |
turma_descricao | ✓ | Texto | |
curso_nome | ✓ | Texto | |
curso_modalidade | ✓ | Texto | |
calendario_nome | ✓ | Texto | |
sala_descricao | ✓ | Texto | |
horario_grupo_nome | ✓ | Texto | |
aluno_nome_completo | ✓ | Texto | |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA |
sistema_avaliacao_nome | ✓ | Texto | Nome do sistema de avaliação (Etapa 3) |
divisao_nome | ✓ | Texto | Nome da divisão — ex: |
valor_numerico | ✓ | Número | Nota da divisão — ex: |
valor_conceitual | Texto | Nota conceitual — ex: |
5.6 - Notas por Avaliação
Registra a nota do aluno em uma avaliação específica dentro de uma divisão (ex: Prova 1, Trabalho 2).
Chave de identificação: turma + disciplina + aluno + sistema + divisão + avaliacao_nome
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | |
disciplina_nome | ✓ | Texto | |
turma_descricao | ✓ | Texto | |
curso_nome | ✓ | Texto | |
curso_modalidade | ✓ | Texto | |
calendario_nome | ✓ | Texto | |
sala_descricao | ✓ | Texto | |
horario_grupo_nome | ✓ | Texto | |
aluno_nome_completo | ✓ | Texto | |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA |
sistema_avaliacao_nome | ✓ | Texto | Nome do sistema de avaliação (Etapa 3) |
divisao_nome | ✓ | Texto | Nome da divisão (Etapa 3) |
avaliacao_nome | ✓ | Texto | Nome da avaliação (Etapa 3) — ex: |
valor_numerico | Número | Nota numérica — preencher quando a avaliação é numérica | |
valor_conceitual | Texto | Nota conceitual — preencher quando a avaliação é conceitual |
Pelo menos um de valor_numerico ou valor_conceitual deve ser informado para registrar a nota.
5.7 - Notas do Professor
Registra a nota atribuída por um professor específico em uma avaliação. Utilizado quando múltiplos professores avaliam o mesmo aluno na mesma avaliação e as notas individuais precisam ser preservadas.
Chave de identificação: turma + disciplina + aluno + sistema + divisão + avaliação + professor
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | |
disciplina_nome | ✓ | Texto | |
turma_descricao | ✓ | Texto | |
curso_nome | ✓ | Texto | |
curso_modalidade | ✓ | Texto | |
calendario_nome | ✓ | Texto | |
sala_descricao | ✓ | Texto | |
horario_grupo_nome | ✓ | Texto | |
aluno_nome_completo | ✓ | Texto | |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA |
sistema_avaliacao_nome | ✓ | Texto | Nome do sistema de avaliação (Etapa 3) |
divisao_nome | ✓ | Texto | Nome da divisão (Etapa 3) |
avaliacao_nome | ✓ | Texto | Nome da avaliação (Etapa 3) |
funcionario_nome_completo | ✓ | Texto | Nome do professor (Etapa 1) |
funcionario_dt_nascimento | ✓ | Data | DD/MM/AAAA |
valor_numerico | ✓ | Número | Nota atribuída pelo professor |
valor_conceitual | Texto | Nota conceitual — quando aplicável |
5.8 - Faltas
Registra as faltas individuais por aula (horário específico) e dia letivo do calendário.
Chave de identificação: turma + aluno + horário (horario_inicio + horario_fim) + dia letivo
Localização da turma e aluno
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | |
turma_descricao | ✓ | Texto | |
curso_nome | ✓ | Texto | |
curso_modalidade | ✓ | Texto | |
calendario_nome | ✓ | Texto | |
sala_descricao | ✓ | Texto | |
horario_grupo_nome | ✓ | Texto | |
aluno_nome_completo | ✓ | Texto | |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA |
Horário da aula
Campo | Obrig. | Formato | Observação |
horario_inicio | ✓ | Hora |
|
horario_fim | ✓ | Hora |
|
Dia do calendário
Campo | Obrig. | Formato | Observação |
calendario_dia_calendario_nome | ✓ | Texto | Nome do calendário (Etapa 3) |
calendario_dia_dia | ✓ | Data | DD/MM/AAAA — data da aula |
calendario_dia_sistema_avaliacao_nome | ✓ | Texto | Sistema de avaliação do dia (Etapa 3) |
calendario_dia_divisao_nome | ✓ | Texto | Divisão do dia — ex: |
Dados da falta
Campo | Obrig. | Formato | Observação |
tipo | Texto | Padrão: | |
justificada | Lista |
| |
justificativa | Texto | Descrição da justificativa, quando | |
abonada | Lista |
|
5.9 - Fornecedores
Cadastra os fornecedores da escola (empresas ou pessoas físicas prestadoras de serviços). Deve ser importado antes de Contas a Pagar quando houver fornecedores vinculados às despesas.
Chave de identificação: nome_fornecedor + cnpj
Identificação
Campo | Obrig. | Formato | Observação |
nome_fornecedor | ✓ | Texto | Nome completo do fornecedor ou razão social |
tipo_fornecedor | ✓ | Lista |
|
cnpj | Texto | CNPJ para PJ; CPF para PF — aceita com ou sem máscara | |
nome_fantasia | Texto | Nome fantasia ou apelido comercial |
Endereço
Campo | Obrig. | Formato | Observação |
end_logradouro | Texto | ||
end_numero | Texto | ||
end_complemento | Texto | ||
end_bairro | Texto | ||
end_municipio | Texto | ||
end_uf | Texto | Sigla do estado — ex: | |
end_cep | Texto | Formato: |
Contato e observações
Campo | Obrig. | Formato | Observação |
telefones | Texto | Um ou mais telefones separados por | |
Texto | |||
observacoes | Texto |
Dados bancários
Campo | Obrig. | Formato | Observação |
banco | Texto | Nome do banco | |
agencia | Texto | Número da agência | |
n_conta | Texto | Número da conta | |
operacao | Texto | Tipo de conta — ex: |
Status
Campo | Obrig. | Formato | Observação |
status_ativo | Lista |
|
5.10 - Contas a Pagar
Nota: A âncora de navegação desta seção é compartilhada com Fornecedores (5.9). Links do sistema para "Contas a Pagar" redirecionarão para a seção 5.9 - Fornecedores acima.
Registra as despesas e obrigações financeiras da escola — aluguéis, fornecedores, serviços, folha de pagamento etc.
Chave de identificação: unidade_nome + descricao + nome_operacao_financeira + funcionário (nome + dt_nasc) + fornecedor (nome + CNPJ) + dt_vencimento + mes_competencia + valor
Identificação
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | Nome da unidade escolar (Etapa 1) |
descricao | ✓ | Texto | Descrição do lançamento — ex: |
nome_operacao_financeira | ✓ | Texto | Nome do tipo de despesa no iScholar — ex: |
mes_competencia | ✓ | Texto | Mês de referência no formato |
Datas e valor
Campo | Obrig. | Formato | Observação |
dt_inicio | ✓ | Data | DD/MM/AAAA — início da competência |
dt_vencimento | ✓ | Data | DD/MM/AAAA |
valor | ✓ | Número | Valor da conta — ex: |
finalizada | ✓ | Lista |
|
dt_termino | Data | DD/MM/AAAA — término (para contratos recorrentes) | |
dt_pagamento | Data | DD/MM/AAAA — obrigatório quando |
Vínculos
Campo | Obrig. | Formato | Observação |
funcionario_nome_completo | Texto | Funcionário vinculado à despesa (Etapa 1) | |
funcionario_dt_nascimento | Data | DD/MM/AAAA — necessário se houver funcionários homônimos | |
nome_fornecedor | Texto | Fornecedor vinculado (Etapa 5.9) | |
cnpj | Texto | CNPJ do fornecedor — necessário junto com |
Para vincular a um funcionário: preencher funcionario_nome_completo + funcionario_dt_nascimento. Para vincular a um fornecedor: preencher nome_fornecedor + cnpj.
Nota fiscal
Campo | Obrig. | Formato | Observação |
nota_fiscal_pgto | Texto | Número da nota fiscal de pagamento | |
dt_nota_fiscal_pgto | Data | DD/MM/AAAA |
Estorno
Campo | Obrig. | Formato | Observação |
estornada | Lista |
| |
motivo_estorno | Texto | Obrigatório quando | |
usuario_estorno | Texto | Usuário responsável pelo estorno | |
data_estorno | Data | DD/MM/AAAA |
5.11 - Situação das Disciplinas
Registra a situação acadêmica do aluno por disciplina (aprovado/reprovado/cursando). Importar apenas quando a situação individual por disciplina difere da situação geral da matrícula ou quando o sistema legado a armazena por disciplina.
Chave de identificação: localização da turma + disciplina_nome + identificação do aluno
Campo | Obrig. | Formato | Observação |
unidade_nome | ✓ | Texto | |
disciplina_nome | ✓ | Texto | |
turma_descricao | ✓ | Texto | |
curso_nome | ✓ | Texto | |
curso_modalidade | ✓ | Texto | |
calendario_nome | ✓ | Texto | |
sala_descricao | ✓ | Texto | |
horario_grupo_nome | ✓ | Texto | |
aluno_nome_completo | ✓ | Texto | |
aluno_dt_nascimento | ✓ | Data | DD/MM/AAAA |
situacao | ✓ | Texto | Situação acadêmica na disciplina — ex: |
Etapa 6 — Biblioteca
Esta etapa importa o acervo bibliográfico da escola. É independente das Etapas 2 a 5 — depende apenas da Etapa 1 (Unidades) para vincular as estantes às unidades.
Auto-criação: Os registros de Gênero, Subgênero e Mídia referenciados na Bibliografia são criados automaticamente durante a importação se ainda não existirem. A Estante referenciada no Exemplar também é criada automaticamente.
# | Entidade | Obrigatória? |
6.1 | Sim (antes dos Exemplares) | |
6.2 | Condicional — após a Bibliografia |
6.1 - Biblioteca > Bibliografia
Registra as obras do acervo (livros, revistas, DVDs etc.). Cada registro representa um título único identificado pela combinação título + autor + edição.
Chave de identificação: titulo + autor + edicao
Identificação da obra
Campo | Obrig. | Formato | Observação |
titulo | ✓ | Texto | Título completo da obra |
autor | ✓ | Texto | Autor principal |
edicao | ✓ | Texto | Ex: |
subtitulo | Texto | ||
editora | Texto | ||
ano | Número | Ano de publicação | |
isbn | Texto | ISBN da obra | |
issn | Texto | ISSN (para periódicos) | |
colecao | Texto | Nome da coleção |
Conteúdo e classificação
Campo | Obrig. | Formato | Observação |
palavras_chave | Texto | Separadas por vírgula | |
genero_nome | Texto | Gênero literário — ex: | |
subgenero_nome | Texto | Subgênero — ex: | |
midia_nome | Texto | Tipo de mídia — ex: | |
midia_atual_nome | Texto | Mídia atual da obra (geralmente igual a |
Classificação bibliográfica
Campo | Obrig. | Formato | Observação |
item_lc | Texto | Item LC (Library of Congress) | |
chamada_lc | Texto | Chamada LC | |
edicao_dewey | Texto | Edição Dewey | |
classificacao_dewey | Texto | Classificação Dewey | |
classificacao_cutter | Texto | Classificação Cutter | |
cdu | Texto | CDU (Classificação Decimal Universal) | |
local | Texto | Localização na biblioteca |
Descrição física
Campo | Obrig. | Formato | Observação |
numero_paginas | Número | ||
detalhes_fisicos | Texto | Ex: | |
dimenssoes | Texto | Ex: | |
capa | Texto | Ex: | |
material_adicional | Texto | Ex: | |
sumario | Texto | Sumário ou sinopse da obra |
6.2 - Biblioteca > Exemplar
Registra os exemplares físicos (cópias) de cada obra do acervo. Cada linha representa um exemplar individual identificado por tombamento ou número de exemplar.
Chave de identificação: bibliografia_titulo + bibliografia_autor + bibliografia_edicao + estante_nome + unidade_nome + nr_exemplar + tombamento
Pré-requisito: a obra deve estar cadastrada na Bibliografia (6.1).
Campo | Obrig. | Formato | Observação |
bibliografia_titulo | ✓ | Texto | Título da obra — deve corresponder exatamente à Bibliografia |
bibliografia_autor | ✓ | Texto | Autor da obra |
bibliografia_edicao | ✓ | Texto | Edição da obra — necessário para identificar a obra corretamente quando há múltiplas edições |
estante_nome | ✓ | Texto | Nome da estante onde o exemplar está alocado — ex: |
unidade_nome | ✓ | Texto | Nome da unidade escolar à qual a estante pertence (Etapa 1) — recomendado quando há múltiplas unidades |
nr_exemplar | Texto | Número sequencial do exemplar — ex: | |
tombamento | Texto | Código de tombamento do exemplar — ex: | |
dt_cadastro | Data | DD/MM/AAAA — data de entrada do exemplar no acervo | |
descricao | Texto | Descrição física do exemplar — ex: | |
observacoes | Texto | ||
ativo | Lista |
| |
consulta_publica | Lista |
| |
pode_emprestar | Lista |
|