Positive register: functional specification: Difference between revisions

From services.krediidiinfo.ee
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
{| align="right"
{| align="right"
| [[Image:Flag of Estonia.svg|border|30px]] [[Positiivne_register:_funktsionaalne_spetsifikatsioon|eesti keeles]]
| [[Image:Flag_of_Estonia.png|border|30px]] [[Positiivne_register:_funktsionaalne_spetsifikatsioon|eesti keeles]]
|}
|}


Line 9: Line 9:
= Definitions =
= Definitions =


* '''Data''' – information about existing obligations of a private person that allows the Member to assess creditworthiness of the individual, as described in “Data composition” chapter.  
* '''Data''' – information about existing obligations of a private person that allows the Member to assess creditworthiness of the individual.  
* '''Data exchange system''' – the IT solution used by the Member to exchange the Data;  
* '''Data exchange system''' – the IT solution used by the Member to exchange the Data;  
* '''Administrator of the data exchange system''' – AS Creditinfo;  
* '''Manager of the data exchange system''' – Creditinfo Eesti AS;  
* '''Codebtor''' – a private person together with whom the Applicant applies for credit and who is taken into account while making the Credit decision;  
* '''Codebtor''' – a private person together with whom the Applicant applies for credit and who is taken into account while making the Credit decision;  
* '''Credit decision''' – the decision made by the Member with regard to concluding the Consumer credit contract with the Applicant;  
* '''Credit decision''' – the decision made by the Member with regard to concluding the Consumer credit contract with the Applicant;  
Line 17: Line 17:
* '''Applicant''' – a private person who turns to the Member with the wish to conclude the Consumer credit contract and provides his/her Agreement for using the Data possessed by the Members;
* '''Applicant''' – a private person who turns to the Member with the wish to conclude the Consumer credit contract and provides his/her Agreement for using the Data possessed by the Members;
* '''Guarantor''' – a person who assumes the obligation before the Member to be liable for performance of the Consumer credit contract obligations of the Applicant;  
* '''Guarantor''' – a person who assumes the obligation before the Member to be liable for performance of the Consumer credit contract obligations of the Applicant;  
* '''Agreement''' – consent of the Applicant for providing the Member making the inquiry with the Data of the Members being the recipients of the inquiry;
* '''Consent '''– consent of the Applicant for providing the Member making the inquiry with the Data of the Members being the recipients of the inquiry;
* '''Member''' – an Estonian or foreign company that joins the Data exchange system and shares the Data about the Applicant with other Members;  
* '''Member''' – an Estonian or foreign company that joins the Data exchange system and shares the Data about the Applicant with other Members;  
* '''Consumer credit contract''' – the contract on the basis of which the Member issues the credit to the Applicant;  
* '''Consumer credit contract''' – the contract on the basis of which the Member issues the credit to the Applicant;  
Line 23: Line 23:
* '''Consumer credit''' – the credit issued to the Applicant by the Member.
* '''Consumer credit''' – the credit issued to the Applicant by the Member.


= Commercial rules =
= Business rules =


* Users of the system are the Members.  
* Users of the system are the ''Members''.  
* A Member must join X-tee.
* A ''Member'' must join X-road.  
* In order to register a Member in the Data exchange system the company registration code, the company’s name and the name of the country where the company operates shall be provided.  
* The ''Member'' inputs ''Data'' to the database of ''Data exchange system'' or provides ''Manager of the data exchange system'' with an IT-based solution to obtain the ''Data'' from him's database.
* The Member inputs the Data to the database of Creditinfo or provides Creditinfo with an IT-based option to obtain the Data from its database.
* The ''Member'' updates the ''Data'' by sending to the ''Data exchange system'' all current ''Data or Consumer credit contract data one by one''.
* The Member updates the Data by sending to Creditinfo all current Data.
* The ''Member'' updates the ''Data'' every 24 hours. At least every 7 days.  
* The Member updates the Data every 24 hours. Where the Data is available on paper – the Member updates the Data every 7 days.  
* The ''Member'' requests the ''Data'' only with the ''Applicant'' prior consent. The ''Consent'' document must be assigned digitally.  
* The Member only shares the Data of the Applicant with prior agreement of the Applicant.  
* The ''Consent'' document is stored in the ''Data exchange system'' for 3 years.
* It should be possible to control the Agreement retroactively.
* A response to the ''Data'' request does not reflect information about the ''Member''.  
* The Agreement can be a simple one or can be digitally signed.
* Composition of the response to the ''Data'' request is described in “Data composition” chapter.  
* An answer for the Data request does not reflect information about the Member.  
* The ''Members'' share the ''Data'' with other Members in equal data composition.
* Composition of the answer to the Data request is described in in “Data composition” chapter.
* An answer with regard to sharing and updating the Data contains the error code and description (http://services.krediidiinfo.ee/wiki/index.php/X-tee_liides_KRI6).  
* The Members share the Data of the composition with other Members.
* The list of the Members of the Data exchange system together with the date of joining is available on Creditinfo website.


= Data composition=
= Data composition=


# Date of updating;
# Date and time of updating data;
# Personal ID code;
# Person identity code;
# Role of the person within the scope of the contract;
# Role of the person within the scope of the contract;
# Contract number (number of the Consumer credit contract concluded between the Member and the Applicant);  
# Contract number;  
# Type of consumer credit;
# Type of consumer credit;
# Effective date of credit agreement – date of commencement of the Consumer credit contract;
# Effective date of credit agreement – date of commencement of the Consumer credit contract;
# End date of credit – the date of repayment of the Consumer credit;  
# End date of credit – the date of repayment of the Consumer credit;  
# Consumer credit sum – the maximum sum of the Consumer credit contract paid or payable to the Applicant;  
# Consumer credit sum – the maximum sum of the Consumer credit paid or payable to the Applicant;  
# Currency – currency of the Consumer credit contract;  
# Currency – currency of the Consumer credit;  
# Payment schedule – the sum and the date of the next or the closest three payments;
# Schedule payments – the sum and the due date of the next or the closest three payments;
# Balance – the amount of the obligation of the consumer before the Member;  
# Balance – the amount of the obligation of the consumer before the Member;  
# Overdue balance – the sum of payments overdue for more than 7 days;
# Overdue balance – the sum of payments overdue for more than 7 days;
# Requests – dates of requests made with regard to the Data of the Applicant made during the past three years.
# Requests – dates of requests made with regard to the Data of the Applicant made during the past three years.
'''Roles of the person'''
#Borrower
#Codebtor
#Guarantor
'''Types of credit'''
#Secured loan
#Hire-purchase
#Unsecured loan
#Lease
#Credit card
#Other


= Use cases =
= Use cases =


[[File:Krediidikohustuste register.jpg]]
[[File:Krediidikohustuste register.jpg]]




== Administration of the Members ==
== Manager data management  ==


Administrator of the data exchange system registers information about the Member in the Data exchange system / removes such information from the Data exchange system.
<u>Data exchange system manager</u> registers information about the Member in the Data exchange system / removes such information from the Data exchange system.


== Sharing of the Data ==
== Credit report request ==


The Member shares the data about the Applicant from the database of the Member through the Data exchange system.
'''Prerequisite:''' <u>Data exchange system manager</u> has given a permission to <u>Member</u> to make a request.
# Member sends a request to the Data exchange system to get applicant's credit obligations;
# Data exchange system queries the Data from the database;
# Data exchange system responses to the requester with the Data.
Extension
* Data repository of the member is stored in Member's system
::2a. Data exchange system queries the Data from Members' systems
* Quering of the Data from Member's system fails
::3a. Data exchange system responses to the requester with the Data and the error message that includes the number of failed queries.


== Administration of the Data ==
== Credit data management ==


'''Prerequisite:''' The Member has concluded the authorization agreement with Creditinfo, under which the Member issues to Creditinfo the rights of authorized data processor with regard to the database held by the Member.  
'''Prerequisite:''' <u>Data exchange system manager</u> has given a permission to <u>Member</u> to make a request.  


The Member forwards information from the database held by the Member to Creditinfo.  
'''Prerequisite:''' The <u>Member</u> has concluded the authorization agreement with Data exchange system manager, under which the Member issues to Data exchange system manager the rights of authorized data processor with regard to the database held by the Member.
 
The Member forwards credit data from the database held by the Member to Data exchange system.  


[[File:Andmete haldus.jpg]]
[[File:Andmete haldus.jpg]]


Scenarios
'''Scenarios'''


A) The Member forwards all current data on consumer credits to the administrator of the Data exchange system in XML format using [[X-road interface: subsystem POSR | x-road interface]].  
'''A)''' The <u>Member</u> forwards all current data on consumer credits to the Data exchange system.
 
'''B)''' The <u>Member</u> changes the consumer credit data in the Data exchange system database.


B) The Member changes the consumer credit details in the Data exchange system using [[X-road interface: subsystem POSR | x-road interface]].


= Sequence diagram =
= Sequence diagram =


[[File:Krediidiotsuse tegemine.jpg]]
[[File:Krediidiotsuse tegemine.jpg]]
Line 89: Line 110:


= Links =
= Links =
[[X-road interface: subsystem POSR | X-road interface]]
[[X-road interface: subsystem POSR|Data exchange system X-road interface]]

Revision as of 12:41, 20 January 2017

File:Flag of Estonia.png eesti keeles

Overview

The Positive Register (Positiivne Register) is the data exchange system, through which creditors that are members of the register are able to share information about person’s credit obligations with consent of the person in question. The Positive Register allows a creditor to fulfill statutory requirements of responsible lending and to ensure a person’s ability to fulfill his or her debt obligations. Loan applicants will no longer have to collect documents from other creditors. Customer will also be better protected from the problems associated with making emotional decisions about loans and excessive debts.


Definitions

  • Data – information about existing obligations of a private person that allows the Member to assess creditworthiness of the individual.
  • Data exchange system – the IT solution used by the Member to exchange the Data;
  • Manager of the data exchange system – Creditinfo Eesti AS;
  • Codebtor – a private person together with whom the Applicant applies for credit and who is taken into account while making the Credit decision;
  • Credit decision – the decision made by the Member with regard to concluding the Consumer credit contract with the Applicant;
  • Borrower – a private person to whom the Member issues the credit based on the Consumer credit contract;
  • Applicant – a private person who turns to the Member with the wish to conclude the Consumer credit contract and provides his/her Agreement for using the Data possessed by the Members;
  • Guarantor – a person who assumes the obligation before the Member to be liable for performance of the Consumer credit contract obligations of the Applicant;
  • Consent – consent of the Applicant for providing the Member making the inquiry with the Data of the Members being the recipients of the inquiry;
  • Member – an Estonian or foreign company that joins the Data exchange system and shares the Data about the Applicant with other Members;
  • Consumer credit contract – the contract on the basis of which the Member issues the credit to the Applicant;
  • Subject – a party to the contract;
  • Consumer credit – the credit issued to the Applicant by the Member.

Business rules

  • Users of the system are the Members.
  • A Member must join X-road.
  • The Member inputs Data to the database of Data exchange system or provides Manager of the data exchange system with an IT-based solution to obtain the Data from him's database.
  • The Member updates the Data by sending to the Data exchange system all current Data or Consumer credit contract data one by one.
  • The Member updates the Data every 24 hours. At least every 7 days.
  • The Member requests the Data only with the Applicant prior consent. The Consent document must be assigned digitally.
  • The Consent document is stored in the Data exchange system for 3 years.
  • A response to the Data request does not reflect information about the Member.
  • Composition of the response to the Data request is described in “Data composition” chapter.
  • The Members share the Data with other Members in equal data composition.

Data composition

  1. Date and time of updating data;
  2. Person identity code;
  3. Role of the person within the scope of the contract;
  4. Contract number;
  5. Type of consumer credit;
  6. Effective date of credit agreement – date of commencement of the Consumer credit contract;
  7. End date of credit – the date of repayment of the Consumer credit;
  8. Consumer credit sum – the maximum sum of the Consumer credit paid or payable to the Applicant;
  9. Currency – currency of the Consumer credit;
  10. Schedule payments – the sum and the due date of the next or the closest three payments;
  11. Balance – the amount of the obligation of the consumer before the Member;
  12. Overdue balance – the sum of payments overdue for more than 7 days;
  13. Requests – dates of requests made with regard to the Data of the Applicant made during the past three years.

Roles of the person

  1. Borrower
  2. Codebtor
  3. Guarantor

Types of credit

  1. Secured loan
  2. Hire-purchase
  3. Unsecured loan
  4. Lease
  5. Credit card
  6. Other


Use cases

Krediidikohustuste register.jpg


Manager data management 

Data exchange system manager registers information about the Member in the Data exchange system / removes such information from the Data exchange system.

Credit report request

Prerequisite: Data exchange system manager has given a permission to Member to make a request.

  1. Member sends a request to the Data exchange system to get applicant's credit obligations;
  2. Data exchange system queries the Data from the database;
  3. Data exchange system responses to the requester with the Data.

Extension

  • Data repository of the member is stored in Member's system
2a. Data exchange system queries the Data from Members' systems
  • Quering of the Data from Member's system fails
3a. Data exchange system responses to the requester with the Data and the error message that includes the number of failed queries.

Credit data management

Prerequisite: Data exchange system manager has given a permission to Member to make a request.

Prerequisite: The Member has concluded the authorization agreement with Data exchange system manager, under which the Member issues to Data exchange system manager the rights of authorized data processor with regard to the database held by the Member.

The Member forwards credit data from the database held by the Member to Data exchange system.

Andmete haldus.jpg

Scenarios

A) The Member forwards all current data on consumer credits to the Data exchange system.

B) The Member changes the consumer credit data in the Data exchange system database.


Sequence diagram

Krediidiotsuse tegemine.jpg


Links

Data exchange system X-road interface