# Об'єкт ESSCompany

##### **Опис параметрів об’єкта**

<div class="c_tableWrapper__a48" id="bkmrk-%D0%9F%D0%BE%D0%BB%D0%B5-%D0%A2%D0%B8%D0%BF-%D0%9E%D0%BF%D0%B8%D1%81-id-num"><table style="width: 100%; height: 729.163px;"><thead><tr style="height: 29.6px;"><th style="width: 26.5725%; height: 29.6px;">Поле</th><th style="width: 9.6525%; height: 29.6px;">Тип</th><th style="width: 63.8704%; height: 29.6px;">Опис</th></tr></thead><tbody><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`id`</td><td style="width: 9.6525%; height: 30.9125px;">number</td><td style="width: 63.8704%; height: 30.9125px;">Внутрішній ідентифікатор компанії.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`fullName`</td><td style="width: 9.6525%; height: 30.9125px;">string/null</td><td style="width: 63.8704%; height: 30.9125px;">Повна назва українською.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`shortName`</td><td style="width: 9.6525%; height: 30.9125px;">string/null</td><td style="width: 63.8704%; height: 30.9125px;">Скорочена назва українською.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`fullNameEN`</td><td style="width: 9.6525%; height: 30.9125px;">string/null</td><td style="width: 63.8704%; height: 30.9125px;">Повна назва англійською.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`shortNameEN`</td><td style="width: 9.6525%; height: 30.9125px;">string/null</td><td style="width: 63.8704%; height: 30.9125px;">Скорочена назва англійською.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`type`</td><td style="width: 9.6525%; height: 30.9125px;">enum</td><td style="width: 63.8704%; height: 30.9125px;">Тип компанії, наприклад, `COMPANY` або `SELF_EMPLOYED`.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`code`</td><td style="width: 9.6525%; height: 30.9125px;">string</td><td style="width: 63.8704%; height: 30.9125px;">Код компанії/ФОП.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`ipn`</td><td style="width: 9.6525%; height: 30.9125px;">string/null</td><td style="width: 63.8704%; height: 30.9125px;">ІПН, якщо застосовується.</td></tr><tr style="height: 47.7125px;"><td style="width: 26.5725%; height: 47.7125px;">`status`</td><td style="width: 9.6525%; height: 47.7125px;">enum</td><td style="width: 63.8704%; height: 47.7125px;">Статус компанії. Частина write/action методів дозволена лише для `ACTIVE` компаній.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`country`</td><td style="width: 9.6525%; height: 30.9125px;">string/null</td><td style="width: 63.8704%; height: 30.9125px;">Країна.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`state`</td><td style="width: 9.6525%; height: 30.9125px;">string/null</td><td style="width: 63.8704%; height: 30.9125px;">Область/регіон.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`locality`</td><td style="width: 9.6525%; height: 30.9125px;">string/null</td><td style="width: 63.8704%; height: 30.9125px;">Населений пункт.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`street`</td><td style="width: 9.6525%; height: 30.9125px;">string/null</td><td style="width: 63.8704%; height: 30.9125px;">Адреса.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`ceoName`</td><td style="width: 9.6525%; height: 30.9125px;">string/null</td><td style="width: 63.8704%; height: 30.9125px;">ПІБ керівника.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`agreemType`</td><td style="width: 9.6525%; height: 30.9125px;">enum/null</td><td style="width: 63.8704%; height: 30.9125px;">Тип договору.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`agreemNumber`</td><td style="width: 9.6525%; height: 30.9125px;">string/null</td><td style="width: 63.8704%; height: 30.9125px;">Номер договору.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`agreemDate`</td><td style="width: 9.6525%; height: 30.9125px;">number</td><td style="width: 63.8704%; height: 30.9125px;">Дата договору, Unix timestamp у секундах.</td></tr><tr style="height: 49.025px;"><td style="width: 26.5725%; height: 49.025px;">`ECDSAStatus` або `ecdsaStatus`</td><td style="width: 9.6525%; height: 49.025px;">enum</td><td style="width: 63.8704%; height: 49.025px;">Готовність компанії до ECDSA залежно від EN-назв.</td></tr><tr style="height: 46.4px;"><td style="width: 26.5725%; height: 46.4px;">`role`</td><td style="width: 9.6525%; height: 46.4px;">enum/null</td><td style="width: 63.8704%; height: 46.4px;">Роль користувача в компанії, якщо company повернена в контексті співробітника.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`employeeStatus`</td><td style="width: 9.6525%; height: 30.9125px;">enum/null</td><td style="width: 63.8704%; height: 30.9125px;">Статус співробітника, якщо company повернена в контексті співробітника.</td></tr><tr style="height: 30.9125px;"><td style="width: 26.5725%; height: 30.9125px;">`employeeEmail`</td><td style="width: 9.6525%; height: 30.9125px;">string/null</td><td style="width: 63.8704%; height: 30.9125px;">Email співробітника в компанії, якщо доступний.</td></tr></tbody></table>

</div><div class="page-content clearfix" id="bkmrk-m-%28mandatory%29-%E2%80%94-%D0%BE%D0%B1%D0%BE%D0%B2"><div dir="auto"><dl class="footnote brackets" id="bkmrk-m-%28mandatory%29-%E2%80%94-%D0%BE%D0%B1%D0%BE%D0%B2-1"><dd><dl class="footnote brackets"><dd></dd></dl>**JSON приклад:**

```json
{
  "id": 123,
  "fullName": "ТОВ \"Тест\"",
  "shortName": "ТОВ \"Тест\"",
  "fullNameEN": "TEST LLC",
  "shortNameEN": "TEST LLC",
  "type": "COMPANY",
  "code": "25412361",
  "ipn": null,
  "status": "ACTIVE",
  "country": "UA",
  "state": "Київська",
  "locality": "Київ",
  "street": "вул. Тестова, 1",
  "ceoName": "Петренко Петро Петрович",
  "agreemType": "INDIVIDUAL",
  "agreemNumber": "123",
  "agreemDate": 1717200000,
  "role": null,
  "employeeStatus": null,
  "employeeEmail": null
}
```

</dd></dl></div></div>