Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleClick here to view all the use cases pertaining to the /studentSchoolAssociation endpoint:

#

Use Case Title

Use Case Description

What to Submit/retrieve

Starting the 24/25 SY, discontinue submitting K3 data through the API. K3 is not the same as K4 or PK Birth to 3 programs.

Informational Only

Verify not sending K3

1.0

Sending a student enrollment record for a student who’s primarily attending a public school district or a charter school

  • Many students receive services from one school in one district or charter school. For these students the identification of primary enrollment is simple.

  • The order for posting a student enrollment is: /student, /studentschoolAssociation, then /StudentEducationOrganizationAssociation. Without posting /studentschoolAssociation you cannot do a GET on /student.

The public district/charter school submits a primary enrollment.

POST on /studentSchoolAssociations:
primarySchool: True
enrollmentTypeDescriptor: uri://dpi.wi.gov/EnrollmentTypeDescriptor#P

2.0

Sending the Resident Local Education Agency (LEA) (2023-24 and later)

Prior to 2023-24, Resident LEA ID is submitted under /SEOA.

Starting the 23/24SY, the Resident LEA ID will be part of the /studentSchoolAssociation (SSA) endpoint under the ResidencyPeriod collection.

When the submitting district is an independent charter school (non-district charter school), then the Resident LEA is set to a public school district that is open in the school year.

The Resident LEA ID cannot be a School ID.

For more details see about how this affect the pupil count for membership report, see Pupil Count Report for Membership

POST on /studentSchoolAssociation

residencyPeriods:
residencyStatusDescriptor: R
beginDate: 2023-09-05
endDate: 2024-06-30
residentLocalEducationAgencyReference:
localEducationAgencyId: 7738

3.0

Sending the Enrollment Type to WISEdata Portal

The enrollmentTypeDescriptor will be a single-value data property, not an array. SIS vendor will need to update their code to reflect the change.

Values for the enrollmentTypeDescriptor include:

  • P: Primary

  • PPP: Parent Placed Private

  • C: Coursework

  • M: Membership

enrollmentTypeDescriptor is a single-value data property:

_EXT:
WI:
enrollmentTypeDescriptor: uri://dpi.wi.gov/EnrollmentTypeDescriptor#P

4.0

Submit a primary enrollment record for a student that completed the most recent school term (year)
Regression Test

In the 2020-21 SY, the completedSchoolTerm data property under the /SSA was replaced with termCompletionIndicator. The 20-21 SY is disabled in WISEdata; therefore, the completedSchoolTerm will be removed from WISEdata UI.

SIS vendors must ensure that the termCompletionIndicator is submitted to WISEdata Portal.

Successfully POST data on /studentSchoolAssociations:

termCompletionIndicator: True

5.0

Submit a Term Completion Indicator for a student with multiple enrollment records
Regression Test

The Term Completion Indicator is only expected on the most recent enrollment record for the school term.

Informational only

6.0

Submit a non-primary enrollment record for a student that completed the most recent school term (year)
Regression Test

The Term Completion Indicator is not required - L2 rule (6569) will be thrown when submitted.

Informational only

7.0

Sending a student enrollment record for a student who’s primarily attending a private choice school that chooses to report all students (All Students Report Card: Opt IN)

The opt in/out status for the Private School – All Students Report Card indicates whether a school would like to have just the Choice students included in the required report card or if they would like all of their students to be included in a report card.  Visit this page to learn more: https://dpi.wi.gov/parental-education-options/choice-programs/school-reports

If a school chooses to report all students, then they have to report both Choice and non-Choice students:

  • For students who meet Choice school requirements and should be reported, send privateSchoolChoiceProgramParticipant as Yes/True.

  • For students who don't meet Choice school requirements and should not be reported, send privateSchoolChoiceProgramParticipant as No/False

NOTE: Choice schools are not expected to send a non-primary enrollment type. Enrollments from Choice schools should always be primary.

The private choice school submits a primary enrollment.

POST on /studentSchoolAssociations:
primarySchool: True
enrollmentTypeDescriptor: uri://dpi.wi.gov/EnrollmentTypeDescriptor#P
privateSchoolChoiceProgramParticipant: False/True

8.0

Sending a student enrollment record for a student who’s primarily attending a private choice school that chooses to report only Choice students (All Students Report Card: Opt OUT)

If a school is opted out of the Private School – All Students Report Card, then they should not send non-Choice students should to WISEdata.

The private choice school submits a primary enrollment.

POST on /studentSchoolAssociations:
primarySchool: True
enrollmentTypeDescriptor: uri://dpi.wi.gov/EnrollmentTypeDescriptor#P
privateSchoolChoiceProgramParticipant: True

9.0

Sending a student enrollment record when the student’s choice program participant status changes in the middle of the school year due to determination of ineligibility AND the school is opted OUT of private school – All students report card.

Students may be determined ineligible through the choice audit and they may lose their Choice status. If the determination is that the student was never eligible, then the school has to delete the enrollment (and other records).

DELETE on /studentSchoolAssociations

10.0

Sending a student enrollment record when the student’s choice program participant status changes in the middle of the school year due to determination of ineligibility AND the school is opted IN of private school – All students report card.

If a student determined never eligible to the choice program, then the school should change the privateSchoolChoiceProgramParticipant in the existing SSA record to No/False.

PUT on on /studentSchoolAssociations to change the privateSchoolChoiceProgramParticipant from True to False.

11.0

Sending a student enrollment record when the student’s choice program participant changes in the middle of the school year because the student/family chose to no longer participate in the Choice program but remain in the same school. And the AND the school is opted IN of private school – All students report card.

If there is a change in the student's Choice program participant status, then a new SSA with a new PrivateSchoolChoiceProgramParticipant value is appropriate.

If the the school is opted OUT of private school – All students report card, then the school should not report a non-choice student, and will just report one studentSchoolAssociation record for when the student was a choice program participant.

PUT on /studentSchoolAssociations to end the existing record.

POST on /studentSchoolAssociations to send a new enrollment record with privateSchoolChoiceProgramParticipant as False

12.0

Sending a student enrollment record for a student who’s attending a private choice school, and receiving special education services in a public school district

  • The Choice school submits a primary enrollment and the associated student data (Demographics, Food Service, Academic Record, etc.)

  • The public district submits a non-primary Parent Placed Private (PPP) enrollment with a Demographics record (studentEducationOrganizationAssociation) and a Special Education record (studentSpecialEducationProgramAssociation).

    • Districts should not send attendance data, exitWithdraw Type, Term Completion Indicator, and Expected Transfer data.

    • Districts should not be sending Coursework for PPP students

    • Districts should not send Food Service, Academic Record, CTE, Discipline, Homeless, and LIEP data

  • LEAs can only have one enrollment type per school for a given enrollment period

Choice School:
POST on /studentSchoolAssociations:
entryDate: 2021-08-23
primarySchool: True
enrollmentTypeDescriptor: uri://dpi.wi.gov/EnrollmentTypeDescriptor#P
exitWithdrawDate: 2022-06-30
exitWithdrawTypeDescriptor: uri://dpi.wi.gov/ExitWithdrawTypeDescriptor#TC
entryGradeLevelDescriptor: uri://dpi.wi.gov/GradeLevelDescriptor#10
termCompletionIndicator: True
actualDaysAttendance: 150
possibleDaysAttendance: 149.5

Public School:
POST on /studentSchoolAssociations:
entryDate: 2021-08-23
primarySchool: False
enrollmentTypeDescriptor: uri://dpi.wi.gov/EnrollmentTypeDescriptor#PPP
exitWithdrawDate: 2022-06-30
entryGradeLevelDescriptor: uri://dpi.wi.gov/GradeLevelDescriptor#10

13.0

Sending a student enrollment record for a student who’s taking coursework in multiple public schools

  • The primary school district submits an Primary Enrollment record and all associated student data (SEOA, SAR, SSEPA, SSFSPA, etc.)

    • The primary district should send student concentrator details even if majority of CTE courses are taken at Non-Primary district.

  • The non-primary school district submits an Enrollment record (studentSchoolAssociation), a Demographics record (studentEducationOrganizationAssociation), Course Offering , Sections, Student Sections, and Grades.

    • The non-primary district should not send attendance data, exitWithdraw Type, Term Completion Indicator, and Expected Transfer data.

    • The non-primary district should not send Food Service, Academic Record, CTE, Discipline, Homeless, and LIEP data

    • If a discipline incident occurs at the Non-Primary school, DPI expects the Primary school to submit the discipline information and have the discipline counted under the primary school. The Primary school is expected as the responsible school (unless FAPE responsible school transfers accountability).

Public School A:

POST on /studentSchoolAssociations, studentEducationOrganizationAssociation, studentSchoolFoodServicesProgramAssociation, studentSpecialEducationProgramAssociation, studentSectionAssociation, StudentCTEProgramAssociation, etc.

Public School B:

POST on /studentSchoolAssociations, studentEducationOrganizationAssociation, courseOffering, section, studentSectionAssociation, and grade

14.0

Sending a student enrollment record for a student who’s primarily enrolled in a Choice school, and taking one or two courses from a public district.

  • The Choice school sends a primary enrollment and associated student data.

  • The Public district does not send student information to WISEdata or WISEid as Choice schools do not participate in the Roster collection.

Choice School:
POST on /studentSchoolAssociations:
entryDate: 2022-08-22
primarySchool: True
enrollmentTypeDescriptor: uri://dpi.wi.gov/EnrollmentTypeDescriptor#P
exitWithdrawDate: 2023-06-30
exitWithdrawTypeDescriptor: uri://dpi.wi.gov/ExitWithdrawTypeDescriptor#TC
entryGradeLevelDescriptor: uri://dpi.wi.gov/GradeLevelDescriptor#11
termCompletionIndicator: True
actualDaysAttendance: 170
possibleDaysAttendance: 169

15.0

Sending a student enrollment record for a student who’s enrolled in a Charter school, and taking courses in non-charter school within the same district

The charter school is considered the primary enrollment regardless of which school provides more courses.

  • The charter school sends primary Enrollment, associated student data, and Roster data from the charter school

  • The non-charter school submsends ts a non-primary Coursework enrollment and coursework taken from the non-charter school.

Charter School

POST on /studentSchoolAssociations, studentEducationOrganizationAssociation, studentSchoolFoodServicesProgramAssociation, studentSpecialEducationProgramAssociation, studentSectionAssociation, StudentCTEProgramAssociation, etc.

Non-Charter School B:

POST on /studentSchoolAssociations, studentEducationOrganizationAssociation, courseOffering, section, studentSectionAssociation, and grade

16.0

Sending a student enrollment record for a student who’s enrolled in a school within the Department of Corrections, the Department of Health Services, or a CCDEB school

These organizations sends primary Enrollment, associated student data, and Roster data to WISEdata

  • These organizations are not required to submit non-primary Coursework enrollments. We do not expect a student to take one or two classes from schools of this type.

POST on /studentSchoolAssociations, studentEducationOrganizationAssociation, studentSchoolFoodServicesProgramAssociation, studentSpecialEducationProgramAssociation, studentSectionAssociation, etc

17.0

Sending Receiving Services when the student enrollment Entry Date is post 3rd Friday of Sept or Oct 1

For a child to count on a count date, the student must have been enrolled in the school wishing to count the student. If the student isn’t enrolled on TFS or Oct. 1, the child cannot be counted.

October 1 Child Count is NOT gathered from Choice schools.

NOTE: The count date has no impact on the requirement for the studentSchoolAssociations (enrollment) tobe submitted to WISEdata.

POST on /studentSchoolAssociations:
entryDate: 2022-10-23
receivingServices: Blank

18.0

Sending Receiving Services when the Count Date falls on a weekend or a non-attendance day

If October 1 falls on a weekend or either count dates (Oct 1 or 3rd Fri of Sept) is a non attendance day, e.g., staff professional development day, then preceding or following attendance day surrounding the non-attendance date may be used to determine the value of ‘Present’ versus ‘Absent’ for Receiving Services

POST on /studentSchoolAssociations:
entryDate: 2022-08-22
receivingServices:
countDateNameDescriptor: uri://dpi.wi.gov/CountDateNameDescriptor#3FS
countDateReceivingServiceDescriptor: uri://dpi.wi.gov/CountDateReceivingServiceDescriptor#P
countDateNameDescriptor: uri://dpi.wi.gov/CountDateNameDescriptor#O1
countDateReceivingServiceDescriptor: uri://dpi.wi.gov/CountDateReceivingServiceDescriptor#A

19.0

Sending Receiving Services when the for a student who transferred districts during the count date

When a student transfers to a new district/school around the count date time, then only the school with the student enrolled on the count date can count the student.

The WISEdata Effective Date logic allows the second district to receive credit for the count.

20.0

Sending Receiving Services when the student is enrolled, but NOT actively receiving educational services.

When a student is NOT receiving services from the district / school, then the student should be exited in WISEdata. This is necessary to maintain accurate Full Academic Year indicators and to identify students expected to participate in assessments.

The code ‘N - Not receiving services' should NOT be used except in the scenarios of a terminally ill student, an abducted student, or similarly dire circumstance for which the student is being held in enrollment so that the school does not have to prematurely report the exit type of ‘Death’ or 'Compassion Exit’.

POST on /studentSchoolAssociations:
entryDate: 2022-08-22
receivingServices:
countDateNameDescriptor: uri://dpi.wi.gov/CountDateNameDescriptor#3FS
countDateReceivingServiceDescriptor: uri://dpi.wi.gov/CountDateReceivingServiceDescriptor#N

21.0

Updating the Entry Date of the enrollment

The Entry Date is a primary key so vendors will need to insert a new studentSchoolAssociation record with the updated entryDate, then delete the old studentSchoolAssociation record.

22.0

Updating the Exit Date and Exit Type of the enrollment (2022-23 and after)

Simply updating the exitWithdrawDate and ExitWithdrawTypeDescriptor for an existing studentSchoolAssociation record.

  • Starting 2022-23 SY, DPI will no longer accept Prior Completion Credential (PCC) as an ExitWithdrawTypeDescriptor.

  • Also, starting 2022-23 SY, DPI will start collecting Compassion Exit (CE) as an ExitWithdrawTypeDescriptor.

POST on /studentSchoolAssociations:
exitWithdrawTypeDescriptor: uri://dpi.wi.gov/ExitWithdrawTypeDescriptor#CE

23.0

Sending multiple student enrollment records in the same LEA

  • Overlap of enrollment records is not expected

  • The Term Completion Indicator is only expected on the most recent enrollment record for the school term.

    • When the Term Completion Indicator is not required, L2 rule (6569) will be displayed in WISEdata.

  • Only the school with the student enrolled on the count date can count the student. If for some reason the student has any gap of enrollment between transferring districts, even if just over the weekend, no school is able to count the child for the count date.

School A:
POST on /studentSchoolAssociations:
entryDate: 2021-08-23
exitWithdrawDate: 2021-09-24
exitWithdrawTypeDescriptor: uri://dpi.wi.gov/ExitWithdrawTypeDescriptor#TC
termCompletionIndicator: False
receivingServices:
countDateNameDescriptor: uri://dpi.wi.gov/CountDateNameDescriptor#3FS
countDateReceivingServiceDescriptor: uri://dpi.wi.gov/CountDateReceivingServiceDescriptor#P

School B:

POST on /studentSchoolAssociations:
entryDate: 2021-09-27
exitWithdrawDate: 2022-106-30
exitWithdrawTypeDescriptor: uri://dpi.wi.gov/ExitWithdrawTypeDescriptor#TC
termCompletionIndicator: True
receivingServices:
countDateNameDescriptor: uri://dpi.wi.gov/CountDateNameDescriptor#O1
countDateReceivingServiceDescriptor: uri://dpi.wi.gov/CountDateReceivingServiceDescriptor#A

24.0

Sending a student enrollment record when student is expected to transfer

When an inter-district transfer is expected, then the LEA should send the existing enrollment record with exitWithdraw Descriptor as ‘ETC’, and the Expected Transfer School/District.

PUT on /studentSchoolAssociations:
exitWithdrawTypeDescriptor: uri://dpi.wi.gov/ExitWithdrawTypeDescriptor#ETC
expectedTransferSchoolReference: School ID

25.0

Deleting a student enrollment record

To delete an enrollment record, all child records (/studentEducationOrganizationAssociation, /studentAcademicRecords, /studentSpecialEducationProgramAssociation, discipline data, roster data, etc.) must be deleted first.

...