You are on page 1of 22

Document on PMJJBY System Integration with Banks

LIC's system integration specification document.


(Version 2.0)

Annexure 1 - Technical Document for SFTP OR Data to be sent to LICs P&GS Unit
via e-mail.
Annexure 2 - Technical Document for Web services .

For any technical queries, please send mail to co_pgssdc@licindia.com or call us at 022-66598595 /
022-66598819

20th May 2015

Page 1

Annexure - 1

Technical Document for SFTP as well as Data to be sent to LICs P&GS Unit
under PMJJBY

1) Introduction
This document details the requirement of banks to use SFTP Interface of LIC for sending data
under Pradhan Mantri Jeevan Jyoti Yojana (PMJJBY). The file formats described hereunder be
used for sending data to P&GS Unit of LIC, which is servicing the policy. This document talks
about different file formats. This document will be used by the banks to send the data of
account-holders whose saving bank account has been auto-debited with premium. The bank will
credit the premium to LICs P&GS Unit Bank Account for a set of accountholders and then
provide the details of such account holders against the UTR/Ref. No. of payment to LIC.
In case the size of the data and control files is small (size less than or equal to 5 MB) , then the
data may be sent via e-mail to the concerned LIC P&GS unit with whom the bank has signed the
MOU.
2) Interface Specification details for PMJJBY
i) Registration with LIC using SFTP :
a) The Bank should send their request for using SFTP interface on co_pgssdc@licindia.com
with following information
b) LIC will convey the decision on the e-mail used for sending the request.
c) If LIC has allowed any bank to use this interface, the bank should send the following on the
above e-mail address :
(a) Banks IP address for white listing at LIC end.
(b) Banks E-Mail address to share user id.
(c) Declaration from the Bank in the same e-mail as to The files with specified file
naming convention containing data in required format will be uploaded to LICs SFTP
Server and no other file like exe, shell, batch, jpeg,gif etc. will be uploaded
d) Admin User of LIC will create SFTP user for the bank and will send the user id and
password, on the e-mail address provided by the Bank.

ii) Type of Files :


The banks will send LIC following files against a UTR/Ref. No. :
a) Input Data Files :
A text file (with file extension .csv) containing details of account holders for whom
premium has been credited to LICs bank Account. If the number of account holders, for
whom premium has been paid under a UTR No. go beyond 25,000 then separate data
file for each set of records up to 25000 per data file should be prepared. Each data file
will be treated as a batch of records. This will be a comma separated (delimited) file.
b) Input Control File :
A text file (with file extension .ctl) containing control record/s for the data in one or

Page 2

more than one Input Data Files. This file will be used to check receipt of entire data in
input data file/s against a UTR No. This will be a comma separated (delimited) file.

iii) File Naming Convention :


a) Input Data File :
<UTR/Ref. No. (22 digits)>-<Batch Id (3 digits)>-<Batch Date (8 digits)>.csv
Example : YESBR52015033100005075-001-20150601.CSV
Total length of Input Data File Name : 39 characters (inclusive of file extension)
All characters in file name should be in UPPER CASE only.
UTR/Ref. No. : 22 digit UTR No. or 16 digit Ref. no. or any other no. used for crediting
premium to LICs P&GS Unit Bank Account. This no. will be used by LIC for
confirming receipt of premium in bank statement and mapping the data of
account holders received. If this no. is less than 22 digits, it should be prefixed with zeros.
Batch Id

: It is a unique number for a set of records in a data file. It should be within


a range of 100 to 999. Each data file will have unique batch id. The batch
id should be a unique consecutive number for a batch date E.g. if data
files are created on 01/06/2015, then each data file will have unique
consecutive batch id on that day. The bank may repeat the batch id used
on 01/06/2015 on next day i.e. 02/06/2015 onwards.

Batch Date : The date on which batch has been prepared. The format will be YYYYMMDD.
E.g. If Batch date is 01/06/2015 then it should be 20150601
b) Input Control File :
<UTR/Ref No. (22 digits)>-<First Batch Id (3 digits)>-<Last Batch Id (3 digits)>-<Batch Date (8 digits)>.ctl

Example : YESBR52015033100005075-100-102-20150601.CTL
Total length of Input Data File Name : 43 characters (inclusive of file extension)
All characters in file name should be in UPPER CASE only.
UTR/Ref. No. : 22 digit UTR No. or 16 digit Ref. no. or any other no. used for crediting
premium to LICs P&GS Unit Bank Account. This no. will be used by LIC for
confirming receipt of premium in bank statement and mapping the data of
account holders received. If this no. is less than 22 digits, it should be prefixed with zeros.
First Batch Id : Batch id of the first batch/file.
Last Batch Id : Batch id of the last batch/file.
Batch Date : The date on which batch has been prepared. The format will be YYYYMMDD.

Page 3

The bank may credit the premium to LICs bank account by following modes :
(1) By RTGS or NEFT, in which UTR No./Ref. No. is generated.
(2) By crediting LICs account in their bank, in case LIC is having bank account in the same
bank, which is going to upload the data. The bank will generate some unique no. to
identify the transaction.
The examples of file names for different mode of payments are given below :
Sr.
No.

Mode of
Payment

RTGS

NEFT

A/C
with
same bank

UTR/Ref. No.

File Name

YESBR52015033100005075
(Alpha-numeric no. without
special characters)
CMS292330258
(Alpha-numeric no. without
special characters)
01/002003
(Alpha-numeric no. with
special characters)

YESBR52015033100005075-001-20150601.CSV
(Pre-fix zeros for UTR No. less than 22 digits)
000000CP15123513510020-001-20150601.CSV
(Pre-fix zeros for UTR no. less than 22 digits)
0000000000000001002003-001-20150601.CSV
(Remove special characters keep only Alphanumeric characters)

iv) File size :


An input data file should contain maximum 25000 records. If the total number of records
against a UTR/Ref No. go beyond 25,000, then separate files containing records upto 25,000
per each file should be prepared. In that case, each input data file will be a separate batch
and will bear a unique consecutive number as batch id.
v) Case Example showing File Naming Convention :
A bank makes payment of premium via RTGS under UTR No. YESBR52015033100005075 for
60,000 records on 01/06/2015 and wants to send the data. It has to prepare three input data
files and one control file. The bank decides to use three consecutive unique no. 1,2 and 3 as
batch ids. The bank will have to use following information to name the files.
UTR No. : YESBR52015033100005075
Batch Ids : 100,101,102
Batch Date : 01/06/2015
The name of files will be as given below :
Input Data file names :
Sr.
Input Data File Name
No.
1
YESBR52015033100005075-100-20150601.CSV
2
YESBR52015033100005075-101-20150601.CSV
3
YESBR52015033100005075-102-20150601.CSV
Total No. of Records

No. of
records
25,000
25,000
10,000
90,000

Input Control file name : YESBR52015033100005075-100-102-20150601.CTL


vi) Data Format :

Page 4

Input Control File :


Field Name

Expected Data
Type

Data
Length

Mandatory
(M) /
Optional

Data
Format

Description

(O)

10
39

M
M

Master Policy No. issued by LIC

UTR_Ref_No

Numeric
Alpha-numeric
inclusive of
special character
Alpha-numeric

22

UTR_Ref_Date

Numeric

BatchId
BatchDate

Numeric
Numeric

3
8

22 digit UTR No. or 16 digit Ref.


no. or any other no. used for
crediting premium to LICs
P&GS Unit Bank Account
Date of Credit in LICs Bank
Account
Batch Id - As explained earlier

NoOfRecords
FileSize

Numeric
Numeric

5
10

PolicyNo
InputDataFileName

YYYYMMDD

YYYYMMDD

M
M
M
M

Name of Input Data File with


file extension as .csv

The date on which batch has


been prepared.
Maximum upto 25,000
File size in bytes. The value
should be less than
1073741824 i.e. less than
10MB

Input Data File :


Field Name

Expected Data
Type

Data
Length

Data
Format

Mandatory
(M) /
Optional

Description

(O)

BankIFSC
RuralUrban

Alpha-numeric
Alpha-numeric

11
10

M
O

AccountHolderName
Gender

Alpha-numeric
Alphabetic

50
1

M
M

DOB
BankAccountNo

Numeric
Alpha-numeric

8
30

BankCustomerId

Alpha-numeric

30

AadharNo
PanCardNo
Pincode
MobileNo
EmailId
DOA

Numeric
Alpha-numeric
Numeric
Numeric
Alpha-numeric
Numeric

12
10
6
12
50
8

YYYYMMDD

O
O
M
O
O
M

DOJ

Numeric

YYYYMMDD

NomineeName
NomineeRelation

Alpha-numeric
Numeric

50
2

O
O

NomineeAge
AppointeeName

Numeric
Alpha-numeric

3
50

O
O

YYYYMMDD

Page 5

M
M

IFSC of the bank


Metro / Urban/Rural/Semi Urban type of a/c holder
Name of the a/c holder
Gender of the a/c holder
M-Male;F-Female;
T-Transgender
Date of Birth of a/c holder
Bank Account Number of a/c
holder
Unique Customer Ref Id as per
bank records
Aadhar number of a/c holder
Pan Card Number of a/c holder
Pin code of the a/c holder
Mobile Number of a/c holder
Email Id of a/c holder
Date of opening the savings
account by the a/c holder
Date of Enrolment into the
PMJJBY scheme
Name of the Nominee
Relation of nominee to the a/c
holder (**)
Age of the nominee
Name of appointee , in case of
minor nominee

**Nominee Relation codes to be used are as follows


Code

Relation

Code

1
2
3
4
5
6
7
8
9
10

SELF
WIFE
FATHER
MOTHER
SON
DAUGHTER
BROTHER
SISTER
FATHER IN LAW
MOTHER IN LAW

11
12
13
14
15
16
17
18
99

Relation
GRANDSON
GRANDDAUGHTER
GRANDFATHER
GRANDMOTHER
BROTHER IN LAW
SISTER IN LAW
HUSBAND
GUARDIAN
OTHERS

vii) Sample data in files :


Input Control File :
Sample Data :
Field Name

PolicyNo
InputDataFileName
UTR_Ref_No
UTR_Ref_Date
BatchId
BatchDate
NoOfRecords
FileSize

First Record

9001000010
YESBR52015033100005075100-20150601.CSV
YESBR52015033100005075
20150601
100
20150601
25000
7586523

Second Record

9001000010
YESBR52015033100005075101-20150601.CSV
YESBR52015033100005075
20150601
101
20150601
938
281400

Sample Records to be prepared for sending two input data files with batch id 100 & 101
against single UTR/Ref. No.
9001000010,YESBR52015033100005075-100-20150601.CSV,YESBR52015033100005075,
20150601,100,20150601,25000,7586523
9001000010,YESBR52015033100005075-101-20150601.CSV,YESBR52015033100005075,
20150601,101,20150601,938,281400

Page 6

Input Data File :

Sample Data :

Field Name

BankIFSC

First Record
(With Nominee & Appointee
Details)
ABABAB12366

Second Record
(Without Nominee Details)

RuralUrban

Urban

AccountHolderName

Ramesh Tendulkar

Asha Desai

Gender

DOB

19900504

19810610

BankAccountNo

3214596977

3214596978

BankCustomerId

123654

123656

AadharNo

689654789632

123654789632

PanCardNo

AWEDF5897H

STEDF5897P

Pincode

456987

456990

MobileNo

96385274123

8828527424

EmailId

ABC@GMAIL.COM

PQR@HOTMAIL.COM

DOA

20100512

20150507

DOJ

20150601

20150601

NomineeName

RAJU1

NomineeRelation

NomineeAge

17

AppointeeName

Miss Meena

ABABAB12365

Sample Record with nominee and appointee details :


The record has been wrapped into three lines. Hence it is one line record.
ABABAB12366,Urban,Ramesh Tendulkar ,M, 19900504,3214596977,123654,689654789632,
AWEDF5897H,456987,96385274123, ABC@GMAIL.COM,20100512, 20150601,RAJU1,
1,17,Miss Meena

Page 7

Sample Record without nominee details :


The record has been wrapped into three lines. Hence it is one line record.
ABABAB12365,,Asha Desai ,F,19810610,3214596978,123656,123654789632,
STEDF5897P,456990,8828527424, PQR@HOTMAIL.COM,20150507,20150601,,,,
viii) Timelines for using the Interface :
The banks may use the interface at the end of the day as per their conveyance.

Page 8

Annexure - 2
Technical Document for PMJJBY Member Enrolment using Webservices :
The purpose of this document is to provide information regarding data exchange between LIC and
Banks, who will be Master Policy holders of LIC for Pradhan Mantri Jeevanjyoti Bima Yojana
(PMJJBY).

Reference to MOU between LIC & Bank and Rules of this Scheme is invited before reading
this document.
This document covers following area :
1. Process Flow
2. XML Formats of REQUEST and RESPONSE
3. Data Types of REQUEST and RESPONSE

1) Bank receives consent for coverage under PMJJBY from a saving bank account holder.
2) Bank confirms eligibility of the accountholder and issues the acknowledgement for consent.
3) Bank consolidates data of eligible accountholders at centralised server and sends it to LIC in
batches of maximum 50 records per batch, in the prescribed format.
4) For this, LIC has now hosted 3 web services (WS) viz WS1 , WS2 and WS4 .
Points 5 to 15 pertains to WS1 and WS2 and points 16 to 17 pertains to WS4.
5) Bank uses a web service hosted/exposed by LIC, called Web Service 1 to upload a batch at
a time.
6) LIC receives a batch containing data.
7) LIC validates the data from the point of view of irregularities in the data structure and
format and checks for de-duplication of data based on IFSC , account number and the unique
customer id , by using the LICs database of members under PMJJBY.
8) LIC provides response under Web Service 1, by way of status against each record of
account holder. There can be three types of status viz. eligible account holders and records
of account holders with errors related to data format. The third type of error would be
outcome of some programming error in extraction of data at banks end. (The bank has to
ensure that they have received a response for a batch already sent, before sending the
next batch.)
( As requested by various banks, this operation of waiting for response from LIC no longer
exists).
9) Bank debits Rs.330/= from eligible account holders towards annual premium. Before
debiting the annual premium, bank must ensure that eligibility of the accountholder has
been confirmed using LICs Web Service 1.
10) Bank consolidates data of account holders, whose account has been debited with annual
premium.

Page 9

11) Bank credits total premium recovered from account holders (No. of eligible account holder
multiplied by Rs.289/=) to LICs Bank A/C as a single payment on daily basis. The premium
would be credited to Bank A/C of LICs designated P&GS Unit.
12) Bank consumes LICs second web service called Web Service 2 to provide details of
account holders, whose premium has been credited to LICs Bank A/C. For uploading this
data, bank prepares data in batches of maximum 50 records per batch, in the prescribed
format. Each batch of records would be tagged with a unique "Cluster Id", the same UTR
No., Premium Credit Date, total no. of accountholders under all the batches and amount of
premium credited, for which total premium has been paid to LIC. Hence, the total of
account holders, whose data has been uploaded in all batches tagged with same UTR No.
and payment date, must be equal to the no. of account holders for whom premium has been
credited to LICs bank A/C. Any mismatch of data at this stage would generate complexity
at a later stage. Bank has also to ensure that the data of account holders for web service 2
must have passed through eligibility test under web service 1, otherwise the data will go
into errors.
Note : An example for the WS2
:
Lets assume that batch no 10001 comprising of 48 records , batch no 10002 comprising of
50 records were uploaded through WS1 and a response for the same was received, where
the 48 records of batch 10001 are valid and only 40 records of batch 10002 are valid.
The bank can now make a neft / rtgs payment for these 88 valid members. Once payment is
done, the bank can send a request on WS2 by making clusters of maximum 50 records
each(giving one unique cluster id for one lot), under the UTR number generated for the
payment of 88 records.
13) LIC provides positive response by way of acknowledgement, to the request through Web
service 2, for every cluster of data so received.
14) LIC merges the records received under all the clusters with same UTR No., Premium Credit
Date and tallies it with the total number of accountholders tagged.
15) LIC will map UTR No., Premium Credit date and total no. of account holders received under
Web Service 2 with UTR No., date and amount of credit as per Bank Statement of LICs
designated P&GS Unit, whose Bank A/C was credited with total premium amount. This
process will take place at LICs designated P&GS Unit.
16) In case, the bank decides to upload the data ONLY after the premium is debited from the
account holders' accounts , then the bank needs to consume only one web service viz. Web
Service 4. Here web service 4 will be a single service which clubs both web service 1 and web
service 2, wherein the bank will upload the members' data along with the payment details.
17) LIC will map UTR No., Premium Credit date and total no. of account holders received under
Web Service 4 with UTR No., date and amount of credit as per Bank Statement of LICs
designated P&GS Unit, whose Bank A/C was credited with total premium amount. This
process will take place at LICs designated P&GS Unit. The response to this service will be a
member wise status of the data with the same error codes and interpretations used in the
response of web service 1.
18) The data types and general conditions for the data are given in an annexure at the end of
the document.

Page
10

WEB SERVICE 1 To upload enrolled Member Data

XML Format of REQUEST to Web Service 1


<?xml version="1.0" encoding="iso-8859-1"?>
<PmjbyMemberDataRQ>
<PolicyData>
<PolicyDetails BankIdentifier="ABC Bank" PolicyNo="900789654" />
</PolicyData>
<MemberData>
<MemberDetails
BankIFSC="ABC20000001"
RuralUrban="RURAL"
AccountHolderName="XYZ JAHGD"
Gender="M"
DOB="19720701"
BankAccountNo="1236543RR123"
BankCustomerId="1236547"
AadharNo="201236547896"
PanCardNo="AYTRH8951W"
Pincode="421430"
MobileNo="9696874563"
EmailId="abdcdf@gmail.com"
DOA="20100512"
DOJ="20150601"
NomineeName="MAGAN KORHALE"
NomineeRelation="5"
NomineeAge="25"
AppointeeName="NULL"/>
<MemberDetails
BankIFSC="ABC20000001"
RuralUrban="RURAL"
AccountHolderName="AGDB HGFFG"
Gender="M"
DOB="19730523"
BankAccountNo="1236543RE564"
BankCustomerId="1987465547"
AadharNo="682147621424"
PanCardNo="REDFF8547N"
Pincode="452430"
MobileNo="9696852147"
EmailId="agsghsh@gmail.com"
DOA="19950104"
DOJ="20150601"
NomineeName="HSDDD DDREEWK"

Page
11

NomineeRelation="4"
NomineeAge="5"
AppointeeName="Mr SHAKDS FFF" />
</MemberData>
<SummaryDetails
WebServiceId="1"
BatchId="10001"
DateofSubmission="20150505"
TotalRecordsInBatch="2" />
</PmjbyMemberDataRQ >

XML Format of RESPONSE from Web Service 1 :


<?xml version="1.0" standalone="yes"?>
<PmjbyMemberDataRS>
<PolicyData>
<PolicyDetails BankIdentifier="ABC Bank" PolicyNo="900789654" />
</PolicyData>
<MemberData>
<MemberDetails
BankIFSC="ABC20000001"
BankAccountNo="1236543RR123"
BankCustomerId="1236547"
MemberStatus="E"
ErrorCode="0"/>
<MemberDetails
BankIFSC="ABC20000001"
BankAccountNo="1236543RE564"
BankCustomerId="1987465547"
MemberStatus="R"
ErrorCode="2"/>
</MemberData>
<SummaryDetails WebServiceId="1" LICResponseTypeId="1" LICReferenceId="101"
BatchId="10001" DateOfReceipt="20150505" TotalRecords="2"
TotalEligible="1" TotalDuplicates="0" TotalError="1"
Status="True" Description="Data Processed"/>
</PmjbyMemberDataRS>

Page
12

WEB SERVICE 2 (For Payment Particulars of PMJJBY Members who have passed eligibility test under
Web Service 1)

XML Format of REQUEST to Web Service 2


<?xml version="1.0" encoding="iso-8859-1"?>
<PmjbyPaymentDataRQ>
<PaymentData>
<PaymentDetails BankIdentifier="ABC Bank" PolicyNo="900789654"
UTRNumber="ABC4236997411115" PaymentDate="20150601" ClusterId="1001"/>
</PaymentData>
<MemberPaymentData>
<MemberPayDetails
BatchId="10001"
BankIFSC="ABC20000001"
BankAccountNo="1236543RR123"
BankCustomerId="123467" />
<MemberPayDetails
BatchId="10002"
BankIFSC="ABC20000001"
BankAccountNo="1236543RE564"
BankCustomerId="1987465547" />
</MemberPaymentData>
<SummaryDetails
WebServiceId="2"
DateofSubmission="20150601"
TotalRecords="2"
TotalAmount="578" />
</PmjbyPaymentDataRQ >

XML Format of RESPONSE from Web Service 2


<?xml version="1.0" standalone="yes"?>
<PmjbyPaymentDataStatusRS >
<PaymentData>
<PaymentDetails BankIdentifier="ABC Bank" PolicyNo="900789654"
UTRNumber="ABC4236997411115" ClusterId="1001"/>
</PaymentData>
<SummaryDetails WebServiceId="2" LICReferenceId="201" ClusterId="1001"
DateOfResponse="20150603" TotalRecords="2" Description="Received for processing"/>
</PmjbyPaymentDataStatusRS >

Page
13

WEB SERVICE 4 (To send enrolled members' data with payment particulars )

XML Format of REQUEST to Web Service 4


<?xml version="1.0" encoding="iso-8859-1"?>
<PmjjbyDataRQ>
<PolicyData>
<PolicyDetails BankIdentifier="ABC Bank" PolicyNo=" 900987456"
UTRNumber="ABC20150106115" UTRDate="20150601" />
</PolicyData>
<MemberData>
<MemberDetails
BankIFSC="ABC20000001"
RuralUrban="RURAL"
AccountHolderName="XYZ JAHGD"
Gender="M"
DOB="19720701"
BankAccountNo="1236543RR123"
BankCustomerId="1236547"
AadharNo="201236547896"
PanCardNo="AYTRH8951W"
Pincode="421430"
MobileNo="9696874563"
EmailId="abdcdf@gmail.com"
DOA="20100512"
DOJ="20150601"
NomineeName="MAGAN KORHALE"
NomineeRelation="5"
NomineeAge="25"
AppointeeName="NULL" />
<MemberDetails
BankIFSC="ABC20000001"
RuralUrban="RURAL"
AccountHolderName="ANBC JAHGD"
Gender="M"
DOB="19721101"
BankAccountNo="1236585KR123"
BankCustomerId="1234500"
AadharNo="201236588896"
PanCardNo="AYTRH8951W"
Pincode="421430"
MobileNo="9696874563"
EmailId="abdcdf@gmail.com"
DOA="20100512"
DOJ="20150601"
NomineeName="MAGAN KORHALE"
NomineeRelation="5"
NomineeAge="25"
AppointeeName="NULL" />
</MemberData>
<SummaryDetails
Page
14

WebServiceId="4" BatchId="1001" DateofSubmission="20150601"


TotalRecordsInBatch="2"/>
</PmjjbyDataRQ >
XML Format of RESPONSE from Web Service 4
<?xml version="1.0" standalone="yes"?>
<PmjjbyDataRS>
<PolicyData>
<PolicyDetails BankIdentifier="ABC Bank" PolicyNo="900789654" UTRNumber="
ABC20150106115"/>
</PolicyData>
<MemberData>
<MemberDetails
BankIFSC="ABC20000001"
BankAccountNo="1236543RR123"
BankCustomerId="1236547"
MemberStatus="E"
ErrorCode="0"/>
<MemberDetails
BankIFSC="ABC20000001"
BankAccountNo="1236543RE564"
BankCustomerId="1987465547"
MemberStatus="R"
ErrorCode="2"/>
</MemberData>
<SummaryDetails WebServiceId="4" LICReferenceId="101" BatchId="1001"
DateOfReceipt="20150605" TotalRecords="2" TotalEligible="1" TotalError="1"
Status="True" Description="Data Processed"/>
</PmjbyMemberDataRS>

Page
15

TEST ENVIRONMENT (UAT) for testing Web services :

1) WSDL : https://pgslink.licindia.in/PmJjbyWS1TestApp/PmJjbyWS?wsdl
2) Web service Name : PmJjbyWS

For Web Service 1 :


Web method : uploadPmjbyMemberData

Request web parameters used :


a) PGSRequestKey : value wil be pmjjby2015 (datatype : string)
b) PGSRequestMsg : value will be the xml data in string format as provided , in this
document.
Response : will be the xml data in string format as provided in this document.

For Web Service 2 :


Web method : uploadPmjjbyPayStatus
Request web parameters used :
a) PGSRequestKey : value will be pmjjby_pay2015 (datatype : string)
b) PGSRequestMsg : value will be the xml data in string format as provided , in this
document.
Response : will be the xml data in string format as provided in this document.
For Web Service 4 :
Web method : uploadPmjjbyFullData
Request web parameters used :
a) PGSRequestKey : value wil be pmjjby_full2015 (datatype : string)
b) PGSRequestMsg : value will be the xml data in string format as provided , in this
document.
Response : will be the xml data in string format as provided in this document.

Page
16

PRODUCTION ENVIRONMENT for LIVE data :

1) WSDL : https://pgslink.licindia.in/PmjjbyProjectApp/PmjjbyProjectWS?wsdl
2) Web service Name : PmjjbyProjectWS

For Web Service 1 :


Web method : uploadPmjbyMemberData

Request web parameters used :


a) PGSRequestKey : value wil be LIcpmJjby##15 (datatype : string)
b) PGSRequestMsg : value will be the xml data in string format as provided , in this
document.
Response : will be the xml data in string format as provided in this document.

For Web Service 2 :


Web method : uploadPmjjbyPayStatus
Request web parameters used :
a) PGSRequestKey : value will be LIcpmJjbyPay##15 (datatype : string)
b) PGSRequestMsg : value will be the xml data in string format as provided , in this
document.
Response : will be the xml data in string format as provided in this document.
For Web Service 4 :
Web method : uploadPmjjbyFullData
Request web parameters used :
a) PGSRequestKey : value wil be LIcpmJjbyFull##15 (datatype : string)
b) PGSRequestMsg : value will be the xml data in string format as provided , in this
document.

Page
17

Response : will be the xml data in string format as provided in this document.

ANNEXURE :
PolicyNo in the parent tag of all web services will be the master policy number allotted to the Bank
after signing the MOU. The bank can contact the LIC unit for this.
BankIdentifier in the parent tag will be the name of the bank limited to 60 characters.
Data Type of REQUEST to Web Service 1

Attribute

Expected Data
Type

Expected
Data
Length

BankIFSC

Alpha-numeric

11

RuralUrban
AccountHolderName
Gender
DOB

Alpha-numeric
Alpha-numeric
Alpha-numeric
Numeric

10
50
1
8

BankAccountNo

Alpha-numeric

30

BankCustomerId

Alpha-numeric

30

AadharNo

Numeric

12

PanCardNo
Pincode

Alpha-numeric
Numeric

10
6

MobileNo
EmailId

Numeric
Alpha-numeric

12
50

DOA

Numeric

DOJ
NomineeName

Numeric
Alpha-numeric

NomineeRelation
NomineeAge

Numeric
Numeric

AppointeeName
WebServiceId

Alpha-numeric
Numeric

50
1

BatchId

Numeric

10

DateofSubmission
TotalRecordsInBatch

Numeric
Numeric

Data Format

Description

Optional(O)

M
O

YYYYMMDD

M
M
M
M
M
O
O
M
O

YYYYMMDD

8
50

YYYYMMDD

2
3

8 YYYYMMDD
2

Page
18

Mandatory
(M) /

O
M
M
O
O
O
O
M
M
M
M

IFSC of the bank


Metro / Urban/Rural/Semi Urban type of a/c holder
Name of the a/c holder
Gender of the a/c holder
Date of Birth of a/c holder
Bank Account Number of a/c
holder
Unique Customer Ref Id as
per bank records
Aadhar number of a/c
holder
Pan Card Number of a/c
holder
Pin code of the a/c holder
Mobile Number of a/c
holder
Email Id of a/c holder
Date of opening the savings
account by the a/c holder
Date of Enrolment into the
PMJJBY scheme
Name of the Nominee
Relation of nominee to the
a/c holder
Age of the nominee
Name of appointee , in case
of minor nominee
Value will be '1'
Unique ID generated by the
bank for each batch
Date on which the batch is
sent to LIC
Total records in the batch

Data Type of REQUEST to Web Service 2

Attribute

Expected Data
Type

Expected
Data
Length

Data Format

Mandatory
(M) /
Optional(O)

M
UTRNumber

Alpha-numeric

PaymentDate

Numeric

22
8 YYYYMMDD

M
M

ClusterId

Numeric

10
M

BatchId
BankIFSC

Numeric
Alpha-numeric

10
11

BankAccountNo

Alpha-numeric

30

BankCustomerId
WebServiceId

Alpha-numeric
Numeric

30
1

BatchId

Numeric

10

DateofSubmission
TotalRecords

Numeric
Numeric

8 YYYYMMDD
2

Page
19

Description

M
M
M
M
M
M
M

The UTR number generated


for the premium payment to
LIC
Date on which the payment
is sent to LIC
Unique ID generated by the
bank for each lot being sent
under the UTR Number.
The batch number under
which the data of the
accountholder was sent
through WS1.
IFSC of the bank
Bank Account Number of a/c
holder
Unique Customer Ref Id as
per bank records
Value will be '2'
Unique ID generated by the
bank for each batch
Date on which the batch is
sent to LIC
Total records in the batch

Data Type of REQUEST to Web Service 4

Attribute

Expected Data
Type

Expected
Data
Length

Data Format

Mandatory
(M) /
Optional(O)

M
UTRNumber

Alpha-numeric

22

UTRDate
BankIFSC

Numeric
Alpha-numeric

8 YYYYMMDD
11

RuralUrban
AccountHolderName
Gender
DOB

Alpha-numeric
Alpha-numeric
Alpha-numeric
Numeric

10
50
1
8

BankAccountNo

Alpha-numeric

30

BankCustomerId

Alpha-numeric

30

AadharNo

Numeric

12

PanCardNo
Pincode

Alpha-numeric
Numeric

10
6

MobileNo
EmailId

Numeric
Alpha-numeric

12
50

DOA

Numeric

DOJ
NomineeName

Numeric
Alpha-numeric

NomineeRelation
NomineeAge

Numeric
Numeric

AppointeeName
WebServiceId

Alpha-numeric
Numeric

50
1

BatchId

Numeric

10

DateofSubmission
TotalRecordsInBatch

Numeric
Numeric

YYYYMMDD

M
M
O
M
M
M
M
M
O
O
M
O

YYYYMMDD

8
50

YYYYMMDD

2
3

8 YYYYMMDD
2

Page
20

Description

O
M
M
O
O
O
O
M
M
M
M

The UTR number generated


for the premium payment to
LIC
Date on which the payment
is sent to LIC
IFSC of the bank
Metro / Urban/Rural/Semi Urban type of a/c holder
Name of the a/c holder
Gender of the a/c holder
Date of Birth of a/c holder
Bank Account Number of a/c
holder
Unique Customer Ref Id as
per bank records
Aadhar number of a/c
holder
Pan Card Number of a/c
holder
Pin code of the a/c holder
Mobile Number of a/c
holder
Email Id of a/c holder
Date of opening the savings
account by the a/c holder
Date of Enrolment into the
PMJJBY scheme
Name of the Nominee
Relation of nominee to the
a/c holder
Age of the nominee
Name of appointee , in case
of minor nominee
Value will be '4'
Unique ID generated by the
bank for each batch
Date on which the batch is
sent to LIC
Total records in the batch

Conditions of Validity for REQUEST to Web Service 1 and Web Service 4

Table of Invalid Error Codes for WS1 and WS4 :


Error Code

Reason of Invalidity

1
2
3
4
5
6
7
8
9

IFSC code not given / Incorrect


Batch Id not given / is duplicate
Batch date not given / Incorrect
Account Holder's name is not given
Gender not given / not equal to (M , F , T)
Date of Birth not given / incorrect
Bank Account Number and Customer Id not given
Date of enrolment is not given
Incorrect Policy Number - Contact LIC

General Conditions for data under WS1 and WS4 :







Expected values in "Gender" - M for Male ; F for Female ; T for Transgender


There must be maximum 50 records per batch.
No. of records in a batch / cluster must tally with value in "TotalRecords"
The optional attributes must contain value NULL (for Character data type) or 0 (for numeric
data type) or 01/01/1900 (for date data type).
 The data must follow aforesaid data type/length/format as mentioned above whereas in
XML attributes, the same data will be presented in double quotes.
 The "BatchId" , "ClusterId" must be an unique number.
 The "PolicyNo" will be alloted by LIC to the bank after signing of MOU.
 " WebServiceId" must be 1 for WS1, 2 for WS2 and 4 for WS4.
 NomineeRelation must be as per the codes provided by LIC.
 When the LIC response is with Status="False", it should be interpreted with value in
attributes "LICResponseTypeId" and " Description".
 When the Status="True" then,
a) the value in the attribute MemberStatus will be "E" for eligible members, "D" for
de-duplication errors and "R" for Errors related to data format.
b) the value in the attribute of "ErrorCode" should be interpreted with the invalidity
codes mentioned in the "Table of Invalid Error Codes".
LIC Response Type ID Master :
LIC Response Type Id

Description

Received for Processing

Error Received : (description of error)

XML Parsing error At (description of error)

Page
21

NOMINEE RELATIONSHIP CODES


Code
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
99

Relation
SELF
WIFE
FATHER
MOTHER
SON
DAUGHTER
BROTHER
SISTER
FATHER IN LAW
MOTHER IN LAW
GRANDSON
GRANDDAUGHTER
GRANDFATHER
GRANDMOTHER
BROTHER IN LAW
SISTER IN LAW
HUSBAND
GUARDIAN
OTHERS

Page
22