/staffEducationOrganizationEmploymentAssociation

The StaffEducationOrganizationEmploymentAssociation entity primarily represents the financial relationship between an individual (such as an employee, contractor, volunteer, or other service provider) and the educational organization responsible for paying them.

This endpoint is NOT expected from Choice schools.

Ed-Fi Tech Docs:

Data Properties:

Click here to view all data properties under the /staffEducationOrganizationEmploymentAssociation endpoint: LIST OF DATA ELEMENTS FROM GET OR POST OR??

#	Property Name	Data Type	Public (Required/ Optional/ Conditional)	Business Definition	Data Element Page
1.0	localPersonIdentificationCode	string	REQ’D	A unique number or alphanumeric code assigned to a staff member by a school or school system.	https://dpi.wi.gov/wise/data-elements/local-person-id
2.0	employmentStatusDescriptor	string	REQ’D	Reflects the type of employment or contract.
3.0	hireDate	string	REQ’D	The month, day, and year on which an individual was hired for a position.
4.0	educationOrganizationId	integer	REQ’D	The identifier assigned to an education organization.
5.0	staffUniqueId	string	REQ’D	A unique alphanumeric code assigned to a staff.	https://dpi.wi.gov/wise/data-elements/WISEid
6.0	credentialIdentifier	string	REQ’D	Identifier or serial number assigned to the credential.
7.0	stateOfIssueStateAbbreviationDescriptor	string	REQ’D	The abbreviation for the name of the state (within the United States) or extra-state jurisdiction in which a license/credential was issued.
8.0	endDate	string	REQ’D	The month, day, and year on which a contract between an individual and a governing authority ends or is terminated under the provisions of the contract (or the date on which the agreement is made invalid).

Use Cases:

Click here to view all the use cases pertaining to the /staffEducationOrganizationEmploymentAssociation endpoint:

#

Use Case Title

Use Case Description

What to Submit/retrieve

1.0

Sending the staff’s primary Local Person ID

The Local Person ID should be a required field in SIS (Error 7145 will dispay in WISEdata when missing)
The Local Person ID must be different than the Staff WISEid.
The Local Person ID must be the same in three places:

1- on /staffEducationOrganizationEmploymentAssociation.
2- WISEid Person Upload/Download CSV file process
3- on /Identities for the Staff Identity Integration (if implemented by SIS)

POST on /staffEducationOrganizationEmploymentAssociation

2.0

Sending the staff’s secondary Local Person ID

The Local Person ID should be a required field in SIS (Error 7145 will dispay in WISEdata when missing)
The Local Person ID must be different than the Staff WISEid.
The Local Person ID must be the same in three places:

1- on /staffEducationOrganizationEmploymentAssociation.
2- WISEid Person Upload/Download CSV file process
3- on /Identities for the Staff Identity Integration (if implemented by SIS)

POST on /staffEducationOrganizationEmploymentAssociation

3.0

Sending staff’s employment association when /staff record is NOT available.

Assuming that /staff record is NOT available, and the vendor created a staffEducationOrganizationEmploymentAssociation record to post staffSectionAssociation

POST /staffEducationOrganizationEmploymentAssociation

THEN

POST on /staffSectionAssociation
{ "sectionReference": { "schoolId": 7525, "localCourseCode": "LCC-121941", "schoolYear": 2021, "sectionIdentifier": "Section-121941", "sessionName": "Sessions-121941" }, "staffReference": { "staffUniqueId": "1001001001" }, "classroomPositionDescriptor": "uri://dpi.wi.gov/ClassroomPositionDescriptor#03187", "beginDate": "2020-07-01", "endDate": "2021-06-05" }

JSON Sample:

JSON sample for /staffEducationOrganizationEmploymentAssociation:

{
  	"educationOrganizationReference": {
      "educationOrganizationId": 39604,
  	},
   "staffReference": {
      "staffUniqueId": "6238514877",
   },
    "employmentStatusDescriptor": "uri://ed-fi.org/EmploymentStatusDescriptor#Tenured or permanent",
    "hireDate": "2023-06-09",
    "_ext": {
      "wi": {
        "localPersonIdentificationCode": "WDPID - 40218"
      }
    },
  }