AVKUL ERPDocs
MODULE GUIDE · 11 OCT 2026

Year-end rollover

Preview new-session student placement and apply or revert a recorded promotion batch.

Try guided demo →Download guide ↓
Year-end rollover — illustrated workflow banner
OVERVIEW

What you can do

01

Rollover preview

02

Structure clone

03

Promotion commit

04

Batch history

05

Revert

06

Enrollment history

BEFORE YOU BEGIN

Access & setup

Intended access: Assigned account with the required permissions.

  • An assigned school account with the required permissions.
  • The academic, student or staff setup used by this workflow.
Required permission keys
promotion:viewpromotion:createpromotion:managepromotion:deletestudent:view

Use the public sample demo to learn this flow. Your assigned ERP account determines access to actual school records.

STEP BY STEP

How the workflow works

  1. 01

    Choose the source and target academic sessions

    An assigned school account with the required permissions.

  2. 02

    Clone or prepare the target class structure

    Structure clone is part of the documented workflow.

  3. 03

    Review the dry-run placement and exceptions

    Promotion commit is part of the documented workflow.

  4. 04

    Commit only the reviewed batch and keep its reversal reference

    Review the result in the connected record or workspace before moving on.

Request fields to understand

Source-declared fields used by related operations; each operation has its own validation and scope.

FieldDeclared typeInput
fromSessionIdstringRequired by declaration
toSessionIdstringRequired by declaration
criteriaPromotionCriteriaDtoOptional
includeTimetablesbooleanOptional
decisionsStudentDecisionDto[]Required by declaration
activateTargetSessionbooleanOptional
notesstringOptional
graduationYearnumberOptional
CURRENT BEHAVIOUR

Rules & current limits

  • Preview writes nothing; commit changes enrollment. Locked sessions and school ownership checks still apply.

Source inventory checked on 11 October 2026. Guide availability confirms documentation publication, not certification of every external service or device flow.

LEARN BY DOING

Try year-end rollover

Open a guided sample workspace, try the available actions, then reset whenever you like. No login required.

Launch guided demo →
FOR IMPLEMENTERS

API & permissions reference

This is the module’s source-declared endpoint catalogue. Reading this reference does not execute any request.

6 source-declared operations
POST/api/v1/promotions/preview

Dry-run a rollover — writes nothing

promotion:view

Declared request fields: fromSessionId (required), toSessionId (required), criteria (optional).

POST/api/v1/promotions/clone-structure

Copy classes/sections/subjects into the new session

promotion:create

Declared request fields: fromSessionId (required), toSessionId (required), includeTimetables (optional).

POST/api/v1/promotions/commit

Apply the rollover (transactional)

promotion:manage

Declared request fields: fromSessionId (required), toSessionId (required), decisions (required), activateTargetSession (optional), notes (optional), graduationYear (optional).

POST/api/v1/promotions/batches/:id/revert

Revert

promotion:delete
GET/api/v1/promotions/batches

Batches

promotion:view
GET/api/v1/promotions/enrollments

Per-session placement history for a student

student:view

Open the actual application

ERP links use your assigned account. Record-specific pages start from the list so you can choose a real record.

/en/school/promotionOpen ↗

Keep exploring

Screen guideYear-end rollover →