# Turmas e o ambiente de aulas: o vínculo que faz a sincronização funcionar

> Qual campo realmente leva o aluno para o Moodle, e por que preencher o outro não adianta.

## O que você vai conseguir

Entender por onde o aluno passa do EduPay para o ambiente de aulas — e por que,
quando não passa, quase sempre falta a mesma coisa.

**A resposta curta:** quem carrega o aluno é a **turma**, não o curso.

## O caminho, em três passos

1. A turma do EduPay guarda o **ID da coorte no Moodle**.
2. Ao criar a matrícula, o aluno é somado àquela coorte do outro lado.
3. O próprio Moodle, pela sincronização de coortes dele, inscreve o aluno nos
   cursos ligados àquela coorte.

O EduPay não inscreve ninguém em curso. Ele coloca a pessoa na coorte, e a
inscrição no curso é trabalho do Moodle.

## Os dois campos que parecem fazer a mesma coisa

| Campo | Onde fica | O que faz hoje |
|---|---|---|
| **ID da coorte no Moodle** | Na turma | **É este.** Sem ele, nada é sincronizado |
| **ID do curso no Moodle** | Na oferta | Nada. É só registro |

Preencher o ID na oferta e esperar que o aluno apareça no curso é o engano mais
comum. Ele fica guardado, aparece na tela e não é usado por nenhuma rotina.

![Formulário da turma, com os dois últimos campos dedicados ao Moodle](/Apps/edupay/ajuda/turma-formulario.png)
*Os dois campos do rodapé são os que importam: o **ID da coorte no Moodle** e a caixa **Criar também no Moodle**. Eles só aparecem para quem já conectou o ambiente de aulas.*

## As três condições

Para a matrícula chegar no ambiente de aulas, as três precisam valer ao mesmo
tempo:

1. **A integração está ativa** em **Integrações › Plataformas LMS**.
2. **A matrícula tem turma escolhida.** Sem turma, o EduPay nem tenta.
3. **A turma tem o ID da coorte preenchido.**

Falhando qualquer uma, o aluno é matriculado normalmente no EduPay — contrato,
parcelas, portal, tudo funciona — e simplesmente não atravessa para o outro lado.

## O jeito fácil de preencher o ID

Ao criar a turma, marque **Criar também no Moodle**. O EduPay cria a coorte lá e
traz o ID preenchido.

Quando isso não dá certo, ele avisa: **Turma criada, mas não foi possível criar a
coorte no Moodle. Vincule o ID manualmente.** A turma existe; falta só o ID, que
você preenche em **Editar**.

## A lista da turma e a matrícula

Vale reforçar, porque é onde o diagnóstico costuma se perder: quem leva o aluno
para o ambiente de aulas é **a turma escolhida na matrícula**, não a lista de
alunos da tela da turma.

Adicionar alguém à lista organiza a escola. É a matrícula que dispara a
sincronização.

## Como saber que deu certo

> [certo]
> Na tela da matrícula, o campo **Sincronização Moodle** deixa de mostrar **Não
> configurado**. Se algo travar, o botão **Re-sincronizar Moodle**, no alto da
> mesma tela, tenta de novo.

## Se algo der errado

> [erro]
> **A matrícula diz "Não configurado".** Percorra as três condições acima, na
> ordem. É quase sempre a segunda ou a terceira.
>
> **O aluno entrou na coorte mas não aparece em curso nenhum.** Aí é do lado do
> Moodle: a coorte precisa estar ligada aos cursos, pela sincronização de coortes
> dele.
>
> **Você trocou a turma da matrícula.** A sincronização não segue sozinha. Use
> **Re-sincronizar Moodle** depois de trocar.


---

https://edupay.estudiosite.com/pt/ajuda/dia-a-dia/turmas-e-o-ambiente-de-aulas
2026-08-05