`POST /workers`

Метод позволяет создать подрядчика.

Заголовки

Название	Описание
Content-Type	`application/json`
Authorization	Заголовок авторизации

Тело запроса

Название	Тип	Формат	Обязательность	Описание
externalId	string	`^\w{1,100}$`	`false`	Внешний идентификатор подрядчика
name	string	`^\w{1,500}$`	`false`	Наименование подрядчика
inn	string	`^\d{10}$\d{12}$`	`false`	ИНН подрядчика
ogrn	string	`^\d{13}$\d{15}$`	`false`	ОГРН подрядчика
kpp	string	`\d{4}[\w\d]{2}\d{3}`	`false`	КПП подрядчика
notification	object	Notification	`true`	Контактные данные
elementIds	array	Guid	`true`	Элементы приемки, за которые ответственен подрядчик

При заполнении полей подрядчиков обязательными являются ogrn или inn+kpp. По этим полям находится организация и автоматически дозаполняются остальные реквизиты подрядчика.

Если данные не найдены, то в ответе будет возвращена соответствующая ошибка. В этом случае необходимо заполнить все требуемые поля вручную.

Пример

Создание подрядчика - юридическое лицо.

  POST /realty/web/inspection-api/v1/workers
  Authorization: ReestroAuth apiKey=1269f58a-3d40-42e1-91ad-a4251566419c&portal.orgid=1269f58a-3d40-42e1-91ad-a4251566419c
  Content-Type: application/json

{
  "elementsIds": [
    "6db6066e-537e-11ee-9cf7-fd8814f00a4f",
    "52d4e9f4-549c-11ee-85f5-33cc3b23a326"
  ],
  "notification": {
    "email": "testkontur111@gmail.com",
    "phone": "79129999991"
  },
  "inn": "5902300072",
  "kpp": "590201001"
}

Ответы

201

Тело ответа

Подрядчик успешно создан. В теле ответа содержится описание подрядчика Worker.

Пример ответа

  HTTP 201
  Content-Type: application/json

{
    "id": "63dc8062-54a2-11ee-ab8c-0daeffc5ad4b",
    "externalId": null,
    "organization": {
        "name": "ООО Подрядчик по сантехнике",
        "inn": "5902300072",
        "ogrn": "1025900000048"
    },
    "soleProprietor": null,
    "notification": {
        "email": "testkontur111@gmail.com",
        "phone": "79129999981"
    },
    "elementsIds": [
        "6db6066e-537e-11ee-9cf7-fd8814f00a4f",
        "52d4e9f4-549c-11ee-85f5-33cc3b23a326"
    ]
}

400

Ошибки валидации запроса.

401

Ошибка авторизации: пользователь не авторизован.

403

Ошибка аутентификации: пользователь не имеет доступа к ресурсам организации, которая указана в заголовке авторизации.

415

В заголовке Content-Type указан тип контента, который не поддерживается для данного метода.