Tier I & Tier II - Subscriber Contribution File

General Notes for All Upload Types and Record Types

1 File should be generated in ASCII Format with "txt" as filename extension.
2 The input file will be a delimited file. Each field in the file will be caret ^ seperated.
3 Each Record (including last record) must start on new line and must end with a newline character.
4 The constant values as mentioned in the file format below (values of fields viz. 'Record Type', 'Upload Type' etc.) n
in BLOCK letters only. i.e. value of field 'Record Type' in case of 'File Header' should be specified as 'FH' and not 'f
5 For all fields of type 'Amount', the decimal point with precision value 2 will be explicit and needs to be mentioned w
6 The created text file will be in the following format:
(i) The first line of the file will be the File Header.
(ii) The first Batch header will be present after the File Header.
(iii) The first POP-SP header associated with the Batch Header will be present after the Batch Header.
(iv) The details of the subscriber associated with the POP-SP will be present after each POP-SP Header reco
(v) The second POP-SP header (if present) will be present after the last Subscriber detail record of the first P

M - Mandatory
O - Optional

File Header Record

Sr. No Field Name Data Type Size M/O M/O Valid Values
Correction
Regular (C)
(R)
1 Line Number INTEGER 9 M M 1

2 Record Type CHAR 2 M M FH

3 Uploaded By CHAR 1 M M 'U'

 4 Uploading entity's Reg. INTEGER 7 M M
No.

5 Number of Batches INTEGER 9 M M 1

6 FH Record Hash INTEGER 20 M M

7 FVU Version CHAR 9 M M

8 FVU File Level Hash INTEGER 20 M M

9 Filler CHAR 9 O O
10 Filler INTEGER 20 O O
11 Filler CHAR 9 O O
12 Filler INTEGER 20 O O

Batch Header Record

Sr. No Field Name Data Type Size M/O M/O Valid Values
Correction
Regular (C)
(R)
1 Line Number INTEGER 9 M M
2 Record Type CHAR 2 M M BH

3 Batch Number INTEGER 9 M M 1

4 Contribution File Type CHAR 1 M M R - Original File C-

Correction File

5 POP / POP-SP Reg. No. INTEGER 7 M M

6 Date of file creation Date 8 M M

7 Batch Id INTEGER 20 M M
 8 Transaction Id INTEGER 13 M

9 Total No. of POP-SP INTEGER 9 M M

Headers

10 No. of subscribers INTEGER 9 M M

contribution records in
the file

11 Control Total for DECIMAL 20,2 M M

Employer’s Contribution

12 Control Total for DECIMAL 20,2 M M

Subscriber’s contribution

13 Filler DECIMAL 20,2 O O NULL

 14 Grand Total DECIMAL 20,2 M M

15 Batch Header Record INTEGER 20 M M

Hash

POP-SP Header Rec

Sr. No Field Name Data Type Size M/O M/O Valid Values
Correction
Regular (C)
(R)
1 Line Number INTEGER 9 M M

2 Record Type CHAR 2 M M DH

3 Batch Number INTEGER 9 M M 1

 4 POP-SP Serial Number INTEGER 9 M M

5 POP-SP Reg. No. Integer 7 M M

6 Total No Of Subscribers INTEGER 9 M M

7 Control Total for DECIMAL 20,2 M M

Employer’s Contribution

8 Control Total for DECIMAL 20,2 M M

Subscriber’s contribution

9 Filler DECIMAL 20,2 O O NULL

10 POP-SP Header Record INTEGER 20 M M
Hash
 Subscriber Details Record
Sr. No Field Name Data Type Size M/O M/O Valid Values
Correction
Regular (C)
(R)
1 Line Number INTEGER 9 M M

2 Record Type CHAR 2 M M SD

3 Batch Number INTEGER 9 M M 1

4 POP-SP Serial Number INTEGER 9 M M

5 Serial No. INTEGER 9 M M

 6 PRAN INTEGER 12 M M

7 Employer’s Contribution DECIMAL 20,2 M M

amount

8 Subscriber’s contribution DECIMAL 20,2 M M

amount

9 Filler DECIMAL 20,2 NULL

10 Total Contribution DECIMAL 20,2 M M
amount for the
subscriber

11 Contribution Type CHAR 1 M M U - Tier I

contribution

T - Tier II
contribution
12 Filler INTEGER 2 M M

13 Filler INTEGER 4 M M

14 Receipt No. INTEGER 17 M M

15 Subscriber Detail Record INTEGER 20 O O

Hash
Contribution File-Format

ine character.
ord Type', 'Upload Type' etc.) need to be mentioned
d be specified as 'FH' and not 'fh'.
and needs to be mentioned within the file.

after the Batch Header.

fter each POP-SP Header record.
riber detail record of the first POP-SP header.

Description Validations (Regular File) Validations (Correction File)

Running sequence number for each Length should be less than or equal to
line in the file. For File Header 9 digits.
Record value will be 1 Must NOT be - '0', 'NULL', 'Space',
'Special Characters', 'Decimal', 'Non-
numeric character', 'Negative Number'.
For File Header record value must
always be equal to '1'.
Length should be less than or
equal to 9 digits. Must NOT be -
'0', 'NULL', 'Space', 'Special
Characters', 'Decimal', 'Non-
numeric character', 'Negative
Number'.For File Header record
value must always be equal to '1'.

Value should be "FH" signifying Only Value allowed is "FH". Must NOT be - Only Value allowed is "FH". Must
"File Header" record 'NULL', 'Space', 'Numeric character', NOT be - 'NULL', 'Space', 'Numeric
'Special Characters'. character', 'Special Characters'.

Value should be "U" for Tier-1/Tier- Value should be equal to "U". Must Value should be equal to "U".
2 contribution of Unorganized NOT be - 'NULL', 'Space', 'Numeric Must NOT be - 'NULL', 'Space',
sector subscribers and/or for Tier-2 character', 'Special Characters'. 'Numeric character', 'Special
contribution of Central Characters'.
Government/State Government
subscribers.
Reg. No. of the uploading entity.
If POP uploads the file , POP Reg.
No. should be entered in this field.
If POP-SP uploads the file , POP-
SP Reg. No. should be entered in
this field.
Only numeric values are allowed. Must
NOT be - '0', 'NULL', 'Space', 'Special
Characters', 'Decimal', 'Alphabets',
'Negative Number'. Length should be
exactly 7 digits for POP / POP-SP
Reg. No.
Only numeric values are allowed.
Must NOT be - '0', 'NULL',
'Space', 'Special Characters',
'Decimal', 'Alphabets', 'Negative
Number'. Length should be
exactly 7 digits for POP / POP-SP
Reg. No.

Number of batches will contain the Value must be = 1. Value must be = 1.

value for the total number of batch
records present in the file. This will
always be equal to 1.This field is
a provision for future use if more
than one batches per file are
required.
Value should be Numeric and Must Value should be Numeric and
NOT be - 'NULL', 'Space','Negative Must NOT be - 'NULL',
Number', 'Special Characters'. 'Space','Negative Number',
'Special Characters'.

Must be NULL for the file prepared. Must be Null for input file to the FVU. Must be Null for input file to the FVU.
The hash value of the record
created and appended by the FVU.

Must be NULL for the input file to Must be Null for input file to the FVU. Must be Null for input file to the FVU.
FVU. The FVU version is appended
by FVU. This field is used during
validation in NPSCAN system

Must be NULL for the input file to Must be NULL for input file to FVU. This Must be NULL for input file to FVU.
FVU. The hash value of the each value is calculated and appended by FVU. This value is calculated and
record and the File calculated and appended by FVU.
appended by FVU.

This is a filler field for future use Will be Spaces Will be Spaces
This is a filler field for future use Will be Spaces Will be Spaces
This is a filler field for future use Will be Spaces Will be Spaces
This is a filler field for future use Will be Spaces Will be Spaces

Description Validations (Original File) Validations (Correction File)

Running sequence number for each Can only be a numeric character I.e. Must
line in the file NOT be - '0', 'NULL', 'Space', 'Special
Characters', 'Decimal', 'Non-numeric
character', 'Negative Number'. Length
should be less than or equal to 9 digits.
Can only be a numeric character I.e.
Must NOT be - '0', 'NULL', 'Space',
'Special Characters', 'Decimal', 'Non-
numeric character', 'Negative
Number'. Length should be less than
or equal to 9 digits.
Value should be "BH" (Batch
Header) for the batch header record 'NULL', 'Space', 'Numeric character',
Value should indicate batch no. of
the current batch.
R / C. R - Original, C - Correction
If POP uploads the file , POP Reg.
No. should be entered in this field.
If POP-SP uploads the file , POP-
SP Reg. No. should be entered in
this field.
Date of creation of the '.txt' file.
Date should be in ddmmyyyy
format.
Batch Id generated and appended
by the FPU.Identification Key in
case of duplicate file upload by
POP / POP-SP.
Only Value allowed = "BH". Must NOT be - Only Value allowed = "BH". Must
NOT be - 'NULL', 'Space', 'Numeric
'Special Characters'.
Length should be less than or equal to
9 digits.
Must NOT be - '0', 'NULL', 'Space',
'Special Characters', 'Decimal', 'Non-
numeric character', 'Negative Number'.
Value should be equal to "R". Must
NOT be - 'NULL', 'Space', 'Numeric
character', 'Special Characters'.
Only numeric values are allowed. Must
NOT be - '0', 'NULL', 'Space', 'Special
Characters', 'Decimal', 'Alphabets',
'Negative Number'. Length should be
exactly equal to 7 digits.
Can only be a numeric character I.e.
Must NOT be - '0', 'NULL', 'Space',
'Special Characters', 'Decimal', 'Non-
numeric character', 'Negative
Number'.Length should be exactly
equal to 8 digits. Date should be in
DDMMYYYY format
This value will be generated and
appended by FPU
character', 'Special Characters'.
Length should be less than or
equal to 9 digits.
Must NOT be - '0', 'NULL',
'Space', 'Special Characters',
'Decimal', 'Non-numeric
character', 'Negative Number'.
Value should be equal to "C".
Must NOT be - 'NULL', 'Space',
'Numeric character', 'Special
Characters'.
Only numeric values are allowed.
Must NOT be - '0', 'NULL',
'Space', 'Special Characters',
'Decimal', 'Alphabets', 'Negative
Number'. Length should be
exactly equal to 7 digits.
Can only be a numeric character
I.e. Must NOT be - '0', 'NULL',
'Space', 'Special Characters',
'Decimal', 'Non-numeric
character', 'Negative
Number'.Length should be exactly
equal to 8 digits. Date should be
in DDMMYYYY format
This value will be generated and
appended by FPU
Unique Transaction Id generated by Should be NULL for an original file.
NPSCAN on successful processing
of an original file.
No of POP-SP Headers present in Should be equal to total number of
the file for the corresponding batch POP-SP Header Records present for
header the corresponding batch. Count should
be >= 1
Total number of Subscriber Detail Should be same as sum of values in
records across all POP-SP headers field "Total No Of Subscribers" across
all POP-SP headers.Count should be
>= 1
The value here should be same as Length<=21. i.e., The amount should
sum of values in field "Control Total be rounded off to two decimal places.
for Employer’s Contribution" across Eg., 50.75 Must NOT be '0', 'NULL',
all POP-SP header records. 'Space', 'Special Characters',
'Decimal', 'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must be >=
0.00
The value here should be same as Length<=21. i.e., The amount should
sum of values in field "Control Total be rounded off to two decimal places.
for Subscriber’s contribution" across Eg., 50.75 Must NOT be '0', 'NULL',
all POP-SP header records. 'Space', 'Special Characters',
'Decimal', 'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must be >
0.00
This is a filler field for future use Will be Spaces
Mandatory Field in case of
correction type of file.Should be
the transaction id of the original
file (file for which correction file is
being uploaded)
Should be equal to total number
of POP-SP Header Records
present for the corresponding
batch. Count should be >= 1
Should be same as sum of values
in field "Total No Of Subscribers"
across all POP-SP headers.Count
should be >= 1
Length<=21. i.e., The amount
should be rounded off to two
decimal places. Eg., 50.75 Must
NOT be '0', 'NULL', 'Space',
'Special Characters', 'Decimal',
'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must
be >= 0.00
Length<=21. i.e., The amount
should be rounded off to two
decimal places. Eg., 50.75 Must
NOT be '0', 'NULL', 'Space',
'Special Characters', 'Decimal',
'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must
be > 0.00
Will be Spaces
 The value here should be same as Length<=21. i.e., The amount should
sum of values in fields "Control be rounded off to two decimal places.
Total for Employer’s Contribution " Eg., 50.75 Must NOT be '0', 'NULL',
and "Control Total for Subscriber’s 'Space', 'Special Characters',
contribution" in the Batch Header 'Decimal', 'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must be >
0.00
The Hash Code of the Record. Must be Null for FVU.Mandatory for
Record level hash is appended by uploaded file in the central system.
the FVU and Mandatory in
uploaded File
POP-SP Header Record
Description Validations (Regular File)
Running sequence number for each Can only be a numeric character I.e. Must
line in the file NOT be - '0', 'NULL', 'Space', 'Special
Characters', 'Decimal', 'Non-numeric
character', 'Negative Number'. Length must numeric character', 'Negative
e less than or equal to 9 digits
Value should be "DH" for the POP- Only Value allowed = "DH". Must NOT be - Only Value allowed = "DH". Must
SP header record 'NULL', 'Space', 'Numeric character', NOT be - 'NULL', 'Space', 'Numeric
'Special Characters'.
Value should indicate batch no. of Length should be less than or equal to
the current batch. 9 digits.
Value should be Numeric. Must NOT
be - '0', 'NULL', 'Space', 'Special
Characters', 'Decimal', 'Non-numeric
character', 'Negative Number'.
Length<=21. i.e., The amount
should be rounded off to two
decimal places. Eg., 50.75 Must
NOT be '0', 'NULL', 'Space',
'Special Characters', 'Decimal',
'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must
be > 0.00
Must be Null for FVU.Mandatory for
uploaded file in the central system.
Validations (Correction File)
Can only be a numeric character I.e.
Must NOT be - '0', 'NULL', 'Space',
'Special Characters', 'Decimal', 'Non-
Number'. Length must e less than or
equal to 9 digits
character', 'Special Characters'.
Length should be less than or
equal to 9 digits.
Value should be Numeric. Must
NOT be - '0', 'NULL', 'Space',
'Special Characters', 'Decimal',
'Non-numeric character',
'Negative Number'.
Running sequence number for each Length should be less than or equal to
POP-SP header record in the file 9 digits.
Value should be Numeric and negative
values are not accepted. Should be in
sequence
Length should be less than or
equal to 9 digits.
Value should be Numeric and
negative values are not accepted.
Should be in sequence

Reg. No. of the POP-SP where the Only numeric values are allowed. Must
subscriber has submitted his NOT be - '0', 'NULL', 'Space', 'Special
contribution. Characters', 'Decimal', 'Alphabets',
'Negative Number'. Length should be
exactly equal to 7 digits.
Only numeric values are allowed.
Must NOT be - '0', 'NULL',
'Space', 'Special Characters',
'Decimal', 'Alphabets', 'Negative
Number'. Length should be
exactly equal to 7 digits.

Total number of subscribers
contribution details for each POP-
SP Header.
Can only be a numeric character I.e. Must
NOT be - '0', 'NULL', 'Space', 'Special
Characters', 'Decimal', 'Non-numeric
character', 'Negative Number'. Length must
be less than or equal to 9 digits
Can only be a numeric character I.e.
Must NOT be - '0', 'NULL', 'Space',
'Special Characters', 'Decimal', 'Non-
numeric character', 'Negative
Number'. Length must e less than or
equal to 9 digits

The value here should be same as
sum of values in field "Employer’s
Contribution amount" across all
Subscriber records of the POP-SP.
Length<=21. i.e., The amount should
be rounded off to two decimal places.
Eg., 50.75 Must NOT be '0', 'NULL',
'Space', 'Special Characters',
'Decimal', 'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must be >=
0.00
Length<=21. i.e., The amount
should be rounded off to two
decimal places. Eg., 50.75 Must
NOT be '0', 'NULL', 'Space',
'Special Characters', 'Decimal',
'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must
be >= 0.00

The value here should be same as
sum of values in field "Subscriber’s
contribution amount" across all
Subscriber records of the POP-SP.
Length<=21. i.e., The amount should
be rounded off to two decimal places.
Eg., 50.75 Must NOT be '0', 'NULL',
'Space', 'Special Characters',
'Decimal', 'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must be >
0.00
Length<=21. i.e., The amount
should be rounded off to two
decimal places. Eg., 50.75 Must
NOT be '0', 'NULL', 'Space',
'Special Characters', 'Decimal',
'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must
be > 0.00

Filler field for future use. Should be spaces Should be spaces

The Hash Code of the Record. . Must be Null for FVU Mandatory for
Rcord level hash is appended by SAM/SCM and uploaded file in the
the FVU and Mandatory in central system.
SAM/SCM and uploaded File
ils Record
Description Validations (Regular File) Validations (Correction File)

Running sequence number for each Can only be a numeric character I.e. Must
line in the file NOT be - '0', 'NULL', 'Space', 'Special
Characters', 'Decimal', 'Non-numeric
character', 'Negative Number'. Length
should be less than or equal to 9 digits.
Can only be a numeric character I.e.
Must NOT be - '0', 'NULL', 'Space',
'Special Characters', 'Decimal', 'Non-
numeric character', 'Negative
Number'. Length should be less than
or equal to 9 digits.

Value "SD" (Subscriber Detail) for Value should be 'SD - Must NOT be 'NULL', Value should be 'SD - Must NOT be
Subscriber Detail record 'Space', 'Numeric character'. 'NULL', 'Space', 'Numeric character'.

Value should indicate batch no. of
the current batch.
Length should be less than or equal to
9 digits.
Value should be Numeric. Must NOT
be - '0', 'NULL', 'Space', 'Special
Characters', 'Decimal', 'Non-numeric
character', 'Negative Number'.
Length should be less than or
equal to 9 digits.
Value should be Numeric. Must
NOT be - '0', 'NULL', 'Space',
'Special Characters', 'Decimal',
'Non-numeric character',
'Negative Number'.

Sequence number specified in the
corresponding POP-SP header
record in the file.
Length should be less than or equal to
9 digits.
Value should be Numeric. Must NOT
be '0', 'NULL', 'Space', 'Special
Characters', 'Decimal', 'Non-numeric
character', 'Negative Number'.
Length should be less than or
equal to 9 digits.
Value should be Numeric. Must
NOT be '0', 'NULL', 'Space',
'Special Characters', 'Decimal',
'Non-numeric character',
'Negative Number'.

Serial No. assigned to each SD
Record. Running serial number
starting with 1.
Should start with '1'. Can only be a
numeric character I.e. Must NOT be
'0', 'NULL', 'Space', 'Special
Characters', 'Decimal', 'Non-numeric
character', 'Negative Number'.
Should start with '1'. Can only be
a numeric character I.e. Must
NOT be '0', 'NULL', 'Space',
'Special Characters', 'Decimal',
'Non-numeric character',
'Negative Number'.
Permanent Retirement Account Can only be a numeric character I.e.
Number Must NOT be '0', 'NULL', 'Space',
'Special Characters', 'Decimal', 'Non-
numeric character', 'Negative Number'.
Can only be a numeric character
I.e. Must NOT be '0', 'NULL',
'Space', 'Special Characters',
'Decimal', 'Non-numeric
character', 'Negative Number'.

Employer's contribution to individual Length<=21. i.e., The amount should
subscriber’s account be rounded off to two decimal places.
Eg., 50.75 Must NOT be '0', 'NULL',
'Space', 'Special Characters',
'Decimal', 'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must be >=
0.00 if Contribution Type = 'U' and
must be 0.00 if Contribution Type = 'T'.
Length<=21. i.e., The amount
should be rounded off to two
decimal places. Eg., 50.75 Must
NOT be '0', 'NULL', 'Space',
'Special Characters', 'Decimal',
'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must
be >= 0.00 if Contribution Type =
'U' and must be 0.00 if
Contribution Type = 'T'.

Individual subscriber's contribution
amount
Length<=21. i.e., The amount should
be rounded off to two decimal places.
Eg., 50.75 Must NOT be '0', 'NULL',
'Space', 'Special Characters',
'Decimal', 'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must be >
0.00
Length<=21. i.e., The amount
should be rounded off to two
decimal places. Eg., 50.75 Must
NOT be '0', 'NULL', 'Space',
'Special Characters', 'Decimal',
'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must
be > 0.00

Filler field for future use. Should be Spaces Should be Spaces

The value here should be same as
sum of values in fields "Employer's
Contribution amount" and
"Subscriber’s contribution amount"
for each subscriber.
Length<=21. i.e., The amount should
be rounded off to two decimal places.
Eg., 50.75 Must NOT be '0', 'NULL',
'Space', 'Special Characters',
'Decimal', 'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must be >
0.00
Length<=21. i.e., The amount
should be rounded off to two
decimal places. Eg., 50.75 Must
NOT be '0', 'NULL', 'Space',
'Special Characters', 'Decimal',
'Non-numeric character',
'Negative Number'.
Value should be Decimal. Must
be > 0.00

Value must be 'U' for Tier I Value must be 'U' or 'T'. Values other Value must be 'U' or 'T'. Values
contribution and 'T' for Tier II than 'U' or 'T' are not allowed. other than 'U' or 'T' are not
contribution. allowed.
Value must be null (filler field for
unorganized sector and Tier II)
Value must be null (filler field for
unorganized sector and Tier II)
Receipt No. given to the
subscribers by POP-SP
The Hash Code of the Record.
Record level hash is appended by
the FVU and Mandatory in
SAM/SCM and uploaded file
Value must be null
Value must be null
Length should be exactly equal to 17
digits. Value should be Numeric. Must
NOT be '0', 'NULL', 'Space', 'Special
Characters', 'Decimal', 'Non-numeric
character', 'Negative Number'.
Must be Null for FVU Mandatory for
SAM/SCM and uploaded file in the central
system.
Value must be null
Value must be null
Length should be exactly equal to
17 digits. Value should be
Numeric. Must NOT be '0',
'NULL', 'Space', 'Special
Characters', 'Decimal', 'Non-
numeric character', 'Negative
Number'.
Must be Null for FVU Mandatory for
SAM/SCM and uploaded file in the
central system.