Illinois Administrative Code › Title 26 - ELECTIONS › Part 219 - PROCEDURES FOR IMPLEMENTING THE ELECTRONIC CANVASS › Appendix A - Illinois eCanvass File Format

Current through Register Vol. 48, No. 28, July 12, 2024
Master File Record Structure
Column Start
Length
Date Type
Ballot Style
Precinct
Party
1
2
Record Type (Integer)
Record
Type = 1
Record
Type = 2
Record
Type = 3
3
7
Unique System Id (Integer)
Ballot Style ID [1]
Precinct ID [6]
(Vendor)
Party ID [9]
10
50
Name (String)
Ballot Style Name [2]
Precinct Name [7]
Party Name [10]
60
20
Code (String)
80
7
Display List Order (Integer)
87
7
Party ID (Vendor or State Number)
Ballot Style (Vendor) Party ID [3]
(SBE) Party ID [11]
94
1
Varies/Record
Dependent (Boolean 0 or 1)
Is Federal [4]
0 = Non-Federal
Ballot Style
1 = Federal Ballot Style
95
2
Vote For (Integer)
Proposition Only [5]
00 = No
01 = Yes
97
7
Varies/Record Dependent (Integer)
Registration [8]
(Master File Record Structure
				Cont.)
District
Contest
Candidate
Record
Type = 4
Record
Type = 5
Record
Type = 6
District ID [12]
(Vendor)
Contest ID [15]
(Vendor)
Candidate ID [21]
District Name [13]
Contest Name [16]
Candidate Name [22]
(SBE) Contest ID [17]
(SBE) Candidate ID [23]
District List Order [14]
Contest List Order [18]
Candidate List Order [24]
(SBE) Party ID [11]
(Vendor) Candidate Party ID [25]
Is Proposal [19]
0 = Normal Contest
1 = Proposal
Is Write-in [31]
0 = Regular Candidate
1 = Write-In Candidate
Vote For [20]
District ID [12]
(Vendor) Contest ID [15]
Vote File Record Structure
Column Start
Length
Date Type
1
7
Precinct ID (Integer) [6]
8
7
Ballot Style ID (Integer) [1]
15
7
(Vendor) Contest ID (Integer) [15]
0 = Turnout Record [26]
22
7
(Vendor) Candidate Id (Integer) [21]
9999999 = Over Votes [27, 28]
9999998 = Under Votes [27, 29]
9999997 = Blank Ballot [27, 30]
0 = Turnout Record [26]
29
7
Vote Count (Integer)
Definitions
1 Ballot Style ID - A unique (to the
				jurisdiction) numeric identifier for the given ballot style
2 Ballot Style Name - A unique (to
				the jurisdiction) name assigned to the given ballot style
3 Ballot Style (Vendor) Party ID -
				Only applicable in a primary election, this party ID identifies the party for a
				given ballot style
4 Is Federal - Designates if a
				ballot style contains only federal contests
5 Proposition Only - Only applicable
				in a primary election, this identifies a ballot style as only having questions
				of public policy (referenda)
6 Precinct ID - Unique (to the
				jurisdiction) numeric identifier for the given precinct
7 Precinct Name - A unique (to the
				jurisdiction) name to identify the precinct
8 Registration - The number of
				registered voters within a precinct. This number should reflect only the
				"active" registered voters from that precinct
9 (Vendor) Party ID - Unique
				Identifier for the political parties active in a given election, assigned by
				the jurisdiction or tabulation vendor
10 Party Name - Name of a given
				political party
11 (SBEL) Party ID - ID assigned to
				a given political party by SBEL; SBEL party ID for a contest will reflect the
				party for a contest in a primary election; in a General Election this ID will
				be designated as "99" (Nonpartisan) since the office does not have a party
				affiliation in a General Election
12 District ID - Unique (to the
				jurisdiction) ID assigned by the jurisdiction to a given political
				district/unit of government
13 District Name - A unique text
				representation of the district/unit of government (e.g.,
				4TH APPELLATE COURT)
14 District List Order - A
				hierarchical number representing the order in which districts appear on the
				ballot
15 (Vendor) Contest ID - A unique ID
				number assigned to an office/contest by the jurisdiction or tabulation
				vendor
16 Contest Name - A unique text
				representation of the contest/office (e.g., 4TH
				APPELLATE COURT - SMITH VACANCY)
17 (SBEL) Contest ID - ID assigned
				to a given office/contest by SBEL; should be zero in the case that an ID is not
				assigned by SBEL for the given contest
18 Contest List Order - A
				hierarchical number representing the order in which offices/contests appear on
				the ballot
19 Is Proposal - Designates if a
				contest/office is actually a question of public policy (referenda)
20 Vote For - Number of candidates
				to be elected/nominated within a given office/contest
21 (Vendor) Candidate ID - Unique ID
				assigned to a candidate by jurisdiction/vendor
22 Candidate Name - Name of
				candidate or position on a referendum question
23 (SBEL) Candidate ID - ID assigned
				by SBEL for the given candidate; in the event that no ID is assigned by SBEL,
				this ID shall be zero
24 Candidate List Order - A
				hierarchical number representing the order in which candidates appear on the
				ballot
25 (Vendor) Candidate Party ID - ID
				assigned by the jurisdiction or vendor to the candidate
26 Turnout Record - In the vote
				file, a turnout record will have a contest ID of zero and a candidate ID of
				zero, and will have one record per precinct and ballot style combination; the
				turnout record will effectively report the number of times a ballot style was
				counted within a particular precinct
27 Reporting of Under Votes, Over
				Votes and Blank Ballots - Under votes, over votes and blank ballots shall be
				designated in the candidate ID field with codes of 9999998, 9999999 and
				9999997, respectively, and shall have a corresponding contest ID
28 Under Votes - The number of times
				that the contest was on a tabulated ballot when votes cast are less than the
				Vote For number
29 Over Votes - The number of times
				that the contest was on a tabulated ballot when votes cast are more than the
				Vote For number
30 Blank Ballots - For a given
				contest, the number of times a ballot is cast when the contest has no
				candidates
31 Is Write-in - Identifies that the
				candidate is a write-in candidate