{"openapi":"3.1.0","info":{"title":"Публичное API Золотенкова, версия 1","description":"Публичное REST API для интеграций: 1С, Ozon, Wildberries, собственные сервисы и ИИ-агенты. Ключ передается заголовком `Authorization: Bearer zol_pat_live_…`, выпускается в разделе «Настройки → API-ключи».\n\nИдентификаторы в ответах отдаются строкой (`\"id\": \"20411\"`) — ради клиентов, у которых JSON-число читается как `f64` и номер длиннее 2^53 теряет точность. В телах запросов такое поле объявлено как `integer/int64`, но принимает и десятичную запись строкой: значение из ответа подставляется в следующий запрос как есть, приводить тип не нужно.\n\nПовтор записи с прежним `Idempotency-Key` отдает код первичного вызова (у создания — `201`) и помечается заголовком ответа `Idempotency-Replayed: true`. Второго документа при этом не появляется; отличить повтор от первичного вызова можно только по этому заголовку.\n\nПро события: подписка на уведомления (webhook) заводится и снимается ключом — ручки `/webhook-subscriptions`, права `read:webhooks` и `write:webhook.subscription.*`. Сами события описаны разделом `webhooks` этого документа: там перечень типов и состав полезной нагрузки. Проверка подписи и поведение при сбоях доставки — в руководстве `docs/public-api-guide.md`, §8.","license":{"name":""},"version":"1.0.0"},"paths":{"/api/external/v1/batches":{"get":{"tags":["stock"],"summary":"Остатки в разрезе партий","description":"Партии с номером, сроком годности и текущим остатком. Фильтр\n`expires_before` отвечает на вопрос «что просрочится в ближайший месяц», не\nобходя весь склад страницами: `?expires_before=2026-09-30`.\n\nПо умолчанию отдаются только партии с ненулевым остатком — израсходованная\nпартия остатком не является. Полную историю партий, включая расходованные,\nвозвращает `include_depleted=true`.\n\nПартии без срока годности (`expiry_date: null`) не попадают ни в\n`expires_before`, ни в `expires_after`: у них срока нет, и «истекающими»\nони не бывают.","operationId":"list","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}},{"name":"item_id","in":"query","description":"Только партии этого товара — по всем его вариантам","required":false,"schema":{"type":"integer","format":"int64"},"example":15983},{"name":"item_variant_id","in":"query","description":"Только партии этого варианта. Номер варианта возвращает `GET /products` полем `variants[].id`","required":false,"schema":{"type":"integer","format":"int64"},"example":20411},{"name":"batch_number","in":"query","description":"Точный номер партии","required":false,"schema":{"type":"string"},"example":"PO-2026-08-14-001"},{"name":"expires_before","in":"query","description":"Срок годности не позже этой даты. Партии без срока годности в выборку не попадают","required":false,"schema":{"type":"string"},"example":"2026-09-30"},{"name":"expires_after","in":"query","description":"Срок годности не раньше этой даты. Партии без срока годности в выборку не попадают","required":false,"schema":{"type":"string"},"example":"2026-08-23"},{"name":"include_depleted","in":"query","description":"Показать израсходованные партии с нулевым остатком. По умолчанию `false`","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Страница партий с остатками и сроками годности","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchListResponse"}}}},"400":{"description":"Неразбираемое значение фильтра по дате или размера страницы","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:stock`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:stock'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:stock"]}]}},"/api/external/v1/categories":{"get":{"tags":["products"],"summary":"Список категорий каталога","description":"Справочник категорий товаров. Поле `id` каждой записи — тот самый\n`category_id`, который принимает тело `POST /products`; иерархия выражена\nполем `parent_id`.","operationId":"list_categories","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Страница списка категорий","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryListResponse"}}}},"400":{"description":"Недопустимое значение курсора или `limit`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:catalog`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:catalog'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:catalog"]}]}},"/api/external/v1/customers":{"get":{"tags":["sales"],"summary":"Список покупателей","description":"Карточки покупателей постранично, по курсору. Поле `id` каждой записи — тот\nсамый `customer_id`, который требует тело `POST /sales-orders`. Фильтр\n`search` находит контрагента по названию, ИНН или адресу электронной почты,\nне обходя справочник целиком.","operationId":"list","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","description":"Подстрока названия покупателя, его ИНН или адреса электронной почты, без учета регистра. Пустая строка и строка из пробелов фильтром не считаются","required":false,"schema":{"type":"string"},"example":"Ромашка"}],"responses":{"200":{"description":"Страница списка покупателей","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerListResponse"}}}},"400":{"description":"Недопустимое значение фильтра или курсора","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:sales`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:sales'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:sales"]}]},"post":{"tags":["sales"],"summary":"Создать покупателя","description":"Заводит карточку контрагента. Возвращенный `id` — тот самый `customer_id`,\nкоторый требует тело `POST /sales-orders`: до ZOL-11167 узнать его снаружи\nбыло нечем, и на пустом учете заказ покупателя оформить было не на кого.\nОбязателен `Idempotency-Key`: повтор с тем же ключом вернет прежний ответ и\nвторой карточки не создаст.","operationId":"create","parameters":[{"name":"Idempotency-Key","in":"header","description":"Обязателен, до 200 символов. Повтор с тем же ключом возвращает прежний ответ и второй карточки не создает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerCreateRequest"}}},"required":true},"responses":{"201":{"description":"Карточка покупателя создана. Повтор с прежним `Idempotency-Key` отвечает тем же кодом и тем же телом — новой карточки не появляется","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerDto"}}}},"400":{"description":"Некорректное тело запроса","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:sales.customer.create`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:sales.customer.create'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"`Idempotency-Key` повторен с другим телом либо ИНН уже занят другим покупателем этого учета","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений (`rate_limited`) либо исчерпан суточный предел документов ключа (`document_quota_exceeded`). Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:sales.customer.create"]}]}},"/api/external/v1/customers/{id}":{"get":{"tags":["sales"],"summary":"Карточка покупателя","description":"Один покупатель вместе с контактными и юридическими реквизитами.","operationId":"get_one","parameters":[{"name":"id","in":"path","description":"id покупателя","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Карточка покупателя","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerDto"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:sales`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:sales'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого покупателя нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:sales"]}]},"patch":{"tags":["sales"],"summary":"Изменить карточку покупателя","description":"Правит реквизиты уже заведенного контрагента. Присланные поля\nперезаписываются, отсутствующие сохраняют прежнее значение; очистить\nнеобязательный реквизит можно пустой строкой.","operationId":"update","parameters":[{"name":"id","in":"path","description":"id покупателя","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен, до 200 символов. Повтор с тем же ключом возвращает прежний ответ и второй правки не делает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"2b8f1c40-6d3e-4a92-b1f7-0c5a9e2d4813"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Карточка покупателя после правки","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerDto"}}}},"400":{"description":"Некорректное тело запроса","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:sales.customer.update`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:sales.customer.update'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого покупателя нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"`Idempotency-Key` повторен с другим телом либо ИНН уже занят другим покупателем этого учета","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:sales.customer.update"]}]}},"/api/external/v1/manufacturing-orders":{"get":{"tags":["manufacturing"],"summary":"Список производственных заданий","description":"Возвращает задания на производство постранично, по курсору. Фильтры сужают выборку\nпо статусу, типу, изготавливаемому варианту и дате заведения.","operationId":"list","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Статус задания: `NOT_STARTED`, `IN_PROGRESS`, `BLOCKED`, `PARTIALLY_DONE` или `DONE`","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","description":"Под что произведено: `MAKE_TO_STOCK` — на склад, `MAKE_TO_ORDER` — под заказ покупателя","required":false,"schema":{"type":"string"},"example":"MAKE_TO_STOCK"},{"name":"item_variant_id","in":"query","description":"Только задания на изготовление этого варианта изделия","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"created_after","in":"query","description":"Заведенные не раньше даты: `created_date >= значение`. ISO-8601 — дата `2026-08-01` (начало суток UTC) либо момент `2026-08-01T00:00:00Z`","required":false,"schema":{"type":"string"},"example":"2026-08-01"},{"name":"created_before","in":"query","description":"Заведенные раньше даты: `created_date < значение`. ISO-8601 — дата `2026-08-01` (начало суток UTC) либо момент `2026-08-01T00:00:00Z`","required":false,"schema":{"type":"string"},"example":"2026-09-01"}],"responses":{"200":{"description":"Страница списка производственных заданий","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManufacturingOrderListResponse"}}}},"400":{"description":"Недопустимое значение фильтра или курсора","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:manufacturing`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:manufacturing'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:manufacturing"]}]},"post":{"tags":["manufacturing"],"summary":"Создать производственное задание","description":"Заводит задание в статусе `NOT_STARTED`. Материалы при этом не списываются — это\nделает отдельный запуск.","operationId":"create","parameters":[{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ и второго задания не создает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManufacturingOrderCreateRequest"}}},"required":true},"responses":{"201":{"description":"Производственное задание создано, в статусе NOT_STARTED","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManufacturingOrderDetailResponse"}}}},"400":{"description":"Некорректное тело либо ссылка на строку другого клиента","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"Missing scope write:manufacturing.order.create","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:manufacturing.order.create'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Учетный период закрыт, задание завести нельзя (manufacturing_order_transition_not_allowed) либо прислано снятое поле planned_start_date или shipping_date (manufacturing_order_field_removed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:manufacturing.order.create"]}]}},"/api/external/v1/manufacturing-orders/{id}":{"get":{"tags":["manufacturing"],"summary":"Карточка производственного задания","description":"Задание вместе со строками материалов: сколько каждого нужно по спецификации и\nсколько уже списано фактически.","operationId":"get_one","parameters":[{"name":"id","in":"path","description":"id производственного задания","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Задание вместе со строками материалов","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManufacturingOrderDetailResponse"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:manufacturing`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:manufacturing'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого заказа нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:manufacturing"]}]}},"/api/external/v1/manufacturing-orders/{id}/complete":{"post":{"tags":["manufacturing"],"summary":"Завершить производственное задание","description":"Приходует выпуск на склад, один раз доводит расход материалов до факта всего\nзадания (без факта — до плана) и фиксирует себестоимость. Завершение допустимо из\nстатусов `IN_PROGRESS` и `PARTIALLY_DONE`.","operationId":"complete","parameters":[{"name":"id","in":"path","description":"id производственного задания","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ и выпуск второй раз не приходует, а материалы второй раз не списывает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManufacturingOrderTransitionRequest"}}},"required":true},"responses":{"200":{"description":"Задание завершено, выпуск оприходован","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManufacturingOrderDetailResponse"}}}},"400":{"description":"Тело запроса — не JSON-объект","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"Missing scope write:manufacturing.order.complete","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:manufacturing.order.complete'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого задания нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Задание не запущено или уже завершено (manufacturing_order_invalid_status) либо учетный период закрыт","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:manufacturing.order.complete"]}]}},"/api/external/v1/manufacturing-orders/{id}/start":{"post":{"tags":["manufacturing"],"summary":"Запустить производственное задание","description":"Переводит задание в работу. Материалы запуск не списывает, как и у Katana: их\nрасходуют выпуски и завершение. Запуск допустим\nиз статусов `NOT_STARTED` и `BLOCKED`.","operationId":"start","parameters":[{"name":"id","in":"path","description":"id производственного задания","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ и задание второй раз не запускает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManufacturingOrderTransitionRequest"}}},"required":true},"responses":{"200":{"description":"Задание запущено, остатки материалов не изменились","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManufacturingOrderDetailResponse"}}}},"400":{"description":"Тело запроса — не JSON-объект","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"Missing scope write:manufacturing.order.start","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:manufacturing.order.start'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого задания нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Задание уже запущено (manufacturing_order_invalid_status) либо отказал учетный путь (manufacturing_order_transition_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:manufacturing.order.start"]}]}},"/api/external/v1/manufacturing-orders/{id}/tasks":{"get":{"tags":["manufacturing"],"summary":"Операции производственного задания","description":"Операции задания в порядке технологии. По ним видно, на каком этапе стоит работа:\nв самом задании виден только общий итог.","operationId":"list_tasks","parameters":[{"name":"id","in":"path","description":"id производственного задания","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Операции задания в порядке технологии","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManufacturingTaskListResponse"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:manufacturing`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:manufacturing'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого заказа нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:manufacturing"]}]}},"/api/external/v1/operations":{"get":{"tags":["manufacturing"],"summary":"Список производственных операций","description":"Справочник операций, из которых собирается технология изготовления.\n\nРаздел версии 1 — **только чтение**: завести операцию снаружи нельзя, ее\nдобавляет человек в разделе «Производство → Операции».","operationId":"list","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Страница списка производственных операций","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationListResponse"}}}},"400":{"description":"Недопустимое значение курсора или `limit`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:manufacturing`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:manufacturing'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:manufacturing"]}]}},"/api/external/v1/operations/{id}":{"get":{"tags":["manufacturing"],"summary":"Карточка производственной операции","description":"Одна операция справочника вместе с ее стоимостью.","operationId":"get_one","parameters":[{"name":"id","in":"path","description":"id производственной операции","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Карточка производственной операции","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationDto"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:manufacturing`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:manufacturing'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такой операции нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:manufacturing"]}]}},"/api/external/v1/plan/forecast":{"get":{"tags":["plan"],"summary":"Прогноз остатков раздела «План»","description":"Расчетный остаток каждой позиции по периодам горизонта — та же сетка, что\nвидит человек на вкладке «План». Дефицит читается сравнением\n`projected_stock` со `safety_stock`: период, в котором расчетный остаток\nопустился ниже страхового запаса, и есть нехватка. Что по этому поводу\nзаказать, отвечает `GET /api/external/v1/plan/replenishment`.","operationId":"forecast","parameters":[{"name":"limit","in":"query","description":"Сколько строк вернуть: от 1 до 1000, по умолчанию 200","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"scope","in":"query","description":"`all` (по умолчанию), `products` — только изделия, `materials` — только материалы","required":false,"schema":{"type":"string"},"example":"materials"},{"name":"granularity","in":"query","description":"Период сетки: `weekly` (по умолчанию) или `monthly`","required":false,"schema":{"type":"string"},"example":"weekly"},{"name":"horizon","in":"query","description":"Сколько периодов вперед считать: от 1 до 52","required":false,"schema":{"type":"integer","format":"int32"},"example":16},{"name":"storage_place_id","in":"query","description":"Считать по одному месту хранения. Номер отдает `GET /storage-places`","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"category_id","in":"query","description":"Только позиции этой категории","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"search","in":"query","description":"Подстрока названия или артикула, без учета регистра","required":false,"schema":{"type":"string"},"example":"хлопок"},{"name":"forecast_demand","in":"query","description":"Учитывать статистический прогноз спроса по истории отгрузок. По умолчанию `true`; `false` оставляет только подтвержденные документы","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Прогноз остатков по периодам","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanForecastResponse"}}}},"400":{"description":"Недопустимое значение параметра выборки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:plan`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:plan'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:plan"]}]}},"/api/external/v1/plan/replenishment":{"get":{"tags":["plan"],"summary":"Дефициты и рекомендации к пополнению","description":"Перечень позиций, которых не хватит в горизонте планирования, и что по\nкаждой сделать: заказать поставщику (`buy`), выпустить (`make`) или\nпереместить с другого склада (`transfer`). Тот же расчет, что показывает\nвкладка «Пополнение» раздела «План»: интегратору не нужно считать дефицит\nзаново по остаткам и заказам.\n\nПозиция, у которой хватает всего, строкой не приходит. Строка с\n`recommended_qty` равным нулю — дефицит, уже покрытый открытым заказом;\nзаказывать по ней ничего не надо, но и исчезать она не должна.","operationId":"replenishment","parameters":[{"name":"limit","in":"query","description":"Сколько строк вернуть: от 1 до 1000, по умолчанию 200","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"scope","in":"query","description":"`all` (по умолчанию), `products` — только изделия, `materials` — только материалы","required":false,"schema":{"type":"string"},"example":"materials"},{"name":"horizon","in":"query","description":"Сколько недель вперед считать: от 1 до 52","required":false,"schema":{"type":"integer","format":"int32"},"example":16},{"name":"storage_place_id","in":"query","description":"Только дефициты этого места хранения","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"category_id","in":"query","description":"Только позиции этой категории","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"search","in":"query","description":"Подстрока названия или артикула, без учета регистра","required":false,"schema":{"type":"string"},"example":"хлопок"},{"name":"supplier_search","in":"query","description":"Подстрока названия поставщика: чем заказать у одного контрагента одной поставкой","required":false,"schema":{"type":"string"},"example":"ткани"},{"name":"forecast_demand","in":"query","description":"Учитывать статистический прогноз спроса по истории отгрузок. По умолчанию `true`","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Дефициты и рекомендации к пополнению","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanReplenishmentResponse"}}}},"400":{"description":"Недопустимое значение параметра выборки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:plan`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:plan'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:plan"]}]}},"/api/external/v1/products":{"get":{"tags":["products"],"summary":"Список товаров","description":"Карточки товаров вместе с вариантами, постранично, по курсору. Фильтр\n`updated_after` позволяет забирать только изменения, а не всю номенклатуру\nцеликом, а `search` — найти товар по названию или артикулу, не обходя каталог.","operationId":"list","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}},{"name":"updated_after","in":"query","description":"Только измененные не раньше даты: `updated_at >= значение`. Так забирают изменения порциями. ISO-8601 — дата `2026-08-01` (начало суток UTC) либо момент `2026-08-01T00:00:00Z`","required":false,"schema":{"type":"string"},"example":"2026-08-01T00:00:00Z"},{"name":"search","in":"query","description":"Подстрока названия товара или артикула любого его варианта, без учета регистра. Пустая строка и строка из пробелов фильтром не считаются","required":false,"schema":{"type":"string"},"example":"сахар"}],"responses":{"200":{"description":"Страница списка товаров","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductListResponse"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:catalog`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:catalog'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:catalog"]}]},"post":{"tags":["products"],"summary":"Создать товар","description":"Заводит карточку товара вместе с вариантами. Обязателен `Idempotency-Key`: повтор\nс тем же ключом вернет прежний ответ и второй карточки не создаст.","operationId":"create","parameters":[{"name":"Idempotency-Key","in":"header","description":"Обязателен, до 200 символов. Повтор с тем же ключом возвращает прежний ответ и второй карточки не создает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductCreateRequest"}}},"required":true},"responses":{"201":{"description":"Карточка товара создана","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDto"}}}},"400":{"description":"Некорректное тело запроса","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"402":{"description":"Исчерпан лимит артикулов тарифа Free (`SUBSCRIPTION_LIMIT`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"SUBSCRIPTION_LIMIT","message":"Достигнут предел каталога бесплатного тарифа","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:catalog.product.create`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:catalog.product.create'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"`Idempotency-Key` повторен с другим телом запроса","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений (`rate_limited`) либо исчерпан суточный предел документов ключа (`document_quota_exceeded`). Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:catalog.product.create"]}]}},"/api/external/v1/products/batch":{"post":{"tags":["products"],"summary":"Завести партию товаров","description":"Заводит до 200 карточек одним запросом и расходует одну единицу строгой\nквоты записи вместо одной на карточку. Отказ построчный: `results[i]`\nговорит про строку `items[i]`, и одна отклоненная строка не отменяет\nзаведенные. Обязателен `Idempotency-Key`: повтор с тем же ключом и тем же\nтелом возвращает прежний ответ и второй партии не создает.","operationId":"create_batch","parameters":[{"name":"Idempotency-Key","in":"header","description":"Обязателен, до 200 символов. Повтор с тем же ключом и тем же телом возвращает прежний ответ и вторых карточек не создает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true`.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductBatchCreateRequest"}}},"required":true},"responses":{"200":{"description":"Партия разобрана. Исход каждой строки — в `results`; код ответа говорит только о том, что запрос принят и разобран, а не о том, что легли все строки","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: партия уже была выполнена прежним вызовом с тем же `Idempotency-Key`, второй раз она не выполнялась"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductBatchResponse"}}}},"400":{"description":"Некорректное тело запроса, пустой либо слишком длинный `items`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"402":{"description":"15 дней без ограничения закончились: пакет, который дал бы больше 30 артикулов, отклонен целиком (`SUBSCRIPTION_LIMIT`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"SUBSCRIPTION_LIMIT","message":"Достигнут предел каталога бесплатного тарифа","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:catalog.product.create`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:catalog.product.create'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"`Idempotency-Key` повторен с другим телом запроса","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений (`rate_limited`). Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:catalog.product.create"]}]}},"/api/external/v1/products/{id}":{"patch":{"tags":["products"],"summary":"Изменить товар","description":"Меняет только переданные поля карточки. Непереданные остаются прежними.","operationId":"update","parameters":[{"name":"id","in":"path","description":"id товара","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Карточка изменена","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDto"}}}},"400":{"description":"Некорректное тело либо ссылка на строку другого клиента","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:catalog.product.update`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:catalog.product.update'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого товара нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:catalog.product.update"]}]}},"/api/external/v1/purchase-orders":{"get":{"tags":["purchasing"],"summary":"Список заказов поставщикам","description":"Заказы поставщикам постранично, по курсору, с фильтрами по статусу, состоянию\nприемки, поставщику и дате.","operationId":"list","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Статус заказа: `OPEN` — открыт, `DONE` — закрыт, `DRAFT` — черновик. Без фильтра черновики не отдаются","required":false,"schema":{"type":"string"}},{"name":"delivery_status","in":"query","description":"Состояние приемки: `NOT_RECEIVED`, `PARTIALLY_RECEIVED` или `RECEIVED`","required":false,"schema":{"type":"string"},"example":"NOT_RECEIVED"},{"name":"supplier_id","in":"query","description":"Только заказы этому поставщику","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"created_after","in":"query","description":"Заведенные не раньше даты: `date >= значение`. ISO-8601 — дата `2026-08-01` (начало суток UTC) либо момент `2026-08-01T00:00:00Z`","required":false,"schema":{"type":"string"},"example":"2026-08-01"},{"name":"created_before","in":"query","description":"Заведенные раньше даты: `date < значение`. ISO-8601 — дата `2026-08-01` (начало суток UTC) либо момент `2026-08-01T00:00:00Z`","required":false,"schema":{"type":"string"},"example":"2026-09-01"}],"responses":{"200":{"description":"Страница списка заказов поставщикам","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseOrderListResponse"}}}},"400":{"description":"Недопустимое значение фильтра или курсора","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:purchase`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:purchase'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:purchase"]}]},"post":{"tags":["purchasing"],"summary":"Создать заказ поставщику","description":"Заводит заказ поставщику вместе со строками. Остаток при этом не двигается —\nего меняет оформление прихода.","operationId":"create","parameters":[{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ и второго заказа не создает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseOrderCreateRequest"}}},"required":true},"responses":{"201":{"description":"Заказ поставщику создан","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseOrderDetailResponse"}}}},"400":{"description":"Некорректное тело либо ссылка на строку другого клиента","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:purchase.order.create`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:purchase.order.create'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Номер закупки уже занят (document_number_taken) либо Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Учетный период закрыт","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:purchase.order.create"]}]}},"/api/external/v1/purchase-orders/{id}":{"get":{"tags":["purchasing"],"summary":"Карточка заказа поставщику","description":"Заказ вместе со строками: что, сколько и по какой цене заказано.","operationId":"get_one","parameters":[{"name":"id","in":"path","description":"id заказа поставщику","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Заказ поставщику вместе со строками","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseOrderDetailResponse"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:purchase`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:purchase'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого заказа нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:purchase"]}]}},"/api/external/v1/purchase-orders/{id}/receipts":{"get":{"tags":["purchasing"],"summary":"Приходы по заказу поставщику","description":"События приемки по заказу, новые сверху: что и когда фактически получено.","operationId":"list_receipts","parameters":[{"name":"id","in":"path","description":"id заказа поставщику","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Приходы по заказу, новые сверху","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseOrderReceiptListResponse"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:purchase`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:purchase'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого заказа нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:purchase"]}]},"post":{"tags":["purchasing"],"summary":"Оформить приход по заказу поставщику","description":"Приходует полученное на склад и увеличивает остаток. Обязателен `Idempotency-Key`:\nповтор с тем же ключом материал второй раз не приходует.","operationId":"create_receipt","parameters":[{"name":"id","in":"path","description":"id заказа поставщику","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ и материал второй раз не приходует. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseReceiptCreateRequest"}}},"required":true},"responses":{"201":{"description":"Приход оформлен","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseReceiptCreatedResponse"}}}},"400":{"description":"Некорректное тело либо ссылка на склад другого клиента","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:purchase.receipt.create`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:purchase.receipt.create'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого заказа нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Приход недопустим (purchase_receipt_not_allowed) либо Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:purchase.receipt.create"]}]}},"/api/external/v1/recipes":{"get":{"tags":["manufacturing"],"summary":"Список спецификаций","description":"Спецификации изделий: из чего и какими операциями изготавливается каждый вариант.\n\nРаздел версии 1 — **только чтение**. Завести спецификацию товару, созданному\nчерез API, снаружи нельзя ни здесь, ни в `/operations`: состав и нормы\nвремени заводит человек в разделе «Производство → Спецификации». Поэтому у\nзадания на такой товар список материалов будет пуст, пока спецификацию не\nзаполнят в интерфейсе. Это ограничение версии 1, а не недосмотр.","operationId":"list","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}},{"name":"item_id","in":"query","description":"Только спецификации этого изделия","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"item_variant_id","in":"query","description":"Только спецификации этого варианта изделия","required":false,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Страница списка спецификаций","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecipeListResponse"}}}},"400":{"description":"Недопустимое значение курсора или `limit`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:manufacturing`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:manufacturing'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:manufacturing"]}]}},"/api/external/v1/recipes/{id}":{"get":{"tags":["manufacturing"],"summary":"Карточка спецификации","description":"Спецификация вместе с материалами и операциями изготовления.","operationId":"get_one","parameters":[{"name":"id","in":"path","description":"id спецификации","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Спецификация вместе с материалами и операциями","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecipeDto"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:manufacturing`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:manufacturing'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такой спецификации нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:manufacturing"]}]}},"/api/external/v1/reports/production-summary":{"get":{"tags":["reports"],"summary":"Выпуск за период","description":"Один запрос вместо постраничной вычитки производственных заказов: сколько\nвыпущено, во сколько это обошлось и сколько это заняло, сложенное по товару\nи по периоду. В срез попадают завершенные заказы по дате завершения.\n\nЧисла совпадают с разделом «Аналитика - Производство - Обзор затрат» того же\nтенанта за тот же период.\n\nРучка отнесена к дорогим операциям: она обходит все заказы периода вместе с\nих материалами и операциями. У обхода есть предел времени: срез, не\nуложившийся в него, отвечает `400` с просьбой сузить выборку.\n\nПраво `read:manufacturing` вместе с этой ручкой отдает наружу себестоимость\nвыпуска (`materials_cost`, `unit_cost`).","operationId":"production_summary","parameters":[{"name":"from","in":"query","description":"Первый день периода, календарная дата `2026-01-01`, зона Europe/Moscow","required":true,"schema":{"type":"string"},"example":"2026-01-01"},{"name":"to","in":"query","description":"Последний день периода, включительно. Период не длиннее 366 суток, считая обе границы","required":true,"schema":{"type":"string"},"example":"2026-12-31"},{"name":"group_by","in":"query","description":"Нарезка периода: `month` (по умолчанию), `week`, `day` или `total` — весь период одной строкой на товар","required":false,"schema":{"type":"string"},"example":"month"},{"name":"manufacturing_location_id","in":"query","description":"Только заказы этой производственной площадки","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"item_id","in":"query","description":"Только этот товар, со всеми его вариантами","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"category_id","in":"query","description":"Только товары этой категории","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"order_type","in":"query","description":"Тип производственного заказа, как он отдается в `GET /manufacturing-orders`","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Сколько строк вернуть: от 1 до 1000, по умолчанию 200","required":false,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Срез выпуска за период","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductionSummaryResponse"}}}},"400":{"description":"Недопустимое значение параметра выборки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:manufacturing`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:manufacturing'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:manufacturing"]}]}},"/api/external/v1/reports/sales-summary":{"get":{"tags":["reports"],"summary":"Продажи за период","description":"Один запрос вместо постраничной вычитки всех отгрузок: выручка,\nсебестоимость, прибыль и количество, сложенные по товару и по периоду.\nПродажа попадает в период по дате отгрузки, проведенный возврат — по дате\nвозврата и со знаком минус, поэтому `revenue` уже очищена от возвратов.\n\nЧисла совпадают с разделом «Аналитика - Продажи» того же тенанта за тот же\nпериод: срез считается по тому же потоку операций, а не пересчитывается\nотдельно.\n\nРучка отнесена к дорогим операциям: она обходит все документы периода, и ее\nчастотный предел строже, чем у списков. У обхода есть предел времени: срез,\nне уложившийся в него, отвечает `400` с просьбой сузить выборку.\n\nПраво `read:sales` вместе с этой ручкой отдает наружу себестоимость (`cogs`)\nи маржу (`profit`).","operationId":"sales_summary","parameters":[{"name":"from","in":"query","description":"Первый день периода, календарная дата `2026-01-01`, зона Europe/Moscow","required":true,"schema":{"type":"string"},"example":"2026-01-01"},{"name":"to","in":"query","description":"Последний день периода, включительно. Период не длиннее 366 суток, считая обе границы","required":true,"schema":{"type":"string"},"example":"2026-12-31"},{"name":"group_by","in":"query","description":"Нарезка периода: `month` (по умолчанию), `week`, `day` или `total` — весь период одной строкой на товар","required":false,"schema":{"type":"string"},"example":"month"},{"name":"storage_place_id","in":"query","description":"Отгрузки с этого места хранения и возвраты без исходного заказа, принятые на него. Номер отдает `GET /storage-places`","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"item_id","in":"query","description":"Только этот товар, со всеми его вариантами","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"category_id","in":"query","description":"Только товары этой категории","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"country_code","in":"query","description":"Страны заказа через запятую, ISO-3166-1 alpha-2, не больше 50 кодов","required":false,"schema":{"type":"string"},"example":"RU,BY,KZ"},{"name":"limit","in":"query","description":"Сколько строк вернуть: от 1 до 1000, по умолчанию 200","required":false,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Срез продаж за период","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesSummaryResponse"}}}},"400":{"description":"Недопустимое значение параметра выборки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:sales`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:sales'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:sales"]}]}},"/api/external/v1/sales-orders":{"get":{"tags":["sales"],"summary":"Список заказов покупателей","description":"Заказы покупателей постранично, по курсору, с фильтрами по статусу, состоянию\nотгрузки, покупателю и дате.","operationId":"list","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Статус заказа: `OPEN` — открыт, `DONE` — выполнен","required":false,"schema":{"type":"string"}},{"name":"delivery_status","in":"query","description":"Состояние отгрузки: `NOT_SHIPPED`, `PACKED`, `PARTIALLY_PACKED`, `PARTIALLY_SHIPPED` или `SHIPPED`","required":false,"schema":{"type":"string"},"example":"NOT_SHIPPED"},{"name":"customer_id","in":"query","description":"Только заказы этого покупателя","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"created_after","in":"query","description":"Заведенные не раньше даты: `created_date >= значение`. ISO-8601 — дата `2026-08-01` (начало суток UTC) либо момент `2026-08-01T00:00:00Z`","required":false,"schema":{"type":"string"},"example":"2026-08-01"},{"name":"created_before","in":"query","description":"Заведенные раньше даты: `created_date < значение`. ISO-8601 — дата `2026-08-01` (начало суток UTC) либо момент `2026-08-01T00:00:00Z`","required":false,"schema":{"type":"string"},"example":"2026-09-01"}],"responses":{"200":{"description":"Страница списка заказов покупателей","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesOrderListResponse"}}}},"400":{"description":"Недопустимое значение фильтра или курсора","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:sales`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:sales'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:sales"]}]},"post":{"tags":["sales"],"summary":"Создать заказ покупателя","description":"Заводит заказ покупателя вместе со строками. Обязателен `Idempotency-Key`: повтор\nс тем же ключом вернет прежний ответ и второго заказа не создаст.","operationId":"create","parameters":[{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ и второго заказа не создает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesOrderCreateRequest"}}},"required":true},"responses":{"201":{"description":"Заказ создан","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesOrderDetailResponse"}}}},"400":{"description":"Некорректное тело либо ссылка на строку другого клиента","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:sales.order.create`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:sales.order.create'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"Покупатель не найден","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Номер заказа уже занят (document_number_taken) либо Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Дата документа попадает в закрытый учетный период (inventory_period_closed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:sales.order.create"]}]}},"/api/external/v1/sales-orders/{id}":{"get":{"tags":["sales"],"summary":"Карточка заказа покупателя","description":"Заказ вместе со строками и данными покупателя.","operationId":"get_one","parameters":[{"name":"id","in":"path","description":"id заказа покупателя","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Заказ покупателя вместе со строками","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesOrderDetailResponse"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:sales`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:sales'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого заказа нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:sales"]}]},"patch":{"tags":["sales"],"summary":"Изменить заказ покупателя","description":"Меняет только переданные поля заказа. Завершенный заказ изменению не подлежит.","operationId":"update","parameters":[{"name":"id","in":"path","description":"id заказа покупателя","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesOrderUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Заказ изменен","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesOrderDetailResponse"}}}},"400":{"description":"Некорректное тело либо ссылка на строку другого клиента","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:sales.order.update`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:sales.order.update'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого заказа или покупателя нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Заказ уже завершен (sales_order_not_editable) либо Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Правка задевает строку, отгруженную в закрытом учетном периоде: ее нельзя удалить, заменить в ней товар, изменить цену или НДС, а количество — сделать меньше отгруженного там (inventory_period_closed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:sales.order.update"]}]}},"/api/external/v1/sales-orders/{id}/complete":{"post":{"tags":["sales"],"summary":"Отгрузить остаток и закрыть заказ покупателя","description":"Отгружает все упаковки заказа без нового списания, а еще не исполненное\nколичество отгружает со списанием со склада, и переводит заказ в `DONE`.\nУпакованное и уже отгруженное вторично не списывается. Тело\nзапроса пустое: что и сколько отгружать, ручка берет из самих строк заказа,\nи передать ей нечего.","operationId":"complete","parameters":[{"name":"id","in":"path","description":"id заказа покупателя","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ и второй раз товар не списывает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesOrderCompleteRequest"}}},"required":true},"responses":{"200":{"description":"Остаток отгружен, заказ закрыт в статусе DONE","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesOrderDetailResponse"}}}},"400":{"description":"Тело запроса — не JSON-объект","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:sales.order.complete`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:sales.order.complete'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого заказа нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Заказ уже закрыт (sales_order_invalid_status); не хватает товара на складе либо для серийной строки не назначены номера (sales_order_shipment_not_allowed); день отгрузки попадает в закрытый учетный период (inventory_period_closed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:sales.order.complete"]}]}},"/api/external/v1/sales-orders/{id}/ship":{"post":{"tags":["sales"],"summary":"Отгрузить позиции заказа покупателя","description":"Упаковывает или отгружает строки заказа. `PACKED` создает упаковку и сразу списывает\nтовар со склада. `DELIVERED` с `fulfillment_id` отгружает эту упаковку без нового\nсписания; без `fulfillment_id` отгружает еще не исполненное количество строк и\nсписывает его. Если строки запроса уже упакованы и запрос не совпадает ровно с одной\nупаковкой по строкам и количеству, ответ `409 sales_order_fulfillment_ambiguous` с\nперечнем упаковок в `details`. Когда отгружены все строки, заказ закрывается сам.","operationId":"ship","parameters":[{"name":"id","in":"path","description":"id заказа покупателя","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ и второй раз товар не списывает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesOrderShipRequest"}}},"required":true},"responses":{"200":{"description":"Событие отгрузки записано; в ответе — заказ с новым `delivery_status`","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesOrderDetailResponse"}}}},"400":{"description":"Некорректное тело запроса","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:sales.order.ship`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:sales.order.ship'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого заказа нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Idempotency-Key повторен с другим телом; отгрузка без `fulfillment_id` попала на упакованное и не совпала ровно с одной упаковкой, в `details` перечень упаковок (sales_order_fulfillment_ambiguous); упаковку уже отгрузила или сняла другая команда (sales_order_fulfillment_state_changed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Заказ уже закрыт (sales_order_invalid_status); количество больше неотгруженного остатка, строка не из этого заказа, не хватает товара на складе либо для серийной строки не переданы номера (sales_order_shipment_not_allowed); день отгрузки попадает в закрытый учетный период (inventory_period_closed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:sales.order.ship"]}]}},"/api/external/v1/sales-return-reasons":{"get":{"tags":["sales"],"summary":"Справочник причин возврата","description":"Системный список причин, из которого выбирается `items[].reason_id`.\nСостав общий для всех учетов: свои значения тенант не добавляет, иначе\nразрез «за что возвращают» перестал бы быть сравнимым. Ручек изменения\nсправочника наружу нет.","operationId":"list_reasons","responses":{"200":{"description":"Действующие значения справочника причин возврата","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesReturnReasonListResponse"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:sales`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:sales'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:sales"]}]}},"/api/external/v1/sales-returns":{"get":{"tags":["sales"],"summary":"Список возвратов покупателей","description":"Возвраты покупателей постранично, по курсору, с фильтрами по статусу,\nисходному заказу и дате документа.","operationId":"list","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Статус возврата: `NOT_RETURNED`, `PARTIALLY_RETURNED`, `RETURNED` или `CANCELLED`","required":false,"schema":{"type":"string"},"example":"RETURNED"},{"name":"sales_order_id","in":"query","description":"Только возвраты по этому заказу покупателя","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"created_after","in":"query","description":"Оформленные не раньше даты: `created_date >= значение`. ISO-8601 — дата `2026-08-01` (начало суток UTC) либо момент `2026-08-01T00:00:00Z`","required":false,"schema":{"type":"string"},"example":"2026-08-01"},{"name":"created_before","in":"query","description":"Оформленные раньше даты: `created_date < значение`. ISO-8601 — дата `2026-08-01` (начало суток UTC) либо момент `2026-08-01T00:00:00Z`","required":false,"schema":{"type":"string"},"example":"2026-09-01"}],"responses":{"200":{"description":"Страница списка возвратов покупателей","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesReturnListResponse"}}}},"400":{"description":"Недопустимое значение фильтра или курсора","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:sales`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:sales'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:sales"]}]},"post":{"tags":["sales"],"summary":"Оформить возврат покупателя","description":"Заводит документ возврата вместе со строками. Остаток при этом не двигается:\nтовар еще едет назад. На склад его принимает отдельный вызов приемки.","operationId":"create","parameters":[{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ и второго документа не создает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesReturnCreateRequest"}}},"required":true},"responses":{"201":{"description":"Возврат оформлен в статусе NOT_RETURNED","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesReturnDetailResponse"}}}},"400":{"description":"Некорректное тело, ссылка на строку другого клиента либо строка не из указанного заказа","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:sales.return.create`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:sales.return.create'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Номер возврата уже занят (document_number_taken) либо Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Учетный период закрыт","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:sales.return.create"]}]}},"/api/external/v1/sales-returns/{id}":{"get":{"tags":["sales"],"summary":"Карточка возврата покупателя","description":"Возврат вместе со строками: что, сколько и по какой цене принято назад.","operationId":"get_one","parameters":[{"name":"id","in":"path","description":"id возврата покупателя","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Возврат вместе со строками","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesReturnDetailResponse"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:sales`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:sales'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого возврата нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:sales"]}]}},"/api/external/v1/sales-returns/{id}/receive":{"post":{"tags":["sales"],"summary":"Принять возврат покупателя","description":"Переводит возврат в `RETURNED` — то же, что кнопка «Возвращен». С ZOL-16553\nсклад не меняется: приход делает только `restock`. Обязателен\n`Idempotency-Key`.\nТело запроса пустое — что и сколько принимать, ручка берет из строк самого\nдокумента.","operationId":"receive","parameters":[{"name":"id","in":"path","description":"id возврата покупателя","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ и товар второй раз не приходует. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesReturnReceiveRequest"}}},"required":true},"responses":{"200":{"description":"Возврат принят, статус RETURNED, остаток не менялся","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesReturnDetailResponse"}}}},"400":{"description":"Тело запроса — не JSON-объект","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:sales.return.receive`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:sales.return.receive'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого возврата нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Возврат уже принят, оприходован или отменен (sales_return_invalid_status); в документе нет строк (sales_return_receive_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:sales.return.receive"]}]}},"/api/external/v1/sales-returns/{id}/restock":{"post":{"tags":["sales"],"summary":"Оприходовать возврат покупателя на склад","description":"Переводит возврат из `RETURNED` в `RESTOCKED` и приходует строки на их\nместо оприходования (из строки, иначе из шапки) — остаток растет. Повтор по\nуже оприходованному возврату отвечает `200` без изменений. Обязателен\n`Idempotency-Key`. Тело пустое.","operationId":"restock","parameters":[{"name":"id","in":"path","description":"id возврата покупателя","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ и товар второй раз не приходует. Ответ на повтор помечен заголовком `Idempotency-Replayed: true`.","required":true,"schema":{"type":"string"},"example":"0d4b7e21-5c3a-4f19-8e62-7a1c9b3d5e40"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesReturnReceiveRequest"}}},"required":true},"responses":{"200":{"description":"Возврат оприходован, статус RESTOCKED; либо был оприходован раньше","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов, действие второй раз не выполнялось"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesReturnDetailResponse"}}}},"400":{"description":"Тело запроса — не JSON-объект","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:sales.return.receive`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:sales.return.receive'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого возврата нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Возврат еще не принят или отменен (sales_return_invalid_status); не указано место оприходования (sales_return_receive_not_allowed); учетный период закрыт","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:sales.return.receive"]}]}},"/api/external/v1/sales-returns/{id}/unrestock":{"post":{"tags":["sales"],"summary":"Откатить оприходование возврата покупателя","description":"Переводит возврат из `RESTOCKED` обратно в `RETURNED` и сторнирует приход —\nто же, что «Откатить» в карточке возврата. Повтор по возврату в `RETURNED`\nотвечает `200` без изменений. Обязателен `Idempotency-Key`. Тело пустое.","operationId":"unrestock","parameters":[{"name":"id","in":"path","description":"id возврата покупателя","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ и приход второй раз не сторнирует. Ответ на повтор помечен заголовком `Idempotency-Replayed: true`.","required":true,"schema":{"type":"string"},"example":"3e8a1f40-7b2c-4d95-a613-9f0c2b4d6e71"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesReturnReceiveRequest"}}},"required":true},"responses":{"200":{"description":"Оприходование откачено, статус RETURNED; либо возврат уже был в RETURNED","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов, действие второй раз не выполнялось"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalesReturnDetailResponse"}}}},"400":{"description":"Тело запроса — не JSON-объект","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:sales.return.receive`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:sales.return.receive'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого возврата нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Возврат не принят или отменен (sales_return_invalid_status); учетный период закрыт","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:sales.return.receive"]}]}},"/api/external/v1/security/telemetry":{"get":{"tags":["security"],"summary":"Телеметрия безопасности за сутки","description":"Обезличенные счетчики регистраций и восстановления пароля за окно ровно в 24 часа\nвместе с базовой линией за предыдущие 7 дней.","operationId":"get_telemetry","parameters":[{"name":"windowStart","in":"query","description":"Начало окна в формате RFC3339, включительно","required":true,"schema":{"type":"string"},"example":"2026-08-01T00:00:00Z"},{"name":"windowEnd","in":"query","description":"Конец окна в формате RFC3339, не включая его. Ровно на 24 часа позже `windowStart`","required":true,"schema":{"type":"string"},"example":"2026-08-02T00:00:00Z"}],"responses":{"200":{"description":"Обезличенные счетчики за сутки вместе с базовой линией за 7 дней","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecurityTelemetryResponseDto"}}}},"400":{"description":"Окно не передано, задано неверно или не равно 24 часам","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:security-telemetry`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:security-telemetry'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:security-telemetry"]}]}},"/api/external/v1/stock":{"get":{"tags":["stock"],"summary":"Остатки по местам хранения","description":"Остаток каждого варианта изделия в разрезе мест хранения. Фильтры `item_id`\nи `item_variant_id` отвечают на вопрос «сколько этого товара на складе», не\nобходя весь список страницами.\n\nОтвечать клиенту надо по `available`, а не по `amount`: `amount` — это все,\nчто лежит физически, включая обещанное другим заказам (`committed`).\n`available` — сколько еще можно обещать.","operationId":"list","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}},{"name":"item_id","in":"query","description":"Только остатки этого товара — по всем его вариантам","required":false,"schema":{"type":"integer","format":"int64"},"example":15983},{"name":"item_variant_id","in":"query","description":"Только остатки этого варианта. Номер варианта возвращает `GET /products` полем `variants[].id`","required":false,"schema":{"type":"integer","format":"int64"},"example":20411}],"responses":{"200":{"description":"Страница остатков по местам хранения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockListResponse"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:stock`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:stock'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:stock"]}]}},"/api/external/v1/stock-adjustments":{"post":{"tags":["stock"],"summary":"Оформить корректировку остатка","description":"Приводит остаток к фактическому и записывает движение с причиной. Обязателен\n`Idempotency-Key`: повтор с тем же ключом остаток второй раз не двигает.","operationId":"create","parameters":[{"name":"Idempotency-Key","in":"header","description":"Обязателен. Повтор с тем же ключом возвращает прежний ответ и остаток второй раз не двигает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockAdjustmentCreateRequest"}}},"required":true},"responses":{"201":{"description":"Корректировка оформлена","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockAdjustmentCreatedResponse"}}}},"400":{"description":"Некорректное тело, ссылка на строку другого клиента либо уход остатка в минус","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:inventory.adjustment.create`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:inventory.adjustment.create'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"Idempotency-Key повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Дата документа в закрытом учетном периоде или в будущем либо смешанные склады в строках","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:inventory.adjustment.create"]}]}},"/api/external/v1/stock-movements":{"get":{"tags":["stock"],"summary":"Движения остатка","description":"История движений остатка с фильтрами по изделию, месту хранения, виду документа\nи дате.","operationId":"list","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}},{"name":"item_id","in":"query","description":"Только движения этого изделия","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"item_variant_id","in":"query","description":"Только движения этого варианта изделия","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"storage_place_id","in":"query","description":"Только движения по этому месту хранения","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"entity_type","in":"query","description":"Каким документом вызвано движение","required":false,"schema":{"type":"string","enum":["STOCK_ADJUSTMENT","PURCHASE_ORDER","PURCHASE_ORDER_RECEIPT","SHIPMENT","MANUFACTURING_ORDER","SALES_RETURN"]}},{"name":"date_from","in":"query","description":"Движения не раньше даты: `date >= значение`. ISO-8601 — дата `2026-08-01` (начало суток UTC) либо момент `2026-08-01T00:00:00Z`","required":false,"schema":{"type":"string"},"example":"2026-08-01"},{"name":"date_to","in":"query","description":"Движения раньше даты: `date < значение`. ISO-8601 — дата `2026-08-01` (начало суток UTC) либо момент `2026-08-01T00:00:00Z`","required":false,"schema":{"type":"string"},"example":"2026-09-01"}],"responses":{"200":{"description":"Страница списка движений остатка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockMovementListResponse"}}}},"400":{"description":"Недопустимое значение фильтра или курсора","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:stock`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:stock'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:stock"]}]}},"/api/external/v1/storage-places":{"get":{"tags":["stock"],"summary":"Список мест хранения","description":"Склады учета с признаками разрешенных на них операций. Склад с\n`manufacturing_allowed = true` годится в `manufacturing_location_id` тела\n`POST /manufacturing-orders`.\n\nПустой список означает, что складов в учете нет вовсе. Это штатное\nсостояние свежего учета: остатки в нем лежат без места хранения\n(`storage_place_id: null`), неявного склада с собственным id не существует,\nи производственное задание в таком учете отвечает `422`. Первый склад\nзаводится `POST /storage-places` и автоматически становится основным.","operationId":"list","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Страница списка мест хранения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoragePlaceListResponse"}}}},"400":{"description":"Недопустимое значение курсора или `limit`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:stock`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:stock'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:stock"]}]},"post":{"tags":["stock"],"summary":"Завести место хранения","description":"Создает склад учета. Возвращенный `id` — тот самый `storage_place_id` тела\n`POST /stock-adjustments` и `manufacturing_location_id` тела\n`POST /manufacturing-orders`.\n\nПервый склад учета становится основным (`is_default: true`), и у основного\nсклада все три операции разрешены всегда: присланные `sales_allowed`,\n`manufacturing_allowed` и `purchase_allowed` для него не действуют — это то\nже правило, что и в интерфейсе. Обязателен `Idempotency-Key`: повтор с тем\nже ключом вернет прежний ответ и второго склада не создаст.","operationId":"create","parameters":[{"name":"Idempotency-Key","in":"header","description":"Обязателен, до 200 символов. Повтор с тем же ключом возвращает прежний ответ и второго склада не создает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"3a91c7de-15b0-4a6f-9f2c-8d4e0b17aa93"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoragePlaceCreateRequest"}}},"required":true},"responses":{"201":{"description":"Место хранения создано. Повтор с прежним `Idempotency-Key` отвечает тем же кодом и тем же телом — нового склада не появляется","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoragePlaceDto"}}}},"400":{"description":"Некорректное тело запроса","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:inventory.storage_place.create`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:inventory.storage_place.create'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"`Idempotency-Key` повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений (`rate_limited`) либо исчерпан суточный предел документов ключа (`document_quota_exceeded`). Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:inventory.storage_place.create"]}]}},"/api/external/v1/suppliers":{"get":{"tags":["purchasing"],"summary":"Список поставщиков","description":"Карточки поставщиков постранично, по курсору. Поле `id` каждой записи — тот\nсамый `supplier_id`, который требует тело `POST /purchase-orders`.","operationId":"list","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","description":"Подстрока названия поставщика, его ИНН или адреса электронной почты, без учета регистра. Пустая строка и строка из пробелов фильтром не считаются","required":false,"schema":{"type":"string"},"example":"Ромашка"}],"responses":{"200":{"description":"Страница списка поставщиков","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierListResponse"}}}},"400":{"description":"Недопустимое значение фильтра или курсора","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:purchase`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:purchase'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:purchase"]}]},"post":{"tags":["purchasing"],"summary":"Создать поставщика","description":"Заводит карточку контрагента. Возвращенный `id` — тот самый `supplier_id`,\nкоторый требует тело `POST /purchase-orders`: до ZOL-11168 узнать его\nснаружи было нечем, и на пустом учете вся ветка закупок вместе с приходами\nоткрывалась только руками в интерфейсе. Обязателен `Idempotency-Key`:\nповтор с тем же ключом вернет прежний ответ и второй карточки не создаст.","operationId":"create","parameters":[{"name":"Idempotency-Key","in":"header","description":"Обязателен, до 200 символов. Повтор с тем же ключом возвращает прежний ответ и второй карточки не создает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"5f6f0c2a-9b3a-4d1e-8c77-2b0f1c9a4e10"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierCreateRequest"}}},"required":true},"responses":{"201":{"description":"Карточка поставщика создана. Повтор с прежним `Idempotency-Key` отвечает тем же кодом и тем же телом — новой карточки не появляется","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierDto"}}}},"400":{"description":"Некорректное тело запроса","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:purchase.supplier.create`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:purchase.supplier.create'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"`Idempotency-Key` повторен с другим телом либо ИНН уже занят другим поставщиком этого учета","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений (`rate_limited`) либо исчерпан суточный предел документов ключа (`document_quota_exceeded`). Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"document_quota_exceeded","message":"Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:purchase.supplier.create"]}]}},"/api/external/v1/suppliers/{id}":{"get":{"tags":["purchasing"],"summary":"Карточка поставщика","description":"Один поставщик вместе с контактными данными и условиями работы.","operationId":"get_one","parameters":[{"name":"id","in":"path","description":"id поставщика","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Карточка поставщика","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierDto"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:purchase`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:purchase'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого поставщика нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:purchase"]}]},"patch":{"tags":["purchasing"],"summary":"Изменить карточку поставщика","description":"Правит реквизиты уже заведенного контрагента. Присланные поля\nперезаписываются, отсутствующие сохраняют прежнее значение; очистить\nнеобязательный реквизит можно пустой строкой. Мягко удаленный поставщик\n(ZOL-8330) не правится: он отвечает `404`, как и чужой.","operationId":"update","parameters":[{"name":"id","in":"path","description":"id поставщика","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен, до 200 символов. Повтор с тем же ключом возвращает прежний ответ и второй правки не делает. Ответ на повтор помечен заголовком `Idempotency-Replayed: true` — по коду ответа повтор от первичного вызова не отличается.","required":true,"schema":{"type":"string"},"example":"7c1a4d90-2f8b-4a13-9e55-8d0b3c6f1a27"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Карточка поставщика после правки","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: действие уже было выполнено прежним вызовом с тем же `Idempotency-Key`, второй раз оно не выполнялось. У ответа, полученного действием прямо сейчас, заголовка нет. Код ответа у повтора тот же, что был у первичного вызова, поэтому отличить повтор можно только по этому заголовку"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierDto"}}}},"400":{"description":"Некорректное тело запроса","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:purchase.supplier.update`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:purchase.supplier.update'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"В этом учете такого поставщика нет либо он удален","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"`Idempotency-Key` повторен с другим телом либо ИНН уже занят другим поставщиком этого учета","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:purchase.supplier.update"]}]}},"/api/external/v1/units":{"get":{"tags":["products"],"summary":"Список единиц измерения","description":"Справочник единиц измерения учета. Поле `id` каждой записи — тот самый\n`unit_id`, который принимает тело `POST /products`.","operationId":"list_units","parameters":[{"name":"limit","in":"query","description":"Сколько записей вернуть: от 1 до 200, по умолчанию 50","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Курсор из поля `next_cursor` предыдущего ответа. Без него чтение начинается сначала","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Страница списка единиц измерения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnitListResponse"}}}},"400":{"description":"Недопустимое значение курсора или `limit`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:catalog`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:catalog'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:catalog"]}]}},"/api/external/v1/webhook-subscriptions":{"get":{"tags":["webhooks"],"summary":"Список подписок на события","description":"Все живые подписки ключа-владельца учета. Секрета подписи в ответе нет: он\nпоказывается один раз, в ответе на заведение.","operationId":"list","responses":{"200":{"description":"Подписки клиента","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionListResponse"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `read:webhooks`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'read:webhooks'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["read:webhooks"]}]},"post":{"tags":["webhooks"],"summary":"Завести подписку на события","description":"Заводит подписку и **единственный раз** показывает ее секрет подписи\n(`whsec_…`): им проверяется заголовок `X-Zolotenkov-Signature` каждого\nуведомления. Восстановить секрет нельзя — потерянный меняется только\nзаведением новой подписки.\n\nАдрес получателя проверяется сразу: `https`, публичный адрес, порт 443 или\nвыше 1024. Адрес, записанный именем узла, принимается, но имя разрешается\nв адрес перед каждой отправкой, и уведомление во внутреннюю сеть не уйдет —\nпричина будет видна в журнале доставок.\n\nОбязателен `Idempotency-Key`: повтор с тем же ключом вернет ту же подписку\nи второй не заведет, но **без секрета**: в повторе `secret` равен `null`,\nа `secret_already_shown` — `true`. Секрет не хранится в кэше повторов,\nчтобы его копия не лежала в базе. Ответ с секретом потерян — снимите\nподписку по id из повтора и заведите новую. Ключ помнится не меньше суток.","operationId":"create","parameters":[{"name":"Idempotency-Key","in":"header","description":"Обязателен, до 200 символов. Повтор с тем же ключом возвращает ту же подписку без секрета и второй подписки не заводит.","required":true,"schema":{"type":"string"},"example":"3a91c7de-15b0-4a6f-9f2c-8d4e0b17aa93"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionCreateRequest"}}},"required":true},"responses":{"201":{"description":"Подписка заведена. Поле `secret` заполнено только в первичном ответе, в повторе оно `null`","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов: подписка была заведена прежним вызовом с тем же `Idempotency-Key`"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedWebhookSubscriptionDto"}}}},"400":{"description":"Недопустимый адрес получателя, пустой или неизвестный набор событий, слишком длинное описание","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:webhook.subscription.create`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:webhook.subscription.create'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"`Idempotency-Key` повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"422":{"description":"Достигнут предел подписок клиента","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unprocessable","message":"Учетный период закрыт по 30.09.2026. Документы с датой в закрытом периоде нельзя создавать, изменять или удалять.","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:webhook.subscription.create"]}]}},"/api/external/v1/webhook-subscriptions/{id}":{"delete":{"tags":["webhooks"],"summary":"Снять подписку","description":"Останавливает доставку и убирает подписку из списка. Журнал доставок\nостается: он свидетельство того, что именно уходило клиенту. Секрет снятой\nподписки не восстанавливается — новая подписка получает новый.\n\nОбязателен `Idempotency-Key`: повтор с тем же ключом отвечает тем же телом,\nа не `404`.","operationId":"delete","parameters":[{"name":"id","in":"path","description":"id подписки","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен, до 200 символов. Повтор с тем же ключом возвращает прежний ответ, а не `404`.","required":true,"schema":{"type":"string"},"example":"3a91c7de-15b0-4a6f-9f2c-8d4e0b17aa93"}],"responses":{"200":{"description":"Подписка снята","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionDeletedResponse"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:webhook.subscription.delete`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:webhook.subscription.delete'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"Подписки с таким id у этого клиента нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:webhook.subscription.delete"]}]},"patch":{"tags":["webhooks"],"summary":"Изменить подписку","description":"Меняет набор событий, признак включенности и описание. Отсутствующее в\nтеле поле сохраняет прежнее значение. Адрес получателя не меняется: под\nдругой адрес заводится другая подписка, иначе журнал доставок перестает\nотвечать на вопрос «куда это уходило».\n\n`\"enabled\": true` возвращает в строй сбойную подписку: пометка `failing`\nснимается, счетчик неудач обнуляется. События, накопившиеся за время\nпростоя, повторно не рассылаются.","operationId":"update","parameters":[{"name":"id","in":"path","description":"id подписки","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","description":"Обязателен, до 200 символов. Повтор с тем же ключом возвращает прежний ответ.","required":true,"schema":{"type":"string"},"example":"3a91c7de-15b0-4a6f-9f2c-8d4e0b17aa93"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Подписка изменена","headers":{"Idempotency-Replayed":{"schema":{"type":"string"},"description":"`true` — ответ достали из хранилища повторов"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionDto"}}}},"400":{"description":"Пустой или неизвестный набор событий, слишком длинное описание","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"validation_failed","message":"customer_id must be a positive integer","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"401":{"description":"Ключ не передан, недействителен или отозван","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"unauthorized","message":"Missing Authorization header","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"403":{"description":"У ключа нет права `write:webhook.subscription.update`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"forbidden","message":"Missing required scope 'write:webhook.subscription.update'","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"404":{"description":"Подписки с таким id у этого клиента нет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"not_found","message":"Resource not found","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"409":{"description":"`Idempotency-Key` повторен с другим телом","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"conflict","message":"Idempotency-Key reused with a different request body","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}},"429":{"description":"Превышена частота обращений. Задержка до повтора — в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"},"example":{"error":"rate_limited","message":"Rate limit exceeded","request_id":"req_cyX5W3UaT8KsYDN7GUEkdW"}}}}},"security":[{"pat":["write:webhook.subscription.update"]}]}}},"components":{"schemas":{"BatchDto":{"type":"object","required":["id","item_id","item_variant_id","batch_number","received_date","quantity","initial_quantity","source_type","locked_out"],"properties":{"batch_number":{"type":"string","example":"PO-2026-08-14-001"},"expiry_date":{"type":["string","null"],"format":"date","description":"«Годен до». Пусто у партий без срока годности — у ткани это крашение,\nу метизов плавка, и портиться там нечему (ZOL-8924).","example":"2026-09-30"},"id":{"type":"string"},"initial_quantity":{"type":"number","format":"double","description":"Сколько пришло в партию изначально.","example":40.0},"item_id":{"type":"string"},"item_variant_id":{"type":"string"},"locked_out":{"type":"boolean","description":"Партия выведена из оборота — просрочена и в расход не уйдет."},"manufacture_date":{"type":["string","null"],"format":"date","description":"Дата изготовления. Пусто, когда ее не указали при приемке."},"quantity":{"type":"number","format":"double","description":"Текущий остаток по партии.","example":25.0},"received_date":{"type":"string","format":"date"},"source_id":{"type":["string","null"],"description":"Строка документа-источника: `purchase_order_item.id` у приемки,\n`manufacturing_order.id` у производственного задания."},"source_type":{"type":"string","description":"Откуда партия появилась: `PURCHASE_ORDER`, `MANUFACTURING_ORDER`,\n`SALES_RETURN` или `MANUAL`.","example":"PURCHASE_ORDER"}}},"BatchListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BatchDto"}},"next_cursor":{"type":["string","null"]}}},"CategoryDto":{"type":"object","required":["id","title"],"properties":{"id":{"type":"string","description":"id категории. Он же `category_id` в теле `POST /products`."},"parent_id":{"type":["string","null"],"description":"Родительская категория; `null` у категории верхнего уровня."},"title":{"type":"string","example":"Сыпучие"}}},"CategoryListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CategoryDto"}},"next_cursor":{"type":["string","null"]}}},"CountRateDto":{"type":"object","required":["count","rate"],"properties":{"count":{"type":"integer","format":"int64"},"rate":{"type":"number","format":"double","description":"Доля от числа наблюдавшихся попыток в этом окне, от 0 до 1.","example":0.12}}},"CreatedWebhookSubscriptionDto":{"allOf":[{"type":"object","description":"Подписка на события.","required":["id","url","events","enabled","status","consecutive_failures","description","created_at"],"properties":{"consecutive_failures":{"type":"integer","format":"int32"},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string","example":"приемник интеграции с 1С"},"enabled":{"type":"boolean","description":"Доставка включена. Выключенная подписка событий не получает и\nуведомления за время простоя потом не догоняет."},"events":{"type":"array","items":{"type":"string"},"description":"Набор типов событий, на которые подписан адрес. Полный перечень с\nсоставом полезной нагрузки — в разделе `webhooks` этой спецификации.","example":["sales_order.created","stock.changed"]},"id":{"type":"string","description":"id подписки. Он же в пути `PATCH` и `DELETE`."},"last_delivery_at":{"type":["string","null"],"format":"date-time"},"last_failure_at":{"type":["string","null"],"format":"date-time"},"last_failure_reason":{"type":["string","null"],"description":"Причина последней неудачи. Тела ответа получателя здесь нет и не будет.","example":"получатель ответил кодом 500"},"status":{"type":"string","description":"`active` — доставляется, `failing` — попытки исчерпаны и доставка\nостановлена до вмешательства. Сбойную подписку возвращает в строй\n`PATCH` с `\"enabled\": true`: счетчик неудач обнуляется.","example":"active"},"url":{"type":"string","example":"https://hooks.example.com/zolotenkov"}}},{"type":"object","required":["secret_already_shown"],"properties":{"secret":{"type":["string","null"],"description":"Секрет подписи уведомлений. Показывается один раз: сохраните сразу,\nвосстановить его нельзя — можно только завести подписку заново. В\nповторе с тем же `Idempotency-Key` здесь `null`.","example":"whsec_9f2b…"},"secret_already_shown":{"type":"boolean","description":"`true` — секрет уже был показан первичным ответом и в этом ответе его\nнет. Так отвечает повтор с тем же `Idempotency-Key`: подписка та же,\nсекрет сервер не хранит в кэше повторов."}}}],"description":"Ответ заведения: подписка плюс секрет подписи — единственное место, где он\nвиден, и только один раз."},"CustomerCreateRequest":{"type":"object","description":"Тело `POST /customers`. Обязательно только имя контрагента: остальные\nреквизиты у розничного покупателя могут отсутствовать вовсе.","required":["title"],"properties":{"address":{"type":["string","null"],"description":"Адрес доставки по умолчанию.","example":"Москва, ул. Складская, 3"},"bill_to_address":{"type":["string","null"],"description":"Юридический адрес.","example":"119021, Москва, ул. Льва Толстого, 16"},"country_code":{"type":["string","null"],"description":"Страна, ISO-3166-1 alpha-2. Заказ покупателя берет ее как значение по\nумолчанию.","example":"RU"},"currency":{"type":["string","null"],"description":"Валюта расчетов, трехбуквенный код. По умолчанию валюта учета.","example":"RUB"},"email":{"type":["string","null"],"example":"zakaz@example.ru"},"first_name":{"type":["string","null"],"example":"Иван"},"inn":{"type":["string","null"],"description":"ИНН. Повтор в пределах учета отвечает `409`.","example":"7701234567"},"kpp":{"type":["string","null"],"example":"770101001"},"last_name":{"type":["string","null"],"example":"Петров"},"legal_name":{"type":["string","null"],"description":"Наименование под УПД.","example":"Общество с ограниченной ответственностью «Ромашка»"},"notes":{"type":["string","null"],"example":"Отгрузка по вторникам"},"ogrn":{"type":["string","null"],"example":"1027700132195"},"phone":{"type":["string","null"],"example":"+7 495 123-45-67"},"title":{"type":"string","description":"Отображаемое имя контрагента. Единственное обязательное поле. У поставщика это же поле называется `name` — имена полей у двух справочников исторически разошлись, и переименование сломало бы уже выпущенные ключи.","example":"ООО «Ромашка»"}}},"CustomerDto":{"type":"object","required":["id","title","created_at","updated_at"],"properties":{"address":{"type":["string","null"],"description":"Адрес доставки по умолчанию.","example":"Москва, ул. Складская, 3"},"bill_to_address":{"type":["string","null"],"description":"Юридический адрес.","example":"119021, Москва, ул. Льва Толстого, 16"},"country_code":{"type":["string","null"],"description":"Страна, ISO-3166-1 alpha-2.","example":"RU"},"created_at":{"type":"string","format":"date-time"},"currency":{"type":["string","null"],"description":"Валюта расчетов, трехбуквенный код.","example":"RUB"},"email":{"type":["string","null"],"example":"zakaz@example.ru"},"first_name":{"type":["string","null"],"example":"Иван"},"id":{"type":"string","description":"id покупателя (строкой — на случай миграции на uuid в v2). Он же\n`customer_id` в теле `POST /sales-orders`."},"inn":{"type":["string","null"],"description":"ИНН уникален в пределах учета: повтор отвечает `409`.","example":"7701234567"},"kpp":{"type":["string","null"],"example":"770101001"},"last_name":{"type":["string","null"],"example":"Петров"},"legal_name":{"type":["string","null"],"description":"Наименование под УПД. При пустом в печать идет `title`.","example":"Общество с ограниченной ответственностью «Ромашка»"},"notes":{"type":["string","null"],"example":"Отгрузка по вторникам"},"ogrn":{"type":["string","null"],"example":"1027700132195"},"phone":{"type":["string","null"],"example":"+7 495 123-45-67"},"title":{"type":"string","description":"Отображаемое имя контрагента. У поставщика это же поле называется `name` — имена полей у двух справочников исторически разошлись, и переименование сломало бы уже выпущенные ключи.","example":"ООО «Ромашка»"},"updated_at":{"type":"string","format":"date-time"}}},"CustomerListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CustomerDto"}},"next_cursor":{"type":["string","null"]}}},"CustomerUpdateRequest":{"type":"object","description":"Тело `PATCH /customers/{id}`.\n\nОбязательных полей нет: присланные перезаписываются, отсутствующие сохраняют\nпрежнее значение — тот же контракт, что у `PATCH /suppliers/{id}`. Очистить\nнеобязательный реквизит можно пустой строкой.\n\nИмя контрагента здесь называется `title`, а у поставщика — `name`. Это\nрасхождение унаследовано от колонок (`customer.title` против\n`supplier.name`) и в v1 сохраняется: переименование поля сломало бы уже\nвыпущенных клиентов. Оно названо явно здесь и в справочнике API, чтобы\nинтегратор не искал причину отказа `400` в своем коде.","properties":{"address":{"type":["string","null"],"description":"Адрес доставки по умолчанию.","example":"Москва, ул. Складская, 3"},"bill_to_address":{"type":["string","null"],"description":"Юридический адрес.","example":"119021, Москва, ул. Льва Толстого, 16"},"country_code":{"type":["string","null"],"description":"Страна, ISO-3166-1 alpha-2.","example":"RU"},"currency":{"type":["string","null"],"description":"Валюта расчетов, трехбуквенный код.","example":"RUB"},"email":{"type":["string","null"],"example":"zakaz@example.ru"},"first_name":{"type":["string","null"],"example":"Иван"},"inn":{"type":["string","null"],"description":"ИНН. Повтор в пределах учета отвечает `409`.","example":"7701234567"},"kpp":{"type":["string","null"],"example":"770101001"},"last_name":{"type":["string","null"],"example":"Петров"},"legal_name":{"type":["string","null"],"description":"Наименование под УПД.","example":"Общество с ограниченной ответственностью «Ромашка»"},"notes":{"type":["string","null"],"example":"Отгрузка по вторникам"},"ogrn":{"type":["string","null"],"example":"1027700132195"},"phone":{"type":["string","null"],"example":"+7 495 123-45-67"},"title":{"type":["string","null"],"description":"Отображаемое имя контрагента. Пустой строкой не очищается: у покупателя\nэто единственное обязательное поле. У поставщика это же поле называется `name` — имена полей у двух справочников исторически разошлись, и переименование сломало бы уже выпущенные ключи.","example":"ООО «Ромашка»"}}},"DuplicateProfileCountersDto":{"type":"object","required":["coverageAvailable","exactNormalizedEmail"],"properties":{"coverageAvailable":{"type":"boolean","description":"Покрытие есть только когда сервер наблюдал все успешные и конфликтные\nпопытки в окне; пустое окно намеренно не считается доказательством."},"exactNormalizedEmail":{"$ref":"#/components/schemas/CountRateDto"}}},"EmailCategoryCountersDto":{"type":"object","required":["disposable","freeProvider","businessOrOther","invalid"],"properties":{"businessOrOther":{"$ref":"#/components/schemas/CountRateDto"},"disposable":{"$ref":"#/components/schemas/CountRateDto"},"freeProvider":{"$ref":"#/components/schemas/CountRateDto"},"invalid":{"$ref":"#/components/schemas/CountRateDto"}}},"EmailSignalCountersDto":{"type":"object","required":["coverageAvailable","coveredAttempts","unavailableAttempts","categories"],"properties":{"categories":{"$ref":"#/components/schemas/EmailCategoryCountersDto"},"coverageAvailable":{"type":"boolean","description":"`false` означает пробел покрытия, а не подтвержденный чистый ноль."},"coveredAttempts":{"type":"integer","format":"int64"},"unavailableAttempts":{"type":"integer","format":"int64"}}},"ErrorBody":{"type":"object","required":["error","message","request_id"],"properties":{"details":{},"error":{"type":"string","description":"Машинный код отказа. Разбор ответа пишут по нему, а не по тексту\n`message`: текст меняется, код — часть контракта.","example":"validation_failed"},"message":{"type":"string","example":"Поле title обязательно"},"request_id":{"type":"string","description":"Значение `X-Request-Id` этого обращения — с ним обращаются в поддержку.","example":"req_cyX5W3UaT8KsYDN7GUEkdW"}}},"ManufacturingOrderCostDto":{"type":"object","description":"Фактическая себестоимость выпуска, зафиксированная при завершении задания.\n\nЧисла «застывают» в момент перехода в `DONE` и дальше не пересчитываются:\nспецификация и ставки могут меняться, а исторический выпуск от этого\nдорожать не должен. Поэтому это именно снимок, а не текущий расчет.\n\nСлагаемое равно `null`, когда посчитать его не удалось: у строки материала\nнет зафиксированной цены либо у операции нет ни фактической, ни плановой\nстоимости. Отсутствие самих строк или операций дает ноль, а не `null`.\n`total` равен `null`, если `null` хотя бы одно слагаемое.","properties":{"materials":{"type":["number","null"],"format":"double","description":"Материалы: сумма `фактическое количество × цена строки на момент\nзавершения` по строкам, у которых нет собственной спецификации.","example":2000.0},"operations":{"type":["number","null"],"format":"double","description":"Операции: сумма фактической стоимости операций, а где ее не вводили —\nплановой (`ставка часа × норма времени × количество выпуска`).","example":4500.0},"subassemblies":{"type":["number","null"],"format":"double","description":"Полуфабрикаты: то же по строкам, у которых своя спецификация есть.","example":500.0},"total":{"type":["number","null"],"format":"double","description":"Итог выпуска: `materials + subassemblies + operations`. Это стоимость\nвсего выпуска, а не единицы: делить на `actual_quantity` — на стороне\nклиента.","example":7000.0}}},"ManufacturingOrderCreateRequest":{"type":"object","required":["item_variant_id","quantity"],"properties":{"created_date":{"type":["string","null"],"format":"date-time","description":"Дата документа. Не прислали — «сейчас»."},"item_variant_id":{"type":"integer","format":"int64","description":"Что изготавливаем — вариант изделия. Строки материалов система соберет\nсама по спецификации изделия, как и в интерфейсе; присылать их незачем."},"manufacturing_location_id":{"type":["integer","null"],"format":"int64","description":"Производственная локация. Не прислали — склад из настроек производства,\nкак в интерфейсе."},"number":{"type":["string","null"],"description":"Номер документа. Не прислали — система выдает следующий сама, тем же\nсчетчиком, что и интерфейс."},"production_date":{"type":["string","null"],"format":"date-time","description":"Срок производства. Не прислали — расчет по недельной мощности, если\nавтоматические сроки включены, иначе дата документа + 7 дней; в ответе\nсрок заполнен всегда. Полей `planned_start_date` и `shipping_date` больше\nнет: прислать их — ответ `422` с кодом `manufacturing_order_field_removed`."},"quantity":{"type":"number","format":"double","description":"Плановое количество выпуска. Строго больше нуля.","example":10.0}}},"ManufacturingOrderDetailResponse":{"allOf":[{"$ref":"#/components/schemas/ManufacturingOrderDto"},{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ManufacturingOrderItemDto"},"description":"Материалы заказа — строки списания."}}}]},"ManufacturingOrderDto":{"type":"object","required":["id","number","status","type","item_variant","quantity","released_quantity","created_date","priority"],"properties":{"actual_cost":{"oneOf":[{"$ref":"#/components/schemas/ManufacturingOrderCostDto","description":"Фактическая себестоимость выпуска — снимок на момент завершения.\n`null`, пока задание не завершено: до перехода в `DONE` снимка нет."},{"type":"null"}]},"actual_quantity":{"type":["number","null"],"format":"double","description":"Ручной итог выпуска, который проставили в карточке; `null`, пока его\nне задавали. Событие выпуска его не поднимает — сколько фактически\nсдано на склад, показывает `released_quantity`.","example":10.0},"completed_at":{"type":["string","null"],"format":"date-time"},"created_date":{"type":"string","format":"date-time"},"id":{"type":"string"},"item_variant":{"$ref":"#/components/schemas/ManufacturingOrderVariantDto","description":"Что изготавливаем."},"manufacturing_location_id":{"type":["string","null"],"description":"Производственная локация; `null` — заказ без указания локации."},"number":{"type":"string","description":"Человекочитаемый номер документа, например `MO-1001`."},"output_batch_number":{"type":["string","null"],"description":"Партия выпуска, если по изделию ведется партионный учет."},"output_expiry_date":{"type":["string","null"],"format":"date"},"output_manufacture_date":{"type":["string","null"],"format":"date"},"priority":{"type":"integer","format":"int32","description":"Ручной порядок в расписании цеха: меньше — раньше."},"production_date":{"type":["string","null"],"format":"date-time","description":"Срок производства — то, ради чего внешний помощник и приходит\nв этот раздел."},"quantity":{"type":"number","format":"double","description":"Плановое количество выпуска.","example":10.0},"released_quantity":{"type":"number","format":"double","description":"ZOL-13436: сколько задание фактически сдало на склад — сумма приходов\nвыпуска, включая добор при закрытии задания (ZOL-14212). Отмененные и\nоткаченные выпуски в нее не входят. Только на чтение. Сколько задание выдало по факту, считайте как\n`max(actual_quantity, released_quantity)`.","example":10.0},"sales_order_delivery_deadline":{"type":["string","null"],"format":"date-time","description":"Срок доставки связанного заказа покупателя, только на чтение. `null` у\nзадания на склад. Правится в заказе покупателя, а не в задании."},"sales_order_id":{"type":["string","null"],"description":"Заказ покупателя, под который открыт производственный заказ."},"started_at":{"type":["string","null"],"format":"date-time"},"status":{"type":"string","description":"`NOT_STARTED` | `IN_PROGRESS` | `BLOCKED` | `PARTIALLY_DONE` | `DONE`."},"type":{"type":"string","description":"`MAKE_TO_STOCK` | `MAKE_TO_ORDER`.","example":"MAKE_TO_STOCK"}}},"ManufacturingOrderItemDto":{"type":"object","required":["id","item_id","item_variant_id","title","quantity"],"properties":{"actual_quantity":{"type":["number","null"],"format":"double","description":"Сколько израсходовано фактически; `null`, пока факт не зафиксирован.","example":10.0},"id":{"type":"string"},"item_id":{"type":"string"},"item_variant_id":{"type":"string"},"quantity":{"type":"number","format":"double","description":"Сколько материала запланировано на весь заказ.","example":10.0},"sku":{"type":["string","null"]},"title":{"type":"string"}}},"ManufacturingOrderListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ManufacturingOrderDto"}},"next_cursor":{"type":["string","null"]}}},"ManufacturingOrderTransitionRequest":{"type":"object","description":"Тело запуска и завершения задания — пустой объект `{}`.\n\nПолей у него нет: обе ручки меняют только статус задания, а его состав и\nколичества берут из самого задания."},"ManufacturingOrderVariantDto":{"type":"object","required":["id","item_id","title","item_title"],"properties":{"id":{"type":"string","description":"id варианта изготавливаемого изделия."},"item_id":{"type":"string"},"item_title":{"type":"string","example":"Табурет дубовый"},"sku":{"type":["string","null"],"description":"`variant_code` варианта — тот же артикул, что отдает `/products`."},"title":{"type":"string","description":"Название варианта; пусто у изделия без вариантов — тогда смотрите\n`item_title`."}}},"ManufacturingTaskDto":{"type":"object","required":["id","manufacturing_order_id","operation_id","operation_title","status","position","duration","cost_per_hour","total_cost"],"properties":{"actual_cost_cents":{"type":["integer","null"],"format":"int64","description":"Фактическая стоимость операции в копейках."},"actual_time_minutes":{"type":["integer","null"],"format":"int32","description":"Фактическое время операции в минутах."},"cost_per_hour":{"type":"number","format":"double","description":"Плановая стоимость часа.","example":900.0},"duration":{"type":"number","format":"double","description":"Норма времени на единицу изделия, в единицах операции (обычно часы).","example":0.5},"id":{"type":"string"},"manufacturing_order_id":{"type":"string"},"operation_id":{"type":"string","description":"Операция из справочника `/operations`."},"operation_title":{"type":"string","example":"Сборка"},"operation_type":{"type":["string","null"],"description":"Вид операции из технологии изделия; `null`, если не заполнен."},"position":{"type":"integer","format":"int32","description":"Порядок операции в технологии изделия."},"resource_id":{"type":["string","null"],"description":"Станок или участок; `null`, если не назначен."},"resource_name":{"type":["string","null"],"example":"Сборочный участок"},"status":{"type":"string","description":"`NOT_STARTED` | `IN_PROGRESS` | `PAUSED` | `BLOCKED` | `COMPLETED`."},"total_cost":{"type":"number","format":"double","description":"Плановая стоимость операции на весь заказ:\nПо типу операции: процесс и «на единицу» зависят от количества,\nналадка и фиксированная стоимость — нет.","example":4500.0}}},"ManufacturingTaskListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ManufacturingTaskDto"}}}},"OperationDto":{"type":"object","required":["id","title","cost_per_hour","position"],"properties":{"cost_per_hour":{"type":"number","format":"double","description":"Плановая стоимость единицы времени операции (колонка `rate`).","example":900.0},"id":{"type":"string"},"position":{"type":"integer","format":"int32","description":"Порядок операции в справочнике — тот же, что видит клиент на экране."},"title":{"type":"string"},"unit_id":{"type":["string","null"],"description":"Единица измерения времени операции; `null`, если единица удалена."},"unit_name":{"type":["string","null"],"example":"ч"}}},"OperationListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/OperationDto"}},"next_cursor":{"type":["string","null"]}}},"PasswordRecoveryOutcomeCountersDto":{"type":"object","required":["rateLimit","recipientMissing","recipientIneligible","smtpSent","smtpFailed","completed","tokenInvalid"],"properties":{"completed":{"type":"integer","format":"int64"},"rateLimit":{"type":"integer","format":"int64"},"recipientIneligible":{"type":"integer","format":"int64"},"recipientMissing":{"type":"integer","format":"int64"},"smtpFailed":{"type":"integer","format":"int64"},"smtpSent":{"type":"integer","format":"int64"},"tokenInvalid":{"type":"integer","format":"int64"}}},"PlanBucketDto":{"type":"object","required":["index","label","starts_at","ends_at"],"properties":{"ends_at":{"type":"string","example":"2026-08-24T00:00:00+00:00"},"index":{"type":"integer","format":"int32","description":"Порядковый номер периода в ответе, с нуля."},"label":{"type":"string","description":"Подпись периода, как ее видит человек: «34 нед.», «сен. 2026».","example":"34 нед."},"starts_at":{"type":"string","example":"2026-08-17T00:00:00+00:00"}}},"PlanExpectedOrderDto":{"type":"object","required":["number","qty","overdue"],"properties":{"eta":{"type":["string","null"],"description":"Ожидаемая дата поступления; `null` — в заказе не указана.","example":"2026-09-10T00:00:00+00:00"},"number":{"type":"string","description":"Человеческий номер документа: «ЗП-179», «ПЗ-42».","example":"ЗП-179"},"overdue":{"type":"boolean","description":"Срок прошел, приемки не было. Такой приход рекомендацию не уменьшает."},"purchase_order_id":{"type":["string","null"],"description":"Номер заказа поставщику; `null` — ожидается выпуск производства."},"qty":{"type":"number","format":"double","description":"Остаток к приемке.","example":40.0}}},"PlanForecastResponse":{"type":"object","required":["data","buckets","current_week","granularity","total","truncated"],"properties":{"buckets":{"type":"array","items":{"$ref":"#/components/schemas/PlanBucketDto"}},"current_week":{"type":"integer","format":"int32","description":"Номер текущей недели по ISO — тот же ориентир, что печатает экран."},"data":{"type":"array","items":{"$ref":"#/components/schemas/PlanForecastRowDto"}},"granularity":{"type":"string","description":"`weekly` или `monthly` — период, которым нарезан горизонт.","example":"weekly"},"total":{"type":"integer","format":"int64","description":"Строк в расчете всего, до обрезки по `limit`. Верхний предел самого\nрасчета — 10 000 позиций."},"truncated":{"type":"boolean","description":"`true` — показаны не все строки, сузьте выборку фильтрами."}}},"PlanForecastRowDto":{"type":"object","required":["item_variant_id","code","name","kind","stock","stock_unit","safety_stock","projected_stock","receipts","spends","forecast_spends","overdue_receipts","demand_irregular"],"properties":{"code":{"type":"string","description":"Артикул варианта.","example":"ITM-4891"},"demand_irregular":{"type":"boolean","description":"ZOL-11922: прогноз спроса по позиции подавлен — отгрузок за окно истории\nменьше трех, регулярного недельного спроса нет. `forecast_spends` при\nэтом нулевые. `false` у позиции без отгрузок в окне: подавлять нечего.","example":false},"forecast_spends":{"type":"array","items":{"type":"number","format":"double"},"description":"ZOL-11806: та часть `spends`, которая пришла из прогноза спроса, а не из\nдокументов. Нули, если `forecast_demand=false`.","example":["0.000","4.700","4.700"]},"item_variant_id":{"type":"string"},"kind":{"type":"string","description":"`product` — изделие, `material` — материал.","example":"material"},"name":{"type":"string"},"overdue_receipts":{"type":"number","format":"double","description":"Заказано, срок поставки прошел, приемки не было. В `projected_stock`\nне входит: сорванная поставка остатком не является.","example":0.0},"projected_stock":{"type":"array","items":{"type":"number","format":"double"},"description":"Расчетный остаток на конец каждого периода из `buckets`, накопительно.","example":["12.000","-6.000","-24.000"]},"receipts":{"type":"array","items":{"type":"number","format":"double"},"description":"Приход по периодам: выпуск производства и приемка закупок.","example":["0.000","0.000","0.000"]},"safety_stock":{"type":"number","format":"double","description":"Страховой запас позиции. Период, в котором `projected_stock` опускается\nниже него, и есть дефицит.","example":50.0},"spends":{"type":"array","items":{"type":"number","format":"double"},"description":"Расход по периодам: отгрузки, списание в производство и — при\n`forecast_demand=true` — прогнозный расход по истории отгрузок.","example":["0.000","18.000","18.000"]},"stock":{"type":"number","format":"double","description":"Остаток на момент запроса.","example":12.0},"stock_unit":{"type":"string","example":"м"}}},"PlanReplenishmentResponse":{"type":"object","required":["data","planning_horizon_weeks","forecast_history_weeks","total","truncated"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PlanReplenishmentRowDto"}},"forecast_history_weeks":{"type":"integer","format":"int64","description":"Окно истории отгрузок, по которому посчитан средний недельный спрос."},"planning_horizon_weeks":{"type":"integer","format":"int32","description":"Горизонт подтвержденных движений в этом ответе, в неделях."},"total":{"type":"integer","format":"int64","description":"Строк дефицита всего, до обрезки по `limit`."},"truncated":{"type":"boolean","description":"`true` — показаны не все строки. Отрезаны наименее срочные: строки\nотсортированы по срочности, самые горящие идут первыми."}}},"PlanReplenishmentRowDto":{"type":"object","required":["item_id","item_variant_id","code","name","kind","unit","allows_fractional","below_safety_date","forecasted_stock","recommended_qty","expected_qty","expected_overdue_qty","expected_orders","lead_date","urgency","action","has_recipe"],"properties":{"action":{"type":"string","description":"`buy` — заказать поставщику, `make` — выпустить, `transfer` —\nпереместить с другого места хранения.","example":"buy"},"allows_fractional":{"type":"boolean","description":"Единицу можно дробить. `false` — заказывать нужно целыми."},"below_safety_date":{"type":"string","description":"Дата, начиная с которой расчетный остаток уходит ниже страхового\nзапаса, — первое пересечение в горизонте.","example":"2026-09-04T00:00:00+00:00"},"code":{"type":"string","example":"ITM-4891"},"currency":{"type":["string","null"],"description":"Валюта учета клиента.","example":"RUB"},"delayed_by_days":{"type":["integer","null"],"format":"int64","description":"На сколько дней ближайший приход опаздывает к дате дефицита;\n`null` — не опаздывает."},"expected_orders":{"type":"array","items":{"$ref":"#/components/schemas/PlanExpectedOrderDto"},"description":"Открытые приходы на склад этой строки, ближайший первым."},"expected_overdue_qty":{"type":"number","format":"double","description":"Часть `expected_qty`, у которой срок поставки уже прошел.","example":0.0},"expected_qty":{"type":"number","format":"double","description":"Все, что ожидается по открытым закупкам и производственным заданиям\nна склад этой строки, включая просроченное. Поставки на другие склады\nпозиции сюда не входят и рекомендацию строки не уменьшают.","example":40.0},"forecasted_stock":{"type":"number","format":"double","description":"Самый низкий расчетный остаток, который должна покрыть рекомендация.","example":-18.0},"has_recipe":{"type":"boolean","description":"Для `make` — есть ли у изделия активная спецификация. `false` означает,\nчто выпустить нечем, пока ее не заполнит человек."},"item_id":{"type":"string"},"item_variant_id":{"type":"string"},"kind":{"type":"string","description":"`product` — изделие, `material` — материал.","example":"material"},"lead_date":{"type":"string","description":"Крайний срок размещения заказа: дата дефицита минус срок поставки.","example":"2026-08-28T00:00:00+00:00"},"lead_time_days":{"type":["integer","null"],"format":"int32","description":"Срок поставки из карточки позиции в днях; `null` — не заполнен."},"name":{"type":"string"},"purchase_cost":{"type":["number","null"],"format":"double","description":"Стоимость закупки рекомендованного количества; `null` у рекомендаций\n«выпустить» и «переместить»."},"recommended_qty":{"type":"number","format":"double","description":"Сколько рекомендуется заказать или выпустить. `0` означает «дефицит\nреален, но уже целиком покрыт открытым заказом» — смотрите\n`expected_orders`.","example":60.0},"storage_place":{"oneOf":[{"$ref":"#/components/schemas/PlanStoragePlaceDto","description":"Место хранения, к которому относится дефицит; `null` — у клиента нет\nзаведенных мест хранения."},{"type":"null"}]},"supplier":{"oneOf":[{"$ref":"#/components/schemas/PlanSupplierDto","description":"Поставщик из карточки позиции; `null` — не назначен."},{"type":"null"}]},"transfer_source":{"oneOf":[{"$ref":"#/components/schemas/PlanStoragePlaceDto","description":"Для `transfer` — место, с которого забирать."},{"type":"null"}]},"unit":{"type":"string","example":"м"},"unit_price":{"type":["number","null"],"format":"double","description":"Цена за единицу, из которой посчитана `purchase_cost`."},"urgency":{"type":"string","description":"`asap-red` — заказывать немедленно, срок уже упущен; `asap-yellow` —\nв ближайшую неделю; `scheduled` — по плану.","example":"asap-red"}}},"PlanStoragePlaceDto":{"type":"object","required":["id","title"],"properties":{"id":{"type":"string"},"title":{"type":"string"}}},"PlanSupplierDto":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"inn":{"type":["string","null"]},"kpp":{"type":["string","null"]},"name":{"type":"string"}}},"ProductBatchCreateRequest":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ProductCreateRequest"},"description":"Карточки в том же виде, в каком их принимает `POST /products`.\nОт 1 до `MAX_PRODUCT_BATCH_ITEMS` штук."}}},"ProductBatchErrorDto":{"type":"object","description":"Отказ по одной строке — тем же машинным кодом, каким одиночная ручка\nотвечает в поле `error` тела ошибки.","required":["code","message"],"properties":{"code":{"type":"string","description":"Машинный код: `validation_failed`, `conflict`, `document_quota_exceeded`\nи прочие коды одиночной ручки."},"message":{"type":"string"}}},"ProductBatchItemStatus":{"type":"string","description":"Чем закончилась одна строка партии.","enum":["created","failed","skipped"]},"ProductBatchResponse":{"type":"object","required":["created","failed","skipped","results"],"properties":{"created":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"results":{"type":"array","items":{"$ref":"#/components/schemas/ProductBatchResultDto"},"description":"Построчный итог в том же порядке, в каком строки пришли."},"skipped":{"type":"integer","minimum":0}}},"ProductBatchResultDto":{"type":"object","required":["index","title","status"],"properties":{"error":{"oneOf":[{"$ref":"#/components/schemas/ProductBatchErrorDto","description":"Причина отказа. Заполнена у `failed` и `skipped`."},{"type":"null"}]},"index":{"type":"integer","description":"Номер строки в присланном `items`, начиная с нуля. По нему строка\nсопоставляется с исходным файлом переноса.","minimum":0},"product":{"oneOf":[{"$ref":"#/components/schemas/ProductDto","description":"Заведенная карточка. Заполнено только у `created`."},{"type":"null"}]},"status":{"$ref":"#/components/schemas/ProductBatchItemStatus"},"title":{"type":"string","description":"Название из присланной строки — чтобы отказ читался без сверки с телом\nзапроса."}}},"ProductCreateRequest":{"type":"object","required":["title"],"properties":{"can_buy":{"type":"boolean"},"can_make":{"type":"boolean"},"can_sell":{"type":"boolean"},"category_id":{"type":["integer","null"],"format":"int64"},"cost_price":{"type":["number","null"],"format":"double","description":"Явная плановая себестоимость. Для покупного товара обязательна: отсутствие\nзначения не должно превращаться в неотличимый от настоящего ноль.","example":850.0},"is_kit":{"type":"boolean","description":"Пометить товар комплектом. Задается только при создании: у уже\nзаведенной карточки признак этой ручкой не меняется."},"sku":{"type":["string","null"]},"title":{"type":"string"},"unit_id":{"type":["integer","null"],"format":"int64","description":"Единица измерения товара. Без поля сохраняется единица по умолчанию:\nиз настройки «Товары по умолчанию», а если она не задана, то «шт»."}}},"ProductDto":{"type":"object","required":["id","title","can_sell","can_buy","can_make","is_kit","archived","created_at","updated_at","variants"],"properties":{"archived":{"type":"boolean"},"can_buy":{"type":"boolean"},"can_make":{"type":"boolean"},"can_sell":{"type":"boolean"},"category_id":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"},"id":{"type":"string","description":"id товара (строкой — на случай миграции на uuid в v2)."},"is_kit":{"type":"boolean","description":"Товар — комплект: продается как одна позиция, а собирается из других\nтоваров. Через API доступно только чтение признака."},"sku":{"type":["string","null"],"description":"Внутренний `variant_code` основной строки `item` (используется как артикул\nдо появления отдельного поля `sku`, см. §1.5 плана)."},"title":{"type":"string"},"unit_id":{"type":["string","null"]},"updated_at":{"type":"string","format":"date-time"},"variants":{"type":"array","items":{"$ref":"#/components/schemas/ProductVariantDto"},"description":"Варианты товара, по возрастанию `id`. Первый из них — основной: именно\nего `sku` и себестоимость правит `PATCH /products/{id}`."}}},"ProductListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ProductDto"}},"next_cursor":{"type":["string","null"]}}},"ProductUpdateRequest":{"type":"object","description":"Изменение карточки товара. Поле, которого нет в теле, не меняется: это\nчастичное изменение, а не замена карточки целиком.\n\nСнять уже заполненную категорию или единицу измерения этой ручкой нельзя —\n`null` и отсутствие поля означают здесь одно и то же, «не трогать». Сделать\nэто можно в интерфейсе.\n\nПризнак комплекта задается только при создании, а архивация карточки\nтребует отдельного права и через это тело недоступна.","properties":{"can_buy":{"type":["boolean","null"]},"can_make":{"type":["boolean","null"]},"can_sell":{"type":["boolean","null"]},"category_id":{"type":["integer","null"],"format":"int64"},"cost_price":{"type":["number","null"],"format":"double","description":"Плановая себестоимость основного варианта.","example":850.0},"sku":{"type":["string","null"]},"title":{"type":["string","null"]},"unit_id":{"type":["integer","null"],"format":"int64"}}},"ProductVariantDto":{"type":"object","description":"Вариант товара — та самая строка, чей `id` документы требуют полем\n`item_variant_id`.\n\nОтдается вместе с карточкой: до ZOL-11166 узнать этот номер снаружи было\nнечем, и заведенным через API товаром нельзя было воспользоваться ни в\nзаказе, ни в корректировке, ни в производственном задании.","required":["id","title"],"properties":{"cost_price":{"type":["number","null"],"format":"double","description":"Плановая себестоимость варианта.","example":850.0},"id":{"type":"string","description":"Он же `item_variant_id` в телах запросов на строки документов."},"sku":{"type":["string","null"],"description":"`variant_code` — артикул варианта."},"title":{"type":"string"}}},"ProductionSummaryResponse":{"type":"object","required":["data","totals","from","to","group_by","total","truncated"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ProductionSummaryRowDto"}},"from":{"type":"string","example":"2026-01-01"},"group_by":{"type":"string","example":"month"},"to":{"type":"string","example":"2026-12-31"},"total":{"type":"integer","format":"int64"},"totals":{"$ref":"#/components/schemas/ProductionSummaryTotalsDto","description":"Итог по всему срезу. Считается до обрезки по `limit`."},"truncated":{"type":"boolean"}}},"ProductionSummaryRowDto":{"type":"object","required":["period_start","period_end","item_id","item_name","orders","quantity","materials_cost","operations_cost","total_cost","minutes"],"properties":{"item_id":{"type":"string","description":"Номер товара. Варианты одного товара сложены в одну строку.","example":"4891"},"item_name":{"type":"string","example":"Платье льняное"},"materials_cost":{"type":"number","format":"double","description":"Материалы: фактическое списание по себестоимости варианта.","example":84000.0},"minutes":{"type":"number","format":"double","description":"Время операций в минутах: факт, а при незаполненном факте — план.","example":1380.0},"operations_cost":{"type":"number","format":"double","description":"Операции: фактическая стоимость, а при незаполненном факте — ставка\nчаса на длительность операции.","example":27600.0},"orders":{"type":"integer","format":"int64","description":"Сколько завершенных производственных заказов попало в период.","example":9},"period_end":{"type":"string","description":"Последний день периода строки, включительно.","example":"2026-08-31"},"period_start":{"type":"string","description":"Первый день периода строки. При `group_by=total` — начало запроса.","example":"2026-08-01"},"quantity":{"type":"number","format":"double","description":"Выпущено единиц: фактическое количество заказа, а при незаполненном\nфакте — плановое.","example":23.0},"total_cost":{"type":"number","format":"double","description":"`materials_cost` плюс `operations_cost`.","example":111600.0},"unit_cost":{"type":["number","null"],"format":"double","description":"`total_cost` на единицу выпуска. `null`, если выпуск нулевой.","example":4852.17}}},"ProductionSummaryTotalsDto":{"type":"object","required":["orders","quantity","materials_cost","operations_cost","total_cost","minutes"],"properties":{"materials_cost":{"type":"number","format":"double","example":84000.0},"minutes":{"type":"number","format":"double","example":1380.0},"operations_cost":{"type":"number","format":"double","example":27600.0},"orders":{"type":"integer","format":"int64","example":9},"quantity":{"type":"number","format":"double","example":23.0},"total_cost":{"type":"number","format":"double","example":111600.0},"unit_cost":{"type":["number","null"],"format":"double","example":4852.17}}},"PurchaseOrderCreateRequest":{"type":"object","required":["supplier_id","items"],"properties":{"currency":{"type":["string","null"]},"date":{"type":["string","null"],"format":"date-time","description":"Дата документа. Не прислали — «сейчас»."},"expected_date":{"type":["string","null"],"format":"date-time","description":"Ожидаемая дата поставки."},"items":{"type":"array","items":{"$ref":"#/components/schemas/PurchaseOrderItemWriteRequest"},"description":"Хотя бы одна строка. Заказ без строк не документ, а заготовка."},"number":{"type":["string","null"],"description":"Номер документа. Не прислали — система выдает следующий сама, тем же\nсчетчиком, что и интерфейс."},"supplier_id":{"type":"integer","format":"int64","description":"Поставщик обязателен: заказ без поставщика — не заказ, а напоминание.\nВ базе колонка необязательная ради старых строк, но заводить такие\nдокументы извне незачем."}}},"PurchaseOrderDetailResponse":{"allOf":[{"$ref":"#/components/schemas/PurchaseOrderDto"},{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PurchaseOrderItemDto"}}}}]},"PurchaseOrderDto":{"type":"object","required":["id","number","status","delivery_status","date","total_amount","tax_amount","total_amount_with_tax"],"properties":{"completed_at":{"type":["string","null"],"format":"date-time","description":"Момент, когда заказ стал полностью полученным."},"currency":{"type":["string","null"]},"date":{"type":"string","format":"date-time"},"delivery_status":{"type":"string","description":"Приемка: `NOT_RECEIVED` | `PARTIALLY_RECEIVED` | `RECEIVED`.","example":"NOT_RECEIVED"},"expected_date":{"type":["string","null"],"format":"date-time","description":"Ожидаемая дата поставки — то, ради чего внешний помощник и приходит\nв этот раздел. Дата, когда придет весь заказ: самая поздняя дата\nпоставки среди строк, полученных не полностью, а если получено все —\nсамая поздняя среди всех строк."},"id":{"type":"string"},"notes":{"type":["string","null"]},"number":{"type":"string","description":"Человекочитаемый номер документа, например `PO-1001`."},"status":{"type":"string","description":"`DRAFT` | `OPEN` | `DONE`.\n\nZOL-14868: `DRAFT` — черновик: не подтвержден, ожидаемым приходом не\nсчитается и не принимается. В списке виден только по `?status=DRAFT`."},"supplier":{"oneOf":[{"$ref":"#/components/schemas/PurchaseOrderSupplierDto","description":"`null`, если заказ заведен без поставщика: колонка `supplier_id`\nнеобязательная, и такие строки в базе есть."},{"type":"null"}]},"tax_amount":{"type":"number","format":"double","description":"НДС документа — сумма уже округленных по строкам величин.","example":2400.0},"total_amount":{"type":"number","format":"double","description":"Сумма без НДС.","example":12000.0},"total_amount_with_tax":{"type":"number","format":"double","description":"Итого с НДС.","example":14400.0}}},"PurchaseOrderItemDto":{"type":"object","required":["id","item_id","item_variant_id","title","quantity","price","received_quantity","line_amount","line_tax_amount","line_amount_with_tax"],"properties":{"batch_number":{"type":["string","null"]},"expected_date":{"type":["string","null"],"format":"date-time","description":"Ожидаемая дата поставки строки — когда придет все количество строки.\nУ строк одного заказа даты могут различаться."},"expiry_date":{"type":["string","null"],"format":"date"},"id":{"type":"string"},"item_id":{"type":"string"},"item_variant_id":{"type":"string"},"line_amount":{"type":"number","format":"double","example":12000.0},"line_amount_with_tax":{"type":"number","format":"double","example":14400.0},"line_tax_amount":{"type":"number","format":"double","example":2400.0},"price":{"type":"number","format":"double","description":"Цена за единицу без НДС.","example":1200.0},"quantity":{"type":"number","format":"double","example":10.0},"received_quantity":{"type":"number","format":"double","description":"Сколько по этой строке уже принято — сумма по событиям приемки.","example":4.0},"sku":{"type":["string","null"],"description":"`variant_code` варианта — тот же артикул, что отдает `/products`."},"tax_rate":{"type":["number","null"],"format":"double","description":"Ставка НДС в процентах; `null` и ноль означают «налога нет».","example":20.0},"title":{"type":"string"}}},"PurchaseOrderItemWriteRequest":{"type":"object","description":"Строка заказа в запросе на запись. Публичный контракт: идентификаторы\nплоские и числовые, вложенных сущностей нет — интеграции незачем собирать\nвнутренний `ItemVariantDto` целиком, чтобы завести строку.","required":["item_variant_id","quantity","price"],"properties":{"batch_number":{"type":["string","null"],"description":"Номер партии — заполняется, когда товар учитывается партиями."},"expected_date":{"type":["string","null"],"format":"date-time","description":"Ожидаемая дата поставки строки. Не прислали — дата заказа\n(`expected_date`). Дата заказа в ответе — самая поздняя из дат строк."},"expiry_date":{"type":["string","null"],"format":"date"},"item_variant_id":{"type":"integer","format":"int64"},"price":{"type":"number","format":"double","description":"Цена за единицу без НДС.","example":1200.0},"quantity":{"type":"number","format":"double","example":10.0},"tax_rate":{"type":["number","null"],"format":"double","description":"Ставка НДС в процентах; отсутствие поля и ноль означают «налога нет».","example":20.0}}},"PurchaseOrderListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PurchaseOrderDto"}},"next_cursor":{"type":["string","null"]}}},"PurchaseOrderReceiptDto":{"type":"object","required":["id","received_at","items"],"properties":{"id":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PurchaseOrderReceiptItemDto"}},"received_at":{"type":"string","format":"date-time"},"storage_place_id":{"type":["string","null"],"description":"Склад, на который принят товар; `null` — приемка без указания места."}}},"PurchaseOrderReceiptItemDto":{"type":"object","required":["id","purchase_order_item_id","item_id","item_variant_id","title","quantity"],"properties":{"batch_number":{"type":["string","null"]},"expiry_date":{"type":["string","null"],"format":"date"},"id":{"type":"string"},"item_id":{"type":"string"},"item_variant_id":{"type":"string"},"purchase_order_item_id":{"type":"string","description":"Строка заказа, к которой относится приемка."},"quantity":{"type":"number","format":"double","example":10.0},"sku":{"type":["string","null"]},"title":{"type":"string"}}},"PurchaseOrderReceiptListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PurchaseOrderReceiptDto"}}}},"PurchaseOrderSupplierDto":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"id поставщика (строкой — на случай миграции на uuid в v2)."},"inn":{"type":["string","null"],"example":"7701234567"},"name":{"type":["string","null"]}}},"PurchaseReceiptCreateRequest":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PurchaseReceiptItemRequest"}},"storage_place_id":{"type":["integer","null"],"format":"int64","description":"Склад, на который приходуется товар. Не прислали — склад по умолчанию,\nкак в интерфейсе."}}},"PurchaseReceiptCreatedResponse":{"type":"object","description":"Ответ на оформление прихода: и само событие приемки, и карточка заказа\nпосле него. Второе здесь не украшение: агенту нужно увидеть, сколько\nосталось принять и закрылся ли заказ, а без этого он пошел бы за тем же\nвторым запросом.","required":["receipt","order"],"properties":{"order":{"$ref":"#/components/schemas/PurchaseOrderDetailResponse"},"receipt":{"$ref":"#/components/schemas/PurchaseOrderReceiptDto"}}},"PurchaseReceiptItemRequest":{"type":"object","description":"Строка прихода: сколько принято по конкретной строке заказа.","required":["purchase_order_item_id","quantity"],"properties":{"batch_number":{"type":["string","null"]},"expiry_date":{"type":["string","null"],"format":"date"},"purchase_order_item_id":{"type":"integer","format":"int64","description":"`items[].id` из карточки заказа, а не идентификатор товара."},"quantity":{"type":"number","format":"double","example":10.0}}},"RecipeDto":{"type":"object","required":["id","item_id","item_title","materials","operations"],"properties":{"id":{"type":"string"},"item_id":{"type":"string","description":"Изделие, для которого написана спецификация."},"item_title":{"type":"string","example":"Табурет дубовый"},"item_variant_id":{"type":["string","null"],"description":"Вариант изделия; `null` — спецификация написана на изделие целиком и\nдействует для всех его вариантов."},"item_variant_title":{"type":["string","null"],"example":"Табурет дубовый, белый"},"materials":{"type":"array","items":{"$ref":"#/components/schemas/RecipeMaterialDto"},"description":"Состав материалов на одну единицу изделия."},"operations":{"type":"array","items":{"$ref":"#/components/schemas/RecipeOperationDto"},"description":"Технология: операции изделия по порядку — только операции,\nприменимые к варианту этой спецификации."},"sku":{"type":["string","null"]}}},"RecipeListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RecipeDto"}},"next_cursor":{"type":["string","null"]}}},"RecipeMaterialDto":{"type":"object","required":["id","item_id","item_variant_id","title","quantity"],"properties":{"id":{"type":"string"},"item_id":{"type":"string"},"item_variant_id":{"type":"string"},"notes":{"type":["string","null"]},"quantity":{"type":"number","format":"double","description":"Расход на одну единицу изделия.","example":10.0},"sku":{"type":["string","null"],"description":"`variant_code` варианта материала — тот же артикул, что отдает `/products`."},"title":{"type":"string"}}},"RecipeOperationDto":{"type":"object","required":["id","operation_id","operation_title","position","duration","cost_per_hour"],"properties":{"cost_per_hour":{"type":"number","format":"double","example":900.0},"duration":{"type":"number","format":"double","description":"Норма времени на единицу изделия, в единицах операции (обычно часы).","example":0.5},"id":{"type":"string"},"notes":{"type":["string","null"]},"operation_id":{"type":"string","description":"Операция из справочника `/operations`."},"operation_title":{"type":"string","example":"Сборка"},"operation_type":{"type":["string","null"],"description":"Вид операции; `null`, если не заполнен."},"position":{"type":"integer","format":"int32","description":"Порядок операции в технологии."}}},"RegistrationAbuseCountersDto":{"type":"object","required":["rateLimit","honeypot","automationUserAgent","other","maxMaskedNetworkVelocity"],"properties":{"automationUserAgent":{"type":"integer","format":"int64"},"honeypot":{"type":"integer","format":"int64"},"maxMaskedNetworkVelocity":{"type":"integer","format":"int64","description":"Максимум отклоненных попыток из одной маскированной сети в настроенном\nокне скорости регистраций."},"other":{"type":"integer","format":"int64"},"rateLimit":{"type":"integer","format":"int64"}}},"RegistrationActivationComparisonDto":{"type":"object","required":["days","current","baseline"],"properties":{"baseline":{"$ref":"#/components/schemas/RegistrationActivationWindowDto"},"current":{"$ref":"#/components/schemas/RegistrationActivationWindowDto"},"days":{"type":"integer","format":"int32","minimum":0}}},"RegistrationActivationCountersDto":{"type":"object","description":"Судьба внешней регистрации, без идентификаторов учетной записи.\n\nСамоназначенный признак внутренней регистрации доверенным не считается и из\nсреза не исключается: исключаются только регистрации, проверенные сервером.","required":["externalRegistrations","ssoCompleted","welcomeCompleted","firstUsefulAction","withoutUsefulAction"],"properties":{"externalRegistrations":{"type":"integer","format":"int64"},"firstUsefulAction":{"type":"integer","format":"int64"},"ssoCompleted":{"type":"integer","format":"int64"},"welcomeCompleted":{"type":"integer","format":"int64"},"withoutUsefulAction":{"type":"integer","format":"int64"}}},"RegistrationActivationWindowDto":{"type":"object","required":["windowStart","windowEnd","totals"],"properties":{"totals":{"$ref":"#/components/schemas/RegistrationActivationCountersDto"},"windowEnd":{"type":"string","format":"date-time"},"windowStart":{"type":"string","format":"date-time"}}},"RegistrationRequestOutcomeCountersDto":{"type":"object","description":"Фактические HTTP-исходы `POST /api/registration`, записываемые с момента\nвыкладки ZOL-12312. В счетчиках нет данных запроса или пользователя.","required":["success","serverError","rateLimit"],"properties":{"rateLimit":{"type":"integer","format":"int64"},"serverError":{"type":"integer","format":"int64"},"success":{"type":"integer","format":"int64"}}},"RegistrationTelemetryCountersDto":{"type":"object","description":"Счетчики регистраций по корзинам.\n\n`internal_verified` — внутренние регистрации, подтвержденные сервером;\nв проверки на злоупотребление они не попадают. `internal_claimed` — те, что\nназвались внутренними сами, поэтому считаются наравне с внешними и входят в\n`probable_automation` и `product`.\n\nСумма сходится так: `raw = internal_verified + probable_automation +\nproduct`, а `internal_claimed` — сквозной срез внутри двух последних корзин.","required":["raw","internalVerified","internalClaimed","probableAutomation","product"],"properties":{"internalClaimed":{"type":"integer","format":"int64"},"internalVerified":{"type":"integer","format":"int64"},"probableAutomation":{"type":"integer","format":"int64"},"product":{"type":"integer","format":"int64"},"raw":{"type":"integer","format":"int64"}}},"SalesOrderCompleteRequest":{"type":"object","description":"Тело закрытия заказа — пустое.\n\nТип объявлен ради того же, ради чего он объявлен у производственного\nзадания: описать в спецификации, что полей нет, и отвергнуть присланный\nвместо объекта мусор. Присланные поля не читаются — именно это защищает\nстроки заказа от частичного тела (класс ZOL-845)."},"SalesOrderCreateRequest":{"type":"object","required":["customer_id","items"],"properties":{"created_date":{"type":["string","null"],"format":"date-time","description":"Дата документа. Не прислали — «сейчас»."},"currency":{"type":["string","null"]},"customer_id":{"type":"integer","format":"int64"},"customer_reference":{"type":["string","null"],"description":"«Доп. № заказа клиента», до 255 символов. Пробелы по краям\nотрезаются; пустая строка значит «номера нет».","example":"PO-58"},"delivery_date":{"type":["string","null"],"format":"date-time"},"items":{"type":"array","items":{"$ref":"#/components/schemas/SalesOrderItemWriteRequest"},"description":"Хотя бы одна строка. Заказ без строк не документ, а заготовка: завести\nего извне и оставить пустым значит положить в учет бумагу без товара."},"notes":{"type":["string","null"]},"number":{"type":["string","null"],"description":"Номер документа. Не прислали — система выдает следующий сама, тем же\nсчетчиком, что и интерфейс."},"priority":{"type":["integer","null"],"format":"int32"},"shipping_fee":{"oneOf":[{"$ref":"#/components/schemas/SalesOrderShippingFeeDto","description":"Доставка заказа. Не прислали — заказ без доставки."},{"type":"null"}]}}},"SalesOrderCustomerDto":{"type":"object","required":["id"],"properties":{"country_code":{"type":["string","null"],"example":"RU"},"id":{"type":"string","description":"id контрагента (строкой — на случай миграции на uuid в v2)."},"title":{"type":["string","null"]}}},"SalesOrderDetailResponse":{"allOf":[{"$ref":"#/components/schemas/SalesOrderDto"},{"type":"object","required":["items","fulfillments"],"properties":{"fulfillments":{"type":"array","items":{"$ref":"#/components/schemas/SalesOrderFulfillmentDto"},"description":"Действующие исполнения заказа: упаковки (`PACKED`) и отгрузки\n(`DELIVERED`). Снятые исполнения сюда не входят. Чтобы отгрузить\nконкретную упаковку, передайте ее `id` в `fulfillment_id` ручки `/ship`."},"items":{"type":"array","items":{"$ref":"#/components/schemas/SalesOrderItemDto"}}}}]},"SalesOrderDto":{"type":"object","required":["id","number","status","delivery_status","customer","created_date","priority","total_amount","tax_amount","total_amount_with_tax"],"properties":{"created_date":{"type":"string","format":"date-time"},"currency":{"type":["string","null"]},"customer":{"$ref":"#/components/schemas/SalesOrderCustomerDto"},"customer_reference":{"type":["string","null"],"description":"«Доп. № заказа клиента» — номер заказа в системе покупателя\n(Katana `Customer reference #`). Поле есть всегда; номера нет — `null`.","example":"PO-58"},"delivery_date":{"type":["string","null"],"format":"date-time"},"delivery_status":{"type":"string","description":"Отгрузка: `NOT_SHIPPED` | `PACKED` | `PARTIALLY_PACKED` |\n`PARTIALLY_SHIPPED` | `SHIPPED`.","example":"NOT_SHIPPED"},"id":{"type":"string"},"notes":{"type":["string","null"]},"number":{"type":"string","description":"Человекочитаемый номер документа, например `SO-1001`."},"priority":{"type":"integer","format":"int32"},"shipped_at":{"type":["string","null"],"format":"date-time"},"shipping_fee":{"oneOf":[{"$ref":"#/components/schemas/SalesOrderShippingFeeDto","description":"Доставка заказа: описание, стоимость без НДС и ставка НДС. Доставки\nнет — `null`."},{"type":"null"}]},"status":{"type":"string","description":"`OPEN` — заказ открыт, `DONE` — отгружен и закрыт.","example":"OPEN"},"tax_amount":{"type":"number","format":"double","description":"НДС документа: уже округленные по строкам величины плюс НДС доставки.","example":2600.0},"total_amount":{"type":"number","format":"double","description":"Сумма без НДС: позиции и стоимость доставки.","example":13000.0},"total_amount_with_tax":{"type":"number","format":"double","description":"Итого с НДС, позиции и доставка. Равно «Итого» в карточке заказа.","example":15600.0}}},"SalesOrderFulfillmentDto":{"type":"object","description":"Исполнение заказа: упаковка или отгрузка части строк.\n\nТовар списывается со склада один раз — при упаковке или при прямой\nотгрузке. Отгрузка упакованного исполнения склад повторно не уменьшает.","required":["id","status","items"],"properties":{"delivered_at":{"type":["string","null"],"format":"date-time"},"id":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/SalesOrderFulfillmentItemDto"}},"packed_at":{"type":["string","null"],"format":"date-time"},"status":{"type":"string","description":"`PACKED` — упаковано и уже списано со склада, ждет отгрузки.\n`DELIVERED` — отгружено.","example":"PACKED"}}},"SalesOrderFulfillmentItemDto":{"type":"object","description":"Строка исполнения: сколько из строки заказа вошло в это исполнение.","required":["sales_order_item_id","quantity"],"properties":{"quantity":{"type":"number","format":"double","example":4.0},"sales_order_item_id":{"type":"string","description":"`items[].id` строки заказа."}}},"SalesOrderItemDto":{"type":"object","required":["id","item_id","item_variant_id","title","quantity","price","discount_pct","line_amount","line_tax_amount","line_amount_with_tax"],"properties":{"discount_pct":{"type":"number","format":"double","description":"Скидка строки в процентах, от 0 до 100.","example":0.0},"id":{"type":"string"},"item_id":{"type":"string"},"item_variant_id":{"type":"string"},"line_amount":{"type":"number","format":"double","description":"Сумма строки без НДС по цене со скидкой: цена со скидкой округляется\nдо копеек и умножается на количество.","example":12000.0},"line_amount_with_tax":{"type":"number","format":"double","example":14400.0},"line_tax_amount":{"type":"number","format":"double","example":2400.0},"price":{"type":"number","format":"double","description":"Цена за единицу без НДС и без скидки строки.","example":1200.0},"quantity":{"type":"number","format":"double","example":10.0},"sku":{"type":["string","null"],"description":"`variant_code` варианта — тот же артикул, что отдает `/products`."},"storage_place_id":{"type":["string","null"]},"tax_rate":{"type":["number","null"],"format":"double","description":"Ставка НДС в процентах; `null` и ноль означают «налога нет».","example":20.0},"title":{"type":"string"}}},"SalesOrderItemWriteRequest":{"type":"object","description":"Строка заказа в запросе на запись. Публичный контракт: идентификаторы\nплоские и числовые, вложенных сущностей нет — интеграции незачем собирать\nвнутренний `ItemVariantDto` целиком, чтобы завести строку.","required":["item_variant_id","quantity","price"],"properties":{"discount_pct":{"type":["number","null"],"format":"double","description":"Скидка строки в процентах, от 0 до 100; отсутствие поля означает ноль.","example":0.0},"item_variant_id":{"type":"integer","format":"int64"},"price":{"type":"number","format":"double","description":"Цена за единицу без НДС и без скидки строки.","example":1200.0},"quantity":{"type":"number","format":"double","example":10.0},"storage_place_id":{"type":["integer","null"],"format":"int64","description":"Склад отгрузки строки, номер из `GET /storage-places`. Не прислали —\nстроке ставится склад продаж по умолчанию: склад из настроек продаж, а\nесли он не задан — склад с отметкой «по умолчанию», затем склад с\nнаименьшим номером. У строки заказа склад есть всегда."},"tax_rate":{"type":["number","null"],"format":"double","description":"Ставка НДС в процентах; отсутствие поля и ноль означают «налога нет».","example":20.0}}},"SalesOrderListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SalesOrderDto"}},"next_cursor":{"type":["string","null"]}}},"SalesOrderSerialAssignmentRequest":{"type":"object","description":"Серийные номера на строку. Обязательны для строки с посерийным учетом при\n`event_type = DELIVERED`; число номеров обязано совпадать с `quantity` той\nже строки. Для строк без посерийного учета поле не читается.","required":["sales_order_item_id"],"properties":{"sales_order_item_id":{"type":"integer","format":"int64"},"serial_ids":{"type":"array","items":{"type":"integer","format":"int64"}}}},"SalesOrderShipItemRequest":{"type":"object","description":"Строка построчной отгрузки: что и сколько уходит этим событием.\n\nИдентификатор здесь — `id` **строки заказа** (`items[].id` из карточки), а\nне варианта товара: одна и та же позиция может стоять в заказе дважды с\nразных складов, и отгрузка адресуется строке.","required":["sales_order_item_id","quantity"],"properties":{"quantity":{"type":"number","format":"double","description":"Сколько отгружается этим событием. Не больше неотгруженного остатка\nстроки — иначе `422`.","example":3.0},"sales_order_item_id":{"type":"integer","format":"int64"}}},"SalesOrderShipRequest":{"type":"object","description":"Тело построчной отгрузки.","properties":{"event_type":{"type":"string","description":"`PACKED` — позиции упакованы: создается исполнение, и товар сразу\nсписывается со склада (как в Katana). `DELIVERED` —\nотгрузка: с `fulfillment_id` отгружается эта упаковка целиком без\nнового списания; без него отгружается еще не исполненное количество\nстрок, и товар списывается в момент отгрузки. Не прислали —\n`DELIVERED`.","example":"DELIVERED"},"fulfillment_id":{"type":["integer","null"],"format":"int64","description":"Упаковка, которую нужно отгрузить (`fulfillments[].id` из карточки\nзаказа). Только с `event_type = DELIVERED`; `items` и\n`serial_assignments` тогда не передаются — строки, партии, ячейки и\nномера берутся из самой упаковки."},"items":{"type":"array","items":{"$ref":"#/components/schemas/SalesOrderShipItemRequest"},"description":"Хотя бы одна строка, если не передан `fulfillment_id`."},"serial_assignments":{"type":"array","items":{"$ref":"#/components/schemas/SalesOrderSerialAssignmentRequest"}},"storage_place_id":{"type":["integer","null"],"format":"int64","description":"Склад, с которого уходит товар. Не прислали — берется склад строки, а\nпри пустой строке — склад по умолчанию, как в интерфейсе."}}},"SalesOrderShippingFeeDto":{"type":"object","description":"ZOL-17372: доставка заказа, как Shipping fee у Katana. Одна на заказ,\nсчитается строкой из одной единицы: скидка позиций на нее не действует,\nНДС округляется до копеек так же, как у строки. Доставка входит во все три\nсуммы заказа: `total_amount`, `tax_amount` и `total_amount_with_tax`.","properties":{"description":{"type":["string","null"],"description":"Описание доставки, например «Курьерская доставка».","example":"Курьерская доставка"},"price":{"type":["number","null"],"format":"double","description":"Стоимость доставки без НДС, не меньше нуля.","example":1000.0},"tax_rate":{"type":["number","null"],"format":"double","description":"Ставка НДС доставки в процентах, от 0 до 100; `null` и ноль означают\n«налога нет».","example":20.0}}},"SalesOrderUpdateRequest":{"type":"object","description":"Частичное изменение заказа. Присланное поле заменяет значение,\nотсутствующее — сохраняется как есть.\n\nСнять уже заполненное поле этой ручкой нельзя: `null` и отсутствие поля\nозначают здесь одно и то же — «не трогать».","properties":{"currency":{"type":["string","null"]},"customer_id":{"type":["integer","null"],"format":"int64"},"customer_reference":{"type":["string","null"],"description":"«Доп. № заказа клиента», до 255 символов. Пробелы по краям\nотрезаются. Пустая строка стирает номер — то же значение, что и пустое\nполе в карточке заказа; `null` и отсутствие поля его не трогают.","example":"PO-58"},"delivery_date":{"type":["string","null"],"format":"date-time"},"items":{"type":["array","null"],"items":{"$ref":"#/components/schemas/SalesOrderItemWriteRequest"},"description":"Прислали `items` — набор строк заказа заменяется присланным целиком:\nстроки, которых в нем нет, из заказа удаляются. Не прислали — строки не\nтрогаются вовсе."},"notes":{"type":["string","null"]},"priority":{"type":["integer","null"],"format":"int32"},"shipping_fee":{"oneOf":[{"$ref":"#/components/schemas/SalesOrderShippingFeeDto","description":"Доставка заказа. Присланный объект заменяет доставку целиком; объект,\nгде `price`, `description` и `tax_rate` пусты, снимает доставку.\n`null` и отсутствие поля доставку не трогают."},{"type":"null"}]}}},"SalesReturnCreateRequest":{"type":"object","required":["items"],"properties":{"customer_id":{"type":["integer","null"],"format":"int64","description":"Покупатель возврата без заказа. У возврата от заказа берется из заказа."},"date":{"type":["string","null"],"format":"date-time","description":"Дата документа. Не прислана — текущий момент."},"external_return_ref":{"type":["string","null"],"description":"Номер возврата в системе клиента: маркетплейс, магазин, транспортная.","example":"OZON-RET-88213"},"items":{"type":"array","items":{"$ref":"#/components/schemas/SalesReturnItemWriteRequest"}},"notes":{"type":["string","null"],"description":"Заметка документа.","example":"Возврат по заявке покупателя"},"number":{"type":["string","null"],"description":"Номер документа. Не прислан — выдается тем же счетчиком, что и в\nинтерфейсе.","example":"В-4"},"refund_amount":{"type":["number","null"],"format":"double","example":432.0},"sales_order_id":{"type":["integer","null"],"format":"int64","description":"Заказ покупателя, товар по которому едет назад. Без него оформляется\nвозврат без заказа, и тогда нужен `customer_id`."},"source_type":{"type":["string","null"],"description":"Откуда пришел возврат. Не прислан — `SALES_ORDER` при заданном\n`sales_order_id` и `MANUAL` без него.","example":"SALES_ORDER"},"storage_place_id":{"type":["integer","null"],"format":"int64","description":"Место хранения приемки для всего документа."},"tracking_info":{"type":["string","null"],"example":"Трек СДЭК 1234567890"}}},"SalesReturnDetailResponse":{"type":"object","required":["sales_return","items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SalesReturnItemDto"}},"sales_return":{"$ref":"#/components/schemas/SalesReturnDto"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/SalesReturnWarning"},"description":"Предупреждения к запросу, который выполнен, но часть присланного\nпроигнорирована. Пустой список не передается."}}},"SalesReturnDto":{"type":"object","required":["id","number","status","source_type","created_date"],"properties":{"cancellation_reason":{"type":["string","null"],"description":"Причина, по которой возврат не состоялся. Заполнена у `CANCELLED`.","example":"Покупатель товар не привез"},"created_date":{"type":"string","format":"date-time"},"customer_id":{"type":["string","null"]},"external_return_ref":{"type":["string","null"],"description":"Номер возврата в системе клиента: маркетплейс, магазин, транспортная.","example":"OZON-RET-88213"},"id":{"type":"string"},"notes":{"type":["string","null"],"description":"Заметка документа.","example":"Возврат по заявке покупателя"},"number":{"type":"string","description":"Человекочитаемый номер документа, например `В-4`.","example":"В-4"},"refund_amount":{"type":["number","null"],"format":"double","description":"Сколько денег возвращено покупателю.","example":432.0},"return_date":{"type":["string","null"],"format":"date-time","description":"Момент приемки на склад. Заполнен ровно у статуса `RETURNED`."},"sales_order_id":{"type":["string","null"],"description":"Заказ покупателя, по которому оформлен возврат. `null` у возврата без\nзаказа."},"sales_order_number":{"type":["string","null"],"description":"Номер того же заказа — чтобы не читать его карточку отдельным запросом.","example":"ЗК-1"},"source_type":{"type":"string","description":"Откуда пришел возврат: `SALES_ORDER` | `MANUAL` | `MARKETPLACE_PVZ` |\n`RETAIL`.","example":"SALES_ORDER"},"status":{"type":"string","description":"`NOT_RETURNED` — оформлен, товар еще не принят; `RETURNED` — товар у\nнас, склад не менялся; `RESTOCKED` — оприходован на склад;\n`CANCELLED` — возврат не состоялся.","example":"NOT_RETURNED"},"storage_place_id":{"type":["string","null"],"description":"Место хранения приемки из шапки документа."},"tracking_info":{"type":["string","null"],"example":"Трек СДЭК 1234567890"}}},"SalesReturnItemDto":{"type":"object","required":["id","item_variant_id","title","quantity","unit_price","quarantine"],"properties":{"batch_id":{"type":["string","null"],"description":"Партия, в которую принят товар. `null`, если партионный учет выключен."},"id":{"type":"string"},"item_variant_id":{"type":"string"},"quantity":{"type":"number","format":"double","example":2.0},"quarantine":{"type":"boolean","description":"**Устарело**: карантина в учете больше нет, всегда\n`false`. Удаляется в следующей версии API.","deprecated":true},"reason":{"type":["string","null"],"description":"Имя причины возврата из справочника. ZOL-12811: поле вычисляемое —\nзначение берется по `reason_id`, `null` означает «причина не выбрана».\nСвободный текст, который был в этом поле до справочника, переехал\nв `reason_note` и виден там дословно.","example":"Брак или повреждение"},"reason_id":{"type":["integer","null"],"format":"int32","description":"ZOL-12811: значение справочника причин, `GET /sales-return-reasons`.","example":2},"reason_note":{"type":["string","null"],"description":"ZOL-12811: свободное уточнение к причине, до 500 символов.","example":"на корпусе скол, упаковка вскрыта"},"sales_order_item_id":{"type":["string","null"],"description":"Строка исходного заказа. `null` у возврата без заказа."},"sku":{"type":["string","null"],"description":"`variant_code` варианта — тот же артикул, что отдает `/products`.","example":"ITM-4155"},"storage_place_id":{"type":["string","null"],"description":"Место хранения приемки этой строки. `null` — берется из шапки."},"title":{"type":"string","example":"Демо: ткань лен"},"unit_price":{"type":"number","format":"double","description":"Цена строки без налога — по ней считается сумма возврата.","example":120.0}}},"SalesReturnItemWriteRequest":{"type":"object","required":["quantity"],"properties":{"batch_id":{"type":["integer","null"],"format":"int64","description":"Партия, в которую принять товар. Без нее партия подбирается учетом."},"item_variant_id":{"type":["integer","null"],"format":"int64","description":"Вариант товара. У возврата от заказа можно не присылать: он берется из\nстроки заказа."},"quantity":{"type":"number","format":"double","example":2.0},"quarantine":{"type":"boolean","description":"**Устарело**: карантина в учете больше нет. Принимается и\nигнорируется; `true` дает предупреждение в `warnings` ответа.\nУдаляется в следующей версии API.","deprecated":true},"reason":{"type":["string","null"],"description":"Причина возврата строки свободным текстом. **Устарело на запись**\n(ZOL-12811): присылайте `reason_id`. Строка продолжает приниматься —\nтекст кладется в `reason_note`, а причиной ставится «Другое»\n(`reason_id = 7`). Если пришли оба поля, выигрывает `reason_id`,\nстрока игнорируется.","deprecated":true,"example":"Не подошел размер"},"reason_id":{"type":["integer","null"],"format":"int32","description":"ZOL-12811: значение справочника причин возврата. Обязательно у возврата\nбез заказа. Список значений — `GET /sales-return-reasons`.","example":2},"reason_note":{"type":["string","null"],"description":"ZOL-12811: свободное уточнение к причине, до 500 символов. Без\nвыбранной причины уточнение не сохраняется.","example":"на корпусе скол, упаковка вскрыта"},"sales_order_item_id":{"type":["integer","null"],"format":"int64","description":"Строка исходного заказа — `items[].id` из карточки заказа. Обязательна\nу возврата от заказа и запрещена у возврата без заказа."},"storage_place_id":{"type":["integer","null"],"format":"int64","description":"Место хранения приемки строки. Не прислано — берется из шапки."},"unit_price":{"type":["number","null"],"format":"double","description":"Цена строки без налога. Не прислана — берется цена строки заказа.","example":120.0}}},"SalesReturnListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SalesReturnDto"}},"next_cursor":{"type":["string","null"],"description":"Курсор следующей страницы. `null` — страница последняя."}}},"SalesReturnReasonDto":{"type":"object","description":"ZOL-12811: значение системного справочника причин возврата.\n\nПаритет с эталонной ручкой Katana `GET /sales_returns/return_reasons`:\nнаружу отдается только чтение, ручек записи в справочник нет.","required":["id","name"],"properties":{"id":{"type":"integer","format":"int32","description":"Номер значения. Он же уходит в `items[].reason_id` при записи.","example":2},"name":{"type":"string","example":"Брак или повреждение"}}},"SalesReturnReasonListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SalesReturnReasonDto"}}}},"SalesReturnReceiveRequest":{"type":"object","description":"Тело приемки возврата на склад. Полей у него нет: что и сколько принимать,\nручка берет из строк самого документа."},"SalesReturnWarning":{"type":"object","description":"Предупреждение к выполненному запросу.","required":["code","message"],"properties":{"code":{"type":"string","description":"Машинный код, например `sales_return_quarantine_ignored`.","example":"sales_return_quarantine_ignored"},"message":{"type":"string","description":"Объяснение по-русски."}}},"SalesSummaryResponse":{"type":"object","required":["data","totals","from","to","group_by","total","truncated"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SalesSummaryRowDto"}},"from":{"type":"string","example":"2026-01-01"},"group_by":{"type":"string","description":"`total`, `day`, `week` или `month` — нарезка, которой посчитан срез.","example":"month"},"to":{"type":"string","example":"2026-12-31"},"total":{"type":"integer","format":"int64","description":"Строк в срезе всего, до обрезки по `limit`."},"totals":{"$ref":"#/components/schemas/SalesSummaryTotalsDto","description":"Итог по всему срезу. Считается до обрезки по `limit`, поэтому остается\nверным и в усеченном ответе."},"truncated":{"type":"boolean","description":"`true` — показаны не все строки, сузьте выборку фильтрами."}}},"SalesSummaryRowDto":{"type":"object","required":["period_start","period_end","item_id","item_name","quantity","revenue","cogs","profit","returned_quantity","returned_revenue"],"properties":{"cogs":{"type":"number","format":"double","description":"Себестоимость проданного.","example":91200.0},"item_id":{"type":"string","description":"Номер товара. Варианты одного товара сложены в одну строку — тот же\nразрез, что на вкладке «Аналитика - Продажи - Товары».","example":"4891"},"item_name":{"type":"string","example":"Платье льняное"},"period_end":{"type":"string","description":"Последний день периода строки, включительно.","example":"2026-08-31"},"period_start":{"type":"string","description":"Первый день периода строки. При `group_by=total` — начало запроса.","example":"2026-08-01"},"profit":{"type":"number","format":"double","description":"`revenue` минус `cogs`.","example":63506.0},"quantity":{"type":"number","format":"double","description":"Отгружено за вычетом возвращенного.","example":18.0},"returned_quantity":{"type":"number","format":"double","description":"Сколько единиц вернули в этом периоде. Уже вычтено из `quantity`.","example":2.0},"returned_revenue":{"type":"number","format":"double","description":"На какую сумму вернули. Уже вычтено из `revenue`.","example":9600.0},"revenue":{"type":"number","format":"double","description":"Выручка за вычетом возвращенной.","example":154706.0}}},"SalesSummaryTotalsDto":{"type":"object","required":["quantity","revenue","cogs","profit","returned_quantity","returned_revenue"],"properties":{"cogs":{"type":"number","format":"double","example":91200.0},"profit":{"type":"number","format":"double","example":63506.0},"quantity":{"type":"number","format":"double","example":18.0},"returned_quantity":{"type":"number","format":"double","example":2.0},"returned_revenue":{"type":"number","format":"double","example":9600.0},"revenue":{"type":"number","format":"double","example":154706.0}}},"SecurityTelemetryBaselineDto":{"type":"object","required":["windowStart","windowEnd","days","totals"],"properties":{"days":{"type":"integer","format":"int32","minimum":0},"totals":{"$ref":"#/components/schemas/SecurityTelemetryCountersDto"},"windowEnd":{"type":"string","format":"date-time"},"windowStart":{"type":"string","format":"date-time"}}},"SecurityTelemetryCountersDto":{"type":"object","required":["registrations","registrationRequestOutcomes","registrationAbuseRejected","maxRegistrationsPerMinute","maxMaskedNetworkVelocity","asnCoverageAvailable","maxAsnRegistrationsPerMinute","distinctAsnCount","asnCoveredRegistrations","asnUnavailableRegistrations","userAgentCategories","smtpOutcomes","passwordRecoveryOutcomes","emailSignals","duplicateProfiles","alertsTriggered","registrationObservabilityAlertsTriggered","alerts"],"properties":{"alerts":{"type":"array","items":{"$ref":"#/components/schemas/TriggeredAlertDto"},"description":"Перечень сработавших оповещений окна, обоих видов сразу, по возрастанию\nвремени. Список ограничен сверху, поэтому источником числа остаются\nсчетчики выше, а не длина этого перечня."},"alertsTriggered":{"type":"integer","format":"int64","description":"Оповещения о вероятной автоматизации успешных регистраций."},"asnCoverageAvailable":{"type":"boolean","description":"`false` означает и «покрытие ASN не сработало», и «регистраций в окне\nне было». ZOL-11681: чтобы развести эти случаи, смотри пару счетчиков\nниже: их сумма равна числу регистраций окна."},"asnCoveredRegistrations":{"type":"integer","format":"int64","description":"Регистрации окна, у которых ASN определился."},"asnUnavailableRegistrations":{"type":"integer","format":"int64","description":"Регистрации окна, у которых ASN не определился (пробел покрытия)."},"distinctAsnCount":{"type":"integer","format":"int64"},"duplicateProfiles":{"$ref":"#/components/schemas/DuplicateProfileCountersDto"},"emailSignals":{"$ref":"#/components/schemas/EmailSignalCountersDto"},"maxAsnRegistrationsPerMinute":{"type":"integer","format":"int64"},"maxMaskedNetworkVelocity":{"type":"integer","format":"int64"},"maxRegistrationsPerMinute":{"type":"integer","format":"int64"},"passwordRecoveryOutcomes":{"$ref":"#/components/schemas/PasswordRecoveryOutcomeCountersDto"},"registrationAbuseRejected":{"$ref":"#/components/schemas/RegistrationAbuseCountersDto"},"registrationObservabilityAlertsTriggered":{"type":"integer","format":"int64","description":"Оповещения о серверных отказах, `429` и росте защитных отклонений."},"registrationRequestOutcomes":{"$ref":"#/components/schemas/RegistrationRequestOutcomeCountersDto"},"registrations":{"$ref":"#/components/schemas/RegistrationTelemetryCountersDto"},"smtpOutcomes":{"$ref":"#/components/schemas/SmtpOutcomeCountersDto"},"userAgentCategories":{"$ref":"#/components/schemas/UserAgentCategoryCountersDto"}}},"SecurityTelemetryResponseDto":{"type":"object","required":["windowStart","windowEnd","disposableEmailDatasetVersion","current","baseline","registrationActivation"],"properties":{"baseline":{"$ref":"#/components/schemas/SecurityTelemetryBaselineDto"},"current":{"$ref":"#/components/schemas/SecurityTelemetryCountersDto"},"disposableEmailDatasetVersion":{"type":"string","example":"2026-07-23"},"registrationActivation":{"$ref":"#/components/schemas/RegistrationActivationComparisonDto"},"windowEnd":{"type":"string","format":"date-time"},"windowStart":{"type":"string","format":"date-time"}}},"SmtpOutcomeCountersDto":{"type":"object","required":["sent","failed"],"properties":{"failed":{"type":"integer","format":"int64"},"sent":{"type":"integer","format":"int64"}}},"StockAdjustmentCreateRequest":{"type":"object","required":["title","items"],"properties":{"additional_info":{"type":["string","null"],"example":"<p>Акт сверки от 14.11</p>"},"date":{"type":["string","null"],"format":"date-time","description":"Дата документа. Не указана — текущий момент. Дата в закрытом учетном\nпериоде и дата в будущем отвергаются с `422`."},"items":{"type":"array","items":{"$ref":"#/components/schemas/StockAdjustmentLineRequest"}},"reason":{"type":["string","null"]},"storage_place_id":{"type":["integer","null"],"format":"int64","description":"Место хранения корректировки. Все строки документа относятся к одному\nскладу: если поле задано, строки без `storage_place_id` наследуют его,\nа строки с другим `storage_place_id` отвергаются с `422`."},"title":{"type":"string"}}},"StockAdjustmentCreatedResponse":{"type":"object","required":["adjustment","items"],"properties":{"adjustment":{"$ref":"#/components/schemas/StockAdjustmentDto"},"items":{"type":"array","items":{"$ref":"#/components/schemas/StockAdjustmentLineDto"}}}},"StockAdjustmentDto":{"type":"object","required":["id","title","date","additional_info"],"properties":{"additional_info":{"type":"string","example":"<p>Акт сверки от 14.11</p>"},"date":{"type":"string","format":"date-time"},"id":{"type":"string"},"reason":{"type":["string","null"]},"storage_place_id":{"type":["string","null"]},"title":{"type":"string"}}},"StockAdjustmentLineDto":{"type":"object","required":["item_variant_id","quantity_delta","amount_after"],"properties":{"amount_after":{"type":"number","format":"double","description":"Остаток на этом месте хранения после применения корректировки — чтобы\nагенту не приходилось перечитывать `/stock` ради проверки.","example":30.0},"item_variant_id":{"type":"string"},"quantity_delta":{"type":"number","format":"double","example":5.0},"storage_place_id":{"type":["string","null"]}}},"StockAdjustmentLineRequest":{"type":"object","description":"Строка запроса: на сколько изменить остаток варианта в месте хранения.","required":["item_variant_id","quantity_delta"],"properties":{"item_variant_id":{"type":"integer","format":"int64"},"quantity_delta":{"type":"number","format":"double","description":"Знаковая величина: недостача отрицательна, излишек положителен. Ноль\nотвергается — корректировка на ноль ничего не корректирует.","example":5.0},"storage_place_id":{"type":["integer","null"],"format":"int64","description":"Не указано — берется место хранения клиента по умолчанию, ровно как у\nприхода по заказу поставщику без явного склада."}}},"StockEntryDto":{"type":"object","required":["id","amount","committed","available","quarantine_qty"],"properties":{"amount":{"type":"number","format":"double","description":"Сколько лежит физически — вместе с зарезервированным и карантином.","example":25.0},"available":{"type":"number","format":"double","description":"Сколько можно обещать клиенту прямо сейчас:\n`amount − committed`, не меньше нуля. То же число, что\nпоказывает колонка «Доступно» в разделе «Склад → Остатки».","example":14.0},"committed":{"type":"number","format":"double","description":"Сколько из `amount` уже обещано: открытые заказы покупателей и активные\nпроизводственные задания. Обещать это количество второй раз нельзя.","example":9.0},"id":{"type":"string"},"item_id":{"type":["string","null"],"description":"Товар строки. Пусто у строк, где записан только вариант изделия — тогда\nтовар берется из `GET /products` по `item_variant_id`."},"item_variant_id":{"type":["string","null"]},"quarantine_qty":{"type":"number","format":"double","description":"**Устарело**: карантина в учете больше нет, всегда `0`.\nУдаляется в следующей версии API.","deprecated":true,"example":0.0},"storage_place_id":{"type":["string","null"]}}},"StockListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/StockEntryDto"}},"next_cursor":{"type":["string","null"]}}},"StockMovementDto":{"type":"object","required":["id","stock_id","amount","date"],"properties":{"amount":{"type":"number","format":"double","description":"Приход — положительное число, расход — отрицательное.","example":25.0},"date":{"type":"string","format":"date-time"},"entity_id":{"type":["string","null"],"description":"id документа-источника в терминах `entity_type`."},"entity_type":{"type":["string","null"],"description":"Документ-источник: `STOCK_ADJUSTMENT` | `PURCHASE_ORDER` |\n`PURCHASE_ORDER_RECEIPT` | `SHIPMENT` | `MANUFACTURING_ORDER` |\n`SALES_RETURN`. `null` — движение без привязки к документу."},"id":{"type":"string"},"item_id":{"type":["string","null"]},"item_variant_id":{"type":["string","null"]},"sku":{"type":["string","null"]},"stock_id":{"type":"string","description":"Строка остатка, по которой прошло движение."},"storage_place_id":{"type":["string","null"]}}},"StockMovementListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/StockMovementDto"}},"next_cursor":{"type":["string","null"]}}},"StoragePlaceCreateRequest":{"type":"object","description":"Тело `POST /storage-places`.","required":["title"],"properties":{"address":{"type":["string","null"],"example":"Москва, ул. Складская, 3"},"legal_name":{"type":["string","null"],"example":"Общество с ограниченной ответственностью «Ромашка», склад №1"},"manufacturing_allowed":{"type":["boolean","null"],"description":"Разрешить производство. По умолчанию `true` — именно этот признак\nподбирает `POST /manufacturing-orders`."},"position":{"type":["integer","null"],"format":"int32","description":"Порядок в справочнике. По умолчанию `0`."},"purchase_allowed":{"type":["boolean","null"],"description":"Разрешить приход от поставщика. По умолчанию `true`."},"sales_allowed":{"type":["boolean","null"],"description":"Разрешить отгрузку покупателю. По умолчанию `true`."},"title":{"type":"string","example":"Цех"}}},"StoragePlaceDto":{"type":"object","required":["id","title","sales_allowed","manufacturing_allowed","purchase_allowed","is_default","position"],"properties":{"address":{"type":["string","null"],"example":"Москва, ул. Складская, 3"},"id":{"type":"string","description":"id места хранения. Он же `storage_place_id` в теле\n`POST /stock-adjustments` и `manufacturing_location_id` в теле\n`POST /manufacturing-orders`."},"is_default":{"type":"boolean","description":"Основной склад учета: он один и подставляется, когда склад не указан.\nУ основного склада все три операции разрешены всегда — присланные\nпризнаки для него не действуют."},"legal_name":{"type":["string","null"],"description":"Наименование под печатные формы; при пустом в печать идет `title`.","example":"Общество с ограниченной ответственностью «Ромашка», склад №1"},"manufacturing_allowed":{"type":"boolean","description":"На складе разрешено производство. Производственное задание без склада\nподбирает склад именно по этому признаку, и при его отсутствии\n`POST /manufacturing-orders` отвечает `422`."},"position":{"type":"integer","format":"int32","description":"Порядок склада в справочнике — тот же, что видит человек на экране."},"purchase_allowed":{"type":"boolean","description":"На складе разрешен приход от поставщика."},"sales_allowed":{"type":"boolean","description":"На складе разрешена отгрузка покупателю."},"title":{"type":"string","example":"Основной склад"}}},"StoragePlaceListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/StoragePlaceDto"}},"next_cursor":{"type":["string","null"]}}},"SupplierCreateRequest":{"type":"object","description":"Тело `POST /suppliers`. Обязательно только название контрагента: остальные\nреквизиты у поставщика-физлица могут отсутствовать вовсе.","required":["name"],"properties":{"address":{"type":["string","null"],"example":"Москва, ул. Промышленная, 7"},"currency":{"type":["string","null"],"description":"Валюта расчетов, трехбуквенный код. По умолчанию валюта учета.","example":"RUB"},"email":{"type":["string","null"],"example":"sales@example.ru"},"inn":{"type":["string","null"],"description":"ИНН. Повтор в пределах учета отвечает `409`.","example":"7701234567"},"kpp":{"type":["string","null"],"example":"770101001"},"name":{"type":"string","description":"Название контрагента. Единственное обязательное поле. У покупателя это же поле называется `title` — имена полей у двух справочников исторически разошлись, и переименование сломало бы уже выпущенные ключи.","example":"ООО «Металлопрокат»"},"notes":{"type":["string","null"],"example":"Отгружает по вторникам"},"phone":{"type":["string","null"],"example":"+7 495 123-45-67"}}},"SupplierDto":{"type":"object","required":["id","name","created_at","updated_at"],"properties":{"address":{"type":["string","null"],"example":"Москва, ул. Промышленная, 7"},"created_at":{"type":"string","format":"date-time"},"currency":{"type":["string","null"],"description":"Валюта расчетов с контрагентом, трехбуквенный код.","example":"RUB"},"email":{"type":["string","null"],"example":"sales@example.ru"},"id":{"type":"string","description":"id поставщика (строкой — на случай миграции на uuid в v2). Он же\n`supplier_id` в теле `POST /purchase-orders`."},"inn":{"type":["string","null"],"description":"ИНН — необязательный реквизит (`inn DROP NOT NULL` в baseline).\nУникален в пределах учета: повтор отвечает `409`.","example":"7701234567"},"kpp":{"type":["string","null"],"example":"770101001"},"name":{"type":"string","description":"Название контрагента. У покупателя это же поле называется `title` — имена полей у двух справочников исторически разошлись, и переименование сломало бы уже выпущенные ключи."},"notes":{"type":["string","null"]},"phone":{"type":["string","null"],"example":"+7 495 123-45-67"},"updated_at":{"type":"string","format":"date-time"}}},"SupplierListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SupplierDto"}},"next_cursor":{"type":["string","null"]}}},"SupplierUpdateRequest":{"type":"object","description":"Тело `PATCH /suppliers/{id}`, все поля необязательны.\n\nПрисланные поля перезаписываются, отсутствующие сохраняют прежнее значение.\nОтличить «не прислали» от «прислали `null`» у ручки способа нет, поэтому\n`null` означает «не трогать», а очистка реквизита делается пустой строкой.","properties":{"address":{"type":["string","null"],"example":"Москва, ул. Промышленная, 7"},"currency":{"type":["string","null"],"example":"RUB"},"email":{"type":["string","null"],"example":"sales@example.ru"},"inn":{"type":["string","null"],"example":"7701234567"},"kpp":{"type":["string","null"],"example":"770101001"},"name":{"type":["string","null"],"example":"ООО «Металлопрокат»"},"notes":{"type":["string","null"],"example":"Отгружает по вторникам"},"phone":{"type":["string","null"],"example":"+7 495 123-45-67"}}},"TriggeredAlertDto":{"type":"object","description":"Одно сработавшее оповещение о регистрациях, обезличенное.\n\nПеречень отвечает на вопрос «какое правило сработало и на чем», когда\nсчетчик сработавших оповещений больше нуля. Полей запроса и учетной записи\nздесь нет по построению: таблицы-источники не содержат ни идентификаторов\nпользователя и тенанта, ни адреса, ни IP, ни `User-Agent`, ни текста ошибки,\nа время срабатывания огрублено до минуты.","required":["rule","triggeredAtMinute","windowSeconds","observedValue","observedTotal"],"properties":{"maxNetworkVelocity":{"type":["integer","null"],"format":"int64","description":"Максимум регистраций из одной маскированной сети в окне. Заполняется\nтолько у правила `probable_automation_registrations`."},"observedTotal":{"type":"integer","format":"int64","description":"Фон окна: все внешние регистрации для сигналов регистрации, все\nнаблюденные исходы запроса для правил наблюдаемости."},"observedValue":{"type":"integer","format":"int64","description":"Значение, пересекшее порог: вероятная автоматизация для сигналов\nрегистрации, число событий класса для правил наблюдаемости."},"rule":{"type":"string","description":"Машинный вид сработавшего правила: `probable_automation_registrations`,\n`registration_server_error`, `registration_rate_limit`,\n`registration_protection_rejection`.","example":"probable_automation_registrations"},"thresholdValue":{"type":["integer","null"],"format":"int64","description":"Настроенный порог на момент срабатывания. `null` означает, что\nоповещение записано версией, которая порог не сохраняла; текущее\nзначение настройки в этом случае намеренно не подставляется."},"triggeredAtMinute":{"type":"string","format":"date-time","description":"Время срабатывания, огрубленное до минуты."},"windowSeconds":{"type":"integer","format":"int32","description":"Ширина окна, на котором правило считало свое значение."}}},"UnitDto":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string","description":"id единицы измерения (строкой — на случай миграции на uuid в v2).\nОн же `unit_id` в теле `POST /products`."},"name":{"type":"string","example":"шт"}}},"UnitListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/UnitDto"}},"next_cursor":{"type":["string","null"]}}},"UserAgentCategoryCountersDto":{"type":"object","required":["browser","automation","crawler","other","missing"],"properties":{"automation":{"type":"integer","format":"int64"},"browser":{"type":"integer","format":"int64"},"crawler":{"type":"integer","format":"int64"},"missing":{"type":"integer","format":"int64"},"other":{"type":"integer","format":"int64"}}},"WebhookEventPayload":{"type":"object","description":"Тело уведомления, которое МРП присылает на адрес подписки.\n\nДанных самого документа здесь нет намеренно: получатель дочитывает документ\nобычным запросом к API своим ключом, и тогда состав полей, права и\nразделение клиентов проверяются ровно один раз — на чтении.\n\nЕдинственное место контракта, где поля названы `camelCase`: тело\nуведомления таким уходит с первого выпуска подписок (ZOL-10470), и\nпереименование сломало бы приемники уже подключенных клиентов.","required":["eventId","event","objectType","objectId","occurredAt","attempt"],"properties":{"attempt":{"type":"integer","format":"int32","description":"Номер попытки доставки, начиная с 1. Всего попыток шесть.","example":1},"event":{"type":"string","description":"Тип события, например `sales_order.created`.","example":"sales_order.created"},"eventId":{"type":"string","description":"Идентификатор события. При повторной доставке тот же самый — по нему\nполучатель отличает повтор от нового события.","example":"0f7c1f1e-6c2a-4a2f-9e4a-9a6f2b1c8d33"},"objectId":{"type":"integer","format":"int64","description":"Идентификатор объекта. Тот же номер подставляется в путь ручки чтения:\n`GET /api/external/v1/sales-orders/{object_id}`.","example":1042},"objectType":{"type":"string","description":"К какому объекту относится событие: `sales_order`, `purchase_order`,\n`manufacturing_order` или `item_variant`.","example":"sales_order"},"occurredAt":{"type":"string","description":"Время события.","example":"2026-08-13T09:14:22.481Z"}}},"WebhookSubscriptionCreateRequest":{"type":"object","description":"Тело `POST /webhook-subscriptions`.","required":["url","events"],"properties":{"description":{"type":["string","null"],"description":"Свободная строка «куда это уходит», до 255 символов.","example":"приемник интеграции с 1С"},"events":{"type":"array","items":{"type":"string"},"description":"Типы событий. Хотя бы один; неизвестный тип отвечает `400`, а не\nотбрасывается молча — иначе клиент прочитал бы отказ как «подписался».","example":["sales_order.created","sales_order.updated"]},"url":{"type":"string","description":"Адрес получателя: только `https`, только публичный адрес в интернете,\nпорт 443 или выше 1024. Имя пользователя и пароль в адресе не\nпринимаются — для подтверждения отправителя есть секрет подписи.","example":"https://hooks.example.com/zolotenkov"}}},"WebhookSubscriptionDeletedResponse":{"type":"object","description":"Ответ снятия подписки.","required":["id","deleted"],"properties":{"deleted":{"type":"boolean","description":"Всегда `true`. Ответ не пустой намеренно: повтор с тем же\n`Idempotency-Key` обязан вернуть то же тело и тот же код, а `204`\nтела не имеет."},"id":{"type":"string"}}},"WebhookSubscriptionDto":{"type":"object","description":"Подписка на события.","required":["id","url","events","enabled","status","consecutive_failures","description","created_at"],"properties":{"consecutive_failures":{"type":"integer","format":"int32"},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string","example":"приемник интеграции с 1С"},"enabled":{"type":"boolean","description":"Доставка включена. Выключенная подписка событий не получает и\nуведомления за время простоя потом не догоняет."},"events":{"type":"array","items":{"type":"string"},"description":"Набор типов событий, на которые подписан адрес. Полный перечень с\nсоставом полезной нагрузки — в разделе `webhooks` этой спецификации.","example":["sales_order.created","stock.changed"]},"id":{"type":"string","description":"id подписки. Он же в пути `PATCH` и `DELETE`."},"last_delivery_at":{"type":["string","null"],"format":"date-time"},"last_failure_at":{"type":["string","null"],"format":"date-time"},"last_failure_reason":{"type":["string","null"],"description":"Причина последней неудачи. Тела ответа получателя здесь нет и не будет.","example":"получатель ответил кодом 500"},"status":{"type":"string","description":"`active` — доставляется, `failing` — попытки исчерпаны и доставка\nостановлена до вмешательства. Сбойную подписку возвращает в строй\n`PATCH` с `\"enabled\": true`: счетчик неудач обнуляется.","example":"active"},"url":{"type":"string","example":"https://hooks.example.com/zolotenkov"}}},"WebhookSubscriptionListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookSubscriptionDto"}},"next_cursor":{"type":["string","null"],"description":"Всегда `null`: подписок у клиента не больше десяти, и страница здесь\nодна. Поле оставлено ради единообразия со списками документов —\nклиенту, который листает любой список одним и тем же кодом, ветвиться\nна этой ручке не нужно."}}},"WebhookSubscriptionUpdateRequest":{"type":"object","description":"Тело `PATCH /webhook-subscriptions/{id}`. Отсутствующее поле сохраняет\nпрежнее значение.","properties":{"description":{"type":["string","null"],"example":"приемник интеграции с 1С"},"enabled":{"type":["boolean","null"],"description":"Включить или выключить доставку. Включение снимает пометку `failing` и\nобнуляет счетчик неудач."},"events":{"type":["array","null"],"items":{"type":"string"},"description":"Новый набор типов событий целиком, а не добавка к прежнему.","example":["sales_order.created"]}}}},"securitySchemes":{"pat":{"type":"http","scheme":"bearer","bearerFormat":"zol_pat_live_<token>"}}},"tags":[{"name":"products","description":"Каталог: карточки товаров и их варианты."},{"name":"sales","description":"Продажи: покупатели и заказы покупателей."},{"name":"purchasing","description":"Закупки: поставщики, заказы поставщикам и приходы."},{"name":"stock","description":"Склад: остатки, движения и корректировки."},{"name":"manufacturing","description":"Производство: задания, операции и спецификации."},{"name":"plan","description":"План: прогноз остатков, дефициты и рекомендации к пополнению."},{"name":"reports","description":"Отчеты: сводные срезы за период — продажи и выпуск, сложенные по товару и периоду."},{"name":"webhooks","description":"События: подписки на уведомления и состав полезной нагрузки каждого события (раздел `webhooks` этого документа)."},{"name":"security","description":"Служебное: телеметрия безопасности."}],"webhooks":{"manufacturing_order.completed":{"post":{"description":"Золотенков присылает это уведомление на адрес подписки, в наборе событий которой есть `manufacturing_order.completed`. Относится к объекту `manufacturing_order`; сам объект дочитывается обычным запросом к API по `objectId`.\n\nОтвечайте любым кодом 2xx и **сразу**, не дожидаясь обработки: на ответ отводится 10 секунд. Тело ответа не читается и не хранится. Неудачная попытка повторяется с нарастающей паузой (минута, 5 минут, 15 минут, час, 3 часа), всего попыток шесть; после этого подписка помечается `failing` и доставка по ней останавливается. Одно и то же событие может прийти дважды — повтор узнается по `eventId`. Порядок доставки не гарантирован.","operationId":"webhook_manufacturing_order_completed","parameters":[{"description":"Тип события — тот же, что в поле `event` тела.","in":"header","name":"X-Zolotenkov-Event","required":true,"schema":{"type":"string"}},{"description":"Идентификатор события — тот же, что в поле `eventId` тела.","in":"header","name":"X-Zolotenkov-Event-Id","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"Время подписи, unix-секунды. Входит в подпись: подменить его, не сломав подпись, нельзя. Уведомление старше пяти минут принимать не следует.","in":"header","name":"X-Zolotenkov-Timestamp","required":true,"schema":{"type":"string"}},{"description":"Подпись вида `v1=<hex>`: HMAC-SHA256 от строки `<время>.<сырое тело запроса>`, ключ — секрет подписки (`whsec_…`). Проверять надо сырое тело, до разбора JSON: перекодировка меняет пробелы и порядок ключей, и подпись перестает сходиться.","in":"header","name":"X-Zolotenkov-Signature","required":true,"schema":{"example":"v1=6f1c…","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"attempt":1,"event":"manufacturing_order.completed","eventId":"0f7c1f1e-6c2a-4a2f-9e4a-9a6f2b1c8d33","objectId":1042,"objectType":"manufacturing_order","occurredAt":"2026-08-13T09:14:22.481Z"},"schema":{"$ref":"#/components/schemas/WebhookEventPayload"}}},"required":true},"responses":{"2XX":{"description":"Уведомление принято. Любой код 2xx считается доставкой."},"default":{"description":"Любой другой ответ (или молчание дольше 10 секунд) считается неудачной попыткой и приводит к повтору."}},"summary":"Завершено производственное задание","tags":["webhooks"]}},"manufacturing_order.created":{"post":{"description":"Золотенков присылает это уведомление на адрес подписки, в наборе событий которой есть `manufacturing_order.created`. Относится к объекту `manufacturing_order`; сам объект дочитывается обычным запросом к API по `objectId`.\n\nОтвечайте любым кодом 2xx и **сразу**, не дожидаясь обработки: на ответ отводится 10 секунд. Тело ответа не читается и не хранится. Неудачная попытка повторяется с нарастающей паузой (минута, 5 минут, 15 минут, час, 3 часа), всего попыток шесть; после этого подписка помечается `failing` и доставка по ней останавливается. Одно и то же событие может прийти дважды — повтор узнается по `eventId`. Порядок доставки не гарантирован.","operationId":"webhook_manufacturing_order_created","parameters":[{"description":"Тип события — тот же, что в поле `event` тела.","in":"header","name":"X-Zolotenkov-Event","required":true,"schema":{"type":"string"}},{"description":"Идентификатор события — тот же, что в поле `eventId` тела.","in":"header","name":"X-Zolotenkov-Event-Id","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"Время подписи, unix-секунды. Входит в подпись: подменить его, не сломав подпись, нельзя. Уведомление старше пяти минут принимать не следует.","in":"header","name":"X-Zolotenkov-Timestamp","required":true,"schema":{"type":"string"}},{"description":"Подпись вида `v1=<hex>`: HMAC-SHA256 от строки `<время>.<сырое тело запроса>`, ключ — секрет подписки (`whsec_…`). Проверять надо сырое тело, до разбора JSON: перекодировка меняет пробелы и порядок ключей, и подпись перестает сходиться.","in":"header","name":"X-Zolotenkov-Signature","required":true,"schema":{"example":"v1=6f1c…","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"attempt":1,"event":"manufacturing_order.created","eventId":"0f7c1f1e-6c2a-4a2f-9e4a-9a6f2b1c8d33","objectId":1042,"objectType":"manufacturing_order","occurredAt":"2026-08-13T09:14:22.481Z"},"schema":{"$ref":"#/components/schemas/WebhookEventPayload"}}},"required":true},"responses":{"2XX":{"description":"Уведомление принято. Любой код 2xx считается доставкой."},"default":{"description":"Любой другой ответ (или молчание дольше 10 секунд) считается неудачной попыткой и приводит к повтору."}},"summary":"Создано производственное задание","tags":["webhooks"]}},"manufacturing_order.started":{"post":{"description":"Золотенков присылает это уведомление на адрес подписки, в наборе событий которой есть `manufacturing_order.started`. Относится к объекту `manufacturing_order`; сам объект дочитывается обычным запросом к API по `objectId`.\n\nОтвечайте любым кодом 2xx и **сразу**, не дожидаясь обработки: на ответ отводится 10 секунд. Тело ответа не читается и не хранится. Неудачная попытка повторяется с нарастающей паузой (минута, 5 минут, 15 минут, час, 3 часа), всего попыток шесть; после этого подписка помечается `failing` и доставка по ней останавливается. Одно и то же событие может прийти дважды — повтор узнается по `eventId`. Порядок доставки не гарантирован.","operationId":"webhook_manufacturing_order_started","parameters":[{"description":"Тип события — тот же, что в поле `event` тела.","in":"header","name":"X-Zolotenkov-Event","required":true,"schema":{"type":"string"}},{"description":"Идентификатор события — тот же, что в поле `eventId` тела.","in":"header","name":"X-Zolotenkov-Event-Id","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"Время подписи, unix-секунды. Входит в подпись: подменить его, не сломав подпись, нельзя. Уведомление старше пяти минут принимать не следует.","in":"header","name":"X-Zolotenkov-Timestamp","required":true,"schema":{"type":"string"}},{"description":"Подпись вида `v1=<hex>`: HMAC-SHA256 от строки `<время>.<сырое тело запроса>`, ключ — секрет подписки (`whsec_…`). Проверять надо сырое тело, до разбора JSON: перекодировка меняет пробелы и порядок ключей, и подпись перестает сходиться.","in":"header","name":"X-Zolotenkov-Signature","required":true,"schema":{"example":"v1=6f1c…","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"attempt":1,"event":"manufacturing_order.started","eventId":"0f7c1f1e-6c2a-4a2f-9e4a-9a6f2b1c8d33","objectId":1042,"objectType":"manufacturing_order","occurredAt":"2026-08-13T09:14:22.481Z"},"schema":{"$ref":"#/components/schemas/WebhookEventPayload"}}},"required":true},"responses":{"2XX":{"description":"Уведомление принято. Любой код 2xx считается доставкой."},"default":{"description":"Любой другой ответ (или молчание дольше 10 секунд) считается неудачной попыткой и приводит к повтору."}},"summary":"Запущено производственное задание","tags":["webhooks"]}},"manufacturing_order.updated":{"post":{"description":"Золотенков присылает это уведомление на адрес подписки, в наборе событий которой есть `manufacturing_order.updated`. Относится к объекту `manufacturing_order`; сам объект дочитывается обычным запросом к API по `objectId`.\n\nОтвечайте любым кодом 2xx и **сразу**, не дожидаясь обработки: на ответ отводится 10 секунд. Тело ответа не читается и не хранится. Неудачная попытка повторяется с нарастающей паузой (минута, 5 минут, 15 минут, час, 3 часа), всего попыток шесть; после этого подписка помечается `failing` и доставка по ней останавливается. Одно и то же событие может прийти дважды — повтор узнается по `eventId`. Порядок доставки не гарантирован.","operationId":"webhook_manufacturing_order_updated","parameters":[{"description":"Тип события — тот же, что в поле `event` тела.","in":"header","name":"X-Zolotenkov-Event","required":true,"schema":{"type":"string"}},{"description":"Идентификатор события — тот же, что в поле `eventId` тела.","in":"header","name":"X-Zolotenkov-Event-Id","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"Время подписи, unix-секунды. Входит в подпись: подменить его, не сломав подпись, нельзя. Уведомление старше пяти минут принимать не следует.","in":"header","name":"X-Zolotenkov-Timestamp","required":true,"schema":{"type":"string"}},{"description":"Подпись вида `v1=<hex>`: HMAC-SHA256 от строки `<время>.<сырое тело запроса>`, ключ — секрет подписки (`whsec_…`). Проверять надо сырое тело, до разбора JSON: перекодировка меняет пробелы и порядок ключей, и подпись перестает сходиться.","in":"header","name":"X-Zolotenkov-Signature","required":true,"schema":{"example":"v1=6f1c…","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"attempt":1,"event":"manufacturing_order.updated","eventId":"0f7c1f1e-6c2a-4a2f-9e4a-9a6f2b1c8d33","objectId":1042,"objectType":"manufacturing_order","occurredAt":"2026-08-13T09:14:22.481Z"},"schema":{"$ref":"#/components/schemas/WebhookEventPayload"}}},"required":true},"responses":{"2XX":{"description":"Уведомление принято. Любой код 2xx считается доставкой."},"default":{"description":"Любой другой ответ (или молчание дольше 10 секунд) считается неудачной попыткой и приводит к повтору."}},"summary":"Изменено производственное задание","tags":["webhooks"]}},"purchase_order.created":{"post":{"description":"Золотенков присылает это уведомление на адрес подписки, в наборе событий которой есть `purchase_order.created`. Относится к объекту `purchase_order`; сам объект дочитывается обычным запросом к API по `objectId`.\n\nОтвечайте любым кодом 2xx и **сразу**, не дожидаясь обработки: на ответ отводится 10 секунд. Тело ответа не читается и не хранится. Неудачная попытка повторяется с нарастающей паузой (минута, 5 минут, 15 минут, час, 3 часа), всего попыток шесть; после этого подписка помечается `failing` и доставка по ней останавливается. Одно и то же событие может прийти дважды — повтор узнается по `eventId`. Порядок доставки не гарантирован.","operationId":"webhook_purchase_order_created","parameters":[{"description":"Тип события — тот же, что в поле `event` тела.","in":"header","name":"X-Zolotenkov-Event","required":true,"schema":{"type":"string"}},{"description":"Идентификатор события — тот же, что в поле `eventId` тела.","in":"header","name":"X-Zolotenkov-Event-Id","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"Время подписи, unix-секунды. Входит в подпись: подменить его, не сломав подпись, нельзя. Уведомление старше пяти минут принимать не следует.","in":"header","name":"X-Zolotenkov-Timestamp","required":true,"schema":{"type":"string"}},{"description":"Подпись вида `v1=<hex>`: HMAC-SHA256 от строки `<время>.<сырое тело запроса>`, ключ — секрет подписки (`whsec_…`). Проверять надо сырое тело, до разбора JSON: перекодировка меняет пробелы и порядок ключей, и подпись перестает сходиться.","in":"header","name":"X-Zolotenkov-Signature","required":true,"schema":{"example":"v1=6f1c…","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"attempt":1,"event":"purchase_order.created","eventId":"0f7c1f1e-6c2a-4a2f-9e4a-9a6f2b1c8d33","objectId":1042,"objectType":"purchase_order","occurredAt":"2026-08-13T09:14:22.481Z"},"schema":{"$ref":"#/components/schemas/WebhookEventPayload"}}},"required":true},"responses":{"2XX":{"description":"Уведомление принято. Любой код 2xx считается доставкой."},"default":{"description":"Любой другой ответ (или молчание дольше 10 секунд) считается неудачной попыткой и приводит к повтору."}},"summary":"Создан заказ поставщику","tags":["webhooks"]}},"purchase_order.updated":{"post":{"description":"Золотенков присылает это уведомление на адрес подписки, в наборе событий которой есть `purchase_order.updated`. Относится к объекту `purchase_order`; сам объект дочитывается обычным запросом к API по `objectId`.\n\nОтвечайте любым кодом 2xx и **сразу**, не дожидаясь обработки: на ответ отводится 10 секунд. Тело ответа не читается и не хранится. Неудачная попытка повторяется с нарастающей паузой (минута, 5 минут, 15 минут, час, 3 часа), всего попыток шесть; после этого подписка помечается `failing` и доставка по ней останавливается. Одно и то же событие может прийти дважды — повтор узнается по `eventId`. Порядок доставки не гарантирован.","operationId":"webhook_purchase_order_updated","parameters":[{"description":"Тип события — тот же, что в поле `event` тела.","in":"header","name":"X-Zolotenkov-Event","required":true,"schema":{"type":"string"}},{"description":"Идентификатор события — тот же, что в поле `eventId` тела.","in":"header","name":"X-Zolotenkov-Event-Id","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"Время подписи, unix-секунды. Входит в подпись: подменить его, не сломав подпись, нельзя. Уведомление старше пяти минут принимать не следует.","in":"header","name":"X-Zolotenkov-Timestamp","required":true,"schema":{"type":"string"}},{"description":"Подпись вида `v1=<hex>`: HMAC-SHA256 от строки `<время>.<сырое тело запроса>`, ключ — секрет подписки (`whsec_…`). Проверять надо сырое тело, до разбора JSON: перекодировка меняет пробелы и порядок ключей, и подпись перестает сходиться.","in":"header","name":"X-Zolotenkov-Signature","required":true,"schema":{"example":"v1=6f1c…","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"attempt":1,"event":"purchase_order.updated","eventId":"0f7c1f1e-6c2a-4a2f-9e4a-9a6f2b1c8d33","objectId":1042,"objectType":"purchase_order","occurredAt":"2026-08-13T09:14:22.481Z"},"schema":{"$ref":"#/components/schemas/WebhookEventPayload"}}},"required":true},"responses":{"2XX":{"description":"Уведомление принято. Любой код 2xx считается доставкой."},"default":{"description":"Любой другой ответ (или молчание дольше 10 секунд) считается неудачной попыткой и приводит к повтору."}},"summary":"Изменен заказ поставщику","tags":["webhooks"]}},"purchase_receipt.created":{"post":{"description":"Золотенков присылает это уведомление на адрес подписки, в наборе событий которой есть `purchase_receipt.created`. Относится к объекту `purchase_order`; сам объект дочитывается обычным запросом к API по `objectId`.\n\nОтвечайте любым кодом 2xx и **сразу**, не дожидаясь обработки: на ответ отводится 10 секунд. Тело ответа не читается и не хранится. Неудачная попытка повторяется с нарастающей паузой (минута, 5 минут, 15 минут, час, 3 часа), всего попыток шесть; после этого подписка помечается `failing` и доставка по ней останавливается. Одно и то же событие может прийти дважды — повтор узнается по `eventId`. Порядок доставки не гарантирован.","operationId":"webhook_purchase_receipt_created","parameters":[{"description":"Тип события — тот же, что в поле `event` тела.","in":"header","name":"X-Zolotenkov-Event","required":true,"schema":{"type":"string"}},{"description":"Идентификатор события — тот же, что в поле `eventId` тела.","in":"header","name":"X-Zolotenkov-Event-Id","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"Время подписи, unix-секунды. Входит в подпись: подменить его, не сломав подпись, нельзя. Уведомление старше пяти минут принимать не следует.","in":"header","name":"X-Zolotenkov-Timestamp","required":true,"schema":{"type":"string"}},{"description":"Подпись вида `v1=<hex>`: HMAC-SHA256 от строки `<время>.<сырое тело запроса>`, ключ — секрет подписки (`whsec_…`). Проверять надо сырое тело, до разбора JSON: перекодировка меняет пробелы и порядок ключей, и подпись перестает сходиться.","in":"header","name":"X-Zolotenkov-Signature","required":true,"schema":{"example":"v1=6f1c…","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"attempt":1,"event":"purchase_receipt.created","eventId":"0f7c1f1e-6c2a-4a2f-9e4a-9a6f2b1c8d33","objectId":1042,"objectType":"purchase_order","occurredAt":"2026-08-13T09:14:22.481Z"},"schema":{"$ref":"#/components/schemas/WebhookEventPayload"}}},"required":true},"responses":{"2XX":{"description":"Уведомление принято. Любой код 2xx считается доставкой."},"default":{"description":"Любой другой ответ (или молчание дольше 10 секунд) считается неудачной попыткой и приводит к повтору."}},"summary":"Оформлен приход","tags":["webhooks"]}},"sales_order.created":{"post":{"description":"Золотенков присылает это уведомление на адрес подписки, в наборе событий которой есть `sales_order.created`. Относится к объекту `sales_order`; сам объект дочитывается обычным запросом к API по `objectId`.\n\nОтвечайте любым кодом 2xx и **сразу**, не дожидаясь обработки: на ответ отводится 10 секунд. Тело ответа не читается и не хранится. Неудачная попытка повторяется с нарастающей паузой (минута, 5 минут, 15 минут, час, 3 часа), всего попыток шесть; после этого подписка помечается `failing` и доставка по ней останавливается. Одно и то же событие может прийти дважды — повтор узнается по `eventId`. Порядок доставки не гарантирован.","operationId":"webhook_sales_order_created","parameters":[{"description":"Тип события — тот же, что в поле `event` тела.","in":"header","name":"X-Zolotenkov-Event","required":true,"schema":{"type":"string"}},{"description":"Идентификатор события — тот же, что в поле `eventId` тела.","in":"header","name":"X-Zolotenkov-Event-Id","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"Время подписи, unix-секунды. Входит в подпись: подменить его, не сломав подпись, нельзя. Уведомление старше пяти минут принимать не следует.","in":"header","name":"X-Zolotenkov-Timestamp","required":true,"schema":{"type":"string"}},{"description":"Подпись вида `v1=<hex>`: HMAC-SHA256 от строки `<время>.<сырое тело запроса>`, ключ — секрет подписки (`whsec_…`). Проверять надо сырое тело, до разбора JSON: перекодировка меняет пробелы и порядок ключей, и подпись перестает сходиться.","in":"header","name":"X-Zolotenkov-Signature","required":true,"schema":{"example":"v1=6f1c…","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"attempt":1,"event":"sales_order.created","eventId":"0f7c1f1e-6c2a-4a2f-9e4a-9a6f2b1c8d33","objectId":1042,"objectType":"sales_order","occurredAt":"2026-08-13T09:14:22.481Z"},"schema":{"$ref":"#/components/schemas/WebhookEventPayload"}}},"required":true},"responses":{"2XX":{"description":"Уведомление принято. Любой код 2xx считается доставкой."},"default":{"description":"Любой другой ответ (или молчание дольше 10 секунд) считается неудачной попыткой и приводит к повтору."}},"summary":"Создан заказ покупателя","tags":["webhooks"]}},"sales_order.updated":{"post":{"description":"Золотенков присылает это уведомление на адрес подписки, в наборе событий которой есть `sales_order.updated`. Относится к объекту `sales_order`; сам объект дочитывается обычным запросом к API по `objectId`.\n\nОтвечайте любым кодом 2xx и **сразу**, не дожидаясь обработки: на ответ отводится 10 секунд. Тело ответа не читается и не хранится. Неудачная попытка повторяется с нарастающей паузой (минута, 5 минут, 15 минут, час, 3 часа), всего попыток шесть; после этого подписка помечается `failing` и доставка по ней останавливается. Одно и то же событие может прийти дважды — повтор узнается по `eventId`. Порядок доставки не гарантирован.","operationId":"webhook_sales_order_updated","parameters":[{"description":"Тип события — тот же, что в поле `event` тела.","in":"header","name":"X-Zolotenkov-Event","required":true,"schema":{"type":"string"}},{"description":"Идентификатор события — тот же, что в поле `eventId` тела.","in":"header","name":"X-Zolotenkov-Event-Id","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"Время подписи, unix-секунды. Входит в подпись: подменить его, не сломав подпись, нельзя. Уведомление старше пяти минут принимать не следует.","in":"header","name":"X-Zolotenkov-Timestamp","required":true,"schema":{"type":"string"}},{"description":"Подпись вида `v1=<hex>`: HMAC-SHA256 от строки `<время>.<сырое тело запроса>`, ключ — секрет подписки (`whsec_…`). Проверять надо сырое тело, до разбора JSON: перекодировка меняет пробелы и порядок ключей, и подпись перестает сходиться.","in":"header","name":"X-Zolotenkov-Signature","required":true,"schema":{"example":"v1=6f1c…","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"attempt":1,"event":"sales_order.updated","eventId":"0f7c1f1e-6c2a-4a2f-9e4a-9a6f2b1c8d33","objectId":1042,"objectType":"sales_order","occurredAt":"2026-08-13T09:14:22.481Z"},"schema":{"$ref":"#/components/schemas/WebhookEventPayload"}}},"required":true},"responses":{"2XX":{"description":"Уведомление принято. Любой код 2xx считается доставкой."},"default":{"description":"Любой другой ответ (или молчание дольше 10 секунд) считается неудачной попыткой и приводит к повтору."}},"summary":"Изменен заказ покупателя","tags":["webhooks"]}},"stock.changed":{"post":{"description":"Золотенков присылает это уведомление на адрес подписки, в наборе событий которой есть `stock.changed`. Относится к объекту `item_variant`; сам объект дочитывается обычным запросом к API по `objectId`.\n\nОтвечайте любым кодом 2xx и **сразу**, не дожидаясь обработки: на ответ отводится 10 секунд. Тело ответа не читается и не хранится. Неудачная попытка повторяется с нарастающей паузой (минута, 5 минут, 15 минут, час, 3 часа), всего попыток шесть; после этого подписка помечается `failing` и доставка по ней останавливается. Одно и то же событие может прийти дважды — повтор узнается по `eventId`. Порядок доставки не гарантирован.","operationId":"webhook_stock_changed","parameters":[{"description":"Тип события — тот же, что в поле `event` тела.","in":"header","name":"X-Zolotenkov-Event","required":true,"schema":{"type":"string"}},{"description":"Идентификатор события — тот же, что в поле `eventId` тела.","in":"header","name":"X-Zolotenkov-Event-Id","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"Время подписи, unix-секунды. Входит в подпись: подменить его, не сломав подпись, нельзя. Уведомление старше пяти минут принимать не следует.","in":"header","name":"X-Zolotenkov-Timestamp","required":true,"schema":{"type":"string"}},{"description":"Подпись вида `v1=<hex>`: HMAC-SHA256 от строки `<время>.<сырое тело запроса>`, ключ — секрет подписки (`whsec_…`). Проверять надо сырое тело, до разбора JSON: перекодировка меняет пробелы и порядок ключей, и подпись перестает сходиться.","in":"header","name":"X-Zolotenkov-Signature","required":true,"schema":{"example":"v1=6f1c…","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"attempt":1,"event":"stock.changed","eventId":"0f7c1f1e-6c2a-4a2f-9e4a-9a6f2b1c8d33","objectId":1042,"objectType":"item_variant","occurredAt":"2026-08-13T09:14:22.481Z"},"schema":{"$ref":"#/components/schemas/WebhookEventPayload"}}},"required":true},"responses":{"2XX":{"description":"Уведомление принято. Любой код 2xx считается доставкой."},"default":{"description":"Любой другой ответ (или молчание дольше 10 секунд) считается неудачной попыткой и приводит к повтору."}},"summary":"Изменились остатки товара","tags":["webhooks"]}}}}