Query for e-invoice recipients

Query name: arireg.earveRegistriParing_v1
Explanation: Information about e-invoice recipients
Additional information: Originally in use as of 1 May 2017.
XSD: http://www2.rik.ee/schemas/xtee6/arireg/live/xroad6_earve.xsd

Input parameters / search variables:

Name

Meaning

Notes

tagasta_nimed

Whether to return names of companies in reply (TRUE/FALSE)

Default value is “FALSE”.

tulemuste_lk

List page number

1 by default

registrikoodid

List of registry codes for which the query is made

Output data:

  • lehekylgi – the number of pages of the whole list of the response
  • kliendid – a list of customers found
  • klient – one customer row
  • registrikood – registry code of customer
  • nimi – name of customer. Returned, if the query had a value for return_names. Missing, if query input consists of registry codes and the relevant registry code does not have an active relationship/the registry code is faulty.
  • teenusepakkuja – identification of the service provider. Not required. Missing, if query input consists of registry codes and the relevant registry code does not have an active relationship/the registry code is faulty.
  • staatus – result of processing. Possible values: OK – the customer has a valid relationship, MR – registry code was not found, registry code is faulty, the queried registry code does not have an active relationship.

Sample request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xro="http://x-road.eu/xsd/xroad.xsd" xmlns:iden="http://x-road.eu/xsd/identifiers" xmlns:prod="http://arireg.x-road.eu/producer/">
 <soapenv:Body>
 <prod:earveRegistriParing_v1>
 <prod:keha>
 <prod:tagasta_nimed>TRUE</prod:tagasta_nimed>
 <prod:tulemuste_lk>1</prod:tulemuste_lk>
 <prod:registrikoodid>
 <prod:registrikood>70000310</prod:registrikood>
 </prod:registrikoodid>
 </prod:keha>
 </prod:earveRegistriParing_v1>
 </soapenv:Body>
</soapenv:Envelope>

Sample response:

<SOAP-ENV:Envelope xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ZSI="http://www.zolera.com/schemas/ZSI/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <SOAP-ENV:Header/>
 <SOAP-ENV:Body xmlns:ns1="http://arireg.x-road.eu/producer/">
 <ns1:earveRegistriParing_v1Response>
 <ns1:paring>
 <ns1:tagasta_nimed>true</ns1:tagasta_nimed>
 <ns1:tulemuste_lk>1</ns1:tulemuste_lk>
 <ns1:registrikoodid>
 <ns1:registrikood>70000310</ns1:registrikood>
 </ns1:registrikoodid>
 </ns1:paring>
 <ns1:keha>
 <ns1:lehekylgi>1</ns1:lehekylgi>
 <ns1:kliendid>
 <ns1:klient>
 <ns1:registrikood>70000310</ns1:registrikood>
 <ns1:nimi>Registrite ja Infosüsteemide Keskus</ns1:nimi>
 <ns1:teenusepakkuja>Fitek</ns1:teenusepakkuja>
 <ns1:staatus>OK</ns1:staatus>
 </ns1:klient>
 </ns1:kliendid>
 </ns1:keha>
 </ns1:earveRegistriParing_v1Response>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>