Versions Compared

Key

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

...

xxx

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.

(blue star) This endpoint is NOT expected from Choice schools.

...

Expand
titleClick 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

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.

https://dpi.wi.gov/wise/data-elements/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.09.0

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

...

Use Cases:

Expand
titleClick 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" }

...

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