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

#	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	integer	REQ’D	The identifier assigned to an education organization.	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/Type

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": "2023-06-09",
    "_ext": {
      "wi": {
        "localPersonIdentificationCode": "WDPID - 40218"
      }
    },
  }