Administração da Conta · Integrações
Diferente das outras integrações de pagamento, esta trabalha por curso: a adesão não é da instituição inteira, é da lista de cursos que você marcar.
Três coisas precisam existir:
Se um curso ativo da instituição não aparece na lista da etapa 2, o tipo dele não está habilitado para a Receita Garantida. Essa habilitação não é editável nas telas do sistema — acione o suporte.
Abra o cartão da Receita Garantida no marketplace de Integrações. São três etapas.
| Campo | O que informar |
|---|---|
| Nome da integração | Como ela aparece na lista de conexões. |
| Instituição | A unidade que adere. É ela que define quais cursos aparecem na etapa seguinte. |
| Conta | A conta bancária vinculada. Liberada depois da instituição. |
| Incluir serviços adicionais no envio | Marcação opcional: além da mensalidade, os serviços adicionais entram no envio. |
Se a instituição escolhida não tiver conta, o campo avisa: "Não há conta vinculada à instituição selecionada."
A lista dos cursos que aderem, com Instituição e Curso em cada linha. Marque um a um, ou use a marcação do cabeçalho para marcar todos.
A lista traz apenas os cursos ativos da instituição escolhida cujo tipo permite Receita Garantida. Cursos que já têm contrato abrem marcados — é o retrato de quem está dentro hoje.
Defina a instituição antes de escolher os cursos.
| Campo | O que informar |
|---|---|
| Chave de acesso / token | A chave fornecida pela Receita Garantida. |
| URL de produção | Vem preenchida (https://api.ies.integracao.principia.net/) e é só para consulta — há um botão para copiar. |
| UTM Source, API Key e Public Key | As credenciais de SSO. |
Ao salvar, o sistema valida a chave junto à Receita Garantida. A conexão só fica Conectado se a chave for aceita.
A mensagem do parceiro aparece na tela, e a conexão fica em Minhas integrações aguardando correção. Abra a mesma conexão para corrigir a chave, em vez de começar outra.
Na edição, a chave só é validada de novo quando você a altera.
| Mensagem | Por quê |
|---|---|
| "É necessário selecionar ao menos um curso para a Receita Garantida." | A etapa 2 ficou sem nenhuma marcação. |
| "Esta unidade escolar já possui uma conexão Receita Garantida ativa." | É uma conexão por instituição. Para mudar os cursos, edite a conexão existente em vez de criar outra. |
| "Os seguintes cursos possuem tipo de curso não apto à Receita Garantida: ..." | O tipo de um dos cursos marcados deixou de permitir Receita Garantida entre a montagem da tela e o salvamento. |
| "É necessário informar a unidade escolar para a Receita Garantida." | A instituição da etapa 1 não foi preenchida. |
Os cursos marcados passam a ter contrato ativo na Receita Garantida; os desmarcados perdem o contrato. É a lista da etapa 2 que manda — curso que estava dentro e você desmarcou sai, no mesmo salvamento.
Todos os modelos de fatura de Matrícula da instituição recebem a Receita Garantida como meio de pagamento, e todo modelo de fatura de Matrícula criado depois já nasce com ela. Em modelo de Loja ela não aparece.
A tentativa devolve "Este meio de pagamento é obrigatório enquanto a integração Receita Garantida estiver ativa." Para tirá-lo, o caminho é inativar a integração.
O parcelamento não é definido aqui: ele acontece no checkout da Receita Garantida, fora do Escolaweb — a fatura paga por Receita Garantida leva a família para lá.
Os pagamentos feitos na Receita Garantida chegam ao Escolaweb pela integração, mas nem sempre na hora. Quando uma fatura aparece em aberto e a família garante que pagou, o botão Sincronizar liquidação, na tela de Faturas, busca as baixas direto no parceiro.
Ele pede um Período (máximo 15 dias). Período maior é recusado com "Selecione um período de até 15 dias."
A tela avisa que "Esse processo consulta a Receita Garantida e pode levar alguns minutos — você será avisado quando terminar." Não repita o comando achando que travou: dois processos concorrentes sobre o mesmo período só atrasam a resposta.
Ao fechar um lote de faturas da Receita Garantida, o sistema agenda uma sincronização de status cerca de cinco minutos depois, sem ação de ninguém. É ela que traz o retorno do parceiro sobre as faturas do lote. Se os status ainda parecerem parados passado esse tempo, use Sincronizar status na conexão, em Minhas integrações.
Quando a família paga uma fatura da Receita Garantida por fora — e a escola registra o recebimento pela aba Faturas do aluno —, o sistema não baixa a fatura: ele envia ao parceiro um pedido de liquidação manual e deixa a fatura em Liquidação manual solicitada. A baixa de verdade chega na sincronização seguinte. O passo a passo, os avisos e o que é recusado estão em Faturas.
Abra a conexão por Minhas integrações. A tela reabre com os dados gravados e a lista de cursos já marcada como está hoje. Salvar aplica só a diferença — cursos de outras instituições não são tocados.
Confira, nesta ordem: a conexão está Conectado; a instituição do modelo de fatura é a mesma da conexão; e a finalidade do modelo é Matrícula, não Loja.
Edite a conexão da instituição e marque o curso. Não crie uma segunda conexão — o sistema recusa. Se o curso não estiver na lista, o tipo dele não é apto: acione o suporte.
É configuração de ambiente da integração. Acione o suporte.