---
title: "OneRoster explicado: turmas e notas para edtech | Quantlix"
description: "O OneRoster é o padrão da 1EdTech para compartilhar turmas, matrículas e notas entre sistemas escolares e ferramentas de aprendizagem. Veja o que a versão 1.2 abrange."
canonical: "https://quantlix.com/pt-br/normas/oneroster/"
last-updated: 2026-11-16
---

Source: https://quantlix.com/pt-br/normas/oneroster/
Language: pt-BR
Description: O OneRoster é o padrão da 1EdTech para compartilhar turmas, matrículas e notas entre sistemas escolares e ferramentas de aprendizagem. Veja o que a versão 1.2 abrange.

**OneRoster** [Tecnologia educacional](https://quantlix.com/pt-br/normas/#learning)

# OneRoster: o padrão para turmas e notas escolares

O OneRoster é o padrão da 1EdTech para trocar listas de turma, matrículas, notas e atribuições de recursos entre sistemas acadêmicos e ferramentas de aprendizagem, por arquivo CSV ou por serviços web REST.

[Converse sobre seu projeto](https://quantlix.com/pt-br/contato/) [Leia os pontos principais](https://quantlix.com/pt-br/normas/oneroster/#standard-overview)

## Visão geral

**Nome completo**

OneRoster Version 1.2, abrangendo os serviços Rostering, Gradebook e Resource

**Publicado por**

1EdTech Consortium (antigo IMS Global Learning Consortium)

**Tipo**

Especificação técnica (padrão de troca de dados)

**Versão atual**

OneRoster 1.2, Final Release; publicada pela primeira vez em 6 de junho de 2022, com os documentos atuais emitidos em 19 de setembro de 2022

**Aplica-se a**

Sistemas acadêmicos (SIS), plataformas de aprendizagem, serviços de enturmação e as ferramentas de edtech que recebem dados de turmas, matrículas e notas

**Última revisão**

16 de novembro de 2026 (2026-11-16)

## Em linguagem simples

### Pontos principais

- O OneRoster dá às escolas uma forma padrão de enviar as listas de turma às ferramentas de aprendizagem e receber as notas de volta.
- A versão 1.2 tem três serviços, Rostering, Gradebook e Resource, cada um disponível por REST e CSV.
- O acesso REST na versão 1.2 exige tokens bearer OAuth 2.0; a antiga assinatura OAuth 1.0a foi removida.
- Escopos separados permitem que uma ferramenta peça os dados básicos de turma sem dados demográficos, o que favorece a minimização de dados.
- Só os produtos listados pela 1EdTech depois de passarem nos seus testes de certificação podem declarar conformidade com o OneRoster.

### O que é o OneRoster?

O OneRoster é **o padrão da 1EdTech para trocar listas de turma, matrículas e notas entre um sistema acadêmico (SIS, na sigla em inglês) e as ferramentas de aprendizagem que uma escola usa**. Ele descreve pessoas, cursos, turmas e resultados da mesma forma em todos os lugares, para que uma ferramenta possa montar as suas turmas automaticamente e devolver as notas sem uma integração sob medida para cada distrito.

O benefício aparece na sala de aula. As listas de turma ficam atualizadas quando os estudantes entram ou mudam de turma, as novas ferramentas ficam prontas no primeiro dia do período letivo e os professores não precisam digitar as notas de novo em um segundo sistema. Sistemas acadêmicos, plataformas de aprendizagem, ferramentas de avaliação e serviços de enturmação usam o padrão, e é por isso que uma única conexão pode atender muitas escolas.

### O que o OneRoster abrange

- **Serviço Rostering.** Organizações, períodos letivos, cursos, turmas, usuários e matrículas, além de dados demográficos opcionais.
- **Serviço Gradebook.** Itens de avaliação (line items), resultados, categorias e escalas de pontuação, com itens e resultados de avaliações para provas que acontecem fora de uma turma.
- **Serviço Resource.** Quais recursos digitais estão atribuídos a turmas, cursos e usuários, sem dar acesso aos recursos em si.
- **Binding CSV.** Um conjunto de arquivos CSV trocados em um zip com um manifesto, com suporte a processamento completo e incremental para sincronizações programadas.
- **Binding REST.** Serviços web em JSON descritos em OpenAPI, com filtragem, ordenação e paginação para trocas quase em tempo real.

### O que mudou na versão 1.2

O OneRoster 1.2 chegou à Final Release em 2022 e continua sendo a versão atual. As mudanças que mais importam para os engenheiros são:

- **Segurança.** A assinatura de mensagens OAuth 1.0a foi removida. Os serviços REST agora exigem **tokens bearer OAuth 2.0 obtidos com o fluxo client credentials**, de acordo com o 1EdTech Security Framework.
- **Escopos.** O acesso é dividido em escopos, por exemplo dados básicos de turma, dados demográficos e a lista completa, para que uma ferramenta peça apenas o que precisa.
- **Um modelo de usuário mais rico.** Os usuários podem ter várias funções em diferentes organizações, e um userMasterId leva um identificador definitivo ao lado do sourcedId de interoperabilidade.
- **Resultados de avaliações.** Um perfil para o serviço Gradebook trata das avaliações que acontecem fora de uma turma.
- **Flexibilidade regional.** Os vocabulários CEDS, específicos dos EUA, foram removidos para que outras regiões possam aplicar os seus.

Muitos distritos e fornecedores ainda trocam dados na versão 1.1, e a 1EdTech continua publicando as duas versões, então as integrações muitas vezes aceitam ambas durante uma migração.

### Como ele aparece em projetos de software

- **Identificadores estáveis.** O sourcedId é a chave de ligação entre as sincronizações, e os registros são conciliados com cuidado quando um distrito reimporta ou mescla dados.
- **Tratamento de deltas e exclusões.** Os valores de status e as datas de última modificação orientam as sincronizações incrementais, e as matrículas canceladas removem o acesso rapidamente.
- **Acesso com privilégio mínimo.** As ferramentas pedem apenas os escopos de turma, dados demográficos ou notas de que precisam, o que apoia os compromissos que as escolas assumem sob a [FERPA](https://quantlix.com/pt-br/normas/ferpa/).
- **Regras de sincronização de notas.** Os resultados vão para o item de avaliação certo, com comportamento claro para recorreções, trabalhos entregues com atraso e notas que o professor altera no sistema acadêmico.
- **Validação antes da importação.** Arquivos e respostas da API são verificados antes de alterar dados em produção, e os distritos recebem relatórios legíveis quando algo está incompleto.

### Como trabalhamos com o OneRoster

Construímos consumidores e provedores OneRoster para produtos de edtech e plataformas de distritos escolares: pipelines de importação de CSV, clientes e servidores REST, correspondência de identidades e sincronização de notas, dentro do nosso trabalho de [aplicações empresariais](https://quantlix.com/pt-br/servicos/aplicacoes-empresariais/). O OneRoster costuma ficar ao lado do [LTI](https://quantlix.com/pt-br/normas/lti/), que cuida da abertura a partir de cada curso enquanto o OneRoster mantém as turmas e as notas em sincronia.

A certificação vem da 1EdTech depois dos seus próprios testes, e só os produtos listados podem declarar conformidade. Ajudamos você a se preparar para esses testes e a documentar como a sua integração se comporta. A enturmação é uma parte do nosso trabalho mais amplo em [educação](https://quantlix.com/pt-br/setores/educacao/).

## Onde se aplica

Setores em que esta norma costuma influenciar o trabalho.

- ### [Educação](https://quantlix.com/pt-br/setores/educacao/)

  Plataformas de aprendizagem, serviços estudantis e operações institucionais

## Normas relacionadas

[Todas as normas](https://quantlix.com/pt-br/normas/)

- LTI

  ### [Abertura e integração de ferramentas de aprendizagem](https://quantlix.com/pt-br/normas/lti/)

  O LTI é o padrão da 1EdTech que permite a uma plataforma de aprendizagem, como um LMS, abrir ferramentas externas com segurança, repassando o contexto de usuário, função e curso e, com o LTI Advantage, trocando notas e listas de turma.
- FERPA

  ### [Privacidade dos registros educacionais nos EUA](https://quantlix.com/pt-br/normas/ferpa/)

  A FERPA é a lei federal dos EUA que protege a privacidade dos registros educacionais dos estudantes, dando aos pais e aos estudantes elegíveis o direito de vê-los e corrigi-los e de controlar a maior parte das divulgações feitas pelas escolas.
- xAPI

  ### [Dados e registros de experiências de aprendizagem](https://quantlix.com/pt-br/normas/xapi/)

  O xAPI é o padrão Experience API, publicado pelo IEEE como 9274.1.1-2023, para registrar atividades de aprendizagem e desempenho como declarações simples e trocá-las com um Learning Record Store.

## Serviços que apoiam este trabalho

Os serviços que costumamos levar a projetos que envolvem esta norma.

[Ver todos os serviços](https://quantlix.com/pt-br/servicos/)

### [Aplicações empresariais](https://quantlix.com/pt-br/servicos/aplicacoes-empresariais/)

A Quantlix projeta e desenvolve aplicações empresariais para processos internos, regras de negócio e integração, com controles de acesso e arquitetura sustentável.

### [Desenvolvimento de aplicações web](https://quantlix.com/pt-br/servicos/desenvolvimento-de-aplicacoes-web/)

A Quantlix projeta aplicações web com interfaces responsivas, regras de negócio e integrações, considerando acessibilidade, desempenho e manutenção.

### [Análise de dados](https://quantlix.com/pt-br/servicos/analise-de-dados/)

A Quantlix desenvolve pipelines de dados e ferramentas de inteligência de negócios que transformam dados operacionais em métricas definidas e apoio à decisão.

## Perguntas e respostas

O que as equipes costumam nos perguntar sobre esta norma.

**Qual é a versão mais recente do OneRoster?**

O OneRoster 1.2, uma Final Release da 1EdTech publicada pela primeira vez em junho de 2022, com os documentos atuais emitidos em 19 de setembro de 2022. Quando verificamos em novembro de 2026, a 1EdTech o indicava como a versão mais recente.

**Devemos usar a versão CSV ou REST do OneRoster?**

O CSV é indicado para sincronizações programadas, completas ou incrementais, como uma exportação noturna do sistema acadêmico. O REST é indicado para trocas quase em tempo real e acesso mais granular. Os distritos variam no que os seus sistemas oferecem, então as ferramentas muitas vezes aceitam os dois.

**O que mudou entre o OneRoster 1.1 e o 1.2?**

A versão 1.2 exige OAuth 2.0 com client credentials em vez da assinatura OAuth 1.0a, acrescenta escopos, permite que os usuários tenham várias funções e um userMasterId e introduz um perfil de resultados de avaliações para o serviço Gradebook.

**O OneRoster é a mesma coisa que o LTI?**

Não. O OneRoster transfere turmas e notas em lote entre sistemas, para a escola inteira. O LTI abre uma ferramenta a partir de um curso e repassa o contexto daquela sessão. Os dois costumam ser usados juntos.

**Como um produto obtém a certificação OneRoster?**

Ele passa na suíte de testes de certificação OneRoster da 1EdTech para a versão, os serviços e o papel que suporta, conforme descrito no guia de conformidade e certificação. Para se candidatar, é preciso ser membro da 1EdTech, e os produtos certificados aparecem no TrustEd Apps Directory.

## Fontes oficiais

Consulte o texto oficial antes de se apoiar em qualquer detalhe. O que se aplica a você depende do seu papel, da sua localização e da versão em vigor.

- [1EdTech: OneRoster](https://www.1edtech.org/standards/oneroster)
- [Especificação OneRoster Version 1.2](https://www.imsglobal.org/spec/oneroster/v1p2)
- [Guia de implementação e boas práticas do OneRoster 1.2](https://www.imsglobal.org/spec/oneroster/v1p2/impl/)

Estes guias explicam cada norma em linguagem simples. Eles não são aconselhamento jurídico e não afirmam que algum produto ou organização esteja em conformidade com uma norma.

## Planejando um software em torno desta norma?

Conte quais sistemas estão envolvidos e o que você precisa demonstrar. Ajudamos a incorporar os requisitos desde o início.

[Converse sobre seu projeto](https://quantlix.com/pt-br/contato/)
