Persons data change list (Beneficial owners)

Query name: arireg.isikuMuudatused_v1
Additional information: The query is intended to search for information about changes of the beneficial owners
XSD: https://www2.rik.ee/schemas/xtee6/arireg/live/xroad6_isikuMuudatused_v1.xsd

Input parameters / search variables:

Name

Data type

Meaning

ariregister_kasutajanimi

String

e-Business Register user

ariregister_parool

String

e-Business Register Password

muudatuse_liik

String

The type of change for which information is requested, if several changes are requested, the element must be repeated

isiku_roll

String

Roles of persons for whom changes are requested, if multiple roles, then the element must be repeated (at the moment only information about beneficial owners)

muudatuse_kpv

Date

Date for which changes are wanted

tulemuste_lk

Int

Response page number, default value 1

tulemusi_lehel

Int

How many results are desired in the answer on one page (number of companies to be returned)

Output data:

Name

Data type

Mandatory?

Meaning

ettevotja

0…*

Company

ettevotja/ariregistri_kood

String

1

the register code value is taken from the ettevotjad table

ettevotja/arinimi

String

1

Business name is taken from the ettevotjad table

ettevotja/oiguslik_vorm

Int

1

Legal form value oiguslikud_vormid_kl is taken from the ettevotjad table

ettevotja/oiguslik_vorm_tekstina String 1 legal form as text (ar.kl_oiguslikud_vormid.nimetus_est)

ettevotja/staatus

String

1

Company status value ettevotja_olekud_kll is taken from the ettevotjad table

ettevotja/staatus_tekstina String 1 Company status as (ar.kl_ettevotja_olekud.nimetus_est)

ettevotja/isiku_muudatus/isiku_roll

String

1

person role classifier e.g. in the case of the beneficial owner 'W'

ettevotja/isiku_muudatus/isiku_roll_tekstina String 1 the role of the person as a text (ar.kl_kandev_isikud_rollid.nimetus_est

ettevotja/isiku_muudatus/muudatuse_liik

Int

1

the value of the change type (1, 2, 3) according to whether the person was added, removed or changed

ettevotja/isiku_muudatus/muudatuse_aeg Datetime 0...1 Date + time of making the change
ettevotja/isiku_muudatus/kandes_isikud_id/vana_isiku_id Int 0...1 invalid entry ar.kandeosad_isikud.id
ettevotja/isiku_muudatus/kandes_isikud_id/uue_isiku_id Int 0...1 new entry ar.kandeosad_isikud.id

tulemuste_arv

Int

1

How many entrepreneurs had a change of persons

Sample request:

<?xml version="1.0"?>
<soapenv:Envelope xmlns:prod="http://arireg.x-road.eu/producer/" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"><soapenv:Header/><soapenv:Body><prod:isikuMuudatused_v1><prod:keha>
<!--Optional:-->
<!--type: string-->
<prod:ariregister_kasutajanimi>Äriregistri kasutajanimi</prod:ariregister_kasutajanimi>
<!--Optional:-->
<!--type: string-->
<prod:ariregister_parool>Äriregistri parool</prod:ariregister_parool>
<!--1 or more repetitions:-->
<!--type: string-->
<prod:isiku_roll>W</prod:isiku_roll>
<!--Zero or more repetitions:-->
<!--type: muudatuseLiik-->
<prod:muudatuse_liik>1</prod:muudatuse_liik><prod:muudatuse_liik>2</prod:muudatuse_liik><prod:muudatuse_liik>3</prod:muudatuse_liik>
<!--type: date-->
<prod:muudatuse_kpv>2020-04-08</prod:muudatuse_kpv>
<!--Optional:-->
<!--type: int-->
<prod:tulemuste_lk>1</prod:tulemuste_lk>
<!--Optional:-->
<!--type: int-->
<prod:tulemusi_lehel>10</prod:tulemusi_lehel></prod:keha></prod:isikuMuudatused_v1></soapenv:Body></soapenv:Envelope>

Sample response:

<?xml version="1.0"?>

<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:ZSI="http://www.zolera.com/schemas/ZSI/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"><SOAP-ENV:Header/>
<SOAP-ENV:Body xmlns:ns1="http://arireg.x-road.eu/producer/"><ns1:isikuMuudatused_v1Response><ns1:paring><ns1:ariregister_kasutajanimi>Äriregistri kasutajanimi</ns1:ariregister_kasutajanimi><ns1:ariregister_parool>Äriregistri parool</ns1:ariregister_parool><ns1:isiku_roll>W</ns1:isiku_roll>
<ns1:muudatuse_liik>1</ns1:muudatuse_liik>
<ns1:muudatuse_liik>2</ns1:muudatuse_liik>
<ns1:muudatuse_liik>3</ns1:muudatuse_liik>
<ns1:muudatuse_kpv>2020-04-08Z</ns1:muudatuse_kpv>
<ns1:tulemuste_lk>1</ns1:tulemuste_lk>
<ns1:tulemusi_lehel>10</ns1:tulemusi_lehel>
</ns1:paring>
<ns1:keha>
<ns1:ettevotja>
<ns1:ariregistri_kood>12362866</ns1:ariregistri_kood>
<ns1:arinimi>Osaühing SCARDOON</ns1:arinimi>
<ns1:oiguslik_vorm>5</ns1:oiguslik_vorm><ns1:oiguslik_vorm_tekstina>Osaühing</ns1:oiguslik_vorm_tekstina>
<ns1:staatus>R</ns1:staatus>
<ns1:staatus_tekstina>Registrisse kantud</ns1:staatus_tekstina>
<ns1:isiku_muudatus>
<ns1:isiku_roll>W</ns1:isiku_roll>
<ns1:isiku_roll_tekstina>Tegelik kasusaaja</ns1:isiku_roll_tekstina>
<ns1:muudatuse_liik>1</ns1:muudatuse_liik>
<ns1:muudatuse_aeg>2020-04-08T14:28:28.002Z</ns1:muudatuse_aeg><ns1:kirje_id_uus>9000935912</ns1:kirje_id_uus>
</ns1:isiku_muudatus>
<ns1:isiku_muudatus>
<ns1:isiku_roll>W</ns1:isiku_roll>
<ns1:isiku_roll_tekstina>Tegelik kasusaaja</ns1:isiku_roll_tekstina>
<ns1:muudatuse_liik>2</ns1:muudatuse_liik>
<ns1:muudatuse_aeg>2020-04-08T14:35:13.002Z</ns1:muudatuse_aeg>
<ns1:kirje_id_vana>9000935913</ns1:kirje_id_vana>
</ns1:isiku_muudatus>
</ns1:ettevotja>
<ns1:tulemuste_arv>1</ns1:tulemuste_arv>
</ns1:keha>
</ns1:isikuMuudatused_v1Response>
</SOAP-ENV:Body></SOAP-ENV:Envelope>