CSV Integration Schema: Meal Plans
Last updated: October 5, 2026
Two files cover dining. Meal Plans defines the plans available; Meal Plan Assignments records which student holds which plan. Included only when dining is in scope.
Meal Plan Assignments
| Column | Type | Required | Notes |
|---|---|---|---|
sisId |
string | Yes | |
schoolEmail |
string | Yes | |
name |
string | Yes | Must match the Meal Plan name in Housing.Cloud |
externalId |
string | No | Populated if configured in Housing.Cloud |
dateStart / dateEnd
|
date | Yes | |
externalTermId |
string | No | Populated if the Cycle has one configured |
secondaryExternalId |
string | No | Requires the includeSecondaryExternalId data mapping |
Meal Plans (Definitions)
| Column | Type | Required | Notes |
|---|---|---|---|
name |
string | Yes | Human-friendly name |
externalCode |
string | No | Should match the meal-plan code in the SIS |
details |
string | Yes | Additional information |
costCode |
string | Yes | Must match a preexisting Charge Code name |
Delivery
Assignments egress: mealplanassignments_yyyy_mm_dd_{uuid}.csv
Definitions ingress: mealplans_…
Ethos equivalent: meal-plan-assignments / meal-plans (v16).