2305

BATCH FILE VALIDATION MODULE

ANNEX B
Job-Aid

2305 BATCH FILE VALIDATION MODULE

1. Go to BIR Website, click Downloadables and download the program (BIRF2305.exe).
2. Create a folder (anywhere in your directory) and save the downloaded program.
3. Double click the BIRF2305.exe
Note: For your convenience, save your file to be validated (in .csv format) to the same folder
where your program resides.

The Batch File Validation Module Screen

This is the main form consisting of two (2) buttons, the Validation Module and the Exit button.

Buttons and Its Description:

Validation Module Clicking the Validation Module button or simply pressing the combination of
Alt key and M (Alt + M) will redirect you to the validation window proper.
Notice that two (2) folders are automatically created to where your program is located:
Reports This folder holds all the output file (in .txt format) that will be the generated
upon clicking the Validate File button.
Validated File This folder holds all the .csv files that have successfully passed the
validation module. The .csv file will be automatically transferred/saved to this folder.

Exit Clicking the Exit button or simply pressing the combination of Alt key and x (Alt + x) will let
you exit from the system.

BUREAU OF INTERNAL REVENUE

Systems Development Division

September 2015 | 1

2305
BATCH FILE VALIDATION MODULE

ANNEX B
Job-Aid

The Validation Window Proper

This form displays the list of directories and files stored in the directory. This is where file selection
and validation is taking place.

Buttons and Its Description:

File Directory This is where your files/folder are saved. The default file directory is the location
of your created folder where the BIRF2305 program is saved.
Filename Lists of all files saved in your created folder together with the BIRF2305 program.
File to Validate This textbox will show the exact address of the selected file subject for
validation.
Validate File Clicking this button or simply pressing the combination of Alt key and V (Alt + V)
will let the selected file be validated. A validation report in text format will be generated.
Cancel Clicking this button or simply pressing the combination of Alt key and C (Alt + C) will
redirect you to the main form.

BUREAU OF INTERNAL REVENUE

Systems Development Division

September 2015 | 2

2305
BATCH FILE VALIDATION MODULE

ANNEX B
Job-Aid

BIRF2305 Information Message

This is the form to be displayed if no file was selected.

BIRF2305 Confirmation Message

This is the form to be displayed after clicking Cancel button from the Main form.
Clicking Yes button will automatically close the program.

File Format and File Structure of BIR Form No. 2305

The following fields (in exact order) should be the content of the file to be validated.
The filename should be saved in a comma delimited format (.csv format) using the following file
naming convention:
WATIN_WABC_DATE_2305_USERNAME.CSV
WHERE:
FIELD_NAME
WATIN
WABC
DATE
FTYPECODE
USERNAME

BUREAU OF INTERNAL REVENUE

Systems Development Division

TYPE
VARCHAR2(9)
VARCHAR2(5)
MM/DD/YYYY
VARCHAR2(6)

DESCRIPTION
Withholding Agents TIN
Withholding Agents Branch Code
Date
Form Type Code
Encoders Name

September 2015 | 3

2305
BATCH FILE VALIDATION MODULE

ANNEX B
Job-Aid

FIELDS (IN EXACT ORDER)

Column

FIELD_NAME

TYPE/FORMAT

DEFAULT
VALUE

1
2
3
4
5

EXMPN_CERT_SEQ_NUM
EXMPN_CERT_VERSION
FORM_VERSION
FTYPE_CODE
DLN

EFFECTIVE_DATE

7
8
9
10
11
12
13

FILING_REASON
FILING_DATE
TIN
BRANCH_CODE
LAST_NAME
FIRST_NAME
MIDDLE_NAME

NUMBER(15)
NUMBER(2)
NUMBER(4)
VARCHAR2(6)
VARCHAR2(14)
DATE
(MM/DD/YYYY)
VARCHAR2(1)
DATE
VARCHAR2(9)
VARCHAR2(5)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(30)

14

TP_TYPE

VARCHAR2(1)

15
16

SIGNATURE_YN
ATTACHMENT_YN

VARCHAR2(1)
VARCHAR2(1)

17

CIVIL_STATUS

VARCHAR2(1)

18

CLAIM_EXMPN_YN

VARCHAR2(1)

19
20
21

ACTIVE_FLAG
PROCESS_YN
CREATED_BY

A
N

22

DATE_CREATED

23
24
25
26
27
28
29
30
31
32
33
34
35

RDO_CODE
SUBSTREET
STREET
BARANGAY
DISTRICT
CITY
ZIP
WA_TIN
WA_BRANCH_CODE
WA_RDO_CODE
WA_FIRST_NAME
WA_LAST_NAME
WA_MIDDLE_NAME

VARCHAR2(1)
VARCHAR2(1)
VARCHAR2(12)
DATE
(MM/DD/YYYY)
VARCHAR2(3)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(12)
VARCHAR2(9)
VARCHAR2(5)
VARCHAR2(3)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(30)

36

WA_REGISTERED_NAME

VARCHAR2(60)

37

WA_SUBSTREET

VARCHAR2(30)

BUREAU OF INTERNAL REVENUE

Systems Development Division

0
1
2305
(NULL)

DESCRIPTION
Sequence Number
Certificate Version
Form Version
Form type code
Document Locator Number
Effective Date of Exemption

N
(NULL)

00000

Please refer to
below List of
Values (LOV)
Y
Y
Please refer to
below List of
Values (LOV)

System Date

Filing Reason
Filing Date
Employees TIN
Employees Branch Code
Employees Last Name
Employees First Name
Employees Middle Name
Type of Filer
Signature (Yes or No)
Attachment (Yes or No)
Employees Civil Status
Claim for Additional Exemption
(Yes of No)
Active Flag
Process (Yes or No)
User LogIn
Date Encoded
Employees RDO Code
Employees Address (Substreet)
Employees Address (Street)
Employees Address (Barangay)
Employees Address (District)
Employees Address (City)
Employees Address (Zip Code)
Withholding Agents TIN
Withholding Agents Branch Code
Withholding Agents RDO Code
Withholding Agents First Name
Withholding Agents Last Name
Withholding Agents Middle Name
Withholding Agents Registered
Name
Withholding Agents Address
(Substreet)
September 2015 | 4

2305
BATCH FILE VALIDATION MODULE

ANNEX B
Job-Aid

38

WA_STREET

VARCHAR2(30)

39

WA_BARANGAY

VARCHAR2(30)

40

WA_DISTRICT

VARCHAR2(30)

41

WA_CITY

VARCHAR2(30)

42

WA_ZIP

VARCHAR2(12)

43

WA_SIGNATURE_YN

VARCHAR2(1)

44

WA_CERT_DATE

DATE
(MM/DD/YYYY)

45

SPS_EMPT_STATUS

VARCHAR2(1)

46
47
48
49
50
51

SPS_TIN
SPS_BRANCH_CODE
SPS_LAST_NAME
SPS_FIRST_NAME
SPS_MIDDLE_NAME
SPS_EMPR_TIN

VARCHAR2(9)
VARCHAR2(5)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(9)

52

SPS_EMPR_BRANCH_CODE

VARCHAR2(3)

53

MULTI_EMPT_TYPE

VARCHAR2(1)

54
55
56
57

MAIN_EMPR_YN
NUM_OF_DEPND
FORM_STATUS
MODIFIED_BY

58

DATE_MODIFIED

59
60
61
62
63
64
65
66

NUM_OF_DEPND_CALC
UPDATE_REASON
CIVIL_STATUS_CALC
EXMPN_CERT_SEQ_NUM
EXMPN_CERT_VERSION
LAST_NAME
FIRST_NAME
MIDDLE_NAME

67

BIRTH_DATE

VARCHAR2(1)
NUMBER(1)
VARCHAR2(1)
VARCHAR2(12)
DATE
(MM/DD/YYYY)
NUMBER(1)
VARCHAR2(50)
VARCHAR2(1)
NUMBER(15)
NUMBER(2)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(30)
DATE
(MM/DD/YYYY)

68

RELATIONSHIP_CODE

VARCHAR2(1)

69
70
71

INCAPACITATED_YN
ACTIVE_FLAG
MODIFIED_BY

72

DATE_MODIFIED

73
74

ERROR_CODE
LAST_NAME

VARCHAR2(1)
VARCHAR2(1)
VARCHAR2(12)
DATE
(MM/DD/YYYY)
VARCHAR2(5)
VARCHAR2(30)

BUREAU OF INTERNAL REVENUE

Systems Development Division

Please refer to
below LOVs

00000

Please refer to
below LOVs

Y
(NULL)
(NULL)

Withholding
(Street)
Withholding
(Barangay)
Withholding
(District)
Withholding
(City)
Withholding
Code)
Withholding
or No)
Withholding
Certification

Agents Address
Agents Address
Agents Address
Agents Address
Agents Address (Zip
Agent Signature (Yes
Agent Date of

Spouses Employment Status

Spouses TIN
Spouses Branch Code
Spouses Last Name
Spouses First Name
Spouses Middle Name
Employers TIN of Spouse
Employers Branch Code of
Spouse
Type of Multiple Employments
Main Employer (Yes or No)
Number of Dependents
Form Status
Modified By
Date Modified

(NULL)
(NULL)
(NULL)
0

Reason for Updates

Sequence Number
Certificate Version
Dependent 1 Last Name
Dependent 1 First Name
Dependent 1 Middle Name
Dependent 1 Birthday

C (if w/
dependent)
N
A
(NULL)

Relationship Code
Mentally/Physically Incapacitated
Dependent 1 Active Flag
Modified By
Date Modified

(NULL)
Dependent 2 Last Name
September 2015 | 5

2305
BATCH FILE VALIDATION MODULE

ANNEX B
Job-Aid

75
76

FIRST_NAME
MIDDLE_NAME

77

BIRTH_DATE

78

RELATIONSHIP_CODE

VARCHAR2(1)

79
80
81

INCAPACITATED_YN
ACTIVE_FLAG
MODIFIED_BY

82

DATE_MODIFIED

83
84
85
86

ERROR_CODE
LAST_NAME
FIRST_NAME
MIDDLE_NAME

87

BIRTH_DATE

VARCHAR2(1)
VARCHAR2(1)
VARCHAR2(12)
DATE
(MM/DD/YYYY)
VARCHAR2(5)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(30)
DATE
(MM/DD/YYYY)

88

RELATIONSHIP_CODE

VARCHAR2(1)

89
90
91

INCAPACITATED_YN
ACTIVE_FLAG
MODIFIED_BY

92

DATE_MODIFIED

93
94
95
96

ERROR_CODE
LAST_NAME
FIRST_NAME
MIDDLE_NAME

97

BIRTH_DATE

VARCHAR2(1)
VARCHAR2(1)
VARCHAR2(12)
DATE
(MM/DD/YYYY)
VARCHAR2(5)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(30)
DATE

98

RELATIONSHIP_CODE

VARCHAR2(1)

99
100
101

INCAPACITATED_YN
ACTIVE_FLAG
MODIFIED_BY

102

DATE_MODIFIED

103

ERROR_CODE

VARCHAR2(1)
VARCHAR2(1)
VARCHAR2(12)
DATE
(MM/DD/YYYY)
VARCHAR2(5)

104

SEX

VARCHAR2(1)

105
106
107
108
109
110
111
112

PLACE_OF_BIRTH
MOTHER_NAME
FATHER_NAME
CITIZENSHIP
OTHER_CITIZENSHIP
ID_TYPE
ID_NUMBER
ID_ISSUER

113

ID_EFFECTIVE_DATE

VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(30)
VARCHAR2(3)
VARCHAR2(3)
VARCHAR2(10)
VARCHAR2(30)
VARCHAR2(60)
DATE
(MM/DD/YYYY)

BUREAU OF INTERNAL REVENUE

Systems Development Division

Dependent 2 First Name

Dependent 2 Middle Name

VARCHAR2(30)
VARCHAR2(30)
DATE
(MM/DD/YYYY)

Dependent 2 Birthday
C (if w/
dependent)
N
A
(NULL)

Relationship Code
Mentally/Physically Incapacitated
Dependent 2 Active Flag
Modified By
Date Modified

(NULL)

Error Code
Dependent 3 Last Name
Dependent 3 First Name
Dependent 3 Middle Name
Dependent 3 Birthday

C (if w/
dependent)
N
A
(NULL)

Relationship Code
Mentally/Physically Incapacitated
Dependent 3 Active Flag
Modified By
Date Modified

(NULL)

Error Code
Dependent 4 Last Name
Dependent 4 First Name
Dependent 4 Middle Name
Dependent 4 Birthday

(MM/DD/YYYY)

C (if w/
dependent)
N
A
(NULL)

Relationship Code
Mentally/Physically Incapacitated
Dependent 4 Active Flag
Modified By
Date Modified

(NULL)
M for Male
F for Female

Error Code
Employees Gender
Employees Place of Birth
Employees Mothers Name
Employees Fathers Name
Employees Citizenship
Employees Other Citizenship
Employees Type of ID
Employees ID Number
Issuer of Employees ID
Effective Date of Employees ID
September 2015 | 6

2305
BATCH FILE VALIDATION MODULE
114

ID_EXPIRY_DATE

115
116
117
118
119
120
121

ID_PLACE_ISSUE
PHONE_NUMBER
MOBILE_NUMBER
FAX_NUMBER
EMAIL_ADDRESS
FOREIGN_ADDRESS
WA_CONTACT_NUMBER

122

RELATIONSHIP_START_DATE

123

COUNTRY

124

DATE_MODIFIED_REPORT

ANNEX B
Job-Aid
DATE
(MM/DD/YYYY)
VARCHAR2(30)
VARCHAR2(50)
VARCHAR2(50)
VARCHAR2(50)
VARCHAR2(50)
VARCHAR2(60)
VARCHAR2(50)
DATE
(MM/DD/YYYY)
VARCHAR2(60)
DATE
(MM/DD/YYYY)

Expiry Date of Employees ID

Place Issued of Employees ID
Employees Phone Number
employees Mobile Number
Employees Fax Number
Employees Email Address
Employees Foreign Address
Employers Contact Number
Relationship Start Date
Employees Country
Date Modified Report

LIST OF VALUES (LOVs)

14 TP_TYPE
VALUE
1
2

DESCRIPTION
Employed
Self-employed

17 CIVIL_STATUS
VALUE
S
M
W

DESCRIPTION
Single
Married
Widow/Widower

45 SPS_EMPT_STATUS
VALUE
1
2
3
4
5
6

DESCRIPTION
Unemployed
Employed Locally and Husband claims additional exemption
Employed Locally and Wife claims additional exemption
Engaged in Business and Husband claims additional exemption
Engaged in Business and Wife claims additional exemption
Employed Abroad

53 MULTI_EMPT_TYPE
VALUE
C
S

DESCRIPTION
Concurrent Employments
Successive Employments

BUREAU OF INTERNAL REVENUE

Systems Development Division

September 2015 | 7