ERP e notas fiscais
O sistema integra-se a ERPs para emitir a NFS-e dos títulos pagos: os pagamentos registrados no financeiro podem ser exportados, e a nota emitida aparece no detalhe do título. Há duas opções — Bling e Conta Azul — e apenas uma fica ativa por vez. As telas são abertas pelo botão Configurar em Integrações (também acessíveis pelas abas da tela Configurações do Sistema).
Nas duas integrações a conexão usa autorização direta no site do ERP (você faz login lá e autoriza a escola) e se renova sozinha — não é preciso reconectar periodicamente.
Bling
Onde: Integrações → cartão Bling → Configurar.
Quem pode usar: administradores.
Para que serve
Conecta o sistema à conta Bling da escola e define de/para das formas de pagamento: cada meio de pagamento registrado no sistema (boleto, Pix, cartão...) é associado à forma de pagamento correspondente cadastrada no seu Bling, para que a NFS-e saia classificada corretamente.
Conexão
A tela mostra a seção Conexão com o Bling:
- Desconectado: botão Conectar com o Bling — você é levado ao site do Bling para fazer login e autorizar (não é preciso digitar credenciais no sistema; o aplicativo já é gerenciado pela plataforma). Ao voltar, aparece "Autenticação efetuada com sucesso!" e a conexão fica ativa.
- Conectado: a tela mostra "Conexão ativa", a validade da autorização (data e hora) e o botão Desconectar do Bling — que pede confirmação explicando o impacto antes de executar.
:::info Regra do sistema Conectar o Bling o torna o ERP ativo da escola. Desconectar remove a autorização e deixa a escola sem ERP ativo — a exportação de títulos para nota fiscal para de funcionar até conectar novamente (o mesmo vale para a Conta Azul). :::
Campos — Formas de pagamento (visíveis com a conexão ativa)
Cada campo é uma lista com as formas de pagamento do seu Bling; selecione a correspondente para cada meio do sistema. Todos são obrigatórios para salvar o mapeamento.
| Campo | O que é | Obrigatório |
|---|---|---|
| Boleto | Forma usada nas notas de títulos pagos por boleto | Sim |
| PIX | Forma para pagamentos por Pix | Sim |
| Cartão de Crédito | Forma para cartão de crédito | Sim |
| Débito | Forma para cartão de débito | Sim |
| Dinheiro | Forma para pagamentos em dinheiro | Sim |
| Depósito Bancário | Forma para depósitos | Sim |
| Maquininha | Forma para pagamentos na maquininha | Sim |
| Bônus | Forma para abatimentos por créditos/bônus | Sim |
| Não Informado | Forma usada quando o meio de pagamento não foi registrado | Sim |
| Sequencial Pedido | Número inicial da sequência de pedidos criados no Bling | Sim |
Ações
| Ação | O que faz |
|---|---|
| Conectar com o Bling | Abre a autorização no site do Bling |
| Salvar mapeamento | Grava o de/para; aparece "Mapeamento salvo! As próximas notas usarão as formas de pagamento configuradas." |
| Desconectar do Bling | Remove a autorização, com confirmação |
Passo a passo
- Clique em Conectar com o Bling e autorize com o login da conta Bling da escola.
- De volta à tela, associe cada meio de pagamento à forma correspondente do Bling.
- Informe o Sequencial Pedido e clique em Salvar mapeamento.
Problemas comuns
- "Não foi possível carregar as formas de pagamento do Bling: ..." — a tela abriu, mas a consulta ao Bling falhou (conexão expirada ou instabilidade). Tente recarregar; se persistir, desconecte e conecte novamente.
- "... é obrigatório" — todos os campos do mapeamento precisam de uma forma selecionada.
- Mensagem de erro ao voltar da autorização — a autorização não foi concluída no Bling; repita o processo de conexão.
Conta Azul
Onde: Integrações → cartão Conta Azul → Configurar.
Quem pode usar: administradores.
Para que serve
Conecta o sistema à Conta Azul da escola para exportação dos títulos pagos e emissão de NFS-e. Aqui o fluxo tem um passo a mais: antes de conectar, é preciso criar um aplicativo no portal do desenvolvedor da Conta Azul e informar as credenciais desse aplicativo.
Campos — Credenciais do aplicativo
| Campo | O que é | Obrigatório | Observações |
|---|---|---|---|
| Client ID | Identificador do aplicativo criado no portal da Conta Azul | Sim | |
| Client Secret | Chave secreta do aplicativo | Sim | Trate como senha; o valor não deve ser compartilhado |
Ações
| Ação | O que faz |
|---|---|
| Salvar credenciais | Grava Client ID/Secret; aparece a orientação: "Credenciais salvas! Agora clique em "Conectar com a Conta Azul" para autorizar o acesso." |
| Conectar com a Conta Azul | Abre o login da Conta Azul para autorizar o acesso da escola |
| Desconectar da Conta Azul | Remove a autorização, com confirmação explicando o impacto |
Passo a passo
- No portal do desenvolvedor da Conta Azul, crie um aplicativo e copie Client ID e Client Secret.
- Na tela, informe os dois campos e clique em Salvar credenciais.
- Clique em Conectar com a Conta Azul, faça login e autorize. Ao voltar, aparece "Autenticação efetuada com sucesso!" — a Conta Azul vira o ERP ativo.
- Pronto: os títulos pagos podem ser exportados para emissão da NFS-e, e a nota emitida aparece no detalhe do título. A conexão se renova sozinha.
Problemas comuns
- "Retorno de autorização inválido — clique em Conectar e tente novamente." — o retorno da Conta Azul não correspondeu à autorização iniciada (por exemplo, um link antigo). Refaça a conexão a partir do botão Conectar.
- "A autorização da Conta Azul expirou ou foi revogada e não pode ser renovada. Clique em Desconectar e depois em Conectar para autorizar novamente." — a renovação automática não é mais possível; refaça a autorização.
- "Não foi possível atualizar o token: ..." — falha temporária na renovação; tente novamente mais tarde.
- Campos obrigatórios — sem Client ID e Client Secret nada é salvo (proteção para não apagar credenciais funcionando).