/courseOfferings

All course offerings that are part of the student schedule should be submitted to WISEdata Portal.

This endpoint is NOT expected from Choice schools.

Ed-Fi Tech Docs: https://techdocs.ed-fi.org/display/EDFICERT/v3+Master+Schedule+%3E+CourseOffering

Data Properties:

#	Property Name	Data Type	Public (Required/ Optional/ Conditional)	Choice (Required/ Optional/ Conditional)	Business Definition	Data Element Page
1.0	localCourseCode	string	REQ’D	NOT REQ’D	The local code assigned by the School that identifies the course offering provided for the instruction of students.	Local Course Code
2.0	courseReference	array
3.0	courseCode	string	REQ’D	NOT REQ’D	A unique alphanumeric code assigned to a course.	Courses
4.0	educationOrganizationId	integer	REQ’D	NOT REQ’D	The identifier assigned to an education organization.	Education Organization Reference
5.0	schoolReference	array
6.0	schoolId	integer	REQ’D	NOT REQ’D	The identifier assigned to a school.	School Reference
7.0	sessionReference	array				Session Reference
8.0	schoolId	integer	REQ’D	NOT REQ’D	The identifier assigned to a school.	Session School Reference
9.0	schoolYear	integer	REQ’D	NOT REQ’D	The identifier for the school year.	School Year
10.0	sessionName	string	REQ’D	NOT REQ’D	The identifier for the calendar for the academic session (e.g., 2010/11, 2011 Summer).
11.0	localCourseTitle	string	OPT	NOT REQ’D	The descriptive name given to a course of study offered in the school, if different from the CourseTitle.	Local Course Title
12.0	careerPathways	array			An unordered collection of courseOfferingCareerPathways. The career cluster or pathway representing the career path of the Vocational/Career Tech concentrator.
13.0	careerPathwayDescriptor	string	CONDITINALLY REQ'D	NOT REQ’D	The career cluster or pathway representing the career path of the Vocational/Career Tech concentrator. If a course is a Career Technical Education then submit the career cluster or pathway representing the career path of the course offered.	Cluster Title
14.0	courseLevelCharacteristicDescriptor	string	OPT	NOT REQ’D	The type of specific program or designation with which the course offering is associated (e.g., Honors). This collection should only be populated if it differs from the course level characteristics identified at the course level.

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 a course that’s offered in multiple semesters

Schools generally create courses based on credit allocation. For example:

Calculus is offered in both 1st and 2nd semesters in a school year, meaning a batch of students take this course in the first semester and get a credit at the end of the semester, and another batch of students take the course in the second semester and they get a credit at the end of this semester. In this case, courseOfferings should be created separately for both the semesters using 1st semester and 2nd semester descriptors respectively.
Calculus is offered as an annual course, meaning a batch of students take the course throughout the entire year. The student receives a credit at the end of the year. In this case, one courseofferering should be created with the annual descriptor.
So it depends on how credits are allocated, even though we do not collect credits.

If a course is a Career Technical Education, then submit the career cluster or
pathway representing the career path of the course offered. Get the Career Pathway from the careerPathwayDescriptor.

Prerequisite: To be able to submit the /courseOfferings endpoint, the /sessions endpoint should be submitted first (CourseOffering has session reference)

POST on /courseOfferings:
courseReference:
educationOrganizationId: 48856
courseCode: 12194
schoolReference
schoolId: 7525
sessionReference
schoolId: 7525
schoolYear: 2021
sessionName: Sessions-121941
localCourseCode: LCC-121941
localCourseTitl: LCT-121941
EXT:
WI: careerPathways:
careerPathwayDescriptor: uri://dpi.wi.gov/CareerPathwayDescriptor#4

JSON Sample:

{
	"courseReference": {
      "educationOrganizationId": 48856,
      "courseCode": "12194",
},
    "schoolReference": {
      "schoolId": 6,
},
    "sessionReference": {
      "schoolId": 6,
      "schoolYear": 2020,
      "sessionName": "Sessions-12194",
},
       "localCourseCode": "LCC-12194",
       "localCourseTitle": "LCT-12194",
    "_ext": {
      "Wi": {
        "careerPathways": [
          {
            "careerPathwayDescriptor": "uri://dpi.wi.gov/CareerPathwayDescriptor#4"
          },
         {
            "careerPathwayDescriptor": "uri://dpi.wi.gov/CareerPathwayDescriptor#2"
          }
        ]
      }
    }
  }