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.
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.

A tela de conexão das integrações simples

As integrações do tipo só credenciais deixaram de usar um painel lateral e passaram a ter uma página própria — a mesma para adicionar e para editar. O que você encontra nela:

O logo e o nome do provedor no topo, para conferir que é o serviço certo.
Uma nota de introdução explicando o que aquela integração faz, quando o provedor fornece essa informação.
Um campo por credencial, com o rótulo e o exemplo de preenchimento vindos do próprio catálogo — por isso os campos mudam de uma integração para outra.
Debaixo dos campos que precisam, uma explicação curta e um link "Ver documentação ↗" que abre a página do provedor onde aquele dado é obtido.
Campos de segredo (token, chave) aparecem mascarados, como senha.

saiu da tela sem salvar?

O sistema pergunta antes de descartar. Se confirmar, nada é gravado — nem parcialmente.

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