Administração da Conta · Integrações

Integrações: o catálogo

As conexões entre o Escolaweb e serviços de fora: quem emite o boleto, quem emite a nota fiscal, quem coleta a assinatura, quem entrega a mensagem no WhatsApp.

Administrador do sistema Leitura de 3 minutos Onde: Menu › Integrações

Sem a integração certa configurada, rotinas inteiras param no meio — fatura sem emissão, NFS-e sem envio, documento sem assinatura eletrônica.

O que está disponível

A tela tem duas partes: o marketplace, com tudo o que existe, e minhas integrações, com o que a escola já conectou.

Categoria	Integração	Para que serve
Assinatura eletrônica	Autentique	Assinar contratos e documentos escolares com validade jurídica.
Bancos e meios de pagamento	PrincipiaPay	Conta integrada ao ERP, com conciliação automática dos recebíveis.
Bancos e meios de pagamento	E-Ticket PrincipiaPay	Carteira digital de créditos para as lojas e cantinas.
Bancos e meios de pagamento	Cielo	Receber por cartão de crédito e débito.
Bancos e meios de pagamento	Receita Garantida	Habilitar a Receita Garantida como meio de pagamento das matrículas, curso por curso.
Emissão de NF/NFS	eNotas	Emitir nota fiscal de serviço e de produto.
Comunicação	Twilio	Conectar o atendimento ao WhatsApp Business.

Sicoob

aparece no catálogo mas está inativo — a integração existe no sistema e não está disponível para conectar. Se a escola usa Sicoob, fale com o suporte antes de planejar a cobrança em cima dela.

Como funciona uma conexão

Cada integração vira uma conexão, vinculada a uma instituição. Escola com duas unidades conecta duas vezes, com credenciais próprias de cada uma.

Os formulários variam bastante:

Tipo	Integrações	O que você preenche
Só credenciais	Autentique, Twilio	Token e identificadores copiados do painel do provedor.
Cadastro com aprovação	PrincipiaPay, Cielo	Dados da empresa, representantes e documentos. A conexão passa por análise do provedor.
Configuração fiscal	eNotas	Certificado digital, inscrições, séries e regime tributário.
Sem campos	E-Ticket PrincipiaPay	Depende do PrincipiaPay já conectado.
Adesão por curso	Receita Garantida	Instituição, conta, a lista de cursos que aderem e a chave de acesso.

O painel de conexão das integrações simples

As integrações do tipo só credenciais — Twilio, Autentique — se conectam num painel lateral, sem sair da lista de integrações. O mesmo painel serve para adicionar e para editar. O que você encontra nele:

O logo do provedor no topo, em Integração selecionada — para conferir que é o serviço certo. Sem logo, aparece o nome.
Uma faixa informativa com os pré-requisitos daquela integração, quando o provedor os informa.
Um campo por credencial, com rótulo e exemplo vindos do próprio catálogo — por isso os campos mudam de uma integração para outra.
A dica de cada campo aparece junto do próprio campo, e o link "Ver documentação ↗" logo abaixo abre a página do provedor onde aquele dado é obtido.
Campos de segredo (token, chave) aparecem mascarados, como senha.

As telas de cadastro com aprovação

Cielo, PrincipiaPay e as conexões de boleto usam telas cheias, no mesmo formato dos demais cadastros do sistema: cabeçalho, etapas e rodapé iguais aos de qualquer formulário.

Três detalhes que mudam o dia a dia:

Instituição e Conta relacionada aparecem como dado de leitura, não como campo — elas vêm da seleção anterior.
O botão Avançar nunca fica desabilitado. Clicar com campos vazios mostra os erros no formulário, em vez de deixar você adivinhando o que falta.
Ao salvar, o sistema mostra o carregamento e impede o envio duplicado; se der erro, aparece a mensagem real do provedor, não um texto genérico.

As ações da lista

Na lista de minhas integrações, cada conexão tem:

Ação	Onde fica
Editar	Sempre visível, no lápis.
Sincronizar status	Ícone próprio — disponível para todas as integrações, não só as de pagamento.
Inativar / Ativar	Dentro de Mais ações.
Histórico	Dentro de Mais ações.
Abrir link	Dentro de Mais ações, quando a integração tem painel externo.

não existe excluir integração pela lista.

Uma conexão excluída deixaria contas e modelos de fatura apontando para o vazio. O caminho é inativar — a conexão para de operar e o histórico continua.

Segurança: leia antes de abrir a tela

quem enxerga Integrações pode movimentar dinheiro em nome da escola.

Chave de API, token e certificado digital são credenciais — quem as tem emite boleto, emite nota e assina documento. Restrinja o perfil de acesso que enxerga este menu a quem realmente administra o sistema.

Três regras que valem para todas:

As credenciais vêm do provedor, não do Escolaweb. Peça ao banco ou à plataforma contratada antes de abrir o formulário.
Nunca envie credencial por e-mail ou mensagem. Se alguém pedir, é motivo para desconfiar.
Troque a credencial quando alguém sai. Token compartilhado com um funcionário desligado continua valendo até ser revogado no painel do provedor.

Qual conectar primeiro

Depende do que a escola precisa que funcione:

Para…	Conecte
Emitir boleto e conciliar recebimento	PrincipiaPay
Receber por cartão	Cielo
Emitir nota fiscal	eNotas — e veja Preparar o ambiente para emitir NFS-e
Coletar assinatura no contrato de matrícula	Autentique
Atender pelo WhatsApp	Twilio
Vender na cantina com carteira de créditos	PrincipiaPay, depois E-Ticket

Perguntas frequentes

Conectei e as faturas continuam com erro.

A conexão precisa estar vinculada à conta usada no modelo de fatura. Veja Contas.

"A integração desta conta não está ativa. Reative a conexão antes de vinculá-la a um modelo de fatura."

Exatamente o que diz: a conta até tem conexão, mas ela está inativa. Reative em minhas integrações e tente de novo. O sistema recusa o vínculo de propósito — deixar passar significaria um modelo de fatura apontando para um meio de pagamento desligado.

Posso ter duas conexões do mesmo provedor?

Sim — uma por instituição, ou uma por conta bancária, conforme o caso.

A integração aparece como conectada mas nada acontece.

Credencial expirada é a causa mais comum. Confira no painel do provedor se o token ainda é válido.

Continue

Visão geral do módulo