Maksehäirete lisamine ja uuendamine registris läbi krediidihalduse

In English

Sissejuhatus

Maksehäireid on võimalik uuendada Creditinfo 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.

NB! Pankade jaoks on loodud oma XML skeem: 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).

Formaat debtors_info

• XML skeem
• debtors_info_mhr_example.xml - näidisfail deebitoride andmetega.
  
• debtors info.png - deebitoride andmete XML faili struktuuri diagramm.

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_ver2

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

• XML skeem
• bank_debtors_payments_ver2_mhr_example.xml - näidisfail deebitoride andmetega.
  
• bank debtors payments ver2.png - deebitoride andmete XML faili struktuuri diagramm.

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

Faile saab Creditinfole edastada KiDocExchange SOAP liidese kaudu.

Creditinfosse saadetava faili nimi peab olema kujul:

<initsiaalid>_krediidihaldus_<id>.<laiend>

• <initsiaalid> - ettevõtte initsiaalid. Näiteks Creditinfo puhul ki.
• <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

ki_krediidihaldus_20100613.zip