Золотенков
Выпустить ключ

Завести место хранения

POST https://mrp.zolotenkov.ru/api/external/v1/storage-places

Требуемое право ключа: write:inventory.storage_place.create

Создает склад учета. Возвращенный id — тот самый storage_place_id тела POST /stock-adjustments и manufacturing_location_id тела POST /manufacturing-orders.

Первый склад учета становится основным (is_default: true), и у основного склада все три операции разрешены всегда: присланные sales_allowed, manufacturing_allowed и purchase_allowed для него не действуют — это то же правило, что и в интерфейсе. Обязателен Idempotency-Key: повтор с тем же ключом вернет прежний ответ и второго склада не создаст.

Заголовки

  • Idempotency-Key строка обязателен

    Обязателен, до 200 символов. Повтор с тем же ключом возвращает прежний ответ и второго склада не создает. Ответ на повтор помечен заголовком Idempotency-Replayed: true — по коду ответа повтор от первичного вызова не отличается.

Тело запроса

Формат — application/json.

  • address строка необязателен может быть пустым
  • legal_name строка необязателен может быть пустым
  • manufacturing_allowed флаг необязателен может быть пустым

    Разрешить производство. По умолчанию true — именно этот признак подбирает POST /manufacturing-orders.

  • position целое число необязателен может быть пустым

    Порядок в справочнике. По умолчанию 0.

  • purchase_allowed флаг необязателен может быть пустым

    Разрешить приход от поставщика. По умолчанию true.

  • sales_allowed флаг необязателен может быть пустым

    Разрешить отгрузку покупателю. По умолчанию true.

  • title строка обязателен

Ответы

  • 201 Место хранения создано. Повтор с прежним Idempotency-Key отвечает тем же кодом и тем же телом — нового склада не появляется
  • 400 Некорректное тело запроса
  • 401 Ключ не передан, недействителен или отозван
  • 403 У ключа нет права write:inventory.storage_place.create
  • 409 Idempotency-Key повторен с другим телом
  • 429 Превышена частота обращений (rate_limited) либо исчерпан суточный предел документов ключа (document_quota_exceeded). Задержка до повтора — в заголовке Retry-After