services.krediidiinfo.ee - User contributions [en]

Mhrlisamine en

2018-12-12T15:24:02Z

Jaan:

{| align="right"
| [[Image:Flag of Estonia.svg|border|30px]] [[Maksehäirete_lisamine_ja_uuendamine_registris_läbi_krediidihalduse|eesti keeles]]
|}

= Introduction =

Payment defaults can be updated by means of Creditinfo’s credit management service. To do that, Sale Ledger statements should be regularly sent to credit management, and an individual agreement as to when they should be sent is made with each customer.

* You can send the Sales Ledger to credit management as an XML file of the format specified by the following schema - The ''debtors_info_ver2
* A separate XML schema has been created for banks - bank_debtors_payments_ver3'

= The ''debtors_info_ver2'' format =

* [https://services.krediidiinfo.ee/schemas/kh/debtors_info_ver2.xsd XML schema]
* [[debtors_info_ver2_mhr_example.xml]] - sample debtor data file. 
* [[Debtors info ver2.png | debtors info ver2.png]] - diagram of the structure of the XML file containing debtors’ data.

The ''/debtors/debtor/additional_data'' tag value with the ''additional_data_name="contract_no"'' attribute is used to add a payment default to the Credit register. The Credit Register also requires the number of the contract that was breached by the outstanding payment to be entered.

If the amounts are stated in euros, the sums referring to the period before the moment the euro came into use will be replaced by Estonian kroons at the rate of 15.6466 kroons to euro. If amounts are still sent in Estonian kroons after the change to the euro, kroons will be substituted with euros at the same rate, so the customer can choose when to start sending the data in euros.

= The ''bank_debtors_payments_ver3'' format =

This format is meant to be used by banks to forward data to credit management. The difference between ''bank_debtors_payments_ver3'' and ''debtors_info'' lies in the fact that the former is not based on invoices.

* [http://www.krediidiinfo.ee/schemas/kh/bank_debtors_payments_ver3.xsd XML schema]
* [[bank_debtors_payments_ver3_mhr_example.xml]] - sample debtor data file. 
* [[Bank debtors payments ver3.png | bank debtors payments ver3.png]] - diagram of the structure of the XML file containing debtors’ data.

If the currency rate is not set in attributes of the ''/debtors/debtor/overdue_payments'' tag, the rate of 15.6466 kroons to euro is used and currency conversions are performed if necessary.

= Forwarding the files =

Files can be sent to Creditinfo by means of the [[KiDocExchange]] SOAP interface.

The format of the name of the file to be sent to Creditinfo must be the following:

<pre>
<initials>_krediidihaldus_<id>.<extension>
</pre>

* <initials> - the initials of the company, for example, ki for Creditinfo. ki.
* <id> - the unique ID of the file in the sender’s system by which the sent file can be identified, for example, the time when the file was generated.
* <extension> - the extension of the file to be sent (XML or ZIP). We recommend compressing the files to be sent.

Example 1: a file to be sent to Creditinfo Eesti AS

<pre>
ki_krediidihaldus_20100613.zip
</pre>

Maksehäirete lisamine ja uuendamine registris läbi krediidihalduse

2018-12-12T15:21:44Z

Jaan:

2013-06-11T13:18:11Z

Jaan: /* Veebiteenuste silumine */

{| align="right"
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[Web Service Debugging|In English]]
|}

= Serveri testimine =

Krediidiinfo SOAP serverisse on sisse ehitatud mõningad silumist ja serveri testimist hõlbustavad võimalused.

SOAP serverit saab kontrollida brauseris päringuga [https://services.krediidiinfo.ee/soap.php?ping https://services.krediidiinfo.ee/soap.php?ping].

Tulemuseks on vastus: KI SOAP server is working!

Võimalus on teha tühipäringut aadressiga [https://services.krediidiinfo.ee/soap.php?dummy_response https://services.krediidiinfo.ee/soap.php?dummy_response]. Päringu tulemuseks on standartne SOAP veateade kujul:

<pre>
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Server</faultcode>
<faultstring>Bad Request. Can't find HTTP_RAW_POST_DATA [DUMMY RESPONCE]</faultstring>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</pre>

Päringut saab kasutada arenduse esimeses faasis programmi või ühenduse testimiseks.

= Veebiteenuste silumine =

Mõningaid veebiteenuseid saab käivitada silumise režiimis. Silumise režiimis suhtleb server kliendiga, kuid kliendi poolt saadetud päringuid ei töödelda rakendusskeskkonnas vaid silumiseks loodud testkeskkonnas.

Silumise režiimis päringute jaoks tuleb veebiteenuse URL-i lõppu lisada parameeter ''debug''.

Näiteks KiDocExchange liidese korral, mille URL on:

<pre>
https://services.krediidiinfo.ee/soap.php?name=KiDocExchange
</pre>

tuleks kasutada URL-i:
<pre>
https://wservices.krediidiinfo.ee/soap.php?name=KiDocExchange&debug
</pre>

NB! Silumise režiimis tehtavate päringute jaoks peab Krediidiinfo andma kasutajale vastava õiguse. Kui seda õigust ei ole, siis tekib pärimisel viga koodiga -20004.

= Raportite silumine =

Silumise jaoks võib alati pärida raportid koodiga ''RAXXXE''. ''RAXXXE'' päringute eest tasu ei võeta! Raporti ''RAXXXE'' XML skeem asub aadressil [http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd].

Raportis on loodud märgendid kõigis skalaarsetes tüüpides, mida Krediidiinfo XML-ides kasutatakse.
Raporti ''RAXXXE'' näidis:

<pre>
<?xml version="1.0" encoding="UTF-8"?>
<report xmlns="http//www.krediidiinfo.ee/schemas/report/RAXXXE.xsd">
<date_tag>2007-10-23</date_tag>
<date_time>2007-10-23T10:10:42</date_time>
<int_tag>12345</int_tag>
<decimal_tag>123456.789</decimal_tag>
<string_tag>I am a string</string_tag>
<codes_tag>&amp; ' &quot; &lt; &gt;</codes_tag>
<est_character_tag>õ ä ö ü Õ Ä Ö Ü</est_character_tag>
<subject_code>00000000</subject_code>
</report>
</pre>

Märgendi ''subject_code'' väärtuseks on alati meetodi sisendparameetri ''subjectCode'' väärtus.

Teile koostatud raporti testimiseks pöörduge klienditeeniduse poole, kes annavad Teile testandmebaasiõiguse

= Veaolukorrad =

Kui SOAP päring ebaõnnestub, siis server saadab tagasi vea teate ja koodi standartse SOAP veateatega. SOAP veavastuses on ''Fault'' märgend, mille alammärgendisse''details'' lisatakse täiendavat informatsiooni vea kohta.

* Fault\details\errorcode - Vea kood
* Fault\details\exception_name - Eriolukorra nimi
* Fault\details\line_no - Rea number, kus veaolukord tekkis.

Vea koodist, ''exceptioni'' nimest ja rea numbrist on abi Krediidiinfo tehnilisel toel vea täpsema põhjuse tuvastamiseks.

Vea tekkimisel tasub veakoodi tähendust otsida kõigepealt veebiteenuse dokumentatsioonist, seejärel [[Veakoodid | üldistest veakoodidest]] ning kui ikka veakoodi tähendust ei leita, pöörduda Krediidiinfo [[Tehniline tugi|tehnilise toe]] poole.

2011-04-01T12:53:06Z

Jaan: /* Formaat debtors_info */

= 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 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).

= Formaat ''debtors_info'' =

* [http://www.krediidiinfo.ee/schemas/kh/debtors_info.xsd XML skeem]
* [[debtors_info_mhr_example.xml]] - näidisfail deebitoride andmetega. 
* [[Debtors info.png | 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_ver2'' =

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

* [http://www.krediidiinfo.ee/schemas/kh/bank_debtors_info_ver2.xsd XML skeem]
* [[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 | bank debtors info ver2.png]] - deebitoride andmete XML faili struktuuri diagramm.

Kui märgnedi ''/debtors/debtor/balances'' 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 Krediidiinfole edastada [[KiDocExchange]] SOAP liidese kaudu.

Krediidiinfosse saadetava faili nimi peab olema kujul:

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

* <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

<pre>
ki_krediidihaldus_20100613.zip
</pre>

KiCompany

2008-01-25T13:46:00Z

Jaan: /* Tutvustus */

= Tutvustus =

KiCompany on Krediidiinfo SOAP protokollil põhinev veebiteenus ettevõtete, mittetulundusühingute ja riigiasutuste põhiandmete pärimiseks. Liides on mõeldud klientidele, kes soovivad integreerida oma süsteemi [http://firmaparing.krediidiinfo.ee firmapäringu] funktsionaalsust.

= WSDL =

KiCompany WSDL asub aadressil [http://services.krediidiinfo.ee/KiCompany.wsdl http://services.krediidiinfo.ee/KiCompany.wsdl].

= Meetodid =

== getName ==

Ettevõtte nime pärimine.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameetrid:
| regCode
| xs:string
| Ettevõtte äriregistri kood.
|-
| Väljundparameeter:
| name
| xs:string
| Ettevõtte nimi. Kui ettevõtte nime ei leita (sellise nimega ettevõtet ei eksisteeri, ettevõtte äriregistrikood vigane vms), siis on väljundparameetri väärtuseks tühistring.
|}

== findCompanies ==

Ettevõtete otsimine nime järgi. Tulemuseks on massiiv, mis sisaldab otsingustringile sobivate ettevõtete nimesid ja äriregistrikoode.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameetrid:
| regCode
| xs:string
| Ettevõtte äriregistri kood
|-
| 
| count
| xs:int
| Leitud ettevõtete maksimaalne arv, mis meetodi tulemuses võib olla. (Meetod ei tagasta korraga rohkem kui 100 ettevõtet)
|-
| Väljundparameeter:
| companies
| ResultCompanyIDDataArray
| Indekseeritud massiiv, mille elementideks on ResultCompanyIDData tüüpi elemendid.
|}

ResultCompanyIDData on kirje järgmise struktuuriga:

{| style="border-style: solid; border-width: 1px;"
! Nimi
! Tüüp
! Kirjeldus
|-
| regCode
| xs:string
| Ettevõtte äriregistri kood
|-
| name
| xs:string
| Ettevõtte nimi.
|}

== getBasicData ==

Ettevõtte põhiandmete pärimine.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameetrid:
| regCode
| xs:string
| Ettevõtte äriregistri kood.
|-
| Väljundparameeter:
| data
| CompanyBasicDataType
| Kirje ettevõtte andmetega.
|}

Kui ''regCode''-ile vastavat ettevõtet ei leita, siis tagastatakse SOAP veateade koodiga -10231.

CompanyBasicDataType tüüpi kirje järgmise struktuuriga:

{| style="border-style: solid; border-width: 1px;"
! Nimi
! Tüüp
! Kirjeldus
|-
| regCode
| xs:string
| ettevõtte äriregistri kood
|-
| name
| xs:string
| ettevõtte nimi.
|-
| street
| xs:string
| tänava nimi turunduseks kasutatavas postiaadressis
|-
| postCode
| xs:string
| posti indeksi number turunduseks kasutatavas postiaadressis
|-
| city
| xs:string
| linna nimi turunduseks kasutatavas postiaadressis
|-
| legalStreet
| xs:string
| tänava nimi juriidilises aadressis
|-
| legalPostCode
| xs:string
| posti indeksi number juriidilises aadressis
|-
| legalCity
| xs:string
| linnanimi juriidilises aadressis
|-
| phones
| xs:string
| telefonide numbrid
|-
| faxes
| xs:string
| fakside numbrid
|-
| web
| xs:string
| interneti kodulehekülje URL
|-
| emails
| xs:string
| e-posti aadressid
|-
| legalForm
| xs:string
| juriidiline vorm
|-
| shareCapital
| xs:int
| osakapitali suurus
|-
| shareCapitalCur
| xs:string
| valuuta tähis, milles on osakapitali suurus antud
|-
| regTime
| xs:string
| ettevõtte registreerimise aeg Äriregistris. Formaat: yyyy-mm-dd
|-
| regPlace
| xs:string
| registriosakonna nimetus kus ettevõte registreeriti
|-
| activities
| xs:string
| ettevõtte tegevusalade loetelu. Iga tegevusala ees on string '* ' (tärn ja tühik).
|-
| status
| xs:string
| äriregistri staatuse nimetus
|-
|}

== getContactData ==

Ettevõtte kontaktandmete pärimine.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameetrid:
| regCode
| xs:string
| ettevõtte äriregistri kood.
|-
| Väljundparameeter:
| data
| CompanyContactDataType
| kirje kontaktandmetega
|}

Kui ''regCode''-ile vastavat ettevõtet ei leita, siis tagastatakse SOAP veateade koodiga -10231.

CompanyContactDataType tüüpi kirje on järgmise struktuuriga:

{| style="border-style: solid; border-width: 1px;"
! Nimi
! Tüüp
! Kirjeldus
|-
| street
| xs:string
| tänava nimi turunduseks kasutatavas postiaadressis
|-
| postCode
| xs:string
| posti indeksi number turunduseks kasutatavas postiaadressis
|-
| city
| xs:string
| linna nimi turunduseks kasutatavas postiaadressis
|-
| phones
| xs:string
| telefonide numbrid
|-
| faxes
| xs:string
| fakside numbrid
|-
| web
| xs:string
| interneti kodulehekülje URL
|-
| emails
| xs:string
| e-posti aadressid
|}

== getLegalPostAddress ==

Ettevõtte juriidilise aadressi pärimine.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameetrid:
| regCode
| xs:string
| ettevõtte äriregistri kood.
|-
| Väljundparameeter:
| data
| CompanyPostAddressType
| kirje juriidilise aadressi andmetega
|}

Kui ''regCode''-ile vastavat ettevõtet ei leita, siis tagastatakse SOAP veateade koodiga -10231.

CompanyPostAddressType tüüpi kirje on järgmise struktuuriga:

{| style="border-style: solid; border-width: 1px;"
! Nimi
! Tüüp
! Kirjeldus
|-
| street
| xs:string
| tänava nimi
|-
| postCode
| xs:string
| indeks
|-
| city
| xs:string
| linn
|}

== isRegCodeValid ==

Ettevõtte äriregistri korrektsuse kontrollimine.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameetrid:
| regCode
| xs:string
| Ettevõtte äriregistri kood
|-
| Väljundparameeter:
| isValid
| xs:boolean
| Tõene, kui parameetriga ette antud äriregistri kood on kaheksakohaline arv ja viimane kontrollnumber on õige.
|}

= Veakoodid =

== -10231 No company found! ==

Krediidiinfo andmebaasist ei leitud parameetriga ette antud registrikoodile vastavat ettevõtet. Kontrollida registrikoodi.

(vt lisaks [[Veakoodid|üldiseid veakoode]])