Gestão Escolar - CFGAPI001 - Configuração do sistema para aceitar matrículas pela API de integração
Introdução
Este manual é utilizado para fazer as configurações necessárias para funcionamento da API de integração de cadastro de cursos e matrículas.
Veja a API em Gestão Escolar - API de integração
Configurando o sistema
Administradoras de cartão
Para utilizar a API de matrícula e geração de financeiro, caso seja utilizada a forma de pagamento como cartão de crédito ou débito, é necessário configurar qual a administradora padrão para cada modalidade (crédito/débito).
Acessar o menu Tabelas e colocar SIM nas que deve ser a padrão, ou seja, nas quais deverão ser registrados os pagamentos quando for cartão:
Cadastro de curso padrão
Quando utilizada a API de cadastro de curso, para que o sistema possa cadastrar um novo curso pela API é necessário ter várias configurações do curso e para que a API não fique muito complexa, deve ser criado um curso no menu Tabelas -> Cursos com o código "[PADRAO]" (sem as aspas) conforme abaixo:
Dentro do cadastro desse curso padrão deve ser configurado todas as informações que serão utilizadas como base para os novos cursos criados pela API, ou seja, quando a API incluir algum curso, irá DUPLICAR os dados desse curso padrão e criar o novo curso com o código e nome informado pela API.
Cadastro de período letivo
Na API quando utilizada a modalidade de curso "EAD" deve-se criar um período letivo com o nome "EAD" que será onde todas as séries, turmas e matrículas serão feitas.
Colocar na data final do período uma data bem longa, por exemplo, 30 anos pra frente.
Cadastro de série
No cadastro de série é necessário cadastrar uma série padrão para quando a API for cadastrar um novo curso o sistema poder também DUPLICAR além do cursão padrão também duplicar todas as séries desse curso.
No exemplo abaixo de curso EAD foi cadastrada uma série "EAD" para o "Curso base" que é o curso com o código [PADRAO].
Para cursos do tipo EAD onde a matrícula já é feita e o financeiro já lançado, a série somente pode ter 1 receita configurada e deve ser obrigatório como abaixo:
Caso não seja curso EAD, pode ter mais de uma receita obrigatória, e os valores dos boletos gerados serão o valor configurado na receita e não o valor informado na API.
Configurações gerais
Para utilizar a API de matrícula, precisa habilitar a auto numeração de matrícula no menu abaixo:
Geração de código e senha para uso da API
Para poderem ter acesso a API, é necessário criar um código e senha e disponibilizar para o desenvolvedor que irá utilizar a API.
Esse código e senha deve ser único para cada desenvolvedor/empresa que for integrar.
Acessar o menu Tabelas -> API e criar uma chave para o desenvolvedor. Manter essa chave em sigilo e somente compartilhar com o desenvolvedor.