Technical Specifications for Electronic Filing of Campaign Expense Reports

Changes from Previous Specifications

There have been several changes to the technical specifications for electronic filing of campaign expense reports. There have been changes to the layout for all five data files. These changes were necessitated by the changes to the paper campaign expense reporting form. Highlights of the changes are listed below: In all five files, (filer.txt, contrib.txt, expense.txt, debt.txt and receipt.txt) the year has been added. >In the filer.txt file, the separate fields for candidate name (last, first, middle and suffix) have been removed. If the report is filed by a candidate, the name should be concatenated into the filer name field. In the filer.txt file, the treasurer name, address and phone number has been removed. The only address that is to be provided now is the address from the expense report cover sheet. In the filer.txt file, the office codes have changed from numeric to more intuitive 3-letter codes. Refer to the office code table below. In the filer.txt file, the party codes have been changed from numeric to more intuitive 3-letter codes. Refer to the party code table below. In the contrib.txt file , a new section code field has been added. This is to identify which section of the report the contribution record is to appear. In the contrib.txt file, the contributing committee number has been removed. In the contrib.txt file, there are now three separate date and amount fields to indicate if a particular contributor has given multiple contributions to the filer during the reporting period. In the contrib.txt file, the payment method has been removed. In the expense.txt file , the recipient identification number has been removed. In the expense.txt file, the expenditure code has been removed. In county code table , Forest county should be number 27, and Franklin county should be number 28. This is to correct an oversight in the original specifications.

The Department will support these new specifications immediately. It is our hope that the certified vendors will have their applications modified, and distributed to their customers by December 31, 1999. The Department will stop supporting the original specifications at some point past that date.

General Requirements for All Files

All data files provided to the Department of State must be ASCII text files. All data files must be comma (,) delimited; that is, a comma must separate all fields in the file. All data files must be text qualified with double quotation marks ("); that is, any field defined as alphanumeric must be enclosed by double quotation marks. A sample of this type of file is provided below:

1234,"Mary Jones",150.00,"123 East Main Street","Anytown","PA","171021234"

5678,"William A. Smith",,"123 West Main Street","Anytown","PA",""

In this sample, there are seven fields. The first field is a numeric field, followed by an alphanumeric name field, a numeric dollar amount field, an alphanumeric address field, and alphanumeric city field, an alphanumeric state code field and finally, an alphanumeric zip code field. In the case where no value is available for a numeric field, only a comma should be placed in the file. For alphanumeric fields that are not available, a set of empty double quotation marks should be placed in the file. These cases are both illustrated in the second record above. 

Note: This sample is for illustration purposes only.

Files to Be Provided

There are five basic types of information that are to be data entered: basic filer information, contributions, other receipts, expenditures and debts. This information will be provided to the Department of State in five files: filer.txt, contrib.txt, receipt.txt, expense.txt and debt.txt, respectively.

Filer.txt will contain the information about each filer. This information is found primarily on the first page of the expense report. Contrib.txt will contain contribution information from Schedule I, Parts A, B, C and D as well as in-kind contributions from Schedule II, Parts F and G. Receipt.txt will contain information from Schedule I, Part E. Expense.txt will contain information from Schedule III. Debt.txt will contain information from schedule IV.

FieldData TypeSource and Comments
Filer Identification NumberNumeric, 7Cover sheet
YearNumeric, 4Cover sheet
Report Type/Cycle CodeNumeric, 2Cover sheet, Must be 1-7. See cycle code table.
AmendmentAlphanumeric, 1Cover sheet, Y if report is an amendment, N otherwise.
TerminationAlphanumeric, 1Cover sheet, Y if report is a termination, N otherwise.
Filer Type Code (1,2 or 3)Alphanumeric, 1Cover sheet, 1 Candidate, 2 Committee or 3 Lobbyist.
Filer NameAlphanumeric, 255Cover sheet
Filer OfficeAlphanumeric, 3Cover sheet, See office code table.
Filer DistrictAlphanumeric, 3Cover sheet
Filer PartyAlphanumeric, 3Cover sheet, See party code table.
Filer Address 1Alphanumeric, 50Cover sheet
Filer Address 2Alphanumeric, 50Cover sheet
Filer CityAlphanumeric, 25Cover sheet
Filer StateAlphanumeric, 2Cover sheet
Filer Zip CodeAlphanumeric, 9Cover sheet, 5 plus 4. No separator
Filer CountyAlphanumeric, 2Cover sheet, See county code table.
Filer PhoneAlphanumeric, 10Cover sheet, Area code and phone, no parentheses or dashes.
Beginning Cash BalanceNumeric, 9.2Cover sheet, (999999999.99) Include decimal
Unitemized Monetary ContributionsNumeric, 9.2Sch. I Detailed Summary (999999999.99)Include decimal
Unitemized In-Kind ContributionsNumeric, 9.2Sch. II Detailed Summary (999999999.99)Include decimal

FieldData TypeSource and Comments
Filer Identification NumberNumeric, 7Cover sheet
YearNumeric, 4Cover sheet
Report Cycle CodeNumeric, 1Cover sheet
Section CodeAlphanumeric, 3Identifies section of report,IA, IB, IC, ID, IIF or IIG
Contributor NameAlphanumeric, 255Schedule I or II
Contributor Address 1Alphanumeric, 50Schedule I or II
Contributor Address 2Alphanumeric, 50Schedule I or II
Contributor CityAlphanumeric, 25Schedule I or II
Contributor StateAlphanumeric, 2Schedule I or II
Contributor Zip CodeAlphanumeric, 9Schedule I or II , 5 plus 4. No separator in field.
Contributor OccupationAlphanumeric, 25Schedule I or II
Employer NameAlphanumeric, 255Schedule I Part D or II Part G
Employer Address 1Alphanumeric, 50Schedule I Part D or II Part G
Employer Address 2Alphanumeric, 50Schedule I Part D or II Part G
Employer CityAlphanumeric, 25Schedule I Part D or II Part G
Employer StateAlphanumeric, 2Schedule I Part D or II Part G
Employer Zip CodeAlphanumeric, 9Schedule I Part D or II Part G, 5 plus 4. No separator
Contribution Date 1Alphanumeric, 8Schedule I or II, (YYYYMMDD), No separators.
Contribution Amount 1Numeric, 9.2Schedule I or II, (999999999.99), Include decimal.
Contribution Date 2Alphanumeric, 8Schedule I or II (YYYYMMDD) No separators, I.
Contribution Amount 2Numeric, 9.2Schedule I or II, (999999999.99), Include decimal.
Contribution Date 3Alphanumeric, 8Schedule I or II (YYYYMMDD) No separators, I.
Contribution Amount 3Numeric, 9.2Schedule I or II, (999999999.99),Include decimal.
Contribution DescriptionAlphanumeric, 255Schedule II Part F or G

FieldData TypeSource and Comments
Filer Identification NumberNumeric, 7Cover sheet
YearNumeric, 4Cover sheet
Report Cycle CodeNumeric, 1Cover sheet
Source of Receipt (Name)Alphanumeric, 255Schedule I Part E
Source of Receipt (Address 1)Alphanumeric, 50Schedule I Part E
Source of Receipt (Address 2)Alphanumeric, 50Schedule I Part E
Source of Receipt (City)Alphanumeric, 25Schedule I Part E
Source of Receipt (State)Alphanumeric, 2Schedule I Part E
Source of Receipt (Zip Code)Alphanumeric, 9Schedule I Part E , 5 plus 4. No separator
Receipt DescriptionAlphanumeric, 255Schedule I Part E
Receipt DateAlphanumeric, 8Schedule I Part E, (YYYYMMDD), No separators.
Receipt AmountNumber, 9.2Schedule I Part E, (999999999.99), Include decimal.

FieldData TypeSource and Comments
Filer Identification NumberNumeric, 7Cover sheet
YearNumeric, 4Cover sheet
Report Cycle CodeNumeric, 1Cover sheet
Recipient NameAlphanumeric, 255Schedule III
Recipient Address 1Alphanumeric, 50Schedule III
Recipient Address 2Alphanumeric, 50Schedule III
Recipient CityAlphanumeric, 25Schedule III
Recipient StateAlphanumeric, 2Schedule III
Recipient Zip CodeAlphanumeric, 9Schedule III, 5 plus 4. No separator
Expenditure DateAlphanumeric, 8Schedule III, (YYYYMMDD), No separators.
Expenditure AmountNumeric, 9.2Schedule III, (999999999.99), Include decimal.
Expenditure DescriptionAlphanumeric, 255Schedule III

FieldData TypeSource and Comments
Filer Identification NumberNumeric, 7Cover sheet
YearNumeric, 4Cover sheet
Report Cycle CodeNumeric, 1Cover sheet
Creditor NameAlphanumeric, 255Schedule IV
Creditor Address 1Alphanumeric, 50Schedule IV
Creditor Address 2Alphanumeric, 50Schedule IV
Creditor CityAlphanumeric, 25Schedule IV
Creditor StateAlphanumeric, 2Schedule IV
Creditor Zip CodeAlphanumeric, 9Schedule IV, 5 plus 4. No separator
Date Debt IncurredAlphanumeric, 8Schedule IV, (YYYYMMDD), No separators.
Amount of DebtNumeric, 9.2Schedule IV, (999999999.99), Include decimal.
Description of DebtAlphanumeric, 255Schedule IV

County Code Number

CodeCounty
01Adams
02Allegheny
03Armstrong
04Beaver
05Bedford
06Berks
07Blair
08Bradford
09Bucks
10Butler
11Cambria
12Cameron
13Carbon
14Centre
15Chester
16Clarion
17Clearfield
18Clinton
19Columbia
20Crawford
21Cumberland
22Duaphin
23Delaware
24Elk
25Erie
26Fayette
27Forest
28Franklin
29Fulton
30Greene
31Huntingdon
32Indiana
33Jefferson
34Juniata
35Lackawanna
36Lancaster
37Lawrence
38Lebanon
39Lehigh
40Luzerne
41Lycoming
42McKean
43Mercer
44Mifflin
45Monroe
46Montgomery
47Montour
48Northampton
49Northumberland
50Perry
51Philadelphia
52Pike
53Potter
54Schuylkill
55Snyder
56Somerset
57Sullivan
58Susquehanna
59Tioga
60Union
61Venango
62Warren
63Washington
64Wayne
65Westmoreland
66Wyoming
67York

CodeType
016th Tuesday Pre Primary Election
022nd Friday Pre Primary Election
0330 Day Post Primary Election
046 th Tuesday Pre General/Municipal Election
052 nd Friday Pre General/Municipal Election
0630 Day Post General/Municipal Election
07Annual Report
082nd Friday Pre-Special Election
0930-Day Post Special Election

CodeType
GOVGovernor
LTGLieutenant Governor
ATTAttorney General
AUDAuditor General
TREState Treasurer
SPMJustice of the Supreme Court
SPRJudge of the Superior Court
CCJJudge of the Commonwealth Court
STSSenator in the General Assembly
STHRepresentative in the General Assembly
CPJJudge of the Court of Common Pleas
MCJJudge of the Municipal Court
TCJJudge of the Traffic Court
PH1Mayor, City of Philadelphia
PH2District Attorney, City of Philadelphia
PH3City Controller, City of Philadelphia
PH4City Council Member, City of Philadelphia
PH5City Commissioner, City of Philadelphia
PH6Register of Wills, City of Philadelphia
PH7Clerk of Quarter Sessions, City of Philadelphia

CodeParty
DEMDemocratic Party
REPRepublican Party
CSTConstitutional Party
LIBLibertarian Party
REFReform Party
OTHOther