Reporting parent and guardian information to WISEdata Portal helps enable WISEdata to integrate with more services, including the Wisconsin eSchool Network, food service programs and some special education vendors. This is an optional data collection, but highly recommended
Starting the 2023-24 SY, vendors are required to program the /parents and /studentParentAssociations endpoints to allow LEAs to report the report parent and guardian data to WISEdata Portal data when needed. If any LEA participates in a Food Service program in which students receive meals through these federal school meal programs, National School Lunch Program (NSLP) or the Community Eligibility Provision (CEP), these endpoints are required. WISEdata Portal has a validation message to require parent and guardian data (Name, Address) for students who qualify for free and reduced-priced meals.
This endpoint is expected from Choice schools.
...
| Expand |
|---|
| title | Click here to view all data properties under the /parent endpoint: |
|---|
|
# | Property Name | Data Type | Public (Required/ Optional/ Conditional) | Choice (Required/ Optional/ Conditional) | Business Definition | Data Element Page | 1.0 | parentUniqueId* | string | REQ'D | REQ'D | A unique alphanumeric code assigned to a parent. parentUniqueId: [LEA ID+’-’+parent unique ID in SIS system] | https://dpi.wi.gov/wise/data-elements/parent-guardian-wisedata | 2.0 | firstName | string | REQ'D | REQ'D | A name given to an individual at birth, baptism, or during another naming ceremony, or through legal change. | NA | 3.0 | middleName | string | OPT | OPT | A secondary name given to an individual at birth, baptism, or during another naming ceremony. | NA | 4.0 | LastSurname | string | REQ'D | REQ'D | The name borne in common by members of a family. | NA | 5.0 | generationCodeSuffix | string | OPT | OPT | An appendage, if any, used to denote an individual's generation in his family (e.g., Jr., Sr., III). | NA | 6.0 | parentAddress | arrayOPT | CONDITIONALLY REQ’D | OPTCONDITIONALLY REQ’D | An unordered collection of parentAddresses. Parent's address, if different from the student address and/or [Placeholder] when the student's Economically Disadvantaged Type (FRAN) is either 'Free' or 'Reduced'. | NA | 7.0 | addressTypeDescriptor | stringOPT | CONDITIONALLY REQ’D | OPTCONDITIONALLY REQ’D | The type of address listed for an individual or organization. For example: Physical Address, Mailing Address, Home Address, etc.)Values are: Mailing, and Home. | NA | 8.0 | streetNumberName | stringOPT | CONDITIONALLY REQ’D | OPTCONDITIONALLY REQ’D | The street number and street name or post office box number of an address. | NA | 9.0 | apartmentRoomSuiteNumber | stringOPT | CONDITIONALLY REQ’D | OPTCONDITIONALLY REQ’D | The apartment, room, or suite number of an address. | NA | 10.0 | city | stringOPT | CONDITIONALLY REQ’D | OPTCONDITIONALLY REQ’D | The name of the city in which an address is located. | NA | 11.0 | stateAbbreviationDescriptor | stringOPT | CONDITIONALLY REQ’D | OPTCONDITIONALLY REQ’D | The abbreviation for the state (within the United States) or outlying area in which an address is located. | NA | 12.0 | postalCode | stringOPT | CONDITIONALLY REQ’D | OPTCONDITIONALLY REQ’D | The five or nine digit zip code or overseas postal code portion of an address. | NA | 13.0 | parentElectronicMail | array | OPT | OPT | An unordered collection of parentElectronicMails. The numbers, letters, and symbols used to identify an electronic mail (e-mail) user within the network to which the individual or organization belongs. | NA | 14.0 | electronicMailTypeDescriptor | string | OPT | OPT | The type of email listed for an individual or organization. Values are: Home/Personal, or Work | NA | 15.0 | electronicMailAddress | string | OPT | OPT | The electronic mail (e-mail) address listed for an individual or organization. | NA | 16.0 | parentLanguage | array | OPT | OPT | An unordered collection of parentLanguages. The language(s) the individual uses to communicate. It is strongly recommended that entries use only ISO 639-2 language codes. | NA | 17.0 | languageDescriptor | string | OPT | OPT | A specification of which written or spoken communication is being used. | NA | 18.0 | parentTelephone | array | OPT | OPT | An unordered collection of parentTelephones. The 10-digit telephone number, including the area code, for the person. | NA | 19.0 | telephoneNumberTypeDescriptor | string | OPT | OPT | The type of communication number listed for an individual or organization. Values are: Mobile (M); Home (H); Work (W); and Other (O). | NA | 20.0 | telephoneNumber | string | OPT | OPT | The telephone number including the area code, and extension, if applicable. | NA |
|
...
| Expand |
|---|
| title | Click here to view all descriptors for the /parent endpoint: |
|---|
|
|
...
| Expand |
|---|
| title | Click here to view all the use cases pertaining to the /parent endpoint: |
|---|
|
# | Use Case Title | Use Case Description | What to Submit/retrieve |
|---|
1.0 | Sending parent/guardian information for each parent/guardian | The parent/guardian data collection is optional for LEAs to submit to WISEdata. The vendor authorization is based on that LEA ID prefix (e.g. 5006058-JS007), which is the LEA ID in the target year, i.e. 2021-22 SY. The order for posting JSON is: /student, /studentSchoolAssociation, /parent, then /studentParentAssociation The First Name, Last Name, and Parent Unique ID are required data properties. Other data properties are optional. Without posting the /studentParentAssociation record, vendor cannot do a GET on /parent The /Parent record cannot be updated until the /studentParentAssociation record is posted.
| POST on /parents:
parentUniqueId : EdFiLEAid+’-’+’parentuniqueidinSISsystem
firstName:
lastSurname:
middleName:
generationCodeSuffix: I through XV, Sr, Jr, and SJ (trailing punctuation must be removed from the from the string)
addresses:
addressTypeDescriptor: Home; and Mailing
city
postalCode
stateAbbreviationDescriptor
streetNumberName
apartmentRoomSuiteNumber
electronicMails:
electronicMailTypeDescriptor: Home/Personal; and Work
electronicMailAddress
languages:
languageDescriptor
telephones
telephoneNumber
telephoneNumberTypeDescriptor: Mobile; Home; Work; and Other |
|---|
2.0 | Submit the student's parent/guardian information for Milwaukee School District (This only applies to vendors that support Carmen Schools and Milwaukee College Prep 'MCP') | Milwaukee School District uses three different SIS vendors. Therefore, vednors supporting Carmen and MCP schools will need to included something to differentiate the parents from MPS and each other. SIS vendors can use the individual Schoolid as part of the ParentUniqueId, but they would need to appropriately handle students moving between their schools. Otherwise, they could pick a single SchoolId, or 'Carmen'/'MCP', or 'PowerSchool'/'Skyward', or anything else that would make sense, such as a tenant number if available in the SIS.
| Student's /parent and /StudentParentAssociation endpoints is successfully submitted with the Parent Unique ID may be as follows: Ed-Fi LEA ID +'-'+'Differentiating Factor'+'-'+ Parent Unique ID in SIS System Differentiating Factor: Something that uniquely identifies the parent within the SIS and is not also used by another SIS to identify parent in the same district. |
|---|
3.0 | Sending parent/guardian information when they more than one students in the same LEA | | |
|---|
34.0 | Sending parent/guardian information when they have multiple addresses | Parents/guardians could have multiple households and multiple address. DPI only requires primary home address and mailing address of parent/guardian if different than the home address. Every school district has a different process for parent data sharing agreement. However, parents/guardians can choose to opt-in or opt-out of the agreement. By law, parents/guardians always have the right to opt-out at any time of the school year. Until they opt-out default is opt-in for data sharing which includes address as well. | POST on /parents:
addresses:
addressTypeDescriptor : Home
city
postalCode
stateAbbreviationDescriptor
streetNumberName
apartmentRoomSuiteNumber addressTypeDescriptor : Mailing
city
postalCode
stateAbbreviationDescriptor
streetNumberName
apartmentRoomSuiteNumber | 4 |
|---|
5.0 | Sending the address for a parent who opted out of address data sharing | If opt-out from data sharing happened before submitting address to WISEdata, then do NOT submit student address to WISEdata. If opt-out from data sharing happens after submitting address to WISEdata, then delete the address of student from API.
DPI may share parents addresses with the WI Depertment of Health Services (DHS) for immunization matching purposes. If districts opts-out of using immunization services, then student addresses is not passed to DHS. | |
|---|
6.0 | Sending parent/guardian information when student transferres transferred to a new LEA | Because the parentUniqueId includes the LEA ID, each LEA is expected to send /parent AND /studentParentAssociation records | LEA 1: submits a /Parent record AND a /studentParentAssociation record AND LEA 2: submits a /Parent record AND a /studentParentAssociation record |
|---|
57.0 | Updating parent/guardian information for a student | There is an Ed-Fi issue when SIS vendors do a POST->GET->DELETE->POST on /parent using the same unique id. This issue appears to be a problem for v3.4, but not for v5.2. Instead of deleting a /parent record, vendors should update (PUT) the rcords with the changes. | |
|---|
|
...