Отримання даних за свідоцтвом про народження (ПІБ): Get Certificate By Name

1. Загальна інформація

Для спрощення моделювання бізнес-процесів розроблено типові інтеграційні конектори для отримання інформації із ДРАЦС[1], налаштування яких відбувається на схемах бізнес-процесів у додатку Camunda Modeler.

Наразі імплементовано 2 типи конекторів для отримання даних із ДРАЦС:

  1. Типове інтеграційне розширення-конектор до SOAP-сервісу ДРАЦС для отримання даних Свідоцтва про народження за вказаними серією і номером Свідоцтва, та датою народження — GetCertByNumRoleBirthDate.

  2. Типове інтеграційне розширення-конектор до SOAP-сервісу ДРАЦС для отримання даних Свідоцтва про народження за вказаними серією і номером Свідоцтва, та ПІБ — GetCertByNumRoleNames.

2. Налаштування делегата

Розширення Get Certificate By Name — делегат для виклику зовнішнього SOAP-сервісу для отримання даних за вказаними серією і номером Свідоцтва, та ПІБ, який налаштовується за допомогою шаблону Get Certificate By Name (getCertificateByNameDracsRegistryDelegate.json).

  1. Відкрийте Service Task.

  2. На панелі налаштувань справа натисніть Open Catalog та оберіть шаблон Get Certificate By Name зі списку.

    get certificate dracs 2

  3. Налаштуйте обраний шаблон:

    • У полі Name вкажіть назву задачі. Це може бути призначення сервісної задачі. Наприклад, Отримати дані зі Свідоцтва про народження.

    • У полі Certificate Number вкажіть номер сертифіката. Наприклад, 218727.

    • У полі Certificate Serial вкажіть серію сертифіката. Наприклад, IV-AM.

      Актуальний формат номера свідоцтва та серію можна перевірити за посиланням.

    • У полі Role вкажіть роль CHILD.

      Наразі Платформа реєстрів підтримує отримання даних виключно для ролі CHILD. Тобто із сервісу ДРАЦС можна отримати виключно дані дитини із сертифіката Свідоцтва про народження. Всі інші передбачені ДРАЦС ролі не підтримуються.

    • У полі Name введіть ім’я дитини. Наприклад, Павло.

    • У полі Surname прізвище дитини. Наприклад, Сидоренко.

    • У полі Patronymic по батькові дитини. Наприклад, Іванович.

    • У полі Result variable вкажіть результівну змінну, до якої необхідно записати відповідь від сервісу — response.

      Приклад відповіді можна подивитися у розділі Імплементація на рівні API

      get certificate dracs 4

3. Імплементація на рівні API

При налаштуванні шаблонів делегата у бізнес-процесі, делегати формують запити у форматі XML і за протоколом SOAP надсилають їх відповідним сервісам ДРАЦС.

Приклад SOAP-запита до API-сервісу GetCertByNumRoleNames згідно з контрактом
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    ...
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <CeServiceRequest xmlns="http://tempuri.org/">
      <ByParam>4</ByParam>
      <CertNumber>218727</CertNumber>
      <CertSerial>IV-AM</CertSerial>
      <DateBirth xsi:nil="true" />
      <Name>Павло</Name>
      <Patronymic>Іванович</Patronymic>
      <Role>1</Role>
      <Surname>Сидоренко</Surname>
    </CeServiceRequest>
  </s:Body>
</s:Envelope>
Приклад відповіді від API згідно з контрактом
{
   "certificate":[
      {
         "certStatus":1,
         "certRepeat":0,
         "certSerial":"IV-AM",
         "certNumber":"218727",
         "certSerialNumber":null,
         "certOrg":null,
         "certDate":null,
         "arOrg":null,
         "arNumb":null,
         "arComposeDate":null,
         "childSurname":"Сидоренко",
         "childName":"Павло",
         "childPatronymic":"Іванович",
         "childBirthdate":null,
         "fatherSurname":null,
         "fatherName":null,
         "fatherPatronymic":null,
         "fatherCitizenship":null,
         "fatherCitizenshipAnother":null,
         "motherSurname":null,
         "motherName":null,
         "motherPatronymic":null,
         "motherCitizenship":null,
         "motherCitizenshipAnother":null,
         "oldSurname":null,
         "oldName":null,
         "oldPatronymic":null,
         "newSurname":null,
         "newName":null,
         "newPatronymic":null,
         "dateOfBirth":null,
         "placeofBirth":null,
         "husbandOldSurname":null,
         "husbandSurname":null,
         "husbandName":null,
         "husbandPatronymic":null,
         "husbandCitizenship":null,
         "husbandBirthdate":null,
         "husbandPlaceofBirth":null,
         "wifeOldSurname":null,
         "wifeSurname":null,
         "wifeName":null,
         "wifePatronymic":null,
         "wifeCitizenship":null,
         "wifeBirthdate":null,
         "wifePlaceOfBirth":null
      }
   ]
}
Параметри зі значенням null не використовуються.
1. ДРАЦС — Державна реєстрація актів цивільного стану.