CSSDA
Chhattisgarh State Skill Development Authority (CSSDA)
Guidelines for
Biometric Device Manufacturers for
Interfacing with
ATTENDANCE MANAGEMENT SYSTEM for VTP and Assessing body
(For multiple bio-metrics in VTP centre)
1
CSSDA
Table of Contents
1 Guideline: .................................................................................................................................... 3
1.1 Prerequisites for participation in CSSDA Attendance Management System: ................ 3
1.2 Specifications of web service method: .............................................................................3
2
CSSDA
1 Guideline:
This document provides guidelines for device vendors to-
a. register their device with CSSDA portal
b. call web service to pull Trainee record for enrollment
c. push attendance data with GPS timestamp, latitude and longitude to CSSDA Portal
1.2 Prerequisites for participation in CSSDA Attendance Management System:
All participating device vendors should register their IMEI Number with CSSDA Portal
before they can access the web service
The brief process involves
Registration of Device ID (IMIE number) with the Attendance Portal
Registration of TBN, Trainees with the CSSDA portal
Fetching these details from Attendance portal while Enrolling the fingerprints
Enrollment of TBN, Trainees with the Attendance portal
Regular Attendance management
1.3 Specifications of web service method:
Please refer below URL for web service details.
http://cssda.cg.nic.in/ws/service.asmx
Web Method Name: InsertBioMetricDeviceRegistrationDetails
Input Parameters: The web method created for the purpose will have following parameters:
Sr. No. Parameter Name Format Example
1 IMEI_No Numeric 82374632646
2 VTP_Reg_No string CG0101P002
3 Longitude string 12.76767676
4 Latitude string 18.12312322
5 BioMetricCompanyName string (Max 20 Character) Testing Company
Response Type: The web method will return either 0 or 1 e.g. 1-Success and 0-fail
Error Code Returned by Service
` Sr. No. Error Code Error Description
1 -1 VTP_Reg_No not found or incorrect
2 -2 Longitude value is not correct
3 -3 Latitude value is not correct
4 -5 IMEI No already registered
5 -6 BioMetricCompanyName is not correct
3
Web Method Name: GetTraineeDetails
Input Parameters: The web method created for the purpose will have following parameters:
Sr. No. Parameter Name Format Example
1 IMEI_No Numeric 82374632646
2 VTP_Reg_No string CG0101P002
3 TBN string 0101P002GAR1051301
Response Type: The web method will return either XML or dataset
<TraineeList>
<TraineeDetail>
<Cssda_Trainee_ID>0101P002GAR105130112</Cssda_Trainee_ID>
<Trainee_Name>Raj Kumar</Trainee_Name>
<Trainee_DOB>1980-01-01T00:00:00+05:30</Trainee_DOB>
<Trainee_Gender>M</Trainee_Gender>
<Trainee_EmailID>[email protected]</Trainee_EmailID>
<Trainee_Mobile>9999999999</Trainee_Mobile>
<Trainee_TBN>0101P002GAR1051301</Trainee_TBN>
<Trainee_Address1>Raipur</Trainee_Address1>
<Trainee_District_Id>13</Trainee_District_Id>
<VTP_Reg_No>CG0101P002</VTP_Reg_No>
<TrainingStartDate>25 Jun 2015</TrainingStartDate>
<TrainingEndDate>05 Nov 2015</TrainingEndDate>
<TrainingStratTime>12:00</TrainingStratTime>
<TrainingEndTime>16:00</TrainingEndTime>
</TraineeDetail>
</TraineeList>
Error Code Returned by Service
Sr. No. Error Code Error Description
1 -1 Device IMEI Number not register with portal
2 -2 VTP Registration number is wrong
3 -3 TBN Not Generated/TBN not found
4
CSSDA
Web Method Name: UpdateTraineeDetails_multi
Input Parameters: The web method created for the purpose will have following parameters:
Sr. No. Parameter Name Format Example
1 TraineeID string “0101P002GAR105130112”
2 VTP_Reg_No string “CG0101P002”
3 TBN string “0101P002GAR1051301”
4 TraineePhoto String(64 bit binary stream)
5 IMEI_No Numeric 82374632646
Response Type: The web method will return either 0 or 1 e.g. 1-Success and 0-fail.
Please note that Traineephoto is optional. Devices with camera may send it. For others
the system shall take null value.
Error Code Returned by Service
Sr.No. Error Code Error Description Dimensions(W x H)px
1 -1 TraineeId not found or incorrect
2 -2 VTP_Reg_No not found or incorrect
3 -3 TBN not found or Incorrect
4 -4 Trainee photo was not in correct format
5 -15 Trainee ID already registered.
6 -16 IMEI No not valid for VTP
7 -17 VTP not approved for multi biometrics device
8 -18 TBN enrolled on some other biometrics device
5
CSSDA
Web Method Name: InsertAttendanceDetails_multi
Input Parameters: The web method created for the purpose will have following parameters:
Sr. No. Parameter Name Format Example
1 TraineeID string “0101P002GAR105130112”
2 VTP_Reg_No string “CG0101P002”
3 TBN string “0101P002GAR1051301”
4 AttendanceDate string 10/ 20/ 2014 (mm/dd/yyyy)
5 PanchTime string 10: 00 AM
6 Longitude string 12.76767676
7 Latitude string 18.12312322
9 TraineePhoto string (64 bit binary stream)
10 IMEI_No Numeric 82374632646
Response Type: The web method will return either 0 or 1
e.g. 1 Success and 0 fail
Error Code Returned by Service
` Sr. No. Error Code Error Description Dimensions(W x H)px
1 -1 TraineeId not found or incorrect
2 -2 VTP_Reg_No not found or incorrect
3 -3 TBN not found or Incorrect
4 -4 Attendance date format is not valid
5 -5 Wrong time value is passed
6 -6 Longitude value is not correct
7 -7 Latitude value is not correct
8 -9 Punch time is not valid for attendance.
9 -10 Attendance already has been done.
10 -12 More than three days older attendance record.
11 -13 Batch start and end time is not exist.
Device location distance is more than 100
12 -14
meter from registered Location.
13 -16 Trainee photo was not in correct format.
14 -17 IMEI No not valid for VTP
15 -18 VTP not approved for multi biometrics device
16 -19 Multiple biometrics exceeds 500 mtr range
Sunday and State Cssda declared holiday
17 -20 attendance not allowed
1.4 Next Steps
Please use the above method to interface your equipment/software with the attendance portal
and develop the client side software required for Enrollment and Attendance management.
Note:
All the Bio metrics manufacture /Vendor may visit the portal form time to time in
order to update their API’s arising out of the new requirement from CSSDA is any.