API — Changelog

Acompanhe as atualizações, melhorias e correções implementadas em nossa API. Fique por dentro das novidades e mudanças que impactam a integração e o uso dos nossos serviços.

Terça-feira, 6 de Outubro de 2026
Novo sandbox, com clientes de teste por app
O sandbox passa a ser uma instância separada da To Aqui Escola, em https://sandbox.toakiescola.com.br. Cada app tem os seus próprios clientes de teste, e o desenvolvedor pode entrar no sistema e usá-lo como a escola. Veja Sandbox e produção.
  • Chaves de teste (toaqui_test_) passam a funcionar só em https://sandbox.toakiescola.com.br/api/v1. Em produção, elas recebem 403 com "code": "SANDBOX_HOST";
  • Cada app cria, na aba Credenciais, uma rede privada e uma rede pública (SEDUC) só suas, com uma escola cheia de dados de demonstração para todos os endpoints de leitura, e pode recriá-las quando quiser;
  • Com o botão "Entrar no sandbox", o desenvolvedor usa o sistema web como a rede de ensino e cadastra o que quiser, inclusive novos usuários. E-mails, SMS, WhatsApp e push vão para a Caixa de saída do sandbox;
  • Pagamentos e assinaturas eletrônicas são simulados por páginas próprias do sandbox, e a escola recebe a confirmação como em produção;
  • Os webhooks de teste agora são enviados para tudo o que acontece nos clientes do app — chamadas à API, ações feitas no sistema e rotinas automáticas — e não só para as chamadas à API;
  • Novo quadro Dados de teste em cada cliente, com um valor para cada parâmetro de caminho (turma, matrícula, CPF, aula, nota…) e o ID de um registro de cada recurso.
Correções
  • Aulas: corrigido o erro 500 em GET /v1/partners/school/{cnpj}/lesson/all e GET /v1/partners/school/{cnpj}/lesson/{id} quando a aula tinha data de publicação.
Sexta-feira, 2 de Outubro de 2026
Módulos ERP na API
Clientes do plano Gestão Escolar passam a ter os módulos de gestão disponíveis na API, com as mesmas credenciais, paginação e formato de erro do restante da API. Veja a visão geral dos módulos ERP.
  • Novos endpoints de leitura: Financeiro (contratos, contas a receber e a pagar, categorias, contas e resumo), Estoque e Merenda, Patrimônio, Recursos Humanos, Saúde, Exercícios e Suporte;
  • Novos endpoints de escrita: fornecedores, leads do CRM (criar, editar, mover de etapa, marcar como perdido), empréstimos da Biblioteca (emprestar, devolver, renovar), visitantes e visitas (agendar, check-in, check-out, cancelar) e eventos (criar, editar, alterar status);
  • Financeiro, CRM e RH são exclusivos de escolas privadas; clientes sem o ERP recebem 403 com ERP_REQUIRED nos módulos de gestão, enquanto Visitantes e Suporte ficam disponíveis em todos os planos, como no sistema;
  • Novos webhooks: receivable.paid, receivable.status_changed, supplier.*, crm_lead.*, library_loan.*, visitor.*, visit.* e event.* — disparados também por mudanças feitas nas telas da escola;
  • Documentado o endpoint de marcações dos relógios de ponto Control iD (POST /v1/hr/timeclock/punch/{token});
  • O sandbox do Portal do Parceiro agora traz dados de demonstração de todos os módulos ERP.
Atualizações e correções nos endpoints existentes
  • Conselho de Classe: created_by (UUID do usuário autor) passou a ser obrigatório ao criar um conselho;
  • Obter responsável: corrigido — o endpoint volta a retornar o responsável em data como um único objeto, conforme documentado;
  • Editar turma: campos ausentes no corpo não são mais alterados — antes, preenrollment_vacancies e teacher_subjects omitidos eram apagados;
  • Frequência biométrica: novo campo opcional device_identifier no check-in e check-out, ligado aos dispositivos do Mapa da Escola;
  • Horário semanal: aceita também os turnos fullshift e morningafternoon;
  • Responsáveis: documentado GET /v1/partners/responsibles/all, que lista os responsáveis de todas as escolas do cliente;
  • Webhooks: documentado classroom_schedule.saved; apps do Portal do Parceiro agora podem assinar os eventos de coordenadores, secretários, professores e autorizações;
  • Portal do Parceiro: documentada a confirmação de recuperação de acesso por chave de API (POST /v1/partner-portal/account-recovery);
  • Verificação Dupla: corrigido o caminho dos endpoints do app móvel na documentação (/api/pedagogic/…, sem /v1).
Sexta-feira, 12 de Junho de 2026
Notificações in-app
A plataforma passa a gerar notificações in-app automaticamente em resposta a eventos do sistema. As notificações são persistidas no banco de dados e ficam disponíveis para leitura no aplicativo mobile, sem depender de serviços de push externos.
  • Responsáveis recebem notificações para: novos recados, recados atualizados, novas aulas, aulas atualizadas, ausências, notas lançadas, ocorrências disciplinares (não confidenciais), resultado do conselho de classe, respostas no atendimento e ficha médica atualizada;
  • Coordenadores recebem notificação quando uma nova aula aguarda aprovação;
  • Secretários recebem notificações para: novos chamados de atendimento, mensagens diretas de responsáveis, atualizações de ficha médica e tentativas de check-in não autorizadas;
  • Professores recebem notificação quando um plano de curso é criado ou atualizado para uma disciplina que lecionam.
Quarta-feira, 20 de Maio de 2026
Atualizações em turmas, autorizações e novos endpoints
Novo: Calendário Letivo, Frequências, Diário de Classe, Ocorrências Disciplinares, Plano Pedagógico, Conselho de Classe;
  • As rotas dos endpoints de quadros de horário foram alteradas;
  • Novos webhooks para Quadro de Horários, Diário de Classe, Plano Pedagógico, Ocorrências Disciplinares e Conselho de Classe;
Segunda-feira, 07 de Maio de 2026
Atualizações em matrículas e novos endpoints
Novo: Autorizações;
Novos endpoints para matrículas, incluindo transferência interna, transferência externa, solicitação de atualização de status e solicitação de reativação, proporcionando uma gestão mais flexível e completa das matrículas dos alunos.
Sábado, 09 de Maio de 2026
Novos endpoints para entidades e recursos da escola
Coordenadores, Secretários, Professores, Disciplinas, Tipos de Aula, Carga Horária, Plano de Curso (BNCC), Séries e Anos, Disciplinas da Escola, Portões de Entrada da Escola, Horários de Entrada, Saída e Tolerância, Espaços Físicos da Escola, Quadro de Disponibilidade da Turma, Quadro de Disponibilidade do Professor, Quadro de Horários da Turma;
Quinta-feira, 07 de Maio de 2026
Atualizações em modelos, webhooks e novos endpoints de ano letivo
  • Novos campos adicionados ao modelo do aluno;
  • Novos campos adicionados ao modelo de escola;
  • Novas informações disponíveis nos webhooks de aluno;
  • Ano Letivo: Novos endpoints disponíveis;
Quinta-feira, 30 de Abril de 2026
Novos endpoints de responsáveis
Adicionados novos endpoints para vincular e desvincular responsáveis legais e adicionais aos alunos, proporcionando uma gestão mais flexível e completa das informações dos estudantes.
Quinta-feira, 30 de Abril de 2026
Versão 1.0
Lançamento oficial da API To Aqui Escola, oferecendo uma ampla gama de endpoints para integração. A versão 1.0 inclui funcionalidades essenciais para gerenciamento de alunos, turmas, frequência, responsáveis, eventos entre outros, proporcionando uma base sólida para que desenvolvedores integrem suas aplicações com a plataforma To Aqui Escola.