Maksehäirete lisamine ja uuendamine registris läbi krediidihalduse

Sissejuhatus

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.

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_minmhr_example.xml - näidisfail minimaalsete andmetega, mida on vaja maksehäirete lisamiseks ja uuendamiseks registris.
  
• 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_info

Formaat on mõeldud pankadele andmete edastamiseks krediidihaldusesse.

• bank_debtors_info_ver2_mhr_example.xml - näidisfail deebitoride andmetega.
  
• bank_debtors_info_ver2_minmhr_example.xml - näidisfail deebitoride miinimumandmetega, mis on vaja maksehäirete lisamiseks ja uuendamiseks
  
• bank debtors info ver2.png - deebitoride andmete XML faili struktuuri diagramm.

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.

Failide edastamine

Faile saab Krediidiinfole edastada KiDocExchange SOAP liidese kaudu.

Krediidiinfosse saadetava faili nimi peab olema kujul:

<initsiaalid>_krediidihaldus_<id>.<laiend>

• <initsiaalid> - ettevõtte initsiaalid. Näiteks Krediidiinfo pohul 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: Krediidiinfo AS saadetav fail

ki_krediidihaldus_20100613.zip