Master Data Services Functionality
Master Data Management
Location Hierarchy
Create Location Hierarchy
Upon receiving a request to add Location hierarchy (e.g., Country - Region - Province - City- LAA) with the input parameters (code, name, hierarchy_level, hierarchy_level_name, parent_loc_code ,lang_code and is_active), the system stores the Location hierarchy in the Database
While storing the location hierarchy in the database, the system performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
name - character (128) - Mandatory
hierarchy_level - smallint - Mandatory
hierarchy_level_name - character (64) - Mandatory
parent_loc_code - character (32) - Optional
lang_code - character (3) - Mandatory
is_active - boolean - Mandatory
Validate if the Location name received does not already exist in the hierarchy for which the location is getting created
If Location name already exist under the hierarchy level, throw an appropriate error
The API should not allow creation of the Location if the data is not received in default language
If the data for the Location is not received in all the configured languages, the API should allow the Location to be created given the Point 3 is satisfied.
The API should activate the Location while creation provided the data for all the configured languages is received during the initial creation
If the data for all the configured languages is not received, deactivate the Location while creation
While storing the location,
cr_by should be the Username of the user who is accessing this API
cr_dtimes should be the date-time at which the user is creating the Location
Responds with the Location Hierarchy created successfully
The component restricts the bulk creation of Master Data through API. However it could be done through a script as need be depending on the requirement of the country.
In case of exceptions, system triggers error messages as received from the Database
Update a Location
On receiving a request to update a Location with the input parameters (code, name, hierarchy_level, hierarchy_level_name, parent_loc_code, lang_code and is_active), the system updates the Location in the Location Database for the code received.
The system performs the following steps to update the location in the Master Database:
Validates if all required input parameters have been received as listed below for each specific request
code character (36) - Mandatory
name character (128) - Mandatory
hierarchy_level smallint - Mandatory
hierarchy_level_name character (64) - Mandatory
parent_loc_code character (32) - Mandatory
lang_code character (3) - Mandatory
is_active boolean - Mandatory
Validate if the Location name received does not already exist in the hierarchy of the Location
If Location name already exist under the hierarchy level, throw an appropriate error
The API should not allow activation of Location if the data for the Location is not present in all the languages which are configured for a country
For the code received in the request, replaces all the data received in the request against the data existing in the Location database against the same code.
While receiving the request for activation, If the Location is already Active, the API should throw an error message. Refer messages section.
While receiving the request for deactivation, If the Location is already Inactive, the API should throw an error message. Refer messages section
If for a Location data, is_active flag is being sent as “False” and there are active child Locations (also the subsequent child locations) being mapped to received location, do not deactivate the location. Respond with appropriate message. Refer messages section
Deleted record are not be updated
upd_by should be the Username of the user who is accessing this API
upd_dtimes should be the date-time when the Location is being updated
Responds with data not found error if deleted record is received in the request
Responds with appropriate message if the Location is updated successfully
In case of Exceptions, system triggers relevant error messages
Verify Location
Upon receiving a request to validate the Location Name with input parameters (Location Name), the system checks the Location Name in the Master Database
While checking the location in the Database, the system performs the following steps:
Validates if the request contains the following input parameters
Location Name - Mandatory
If the mandatory input parameters are missing, throw the appropriate message
In case of Exceptions, system triggers relevant error messages
Fetch Location Hierarchy Levels based on a Language Code
Upon receiving a request to fetch the Location Hierarchy Levels with input parameters (Language Code), the system fetches the Location Hierarchy Levels in the requested language. The following steps are performed by the system:
Validates if the request contains following input parameters (Language Code)
Language Code - Mandatory
Validates if the response contains the Location Hierarchy Levels with the following attributes
Hierarchy Level
Hierarchy Name
IsActive
In case of Exceptions, system triggers relevant error messages
Fetch the Location Hierarchy Data based on a Location Code and a Language Code
Upon receiving a request to fetch all the Location Hierarchy Data with input parameters (Location Code and Language Code), the system fetches the Location Hierarchy Data based on requested Location code and language code. The following steps are performed by the system:
Validates if the request contains the following input parameters
Location Code - Mandatory
Language Code - Mandatory
If the mandatory input parameters are missing, throw the appropriate message.
Validates if the response contains the following location hierarchy data and the corresponding attributes against the Location Code and Language Code received in the input parameter (i) List of Countries against the Location Code
Country Code
Country Name
IsActive
(ii) List of Regions against the Location Code
Region Code
Region Name
IsActive
(iii) List of Provinces against the Location Code
Province Code
Province Name
IsActive
(iv) List of Cities against the Location Code
City Code
City Name
IsActive
(v) List of Local Administrative authorities against the Location Code
Local Administrative Authority Code
Local Administrative Authority Name
IsActive
(vi) List of Pincodes against the Location Code
Pincode
IsActive
Responds to the source with all the Location Hierarchy Data based on the Location Code
In case of Exceptions, system triggers relevant error messages.
Fetch the Location Hierarchy Data for the bottom next hierarchy based on a Location Code and a Language Code
Upon receiving a request to fetch all the Location Hierarchy Data with input parameters (Location Code and Language Code), the system fetches the Location Hierarchy Data for the next hierarchy level. The following steps are performed by the system:
Validates if the request contains the following input parameters
Location Code - Mandatory
Language Code - Mandatory
If the mandatory input parameters are missing, throws the appropriate message.
Fetches the Location data of only the child hierarchy of location code received (For e.g., if the location code for a particular Province is received, responds with the data of all the Cities existing in that Province, similarly if location code of a City is received, responds all the data regarding the Local Administrative Authorities existing under that City)
Responds to the source with the data fetched
In case of Exceptions, system should trigger an error message.
Delete a Location
On receiving a request to delete a Location with the input parameters (code), the system updates the is_deleted flag to true in the Location Database against the code received.
The system performs the following steps in order to delete the loaction received in the code:
Validates if all required input parameters have been received as listed below for each specific request
Delete all records for the code received
Deleted record are not be deleted again
Responds with data not found error if deleted record is received in the request
Responds with dependency found error if a record to be deleted is used as foreign key in the dependent table
Responds with the Code for the Location Hierarchy deleted successfully
code - character (36) - Mandatory
In case of Exceptions, system triggers relevant error messages.
List of Holidays
Create Holiday
Upon receiving a request to add Holiday Data with the input parameters (location_code, holiday_date, holiday_name, holiday_desc, lang_code and is_active), the system stores the Holiday in the Database. The following steps are performed by the system:
This API should only be accessible to Global Admin
The API should accept only the below parameters
location_code - Character - 128 - Mandatory
holiday_date - Date Format (yyyy-mm-dd) - Mandatory
holiday_name - Character - 64 - Mandatory
holiday_desc - Character - 128 - Optional
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message.
'location_code' received should be from list of 'codes' from 'location' masterdata table
If not, the API should throw an error.
If all the above validations are successfull, the API should update the data in the database agianst the id received
API should perfrom below multi-language validations on the Holiday data recieved
If in the database, all the mandatory data is present in primary langauge but not in the secondary langauge, API should update the data but mark the Holiday as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
API should store upd_by as the Username of the user who is accessing this API
API should store upd_dtimes as the date-time at which the user is modiying the Holiday details
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
Update Holiday
This API should only be accessible to Global Admin
The API should accept only the below parameter
id - Character - 36 - Mandatory
location_code - Character - 128 - Mandatory
holiday_date - Date Format (yyyy-mm-dd) - Mandatory
holiday_name - Character - 64 - Mandatory
holiday_desc - Character - 128 - Optional
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message.
'location_code' received should be from list of 'codes' from 'location' masterdata table
If not, the API should throw an error.
If all the above validations are successfull, the API should update the data in the database agianst the id received
API should perfrom below multi-language validations on the Template data recieved
If in the database, all the mandatory data is present in primary langauge but not in the secondary langauge, API should update the data but mark the Template as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
API should store upd_by as the Username of the user who is accessing this API
API should store upd_dtimes as the date-time at which the user is modiying the Template details
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
Fetch List of Holidays based on a Registration Center ID, a Year and a Language Code
On receiving a request to fetch the list of Holidays with the input parameters (Registration Center ID, Year and Language Code), the system fetches the list of Holidays mapped to a Registration Center and for the year and Language Code received in input parameter as per the below steps:
Validates if the received request contains the following input parameters
Registration Center ID - Mandatory
Year - Mandatory
Language Code - Mandatory
If the mandatory input parameters are missing, throws the appropriate message
Validates if the response contains the List of Holidays against the Registration Center ID and the year received and contains the following attributes for a Region
Holiday ID
Holiday Date
Holiday Name
IsActive
Responds to the source with the List of Holidays
In case of Exceptions, system triggers relevant error messages
Biometric Authentication Type
Create Biometric Authentication Type
On receiving a request to add Biometric Authentication Type (e.g., Fingerprint, Iris) with the input parameters (code, name, descr, lang_code and is_active), the system stores the Biometric Authentication Type in the Database as per the below steps:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
name - character (64) - Mandatory
descr - character (256) - Optional
lang_code - character (3) - Mandatory
is_active - boolean - Mandatory
Responds with the Biometric Authentication Type Code and Language Code for the Biometric Authentication Type created successfully
The component restricts the bulk creation of Master Data
In case of Exceptions, system triggers error messages as received from the Database.
Fetch the List of Biometric Authentication Type based on a Language Code
On receiving a request to fetch the List of Biometric Authentication Type with input parameters (Language Code), the system fetches the List of Biometric Authentication Type against the Language Code as per the below steps:
Validates if the request to add Biometric Authentication Type contains the following parameters
Language Code - Mandatory
If the mandatory input parameters are missing, responds with all the data.
Validates if the response contains the List of Biometric Authentication Type against the Language Code along with the IsActive Flag for each Biometric Authentication Type
Responds to the source with List of Biometric Authentication Type
In case of Exceptions, system triggers relevant error messages
Biometric Attribute Type
Create Biometric Attribute
On receiving a request to add Biometric Attribute (e.g., Right Thumb, Left Thumb) with the input parameters (code, name, descr, bmtyp_code, lang_code and is_active), the system stores the Biometric Attribute in the Database as per the below steps:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
name - character (64) - Mandatory
descr - character (128) - Optional
bmtyp_code - character (36) - Mandatory
lang_code - character (3) - Mandatory
is_active - boolean - Mandatory
Responds with the Biometric Attribute Code and Language Code for the Biometric Attribute created successfully
The component restricts the bulk creation of Master Data
Responds to the source with the appropriate message.
In case of Exceptions, system triggers error messages as received from the Database
Fetch the List of Biometric Attributes based on the Biometric Authentication Type and a Language Code
On receiving a request to fetch the List of Biometric Attributes with input parameters (Biometric Authentication Type and Language Code), the system fetches the List of Biometric Attributes against the Biometric Authentication Type and the Language Code Received as per the below steps:
Validates if the request contains the following input parameters
Biometric Authentication Type - Mandatory
Language Code - Mandatory
If no data is present in the Database for the input parameter received, responds with an appropriate message.
If both the input parameter is missing, responds with all the data.
If one of the input parameters is missing, throw the appropriate message. Refer "Messages" section.
Validates if the response contains the List of Biometric Attributes with all the attributes against Biometric Authentication Type and Language Code Received
Biometric Attribute Code - Mandatory
Biometric Attribute Name - Mandatory
Biometric Attribute Description - Optional
IsActive – Mandatory
Responds to the source with the Fetched Data
In case of Exceptions, system triggers relevant error messages
Gender
Create Gender Types
This API should only be accessible to Global Admin
The API should accept only the below parameters
name - Character - 64 - Mandatory
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message. Refer messages section
API should perfrom below multi-language validations on the Gender Type data recieved
If, the data is recieved in secondary language and the data for primary language is not present in the database, the API should not allow creation of the Gender Type and throw an error message. Refer messages section
If in the request, all the mandatory data is received in primary langauge but not in the secondary langauge, API should store the data but mark the Gender Type as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
If all the above validations are successfull, the API should store the data the the database Gender Type Code should be generated at the back-end for any Gender Type added using a UUID generator
API should store cr_by as the Username of the user who is accessing this API
API should store cr_dtimes as the date-time at which the user is creating the Gender Type
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
Update a Gender Type
On receiving a request to update a Gender Type with the input parameters (code, name, lang_code and is_active), the system updates the Gender Type in the Gender Type Database for the code received as per the below steps:
This API should only be accessible to Global Admin
The API should accept only the below parameters
code - Character - 36 - Mandatory
name - Character - 64 - Mandatory
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message. Refer messages section
If all the above validations are successfull, the API should update the data in the database agianst the code received
API should perfrom below multi-language validations on the Gender Type data recieved
If in the database, all the mandatory data is present in primary langauge but not in the secondary langauge, API should update the data but mark the Gender Type as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
API should store upd_by as the Username of the user who is accessing this API
API should store upd_dtimes as the date-time at which the user is modiying the Gender Type details
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
Check the existence of a Gender in Master Database
On receiving a request to validate the Gender Name with input parameters (Gender Name), the system checks the Gender Name in the Master Database as per the below listed steps:
Validates if the request contains the following input parameters
Gender Name - Mandatory
If the mandatory input parameters are missing, throws the appropriate message.
Responds to the source with the appropriate message
In case of Exceptions, system triggers relevant error messages
Fetch the List of Gender Types based on a Language Code
On receiving a request to fetch the List of Gender Types with the input parameters (Language Code), the system fetches the List of Gender Types against the Language Code received as per the below listed steps:
Validates if the request contains the following input parameters
Language Code - Mandatory
If the Language code is missing, responds with all the data.
Validates if the response contains the List of Gender Types with the following attributes
Gender Code
Gender Name
isActive
Responds to the source with the List of Gender Types
In case of Exceptions, system triggers relevant error messages
Document Category
Create Document Category in Master Database
On receiving a request to add Document Category with the input parameters (code, name, descr, lang_code and is_active), the system stores the Document Category in the Database as per the below listed steps:
This API should only be accessible to Global Admin
The API should accept only the below parameters
name - Character - 64 - Mandatory
descr - Character - 128 - Optional
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message.
API should perfrom below multi-language validations on the Document Category data recieved
If, the data is recieved in secondary language and the data for primary language is not present in the database, the API should not allow creation of the Document Category and throw an error message.
If in the request, all the mandatory data is received in primary langauge but not in the secondary langauge, API should store the data but mark the Document Category as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
If all the above validations are successfull, the API should store the data the the database
Document Category Code should be generated at the back-end for any Document Category added using a UUID generator
API should store cr_by as the Username of the user who is accessing this API
API should store cr_dtimes as the date-time at which the user is creating the Document Category
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
Update a Document Category in the Document Category Master Database
On receiving a request to update a Document Category with the input parameters (code, name, descr, lang_code and is_active), the system update the Document Category in the Document Category Database for the Code received as per the below listed steps:
The API should only be accessible to Global Admin
The API should accept only the below parameters
code - Character - 36 - Mandatory
name - Character - 64 - Mandatory
descr - Character - 128 - Optional
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message.
If all the above validations are successfull, the API should update the data in the database agianst the code received
API should perfrom below multi-language validations on the Document Category data recieved
If in the database, all the mandatory data is present in primary langauge but not in the secondary langauge, API should update the data but mark the Document Category as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
API should store upd_by as the Username of the user who is accessing this API
API should store upd_dtimes as the date-time at which the user is modiying the Document Category details
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
Fetch list of Document Categories based on a Language Code
On receiving a request to fetch Document Category Details with the input parameters (Language Code), the system fetches all the Document Categories for the Language Code Received as per the below listed steps:
Validates if all required input parameters have been received as listed below for each specific request
Language Code - Mandatory
If the mandatory input parameters are missing, responds with all the data.
Validates if the response contains the following attributes for the Document Category Code
Document Category Code - Mandatory
Document Category Name - Mandatory
Document Category Description - Optional
IsActive - Mandatory
In case of Exceptions, system triggers relevant error messages
Document Type
Create Document Type
On receiving a request to add Document Type with the input parameters (code, name, descr, lang_code and is_active), the system stores the Document Type in the Database
Refer below for the process:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
name - character (64) - Mandatory
descr - character (128) - Optional
lang_code - character (3) - Mandatory
is_active - boolean - Mandatory
The API should not allow creation of the Document Type if the data is not received in default language
If the data for the Document Type is not received in all the configured languages, the API should allow the Document Type to be created given the Point 2 is satisfied.
The API should activate the Document Type while creation provided data for all the configured languages is received during the initial creation
cr_by should be the Username of the user who is accessing this API
cr_dtimes should be the date-time when the user is creating the Document Type
If the data for all the configured languages is not received, deactivate the Document Type while creation
Responds with an appropriate message for the Document Type created successfully
In case of Exceptions, system triggers relevant error messages
Update a Document Type
On receiving a request to update a Document Type with the input parameters (code, name, descr, lang_code and is_active), the system updates the Document Type in the Document Type Database for the Code received
Refer below for the process:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
name - character (64) - Mandatory
descr - character (128) - Optional
lang_code - character (3) - Mandatory
is_active - boolean - Mandatory
For the code received in the request, replaces all the data received in the request against the data existing in the Document Type database against the same code
upd_by should be the Username of the user who is accessing this API upd_dtimes should be the date-time when the user updates the Document Type Details
The API should not allow activation of Document Type if the data for the Document Type is not present in all the languages which are configured for a country
While receiving the request for activation, If the Document Type is already Active, the API should throw an error message. Refer messages section.
While receiving the request for deactivation, If the Document Type is already Inactive, the API should throw an error message. Refer messages section.
Deleted record are not be updated
Responds with data not found error if deleted record is received in the request
Responds with the appropriate message for the Document Category updated successfully
In case of Exceptions, system triggers relevant error messages
Delete a Document Type
On receiving a request to delete a Document Type with the input parameters (code), the system updates the is_deleted flag to true in the Document Type Database against the code received
Refer below for the process:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
Delete all records for the code received
Deleted record are not be deleted again
Responds with data not found error if deleted record is received in the request
Responds with dependency found error if a record to be deleted is used as foreign key in the dependent table
Responds with the Document Category Code for the Document Category deleted successfully
In case of Exceptions, system triggers relevant error messages
Applicant Type - Document Category - Document Type Mapping
Fetch list of Document Categories based on Applicant Type from Master Database
Upon receiving a request to fetch List of Document Categories with the input parameters (Applicant Type Code), the system fetches all the Document Categories for the Applicant Type Code Received
While fetching the list of documents, the system performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
Applicant Type Code - Mandatory
If the mandatory input parameter is missing, responds with the appropriate error message
Validates if the response contains the following attributes for each Document Category Code
Document Category Code
Name
Description
Language Code
Is Active
In case of Exceptions, system triggers relevant error messages
Fetch List of Document Category-Document Type mappings based on Applicant Type and a List of Language Codes
Upon receiving a request to fetch List of Document Category-Document Type mappings with input parameters (Applicant Type and List of Language Codes), the system fetches the required data
While fetching the data, the system performs the following steps:
Validates if the request contains the following input parameters
Applicant Type - Mandatory
List of Language Codes - Mandatory
If the mandatory input parameters are missing, throws the appropriate message.
Fetches the Document Category-Document Type mapping for all language codes received in response
The response contains the List of Mappings of Document Category and Document Type against each Document Category
Each Document Category contains the below attributes
Document Category Code
Name
Description
Language Code
Is Active
Each Document Type contains the below attributes
Document Type Code
Name
Description
Language Code
Is Active
In case of Exceptions, system triggers relevant error messages
Delete a Document Category-Type mapping in the Document Category-Type mapping Master Database
On receiving a request to delete a Document Category-Type mapping with the input parameters (doccat_code, doctyp_code), the system updates the is_deleted flag to true in the Document Category-Type mapping Database against the input received
The system performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
doccat_code - character (36) - Mandatory
doctyp_code - character (36) - Mandatory
Responds with the doc_type Code and doccat_code for the Document Category-Type mapping deleted successfully
In case of Exceptions, system triggers relevant error messages.
Fetch applicant type based on Individual Type Code, Date of Birth, Gender Type Code and Biometric Exception Type
On receiving a request to get Applicant type with input parameters (Individual Type Code, Date of Birth, Gender Type Code and Biometric Exception Type), the system derives the Applicant Type from the input parameter and performs the following steps:
Validates if the request contains the following input parameters
Individual Type Code - Mandatory
Date of Birth - Mandatory
Gender Type Code - Mandatory
Biometric Exception Type - Optional
Derives the Age Group Type based on following logic
Child if Age < 5
Adult if Age >= 5
If the mandatory input parameters are missing, throws the appropriate message
Derives the applicant type as per the define logic
In case of Exceptions, system triggers relevant error messages
Check the mapping of Applicant Type-Document Category Name-Document Type Name
On receiving a request to check the mapping of Applicant Type-Document Category-Document Type mapping parameters (Applicant Type, Document Category Name and Document Type Name), the system checks the mapping and performs the following steps:
Validates if the request contains the following input parameters
Applicant Type Code
Document Category Name
Document Type Name
If the mandatory input parameters are missing, throws the appropriate message.
If the mapping exists, responds with "Valid".
If the mapping does not exist, responds with "Invalid".
In case of Exceptions, system triggers relevant error messages
List of Rejection Reasons
Create a Rejection Reason in Reason List Master Database
Upon receiving a request to add a Reason with the input parameters (code, name, descr, rsncat_code, lang_code and is_active), the system stores the Reason in the Database
The system performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
code - character (64) - Mandatory
descr - character (256) - Mandatory
rsncat_code - character (36) – Mandatory (The parameter rsncat_code refers to a Language stored in Language Masterdata)
lang_code - character (3) – Mandatory (The parameter lang_code refers to a Language stored in Language Masterdata)
is_active - boolean - Mandatory
Validates if the response contains the following attributes for a Reason Category Code added
Code
Language Code
Rsncat_code (Reason Category Code)
Responds to the source with the appropriate message.
In case of Exceptions, system triggers relevant error messages.
Fetch the requested list of reasons based on Reason Category Code and Language Code
Upon receiving a request to Fetch the requested List of Reasons with the required input parameters (Reason 1. Category Code, Language Code), the system fetches the requested List of reasons stored against the Reason Category Code and Language Code received.
The system performs the following steps:
Validates if the request contains the following input parameters
Language Code - Mandatory
Reason Category Code - Mandatory
If either of the mandatory input parameters is missing, responds with the appropriate message as define below in message sections
Validates if the response contains the:
Requested list based on the requested Language Code and Reason Category Code
List of Reasons with the corresponding attributes for the list
Reason ID
Reason Name (per Reason ID)
Language Code
Reason Category Code
IsActive
Responds to the source with the relevant List of Reasons, as per the stated business rules
In case of Exceptions, system triggers relevant error messages as listed below
List of Languages
Create List of Languages
After receiving a request to add Language Details with the input parameters (code, name, family, native_name and is_active), the system stores the Language Details in the Database and performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
code - character (3) - Mandatory
name - character (64) - Mandatory
family - character (64) - Optional
native_name - character (64) - Optional
is_active - boolean - Mandatory
Responds with the Language Code for the language successfully created
In case of Exceptions, system triggers relevant error messages
Fetch the List of Languages
After receiving a request to fetch the List of Languages, the system fetches the List of Languages and performs the following steps:
Validates if the response contains the List of all Languages with the following attributes
Language Code - Mandatory
Language Name - Mandatory
IsActive – Mandatory
Responds to the source with the List of Languages
In case of Exceptions, system triggers relevant error messages
Update and Delete a Language in the List of Languages Master Database
Update
After receiving a request to update a Language with the input parameters (code, name, family, native_name and is_active), the system updates the Language Details in the List of languages Database for the Code received in request
The system performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
code - character (3) - Mandatory
name - character (64) - Mandatory
family - character (64) - Optional
native_name - character (64) - Optional
is_active - boolean - Mandatory
For the Code received in the request, replaces all the data received in the request against the data existing in the List of languages database against the same code.
Deleted record are not updated
Responds with data not found error if deleted record is received in the request
Responds with the Language Code for the language successfully updated
In case of Exceptions, system triggers relevant error messages
Delete
After receiving a request to delete a Language with the input parameters (code), the system updates the is_deleted flag to true in the List of languages Database against the code received in request
The system performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
code - character (3) - Mandatory
Deleted record should not be deleted again
Responds with data not found error if deleted record is received in the request
Responds with the Language Code for the language successfully deleted
In case of Exceptions, system triggers relevant error messages.
List of Titles
Create a Title
On receiving a request to add a Title (e.g., MR., Mrs.) with the input parameters (code, name, descr, lang_code and is_active), the system stores the Title in the Database and performs the following steps:
The API should only be accessible to Global Admin
The API should accept only the below parameters
name - Character - 64 - Mandatory
descr - Character - 128 - Optional
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message. Refer messages section
API should perfrom below multi-language validations on the Title data recieved
If, the data is recieved in secondary language and the data for primary language is not present in the database, the API should not allow creation of the Title and throw an error message. Refer messages section
If in the request, all the mandatory data is received in primary langauge but not in the secondary langauge, API should store the data but mark the Title as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
If all the above validations are successfull, the API should store the data the the database
Title Code should be generated at the back-end for any Title added using a UUID generator
API should store cr_by as the Username of the user who is accessing this API
API should store cr_dtimes as the date-time at which the user is creating the Title
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
Update a Title
On receiving a request to update a Title with the input parameters (code, name, descr, lang_code and is_active), the system updates the Title in the Title Database for the code received and performs the following steps:
This API should only be accessible to Global Admin
The API should accept only the below parameters
code - Character - 36 - Mandatory
name - Character - 64 - Mandatory
descr - Character - 128 - Optional
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message. Refer messages section
If all the above validations are successfull, the API should update the data in the database agianst the code received
API should perfrom below multi-language validations on the Title data recieved
If in the database, all the mandatory data is present in primary langauge but not in the secondary langauge, API should update the data but mark the Title as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
API should store upd_by as the Username of the user who is accessing this API
API should store upd_dtimes as the date-time at which the user is modiying the Title details
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
Fetch the List of Titles
On receiving a request to fetch Title Details with the input parameters (Language Code), the system fetches all the Titles with all the attributes for the Language Code Received
The system performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
Language Code - Mandatory
If the mandatory input parameters are missing, responds with all the data.
Validates if the response contains List of Titles against the received Language Code along with the following attributes for the Title Code
Title Code - Mandatory
Title Name - Mandatory
Title Description - Optional
IsActive - Mandatory
In case of Exceptions, system triggers relevant error messages
Template File Format
Create Template File Format
On receiving a request to add Template File Format with the input parameters (code, descr, lang_code and is_active), the system stores the Template File Format in the Database and performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
descr - character (256) - Mandatory
lang_code - character (3) - Mandatory
is_active - boolean - Mandatory
Validates if the response contains the following attributes for a Template File Format added
Code
Language Code
Responds with the Template File Format Code and Language Code for the Template File Format created successfully
In case of Exceptions, system triggers relevant error messages.
Create Template File Format
Update and Delete a Template File Format in Template File Format Master Database
Update
On receiving a request to update a Template File Format with the input parameters (code, descr, lang_code and is_active), the system updates the Template File Format in the Template File Format Database for the Code received
While updating the Template File Format, the system performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
descr - character (256) - Optional
lang_code - character (3) - Mandatory
is_active - boolean - Mandatory
For the code received in the request, replaces all the data received in the request against the data existing in the Template File Format database against the same code.
Deleted record are not updated
Responds with data not found error if deleted record is received in the request
Responds with the Template File Format Code and Language Code for the Template File Format updated successfully
In case of Exceptions, system triggers relevant error messages
Delete
On receiving a request to delete a Template File Format with the input parameters (code), the system updates the is_deleted flag to true in the Template File Format Database against the code received
While deleting the Template File Format, the system performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
Delete all records for the code received
Deleted record are not deleted again
Responds with data not found error if deleted record is received in the request
Responds with dependency found error (Refer Acceptance criteria) if a record to be deleted is used as foreign key in the dependent table
Responds with the Template File Format Code for the Template File Format deleted successfully
In case of Exceptions, system triggers relevant error messages.
List of Template Types
MOSIP system can create Template Type in the Master Database.
Upon receiving a request to add Template Type (e.g., SMS Notification template - New Registration) with the input parameters (code, descr, lang_code and is_active), the system stores the Template Type in the Database and performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
descr - character (256) - Mandatory
lang_code - character (3) - Mandatory
is_active - boolean – Mandatory
Responds with the Template Type Code and Language Code for the Template Type created successfully
This component also restricts the bulk creation of Master Database
In case of Exceptions, system triggers relevant error messages as listed below.
List of Templates
Create Template
On receiving a request to add a Template with the input parameters (id, name, descr, file_format_code, model, file_txt, module_id, module_name, template_typ_code, lang_code and is_active), the system stores the Template in the Database and performs the following steps:
This API should only be accessible to Global Admin
The API should accept only the below parameters
name - Character - 128 - Mandatory
descr - Character - 256 - Optional
file_format_code - 36 - Mandatory
model - Character - 128 - Optional
file_txt - Character - 4086 - Mandatory
module_id - Character - 36 - Mandatory
module_name - Character - 128 - Mandatory
template_typ_code - Character - 36 - Mandatory
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message.
'file_format_code' received should be from list of 'codes' from 'template_file_format' masterdata table
If not, the API should throw an error.
'template_typ_code' received should be from list of 'codes' from 'template_type' masterdata table
If not, the API should throw an error.
If all the above validations are successfull, the API should update the data in the database agianst the id received
API should perfrom below multi-language validations on the Template data recieved
If in the database, all the mandatory data is present in primary langauge but not in the secondary langauge, API should update the data but mark the Template as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
API should store upd_by as the Username of the user who is accessing this API
API should store upd_dtimes as the date-time at which the user is modiying the Template details
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
Fetch Template based on a Template Type and a Language Code
On receiving a request to fetch a Template with the input parameters (Template Type Code and List of Language Code), the system fetches the Template for the Template Type Code and all Language Codes received
Refer below for the process:
Validates if all required input parameters have been received as listed below for each specific request
Template Type Code - Mandatory
List of Language Code - Mandatory
If the mandatory input parameters are missing, throws the appropriate message. Refer "Messages" section.
Response must contain templates for all the language codes received in the input parameter
Validates if the response contains the Template along with the following attributes
Template Type Code - Mandatory
Template - Mandatory
IsActive
In case of Exceptions, system triggers relevant error messages
Update a Template
On receiving a request to update a Template with the input parameters (id, name, descr, file_format_code, model, file_txt, module_id, module_name, template_typ_code, lang_code and is_active), the system updates the Template in the Template Database for the id received and performs the following steps:
This API should only be accessible to Global Admin
The API should accept only the below parameters
id - Character - 36 - Mandatory
name - Character - 128 - Mandatory
descr - Character - 256 - Optional
file_format_code - 36 - Mandatory
model - Character - 128 - Optional
file_txt - Character - 4086 - Mandatory
module_id - Character - 36 - Mandatory
module_name - Character - 128 - Mandatory
template_typ_code - Character - 36 - Mandatory
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message. Refer messages section
'file_format_code' received should be from list of 'codes' from 'template_file_format' masterdata table
If not, the API should throw an error.
'template_typ_code' received should be from list of 'codes' from 'template_type' masterdata table
If not, the API should throw an error.
If all the above validations are successfull, the API should update the data in the database agianst the id received
API should perfrom below multi-language validations on the Template data recieved
If in the database, all the mandatory data is present in primary langauge but not in the secondary langauge, API should update the data but mark the Template as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
API should store upd_by as the Username of the user who is accessing this API
API should store upd_dtimes as the date-time at which the user is modiying the Template details
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
List of Blacklisted Words
Create Blacklisted Words
Upon receiving a request to add a Blacklisted Word with the input parameters (code, name, descr, lang_code and is_active), the system stores the Blacklisted Word in the Database and performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
word - character (128) - Mandatory
descr - character (256) - Optional
lang_code - character (3) - Mandatory
is_active - boolean - Mandatory
cr_by should be the Username of the user who is accessing this API
cr_dtimes should be the date-time when the user is creating the Blacklisted Word
Responds with the appropriate message for the Device created successfully
The component should restricts the bulk creation of Master Database
In case of Exceptions, system triggers error messages as received from the Database.
Update a Blacklisted Word
Upon receiving request to update a Blacklisted Word with the input parameters (code, name, descr, lang_code and is_active), the system updates the Blacklisted Word in the Blacklisted Word Database for the code received and performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
word- character (128) - Mandatory
descr - character (256) - Optional
lang_code - character (3) - Mandatory
is_active - boolean - Mandatory
For the code received in the request, replaces all the data received in the request against the data existing in the Blacklisted Word database against the same code
upd_by should be the Username of the user who is accessing this API
upd_dtimes should be the date-time when the user updates the Blacklisted Word Details
Deleted record are not updated
Responds with data not found error if deleted record is received in the request
Responds with the appropriate message for the Blacklisted word updated successfully
In case of Exceptions, system triggers relevant error messages as listed below
Delete a Blacklisted Word
Upon receiving a request to delete a Blacklisted Word with the input parameters (code), the system updates the is_deleted flag to true in the Blacklisted Word Database against the code received and performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
word- int - Mandatory
Deleted record are not deleted again
Responds with data not found error if deleted record is received in the request
Responds with the Word for the Blacklisted word deleted successfully
In case of Exceptions, system triggers relevant error messages as listed below
Fetch List of Blacklisted words based on a Language Code
Upon receiving a request to Fetch the List of Blacklisted words with input parameters (Language Code), the system fetches the List of Blacklisted words against the Language Code received
While fetching the black listed words, the system performs the following steps:
Validates if the request contains the following input parameters
Language Code - Mandatory
If the mandatory input parameters are missing, throws the appropriate message.
Validates if the response contains the List of Blacklisted words against Language Code and the corresponding attributes for the Blacklisted word
Blacklisted Word
IsActive
In case of Exceptions, system triggers relevant error messages.
List of Reason Categories
MOSIP system can create a Reason Category in Master Database
Upon receiving a request to add Reason Category with the input parameters (code, name, descr, lang_code and is_active), the system stores the Reason Category in the Database and performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
name - character (64) - Mandatory
descr - character (256) - Mandatory
lang_code - character (3) - Mandatory
is_active - boolean - Mandatory
Validates if the response contains the following attributes for a Reason Category added
Code
Language Code
Responds with the Reason Category code and Language Code for the Reason Category created successfully
In case of Exceptions, system triggers relevant error messages as listed below
List of Applications
Create a List of Applications
Upon receiving a request to add Application with the input parameters (code, name, descr, lang_code and is_active), the system stores the Application in the Database
Refer below for the process:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
name - character (64) - Mandatory
descr- character (256) - Mandatory
lang_code - character (3) – Mandatory (The parameter lang_code refers to a Language stored in Language Masterdata. Refer)
is_active - boolean - Mandatory
Validates if the response contains the following attributes for an Application added
Code
Language Code
Responds with the Application ID and Language Code for the Application created successfully
In case of Exceptions, system triggers relevant error messages as listed below
Fetch List of Applications based on received input parameter
Fetch the List of all Applications
Upon receiving a request to Fetch List of Applications, the system fetches all the List of Applications and performs the following steps:
Validates if the response contains the following attributes for each Application
Application ID
Application Detail
IsActive
The response must contain the list of applications in all the languages present in the Database
Responds to the source with all the Application attributes.
Fetch the Application detail based on a Language Code and Application ID
Upon receiving a request to Fetch List of Applications with the required input parameters (Application ID, Language Code), the system fetches the Application Detail based on the Application ID and Language Code received
Refer below for the process:
Validates if all required input parameters have been received as listed below for each specific request
Application ID - Mandatory
Language Code - Mandatory
Responds with the Application Data against the Application ID and Language Code Received
Validates if the response contains the following attributes for each Application
Application ID
Application Detail
IsActive
Responds to the source with the Application Detail
If the mandatory input parameters are missing, responds with all the data.
In case of Exceptions, system triggers relevant error messages as listed below
List of ID Types
Create an ID type
Upon receiving a request to add an ID Type with the input parameters (code, name, descr, lang_code and is_active), the system stores the ID Type in the Database
Refer below for the process:
Validates if all required input parameters have been received as listed below for each specific request
code - character (36) - Mandatory
code - character (64) - Mandatory
descr - character (256) - Mandatory
lang_code - character (3) – Mandatory (refers to a Language stored in Language Masterdata)
is_active - boolean - Mandatory
Validates if the response contains the following attributes for an ID Type added
Code
Language Code
Responds with the ID Type Code and Language Code for the ID type created successfully
In case of Exceptions, system triggers relevant error messages as listed below.
Fetch the List of ID Types based on Language Code
Upon receiving a request to fetch the List of ID Types with input parameters (Language Code), the system fetches the List of ID Types against the Language Code Received
Refer below for the process:
Validates if the request contains the following input parameters
Language Code - Mandatory
If the mandatory input parameters are missing, throws the appropriate message. Refer "Messages" section below.
Validates if the response contains the List of ID Types with the following attributes
ID Type Name
ID Type Code
IsActive
In case of Exceptions, system triggers relevant error messages.
User Details
User Details
Upon receiving a request to fetch the user history record with input parameters (User ID and Date Timestamp), the system fetches all the attributes of the user from the history table and performs the following steps:
Validates if all required input parameters have been received as listed below for each specific request.
User ID - Mandatory
Date Timestamp - Mandatory
The record fetched are the latest record existing on or before the date received in the input parameter.
If the mandatory input parameters are missing, then the system triggers the appropriate message.
Response will contain all the attributes for the user including the Active/Inactive status.
In case of exceptions, system triggers relevant error messages.
Fetch RID based on a User ID
Receive request to retrieve RID based on input parameter (User ID, App ID)
User ID and App ID both will be mandatory
Fetch the RID
Respond to the source with the fetched data
Respond with error 'User doesn't exist' if no user is found for User ID received
Document Type to Category Mapping
Create a mapping record of Document Type and Document Category in Valid Document Mapping Master Database
Upon receiving a request to add a mapping of Document Type and Document Category with the input parameters (doctyp_code, doccat_code) the system stores the Mapping of Document type and Document category in the Database
Refer below for the process:
Validates if all required input parameters have been received as listed below for each specific request
doctyp_code - character - 36 - mandatory
doccat_code - character - 36 - mandatory
If the mapping does not exist
is_active flag should be stored as true when the mapping is created
Store the default language code against the mapping
cr_by should be the User ID of the user who is accessing this API
cr_dtimes should be the date-time at which the user is creating the Document Category - Document Type Mapping
if the mapping already exist but is in inactive state
Update the is_acitve flag as “True”
Updated the upd_by and upd_dtimes values against the mapping
If the mapping already exist in active state, throw appropriate error message
Responds with the appropriate message for the mapping being created successfully
The API restricts the bulk creation of Master Data
In case of Exceptions, system triggers error messages as received from the Database.
Remove a mapping record of Document Type and Document Category in Valid Document Mapping Master Database
Upon receiving a request to add a mapping of Document Type and Document Category with the input parameters (doctyp_code, doccat_code) the system stores the Mapping of Document type and Document category in the Database
Refer below for the process:
Validates if all required input parameters have been received as listed below for each specific request
doctyp_code - character - 36 - mandatory
doccat_code - character - 36 - mandatory
If the Document Type is already un-mapped from Document Category, throw an appropriate error message
upd_by should be the User ID of the user who is accessing this API
upd_dtimes should be the date-time when the Document Category - Document Type Mapping is being updated
Change the Is_active flag to “False” for removing the mapping
Responds with the appropriate message for the mapping being created successfully
The API restricts the bulk creation of Master Data
In case of Exceptions, system triggers error messages as received from the Database.
Working and Non-Working Days
API should be able to fetch working days for a Center based on a Center ID
Refer below for the process:
The API should support taking Center ID and Language Code as an mandatory input parameter
The API should respond to the source with all the days of the week for the Center in the language received
Each day should have an attribute marking whether the day is a working day or off-work day
Each day should have an attribute defing the calenday order of days of the week
If the working days are not defined against the Center, the API should fetch the globally defined working and non-working days.
The API should throw error messages in scenarios mentioned in error messages section.
Exceptional Holidays for a Center
API should be able to fetch any defined exceptional holiday dates for a Center based on a Center ID
Refer below for the process:
Validates if all required input parameters have been received as listed below for each specific request
Center ID - character - 10 - mandatory
API should respond to the source with all the exceptional holiday dates for the Center ID received
API should throw relevant error messages in any error scenarios
Registration Management
Registration Center Type
Create Registration Center Type
On receiving a request to add Registration Center Type with the input parameters (code, name, descr, lang_code and is_active), the system stores the Registration Center Type in the Database
Refer below for the process:
This API should only be accessible to Global Admin
The API should accept only the below parameters
name - Character - 64 - Mandatory
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message. Refer messages section
API should perfrom below multi-language validations on the Gender Type data recieved
If, the data is recieved in secondary language and the data for primary language is not present in the database, the 8. API should not allow creation of the Gender Type and throw an error message.
If in the request, all the mandatory data is received in primary langauge but not in the secondary langauge, API should store the data but mark the Gender Type as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
If all the above validations are successfull, the API should store the data the the database
Gender Type Code should be generated at the back-end for any Gender Type added using a UUID generator
API should store cr_by as the Username of the user who is accessing this API
API should store cr_dtimes as the date-time at which the user is creating the Gender Type
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
Update a Registration Center Type
On receiving a request to update a Registration Center Type with the input parameters (code, name, descr, lang_code and is_active), the system Updates the Registration Center Type Details in the Registration Center Type Database for the Code received
Refer below for the process:
This API should only be accessible to Global Admin
The API should accept only the below parameters
code - Character - 36 - Mandatory
name - Character - 64 - Mandatory
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message. Refer messages section
If all the above validations are successfull, the API should update the data in the database agianst the code received
API should perfrom below multi-language validations on the Gender Type data recieved
If in the database, all the mandatory data is present in primary langauge but not in the secondary langauge, API should update the data but mark the Gender Type as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
API should store upd_by as the Username of the user who is accessing this API
API should store upd_dtimes as the date-time at which the user is modiying the Gender Type details
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
Registration Center
Create a Registration Center
Upon receiving a request to add Registration Center with the input parameters, the system Stores the Registration Center in the Database
Refer below for the process:
The system validates if all required input parameters have been received as listed below for each specific request
name - character (128) - mandatory
cntrtyp_code - character (36) - mandatory
addr_line1 - character (256) - mandatory
addr_line2 - character (256) - optional
addr_line3 - character (256) - optional
latitude - character (32) - mandatory
longitude - character (32) - mandatory
location_code - character (36) - mandatory
contact_phone - character (16) - optional
contact_person - character (256) - optional
working_hours - character (32) - mandatory
per_kiosk_process_time - time - mandatory
center_start_time - time - mandatory
center_end_time - time - mandatory
lunch_start_time - time - optional
lunch_end_time - time - optional
holiday_loc_code - character (36) - mandatory
timezone - string (128) - optional
lang_code - character (3) - mandatory
zone_code - character (36) - mandatory
is_active should be set as “False”
number_of_kiosks should be kept as zero for creation of a Registration Center
center_end_time should not be before the center_start_time
Latitude and Longitude should be in format of “(-)XX.XXXX”
Latitude and Longitude should contain at-least 4 digits after decimal
If lunch_end_time and lunch_start_time is sent in the request,
lunch_end_time should not be before the lunch_start_time
The Zone received should be either same as the Zone mapped of the Administrator or a child zone of the Administrator's Zone
cr_by should be the Username of the user who is accessing this API
cr_dtimes should be the date-time at which the user is creating the Registration Center
Center ID should be generated by calling the Registration Center ID Generator and stored against every new Center Created
If, the data is recieved in secondary language and the data for primary language is not present in the database, the API should not allow creation of the Registration Center
Responds with the appropriate message for the Registration Center created successfully
History record should be stores for every creation of a new Registration Center
The API should restricts the bulk creation of Master Data
In case of Exceptions, system triggers error messages as received from the Database.
Update a Registration Center
On receiving a request to update a Registration Center with the input parameters, the system updates the Registration Center Details in the List of Registration Center Database for the center_id received
Refer below for the process:
The system validates if all required input parameters have been received as listed below for each specific request
center_id - character (36) - mandatory
name - character (128) - mandatory
cntrtyp_code - character (36) - mandatory
addr_line1 - character (256) - mandatory
addr_line2 - character (256) - optional
addr_line3 - character (256) - optional
latitude - character (32) - mandatory
longitude - character (32) - mandatory
location_code - character (36) - mandatory
contact_phone - character (16) - optional
contact_person - character (256) - optional
working_hours - character (32) - mandatory
per_kiosk_process_time - time - mandatory
center_start_time - time - mandatory
center_end_time - time - mandatory
lunch_start_time - time - optional
lunch_end_time - time - optional
holiday_loc_code - character (36) - mandatory
timezone - string (128) - optional
lang_code - character (3) - mandatory
zone_code - character (36) - mandatory
is_active - boolean - mandatory
For the center_id received in the request, replaces all the data received in the request against the data existing in the List of Registration Center database against the same center_id.
All the mandatory input parameters should be present
center_end_time should not be before the center_start_time
Latitude and Longitude should be in format of “(-)XX.XXXX”
Latitude and Longitude should contain at-least 4 digits after decimal
If lunch_end_time and lunch_start_time is sent in the request,
lunch_end_time should not be before the lunch_start_time
The Zone received should be either same as the Zone mapped of the Administrator or a child zone of the Administrator's Zone
If in the database, all the mandatory data is present in primary langauge but not in the secondary langauge, API should update the data but mark the Registration Center as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
upd_by should be the Username of the user who is accessing this API
upd_dtimes should be the date-time at which the user is creating the Registration Center
History record should be stores for every modification of a Registration Center
Responds with the Registration Center Code and Language Code for the Registration Center updated successfully
In case of Exceptions, system triggers relevant error messages
Decommission a Registration Center
Upon receiving a request to Decommission a Registration Center with the input parameters (center_id), the system updates the is_deleted flag to true in the List of Registration Center Database against the center_id received
Refer below for the process:
Validate if all required input parameters have been received as listed below for each specific request
center_id - character (36) - Mandatory
Change the “is_Deleted” flag against Registration Center ID to “True”
Change the “is_Active” flag to “False” against the Registration Center.
upd_by should be the Username of the user who is accessing this API
del_dtimes should be the date-time when the Registration Center is being decommissioned
Validate if any Machine, Devices or Users are mapped to the Registration Center
If any Machine, Device or User is assigned to the Registration Center, do no decommission the Registration Center, throw an appropriate error message. Refer “Messages Section”.
The User accessing the API should only be able to decommission a Center under its administrative zone only
Responds with the appropriate message for the Registration Center decommissioned successfully
In case of Exceptions, system triggers relevant error messages
Fetch Registration Center details based on a Registration Center ID and Language Code.
On receiving a request to fetch Registration Center Details with the input parameters (Registration Center ID and Language Code), the system fetches all the Registration Center attributes for the Registration Center ID and Language Code received. The system only fetches active Registration Centers.
Refer below for the process:
While fetching the registration center details the system validates if all required input parameters have been received as listed below for each specific request
Registration Center ID - Mandatory
Language Code - Mandatory
If the mandatory input parameters are missing, throws the appropriate message.
System also validates if the response contains the following attributes for the Registration Center ID along with values as applicable
Registration Center ID
Registration Center Name
Longitude
Latitude
IsActive
Center Type Code
Address
Working Hours
Contact Number
No. of kiosk
Per kiosk Processing time
Starting time
End time
IsActive
In case of Exceptions, system triggers relevant error messages.
Fetch Registration Center record based on a Registration center ID, Date and Language Code from the Registration Center Updation/Creation History table
On receiving a request to fetch Registration Center Creation/Updation History Detail with the input parameters (Registration Center ID, Date and Language Code), the system fetches all the attributes of Registration Center from the history table for the Registration Center ID, Date and Language Code received
Refer below for the process:
While fetching registration center records the system validates if all required input parameters have been received as listed below for each specific request
Registration Center ID - Mandatory
Date - Mandatory
Language Code - Mandatory
The record fetched is the latest record existing on or before the date received in the input parameter
If the mandatory input parameters are missing, system throws the appropriate message.
Validates if the response contains the following attributes for the Registration Center ID along with values as applicable
Registration Center ID
Registration Center Name
Longitude
Latitude
IsActive
Center Type Code
Address
Working Hours
Contact Number
No. of kiosk
Per koisk Processing time
Starting time
End time
IsActive
In case of Exceptions, system triggers relevant error messages.
Fetch Registration Center details based on a Location Code and a Language Code
Upon receiving a request to fetch the List of Registration Centers with the input parameter (Location Code and Language Code), the system fetches the list of all the Registration Centers against the Location Code and Language Code received with all the attributes for each Registration Center. The system only fetches active Registration Centers.
Refer below for the process:
While fetching the registration center details the system validates if all required input parameters have been received as listed below for each specific request
Location Code
Language Code
If the mandatory input parameters are missing, throws the appropriate message
Validates if the response contains all the Registration Center against the Location Code received with the following attributes for the Registration Centers
Registration Center ID
Registration Center Name
Longitude
Latitude
IsActive
Center Type
Address
Working Hours
Contact Number
No. of kiosk
Per koisk Processing time
Starting time
End time
IsActive
In case of Exceptions, system triggers relevant error messages
Fetch Registration Center details based on a Longitude and a Latitude, Proximity Distance and Language Code
On receiving a request to fetch the List of Registration Centers with the input parameter (Longitude and Latitude, Proximity distance and Language Code), the system fetches the List of Registration Centers against the input parameters received. The system only fetches active Registration Centers.
Refer below for the process:
While fetching the registration center details the system validates if all required input parameters have been received as listed below for each specific request
Longitude
Latitude
Proximity Distance
Language Code
If the mandatory input parameters are missing, throw the appropriate message
The responses contain the list of all the Registration Centers in the radius of Proximity distance radius of the Longitude and the Latitude received with all the attributes for each Registration Center
System fetches the record against the Language Code Received
Validates if the response contains all the Registration Center against the Longitude and the Latitude and the Language Code received with the following attributes for the Registration Centers
Registration Center ID
Registration Center Name
Longitude
Latitude
IsActive
Center Type
Address
Working Hours
Contact Number
No. of kiosk
Per koisk Processing time
Starting time
End time
IsActive
In case of Exceptions, system triggers relevant error messages
Fetch the List of Registration Centers based on Location Hierarchy Level, text input and a Language Code
Upon receiving a request to fetch the List of Registration centers with input parameters (Location Hierarchy Level, Text Input and a Language Code), the system fetches the List of Registration centers. The system only fetches active Registration Centers.
Refer below for the process:
While fetching the list of registration centers the system validates if the request contains the following input parameters
Location Hierarchy Level - Mandatory
Text Input - Mandatory
Language Code - Mandatory
If the mandatory input parameters are missing, throws the appropriate message
The list of registration center is fetched based on the combination of Location Hierarchy level and Text received.
System also fetches the list based on the language code received.
The response contains below mentioned attributes for each registration center
Registration Center ID
Registration Center Name
Longitude
Latitude
IsActive
Center Type Code
Address
Working Hours
Contact Number
No. of kiosk
Per kiosk Processing time
Starting time
End time
IsActive
In case of Exceptions, system triggers relevant error messages.
Validates whether a Registration Center is under working hours based on a timestamp received
On receiving a request to fetch Registration Center Details with the input parameters (Registration Center ID and Date-Timestamp), the system determines the status of the Registration center as per the logic defined.
Refer below for the process:
While determining the status of registration center the system validates if all required input parameters have been received as listed below for each specific request
Registration Center ID - Mandatory
Date-Timestamp - Mandatory
If the mandatory input parameters are missing, system throws the appropriate message.
Responds with "Accept" message if both the following conditions are met:
The Registration Center corresponding to the Registration Center ID received must be not on a holiday on the date received in the input parameter.
The Timestamp received in the input parameter must be greater the Registration Center Opening time and Less than or equal to Closing time + 1 Hour.
Responds with the reject scenario if the above two conditions together are not met.
E.g., If the Registration center in not on a holiday and its opening and closing time is (9:00 AM to 5:00 PM). Find the sample response below for different timestamp received.
Timestamp - 4:00 PM - Accepted
Timestamp - 5:00 PM - Accepted
Timestamp - 6:00 PM - Accepted
Timestamp - 6:01 PM - Rejected
In case of Exceptions, system triggers relevant error messages
List of Machine Types
Creation of a Machine Type
Upon receiving a request to add Machine Type (e.g., Dongle/Desktop) with the input parameters (code, name, descr, lang_code and is_active), the system stores the Machine Type in the Database
Refer below for the process:
This API should only be accessible to Global Admin
The API should accept only the below parameters
name - Character - 64 - Mandatory
descr - Character - 128 - Optional
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message. Refer messages section
API should perfrom below multi-language validations on the Machine Type data recieved
If, the data is recieved in secondary language and the data for primary language is not present in the database, the API should not allow creation of the Machine Type and throw an error message. Refer messages section
If in the request, all the mandatory data is received in primary langauge but not in the secondary langauge, API should store the data but mark the Machine Type as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
If all the above validations are successfull, the API should store the data the the database
Machine Type Code should be generated at the back-end for any Machine Type added using a UUID generator
API should store cr_by as the Username of the user who is accessing this API
API should store cr_dtimes as the date-time at which the user is creating the Machine Type
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
Update of a Machine Type
This API should only be accessible to Global Admin
The API should accept only the below parameters
code - Character - 36 - Mandatory
name - Character - 64 - Mandatory
descr - Character - 128 - Optional
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message. Refer messages section
If all the above validations are successfull, the API should update the data in the database agianst the code received
API should perfrom below multi-language validations on the Machine Type data recieved
If in the database, all the mandatory data is present in primary langauge but not in the secondary langauge, API should update the data but mark the Machine Type as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
API should store upd_by as the Username of the user who is accessing this API
API should store upd_dtimes as the date-time at which the user is modiying the Machine Type details
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
List of Machine Specifications
Create Machine Specifications
On receiving a request to add Machine Specifications with the input parameters (name, brand, model, mtyp_code, min_driver_ver, descr, lang_code and is_active) the system stores the Machine Specifications in the Database
Refer below for the process:
This API should only be accessible to Global Admin
The API should accept only the below parameters
name - Character - 64 - Mandatory
brand - Character - 32 - Mandatory
model - Character - 16 - Mandatory
mtyp_code - Character - 36 - Mandatory
min_driver_version - Character - 16 - Mandatory
descr - Character - 256 - Optional
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message. Refer messages section
mtyp_code received should be from list of 'codes' from machine_type masterdata table
If not, the API should throw an error. Refer messages section
API should perfrom below multi-language validations on the Machine Specification data recieved
If, the data is recieved in secondary language and the data for primary language is not present in the database, the API should not allow creation of the Machine Specification and throw an error message. Refer messages section
If in the request, all the mandatory data is received in primary langauge but not in the secondary langauge, API should store the data but mark the Machine Specification as Inactive (is_acitve = false) regardless of what is received in the request for is_active flag
If all the above validations are successfull, the API should store the data the the database
Machine Specification Id should be generated at the back-end for any Machine Specification added using a UUID generator
API should store cr_by as the Username of the user who is accessing this API
API should store cr_dtimes as the date-time at which the user is creating the Machine Specification
API should only allow creation of one record at a time and should restrict bulk creation
API should audit the relevant data when the API is called successfully or when an error is encountered
Update a Machine Specification
On receiving a request to update a Machine Specification with the input parameters (id, name, brand, model, mtyp_code, min_driver_ver, descr, lang_code and is_active), the system updates the Machine Specification Details in the Machine Specification Database for the id received
This API should only be accessible to Global Admin
The API should accept only the below parameters
id - Character - 36 - Mandatory
name - Character - 64 - Mandatory
brand - Character - 32 - Mandatory
model - Character - 16 - Mandatory
mtyp_code - Character - 36 - Mandatory
min_driver_version - Character - 16 - Mandatory
descr - Character - 256 - Optional
lang_code - Character - 3 - Mandatory
is_active - boolean (true/false) - Mandatory
All the mandatory input parameter(s) should be present in the reqeust. If not, throw an appropriate error message
The API should validate the data type and length for each attribute as mentioned above.
In case of any failed validation, API should respond with appropriate error message. Refer messages section
mtyp_code received should be from list of 'codes' from machine_type masterdata table
If not, the API should throw an error.
If all the above validations are successfull