Department of Education FSA Common Record XML Schema Change Log

Description of Fields:
Version #: The release version of the fileset that includes this change.
Change #: A reference number of the change performed.
File changed: The name of the file that was changed. There should normally only be one file name per change log entry.
Description: Details on the change.
Reason: Background on the change, if necessary.

Version # Change # Date File changed Description of change Reason for change

CommonRecord1.0.xsd
1.00 0 8.24.01 CommonRecord1.0-VR.xsd first release of documents

move the DocumentId element to be

the first element in the
1.0c 1 11.02.01 CommonRecord1.0.xsd CommonRecordType cT

in the DisbursementType cT, for the

Number attribute, change the
1.0c 9 11.02.01 CommonRecord1.0.xsd maxInclusive value from 20 to 99

in the PellType cT, add

minOccurs="0" for the following
elements:
CostOfAttend, AcCal, PmtMeth,
1.0c 13 11.02.01 CommonRecord1.0.xsd VerifStatCd, EnrollDt fields are not required

in the CommonRecordType, add

minOccurs="0" for the ReportingSchl needs to be optional to allow
1.0c 14 11.02.01 CommonRecord1.0.xsd element for receipts
in the
ProgramYearReportedSummaryTyp
e cT, remove the TotAmtRep value will be broken out for
1.0c 15 11.02.01 CommonRecord1.0.xsd element awards and disbursements

in the
ProgramYearReportedSummaryTyp
e cT, add elements
TotAwardAmtRep (LargeCurrency)
and
1.0c 16 11.02.01 CommonRecord1.0.xsd TotDisbAmtRep (LargeCurrency)
in the
ProgramYearSummaryResponseTyp
e cT, remove the TotAmtRep
1.0c 17 11.02.01 CommonRecord1.0.xsd element

in the
ProgramYearSummaryResponseTyp
e cT, add elements
TotAwardAmtRep (LargeCurrency)
and
1.0c 18 11.02.01 CommonRecord1.0.xsd TotDisbAmtRep (LargeCurrency)

in the
CommonRecordResponseType cT,
add the following enumerations for
the element DocumentType:
BN = Response for Booking
Notification
PS = Response for Payment to
Servicing
PN = Response for Promissory Note
ND = Negative Disbursement
RC = Receipt
RS = Response
SG = Response for other System
1.0c 19 11.02.01 CommonRecord1.0.xsd Generated

in the LoanAwardType cT, add the

1.0c 23 11.02.01 CommonRecord1.0.xsd element AwardNum (integer, 3)

in the PLUSAwardType cT, add the

element AwardAmtRqd
1.0c 24 11.02.01 CommonRecord1.0.xsd (SmallCurrency type)

in the PersonType cT, add the

element SchlUseOnly (reference to
1.0c 25 11.02.01 CommonRecord1.0.xsd existing element)

in the PersonType cT, add

reqired="optional" for the attributes
1.0c 27 11.02.01 CommonRecord1.0.xsd DtofBirth and SSNum

Change name of ALTLoan element

to AltLoan, and ALTLoanType cT to
1.0c 40 11.02.01 CommonRecord1.0.xsd AltLoanType
 Change name of PERK element to
Perkins, and PERKType cT to
1.0c 41 11.02.01 CommonRecord1.0.xsd PerkinsType

remove the CrDecisionResponse

element in the
PLUSAwardResponseType ct,
and remove the
CreditDecisionResponseExtensionTy
pe cT,
place the child elements
CrDecisionStat
CrDecisionDt
CrOverrideInd
directly under the
1.0c 42 11.12.01 CommonRecord1.0.xsd PLUSAwardResponseType cT
removed an additional close
comment tag (-->) that wasn't
1.0c 46 11.02.01 CommonRecord1.0-VR.xsd necessary

increase the maxOccurs value for

the Disbursement element in the
following cTs to the indicated values:
CampusBasedAwardType - 52
PellType - 2000
PLUSAwardType - 400
SubAwardType - 2000
1.0c 47 11.12.01 CommonRecord1.0.xsd UnsubAwardType - 2000

in the ReportingSchlType cT, add

minOccurs="0" and
maxOccurs="unbounded" for the not needed when only sending
1.0c 48 11.12.01 CommonRecord1.0.xsd ReportedSummary element student information
in the
ReportingSchoolResponseType cT,
add the element EditResults of
1.0c 49 11.12.01 CommonRecord1.0.xsd EditResultsType
create a new cT called
AttendingSchoolResponseType, with
one element, EditResuls of type
1.0c 50 11.12.01 CommonRecord1.0.xsd EditResultsType

in the AttendingSchlType cT, add an

element named Response of type
1.0c 51 11.12.01 CommonRecord1.0.xsd AttendingSchoolResponseType

in the
ReportingSchoolResponseType cT,
add minOccurs="0" for the not needed when only sending
1.0c 52 11.12.01 CommonRecord1.0.xsd ProgYrSummary element student information

in the BorrowerType cT and

AwardType cT, remove
nillable="true" for the LDefGOver
1.0c 53 11.12.01 CommonRecord1.0.xsd element

in the LDefGOverType cT, add

nillable="true" for the AppliesTo and
1.0c 54 11.12.01 CommonRecord1.0-VR.xsd Value elements

in the BorrowerType cT and

AwardType cT, remove
nillable="true" for the LDefGOver
1.0c 53 11.12.01 CommonRecord1.0.xsd element

in the NameType cT, remove

nillable="true" for the LastName
1.0c 54 11.12.01 CommonRecord1.0.xsd element

in the EditResultType cT, set the

maximum lengths for the Field and
1.0c 55 11.12.01 CommonRecord1.0.xsd Value elements to 150

in the
ProgramYearReportedSummaryTyp
e cT, add minOccurs="0" for the
following elements:
TotAwardAmtRep,
1.0c 56 11.21.01 CommonRecord1.0.xsd TotDisbAmtRep
 in the LoanInfoType cT, add
minOccurs="0" for the following
elements:
OrigntnFeePct,
IntRebatePct,
GradeLevelInd,
AwardBeginDt,
AwardEndDt,
AcYrBeginDt,
1.0c 57 11.21.01 CommonRecord1.0.xsd AcYrEndDt

in the PersonType cT, add

minOccurs="0" for the following
elements:
Identifiers,
1.0c 58 11.21.01 CommonRecord1.0.xsd SSNum (element, not attribute)

in the LoanAwardType cT, add

minOccurs="0" for the following
elements:
LoanKey,
AwardId,
1.0c 59 11.21.01 CommonRecord1.0.xsd AwardCreateDt

in the
ProgramYearSummaryResponseTyp
e cT, add minOccurs="0" for the
following elements:
TotNumAcc
TotNumRej
TotNumCorr
TotNumDup
TotNumHeld
TotNumPartial
TotNumVerif
TotNumSSAdmin
TotAwardAmtRep
TotDisbAmtRep
TotAmtAcc
1.0c 60 11.21.01 CommonRecord1.0.xsd TotAmtCorr

in the PellAwardResponseType cT,

for the element TotEligUsed, change
the value for maxInclusive from
1.0c 61 11.21.01 CommonRecord1.0.xsd 100.999 to 999.999

in the element SchlUseOnly, add

1.0c 63 11.21.01 CommonRecord1.0-VR.xsd nillable="true"

in the Awards sT, change the

enumeration value DLPlus to
1.0c 64 11.21.01 CommonRecord1.0-VR.xsd DLPLUS

in the Awards sT, change the

1.0c 65 11.21.01 CommonRecord1.0-VR.xsd enumeration value Perk to Perkins

for the EditResults element in the

following complex types, change
maxOccurs to be 100:
CommonRecordResponseType
ResponseType
AttendingSchoolResponseType
1.0c 69 11.26.01 CommonRecord1.0.xsd ReportingSchoolResponseType

for the Response element in the

following complex types, change
maxOccurs to be 1 (remove it so it
defaults to 1):
StudentType
CampusBasedAwardType-
>Disbursement
PLUSAwardType->Disbursement
SubAwardType->Disbursement
1.0c 70 11.26.01 CommonRecord1.0.xsd UnsubAwardType->Disbursement

change the maxOccurs value for the

following elements to the indicated
values:
ReportingSchlType-
>ReportedSummary: 120
ReportingSchlResponseType-
>ProgYrSummary: 120
1.0c 71 11.26.01 CommonRecord1.0.xsd StudentType->LoanInfo: 60
 for the SchlUseOnly element, added
the restriction on the string value: added to better define valid
1.0c 72 11.27.01 CommonRecord1.0-VR.xsd maxLength="20" field values

in the DLAwardResponseType cT,

for the PmttoSvcrAmt element,
added the restriction on the decimal
value:
minInclusive="-9999999.99"
maxInclusive="9999999.99"
totalDigits="9" added to better define valid
1.0c 73 11.27.01 CommonRecord1.0.xsd fractionDigits="2" field values

in the PellAwardResponseType cT,

for the element SchedFedPellGrt
change the element type from
xsd:decimal to added to better define valid
1.0c 74 11.27.01 CommonRecord1.0.xsd codv:SmallCurrencyType field values

changed to better define valid

in the EditResultType cT, for the field values, ensure an
element Field change the value of EditResults block will not
1.0c 75 11.27.01 CommonRecord1.0.xsd maxLength from 150 to 35 exceed 32K

removed all element-specific

annotations and documentations,
added note that all documentation
CommonRecord1.0.xsd will be maintained only in the COD
1.0c 76 11.27.01 CommonRecord1.0-VR.xsd Technical Reference going forward

in the LoanAwardResponseType cT,

for the element MPNStat, remove
the enumerations N, I, C, and P, and values changed to align with
1.0d 80 12.4.01 CommonRecord1.0c.xsd add the enumeration X the COD Tech Reference

in the PellType cT, for the element

LowTuitFeesInd, added an values changed to align with
1.0e 81 1.31.02 CommonRecord1.0d.xsd enumeration with a value of 4. updated range by SFA

in the AddressType cT, for the City

element, changed the value of correction of the maxLength
1.0e 82 1.31.02 CommonRecord1.0d.xsd maxLength to 24 for this element

in the LoanInfoType cT, for the

PromNtPrtInd element, deleted the
enumeration "B" and added the correction of the enumeration
1.0e 83 1.31.02 CommonRecord1.0d.xsd enumeration "Z" for this element
done to be consistent with the
enumerated list values, which
in the CountryType simpleType, are all that is necessary to
removed the restriction appropriately constrain the
1.0e 84 1.31.02 CommonRecord1.0d-VR.xsd <xsd:length value="3"/> field

in the EditResultsType cT, added an

element ReportedValue, as a string determined to be needed to
1.0f 86 2.28.02 CommonRecord1.0e.xsd with a maxLength of 150 support edit processing
added simpleType named
SignedLargeCurrencyType, as a
decimal with a minInclusive of determined to be needed
-999999999999.99 and maxInclusive internally to support legacy
1.0f 89 2.28.02 CommonRecord1.0e-VR.xsd of 999999999999.99 Pell responses
added simpleType named
SignedSmallCurrencyType, as a
decimal with a minInclusive of determined to be needed
-999999999.99 and maxInclusive of internally to support legacy
1.0f 90 2.28.02 CommonRecord1.0e-VR.xsd 999999999.99 Pell responses

changed the reference method for change made to conform with

the VR schema from an "import" W3C schema design
1.0g 97 4.19.02 CommonRecord1.0f.xsd 5 statement to an "include" statement specifications

it was necessary for future

in the AttendingSchlType cT, added flexibility to allow, in certain
the attribute minOccurs="0" to the situations, having an Attending
1.0g 98 4.19.02 CommonRecord1.0f.xsd 133 Student element School without a Student

it was necessary for some

current responses to allow, in
in the ReportingSchlType cT, added certain situations, having an
the attribute minOccurs="0" to the Reporting School without a
1.0g 99 4.19.02 CommonRecord1.0f.xsd 155 AttendingSchl element Attending School
 it was necessary for some
current responses, to allow
sending back a value in that
field that would be out of the
specified date range, namely
in the AwardCreateDt element, 0001-01-01, which is
removed the restriction clause on the consistent with all other date
1.0g 100 4.19.02 CommonRecord1.0f.xsd 487-494 valid range of date values fields

it was necessary for the proper

handling of some current
in the EditResultType cT, added the responses to allow for
attribute nillable="true" for the Value indicating a value has been
1.0g 108 4.19.02 CommonRecord1.0f.xsd 1021 element corrected to nil

in the CountryType sT, removed two

1.0g 109 4.19.02 CommonRecord1.0f.xsd 141-142 duplicated entries from the list

it was necessary for the proper

handling of some current
in the EntityID sT, changed the value responses to allow an EntityID
1.0g 110 4.19.02 CommonRecord1.0f.xsd 561 for minInclusive from 1 to 0 of 0

adherence to PESC standards

changes to tag names to reflect new required tag names without
2.0a 111 8.1.02 CommonRecord1.0g.xsd all naming conventions abbreviations

for the element SoftwareVersion,

changed the value for maxLength
2.0b 112 11.19.02 CommonRecord2.0a.xsd 50 from 5 to 6

changed the name of element

ReportedSchool to ReportingSchool,
and the type to
2.0b 113 11.19.02 CommonRecord2.0a.xsd 68 ReportingSchoolType

changed the name of the cT

ReportedSchoolType to
ReportingSchoolType, and the name
151, of the cT
157, ReportedSchoolResponseType to
2.0b 114 11.19.02 CommonRecord2.0a.xsd 1058 ReportingSchoolResponseType

for the PersonType cT, changed the

name of attribute NameLast to
2.0b 115 11.19.02 CommonRecord2.0a.xsd 246 LastName

for the PromissoryNotePrintCode

2.0b 116 11.19.02 CommonRecord2.0a.xsd 334 element, added the enumeration 'V'

for the FinancialAwardType cT,

2.0b 117 11.19.02 CommonRecord2.0a.xsd 430 added the element NoteMessage

for the CampusBasedAwardType cT,

changed the name of element
LessThanFTFlg to
2.0b 118 11.19.02 CommonRecord2.0a.xsd 447 LessThanFullTimeIndicator
 467,
616, the NoteMessage element
641, was consolidated to appear
671, only under the PersonType,
695, FinancialAwardType, and
846, removed the element NoteMessage DisbursementType
2.0b 119 11.19.02 CommonRecord2.0a.xsd 858 for the following locations complexTypes

for the PellType cT, changed the

name of element
PaymentMethodCode to
2.0b 120 11.19.02 CommonRecord2.0a.xsd 539 PaymentMethodologyCode

for the PellType cT, changed the

name of element
PaymentMethodCode to
2.0b 121 11.19.02 CommonRecord2.0a.xsd 539 PaymentMethodologyCode

for the PLUSAwardType cT,

corrected the name of element
FinanciaAwardAmountRequested to
2.0b 122 11.19.02 CommonRecord2.0a.xsd 639 FinancialAwardAmountRequested

for the DisbursementType cT, added

2.0b 123 11.19.02 CommonRecord2.0a.xsd 824 the element NoteMessage

for the
ResponseFinancialSummaryType
cT, removed the element
2.0b 124 11.19.02 CommonRecord2.0a.xsd 1096 TotalAmountAccepted

for the AddressType cT, changed the

name of the element
AddressFormatIndicator to
2.0b 125 11.19.02 CommonRecord2.0a.xsd 1122 AddressForeignIndicator

for the NameType cT, changed the

name of the elements:
1191, NameFirst to FirstName,
1199, NameMiddle to MiddleInitial,
2.0b 126 11.19.02 CommonRecord2.0a.xsd 1206 NameLast to LastName

created a new cT, named

DLDisbursementResponseType, it
extends the ResponseType with one
additional element,
2.0c 127 1.09.03 CommonRecord2.0b.xsd 1011 PreviousSequenceNumber

in the PLUSAwardType cT,

SubsidizedAwardType cT, and
UnsubsidizedAwardType cT, under
their respective Disbursement
blocks, changed the type of the
647, Response element from
676, ResponseType to
2.0c 128 1.09.03 CommonRecord2.0b.xsd 699 DLDisbursementResponseType

created a new cT, named

PellDisbursementResponseType, it
extends the ResponseType with one
additional element,
2.0c 129 1.09.03 CommonRecord2.0b.xsd 1011 PreviousSequenceNumber
 in the PellType cT, under the
Disbursement block, changed the
type of the Response element from
ResponseType to
2.0c 130 1.09.03 CommonRecord2.0b.xsd 623 PellDisbursementResponseType

moved the element EndorserAmount

from the DLAwardResponseType cT
2.0c 131 2.03.03 CommonRecord2.0b.xsd 939, 950 to the PLUSAwardResponseType cT

added the elements

CPSVerificationIndicator and conform with COD system
HighestCPSTransactionNumber to changes for award year 2004-
2.0d 132 8.11.03 A. Smalera H. Hyland CommonRecord2.0c.xsd 1006 the PellAwardResponseType cT 2005
Changed Commented out area to Update Comment to recent
2.0e 133 5.03.06 A. Lenis CommonRecord2.0d.xsd 2 update date and schema version changes
Changed Namespace to use the new Update namespace to use
2.0e 134 5.03.06 A. Lenis CommonRecord2.0d.xsd 4 Version of 2.0e new Schema Version
Updated word "elemant" to "element"
2.0e 135 5.03.06 A. Lenis CommonRecord2.0d.xsd 394 in Documentation Word was mispelled
Documentation was updated
to better reflect the actual
Updated Documentation verbiage processing that the COD
2.0e 136 5.03.06 A. Lenis CommonRecord2.0d.xsd 394 concerning types of awards. System uses the schema for.

AcademicCompetitivenessGrant was
added intot he schema with a type of
AcademicCompetitivenessGrantTyp
e to be associated with the To update the schema to
2.0e 137 5.03.06 A. Lenis CommonRecord2.0d.xsd 408 substitutionGroup of FinancialAward. accept the ACG program.

NationalSMARTGrant was added

into the schema with a type of
AcademicCompetitivenessGrantTyp
e to be associated with the To update the schema to
2.0e 138 5.03.06 A. Lenis CommonRecord2.0d.xsd 409 substitutionGroup of FinancialAward. accept the ACG program.

DLGraduatePLUS was added into

the schema with a type of
AcademicCompetitivenessGrantTyp To update the schema to
e to be associated with the accept the Grad-PLUS
2.0e 139 5.03.06 A. Lenis CommonRecord2.0d.xsd 410 substitutionGroup of FinancialAward. program.
New Field added for Unsubsidized
Awards. Field is Request from FSA to include
AdditionalUnsubsizedEligibilityIndicat this field as part of the new
2.0e 140 5.03.06 A. Lenis CommonRecord2.0d.xsd or schema.

New Field added for Unsubsidized Request from FSA to include

Awards. Field is this field as part of the new
2.0e 141 5.03.06 A. Lenis CommonRecord2.0d.xsd PreprofessionalCourseworkIndicator. schema.
Complex element of
AcademicCompetitivenessGrantTyp
e added that will use the
FinancialAwardType extension. This Schema needs to be able to
Complex element will reuse the accept ACG awards and
2.0e 142 5.03.06 A. Lenis CommonRecord2.0d.xsd PellDisbursementType disbursements.
New tag of
EligibilityPaymentReasonCode
added specifically to the ACG ACG program needs the field
program. Schema limits valid values in order for COD to accept and
2.0e 143 5.03.06 A. Lenis CommonRecord2.0d.xsd to "01", "02", and "03". store the data.
New tag of
RigorousHighSchoolProgramCode ACG program needs the field
added specifically to the ACG in order for COD to accept and
2.0e 144 5.03.06 A. Lenis CommonRecord2.0d.xsd program store the data.
ProgramCIPCode added as a valid SMART program needs the
tag only within the SMART Grant field in order for COD to
2.0e 145 5.03.06 A. Lenis CommonRecord2.0d.xsd Type. accept and store the data.
Tag was added in order to
MPNExpirationDate was added into update the schema to allow
the LoanAwardResponseType responses to store values
2.0e 146 5.03.06 A. Lenis CommonRecord2.0d.xsd complex element. within the tag.
 Tag was added in order to
StudentLevelCode was added into update the schema to allow
the NationalSMARTGrantType type responses to store values
2.0e 147 5.03.06 A. Lenis CommonRecord2.0d.xsd complex element. within the tag.
StudentLevelCode was added into Tag was added in order to
the update the schema to allow
AcademicCompetitivenessGrantTyp responses to store values
2.0e 148 5.03.06 A. Lenis CommonRecord2.0d.xsd e type complex element. within the tag.
Added
"AcademicCompetitivenessGrant", These are 3 new valid values
"NationalSMARTGrant", and for the "Financials Awards"
"DLGraduatePLUS" as valid values simple type (please note that
for the "Financial Awards" simple DL Graduate PLUS will not be
2.0e 149 6.14.06 A. Lenis CommonRecord2.0d-VR.xsd type. used by COD).