Maksehäirete lisamine ja uuendamine registris läbi krediidihalduse: Difference between revisions

From services.krediidiinfo.ee
Jump to navigation Jump to search
No edit summary
No edit summary
 
(23 intermediate revisions by 5 users not shown)
Line 1: Line 1:
= Sissejuhatus =
{| align="right"
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Mhrlisamine_en|In English]]
|}


Maksehäireid on võimalik uuendata Krediidiinfo krediidihalduse teenuse kaudu. Selleks tuleb krediidihaldusesse saata regulaarselt (lepitakse iga kliendiga eraldi kokku) väljavõte müügireskontrast.
Müügireskontrat saab saata krediidihaldusesse XML failis, mille formaat on määratud skeemiga [http://www.krediidiinfo.ee/schemas/kh/debtors_info.xsd http://www.krediidiinfo.ee/schemas/kh/debtors_info.xsd].
NB! Pankade jaoks on loodud oma XML skeem: [http://www.krediidiinfo.ee/schemas/kh/bank_debtors_info_ver2.xsd http://www.krediidiinfo.ee/schemas/kh/debtors_info_ver2.xsd]
= Krediidihalduse andmete sünkroniseerimise põhimõtted =
Krediidihaldusesse tuleb saata infot vaid maksmata arvete kohta. Maksmata arvete koondsaldo näitabki deebitori saldot ning arvetest saab järeldada võla vanust. Need ongi põhilised andmed millel põhineb krediidihaldus. Makstud arved saldod ei muuda ning seepärast ei oma need krediidihalduse jaoks tähtsust.
Sõltuvalt krediidihalduse pakutavatest teenusest võib krediidihaldusesse saadetavaid deebitorite andmeid piirata veel lisaks võla vanusega. Näiteks kui on krediidihaldusega kokkulepe, et kasutatakse ainult maksehäireregistris andmete uuendamise teenust, siis võib krediidihaldusesse saata infot vaid nende deebitoride kohta, kellel on võlgnevused vanemad kui 45 päeva. Deebitorid, kelle võla vanus ei ole 45 päeva, ei ole krediidihaldusele vaja. Saadetavate andmete piiramisega väheneb saadetava faili maht ja andmete importimise kiirus.
Krediidihaldusesse importimisel uuendatakse andmebaasis deebitori arvete saldosid. Need arved, mis enne importi olid maksmata kuid mille kohta sisendfailis info puudus, loetakse makstuks ning saldo märgitakse nulliks. Seega ei ole vaja krediidihaldust teavitada sellest kui mõni arve tasuti. Lihtsalt tuleb teha väljavõte maksmata arvete (ka ettemaksudest, et koondsaldo arvutataks õigesti) hetkeseisust. Selline lähenemine on kliendi jaoks lihtsam (ei ole eelmisest ekspordist vaja midagi meeles pidada) ning viimane sisendfail fail parandab alati kõik andmed krediidihalduses õigeks (andmed ei lähe sünkroonist välja).


= Sissejuhatus =


Maksehäireid on võimalik uuendada Creditinfo krediidihalduse teenuse kaudu. Selleks tuleb krediidihaldusesse saata regulaarselt (lepitakse iga kliendiga eraldi kokku) faili võlgnevuste andmetega.
Fail peab olema XML formaadis ja võimalik on valida kahe erineva skeemi vahel. 


= Formaat ''debtors_info'' =


= Formaat ''debtors_info_ver2'' =


* [[debtors_info_mhr_example.xml]] - näidisfail deebitoride andmetega. <br/>
* [https://services.krediidiinfo.ee/schemas/kh/debtors_info_ver2.xsd XML skeem]
* [[debtors_info_minmhr_example.xml]] - näidisfail minimaalsete andmetega, mida on vaja maksehäirete lisamiseks ja uuendamiseks registris.<br/>
* [[debtors_info_ver2_mhr_example.xml]] - näidisfail deebitoride andmetega. <br/>
* [[Debtors info.png | debtors info.png]] - deebitoride andmete XML faili struktuuri diagramm.
* [[Debtors info ver2.png | debtors info ver2.png]] - deebitoride andmete XML faili struktuuri diagramm.




Line 37: Line 22:
Kui summad on eurodes, siis teisendatakse need kuni eurole ülemineku hetkeni Eesti kroonideks kursiga 15.6466 krooni ühe euro eest. Kui pärast eurole üleminekut saadetakse ikkagi summasid eesti kroonides, siis teisendatakse sama kursiga kroonid euordeks. Seega võivad kliendid ise valida hetke, millal hakata andmeid saatma eurodes.
Kui summad on eurodes, siis teisendatakse need kuni eurole ülemineku hetkeni Eesti kroonideks kursiga 15.6466 krooni ühe euro eest. Kui pärast eurole üleminekut saadetakse ikkagi summasid eesti kroonides, siis teisendatakse sama kursiga kroonid euordeks. Seega võivad kliendid ise valida hetke, millal hakata andmeid saatma eurodes.


= Formaat ''bank_debtors_payments_ver3'' =




= Formaat ''bank_debtors_info'' =
Formaat on mõeldud pankadele andmete edastamiseks krediidihaldusesse. ''bank_debtors_payments_ver3'' erineb ''debtors_info'' formaadist selle poolest, et ei ole arvepõhine.


* [http://www.krediidiinfo.ee/schemas/kh/bank_debtors_payments_ver3.xsd XML skeem]
* [[bank_debtors_payments_ver3_mhr_example.xml]] - näidisfail deebitoride andmetega. <br/>
* [[Bank debtors payments ver3.png | bank debtors payments ver3.png]] - deebitoride andmete XML faili struktuuri diagramm.


Formaat on mõeldud pankadele andmete edastamiseks krediidihaldusesse.


* [[bank_debtors_info_ver2_mhr_example.xml]] - näidisfail deebitoride andmetega. <br/>
Kui märgnedi ''/debtors/debtor/overdue_payments'' atribuutides ei ole määratud valuuta kurssi, siis võetakse kursiks 15.6466 krooni ühe euro eest ning tehakse vajadusel valuuta teisendused.
* [[bank_debtors_info_ver2_minmhr_example.xml]] - näidisfail deebitoride miinimumandmetega, mis on vaja maksehäirete lisamiseks ja uuendamiseks <br/>
* [[Bank debtors info ver 2.png | bank debtors info ver 2.png]] - deebitoride andmete XML faili struktuuri diagramm.


= Failide edastamine =


Kui märgnedis ''/debtors/debtor/balances'' ei ole atribuutides märgitud ära valuuta kurssi, siis võetakse kursiks 15.6466 krooni ühe euro eest ning tehakse vajadusel valuuta teisendused.
Creditinfosse saadetava faili nimi peab olema kujul:


<pre>
<initsiaalid>_krediidihaldus_<id>.<laiend>
</pre>




= Failide edastamine =
* <initsiaalid> - ettevõtte initsiaalid. Näiteks Creditinfo puhul <i>ci</i>.
 
* <id> - faili saatja süsteemis unikaalne id, millega saab saadetud faili identifitseerida. Võib olla ka näiteks faili genereerimise aeg.
* <laiend> - saadetud faili laiend. XML või ZIP. Saadetud faile on soovitav pakkida.


Faile saab Krediidiinfole edastada [[KiDocExchange]] SOAP liidese kaudu.


Näide 1: Creditinfo Eesti AS saadetav fail


Krediidiinfosse saadetava faili nimi peab olema kujul:


<pre>
<pre>
<initsiaalid>_krediidihaldus_<id>.<laiend>
ci_krediidihaldus_20100613.zip
</pre>
</pre>




* <initsiaalid> - ettevõtte initsiaalid. Näiteks Krediidiinfo pohul <i>ki</i>.
== Failiedastusmeetodid ==
* <id> - faili saatja süsteemis unikaalne id, millega saab saadetud faili identifitseerida. Võib olla ka näiteks faili genereerimise aeg.
* <laiend> - saadetud faili laiend. XML või ZIP. Saadetud faile on soovitav pakkida.


=== KiDocExchange ===


Näide 1: Krediidiinfo AS saadetav fail
[[KiDocExchange]] on Creditinfo SOAP liides failide edastamiseks Creditinfosse. Liidest on võimalik integreerida infosüsteemidesse. Liidese kasutamiseks on vaja kasutajanime ja parooli ning KiDocExchange liidese kasutamise õiguseid.


===  Creditinfo failiedastuskeskkond ===


<pre>
Creditinfo failiedastuskeskkond on veebiliides failide saatmiseks Creditinfosse. Liides asub aadressil [https://services.krediidiinfo.ee/filestore.php https://services.krediidiinfo.ee/filestore.php] ning selle kasutamiseks on vaja kasutajanime ja parooli ning liidese kasutamise õiguseid.
ki_krediidihaldus_20100613.zip
</pre>

Latest revision as of 18:21, 12 December 2018

Flag of the United Kingdom.svg In English


Sissejuhatus

Maksehäireid on võimalik uuendada Creditinfo krediidihalduse teenuse kaudu. Selleks tuleb krediidihaldusesse saata regulaarselt (lepitakse iga kliendiga eraldi kokku) faili võlgnevuste andmetega. Fail peab olema XML formaadis ja võimalik on valida kahe erineva skeemi vahel.


Formaat debtors_info_ver2


Märgendi /debtors/debtor/additional_data atribuudiga additional_data_name="contract_no" väärtust kasutatakse maksehäire lisamisel registrisse. Maksehäireregistri nõuete järgi tuleb maksehäire juurde lisada ka lepingu number, mille kohustuse mittetäitmisel maksehäire tekkis.


Kui summad on eurodes, siis teisendatakse need kuni eurole ülemineku hetkeni Eesti kroonideks kursiga 15.6466 krooni ühe euro eest. Kui pärast eurole üleminekut saadetakse ikkagi summasid eesti kroonides, siis teisendatakse sama kursiga kroonid euordeks. Seega võivad kliendid ise valida hetke, millal hakata andmeid saatma eurodes.

Formaat bank_debtors_payments_ver3

Formaat on mõeldud pankadele andmete edastamiseks krediidihaldusesse. bank_debtors_payments_ver3 erineb debtors_info formaadist selle poolest, et ei ole arvepõhine.


Kui märgnedi /debtors/debtor/overdue_payments atribuutides ei ole määratud valuuta kurssi, siis võetakse kursiks 15.6466 krooni ühe euro eest ning tehakse vajadusel valuuta teisendused.

Failide edastamine

Creditinfosse saadetava faili nimi peab olema kujul:

<initsiaalid>_krediidihaldus_<id>.<laiend>


  • <initsiaalid> - ettevõtte initsiaalid. Näiteks Creditinfo puhul ci.
  • <id> - faili saatja süsteemis unikaalne id, millega saab saadetud faili identifitseerida. Võib olla ka näiteks faili genereerimise aeg.
  • <laiend> - saadetud faili laiend. XML või ZIP. Saadetud faile on soovitav pakkida.


Näide 1: Creditinfo Eesti AS saadetav fail


ci_krediidihaldus_20100613.zip


Failiedastusmeetodid

KiDocExchange

KiDocExchange on Creditinfo SOAP liides failide edastamiseks Creditinfosse. Liidest on võimalik integreerida infosüsteemidesse. Liidese kasutamiseks on vaja kasutajanime ja parooli ning KiDocExchange liidese kasutamise õiguseid.

Creditinfo failiedastuskeskkond

Creditinfo failiedastuskeskkond on veebiliides failide saatmiseks Creditinfosse. Liides asub aadressil https://services.krediidiinfo.ee/filestore.php ning selle kasutamiseks on vaja kasutajanime ja parooli ning liidese kasutamise õiguseid.