Escolar Documentos
Profissional Documentos
Cultura Documentos
Versão: 1.4
19/10/2016
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
Sumário
Conteúdo
Introdução ............................................................................................................................................... 3
Formatos e Padrões Utilizados................................................................................................................ 3
Tipos Complexos...................................................................................................................................... 4
Tabelas de Elementos.............................................................................................................................. 5
Tipos Simples ........................................................................................................................................... 9
Importação de alunos........................................................................................................................ 15
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
2
Introdução
Este manual tem como objetivo apresentar as especificações e critérios técnicos para
configuração da importação de arquivos em formato XML referente ao Módulo Educação do sistema
GINFES – NFS-e.
Contem nesse documento exemplos de arquivos válidos para importação dos cursos e aluno
referente ao módulo.
FORMATO OBSERVAÇÃO
Formato: dd/mm/yyyy
dd = dia com 2 caracteres
Data (date)
mm = mês com 2 caracteres
yyyy = ano com 4 caracteres
Formato: 0.00
Não deve ser utilizado separador de milhar. O ponto (.) deve ser
utilizado para separar a parte inteira da fracionária.
Valores Decimais (Decimal)
Exemplo: 48.562,22 = 48562.22
1,00 = 1.00
0,50 = 0.50 ou 0.5
Tabela 1: Formatos e Padrões Utilizados
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
3
Tipos Complexos
Segue abaixo todos os elementos que compõe o XML para o envio dos arquivos referentes aos
Cursos e Alunos.
(1)
(2)
Nome Tipo Ocorrência Descrição Tamanho Observação
(3) (4) (5) (6) (7) (8)
Tabela 2: Tipos Complexos
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
4
Tabelas de Elementos
Endereco
Dados do endereço
Nome Tipo Ocorrência Descrição Tamanho Observação
Cep String 1-1 CEP 8 Somente dígitos
numero String 1-1 Número 15
logradouro String 1-1 Logradouro 100
bairro String 1-1 Bairro 60
Uf Integer 1-1 UF
municipio Integer 1-1 Município
complemento String 1-1 Complemento 60
Tabela 3: Dados do endereço
IdentificacaoResponsavel
Dados do responsável
Nome Tipo Ocorrência Descrição Tamanho Observação
numeroIdentificacao String 1-1 CPF ou CNPJ 1-14
tipoIdentificacao String 1-1 Tipo de documento utilizado 1
Nome String 1-1 Nome 150
dataNascimento String 0-1 Data no formato dd/mm/yyyy 10
Tabela 4: Dados do responsável
IdentificacaoAluno
Dados de identificação do aluno
Nome Tipo Ocorrência Descrição Tamanho Observação
numeroIdentificacao String 1-1 CPF ou CNPJ 14
tipoIdentificacao String 1-1 Tipo de documento utilizado 1
Nome String 1-1 Nome 150
Matricula String 1-1 Número da matricula 14
dataNascimento String 0-1 Data no formato dd/mm/yyyy 10
Tabela 5: Dados de identificação do aluno
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
5
Contato
Dados de contato
Nome Tipo Ocorrência Descrição Tamanho Observação
email String 1-1 Email 100
Formado: DDD + Telefone
Celular com 9 dígito = 11123456789
Celular com 8 Dígitos = 1112345678 8-11
Telefone Fixo com 8 Dígitos = 1112345678
telefone String 1-1
Tabela 6: Dados de contato
Valores
Valores
Nome Tipo Ocorrência Descrição Tamanho Observação
valorServico Decimal 1-1 Valor do serviço 15.2
Valor do desconto
15.2
valorDescCondicionado Decimal 0-1 condicionado
Valor do desconto
15.2
valorDescIncondicionado Decimal 0-1 incondicionado
Valor do desconto
15.2
valorDescEducacao Decimal 0-1 educação
Data no
Data inicio do formato
dataInicioDescEducacao String 0-1 desconto educação dd/mm/yyyy
Data no
Data fim do desconto formato
dataFimDescEducacao String 0-1 educação dd/mm/yyyy
Valor dos custos
15.2
valorCustosDiversos Decimal 0-1 diversos
Data no
Data inicio dos custos formato
dataInicioCustosDiversos String 0-1 diversos dd/mm/yyyy
Data no
Data fim dos custos formato
dataFimCustosDiversos String 0-1 diversos dd/mm/yyyy
Código do item da
1-5
itemListaServico String 0-1 lista de serviço
Discriminação do
1000
descricaoServico String 0-1 serviço
Tabela 7: Valores
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
6
Aluno
Dados do aluno
Nome Tipo Ocorrência
Descrição Tamanho Observação
Identificação
identificacao tpEdu:IdentificacaoAluno 1-1 do aluno
icResponsavel Integer 1-1 0-Não, 1-Sim 1
icAtivo Integer 1-1 0-Não, 1-Sim 1
Dados de
contato tpEdu:Contato 1-1 contato
Dados de
endereco tpEdu:Endereco 1-1 endereço
Dados do
responsavel tpEdu:Resposavel 1-1 responsavel
Lista de
listaCursos tpEdu:Curso 1-* cursos
Tabela 8: Dados do aluno
Responsavel
Dados do responsavel
Nome Tipo Ocorrência
Descrição Tamanho Observação
Identificação
identificacao tpEdu:Identificacao 1-1 do responsavel
Dados de
contato tpEdu:Contato 1-1 contato
Dados de
endereco tpEdu:Endereco 1-1 endereço
Tabela 9: Dados do responsavel
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
7
Curso
Dados do curso
Nome Tipo Ocorrência Descrição Tamanho Observação
codCurso String 1-1 Código do curso 10
Serie String 1-1 Série 40
descricaoCurso String 1-1 Descrição do curso 100
Valores tpEdu:Valores 1-1 1
0 – Esporádico
1
tpCurso Integer 1-1 1 – Mensal
Data no Formato
10
dataInicioCurso String 1-1 dd/mm/yyyy
0 – Não
1
icAtivo Integer 1-1 1 – Sim
Tabela 9: Dados da escola
EmpresaEscola
Dados da Escola
Nome Tipo Ocorrência Descrição Tamanho Observação
Tipo de operação desejada no
upload do arquivo (0-incluir ou 1- 1
operacao Integer 1-1 alterar)
dsIm Strintg 1-1 Inscrição municipal 1-40
cpfCnpj String 1-1 Cpf ou Cnpj do prestador 11-14
listaCursos tpEdu:Curso 1-* 1
Tabela 10: Dados da escola
listaCursos
Lista de cursos
Nome Tipo Ocorrência Descrição Tamanho Observação
Curso tpEdu:Curso 1-* Dados do curso 1
Tabela 11: Dados da escola
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
8
Tipos Simples
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
9
ensino.
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
10
Tabela Tipos de Erros
Arquivo Importação
de Alunos
Tipo de Erro
1.Erro de estrutura
Código Campo Referência Mensagem de Erro 2. Erro de
Preenchimento
SE02 dsIm IM_NULA A inscrição municipal não pode ser nula. 2
O tamanho do campo identificação do
SE03 numeroIdentificacao IDENTIFICACAO_ALUNO_TAMANHO_INVALIDO aluno é maior que o suportado. 1
SE03 numeroIdentificacao IDENTIFICACAO_ALUNO_NULA A identificação do aluno não pode ser nula. 2
SE04 numeroIdentificacao IDENTIFICACAO_ALUNO_INVALIDA A identificação do aluno invalida. 2
A identificação do responsável não pode
SE05 numeroIdentificacao IDENTIFICACAO_RESPONSAVEL_NULA ser nula. 2
SE06 numeroIdentificacao IDENTIFICACAO_RESPONSAVEL_INVALIDA A identificação do responsável invalida. 2
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
13
Arquivo XML Exemplo
Importação de Cursos
<tns:importacaoCursoEnvio xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
xmlns:tns="http://www.ginfes.com.br/importacao_curso_envio"
xmlns:tpEdu="http://www.ginfes.com.br/tpEdu"xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance"xsi:schemaLocation="http://www.ginfes.com.br/importacao_curso_envio
xsd/v01/importacao_curso_envio.xsd">
<tns:empresaEscola>
<tpEdu:operacao>0</tpEdu:operacao>
<tpEdu:dsIm>00000000</tpEdu:dsIm>
<tpEdu:cpfCnpj>70000000000154</tpEdu:cpfCnpj>
<tpEdu:listaCursos>
<tpEdu:Curso>
<tpEdu:codCurso>1111</tpEdu:codCurso>
<tpEdu:descricaoCurso>TESTE</tpEdu:descricaoCurso>
<tpEdu:valores>
<tpEdu:valorServico>1278.00</tpEdu:valorServico>
<tpEdu:itemListaServico>8.01/851390000</tpEdu:itemListaServico>
<tpEdu:descricaoServico>Prestacao de Servicos
Educacionais</tpEdu:descricaoServico>
</tpEdu:valores>
<tpEdu:tpCurso>1</tpEdu:tpCurso>
<tpEdu:icAtivo>1</tpEdu:icAtivo>
</tpEdu:Curso>
</tpEdu:listaCursos>
</tns:empresaEscola>
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
14
</tns:importacaoCursoEnvio>
Importação de Alunos
<?xml version = '1.0' encoding = 'UTF-8'?>
<importacaoAlunoEnvio xmlns="http://www.ginfes.com.br/tiposEducacao.xsd">
<empresaEscola>
<dsIm>1234</dsIm>
<cpfCnpj>07896042000125</cpfCnpj>
</empresaEscola>
<aluno>
<identificacao>
<numeroIdentificacao>481989369</numeroIdentificacao>
<tipoIdentificacao>3</tipoIdentificacao>
<nome>teste aluno</nome>
<matricula>18349</matricula>
<dataNascimento>24/06/2008</dataNascimento>
</identificacao>
<icResponsavel>1</icResponsavel>
<icAtivo>1</icAtivo>
<contato>
<email>teste@teste.com.br</email>
</contato>
<endereco>
<cep>00000000</cep>
<numero>136</numero>
<logradouro>teste</logradouro>
<bairro>teste bairro</bairro>
<uf>35</uf>
<municipio>50308</municipio>
</endereco>
<responsavel>
<identificacao>
<numeroIdentificacao>29490068073</numeroIdentificacao>
<tipoIdentificacao>1</tipoIdentificacao>
<nome>responsavel teste</nome>
</identificacao>
<contato>
<email>teste@teste.com.br</email>
</contato>
<endereco>
<cep>00000000</cep>
<numero>136</numero>
<logradouro>teste</logradouro>
<bairro>teste bairro</bairro>
<uf>35</uf>
<municipio>50308</municipio>
</endereco>
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
15
</responsavel>
<listaCursos>
<Curso>
<codCurso>333</codCurso>
<serie>3 ANO</serie>
<valores>
<valorServico>944.44</valorServico>
<valorDescEducacao>48.8</valorDescEducacao>
<dataInicioDescEducacao>01/01/2016</dataInicioDescEducacao>
<dataFimDescEducacao>31/12/2016</dataFimDescEducacao>
<valorCustosDiversos>81.8</valorCustosDiversos>
<dataInicioCustosDiversos>01/01/2016</dataInicioCustosDiversos>
<dataFimCustosDiversos>31/12/2016</dataFimCustosDiversos>
</valores>
<tpCurso>1</tpCurso>
<dataInicioCurso>30/10/2015</dataInicioCurso>
<icAtivo>1</icAtivo>
</Curso>
</listaCursos>
</aluno>
</importacaoAlunoEnvio>
Este manual é de uso exclusivo dos usuários do sistema Ginfes (NFS-e – Nota Fiscal de Serviço Eletrônica) e não pode ser alterado sem prévia autorização.
Eicon Inteligência em Controles – 2016 ® Gissonline – Todos os diretos reservado.
16