Установленное оснащение

Все операции. Авторизация. Запросы и повторы.

Все пути в этом файле дополняют /api/v1 на домене организации.

Описание и ограничения

Назначение

Установленные на оборудовании товары, лицензии, расходные элементы и серийные экземпляры оборудования.

Поля и назначение

Обязательность и null указаны в схемах каждой операции ниже.

Доступ и выборка

equipment_assignments:read/write и текущие права оборудования. Создание требует «ТОиР — Оборудование → Изменение» и чтения выбранного товара; завершение прежнего назначения и повтор его записи об операции требуют только «ТОиР — Оборудование → Изменение». Складские связи читаются только при наличии stocks:read, «Остатки → Просмотр» и доступа к исходному складу; происхождение из акта дополнительно требует acts:read и права этого акта. Эти дополнительные права и разрешения подключения сохраняются в записи об операции, если в ответ попали складские ID, и заново проверяются при повторе и опросе операции.

Правила и связи

• Источник source_key формирует сервер; внешнее приложение не подделывает происхождение из завершённого акта.
• Ручное назначение не списывает склад автоматически и не подменяет товарную строку акта.
• Срок действия и идентификатор сохраняют семантику типа оснащения.

Завершение акта добавляет оснащение типов component, license и certificate из товарных строк с equipment_id. В meta.affected_resources входят созданные или изменённые записи оснащения и версия оборудования. Формируются события equipment_assignment.changed и equipment.updated. Возврат акта в работу снимает созданное им оснащение с признаком удаления и согласует складские изменения. Материалы, которые не учитываются как оснащение, не требуют разрешений equipment_assignments и не создают таких записей.

Для этих эффектов переход требует equipment_assignments:read/write, equipment:read/write, products:read и соответствующие текущие права; для привязки заявки также maintenance_schedules:read. Запись об операции хранит исходные оборудование/товар назначения и клиента/объект оборудования; при повторе проверяются исходный и текущий контекст. Снятое назначение авторизуется по сохранённому происхождению, а не теряет защиту после удаления строки.

Назначение с последующим продлением либо документальной историей нельзя переписать или удалить откатом акта. Возвращается 409 ASSIGNMENT_HISTORY_LOCKED; статус, история, склад и запись об операции остаются без частичных изменений. Ручное завершение действия через /end сохраняет собственный контракт и историю.

Операции

GET /equipment/{id}/assignments

Состав установленного оснащения.

Доступ. Разрешения подключения: equipment_assignments:read. Права сотрудника: «ТОиР — Оборудование → Просмотр». Дополнительно действуют доступ к записям, мастерским, модулям и условия полей из описания ресурса выше.

Параметры

Ответы

Каждый ответ содержит новый X-Request-Id в заголовке. Общие транспортные отказы и правила повтора действуют также при отказе до контроллера; см. ошибки.

Пример запроса

Запускается из каталога комплекта после настройки переменных в быстром старте. Замените демонстрационные идентификаторы 101 и UUID идентификаторами доступных записей. $RESOURCE_VERSION берётся из GET владельца версии, описанного выше. Для нового действия сохраните новый ключ; для повтора используйте прежний.

curl --silent --show-error --globoff \
  "$API/equipment/101/assignments" \
  --header "Authorization: Bearer $SERVICEAPP_TOKEN" \
  --header "Accept: application/json"

POST /equipment/{id}/assignments

Ручное назначение по допустимому источнику.

Доступ. Разрешения подключения: equipment_assignments:write. Права сотрудника: «ТОиР — Оборудование → Изменение». Дополнительно действуют доступ к записям, мастерским, модулям и условия полей из описания ресурса выше.

Параметры

Тело запроса

Content-Type: application/json. Тело обязательно.

Ответы

Каждый ответ содержит новый X-Request-Id в заголовке. Общие транспортные отказы и правила повтора действуют также при отказе до контроллера; см. ошибки.

У принятого POST Location и meta.operation_id указывают на журнал операции; ETag отсутствует. При повторе запроса сохраняются исходные data/meta, добавляется Idempotency-Replayed: true. Версии передавайте по назначению, указанному в описании ресурса.

Пример запроса

Запускается из каталога комплекта после настройки переменных в быстром старте. Замените демонстрационные идентификаторы 101 и UUID идентификаторами доступных записей. $RESOURCE_VERSION берётся из GET владельца версии, описанного выше. Для нового действия сохраните новый ключ; для повтора используйте прежний.

curl --silent --show-error --globoff --request POST \
  "$API/equipment/101/assignments" \
  --header "Authorization: Bearer $SERVICEAPP_TOKEN" \
  --header "Accept: application/json" \
  --header "Idempotency-Key: example:v1-equipment-assignments-store:001" \
  --header "If-Resource-Version: $RESOURCE_VERSION" \
  --header "Content-Type: application/json" \
  --data-binary '@examples/requests/v1.equipment.assignments.store.json'

GET /equipment/{id}/assignments/{assignment}

Одна запись оснащения.

Доступ. Разрешения подключения: equipment_assignments:read. Права сотрудника: «ТОиР — Оборудование → Просмотр». Дополнительно действуют доступ к записям, мастерским, модулям и условия полей из описания ресурса выше.

Параметры

Ответы

Каждый ответ содержит новый X-Request-Id в заголовке. Общие транспортные отказы и правила повтора действуют также при отказе до контроллера; см. ошибки.

Пример запроса

Запускается из каталога комплекта после настройки переменных в быстром старте. Замените демонстрационные идентификаторы 101 и UUID идентификаторами доступных записей. $RESOURCE_VERSION берётся из GET владельца версии, описанного выше. Для нового действия сохраните новый ключ; для повтора используйте прежний.

curl --silent --show-error --globoff \
  "$API/equipment/101/assignments/101" \
  --header "Authorization: Bearer $SERVICEAPP_TOKEN" \
  --header "Accept: application/json"

POST /equipment/{id}/assignments/{assignment}/end

Завершение действия оснащения.

Доступ. Разрешения подключения: equipment_assignments:write. Права сотрудника: «ТОиР — Оборудование → Изменение». Дополнительно действуют доступ к записям, мастерским, модулям и условия полей из описания ресурса выше.

Параметры

Тело запроса

Content-Type: application/json. Тело обязательно.

Тело — пустой JSON-объект {}. Другие ключи не принимаются.

Ответы

Каждый ответ содержит новый X-Request-Id в заголовке. Общие транспортные отказы и правила повтора действуют также при отказе до контроллера; см. ошибки.

У принятого POST Location и meta.operation_id указывают на журнал операции; ETag отсутствует. При повторе запроса сохраняются исходные data/meta, добавляется Idempotency-Replayed: true. Версии передавайте по назначению, указанному в описании ресурса.

Пример запроса

Запускается из каталога комплекта после настройки переменных в быстром старте. Замените демонстрационные идентификаторы 101 и UUID идентификаторами доступных записей. $RESOURCE_VERSION берётся из GET владельца версии, описанного выше. Для нового действия сохраните новый ключ; для повтора используйте прежний.

curl --silent --show-error --globoff --request POST \
  "$API/equipment/101/assignments/101/end" \
  --header "Authorization: Bearer $SERVICEAPP_TOKEN" \
  --header "Accept: application/json" \
  --header "Idempotency-Key: example:v1-equipment-assignments-end:001" \
  --header "If-Resource-Version: $RESOURCE_VERSION" \
  --header "Content-Type: application/json" \
  --data-binary '@examples/requests/v1.equipment.assignments.end.json'