Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. тип: list of objects
  2. може містити: кілька КБВ або fallback-записвизначення причини відсутності даних (excluded, isMissing,reason) або status має значення error .
Expand
titleМодель даних beneficiaries
Технічна назваБізнес назва (x-legalName)ТипRead onlyОбовʼязковість (потребує уточнень)Коментар
uk_UAen_US
beneficiaries
Інформація про кінцевого бенефеціарного влсникаInformation about the ultimate beneficial owner
list of objectstruefalse
 

status

 Статус обробки даних Status of datastringtruefalseenum [processing, complete, error]
 

errorReason

Причина помилкиError reasonstringtruefalseЗаписується тільки якщо значення status = error
 

excluded

Ознака виключення відомостей про КБВ за вказівкою Міністерства юстиції України  stringtruefalse
 

isMissing

Ознака відсутності КБВ юридичної особи stringtruefalse
 

reason

 Причина відсутності КБВ юридичної особи string (multilang)truefalse
 

informationDate

Дата отримання данихDate of informationstring ($dateTime)truetrue
 

beneficiariesGeneralInfo

  objecttruefalse

Може бути декілька.

Якщо хоча б один КБВ невалідний → НЕ записується жоден



beneficialNameПІБ кінцевого бенефеціарного власникаFull name of the ultimate beneficial ownerstring (multilang)truetrueВ запиті Прізвище це відповідь на один запит, Імʼя та По батькові - відповідь на інший запит


addressАдресаAddressmodeltruetrue


beneficiariesType

Тип бенефіціарного володінняType of 

beneficiaries

string (multilang)truetrue


roleРоль КБВ по відношенню до пов’язаного суб’єкта
stringtruetrueВідповідь на запит текстове відображення ролі (roleText)


interest

Відсоток частки статутного капіталу або відсоток права голосу
float truetrue


indirectInterest

Відсоток частки статутного капіталу або відсоток права голосу у разі непрямого впливу
floattruetrue


otherImpact

Інший характер та міру впливу
 




beneficiaryFalse

Ознака можливої недостовірності інформації про КБВ
 


...

СтатусОпис
processingТриває обробка даних
completeДані внесено
errorНе вдалось отримати інформацію з сервісу

Послідовність зміни статусів

  1. При створенні відправці даних для отримання даних з ЄДР про КБВ beneficiaries.status змінюється на processing
  2. При правильному отриманні відповіді 200 з даними beneficiaries.status змінюється з processing на complete
  3. При отриманні помилки beneficiaries.status змінюється з processing на error і в залежності від типу помилки відправляється повідомлення РО

Статуси інтеграції

СтатусОпис
activeЗапити до ЄДР виконуються
payment_requiredОтримано 402, запити зупинено
rate_limit_exceededОтримано 429, запити зупинено
suspendedІнтеграцію вручну зупинено адміністратором
auth_errorПроблема з токеном
access_denied403
invalid_request

400/406

...