Processo Migração de Dados

2020-08-17T19:24:48Z

Talesruan:

O processo de migração de dados é realizado por meio de arquivos de importação, que seguem um layout específico e que devem ser gerados, pelo responsável na instituição, com base nos dados do sistema legado da instituição de ensino para que sejam posteriormente importados na plataforma da Gennera.

De todas as etapas do processo de implantação, a fase de migração dos dados é a que exige mais atenção, já que muitas vezes, os usuários da instituição de ensino não possuem o conhecimento técnico necessário para a geração dos arquivos.

Em muitos casos, pode ser necessário contratar um especialista externo para realizar a geração dos arquivos de importação com o auxílio dos usuários da instituição de ensino, que conhecem com mais profundidade os processos de negócio e sabem operar o sistema legado.

A plataforma da Gennera conta com um [[Documentação Importador | módulo específico]] para validar os arquivos de importação que deve ser utilizado durante a etapa de geração dos arquivos. Após a validação, a equipe de migração de dados da Gennera iniciará o processo de carga dos dados para que o responsável pela instituição de ensino possa aprovar, encerrando o processo de migração de dados.

== Formato dos Arquivos ==

Os arquivos de importação devem seguir as seguintes regras:

* Devem conter o nome das colunas no cabeçalho
* Devem ser codificados em [[Artigo_UTF-8 | UTF-8]]
* Devem ter os dados, entre as colunas, separados por TAB
* Devem ser respeitados os campos indicados como obrigatórios
* Devem ser populadas, em todas as linhas, o número de colunas definido ainda que os campos sejam opcionais
* Os números decimais devem utilizar "." (ponto), e não "," (vírgula), para separar a parte inteira das casas decimais
** 1000 é um valor válido
** 9.5 é um valor válido
** 1,5 é um valor inválido
* As datas devem ser formatadas utilizando o padrão DD/MM/AAAA e devem ser válidas
** 01/01/2002 é um valor válido
** 99/99/9999 é um valor inválido

== Arquivos de Importação ==

=== Dados cadastrais básicos ===

==== Curso ====

Informações dos Cursos.

Nome do Arquivo: Curso.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_course
| Identificador do curso
| Somente Números Ex: 123, 67
| integer
| Sim
|
|-
| name
| Nome do curso
| O nome do curso na instituição de ensino
| text
| Sim
|
|-
| level
| Nome do nível do curso
| Educação Superior, Educação Básica
| text
|
|
|-
| type
| Nome do tipo do curso
| Cursos Sequencias, Graduação, Pós Graduação, Extensão
| text
|
|
|-
| grade
| Titulação
| bacharelado, etc
| text
|
|
|-
| secretary
| Nome do secretário
| João Paulo, etc
| text
|
|
|-
| secretary_subscription
| Inscrição do secretário
| Descrição da inscrição
| text
|
|
|-
| authorization
| Autorização
| Descrição da autorização
| text
|
|
|-
| recognition
| Reconhecimento
| Descrição do reconhecimento
| text
|
|
|-
| code_inep
| Código do Curso no INEP/E-MEC
| Código do Curso no INEP/E-MEC
| text
|
|
|-
| modality
| Modalidade
| Presencial, A distância, semipresencial
| text
|
|
|}

==== Currículo ====

Informações dos currículos.

Nome do Arquivo: Curriculo.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_curriculum
| Identificador do currículo
| Somente Números Ex: 123, 67
| integer
| Sim
|
|-
| name
| Nome do currículo
| O nome do currículo na instituição de ensino
| text
| Sim
|
|-
| id_course
| Identificador do curso
| Somente Números Ex: 123, 67
| integer
| Sim
| '''Curso'''
|}

==== Módulo ====

Informações dos módulos.

Nome do Arquivo: Modulo.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_module
| Identificador do módulo
| Somente Números Ex: 123, 67
| integer
| Sim
|
|-
| name
| Nome do módulo
| O nome do módulo na instituição de ensino
| text
| Sim
|
|-
| index
| Ordem crescente em que será apresentado o módulo
| Somente Números Ex: 1, 2, 3 ...
| integer
| Sim
|
|-
| id_curriculum
| Identificador do currículo
| Somente Números Ex: 123, 67
| integer
| Sim
| '''Currículo'''
|}

==== Disciplina ====

Informações das disciplinas.

Nome do Arquivo: Disciplina.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_subject
| Identificador da disciplina
| Somente Números Ex: 123, 67
| integer
| Sim
|
|-
| name
| Nome da disciplina
| O nome da disciplina na instituição de ensino
| text
| Sim
|
|-
| index
| Ordem crescente em que será apresentada a disciplina
| Somente Números Ex: 1, 2, 3 ...
| integer
| Sim
|
|-
| credit
| número de créditos
| Somente Números Ex: 4, 5, ...
| integer
| Sim
|
|-
| required
| Obrigatoriedade
| true, false
| boolean
| false
|
|-
| workload
| Carga horária
| Somente Números Ex: 95, 100, ...
| integer
| Sim
|
|-
| code
| Código descritivo da disciplina
| PT, MAT, etc
| text
|
|
|-
| id_module
| Identificador do módulo
| Somente Números Ex: 123, 67
| integer
| Sim
| '''Módulo'''
|}

===== Disciplina Equivalente =====

Informações das disciplinas equivalentes.

Nome do Arquivo: DisciplinaEquivalente.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_subject
| Identificador da disciplina principal
| Somente Números Ex: 123, 67
| integer
| Sim
| '''Disciplina'''
|-
| id_subject_equivalence
| Identificador da disciplina equivalente
| Somente Números Ex: 123, 67
| integer
| Sim
| '''Disciplina'''
|}

===== Disciplina Pré-Requisito =====

Informações das disciplinas pré-requisito.

Nome do Arquivo: DisciplinaPrerequisito.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_subject
| Identificador da disciplina principal
| Somente Números Ex: 123, 67
| integer
| Sim
| '''Disciplina'''
|-
| id_subject_prerequisite
| Identificador da disciplina de pré-requisito
| Somente Números Ex: 123, 67
| integer
| Sim
| '''Disciplina'''
|}

===== Disciplina Co-Requisito =====

Informações das disciplinas co-requisito.

Nome do Arquivo: DisciplinaCorequisito.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_subject
| Identificador da disciplina principal
| Somente Números Ex: 123, 67
| integer
| Sim
| '''Disciplina'''
|-
| id_subject_corequisite
| Identificador da disciplina de co-requisito
| Somente Números Ex: 123, 67
| integer
| Sim
| '''Disciplina'''
|}

==== Calendário Acadêmico ====

Informações dos calendários acadêmicos.

Nome do Arquivo: CalendarioAcademico.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_academic_calendar
| Identificador do calendário acadêmico
| Somente Números Ex: 123, 67
| integer
| Sim
|
|-
| name
| Descrição do calendário acadêmico
| Nome do calendário na instituição de ensino
| text
| Sim
|
|-
| start_date
| Data inicial do calendário
| 31/01/1990
| date
| Sim
|
|-
| end_date
| Data inicial do calendário
| 31/01/1990
| date
| Sim
|
|-
| code
| Código do Calendário
| A1, 20102, etc
| text
|
|
|-
| reference_year
| Ano Referência
| 2010, 20182
| text
|
|
|}

==== Período ====

Informações dos períodos.

Nome do Arquivo: Periodo.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_period
| Identificador do período
| Somente Números Ex: 123, 67
| integer
| Sim
|
|-
| name
| Descrição do período
| Nome do período na instituição de ensino
| text
| Sim
|
|-
| start_date
| Data inicial do calendário
| 31/01/1990
| date
| Sim
|
|-
| end_date
| Data inicial do calendário
| 31/01/1990
| date
| Sim
|
|-
| code
| Código do Período
| P1, P2, etc
| text
|
|
|-
| index
| Ordem crescente do período
| 1, 2, 3, 4
| integer
| Sim
|
|-
| retake_period
| Período de recuperação
| true, false
| boolean
|
|
|-
| id_academic_calendar
| Identificador do calendário acadêmico
| Somente Números Ex: 123, 67
| integer
| Sim
| '''Calendário Acadêmico'''
|}

==== Pessoa ====

Dados completos das pessoas cadastradas na instituição de ensino.

Nome do Arquivo: Pessoa.csv

Filtro: Todos os registros existentes

Obrigatório: Sim

{| class="wikitable sortable" style="width:100%"
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_person
| Código '''ÚNICO''' que identifica a pessoa na instituição de ensino
| 001, 002, 003, etc
| integer
| sim
|
|-
| id_student
| Código '''ÚNICO''' que identifica o aluno na instituição de ensino que poderá ser o mesmo valor de id_person
| 001, 002, 003, etc
| integer
|
|
|-
| profile
| O perfil da pessoa
| 1 (Professor), 2 (Aluno), 3 (Instituição)
| integer
|
|
|-
| type
| O tipo de pessoa
| 1 (Pessoa Física), 2 (Pessoa Jurídica), 3 (Pessoa Física - Estrangeiro)
| integer
|
|
|-
| name
| Nome da pessoa (necessário nome e sobrenome)
| João C. Lima, Ana Maria S. Cruz, etc.
| text
| sim
|
|-
| email
| Email da pessoa
| aluno@yahoo.com.br
| text
|
|
|-
| zipcode
| CEP
| 88122420 (somente números)
| text
| sim
|
|-
| street
| Logradouro da residência
| R. Floriano, R. Direita, etc.
| text
| sim
|
|-
| street_number
| Número de localização da residência no logradouro.
| 123, 44, etc
| text
| sim
| valor default S/N
|-
| city
| Nome da Cidade da residência
| São Paulo
| text
| sim
|
|-
| state
| Sigla da UF residencial
| SP
| varchar(2)
| sim
|
|-
| country
| Nome do País
| Brasil
| text
| Sim
|
|-
| complement
| Complemento do logradouro (Número da casa, apartamento, bloco, etc).
| Edifício Gennera - apto 201; bloco A, apto 44; etc
| text
|
|
|-
| neighborhood
| Bairro da residência
| Centro
| text
|
|
|-
| zone
| Indica a zona residencial
| Urbana ou Rural
| text
| Sim
|
|-
| birthdate
| Data de nascimento
| 31/01/1990
| date
| Sim
|
|-
| birthplace
| Nome da cidade de nascimento
| São Paulo, Santos, Niterói, Itabirito, etc.
| text
|
|
|-
| birth_state
| UF de nascimento
| SC, SP, RJ, MG.
| varchar(2)
|
|
|-
| nationality
| Nacionalidade
| Brasileira, Chilena, Argentina, etc.
| text
|
|
|-
| gender
| Sexo da pessoa
| Masculino, Feminino,
| text
| Sim
|
|-
| ethnicity
| Cor/raça do aluno conforme classificação do MEC
| Indígena, Amarela, Parda, Não Declarada, Preta, Branca
| text
|
|
|-
| rg
| Número da carteira de Identidade (RG)
| 12345678 (somente números)
| text
|
|
|-
| rg_issuing_agency
| Código do órgão expedidor da carteira de identidade
| SSP, MEx, CREA, OAB, DPF, etc.
| text
|
|
|-
| rg_issuing_state
| UF do órgão expedidor da carteira de identidade
| SC, SP, RJ, MG.
| varchar(2)
|
|
|-
| rg_issue_date
| Data de Expedição da carteira de identidade
| 31/01/1999
| date
|
|
|-
| social_id
| Número de Identificação Social
| 123456
| text
|
|
|-
| cpf
| Número do CPF da pessoa
| 20919195600 (somente números)
| text
|
|
|-
| cnpj
| Número do CNPJ da pessoa
| 31575212000120 (somente números)
| text
|
|
|-
| civil_status
| Estado civil
| Solteiro, Casado, Divorciado, Viúvo, Separado
| text
|
|
|-
| profession
| Profissão
| Estudante, Comerciário, etc.
| text
|
|
|-
| religion
| Religião
| Católica, Protestante, Espírita, etc.
| text
|
|
|-
| telephone_area_code
| Código de área do telefone
| 48
| varchar(2)
|
|
|-
| telephone_number
| Número do telefone
| 32333020 (sem formatação e sem código de área)
| text
|
|
|-
| mobile_phone_area_code
| Código de área do telefone celular
| 48
| varchar(2)
|
|
|-
| mobile_phone_number
| Número do telefone celular
| 8888888
| text
|
|
|-
| commercial_phone_area_code
| Código de área do telefone comercial
| 48
| varchar(2)
|
|
|-
| commercial_phone_number
| Número do telefone comercial
| 88888888
| text
|
|
|-
| fax_area_code
| Código de área do fax
| 48
| varchar(2)
|
|
|-
| fax_number
| Número do fax
| 88888888
| text
|
|
|-
| foreigner_document_issue_date
| Data de expedição da Carteira de estrangeiro
| 31/01/1990
| date
|
|
|-
| foreigner_document
| Código do Registro Nacional de Estrangeiro
| 123456
| text
|
|
|-
| foreigner_document_expiry_date
| Data de validade do documento de estrangeiro
| 31/12/2010
| date
|
|
|-
| military_status
| Descrição da situação militar
| Dispensado
| text
|
|
|-
| military_description
| Descrição do Registro Militar
|
| text
|
|
|-
| military_certificate
| Número do certificado Militar
| 12345
| text
|
|
|-
| military_certificate_description
| Descrição do certificado Militar
|
| text
|
|
|-
| voter_document
| Número do Titulo de Eleitor
| 12341
| text
|
|
|-
| voter_document_issue_date
| Data de expedição do Titulo de Eleitor
| 31/01/1990
| date
|
|
|-
| voter_document_city
| Nome do município de emissão do Titulo de Eleitor
| São Paulo, Rio de Janeiro, etc.
| text
|
|
|-
| voter_document_state
| Sigla da UF de emissão do Titulo de Eleitor
| SP, SC, RJ
| char(2)
|
|
|-
| voter_document_section
| Descrição da seção do Titulo de Eleitor
| 154
| char(3)
|
|
|-
| voter_document_zone
| Número da zona eleitoral
| 2
| char(3)
|
|
|-
| civil_certificate_term
| Número do Termo da Certidão Civil
| 432
| text
|
|
|-
| civil_certificate_page
| Número da folha no livro de Certidão Cívil
| 521
| text
|
|
|-
| civil_certificate_book
| Descrição do Livro da Certidão Civil
| A-028
| text
|
|
|-
| civil_certificate_issue_date
| Data da emissão da Certidão Cívil
| 01/01/1900
| date
|
|
|-
| civil_certificate_agency_state
| Sigla da UF do cartório
| SC
| char(2)
|
|
|-
| civil_certificate_agency
| Nome do órgão usado para emitir a Certidão Civil.
| 11º Cartório do Registro Civil
| text
|
|
|-
| marriage_certificate_term
| Número do Termo da Certidão de casamento
| 432
| text
|
|
|-
| marriage_certificate_page
| Número da folha no livro de Certidão de casamento
| 521
| text
|
|
|-
| marriage_certificate_book
| Descrição do Livro da Certidão de casamento
| A-028
| text
|
|
|-
| marriage_certificate_issue_date
| Data da emissão da Certidão de casamento
| 01/01/1900
| date
|
|
|-
| marriage_certificate_agency_state
| Sigla do UF do cartório
| SP, RJ
| text
|
|
|-
| marriage_certificate_agency
| Nome do órgão usado para emitir a Certidão de casamento.
| 12º Cartório
| text
|
|
|-
| identity
| Identidade, caso estrangeiro
|
| text
|
|
|-
| commercial_name
| Nome da empresa de trabalho
|
| text
|
|
|-
| passport
| passaporte
|
| text
|
|
|-
| academic_title
| Tituação do professor (caso a pessoa seja um professor)
|
| text
|
|
|-
| student_code_inep
| Código do aluno no INEP
|
| text
|
|
|-
|}

==== Filiação ====

Dados dos pais, mães e responsáveis dos alunos.

Nome do Arquivo: AlunoFil.csv

Filtro: Todos os alunos existentes

Obrigatório: Sim

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_person
| Código da pessoa
| 1
| integer
| sim
| '''Pessoa'''
|-
| id_student
| Código do aluno
| 1
| integer
| sim
| '''Pessoa'''
|-
| relationship
| Grau de parentesco ou relacionamento que a pessoa tem com o aluno
| Um desses valores: pai, mãe, avô, avó, adotador, responsável legal, tutor, outros
| text
| sim
|
|-
| is_financial_responsible
| Indicar se essa pessoa é responsável financeiro do aluno
| true/false
| boolean
| sim
|
|}

==== Responsável financeiro X Aluno ====

Informações da relação entre responsáveis financeiros e alunos.

Nome do Arquivo: ResposavelFinanceiroAluno.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| financial_responsible_person_document
| Número do CPF do responsável
| Somente Números Ex: 71457756110
| text
| Sim
|
|-
| id_student
| Identificador do tomador do serviço tipo aluno
| Deve existir no arquivo de migração de alunos
| integer
| Sim
| '''Pessoa'''
|}

=== Dados de Ofertas ===

==== Matrícula ====

Informações referentes a matrícula do aluno.

Nome do Arquivo: Matricula.csv

Filtro: Todas as matrículas existentes no sistema do calendário acadêmico atual (ex: se estamos em 2018, exportar somente as matrículas de 2018, ignorando as de 2017 e anteriores)

Obrigatório: Não

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_student
| Código único que identifica o aluno.
| 120
| integer
| sim
| '''Pessoa'''
|-
| id_enrollment
| Código único que identifica a matrícula do aluno
| 123
| integer
| sim
|
|-
| code
| Número de matricula do aluno usado no sistema legado. Somente inserir esta informação caso seja necessário cadastrar o mesmo número de matrícula.
| 1813023354, 2015010149, etc
| integer
| Não
|
|-
| academic_responsible_person_cpf
| CPF do responsável acadêmico
| 64383818021, 12578880050, etc
| text
| sim
|
|-
| financial_responsible_person_document
| CPF/CNPJ do responsável financeiro
| 64383818021, 12578880050, etc
| text
| Sim
|
|-
| academic_calendar
| Nome do calendário acadêmico cadastrado no sistema
| 20181, 2018A, 2018, Pós_2018, Graduação 2019
| text
| sim
|
|-
| course
| Nome do Curso
| Ensino Fundamental
| text
| sim
|
|-
| curriculum
| Nome do Currículo
| Grade 1, ENF2010
| text
|
|
|-
| module
| Nome da série
| 1 série, 2 série, etc
| text
| sim
|
|-
| class
| Nome da turma
| A, B, etc
| text
| sim
|
|-
| status
| Situação que a matrícula deve ser apresentada no sistema
| Aberto<br>Reservado<br>Ativo (Usada principalmente para fazer promoção de alunos, não inclui as disciplinas)
| text
| sim
|
|-
| campaign
| Nome da campanha criada no sistema Acadêmico para ser possível fazer o vínculo caso necessário
| Matrículas 2019, Matrículas, etc
| text
| Não
|
|-
| date_enrollment
| Data de criação da matrícula
| 31/01/2018
| date
| Não
|
|-
| start_date
| Data de ingresso da matrícula
| 31/01/2018, 01/01/2019, 01/2019, 02/2020
| text
| Não
|
|}

==== Matrícula x Disciplina ====

Informações referentes às disciplinas da matrícula do aluno.

Nome do Arquivo: MatriculaDisciplina.csv

Filtro: Todas as disciplinas das matrículas existentes no sistema

Obrigatório: Não

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_enrollment
| Código único que identifica a matrícula do aluno
| 123
| integer
| sim
| '''Matrícula'''
|-
| academic_calendar
| Nome do calendário acadêmico cadastrado no sistema
| 20181, 2018A, 2018, Pós_2019, Graduação 2019
| text
| sim
|
|-
| course
| Nome do curso
| Ensino Fundamental
| text
| sim
|
|-
| curriculum
| Nome do Currículo
| Grade 1, ENF2010
| text
|
|
|-
| module
| Nome do módulo
| 2ª Série, 8ª Série, etc.
| text
| sim
|
|-
| subject
| Nome da disciplina
| Português, Física, etc
| text
| sim
|
|-
| class
| Nome da turma
| Turma A, B, etc
| text
| sim
|
|-
| type
| Tipo de disciplina
| Regular ou Dependência
| text
|
|
|}

==== Histórico Escolar ====

Informações do histórico escolar dos alunos.

Nome do Arquivo: Historico.csv

Filtro: Todos os históricos dos alunos matriculados

Obrigatório: Não

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_enrollment_record
| Identificador chave (único) do registro acadêmico
| 1
| integer
| Sim
|
|-
| id_student
| Identificador do aluno
| 1
| integer
| Sim
| '''Pessoa'''
|-
| institution_name
| Nome do colégio
| Escola Planeta, Curso Aprimorar, etc.
| text
| sim
|
|-
| index
| Ordem cronológica. Importante para relacionar os registros no sistema
| 1, 2, 3, 4, etc
| integer
|
|
|-
| institution_city
| Nome da cidade onde está localizado o colégio
| São Paulo, Curitiba, etc.
| text
|
|
|-
| institution_state
| UF onde está localizado o colégio
| SP, SC, PR, etc.
| char(2)
|
|
|-
| course
| Nome do curso
| Ensino Fundamental, Ensino Infantil.
| text
| Sim
|
|-
| module
| Nome da série/ano
| 2ª Série, 8º Ano, etc.
| text
| Sim
|
|-
| academic_calendar
| Calendário acadêmico
| 2003, 20031, 20032, 2004, 20041, 20042
| text
| Sim
|
|-
| status
| Resultado que o aluno obteve na série
| Aprovado, Reprovado, Cursando, Cancelado
| text
| Sim
|
|-
| complementary_status
| Resultado que o aluno obteve na série que não seja o resultado padrão do campo status * se este campo for preenchido deixar status como OUTROS
| Reprovado por recuperação, etc
| text
|
|
|-
| attendance
| Frequência que o aluno obteve na série
| 2, 3, 8, 0, etc. (percentual)
| text
|
|
|-
| workload
| Carga horária
| 40, 50, 45, 25, etc.
| text
|
|
|-
| law
| Lei que regulamentou o curso
| 12345
| text
|
|
|-
| instructional_days
| Quantidade de dias letivos
| 198
| text
|
|
|-
| obs
| Observações do histórico
| Aluno transferido, etc
| text
|
|
|-
| finish_date
| Data de conclusão
| 01/01/2019
| date
|
|
|-
| curriculum_name
| Nome do currículo
| grade 1, 2019-curriculo
| text
|
|
|-
| id_course_level
| Nível do Curso
| 1 (Educação Básica), 2 (Educação Superior)
| integer
|
|
|-
| id_course_type
| Tipo do Curso
| 1 (Educação Infantil), 2 (Ensino Fundamental de 8 anos), 3 (Ensino Fundamental de 9 anos), 4 (Multi 8 e 9 anos e Multietapa), 5 (Ensino Médio), 6 (Educação Profissional Técnica de Nível Médio - Integrada), 7 (Ensino Médio - Normal/ Magistério), 8 (Educação Profissional Técnica de Nível Médio), 9 (EJA - Ensino Fundamental), 10 (EJA - Médio), 11 (Formação Continuada ou Qualificação Profissional (FIC)), 12 (Cursos Sequenciais), 13 (Graduação), 14 (Pós Graduação), 15 (Extensão)
| integer
|
|
|-
| mec_course_code
| Código do MEC
| 1111,2222
| integer
|
|
|-
| coordinator
| Nome do Coordenador
| Paulo Silva
| text
|
|
|-
| coordinator_grade
| Titulação do Coordenador
| Licenciatura
| text
|
|
|-
| recognition
| Reconhecimento
|
| text
|
|
|-
| secretary
| Nome do secretário(a)
| João Silva
| text
|
|
|-
| secretary_subscription
| Incrição da secretário(a)
| 1111111111
| text
|
|
|-
| modality
| Modalidade
| Semipresencial, Presencial, A distância
| text
|
|
|-
| authorization
| Autorização
|
| text
|
|
|-
| course_name_equivalence
| Nome do curso equivalente ao curso existente do sistema
| Ensino fundamental, ...
| text
|
|
|-
| curriculum_name_equivalence
| Nome do currículo equivalente ao currículo existente do sistema
| EF1, Ensino Fundamental 1 ...
| text
|
|
|-
| start_date
| Data de Ingresso
| 31/01/2018, 01/01/2019, 01/2019, 02/2020
| text
|
|
|-
| certification_dispatch_date
| Data de expedição do diploma
| 31/01/2018, 01/01/2019, 01/2019, 02/2020
| text
|
|
|-
| graduation_date
| Data de colação de grau
| 31/01/2018, 01/01/2019, 01/2019, 02/2020
| text
|
|
|}

==== Histórico x Disciplina ====

Informações das notas e frequências obtidas pelos alunos nas disciplinas, referentes aos históricos escolares.

Nome do Arquivo: HistoricoDisciplina.csv

Filtro: Todas as disciplinas dos históricos dos alunos matriculados

Obrigatório: Não

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_enrollment_subject_record
| Identificador chave (único) do registro de disciplina
| 1
| integer
| sim
|
|-
| id_enrollment_record
| Identificador do histórico escolar
| 1
| integer
| sim
| '''Histórico Escolar'''
|-
| subject
| Nome da disciplina
| Português, Química, Língua Estrangeira, etc.
| text
| sim
|
|-
| academic_calendar
| Descrição do ano referência
| 2010, 20101, etx
| text
|
|
|-
| subject_group
| Nome da disciplina agrupada
| Língua Estrangeira
| text
|
|
|-
| subject_type
| Tipo de disciplina
| Regular, Dependência
| text
|
|
|-
| national_curriculum
| É a Base de conhecimento de cada disciplina definida pelo MEC.
| Informe '''Comum''' quando a disciplina pertencer a grade curricular, e informe “'''Diversificada'''” quando não pertencer a grade curricular, mas é para enriquecimento do currículo.
| text
| Sim
|
|-
| subject_area
| Área de conhecimento da disciplina
| Ciências da natureza, etc
| text
|
|
|-
| average_grade
| Média obtida pelo aluno na disciplina
| 8.6, 9.0, 7.2, etc.
| text
|
|
|-
| attendance
| Frequência que o aluno obteve na disciplina
| 2, 3, 8, 0, etc. (percentual)
| text
|
|
|-
| workload
| Carga horária da disciplina
| 45, 55, 48, etc.
| text
|
|
|-
| waiver
| Tipo de dispensa que o aluno teve para não cumprir a disciplina
| Médica, Já cursou, etc.
| text
|
|
|-
| achievement_test_grade
| Valor da prova de aproveitamento
| 6.5, 7.3, 8.3, etc.
| text
|
|
|-
| status
| Resultado que o aluno obteve na disciplina
| Aprovado, Reprovado, etc.
| text
| sim
|
|-
| complementary_status
| Outro status da disciplina * se este campo for preenchido deixar status como OUTROS
| Ativo, Cancelado ou Dispensado
| text
|
|
|-
| letter_grade
| Nota conceito
| A, B, C, D, E, F...
| text
|
|
|-
| cancellation_reason
| Motivo de cancelamento
| problemas de saúde, financeiro
| text
|
|
|-
| obs
| Observações de histórico disciplina
| Disciplina transferida
| text
|
|
|-
| dismissed
| Dispensado
| true / false
| boolean
|
|
|-
| dismissal_reason
| Motivo da dispensa
| Doença, etc
| text
|
|
|-
| course_name_equivalence
| Nome do curso equivalente ao curso existente no sistema
| Ensino fundamental, ...
| text
|
|
|-
| curriculum_name_equivalence
| Nome do currículo equivalente ao currículo existente no sistema
| EF1, Ensino fundamental 1, ...
| text
|
|
|-
| module_name_equivalence
| Nome do módulo equivalente ao módulo existente no sistema
| 1 Ano, Módulo 1, ...
| text
|
|
|-
| subject_name_equivalence
| Nome da disciplina equivalente a disciplina existente no sistema
| Artes, Português, ...
| text
|
|
|}

==== Histórico x Disciplina x Professor ====

Informações dos professores referentes às disciplinas no histórico escolar.

Nome do Arquivo: HistoricoDisciplinaProfessor.csv

Filtro: Todas os professores de uma disciplina no histórico acadêmico

Obrigatório: Não

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_enrollment_subject_record_professor
| Identificador chave (único) do registro de professor
| 1
| integer
| sim
|
|-
| id_enrollment_subject_record
| Identificador do registro de disciplina do histórico
| 1
| integer
| sim
| '''Histórico x Disciplina'''
|-
| professor_name
| Nome do professor
| João Paulo
| text
|
|
|-
| academic_title
| Titulação do professor
| Graduação em Engenharia de Software
| text
|
|
|}

==== Histórico x Atividade Complementar ====

Informações das atividades complementares dos alunos referentes aos históricos escolares.

Nome do Arquivo: HistoricoAtividadeComplementar.csv

Obrigatório: Não

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_enrollment_complementary_activity_record
| Identificador chave (único) da atividade complementar do histórico
| 1
| integer
| sim
|
|-
| id_enrollment_record
| Identificador do histórico escolar
| 1
| integer
| sim
| '''Histórico Escolar'''
|-
| category
| A descrição da categoria
| Atividade Complementar 1
| text
| Sim
|
|-
| name
| Nome da categoria
| Atividade livre, etc
| text
| Sim
|
|-
| description
| Descrição da categoria
| Atividade livre sobre fisioterapia
| text
|
|
|-
| start_date
| Data de início
| 11/12/2019
| text
|
|
|-
| end_date
| Data final
| 12/12/2019
| text
|
|
|-
| workload
| Carga horária
| 10, 40, 100, etc
| integer
|
|
|}

==== Matrícula x Documento ====
Informações dos documentos entregues referentes à matrícula do aluno.

Nome do Arquivo: MatriculaDocumento.csv

Filtro: Todos os documentos marcados como entregue das matrículas existentes no sistema

Obrigatório: Não

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_enrollment
| Código que identifica a matrícula do aluno
| 123
| integer
| sim
| '''Matrícula'''
|-
| document_name
| Nome do documento entregue pelo aluno ou responsável
| RG, CPF, comprovante de residência, etc
| text
| sim
|
|}

==== Nota ====

Informações referentes às notas dos alunos.

Nome do Arquivo: Nota.csv

Filtro: Todos as notas dos alunos matriculados

Obrigatório: Não

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_student
| Identificador do aluno
| Deve existir no arquivo de migração de alunos
| integer
| Sim
| '''Pessoa'''
|-
| course
| Nome do curso
| Ensino Fundamental
| text
| sim
|
|-
| module
| Nome do módulo
| 2ª Série, 8ª Série, etc.
| text
| sim
|
|-
| class
| Nome da turma
| Turma A, B, etc
| text
| sim
|
|-
| student_name
| Nome do aluno
| João Souza
| text
| não
|
|-
| period
| Nome do período ao qual pertence a nota
| 1ª Bimestre, 2º Fase, Recuperação (se for média deixar como anual, semestral, trimestral, etc)
| text
| sim
|
|-
| exam
| Nome do exame ao qual pertence a prova
| Prova de Recuperação, Nota 1, Trabalho (se for média deixar como '''media''')
| text
| sim
|
|-
| academic_calendar
| Nome do Calendário acadêmico
| 2018, 20181, 2018-2019
| text
| sim
|
|-
| subject
| Nome da disciplina
| Português, Matemática
| text
| sim
|
|-
| type
| Tipo da nota
| 1 - normal, 2 - recuperação, 3 - média
| integer
| sim
|
|-
| grade
| O valor da nota
| 9.5, 10, 2.5
| numeric
| sim
|
|-
|}

==== Parecer Descritivo ====

Informações referentes aos pareceres descritivos dos alunos.

Nome do Arquivo: ParecerDescritivo.csv

Filtro: Todos os pareceres descritivos dos alunos matriculados

Obrigatório: Não

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_student
| Identificador do aluno
| Deve existir no arquivo de migração de alunos
| integer
| Sim
| '''Pessoa'''
|-
| course
| Nome do curso
| Ensino Fundamental
| text
| sim
|
|-
| module
| Nome do módulo
| 2ª Série, 8ª Série, etc.
| text
| sim
|
|-
| class
| Nome da turma
| Turma A, B, etc
| text
| sim
|
|-
| period
| Nome do período ao qual pertence a nota
| 1ª Bimestre, 2º Fase, Recuperação (se for média deixar como anual, semestral, trimestral, etc)
| text
| sim
|
|-
| academic_calendar
| Nome do Calendário acadêmico
| 2018, 20181, 2018-2019
| text
| sim
|
|-
| subject
| Nome da disciplina
| Português, Matemática
| text
| sim
|
|-
| assessment
| A descrição do parecer descritivo do aluno
| O aluno foi muito bem nas atividades<br>Muito bom aluno
| text
| sim
|
|-
|}

=== Dados de Financeiro ===

==== Item ====

Informações referentes ao produto ou serviço que esta sendo comprado.

Nome do Arquivo: Item.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_item
| ID ou código interno do item no sistema
| 123,1456,178
| integer
| Sim
|
|-
| description
| Descrição do item (título, nome)
| Mensalidade, Atividade
| text
| Sim
|
|-
| type
| Tipo de item
| service, product
| text
| Sim
|
|-
| period
| Período do Item
| 1,.., 12 (Obrigatório informar se for do tipo serviço)
| integer
|
|
|-
| price
| Preço do item
| 215.55, 200
| numeric
| sim
|
|-
| status
| Situação do item
| active, inactive
| text
| Sim
|
|-
| cost_center
| Informação de centro de custo
| 123456, A12456
| text
|
|
|-
| category
| Descrição da categoria
| Mensalidade, ... (Cria uma categoria nova caso não exista)
| text
| Sim
|
|}

==== Tipo Desconto ====

Informações dos tipos de descontos.

Nome do Arquivo: TipoDesconto.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_type_discount
| ID ou código interno do tipo de desconto no sistema
| 123,1456,178
| integer
| Sim
|
|-
| category
| Descrição da categoria
| Pontualidade, Bolsa integral, ...
| text
| Sim
|
|-
| description
| Descrição do desconto
| Bolsa 50%, Integral, ...
| text
| Sim
|
|-
| type
| O tipo de desconto
| conditional ou unconditional
| text
| Sim
|
|-
| condition
| Regra de aplicação do desconto (Deve ser informado somente se tipo for condicional)
| days_before_due_date, until_due_date ou number_of_installments
| text
|
|
|-
| value
| Valor referente a condição selecionada (Se condition for informado é necessário informar este valor)
| 4 (número de vezes), 3 (dias antes da data de vencimento), 5 (até o quinto dia), ...,
| integer
|
|
|-
| method
| Método do desconto (se o método indicado for manual, o valor deverá ser passado no layout de desconto)
| absolute, relative ou manual
| text
| Sim
|
|-
| percentage
| Valor relativo do desconto (Ele valor só será informado caso o método indicado seja relative)
| absolute, relative ou manual
| numeric
|
|
|-
| amount
| Valor absoluto do desconto (Ele valor só será informado caso o método indicado seja absolute)
| absolute, relative ou manual
| numeric
|
|
|-
| calculation_base
| Regra de cálculo do desconto
| gross ou net
| text
|
|
|}

==== Contrato ====

Informações referentes ao contrato.

Nome do Arquivo: Contrato.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_contract
| ID ou código interno do contrato no sistema
| 123,1456,178
| integer
| Sim
|
|-
| financial_responsible_person_document
| Número do CPF ou CNPJ do responsável financeiro
| 49530612095, 62927132000110 (somente números)
| text
| Sim
|
|-
| id_enrollment
| ID ou código interno da matrícula
| 1123,123456,78945
| integer
|
| '''Matrícula'''
|-
| status
| Identificador da situação do contrato
| Ativo ou Encerrado
| text
| Sim
|
|-
| due_date
| Data de vencimento
| DD/MM/YYYY (01/02/2020)
| Date
| sim
|
|-
| details
| Informações de detalhes do contrato
|
| text
|
|
|-
| observation
| Observações sobre o contrato
| Criado via importação
| text
|
|
|}

===== Compra =====

Informações de compras.

Nome do Arquivo: Compra.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_contract
| ID ou código interno do contrato no sistema
| 123,1456,178
| integer
| Sim
| '''Contrato'''
|-
| id_purchase
| ID ou código interno da compra no sistema
| 123,1456,178
| integer
| Sim
|
|-
| id_person
| ID ou código interno da pessoa (Aluno)
| 1123,123456,78945
| integer
| Sim
| '''Pessoa'''
|-
| id_item
| ID ou código interno do item
| 1123,123456,78945
| integer
| Sim
| '''Item'''
|-
| installments
| Número de prestações
| 1,2,3,...,12
| integer
| Sim
|
|-
| quantity
| Quantidade
| 1,2,3,...,6
| integer
| Sim
|
|-
| unit_price
| Valor da compra por unidade
| 15, 15.50
| numeric
| Sim
|
|-
| date_start
| Data inicial de compra
| DD/MM/YYYY
| date
| Sim
|
|-
| date_end
| Data final de compra
| DD/MM/YYYY
| date
| Sim
|
|}

===== Fundo =====

Informações de fundo.

Nome do Arquivo: Fundo.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_contract
| ID ou código interno do contrato no sistema
| 123,1456,178
| integer
| Sim
| '''Contrato'''
|-
| id_fund
| ID ou código interno do fundo no sistema
| 123,1456,178
| integer
| Sim
|
|-
| id_person
| ID ou código interno da pessoa (Aluno)
| 1123,123456,78945
| integer
| Sim
| '''Pessoa'''
|-
| description
| Descrição do fundo
| 1123,123456,78945
| text
| Sim
|
|-
| installments
| Número de prestações
| 1,2,3,...,12
| integer
| Sim
|
|-
| amount
| Valor do fundo
| 500, 500.55
| numeric
| Sim
|
|-
| date
| Data inicial de compra
| DD/MM/YYYY
| date
| Sim
|
|}

===== Financiamento =====

Informações de financiamento.

Nome do Arquivo: Financiamento.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_loan
| ID ou código interno do financiamento no sistema
| 123,1456,178
| integer
| Sim
|
|-
| id_purchase
| ID ou código interno da compra no sistema
| 123,1456,178
| integer
| Sim
| '''Compra'''
|-
| id_fund
| ID ou código interno do fundo no sistema
| 1123,123456,78945
| integer
| Sim
| '''Fundo'''
|-
| amount
| Valor do financiamento
| 500, 500.55
| numeric
| Sim
|
|-
| date
| Data do financiamento
| DD/MM/YYYY
| date
| Sim
|
|}

===== Renegociação =====

Informações de renegociação.

Nome do Arquivo: Renegociacao.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_renegotiation
| ID ou código interno da renegociação no sistema
| 123,1456,178
| integer
| Sim
|
|-
| id_contract
| ID ou código interno do contrato no sistema
| 123,1456,178
| integer
| Sim
| '''Contrato'''
|-
| installments
| Número de prestações que serão geradas
| 1,2,3 ...
| integer
| Sim
|
|}

===== Fatura =====

Informações das faturas.

Nome do Arquivo: Fatura.csv

'''OBS:''' A fatura é sempre vínculo de uma compra, fundo ou renegociação.

Deve ser informado '''apenas um''' dos três campos ('''id_purchase, id_fund, id_renegotiation''')

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_purchase
| ID ou código interno da compra no sistema
| 123,1456,178
| integer
|
| '''Compra'''
|-
| id_fund
| ID ou código interno do fundo no sistema
| 123,1456,178
| integer
|
| '''Fundo'''
|-
| id_renegotiation
| ID ou código interno da renegociação no sistema
| 1123,123456,78945
| integer
|
| '''Renegociação'''
|-
| id_invoice
| ID ou código interno da fatura
| 1123,123456,78945
| integer
| Sim
|
|-
| month_cycle
| Mês de competência
| 1,2,3,...,12
| integer
| Sim
|
|-
| year_cycle
| Ano de competência
| 2018, 2019, 2020
| integer
| Sim
|
|-
| due_date
| Data de vencimento
| DD/MM/YYYY
| date
| Sim
|
|-
| amount
| Valor total da fatura
| 150, 150.55
| numeric
| Sim
|
|}

====== Pagamento ======

Informações dos pagamentos.

Nome do Arquivo: Pagamento.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_payment
| ID ou código interno do pagamento no sistema
| 123,1456,178
| integer
| Sim
|
|-
| id_invoice
| ID ou código interno da fatura
| 1123,123456,78945
| integer
| Sim
| '''Fatura'''
|-
| id_person
| ID ou código interno da pessoa (Aluno)
| 1123,123456,78945
| integer
| Sim
| '''Pessoa'''
|-
| payment_method
| Método de pagamento
| debitCard, pagseguro, creditCard, check, boleto, cash, bankTransfer
| text
| Sim
|
|-
| type
| Tipo de pagamento
| in, out
| text
| Sim
|
|-
| status
| Situação final do pagamento
| pending, refused, paid, cancelled
| text
| Sim
|
|-
| amount
| Valor total da fatura
| 150, 150.55
| numeric
| Sim
|
|-
| payment_date
| Data de pagamento
| DD/MM/YYYY
| date
| Sim
|
|}

====== Desconto ======

Informações dos descontos.

Nome do Arquivo: Desconto.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_discount
| ID ou código interno do desconto no sistema
| 123,1456,178
| integer
| Sim
|
|-
| id_invoice
| ID ou código interno da fatura
| 1123,123456,78945
| integer
| Sim
| '''Fatura'''
|-
| id_type_discount
| ID ou código interno do desconto
| 1123,123456,78945
| integer
| Sim
| '''Tipo Desconto'''
|-
| type
| Tipo de desconto
| invoice
| text
| Sim
|
|-
| event
| Tipo de evento do desconto
| purchase
| text
| Sim
|
|-
| base
| Tipo de valor considerado no cálculo do desconto
| gross
| text
| Sim
|
|-
| amount
| Valor do desconto (Este valor só é informado quando o tipo de desconto é manual)
| 150, 150.55
| numeric
| Sim
|
|}

====== Multa ======

Informações das multas.

Nome do Arquivo: Multa.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_penalty
| ID ou código interno da multa no sistema
| 123,1456,178
| integer
| Sim
|
|-
| id_invoice
| ID ou código interno da fatura
| 1123,123456,78945
| integer
| Sim
| '''Fatura'''
|-
| amount
| O valor da multa que será aplicado na fatura
| 155, 200.55
| numeric
| Sim
|
|-
| percentage
| Regra de porcentagem aplicado no valor da multa (Não será aplicado, apenas informal)
| 10, 80
| numeric
| Sim
|
|-
| base_amount
| Regra do valor base aplicado no valor da multa (Não será aplicado, apenas informal)
| 10, 55.54
| numeric
| Sim
|
|}

====== Juros ======

Informações dos juros.

Nome do Arquivo: Juros.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_interest
| ID ou código interno do juro no sistema
| 123,1456,178
| integer
| Sim
|
|-
| id_invoice
| ID ou código interno da fatura
| 1123,123456,78945
| integer
| Sim
| '''Fatura'''
|-
| amount
| O valor do juro que será aplicado na fatura
| 155, 200.55
| numeric
| Sim
|
|-
| percentage
| Regra de porcentagem aplicado no valor do juro (Não será aplicado, apenas informal)
| 10, 80
| numeric
| Sim
|
|-
| base_amount
| Regra do valor base aplicado no valor do juro (Não será aplicado, apenas informal)
| 10, 55.54
| numeric
| Sim
|
|-
| days
| Regra de dias de vencimento aplicado no valor do juro (Não será aplicado, apenas informal)
| 10, 55.54
| numeric
| Sim
|
|}

====== Cancelamento ======

Informações dos cancelamentos.

Nome do Arquivo: Cancelamento.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_cancellation
| ID ou código interno do cancelamento no sistema
| 123,1456,178
| integer
| Sim
|
|-
| id_invoice
| ID ou código interno da fatura
| 1123,123456,78945
| integer
| Sim
| '''Fatura'''
|-
| type
| Tipo de desconto
| invoice
| text
| Sim
|
|-
| event
| Tipo de evento do cancelamento
| purchase
| text
| Sim
|
|-
| reason
| Descrição do motivo do cancelamento
| Cancelamento de matrícula, Erro no pagamento, ...
| text
| Sim
|
|-
| amount
| Valor do cancelamento
| 150, 150.55
| numeric
| Sim
|
|}

===== Faturas Renegociadas =====

Informações das faturas renegociadas.

Nome do Arquivo: FaturasAtrasadasRenegociadas.csv

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_invoice_renegotiation
| ID ou código interno
| 123,1456,178
| integer
| Sim
|
|-
| id_renegotiation
| ID ou código interno da renegociação no sistema
| 1123,123456,78945
| integer
| Sim
| '''Renegociação'''
|-
| id_delayed_invoice
| ID ou código interno da fatura
| 1123,123456,78945
| integer
| Sim
| '''Fatura'''
|}

=== Dados de Biblioteca ===

Diferentemente das demais, a importação de dados de biblioteca não é realizada via importador, mas sim, diretamente no módulo de biblioteca.

Existem dois processos distintos: Um para adicionar obras ao catálogo, e outro para adicionar cópias/exemplares às bibliotecas.

==== Catálogo ====

Para importar obras para o catálogo, acesse o módulo Biblioteca. Em seguida navegue para Configurações > Catálogos > Selecione o catálogo > Importações (botão superior direito).

Crie uma nova importação do tipo CSV. A seguir informe os 4 arquivos necessários:

* Obras
* Obras x Autor
* Obras x Assunto (opcional)
* Obras x Palavras-Chave (opcional)

===== Obras =====

Este arquivo contém informações das obras (livros, e outros materiais) a serem lançadas no acervo.

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_obra
| ID ou código interno da obra no sistema
| 123,1456,178
| integer
| Sim
|
|-
| titulo
| Título da Obra
| Memórias Póstumas de Brás Cubas
| text
| Sim
|
|-
| subtitulo
| Subtítulo da Obra
|
| text
| Não
|
|-
| tipo_acervo
| Tipo de Obra
| Livro, Guias, TCC, Mapa
| text
| Sim
|
|-
| classificacao_decimal
| Classificação Decimal
| 342.4
| text
| Não
|
|-
| tipo_suporte
| Tipo de Suporte/Material
| Papel
| text
| Não
|
|-
| colecao
| Nome da coleção a que esta obra pertence
| Coleção Vagalume
| text
| Não
|
|-
| genero
| Gênero da Obra
| Gastronomia
| text
| Não
|
|-
| qt_paginas
| Quantidade de páginas
| 190
| integer
| Não
|
|-
| isbn
| ISBN
| 8525413240
| text
| Não
|
|-
| nr_volume
| Número do Volume/Designação sequencial
| 3, Volume 1,
| text
| Não
|
|-
| cutter
| Número Cutter
| L783a
| text
| Não
|
|-
| periodicidade
| Periodicidade atual da publicação (jornais, revistas, periódicos)
| Mensal
| text
| Não
|
|-
| data_veiculacao
| Data da veiculação da publicação (jornais, revistas, periódicos)
| 31/01/2020
| text
| Não
|
|-
| issn
| ISSN
| 1039989
| text
| Não
|
|-
| ano_volume
| Ano/Volume da publicação
| 2012, Volume 2
| text
| Não
|
|-
| fasciculo
| Fascículo
| 3
| text
| Não
|
|-
| tradutor
| Nome do tradutor
| Marcos Oliveira
| text
| Não
|
|-
| titulo_original
| Título da obra no idioma original
| The Hitchhiker's Guide to the Galaxy
| text
| Não
|
|-
| idioma_original
| Idioma original da obra
| Inglês
| text
| Não
|
|-
| obs_geral
| Observações gerais
|
| text
| Não
|
|-
| obs_especifica
| Observações específicas
|
| text
| Não
|
|-
| obs_resumida
| Observação resumida
|
| text
| Não
|
|-
| ano_publicacao
| Ano de publicação
|
| text
| Não
|
|-
| nr_edicao
| Número da edição
| 3
| text
| Não
|
|-
| cidade_publicacao
| Local de publicação
| Brasília-DF, Berlim, São Paulo-SP
| text
| Não
|
|-
| editora
| Nome da Editora
| Editora Sextante
| text
| Não
|
|}

===== Obra x Autores =====

Este arquivo contém informações de Autor e uma referência ao arquivo de Obras.

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_obra
| ID ou código interno da obra no sistema
| 123,1456,178
| integer
| Sim
| Obra
|-
| tipo_autor
| Tipo de Autor (Principal ou Secundário)
| Principal, Secundário
| text
| Sim
|
|-
| nome
| Nome do autor
| Machado
| text
| Sim
|
|-
| sobrenome
| Sobrenome do autor (opcionalmente pode-se deixar este campo em branco e informar o nome completo na coluna "nome")
| De Assis
| text
| Não
|
|-
| cutter
| Número de Cutter
| L783a
| text
| Não
|
|}

===== Obra x Assuntos =====

Este arquivo relaciona uma obra a diversos assuntos. No processo de importação, este arquivo é opcional e pode ser omitido.

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_obra
| ID ou código interno da obra no sistema
| 123,1456,178
| integer
| Sim
| Obra
|-
| assunto
| Assunto da Obra
| Gastronomia, Economia, Política, Ciência
| text
| Sim
|
|}

===== Obra x Palavras-Chave =====

Este arquivo relaciona uma obra a diversas palavras-chave. No processo de importação, este arquivo é opcional e pode ser omitido.

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_obra
| ID ou código interno da obra no sistema
| 123,1456,178
| integer
| Sim
| Obra
|-
| palavra_chave
| Palavra-Chave da Obra
| Turismo, Hotéis, Praias
| text
| Sim
|
|}

==== Cópias/Exemplares ====

Para importar cópias para a biblioteca, acesse o módulo Biblioteca. Em seguida navegue para Configurações > Bibliotecas > Selecione a biblioteca > Importações de Cópias (botão superior direito).

Crie uma nova importação do tipo CSV. A seguir faça upload de um arquivo no formato a seguir.

===== Cópias =====

{| class="wikitable sortable" style="width: 100%"
|-
! '''Coluna'''
! '''Descrição'''
! '''Exemplo'''
! '''Tamanho e Formato'''
! '''Obrigatório'''
! '''Referência'''
|-
| id_obra
| ID ou código interno da obra no sistema
| 123,1456,178
| integer
| Sim
| Obra
|-
| id_copia
| ID ou código interno da cópia/exemplar no sistema. Este campo é opcional, porém recomendado. Se informado o importador checará por duplicidade nas importações evitará lançamentos duplicados de exemplares.
| 123, 1456, ABC1
| text
| Não
|
|-
| nr_exemplar
| Número identificador do exemplar
| 1, 2, 125, Exemplar 1, EX2, etc
| text
| Sim
|
|-
| nr_tombo
| Número do tombo patrimonial
| 1, 2, 125, Tombo45673, TM2123, etc
| text
| Não
|
|-
| sequencial_exemplar
| Número sequencial do exemplar
|
| text
| Não
|
|-
| parte
| Parte do exemplar
|
| text
| Não
|
|-
| tipo_aquisicao
| Tipo de Aquisição
| Compra, doação
| text
| Não
|
|-
| valor_aquisicao
| Valor da Aquisição
| R$ 50, 123, 80.12 BRL
| text
| Não
|
|-
| andar
| Andar
| 1
| text
| Não
|
|-
| corredor
| Corredor
| 1
| text
| Não
|
|-
| estante
| Estante
| 1
| text
| Não
|
|-
| prateleira
| Prateleira
| 1
| text
| Não
|
|-
| observacao
| Observação
|
| text
| Não
|
|}

Gennera Wiki - Contribuições do usuário [pt-br]

Processo Migração de Dados