Meetod: GET /person/representationRights

OpenAPI/Swagger: https://ar-rest.rik.ee/docs#/Person/get_representation_rights

Tagastab isiku esindusõigused ettevõtetes - millistes ettevõtetes isik omab esindusõigust, tema roll, ainuesindusõiguse olemasolu ja esindusõiguse eritingimused. Teenus võimaldab kontrollida isiku esindusõigusi kõigis ettevõtetes korraga. Sobib esindusõiguse kontrollimiseks ja taustakontrolliks.

Päringu parameetrid

Parameeter	Tüüp	Kohustuslik	Kirjeldus
personFirstName	string	Valikuline	Seotud füüsilise isiku eesnimi. Vähemalt 2 märki (minLength: 2).
surnameLegalEntityName	string	Valikuline	Perekonnanimi või ärinimi. Vähemalt 2 märki (minLength: 2).
personBirthday	string (date)	Valikuline	Seotud füüsilise isiku sünnikuupäev
personType	PersonType	Valikuline	Isiku tüüp: J – juriidiline isik, P – füüsiline isik. Vaikimisi: P.
entityCode	string	Valikuline	Isikukood või registrikood
entityCodeCountry	string	Valikuline	Isiku- või registrikoodi riik (ISO 3166-1 alpha-3)
pageNumber	integer	Valikuline	Tulemuste lehekülje number. Vaikimisi: 1. Maksimaalselt: 100000.
pageSize	integer	Valikuline	Soovitud tulemuste arv ühel lehel. Vaikimisi: 100. Maksimaalselt: 1000.

Päise parameetrid

Parameeter	Tüüp	Kohustuslik	Kirjeldus
apiVersion	ApiVersions	Valikuline	API versiooni päis Vaikimisi: V1.
acceptLanguage	AcceptLanguage	Valikuline	Klassifikaatorite tõlgete keel (est – eesti, eng – inglise) Vaikimisi: est.

Vastused

Edukas päring – Mari Maasikas võib ettevõtet esindada üksinda.

{
 "total": 1,
 "list": [
 {
 "legalEntityName": "NÄIDIS OÜ",
 "registryCode": 12345678,
 "persons": [
 {
 "firstName": "Mari",
 "surnameLegalEntityName": "Maasikas",
 "entityCode": "48503151233",
 "entityCodeCountry": "EST",
 "birthday": "1985-03-15",
 "personType": "F1",
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "exclusiveRightOfRepresentation": true,
 "entityCodeCountryAsText": "Eesti"
 }
 ],
 "representationRightSpecialConditions": [],
 "representationRightGroups": [],
 "legalForm": "5",
 "legalFormAsText": "Osaühing",
 "status": "R",
 "statusAsText": "Registreeritud"
 }
 ]
}

Edukas päring – Jüri Juurikas võib ettevõtet esindada üksinda; Anna Aedmaasikas ja Erik Esimerkki ühiselt.

{
 "total": 1,
 "list": [
 {
 "legalEntityName": "SUUR ETTEVÕTE AS",
 "registryCode": 10000001,
 "persons": [
 {
 "firstName": "Jüri",
 "surnameLegalEntityName": "Juurikas",
 "entityCode": "38006201232",
 "entityCodeCountry": "EST",
 "birthday": "1980-06-20",
 "personType": "F1",
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "exclusiveRightOfRepresentation": true,
 "entityCodeCountryAsText": "Eesti"
 },
 {
 "firstName": "Anna",
 "surnameLegalEntityName": "Aedmaasikas",
 "entityCode": "49011251238",
 "entityCodeCountry": "EST",
 "birthday": "1990-11-25",
 "personType": "F1",
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "exclusiveRightOfRepresentation": false,
 "entityCodeCountryAsText": "Eesti"
 },
 {
 "firstName": "Erik",
 "surnameLegalEntityName": "Esimerkki",
 "entityCode": "FI-EXAMPLE-001",
 "entityCodeCountry": "FIN",
 "birthday": "1988-08-12",
 "personType": "F2",
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "exclusiveRightOfRepresentation": false,
 "entityCodeCountryAsText": "Soome"
 }
 ],
 "representationRightSpecialConditions": [
 "Äriühingut võib esindada Jüri Juurikas üksinda või Anna Aedmaasikas ja Erik Esimerkki ühiselt."
 ],
 "representationRightGroups": [
 {
 "groupNumber": 1,
 "persons": [
 {
 "firstName": "Anna",
 "surnameLegalEntityName": "Aedmaasikas",
 "entityCode": "49011251238",
 "entityCodeCountry": "EST",
 "birthday": "1990-11-25",
 "personType": "F",
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "exclusiveRightOfRepresentation": false,
 "entityCodeCountryAsText": "Eesti"
 },
 {
 "firstName": "Erik",
 "surnameLegalEntityName": "Esimerkki",
 "entityCode": "FI-EXAMPLE-001",
 "entityCodeCountry": "FIN",
 "birthday": "1988-08-12",
 "personType": "F",
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "exclusiveRightOfRepresentation": false,
 "entityCodeCountryAsText": "Soome"
 }
 ]
 }
 ],
 "legalForm": "1",
 "legalFormAsText": "Aktsiaselts",
 "status": "R",
 "statusAsText": "Registreeritud"
 }
 ]
}

Päringule vastavaid andmeid ei leitud.

Juurdepääs teenusele on keelatud.

Ressurssi ei leitud.

{
 "message": "Resource not found",
 "code": 4041,
 "id": "abc123-def456"
}

Vigane päring – parameetrid ei vasta nõuetele.

{
 "detail": [
 {
 "loc": ["query", "personFirstName"],
 "msg": "String should have at least 2 characters",
 "type": "string_too_short"
 }
 ]
}

Vastuse skeem

RepresentationRightsResponse

Väli	Tüüp	Kirjeldus
total	integer	Kohustuslik.
list	array[CompanyRepresentationRights]	Kohustuslik. Ettevõtjad

CompanyRepresentationRights

Väli	Tüüp	Kirjeldus
legalEntityName	string	Kohustuslik. Ettevõtte ärinimi
registryCode	integer	Kohustuslik. Ettevõtte registrikood
representationRightSpecialConditions	array[string]	Esindusõiguse eritingimused
representationRightGroups	array[RepresentationRightsGroup]	Esindusõiguse rühmad ja nende ühisesinduse reeglid
persons	array[RepresentationRightsPerson]	Kohustuslik. Esindusõigusega isikud
legalForm	string	Kohustuslik. Õiguslik vorm
legalFormAsText	string	Kohustuslik. Õiguslik vorm tekstina
status	string	Kohustuslik. Staatus
statusAsText	string	Kohustuslik. Staatus tekstina

RepresentationRightsGroup

Väli	Tüüp	Kirjeldus
groupNumber	integer	Kohustuslik. Rühma number
persons	array[RepresentationRightsPerson]	Kohustuslik. Rühma kuuluvad isikud

RepresentationRightsPerson

Väli	Tüüp	Kirjeldus
firstName	string | null	Eesnimi
surnameLegalEntityName	string	Kohustuslik. Perekonnanimi või ärinimi
entityCode	string | null	Isikukood või registrikood
entityCodeCountry	string	Kohustuslik. Isiku- või registrikoodi riik (ISO 3166-1 alpha-3)
entityCodeCountryAsText	string | null	Isiku- või registrikoodi riigi nimi. Valikuline.
birthday	string (date) | null	Sünnikuupäev
personType	string	Kohustuslik. Isiku tüüp
role	string	Kohustuslik. Isiku roll
roleAsText	string	Kohustuslik. Roll tekstina
exclusiveRightOfRepresentation	boolean | null	Ainuesindusõiguse olemasolu

JSON Schema

{
 "RepresentationRightsResponse": {
 "type": "object",
 "required": ["total", "list"],
 "properties": {
 "total": {
 "type": "integer",
 "description": "Leitud ettevõtete koguarv"
 },
 "list": {
 "type": "array",
 "items": { "$ref": "#/components/schemas/CompanyRepresentationRights" },
 "description": "Ettevõtete nimekiri"
 }
 }
 },
 "CompanyRepresentationRights": {
 "type": "object",
 "required": ["legalEntityName", "registryCode", "persons", "legalForm", "legalFormAsText", "status", "statusAsText"],
 "properties": {
 "legalEntityName": { "type": "string" },
 "registryCode": { "type": "integer" },
 "representationRightSpecialConditions": { "type": "array", "items": { "type": "string" } },
 "representationRightGroups": { "type": "array", "items": { "$ref": "#/components/schemas/RepresentationRightsGroup" } },
 "persons": { "type": "array", "items": { "$ref": "#/components/schemas/RepresentationRightsPerson" } },
 "legalForm": { "type": "string" },
 "legalFormAsText": { "type": "string" },
 "status": { "type": "string" },
 "statusAsText": { "type": "string" }
 }
 },
 "RepresentationRightsGroup": {
 "type": "object",
 "required": ["groupNumber", "persons"],
 "properties": {
 "groupNumber": { "type": "integer" },
 "persons": { "type": "array", "items": { "$ref": "#/components/schemas/RepresentationRightsPerson" } }
 }
 },
 "RepresentationRightsPerson": {
 "type": "object",
 "required": ["surnameLegalEntityName", "entityCodeCountry", "personType", "role", "roleAsText"],
 "properties": {
 "firstName": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
 "surnameLegalEntityName": { "type": "string" },
 "entityCode": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
 "entityCodeCountry": { "type": "string" },
 "entityCodeCountryAsText": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
 "birthday": { "anyOf": [{ "type": "string", "format": "date" }, { "type": "null" }] },
 "personType": { "type": "string" },
 "role": { "type": "string" },
 "roleAsText": { "type": "string" },
 "exclusiveRightOfRepresentation": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] }
 }
 }
}