Сервіс пошуку суб’єкта в ЄДР (SearchSubjects)

Сервіс SearchSubjects надає можливість здійснити пошук у Єдиному державному реєстру юридичних та фізичних осіб (ЄДР) та отримати відомості щодо загальної інформації про суб’єкта відповідно до критеріїв пошуку через ШБО "Трембіта".

Пошук суб’єкта в ЄДР здійснюється за параметрами:

code — код ЄДРПОУ або РНОКПП;
passport — серія та/або номер документа, що посвідчує фізичну особу;
name — назва організації юридичної особи або ПІБ фізичної особи-підприємця (ФОП).

Серія та номер паспорту використовується для фізичної особи-підприємця, якщо особа відмовилась від отримання ІПН (РНОКПП). Формат: серія (дві кирилічні літери у верхньому регістрі), об’єднана з шістьма цифрами номеру, наприклад: СН012345; або, у разі нового пластикового паспорта, номер у вигляді дев’яти цифр

Приклад 1. запит у форматі XML:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:edr="http://nais.gov.ua/api/sevdeir/EDR" xmlns:xro="http://x-road.eu/xsd/xroad.xsd" xmlns:iden="http://x-road.eu/xsd/identifiers">
   <soapenv:Header>
      <edr:AuthorizationToken>00000000000000000000000000000000000000</edr:AuthorizationToken>
      <xro:protocolVersion>4.0</xro:protocolVersion>
      <xro:id>MDTUDDM</xro:id>
      <xro:userId>MDTUDDM</xro:userId>
      <xro:service iden:objectType="SERVICE">
         <iden:xRoadInstance>SEVDEIR-TEST</iden:xRoadInstance>
         <iden:memberClass>GOV</iden:memberClass>
         <iden:memberCode>00015622</iden:memberCode>
         <!--Optional:-->
         <iden:subsystemCode>2_MJU_EDR_prod</iden:subsystemCode>
         <iden:serviceCode>SearchSubjects</iden:serviceCode>
         <!--Optional:-->
      </xro:service>
      <xro:client iden:objectType="SUBSYSTEM">
         <iden:xRoadInstance>SEVDEIR-TEST</iden:xRoadInstance>
         <iden:memberClass>GOV</iden:memberClass>
         <iden:memberCode>43395033</iden:memberCode>
         <!--Optional:-->
         <iden:subsystemCode>IDGOV_TEST_01</iden:subsystemCode>
      </xro:client>
   </soapenv:Header>
   <soapenv:Body>
      <edr:SearchSubjects>
         <edr:code>0000000000</edr:code>
      </edr:SearchSubjects>
   </soapenv:Body>
</soapenv:Envelope>

Приклад 2. відповідь у форматі XML:

<soap11env:Envelope xmlns:soap11env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tns="http://nais.gov.ua/api/sevdeir/EDR" xmlns:xroad="http://x-road.eu/xsd/xroad.xsd" xmlns:id="http://x-road.eu/xsd/identifiers">
   <soap11env:Header>
      <tns:AuthorizationToken>00000000000000000000000000000000000000</tns:AuthorizationToken>
      <xroad:userId>MDTUDDM</xroad:userId>
      <xroad:client id:objectType="SUBSYSTEM">
         <id:xRoadInstance>SEVDEIR-TEST</id:xRoadInstance>
         <id:memberClass>GOV</id:memberClass>
         <id:memberCode>43395033</id:memberCode>
         <id:subsystemCode>IDGOV_TEST_01</id:subsystemCode>
      </xroad:client>
      <xroad:service id:objectType="SERVICE">
         <id:xRoadInstance>SEVDEIR-TEST</id:xRoadInstance>
         <id:memberClass>GOV</id:memberClass>
         <id:memberCode>00015622</id:memberCode>
         <id:subsystemCode>2_MJU_EDR_prod</id:subsystemCode>
         <id:serviceCode>SearchSubjects</id:serviceCode>
      </xroad:service>
      <xroad:protocolVersion>4.0</xroad:protocolVersion>
      <xroad:id>MDTUDDM</xroad:id>
      <xroad:requestHash algorithmId="http://www.w3.org/2001/04/xmldsig-more#gost34311">0000000000000000000000000000000</xroad:requestHash>
   </soap11env:Header>
   <soap11env:Body>
      <tns:SearchSubjectsResponse>
         <tns:SubjectList>
            <tns:SubjectInfo>
               <tns:state>1</tns:state>
               <tns:state_text>зареєстровано</tns:state_text>
               <tns:name>МІНІСТЕРСТВО ЮСТИЦІЇ УКРАЇНИ</tns:name>
               <tns:url>http://zqedr-api.nais.gov.ua/1.0/subjects/00000000</tns:url>
               <tns:code>00000000</tns:code>
               <tns:id>1234567</tns:id>
            </tns:SubjectInfo>
         </tns:SubjectList>
      </tns:SearchSubjectsResponse>
   </soap11env:Body>
</soap11env:Envelope>

Таблиця 1. Опис структурних параметрів
Параметр	Опис	Тип	Важливість
Блок SubjectInfo "Інформація про суб’єкта"
id	Внутрішній унікальний ідентифікатор суб’єкта в БД ЄДР	string	необов’язково
state	Код стану суб’єкта	string	необов’язково
state_text	Текстове відображення стану суб’єкта	string	необов’язково
code	ЄДРПОУ; якщо суб’єкт - фізична особа-підприємець - замість ІПНа буде десять нулів	string	необов’язково
name	Назва суб’єкта	string	необов’язково
url	Посилання на деталізовану інформацію про суб’єкта (при використанні API)	string	необов’язково
Блок errors "Помилки"
code		string	необов’язково
message		string	необов’язково
inner_code		string	необов’язково
inner_message		string	необов’язково

Таблиця 2. Можливі значення стану (state) суб’єкта з ЄДР
Стан	Опис
-1	«скасовано»
1	«зареєстровано»
2	«в стані припинення»
3	«припинено»
4	«порушено справу про банкрутство»
5	«порушено справу про банкрутство (санація)»
6	«зареєстровано, свідоцтво про державну реєстрацію недійсне»

Актуальну інформацію щодо необхідних ідентифікаторів сервісу та його постачальника, а також опис параметрів і WSDL, ви можете отримати за посиланнями: