/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.

Staff Employment can be posted by the vendor and read by WISEid. While it's preferred at the district level. This process is used to add staff to a district and for authorization purposes. If an assignment already exists for the district, it doesn't need to be sent again.

This endpoint is NOT expected from Choice schools.

Ed-Fi Tech Docs: Staff Domain - Overview - Ed-Fi Data Standard v4 - Ed-Fi Confluence

Data Properties:

#	Property Name	Data Type	Public (Required/ Optional/ Conditional)	Business Definition	Data Element Page
1.0	employmentStatusDescriptor	string	REQ’D	Reflects the type of employment or contract.	N/A
2.0	hireDate	string	REQ’D	The month, day, and year on which an individual was hired for a position.	N/A
3.0	educationOrganizationReference.educationOrganizationId	big integer	REQ’D	The identifier assigned to an education organization. Format change from Integer to Big Integer (2025-26 SY and later)	N/A
4.0	staffReference.staffUniqueId	string	OPT	A unique alphanumeric code assigned to a staff.	WISEid
5.0	credentialReference. credentialIdentifier	string	OPT	Identifier or serial number assigned to the credential.	N/A
6.0	credentialReference. stateOfIssueStateAbbreviationDescriptor	string	OPT	The abbreviation for the name of the state (within the United States) or extra-state jurisdiction in which a license/credential was issued.	N/A
7.0	endDate	string	OPT	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).	N/A
8.0	wi_staffEducationOrganizationEmploymentAssociationExtension. localPersonIdentificationCode	string	REQ’D	A unique number or alphanumeric code assigned to a staff member by a school or school system.	Local Person ID
9.0	StaffClassificationDescriptor	string	REQ’D

Descriptors:

Namespace	Code Value	Short Description	Long Description

Namespace	Code Value	Short Description	Long Description
uri://ed-fi.org/employmentStatusDescriptor	Contractual	Contractual	N/A
	Probationary	Probationary	N/A
	Employed or affiliated with outside organization	Employed or affiliated with outside organization	N/A
	Non-contractual	Non-contractual	N/A
	Employed part-time	Employed part-time	N/A
	Employed or affiliated with outside agency part-ti	Employed or affiliated with outside agency part-time	N/A
	Tenured or permanent	Tenured or permanent	N/A
	Substitute/temporary	Substitute/temporary	N/A
	Other	Other	N/A
	Volunteer/no contract	Volunteer/no contract	N/A
uri://dpi.wi.gov/StaffClassificationDescriptor ( Added 2026-27)	S	Staff	Staff
	U	Unknown	Unknown
credentialReference. stateOfIssueStateAbbreviationDescriptor			See the Swagger documentation for descriptor values.

Use Cases:

#	Use Case Title	Use Case Description	What to Submit/retrieve

#

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:

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