{
    "openapi": "3.1.2",
    "info": {
        "title": "API для интеграций Saleya",
        "version": "1",
        "description": "Подключите к магазину учётную систему, бухгалтерию, маркетплейс или свой сервис. Каждый запрос несёт токен приложения, а токен определяет магазин."
    },
    "servers": [
        {
            "url": "https://api.saleya.app/v1"
        }
    ],
    "security": [
        {
            "apiToken": []
        }
    ],
    "tags": [
        {
            "name": "Me",
            "x-displayName": "Приложение и токен",
            "description": "От чьего имени говорит токен: приложение, его scopes, точки и лимиты. Первый вызов интеграции: по нему видно, что токен рабочий и каких scopes не хватает."
        },
        {
            "name": "Store",
            "x-displayName": "Магазин",
            "description": "То, с чем читаются все остальные ответы: валюта денежных сумм, часовой пояс календарных дат и языки контента."
        },
        {
            "name": "Locations",
            "x-displayName": "Точки",
            "description": "Точки магазина: магазины, склады, кухни и пункты самовывоза. На них ссылаются остатки, заказы и самовывоз."
        },
        {
            "name": "Categories",
            "x-displayName": "Категории",
            "description": "Категории каталога плоским списком: дерево строится по parent_id. Создаются, правятся, уходят в архив и сопоставляются по внешнему id."
        },
        {
            "name": "Products",
            "x-displayName": "Товары",
            "description": "Карточки товаров: названия, описания, категории, опции и фото. У вариантов свои методы; товар создаётся и пишется вместе с ними."
        },
        {
            "name": "Variants",
            "x-displayName": "Варианты",
            "description": "То, что реально продаётся и лежит на складе: артикул, штрихкоды, цены, единица и способ продажи. Варианты правятся под версией карточки своего товара."
        },
        {
            "name": "ProductMedia",
            "x-displayName": "Фото товара",
            "description": "Галерея товара: добавить фото по адресу, переставить, выбрать главное, снять."
        },
        {
            "name": "MediaImports",
            "x-displayName": "Загрузки фото",
            "description": "Фото, добавленные по адресу, скачиваются в фоне; загрузка показывает статус и причину сбоя."
        },
        {
            "name": "ModifierGroups",
            "x-displayName": "Группы модификаторов",
            "description": "Выбор к позиции: соусы, добавки, размер порции. Группа задаёт границы выбора, опции — надбавку и состав."
        },
        {
            "name": "ProductModifierGroups",
            "x-displayName": "Модификаторы товара",
            "description": "Какие группы модификаторов у товара, по порядку, с правилом выбора и надбавками опций по вариантам."
        },
        {
            "name": "RecommendationRules",
            "x-displayName": "Правила рекомендаций",
            "description": "Что предлагать к товарам категории или подборки, по приоритету: свой список товара, затем правила сверху вниз, затем автоподбор."
        },
        {
            "name": "TaxClasses",
            "x-displayName": "Налоговые классы",
            "description": "Налоговые классы магазина, на которые товары ссылаются через tax_class_id: природа налога и ставка, которую запоминает продажа."
        },
        {
            "name": "PriceLists",
            "x-displayName": "Прайс-листы",
            "description": "Прайс-листы точек и оптовые: процент к базовой цене или к себестоимости и округление. Ручные цены и надбавки — своими лентами."
        },
        {
            "name": "PriceListItems",
            "x-displayName": "Ручные цены прайс-листов",
            "description": "Ручные цены вариантов в прайс-листах — исключения из правила листа: цена в валюте прайса и её проекция в деньгах учёта."
        },
        {
            "name": "PriceListModifierItems",
            "x-displayName": "Ручные надбавки прайс-листов",
            "description": "Ручные надбавки опций модификаторов в прайс-листах: для одного варианта позиции или для всех, в валюте прайса и в деньгах учёта."
        },
        {
            "name": "InventoryLevels",
            "x-displayName": "Остатки",
            "description": "Остаток варианта на точке: прочитать уровни, установить физический остаток после пересчёта, принять или списать товар."
        },
        {
            "name": "StockMovements",
            "x-displayName": "Движения склада",
            "description": "Журнал физического остатка точки: продажи, приёмки, списания, ревизии, перемещения и их сторно. Только дописывается."
        },
        {
            "name": "Lots",
            "x-displayName": "Партии",
            "description": "Партии товара: номер с упаковки, срок годности и доступность. На партию ссылаются движения склада и строки документов."
        },
        {
            "name": "LocationTransfers",
            "x-displayName": "Перемещения",
            "description": "Акты перемещения товара между точками магазина: проведённый документ со строками. Ошибку гасит встречный акт."
        },
        {
            "name": "Stocktakes",
            "x-displayName": "Ревизии",
            "description": "Ревизии остатков точки: охват, слепой счёт и статус от черновика до проведения. Строки — отдельной лентой."
        },
        {
            "name": "StocktakeLines",
            "x-displayName": "Строки ревизий",
            "description": "Что нашла ревизия: учёт и факт по позиции и партии, расхождение, применённая коррекция и остаток точки после проведения."
        },
        {
            "name": "WriteOffReasons",
            "x-displayName": "Причины списания",
            "description": "Причины магазина, которые называет списание: причина решает учётный вид и нужен ли комментарий."
        },
        {
            "name": "Orders",
            "x-displayName": "Заказы",
            "description": "Заказы всех каналов: позиции, итоги, статус и оплата. Лента отдаёт изменённое в порядке коммитов; статус меняется и заказ отменяется по правилам магазина."
        },
        {
            "name": "OrderStatuses",
            "x-displayName": "Статусы заказов",
            "description": "Список статусов магазина с его собственными, постоянный смысл каждого и разрешённые переходы."
        },
        {
            "name": "DraftOrders",
            "x-displayName": "Черновики заказов",
            "description": "Заказ, который готовит приложение: черновик считается живьём по каталогу, скидкам и доставке, показывает помехи оформлению и становится заказом."
        },
        {
            "name": "Payments",
            "x-displayName": "Платежи",
            "description": "Попытки оплаты заказов и их исход. Здесь подтверждаются ручные платежи, ждущие денег."
        },
        {
            "name": "Refunds",
            "x-displayName": "Возвраты",
            "description": "Возвраты по заказам: сначала расчёт, затем возврат позиций и доставки; деньги уходят обратно способами оплаты, товар — на склад."
        },
        {
            "name": "DeliveryMethods",
            "x-displayName": "Способы доставки",
            "description": "Способы доставки магазина: справочник, на который заказы и черновики ссылаются полем delivery_method_id."
        },
        {
            "name": "ManualPaymentMethods",
            "x-displayName": "Ручные способы оплаты",
            "description": "Ручные способы оплаты магазина, например банковский перевод, на которые ссылаются заказы и платежи."
        },
        {
            "name": "Customers",
            "x-displayName": "Покупатели",
            "description": "Покупатели магазина с контактами, согласием на рассылки и адресной книгой. Всё это — персональные данные под scope customers:read."
        },
        {
            "name": "CustomerAddresses",
            "x-displayName": "Адреса покупателей",
            "description": "Адресная книга покупателя: добавить, изменить, сделать основным, удалить."
        },
        {
            "name": "CustomerFiscalProfiles",
            "x-displayName": "Реквизиты покупателей",
            "description": "Реквизиты, под которыми выписываются документы новых заказов покупателя."
        },
        {
            "name": "CustomerGroups",
            "x-displayName": "Группы покупателей",
            "description": "Ручные группы покупателей — аудитория скидок и рассылок: VIP, опт, персонал. Состав группы — поле group_ids покупателя."
        },
        {
            "name": "LegalEntities",
            "x-displayName": "Юрлица",
            "description": "Юрлица магазина: налоговый номер и статус, эмитенты фискальных документов. На них ссылаются документы и налоговые периоды."
        },
        {
            "name": "FiscalDocuments",
            "x-displayName": "Фискальные документы",
            "description": "Фактуры, кредит- и дебет-ноты продаж так, как их выпустила налоговая: номер, дата, налог, аннулирование и PDF."
        },
        {
            "name": "TaxPeriods",
            "x-displayName": "Налоговые периоды",
            "description": "Месяцы налогового учёта юрлиц: закрытый период сдан, и данные за него больше не меняются. Только у магазинов Аргентины."
        },
        {
            "name": "TaxWithholdings",
            "x-displayName": "Удержания и перцепции",
            "description": "Налог, удержанный у магазина, — его зачёт, и удержанный магазином у поставщика — к перечислению; сертификаты магазина в PDF."
        },
        {
            "name": "MoneyAccounts",
            "x-displayName": "Денежные счета",
            "description": "Счета, на которые приходят и с которых уходят деньги магазина: касса, банк, эквайринг, кошелёк. Остаток — в валюте счёта."
        },
        {
            "name": "MoneyCategories",
            "x-displayName": "Статьи движений",
            "description": "Дерево статей приходов и расходов. Системную статью опознаёт system_code, а не имя."
        },
        {
            "name": "MoneyTransactions",
            "x-displayName": "Движения денег",
            "description": "Журнал приходов и расходов по счетам: сумма проводки, запись-источник и первичный документ."
        },
        {
            "name": "MoneyTransfers",
            "x-displayName": "Переводы между счетами",
            "description": "Перевод денег со счёта на счёт с комиссией: создание, правка и удаление. Части перевода — движения денег с transfer_id."
        },
        {
            "name": "ExchangeRates",
            "x-displayName": "Курсы дня учёта",
            "description": "Курс валюты к валюте магазина на дату — по нему журнал денег пересчитывает валютные счета; для переоценки и сверки."
        },
        {
            "name": "PosShifts",
            "x-displayName": "Кассовые смены",
            "description": "Смены касс со сверкой денежного ящика по каждой валюте: фонд открытия, ожидание, пересчёт, расхождение и оставленный размен."
        },
        {
            "name": "PosCashMovements",
            "x-displayName": "Движения денежного ящика",
            "description": "Журнал ящика смены: продажи и возвраты налом, внесения, выдачи, сдача в сейф, размен и сторно. Только дописывается."
        },
        {
            "name": "PosCashReasons",
            "x-displayName": "Причины внесения и выдачи",
            "description": "Причины, которые называет внесение или выдача наличных из ящика, со статьёй, которой журнал денег проводит движение."
        },
        {
            "name": "GiftCards",
            "x-displayName": "Подарочные карты",
            "description": "Подарочные карты магазина: номинал, остаток и долг магазина по карте. Код карты не хранится и не отдаётся."
        },
        {
            "name": "GiftCardTransactions",
            "x-displayName": "Журнал подарочных карт",
            "description": "Строки журнала карт: выпуск, погашение, возврат на карту, корректировка, аннулирование и блокировка. Только дописывается."
        },
        {
            "name": "CustomerAccounts",
            "x-displayName": "Счета покупателей",
            "description": "Книга долгов магазина: остаток каждого покупателя, кредитный лимит, срок оплаты и выписка за период со сроками долгов."
        },
        {
            "name": "CustomerAccountEntries",
            "x-displayName": "Журнал счетов покупателей",
            "description": "Записи книги долгов: продажа в долг, погашение, возврат, списание, взаимозачёт, удержание и сторно. Только дописывается."
        },
        {
            "name": "Suppliers",
            "x-displayName": "Поставщики",
            "description": "Справочник поставщиков: реквизиты, валюта закупки, отсрочка оплаты и вид расчётов, а ещё сальдо и акт сверки. Контактное лицо и заметки не отдаются."
        },
        {
            "name": "SupplierBills",
            "x-displayName": "Счета поставщиков",
            "description": "Кредиторка: фактуры, ноты дебета и кредита, долги по поставкам без фактуры — с НДС по ставкам, перцепциями и строками."
        },
        {
            "name": "SupplierBillPayments",
            "x-displayName": "Оплаты счетов поставщиков",
            "description": "Чем и на сколько закрыт долг по счёту поставщика: деньги, зачёт, нота кредита, аванс, расход журнала или вне системы."
        },
        {
            "name": "SettlementAgreements",
            "x-displayName": "Соглашения о взаимозачёте",
            "description": "Основание взаимозачёта: стороны, двусторонний или трёхсторонний зачёт, номер и дата договора, срок действия и расписание регулярного зачёта."
        },
        {
            "name": "SettlementOffsets",
            "x-displayName": "Взаимозачёты",
            "description": "Документ зачёта встречных долгов: что магазину должен покупатель против того, что магазин должен поставщику. Аннулированный зачёт остаётся со статусом voided."
        },
        {
            "name": "SettlementOffsetLines",
            "x-displayName": "Строки взаимозачётов",
            "description": "Что именно зачтено: заказ или долг покупателя по книге долгов и счёт поставщика, с погашениями, которые создал зачёт."
        },
        {
            "name": "PurchaseOrders",
            "x-displayName": "Заказы поставщику",
            "description": "Что магазин заказал у поставщика: строки с заказанным, подтверждённым и принятым количеством, ценой и обещанной датой поставки."
        },
        {
            "name": "GoodsReceipts",
            "x-displayName": "Приёмки",
            "description": "Приход товара от поставщика: строки с ценой накладной и себестоимостью, корректировки «было → стало». Сторно отмечает voided_at."
        },
        {
            "name": "SupplierReturns",
            "x-displayName": "Возвраты поставщику",
            "description": "Товар, отгруженный обратно поставщику: строки, ожидаемая и полученная компенсация — нота кредита, замена товаром или деньги."
        },
        {
            "name": "ConsignmentSettlements",
            "x-displayName": "Акты реализации",
            "description": "Отчёт поставщику о проданном за период товаре на реализации — основание его фактуры: разделы, строки и итоги."
        },
        {
            "name": "Uploads",
            "x-displayName": "Загрузки",
            "description": "Большой файл, переданный частями: сервер считает принятые байты, и оборванная загрузка продолжается с них. Вход массовой операции."
        },
        {
            "name": "BulkOperations",
            "x-displayName": "Массовые операции",
            "description": "Тысячи записей одним запросом: установить остатки, записать товары, выгрузить заказы. Результат — NDJSON, строка на строку входа, докачивается диапазонами."
        },
        {
            "name": "Events",
            "x-displayName": "События",
            "description": "Что изменилось в магазине за последние 30 дней, вместе с записью в её нынешнем виде. Те же события уходят на адреса вебхуков."
        },
        {
            "name": "WebhookEndpoints",
            "x-displayName": "Адреса вебхуков",
            "description": "Адреса, на которые магазин отправляет события с подписью Standard Webhooks; секрет подписи, его смена и тестовое событие."
        },
        {
            "name": "WebhookDeliveries",
            "x-displayName": "Доставки вебхуков",
            "description": "Что ушло на адрес, что ждёт повтора и что не доставлено, с ответами получателя; доставку можно повторить."
        }
    ],
    "x-tagGroups": [
        {
            "name": "Основы",
            "tags": [
                "Me",
                "Store",
                "Locations"
            ]
        },
        {
            "name": "Каталог",
            "tags": [
                "Categories",
                "Products",
                "Variants",
                "ProductMedia",
                "MediaImports",
                "ModifierGroups",
                "ProductModifierGroups",
                "RecommendationRules",
                "TaxClasses",
                "PriceLists",
                "PriceListItems",
                "PriceListModifierItems"
            ]
        },
        {
            "name": "Склад",
            "tags": [
                "InventoryLevels",
                "StockMovements",
                "Lots",
                "LocationTransfers",
                "Stocktakes",
                "StocktakeLines",
                "WriteOffReasons"
            ]
        },
        {
            "name": "Заказы и оплаты",
            "tags": [
                "Orders",
                "OrderStatuses",
                "DraftOrders",
                "Payments",
                "Refunds",
                "DeliveryMethods",
                "ManualPaymentMethods"
            ]
        },
        {
            "name": "Покупатели",
            "tags": [
                "Customers",
                "CustomerAddresses",
                "CustomerFiscalProfiles",
                "CustomerGroups"
            ]
        },
        {
            "name": "Учёт",
            "tags": [
                "LegalEntities",
                "FiscalDocuments",
                "TaxPeriods",
                "TaxWithholdings",
                "MoneyAccounts",
                "MoneyCategories",
                "MoneyTransactions",
                "MoneyTransfers",
                "ExchangeRates",
                "PosShifts",
                "PosCashMovements",
                "PosCashReasons",
                "GiftCards",
                "GiftCardTransactions",
                "CustomerAccounts",
                "CustomerAccountEntries"
            ]
        },
        {
            "name": "Закупки",
            "tags": [
                "Suppliers",
                "SupplierBills",
                "SupplierBillPayments",
                "SettlementAgreements",
                "SettlementOffsets",
                "SettlementOffsetLines",
                "PurchaseOrders",
                "GoodsReceipts",
                "SupplierReturns",
                "ConsignmentSettlements"
            ]
        },
        {
            "name": "Массовые операции",
            "tags": [
                "Uploads",
                "BulkOperations"
            ]
        },
        {
            "name": "События и вебхуки",
            "tags": [
                "Events",
                "WebhookEndpoints",
                "WebhookDeliveries"
            ]
        }
    ],
    "x-problem-types": [
        {
            "type": "api_token_expired",
            "status": 401,
            "title": "Срок токена API истёк",
            "description": "Срок действия токена прошёл.",
            "resolution": "Выпустите новый токен в настройках приложения магазина и замените старый в интеграции."
        },
        {
            "type": "api_token_invalid",
            "status": 401,
            "title": "Токен API недействителен",
            "description": "У токена неверный формат, не сходится контрольная сумма или такого токена нет.",
            "resolution": "Проверьте, что токен скопирован целиком. При необходимости выпустите новый в настройках приложения магазина."
        },
        {
            "type": "api_token_missing",
            "status": 401,
            "title": "Нужен токен API",
            "description": "В запросе нет заголовка Authorization: Bearer. Токен в строке запроса не принимается.",
            "resolution": "Передайте токен приложения в заголовке: Authorization: Bearer <токен>."
        },
        {
            "type": "api_token_revoked",
            "status": 401,
            "title": "Токен API отозван",
            "description": "Токен отозван, приложение удалено, его служебный участник выключен или магазин закрыт.",
            "resolution": "Попросите у магазина новый токен. Если приложение удалено, магазину нужно создать его заново."
        },
        {
            "type": "capability_disabled",
            "status": 403,
            "title": "Ресурс недоступен этому магазину",
            "description": "Ресурс держит возможность магазина, а у этого магазина её нет; capability — какая. Налоговые периоды, например, ведутся только у магазинов Аргентины.",
            "resolution": "Не запрашивайте ресурс у этого магазина: этих данных у него нет."
        },
        {
            "type": "forbidden",
            "status": 403,
            "title": "Доступ запрещён",
            "description": "Правило доступа магазина отказало в действии сверх scopes, например на точке, с которой приложение не работает.",
            "resolution": "Прочитайте detail: он называет правило. Если действие ожидаемо, попросите магазин расширить доступ приложения."
        },
        {
            "type": "insufficient_scope",
            "status": 403,
            "title": "Не хватает доступа",
            "description": "У приложения нет scope, который нужен методу; его называют required_scope и заголовок WWW-Authenticate. Метод, который принимает любой из нескольких scopes, перечисляет их в accepted_scopes — хватит любого.",
            "resolution": "Попросите магазин выдать приложению этот scope. Токен остаётся прежним: scopes принадлежат приложению."
        },
        {
            "type": "integration_api_not_in_plan",
            "status": 403,
            "title": "API для интеграций нет в тарифе",
            "description": "Тариф магазина не включает API для интеграций.",
            "resolution": "Магазину нужен тариф с API для интеграций."
        },
        {
            "type": "ip_not_allowed",
            "status": 403,
            "title": "Адрес не разрешён",
            "description": "Приложение принимает запросы только с перечисленных IP-адресов, а этот пришёл с другого.",
            "resolution": "Обращайтесь с разрешённого адреса или попросите магазин добавить ваш в настройки приложения."
        },
        {
            "type": "not_found",
            "status": 404,
            "title": "Не найдено",
            "description": "Записи нет или она принадлежит другому магазину; неизвестный путь получает тот же ответ.",
            "resolution": "Проверьте ID и путь. Записи других магазинов не видны никогда, даже по точному ID."
        },
        {
            "type": "method_not_allowed",
            "status": 405,
            "title": "Метод не разрешён",
            "description": "Путь существует, но этот HTTP-метод не принимает.",
            "resolution": "Используйте метод операции из справочника."
        },
        {
            "type": "address_book_full",
            "status": 409,
            "title": "Адресная книга покупателя полна",
            "description": "Адресная книга покупателя достигла потолка магазина; limit — потолок.",
            "resolution": "Удалите ненужный адрес и добавьте новый."
        },
        {
            "type": "bulk_operation_finished",
            "status": 409,
            "title": "Операция уже закончилась",
            "description": "Операция уже закончилась, отменить её нельзя; operation_status — её статус.",
            "resolution": "Прочитайте операцию и её результат."
        },
        {
            "type": "bulk_operation_queue_full",
            "status": 409,
            "title": "Очередь операций приложения полна",
            "description": "У приложения уже столько незаконченных массовых операций, сколько разрешено; limit — потолок.",
            "resolution": "Дождитесь окончания одной из них и создайте следующую."
        },
        {
            "type": "bulk_operation_result_unavailable",
            "status": 409,
            "title": "Файла результата нет",
            "description": "Результат операции-файла появляется целиком только у completed, а эта операция ещё идёт, отказала или отменена; operation_status — её статус.",
            "resolution": "Дождитесь события bulk_operation.finished или прочитайте операцию: у failed причина — в error."
        },
        {
            "type": "consent_required",
            "status": 409,
            "title": "Нужно согласие на последствия",
            "description": "Запись изменит другие данные магазина: consent_kind называет вид последствия, consequences считает, что изменится, consent_token — отпечаток показанного.",
            "resolution": "Если последствия приемлемы, повторите запрос с consent[<consent_kind>]=<consent_token>, сохранив уже данные согласия. Если они тем временем изменились, придёт новый 409 с новым отпечатком. У строки варианта в записи товара согласие даётся правкой этого варианта (variant_id)."
        },
        {
            "type": "customer_contact_in_use",
            "status": 409,
            "title": "Контакт уже у покупателя магазина",
            "description": "Телефон или email нового покупателя уже принадлежит покупателю магазина; их называют field и existing_customer_id.",
            "resolution": "Используйте существующего покупателя: прочитайте его по existing_customer_id."
        },
        {
            "type": "draft_order_closed",
            "status": 409,
            "title": "Черновик заказа закрыт",
            "description": "Черновик оформлен или отменён и больше не правится и не оформляется; current даёт его статус и заказ.",
            "resolution": "Если в current.order_id есть заказ, он уже оформлен: прочитайте его."
        },
        {
            "type": "external_id_archived",
            "status": 409,
            "title": "Запись с этим внешним id в архиве",
            "description": "Внешний id принадлежит записи в архиве магазина; его называет external_id.",
            "resolution": "Попросите магазин восстановить запись или выберите другой ID."
        },
        {
            "type": "external_id_in_use",
            "status": 409,
            "title": "Внешний id занят",
            "description": "Внешний id уже у другой живой записи этого приложения; его называет external_id.",
            "resolution": "Прочитайте запись по внешнему id и обновите её или выберите другой ID."
        },
        {
            "type": "fiscal_document_annul_refused",
            "status": 409,
            "title": "Фактуру не аннулировать",
            "description": "Фактуру не аннулировать. code — причина: not_an_invoice — документ не фактура; not_issued — фактура не выпущена: отклонённую перевыпускают, ждущую выпуска гасит отмена заказа; provider_disabled — фискальный модуль магазина выключен; already_voided — фактура уже снята или её нота ждёт выпуска; nothing_to_void — продажа возвращена целиком, встречные ноты обнулили фактуру. current.status — статус документа, current.annulling_document_id — действующая аннулирующая нота у already_voided.",
            "resolution": "already_voided — следите за нотой current.annulling_document_id. Остальные причины повтор не исправит."
        },
        {
            "type": "fiscal_document_dismiss_refused",
            "status": 409,
            "title": "Документ не снять с контроля",
            "description": "Документ не снять с контроля. code — причина: not_awaiting_decision — документ не ждёт решения человека: снимают отклонённый налоговой или выпущенный под CAEA, информирование которого ARCA не принимает; already_resolved — документ уже снят. current.status — статус документа сейчас.",
            "resolution": "Повтор не исправит: сбой и ожидание выпуска доводит сама система."
        },
        {
            "type": "fiscal_document_pdf_unavailable",
            "status": 409,
            "title": "У документа нет файла",
            "description": "У документа нет файла: он не выпущен или провайдер не сохранил ни файла, ни данных для него; current.status — статус документа.",
            "resolution": "Дождитесь события fiscal_document.issued и запросите файл снова; у выпущенного документа без файла его не будет."
        },
        {
            "type": "fiscal_document_reissue_refused",
            "status": 409,
            "title": "Документ не перевыпустить",
            "description": "Документ не перевыпустить. code — причина: not_reissuable — документ не в сбое и не отклонён: ждёт выпуска или выпущен; advance_applied — аванс брони зачтён в чек, фактура чека его уже документирует; nothing_to_issue — заказ возвращён целиком. current.status — статус документа сейчас.",
            "resolution": "not_reissuable — дождитесь исхода выпуска событием. Остальные причины повтор не исправит: такой документ снимают с контроля через POST /v1/fiscal-documents/{document}/dismiss."
        },
        {
            "type": "idempotency_key_in_use",
            "status": 409,
            "title": "Запрос с этим ключом ещё исполняется",
            "description": "Запрос с тем же Idempotency-Key ещё исполняется.",
            "resolution": "Подождите Retry-After секунд и повторите запрос с тем же ключом: придёт сохранённый ответ."
        },
        {
            "type": "in_use_conflict",
            "status": 409,
            "title": "Запись используется",
            "description": "Запись нельзя удалить: на неё ещё ссылаются другие данные магазина.",
            "resolution": "Отправьте запись в архив вместо удаления: архив сохраняет данные, которые на неё ссылаются."
        },
        {
            "type": "invoice_issue_refused",
            "status": 409,
            "title": "Фактуру по заказу сейчас не выпустить",
            "description": "Фактуру по заказу сейчас не выпустить. code — причина: channel_not_first_party — документ выпускает канал продажи; entity_exempt — юрлицо заказа документов не выпускает; issued_externally — документ выпускает внешняя касса; provider_disabled — фискальный модуль магазина выключен; not_covered — продажа ещё не оплачена; advance_applied — аванс брони зачтён в чек, его документирует фактура чека; invoice_exists — фактура уже есть или ждёт выпуска; invoice_rejected — фактуру отклонила налоговая; nothing_to_issue — заказ возвращён целиком; bill_required — у стола несколько счетов, на счёт выпускают касса или панель. current.invoice_id — действующая фактура заказа у invoice_exists и invoice_rejected.",
            "resolution": "not_covered — дождитесь оплаты; invoice_exists — следите за фактурой current.invoice_id; invoice_rejected — исправьте данные и перевыпустите её через POST /v1/fiscal-documents/{document}/reissue. Остальные причины повтор не исправит."
        },
        {
            "type": "money_transaction_locked",
            "status": 409,
            "title": "Движение не меняется руками",
            "description": "Движение журнала не правится и не удаляется руками: у него есть документ-источник (тогда меняются только статья, контрагент и описание), это служебная строка журнала (начальный остаток, курсовая разница, отражение магазина группы) или часть перевода. detail называет причину, current.origin — происхождение строки, current.transfer_id — перевод.",
            "resolution": "Строку с источником меняйте через её документ, часть перевода — через /v1/money-transfers/{transfer_id}."
        },
        {
            "type": "order_cancel_refused",
            "status": 409,
            "title": "Заказ нельзя отменить",
            "description": "Заказ сейчас не отменить: статус не допускает, кредит-ноту не выписать, наличные возвращает только касса с открытой сменой, идёт оплаченная подписка.",
            "resolution": "Прочитайте detail; current показывает статус заказа сейчас."
        },
        {
            "type": "order_transition_refused",
            "status": 409,
            "title": "Заказ нельзя перевести в этот статус",
            "description": "Магазин не разрешает эту смену статуса заказа: правила переходов, самовывоз без курьера, доставка без курьера или неоплаченный остаток перед завершением. detail называет причину, current показывает статус сейчас.",
            "resolution": "Сверьтесь с allowed_next текущего статуса в /v1/order-statuses и причиной в detail."
        },
        {
            "type": "payment_not_confirmable",
            "status": 409,
            "title": "Платёж нельзя подтвердить",
            "description": "Платёж уже не ждёт денег или его закрывает провайдер, а не человек; current показывает его статус.",
            "resolution": "Прочитайте платёж: confirmable говорит, когда ручное подтверждение возможно."
        },
        {
            "type": "plan_limit_reached",
            "status": 409,
            "title": "Достигнут лимит тарифа",
            "description": "Тариф магазина не позволяет больше записей этого вида; limit — потолок.",
            "resolution": "Отправьте ненужные записи в архив, или магазину нужен тариф выше."
        },
        {
            "type": "purchase_order_refused",
            "status": 409,
            "title": "Заказ поставщику не принимает эту команду",
            "description": "Заказ поставщику не принимает команду в нынешнем состоянии: правится только черновик и размещённый заказ, удаляется только черновик, отменяется размещённый, закрывается принятый, а разместить можно только у активных поставщика и точки. detail называет причину, current.status — статус заказа сейчас.",
            "resolution": "Перечитайте заказ и сверьтесь с его статусом: черновик вместо отмены удалите, размещённый вместо удаления отмените."
        },
        {
            "type": "record_limit_reached",
            "status": 409,
            "title": "Достигнут потолок записей",
            "description": "Магазин достиг потолка записей этого вида; limit — потолок. От тарифа он не зависит.",
            "resolution": "Удалите ненужные записи этого вида в панели магазина: тариф выше этот потолок не поднимает."
        },
        {
            "type": "refund_not_confirmable",
            "status": 409,
            "title": "Возврат не ждёт подтверждения выплаты",
            "description": "У возврата нет ручной выплаты, ждущей подтверждения: деньги вернул провайдер, касса или баланс.",
            "resolution": "Прочитайте возврат: confirmable говорит, когда подтверждение нужно."
        },
        {
            "type": "refund_refused",
            "status": 409,
            "title": "Заказ нельзя вернуть",
            "description": "Состояние заказа не допускает возврат: отменён, денег не получено, наличные сданы в кассу, карта продажи потрачена или аванс держит бронь. detail называет причину.",
            "resolution": "Пересчитайте возврат (/v1/orders/{order}/refunds/calculate) и проверьте refundable."
        },
        {
            "type": "shipment_in_progress",
            "status": 409,
            "title": "Выпуск отправления уже идёт",
            "description": "Выпуск отправления по заказу уже ждёт очереди или идёт, либо отправление сейчас отменяют.",
            "resolution": "Дождитесь события order.updated: итог будет в shipment или shipment_attempt."
        },
        {
            "type": "shipment_label_unavailable",
            "status": 409,
            "title": "Наклейки отправления нет",
            "description": "У заказа нет отправления, перевозчик ещё не выдал наклейку или её файл недоступен.",
            "resolution": "Проверьте shipment.label_available в заказе: наклейка есть, когда это поле true."
        },
        {
            "type": "shipment_outcome_unknown",
            "status": 409,
            "title": "Исход прошлого выпуска неизвестен",
            "description": "Связь с перевозчиком оборвалась после прошлого запроса выпуска, и неизвестно, создано ли отправление.",
            "resolution": "Магазин сверяется с кабинетом перевозчика и отмечает исход в панели; после этого выпуск снова доступен."
        },
        {
            "type": "shipment_refused",
            "status": 409,
            "title": "Отправление сейчас не выпустить",
            "description": "Отправление сейчас не выпустить: у способа доставки заказа нет перевозчика с интеграцией, заказ не отгружается или ждёт оплаты счёта. code — причина (no_carrier, not_shippable, awaits_bill_payment), current — статус заказа сейчас.",
            "resolution": "Исправьте заказ по причине в detail — смените способ доставки или дождитесь оплаты счёта — и повторите запрос."
        },
        {
            "type": "shipment_tracking_refused",
            "status": 409,
            "title": "Номер отслеживания вручную не записать",
            "description": "Номер отслеживания у заказа вручную не записать и не снять. code — причина: carrier_integrated — номер выдаёт перевозчик с интеграцией, отправление выпускают через POST /v1/orders/{order}/shipment; manual_tracking_unsupported — способ доставки заказа не везёт службой доставки; order_closed — заказ отменён или возвращён. current — статус заказа сейчас.",
            "resolution": "carrier_integrated — выпустите отправление вместо записи номера; остальные причины повтор не исправит: номер у такого заказа не ведётся."
        },
        {
            "type": "stock_held_by_write_offs",
            "status": 409,
            "title": "Остаток удержан списаниями на подтверждении",
            "description": "Установка ниже забрала бы количество, удержанное списаниями на подтверждении в магазине.",
            "resolution": "Дождитесь, пока магазин подтвердит или отклонит списания, и установите остаток снова."
        },
        {
            "type": "stock_on_hand_changed",
            "status": 409,
            "title": "Остаток изменился",
            "description": "Физический остаток не совпадает с expected_on_hand: он изменился после чтения. current.on_hand показывает остаток сейчас.",
            "resolution": "Пересчитайте от current.on_hand и отправьте запрос снова с новым expected_on_hand."
        },
        {
            "type": "supplier_bill_payment_locked",
            "status": 409,
            "title": "Оплату счёта не отменить напрямую",
            "description": "Оплату счёта поставщика не отменить напрямую: зачёт, ноту кредита, аванс по заказу и расход журнала снимает их документ, а удержание при оплате в закрытом налоговом периоде держит и саму оплату. detail называет причину, current.kind — вид оплаты.",
            "resolution": "Зачёт, ноту, аванс и расход журнала снимите их документом в панели магазина. Удержание закрытого периода исправляется документом следующего периода."
        },
        {
            "type": "supplier_bill_refused",
            "status": 409,
            "title": "Счёт поставщика не принимает эту команду",
            "description": "Счёт поставщика не принимает команду в нынешнем состоянии: правится и удаляется только черновик, проведённый счёт не правится, аннулированный не проводится, а удалению черновика мешают проведённые к нему ноты. Одобряют только проведённый счёт, отзыв одобрения невозможен после первой оплаты, платят только проведённый и одобренный. detail называет причину, current.status — статус счёта сейчас.",
            "resolution": "Перечитайте счёт и сверьтесь с его статусом: проведённый вместо правки аннулируйте или выставьте к нему ноту."
        },
        {
            "type": "tax_withholding_certificate_unavailable",
            "status": 409,
            "title": "Сертификата по записи нет",
            "description": "Сертификат магазин выдаёт только по удержанию, сделанному им самим (direction practiced), от своего юрлица: удержанное у магазина подтверждает бумага агента. current.direction — направление записи, current.legal_entity_id — её юрлицо.",
            "resolution": "Сертификат на удержанное у магазина запросите у агента, который удержал; у записи без юрлица сертификата не будет."
        },
        {
            "type": "unique_conflict",
            "status": 409,
            "title": "Повтор значения",
            "description": "Параллельный запрос занял уникальное значение, например адрес или артикул, между проверкой и записью.",
            "resolution": "Прочитайте текущие данные и повторите с другим значением."
        },
        {
            "type": "upload_offset_mismatch",
            "status": 409,
            "title": "Часть не с того места",
            "description": "Смещение части не равно тому, что загрузка уже приняла; received — верное смещение.",
            "resolution": "Продолжите с received: отправьте часть, начинающуюся с этого байта."
        },
        {
            "type": "webhook_endpoint_limit_reached",
            "status": 409,
            "title": "У приложения предельное число адресов вебхуков",
            "description": "У приложения уже столько адресов вебхуков, сколько разрешено; limit — потолок.",
            "resolution": "Удалите ненужный адрес или подпишите существующий на больше типов событий."
        },
        {
            "type": "cursor_expired",
            "status": 410,
            "title": "Курсор синхронизации устарел",
            "description": "Курсор синхронизации старше срока хранения удалений или выдан до восстановления базы магазина.",
            "resolution": "Синхронизируйтесь заново с начала без курсора (или с updated_since) и сохраните новый курсор синхронизации."
        },
        {
            "type": "precondition_failed",
            "status": 412,
            "title": "Запись изменилась",
            "description": "Версия в If-Match не текущая: запись изменили после чтения. Для If-None-Match: * — запись уже существует.",
            "resolution": "Прочитайте запись заново, примените изменение к свежим данным и отправьте с новым ETag."
        },
        {
            "type": "range_not_satisfiable",
            "status": 416,
            "title": "Диапазон за концом результата",
            "description": "Диапазон начинается дальше записанного результата; Content-Range даёт его длину.",
            "resolution": "У идущей операции дождитесь новых строк и докачивайте с уже скачанной длины."
        },
        {
            "type": "idempotency_key_required",
            "status": 422,
            "title": "Нужен ключ идемпотентности",
            "description": "Метод выполняется только с заголовком Idempotency-Key: его дубль в налоговой не отменить.",
            "resolution": "Передайте уникальный ключ, например UUID; повтор после потерянного ответа — с тем же ключом и телом."
        },
        {
            "type": "idempotency_key_reused",
            "status": 422,
            "title": "Ключ идемпотентности уже использован",
            "description": "Ключ уже ушёл с другим запросом: другим методом, путём или телом.",
            "resolution": "Для нового запроса — новый ключ; с тем же ключом повторяйте только тот же запрос."
        },
        {
            "type": "invalid_idempotency_key",
            "status": 422,
            "title": "Ключ идемпотентности неверен",
            "description": "Заголовок Idempotency-Key не разобран: ключ — от 1 до 255 видимых символов ASCII, токеном или строкой в кавычках.",
            "resolution": "Передавайте уникальный ключ на запрос, например UUID."
        },
        {
            "type": "last_variant_of_product",
            "status": 422,
            "title": "Последний вариант товара",
            "description": "Товар не может остаться без вариантов, поэтому его последний вариант нельзя отправить в архив.",
            "resolution": "Отправьте в архив сам товар (DELETE /v1/products/{product})."
        },
        {
            "type": "money_out_of_range",
            "status": 422,
            "title": "Сумма вне диапазона",
            "description": "Цена, количество или единица дают сумму, слишком большую для точного расчёта.",
            "resolution": "Проверьте цену, количество и единицу варианта."
        },
        {
            "type": "validation_error",
            "status": 422,
            "title": "Неверный запрос",
            "description": "Поле или параметр неверны или неизвестны; errors перечисляет сообщения по полям.",
            "resolution": "Исправьте поля из errors. Неизвестные поля отклоняются, а не игнорируются."
        },
        {
            "type": "precondition_required",
            "status": 428,
            "title": "Нужен If-Match",
            "description": "Правке версионируемой записи нужен If-Match с её ETag; * версией не считается.",
            "resolution": "Прочитайте запись, возьмите её ETag и передайте в If-Match."
        },
        {
            "type": "too_many_requests",
            "status": 429,
            "title": "Слишком много запросов",
            "description": "Лимит исчерпан; policy называет корзину — app, store или rejected, — а Retry-After говорит, сколько ждать. rejected значит, что с вашего адреса слишком много запросов отклонено на входе: токена нет, он неверный, отозван или истёк, адрес не разрешён, в тарифе нет API.",
            "resolution": "Подождите Retry-After секунд. Распределяйте запросы равномерно и используйте массовые операции для больших объёмов; заголовок RateLimit показывает остаток. При rejected исправьте причину, которую назвал прежний ответ 401 или 403, а не повторяйте запрос."
        },
        {
            "type": "server_error",
            "status": 500,
            "title": "Ошибка сервера",
            "description": "Неожиданный сбой на нашей стороне. Запрос не завершился.",
            "resolution": "Повторите позже с тем же Idempotency-Key. Если повторяется — напишите в поддержку с X-Request-Id."
        },
        {
            "type": "carrier_unavailable",
            "status": 503,
            "title": "Перевозчик не отвечает",
            "description": "Перевозчик не ответил на запрос, который магазин делает к нему за вас (наклейка отправления у Mercado Envíos).",
            "resolution": "Повторите запрос позже, ориентируясь на Retry-After."
        },
        {
            "type": "store_frozen",
            "status": 503,
            "title": "Магазин заморожен",
            "description": "Магазин заморожен за неоплату подписки.",
            "resolution": "Магазину нужно оплатить подписку; запросы снова заработают сразу после этого."
        },
        {
            "type": "transient_conflict",
            "status": 503,
            "title": "Временный конфликт",
            "description": "Параллельное изменение откатило запрос целиком; ничего не записано.",
            "resolution": "Повторите через Retry-After секунд."
        },
        {
            "type": "http_error",
            "status": null,
            "title": "Ошибка HTTP",
            "description": "Ошибка HTTP без своего типа, например 503 на время обслуживания.",
            "resolution": "Действуйте по статусу: при 503 повторите через Retry-After секунд."
        }
    ],
    "x-scopes": [
        {
            "name": "catalog:read",
            "description": "Чтение каталога: категории, товары с вариантами и фото, правила рекомендаций, прайс-листы точек с ручными ценами и надбавками.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "catalog:write",
            "description": "Создание, правка и архив категорий, товаров, вариантов, опций и фото товаров и правил рекомендаций; правило, ручные цены и надбавки прайс-листов точек; ход загрузок фото.",
            "includes": [
                "catalog:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "inventory:read",
            "description": "Чтение остатков по точкам, журнала движений склада, партий, перемещений, ревизий и причин списания магазина.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "inventory:write",
            "description": "Установка физического остатка после пересчёта, приход и списание.",
            "includes": [
                "inventory:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "orders:read",
            "description": "Чтение заказов, черновиков, статусов заказов, способов доставки и ручных способов оплаты. Контакты покупателя в заказах требуют ещё customers:read.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "orders:write",
            "description": "Создание и оформление черновиков, смена статуса и отмена заказов, выпуск отправления у перевозчика и запись номера отслеживания у службы без интеграции. Оформление черновика оплаченным требует ещё payments:write, отмена заказа с полученными деньгами — refunds:write.",
            "includes": [
                "orders:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "orders:wholesale",
            "description": "Условия опта — право панели «вести опт»: заведение, правка и удаление оптовых прайс-листов, их ручные цены и надбавки, назначение оптового прайса покупателю (с customers:write). Включает orders:read, catalog:read и costs:read: оптовый лист считает цену от себестоимости. Оптовых продаж через API нет.",
            "includes": [
                "orders:read",
                "catalog:read",
                "costs:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "customers:read",
            "description": "Чтение покупателей с адресной книгой, реквизитами и группами, а также контактов, адреса и комментария покупателя в заказах и получателя фискальных документов.",
            "includes": [],
            "adds_fields_to": [
                "orders:read",
                "fiscal:read"
            ]
        },
        {
            "name": "customers:write",
            "description": "Создание и правка покупателей, их адресной книги и реквизитов; ведение групп покупателей и их состава.",
            "includes": [
                "customers:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "locations:read",
            "description": "Чтение точек магазина, доступных приложению.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "payments:read",
            "description": "Чтение платежей по заказам.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "payments:write",
            "description": "Подтверждение ручного платежа полученным и оформление черновика оплаченным.",
            "includes": [
                "payments:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "refunds:read",
            "description": "Чтение возвратов по заказам.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "refunds:write",
            "description": "Расчёт и создание возвратов, подтверждение ручных выплат и отмена заказов с полученными деньгами.",
            "includes": [
                "refunds:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "costs:read",
            "description": "Себестоимость в вариантах каталога и позициях заказов, оптовые прайс-листы, считающие цену от неё. Своих методов не открывает и работает только вместе с catalog:read или orders:read.",
            "includes": [],
            "adds_fields_to": [
                "catalog:read",
                "orders:read"
            ]
        },
        {
            "name": "fiscal:read",
            "description": "Чтение юрлиц магазина, фискальных документов с их PDF, налоговых периодов, удержаний и перцепций с сертификатами магазина. Получатель документа требует ещё customers:read. Вместе с orders:read даёт документ внешней кассы в заказах.",
            "includes": [],
            "adds_fields_to": [
                "orders:read"
            ]
        },
        {
            "name": "fiscal:write",
            "description": "Выпуск фактуры по закрытой продаже, перевыпуск документа после сбоя или отказа налоговой и снятие отклонённого документа с контроля. Выпуск идёт в налоговую: ключ идемпотентности обязателен.",
            "includes": [
                "fiscal:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "fiscal:annul",
            "description": "Аннулирование выпущенных фактур кредит-нотой — необратимо: нота остаётся в налоговой. Записи не даёт: выпускать документы и снимать их — разные полномочия.",
            "includes": [
                "fiscal:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "finance:read",
            "description": "Чтение денежных счетов с остатком, статей, журнала движений денег с источником и первичным документом, курса дня учёта, кассовых смен со сверкой и журналом денежного ящика, подарочных карт с долгом магазина и журналом карт, счетов покупателей в книге долгов с журналом и выпиской.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "finance:write",
            "description": "Запись ручных доходов и расходов, их правка и удаление, переводы между счетами, разноска журнала пачкой и погашение долгов покупателей деньгами, которые уже пришли. Счета и статьи ведёт панель магазина.",
            "includes": [
                "finance:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "procurement:read",
            "description": "Чтение поставщиков с реквизитами и условиями расчётов, счетов поставщиков с налогом, строками и остатком, оплат счетов, сальдо, акта сверки, взаимозачётов, заказов поставщику, приёмок, возвратов поставщику и актов реализации.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "procurement:write",
            "description": "Создание и правка поставщиков: реквизиты, условия расчётов, внешний id. Заказы поставщику: черновик, правка, размещение, отмена и закрытие. Счета поставщиков: черновик, правка, удаление черновика, проведение и аннулирование.",
            "includes": [
                "procurement:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "procurement:approve",
            "description": "Одобрение проведённых счетов поставщиков к оплате и отзыв одобрения: без него счёт не оплачивается. Записи не даёт: заводить счета и разрешать их оплату — разные полномочия.",
            "includes": [
                "procurement:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "procurement:pay",
            "description": "Оплата одобренных счетов поставщиков вне системы — когда деньги ушли мимо счетов магазина, например с банка ERP, — и отмена оплаты. Записи и одобрения не даёт: заводить счета, разрешать их оплату и платить — разные полномочия.",
            "includes": [
                "procurement:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "webhooks:read",
            "description": "Чтение ленты событий, адресов вебхуков и их доставок.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "webhooks:write",
            "description": "Создание, правка и удаление адресов вебхуков, получение и ротация их секретов, тестовые события и повтор доставок.",
            "includes": [
                "webhooks:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "bulk:read",
            "description": "Чтение массовых операций, скачивание их результатов и проверка загрузок.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "bulk:write",
            "description": "Загрузка файлов, запуск и отмена массовых операций. Каждый вид операции требует ещё scope своего ресурса.",
            "includes": [
                "bulk:read"
            ],
            "adds_fields_to": []
        }
    ],
    "x-limits": [
        {
            "name": "page_size",
            "value": 250,
            "unit": "records",
            "description": "Записей на странице списка (limit)."
        },
        {
            "name": "live_tokens_per_app",
            "value": 2,
            "unit": "items",
            "description": "Текущих токенов у приложения: один в работе и один на замену."
        },
        {
            "name": "idempotency_key",
            "value": 24,
            "unit": "hours",
            "description": "Сколько хранится ответ на запрос с Idempotency-Key."
        },
        {
            "name": "sync_cursor",
            "value": 30,
            "unit": "days",
            "description": "Сколько действует курсор синхронизации; более старый получает 410 cursor_expired."
        },
        {
            "name": "events",
            "value": 30,
            "unit": "days",
            "description": "Сколько хранятся события в GET /v1/events."
        },
        {
            "name": "request_log",
            "value": 30,
            "unit": "days",
            "description": "Сколько запросы хранятся в журнале запросов приложения."
        },
        {
            "name": "webhook_endpoints_per_app",
            "value": 10,
            "unit": "items",
            "description": "Адресов вебхуков у приложения."
        },
        {
            "name": "webhook_timeout",
            "value": 10,
            "unit": "seconds",
            "description": "Сколько доставка вебхука ждёт ответа адреса."
        },
        {
            "name": "previous_webhook_secret",
            "value": 24,
            "unit": "hours",
            "description": "Сколько прежний секрет ещё подписывает после ротации."
        },
        {
            "name": "webhook_retries",
            "value": 10,
            "unit": "items",
            "description": "Автоматических повторов неудачной доставки вебхука."
        },
        {
            "name": "webhook_retry_window",
            "value": 72,
            "unit": "hours",
            "description": "Примерно сколько длятся автоматические повторы доставки."
        },
        {
            "name": "webhook_disable_after",
            "value": 72,
            "unit": "hours",
            "description": "Сколько адрес может отвечать неудачей без единого успеха, прежде чем его выключат."
        },
        {
            "name": "bulk_operations_per_app",
            "value": 5,
            "unit": "items",
            "description": "Массовых операций приложения в очереди и в работе одновременно."
        },
        {
            "name": "bulk_input",
            "value": 268435456,
            "unit": "bytes",
            "description": "Размер входного файла массовой операции."
        },
        {
            "name": "bulk_line",
            "value": 1048576,
            "unit": "bytes",
            "description": "Размер одной строки входа."
        },
        {
            "name": "upload_chunk",
            "value": 1048576,
            "unit": "bytes",
            "description": "Размер одной части загрузки."
        },
        {
            "name": "bulk_retention",
            "value": 7,
            "unit": "days",
            "description": "Сколько хранятся законченная массовая операция и её файлы."
        },
        {
            "name": "rejected_requests_per_minute",
            "value": 60,
            "unit": "items",
            "description": "Сколько запросов в минуту с одного адреса может быть отклонено на входе (401, 403), прежде чем адрес получит 429."
        }
    ],
    "x-changelog": [
        {
            "key": "feed-nulled-references",
            "date": "2026-11-20",
            "kind": "fixed",
            "title": "Ленты отдают записи, ссылку которых обнулило удаление",
            "description": "Когда удаление связанной записи обнуляло ссылку в записи списка (tax_class_id товара после удаления налогового класса, location_id счёта денег после удаления точки) или стирало её вложенную строку (строку счёта поставщика, приёмки, возврата поставщику, акта реализации, категорию товара), запись не двигалась в ленте изменений и не давала событие .updated, и копия интеграции оставалась со старым значением. Теперь такая запись приходит в следующей синхронизации по курсору, а у ресурсов с событием .updated — и событием. Изменения до этой даты лента не повторит: если ваша копия хранит эти ссылки или вложенные строки, один раз прочитайте перечисленные списки заново без курсора.",
            "operations": [
                "orders.list",
                "payments.list",
                "refunds.list",
                "customers.list",
                "locations.list",
                "categories.list",
                "products.list",
                "variants.list",
                "modifier_groups.list",
                "recommendation_rules.list",
                "media_imports.list",
                "lots.list",
                "location_transfers.list",
                "fiscal_documents.list",
                "money_accounts.list",
                "money_categories.list",
                "pos_cash_movements.list",
                "gift_cards.list",
                "gift_card_transactions.list",
                "supplier_bills.list",
                "goods_receipts.list",
                "supplier_returns.list",
                "consignment_settlements.list"
            ]
        },
        {
            "key": "supplier-payment-withholdings",
            "date": "2026-11-20",
            "kind": "changed",
            "title": "Удержания при оплате счёта поставщика: юрисдикция и валюта",
            "description": "В POST /v1/supplier-bills/{supplier_bill}/payments/out-of-band строка удержания turnover или municipal без jurisdiction теперь отклоняется 422: такое удержание не попадало ни в одну декларацию провинции. Сумма удержания по-прежнему в валюте счёта и вычитается из оплаты поставщику. У счёта в чужой валюте лента tax-withholdings получает эквивалент суммы и базы в валюте магазина по курсу дня оплаты, а раньше получала число в валюте счёта. Нет курса на этот день — оплата с удержаниями отклоняется 422.",
            "operations": [
                "supplier_bills.record_out_of_band_payment"
            ]
        },
        {
            "key": "group-transfer-movements",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Перемещения между магазинами группы в журнале склада",
            "description": "В журнале движений склада появились причины group_transfer_out (отгрузка в другой магазин группы), group_transfer_in (приёмка из него) и group_transfer_return (недостача перемещения вернулась на склад отправителя) и вид документа group_transfer — копия перемещения этого магазина. Отбор document_type=group_transfer отдаёт движения одного перемещения. Отдельного ресурса перемещений в /v1 нет.",
            "operations": [
                "stock_movements.list",
                "stock_movements.get"
            ]
        },
        {
            "key": "external-fiscal-document",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Документ внешней кассы в заказе",
            "description": "У заказа появилось поле external_fiscal_document — документ продажи во внешней кассе (FuDo, Poster), которая выпускает его вместо нас: касса (issuer), статус pending или issued и номер. Поле приходит со scope fiscal:read; по таким заказам фискальных документов нет. Появление и выпуск документа двигают заказ в ленте и приходят событием order.updated; заказы с историей получают поле одной догрузкой и тоже проходят по ленте заново. В массовой выгрузке orders.export поле есть, если операцию создали со scope fiscal:read.",
            "operations": [
                "orders.list",
                "orders.get"
            ]
        },
        {
            "key": "fiscal-writes",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Запись фискальных документов",
            "description": "Новые scopes fiscal:write и fiscal:annul. Под fiscal:write POST /v1/orders/{order}/invoice выпускает фактуру по закрытой продаже, POST /v1/fiscal-documents/{document}/reissue перевыпускает документ после сбоя или отказа налоговой (у отклонённой фактуры — с исправленным receptor или refresh_receptor), POST /v1/fiscal-documents/{document}/dismiss снимает отклонённый документ с контроля. Под fiscal:annul POST /v1/fiscal-documents/{document}/annul аннулирует выпущенную фактуру кредит-нотой с причиной reason. Выпуск идёт в налоговую в фоне: ответ 202 и документ, итог — событиями fiscal_document.issued и fiscal_document.failed. У команд, идущих в налоговую, заголовок Idempotency-Key обязателен — без него 422 idempotency_key_required. Новые отказы invoice_issue_refused, fiscal_document_reissue_refused, fiscal_document_dismiss_refused и fiscal_document_annul_refused. У фискального документа появился объект dismissal, у annulment — поле comment; annulment.reason теперь order_cancelled, advance_applied или manual: прежний перечень описывал не те причины.",
            "operations": [
                "fiscal_documents.issue_invoice",
                "fiscal_documents.reissue",
                "fiscal_documents.dismiss",
                "fiscal_documents.annul"
            ]
        },
        {
            "key": "wholesale-price-lists",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Оптовые прайс-листы",
            "description": "Новый scope orders:wholesale — условия опта, право панели «вести опт»; включает orders:read, catalog:read и costs:read. Под ним POST /v1/price-lists заводит оптовый лист, DELETE /v1/price-lists/{price_list} удаляет его под If-Match (лист, назначенный покупателям, — с согласием wholesale_price_list_buyers), а PATCH и команды строк пишут оптовый лист; у оптового PATCH правит и name. POST /v1/customers/{customer}/wholesale-price-list назначает покупателю оптовый лист под его If-Match — нужен ещё customers:write. Команды записи листа принимают любой из scopes catalog:write и orders:wholesale, а нужен scope вида листа — его называет отказ insufficient_scope; у метода с несколькими scopes отказ перечисляет их в accepted_scopes.",
            "operations": [
                "price_lists.create",
                "price_lists.delete",
                "customers.set_wholesale_price_list"
            ]
        },
        {
            "key": "price-list-writes",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Запись прайс-листов",
            "description": "Под catalog:write прайс-лист пишется под If-Match его версии: PATCH /v1/price-lists/{price_list} меняет правило — adjustment_bp и округление rounding; команды POST /v1/price-lists/{price_list}/items и …/items/remove задают и снимают ручные цены вариантов, …/modifier-items и …/modifier-items/remove — ручные надбавки опций, до 1000 строк за запрос одной операцией. Ответ — лист с новой версией, а пачка шлёт одно событие price_list.updated. Строка в деньгах магазина пишется полями price и compare_at_price, в валюте прайса — list_price и list_compare_at_price. Лист точки приложение ведёт, если все его точки приложению доступны; оптовый лист этими командами не пишется.",
            "operations": [
                "price_lists.update",
                "price_lists.set_items",
                "price_lists.remove_items",
                "price_lists.set_modifier_items",
                "price_lists.remove_modifier_items"
            ]
        },
        {
            "key": "price-lists",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Прайс-листы",
            "description": "Под catalog:read появились прайс-листы (GET /v1/price-lists) — листы точек и оптовые, с правилом adjustment_bp и округлением rounding, — их ручные цены вариантов (GET /v1/price-list-items) и ручные надбавки опций (GET /v1/price-list-modifier-items). Оптовый лист считает цену от себестоимости и виден только с costs:read; лист точки — приложению, которому доступна хотя бы одна его точка. У точки появилось поле price_list_id, у покупателя — wholesale_price_list_id и фильтр ленты покупателей по нему. Правка ручной цены или надбавки сдвигает версию листа. События price_list.created, price_list.updated, price_list.deleted.",
            "operations": [
                "price_lists.list",
                "price_lists.get",
                "price_list_items.list",
                "price_list_items.get",
                "price_list_modifier_items.list",
                "price_list_modifier_items.get",
                "locations.list",
                "customers.list",
                "customers.get"
            ]
        },
        {
            "key": "customer-groups",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Группы покупателей",
            "description": "Под customers:read появились группы покупателей (GET /v1/customer-groups) — имя, описание и активность, — а у покупателя поле group_ids и фильтр group_id ленты покупателей. Под customers:write группы создаются, правятся под If-Match и удаляются; удаление отвязывает группу от правил скидок и рассылок, опустевшая аудитория выключает правило. Покупателей добавляют в группу и снимают с неё командами POST /v1/customer-groups/{customer_group}/members и …/members/remove. Членство не двигает версию покупателя: его смена сдвигает покупателя в ленте и шлёт customer.updated. События customer_group.created, customer_group.updated, customer_group.deleted.",
            "operations": [
                "customer_groups.list",
                "customer_groups.get",
                "customer_groups.create",
                "customer_groups.update",
                "customer_groups.delete",
                "customer_groups.add_members",
                "customer_groups.remove_members",
                "customers.list",
                "customers.get"
            ]
        },
        {
            "key": "order-shipment-tracking",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Номер отслеживания у службы без интеграции",
            "description": "POST /v1/orders/{order}/shipment/tracking под orders:write записывает номер отслеживания, ссылку и название службы у заказа, который везёт служба доставки без интеграции; POST …/shipment/tracking/clear снимает его. Номер — в shipment заказа: carrier получил значение courier_service, у shipment и previous_shipments появилось поле carrier_name — служба, как её назвал магазин. Покупатель видит номер на странице заказа и получает сообщением, если заказ уже у службы. Новый отказ shipment_tracking_refused.",
            "operations": [
                "orders.set_shipment_tracking",
                "orders.clear_shipment_tracking",
                "orders.list",
                "orders.get"
            ]
        },
        {
            "key": "order-shipment-create",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Выпуск отправления через API",
            "description": "POST /v1/orders/{order}/shipment выпускает отправление у перевозчика заказа под orders:write: ответ 202 и заказ, выпуск идёт в фоне, итог приходит событием order.updated; отправление уже есть — 200. shipment_attempt получил состояния queued и failed и поле error — код и текст причины отказа. Новые отказы shipment_refused, shipment_in_progress и shipment_outcome_unknown.",
            "operations": [
                "orders.create_shipment",
                "orders.list",
                "orders.get"
            ]
        },
        {
            "key": "variants-list-price",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Цена варианта в валюте прайса",
            "description": "У варианта появились поля list_price и list_price_currency — цена, как её назначил владелец, и её валюта, когда магазин ведёт прайс в чужой валюте. У такой позиции price в деньгах учёта считает система по курсу прайса и во входе его не принимает: цену назначают полем list_price (валюта — прайса магазина или currency). null в list_price_currency — цена назначена в деньгах учёта, как раньше.",
            "operations": [
                "variants.list",
                "variants.get",
                "variants.get_by_external_id",
                "variants.create",
                "variants.update",
                "variants.upsert",
                "products.list",
                "products.get",
                "products.get_by_external_id",
                "products.create",
                "products.update",
                "products.upsert"
            ]
        },
        {
            "key": "products-sale-schedule",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Расписание продажи товара",
            "description": "У товара появилось поле sale_schedule — окна недели в часовом поясе магазина, когда позицию можно заказать: список {days, from, to}, где days — дни ISO (1 — понедельник), from и to — «HH:MM», «24:00» только концом; окно, кончающееся раньше начала, идёт через полночь и принадлежит дню начала. null — позицию заказывают всегда. Это не публикация: вне окна товар виден и кладётся в корзину, а оформление сверяет расписание со временем исполнения заказа. Записать поле можно в создании, правке и upsert товара; null стирает расписание.",
            "operations": [
                "products.list",
                "products.get",
                "products.get_by_external_id",
                "products.create",
                "products.update",
                "products.upsert"
            ]
        },
        {
            "key": "order-shipment",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Отправление у перевозчика в заказе",
            "description": "Заказ получил отправление у перевозчика: shipment — перевозчик, номер и страница отслеживания, последний статус из закрытого набора и история статусов с текстом перевозчика; previous_shipments — отправления, заменённые перевыпуском; shipment_attempt — выпуск идёт или его исход неизвестен. Наклейка отправления — GET /v1/orders/{order}/shipment/label, PDF под orders:read и customers:read: на ней данные получателя. Новые отказы shipment_label_unavailable и carrier_unavailable. Опрос перевозчика без нового статуса больше не сдвигает заказ в ленте и не шлёт order.updated.",
            "operations": [
                "orders.list",
                "orders.get",
                "orders.get_shipment_label"
            ]
        },
        {
            "key": "order-discount-composition",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Состав скидок заказа",
            "description": "Заказ получил состав скидок: applied_discounts — журнал скидок на товары (откуда скидка, за что, имя правила, промокод, причина ручной скидки, позиция при уценке одной позиции, сумма), delivery_discounts — скидки доставки, items[].discount_allocations — из каких строк журнала сложилась скидка позиции. Суммы сходятся: Σ applied_discounts = discount, Σ delivery_discounts = delivery_discount, Σ раскладки позиции = её discount. Скидка внешней кассы приходит строкой source = external_pos. Заказ сдвигается в ленте и шлёт order.updated и тогда, когда его состав меняется без правки самого заказа: журнал скидок или себестоимость позиций.",
            "operations": [
                "orders.list",
                "orders.get"
            ]
        },
        {
            "key": "inventory-stock-documents",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Перемещения и ревизии",
            "description": "Под inventory:read появились акты перемещения между точками (GET /v1/location-transfers) со строками — вариант, партия, количество — и ревизии (GET /v1/stocktakes) со статусом, охватом и признаком слепого счёта. Строки ревизий — своей лентой GET /v1/stocktake-lines: учёт, факт, расхождение, применённая коррекция и остаток точки после проведения; у слепой ревизии в черновике учёт и расхождение — null. Документ движения склада вида location_transfer и stocktake теперь читается этими ресурсами. События location_transfer.created, location_transfer.updated, stocktake.created, stocktake.status_changed, stocktake.updated.",
            "operations": [
                "location_transfers.list",
                "location_transfers.get",
                "stocktakes.list",
                "stocktakes.get",
                "stocktake_lines.list",
                "stocktake_lines.get"
            ]
        },
        {
            "key": "payment-rate-peg",
            "date": "2026-11-19",
            "kind": "changed",
            "title": "Привязка курса в счёте платежа",
            "description": "Режим курса tender.exchange_rate.mode получил значение pegged: магазин привязал валюту способа к другой валюте (например, 1 USDT = 1 USD), и курс — её курс, умноженный на коэффициент. Новое поле tender.exchange_rate.peg {currency, rate} называет привязку; null — курс не привязан. Цены, назначенные в валюте привязки, входят в счёт как есть.",
            "operations": [
                "payments.list",
                "payments.get"
            ]
        },
        {
            "key": "inventory-stock-ledger",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Журнал движений склада и партии",
            "description": "Под inventory:read появились журнал движений склада (GET /v1/stock-movements) — изменение физического остатка точки со знаком, остаток после, причина, графа ведомости и первичный документ — и партии (GET /v1/lots) с номером, сроком годности и статусом. Строки приёмок, возвратов поставщику и актов реализации получили lot_id. События stock_movement.created, stock_movement.updated, lot.created, lot.updated, lot.deleted.",
            "operations": [
                "stock_movements.list",
                "stock_movements.get",
                "lots.list",
                "lots.get",
                "goods_receipts.list",
                "goods_receipts.get",
                "supplier_returns.list",
                "supplier_returns.get",
                "consignment_settlements.list",
                "consignment_settlements.get"
            ]
        },
        {
            "key": "fiscal-libro-iva-files",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Книги Libro IVA и пакет бухгалтера файлом",
            "description": "У массовых операций появился третий род — файл. Вид libro_iva.export собирает книги Libro IVA Digital юрлица за месяц: в params — legal_entity_id, period вида YYYY-MM и books (ventas, compras или обе; к покупкам — файлы импорта). Вид accountant_package.export собирает пакет бухгалтера. Нужны bulk:write и fiscal:read, налоговый учёт Аргентины у магазина и доступ приложения ко всем точкам. Результат — ZIP с теми же файлами, что в панели; он появляется целиком у completed, а до этого GET …/result отвечает новым 409 bulk_operation_result_unavailable. Отказ сборки — failed с кодом libro_iva_not_applicable или libro_iva_incomplete; у второго error.documents перечисляет документы и причины.",
            "operations": [
                "bulk_operations.create",
                "bulk_operations.get_result"
            ]
        },
        {
            "key": "procurement-supplier-bills-out-of-band-payments",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Оплата счетов поставщика вне системы",
            "description": "Новый scope procurement:pay — по умолчанию не выдаётся и включает procurement:read, но не запись и не одобрение. POST /v1/supplier-bills/{supplier_bill}/payments/out-of-band под If-Match отмечает одобренный счёт оплаченным вне системы: долг закрывается без денежного счёта магазина, у юрлица — агента удержаний состав withholdings обязателен. Ответ — созданная оплата, 201 с Location. DELETE /{supplier_bill}/payments/{supplier_bill_payment} под If-Match отменяет оплату деньгами или вне системы вместе с её удержаниями; остальные виды снимает свой документ — новый отказ supplier_bill_payment_locked. Оплата и отмена приходят событиями supplier_bill_payment.created и .deleted, остаток счёта — supplier_bill.updated.",
            "operations": [
                "supplier_bills.record_out_of_band_payment",
                "supplier_bills.delete_payment"
            ]
        },
        {
            "key": "procurement-supplier-bills-approval",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Утверждение счетов поставщика к оплате",
            "description": "Новый scope procurementSaleyarove — по умолчанию не выдаётся и включает procurement:read, но не запись. POST /v1/supplier-bills/{supplier_bill}/approve одобряет проведённый счёт к оплате под If-Match: без одобрения счёт не оплачивается, а аванс по заказу счёта гасит его сразу. POST /{supplier_bill}/revoke-approval отзывает одобрение, пока по счёту не было оплат. Отказ по состоянию счёта — supplier_bill_refused. Одобрение и отзыв приходят событием supplier_bill.updated с полем approved_at.",
            "operations": [
                "supplier_bills.approve",
                "supplier_bills.revoke_approval"
            ]
        },
        {
            "key": "variants-net-content",
            "date": "2026-11-17",
            "kind": "added",
            "title": "Мера нетто штуки варианта",
            "description": "У варианта появилось поле net_content — мера нетто одной штуки {quantity, unit}: пачка 500 г, бутылка 1000 мл. В ответе — действующая мера: у упаковки из нескольких единиц другого варианта она выводится из него, у фасованной штуки — из её меры. Записать её можно в создании и правке варианта и товара с вариантами — только у обычного штучного варианта; null стирает. По ней акция-набор засчитывает пачки в позицию «от 1 кг», а фиды витрин показывают цену за килограмм.",
            "operations": [
                "variants.list",
                "variants.get",
                "variants.get_by_external_id",
                "variants.create",
                "variants.update",
                "variants.upsert",
                "products.list",
                "products.get",
                "products.get_by_external_id",
                "products.create",
                "products.update",
                "products.upsert"
            ]
        },
        {
            "key": "procurement-supplier-bills-write",
            "date": "2026-11-16",
            "kind": "added",
            "title": "Запись счетов поставщика",
            "description": "Под procurement:write: черновик счёта поставщика (POST /v1/supplier-bills), правка черновика под If-Match (PATCH /v1/supplier-bills/{supplier_bill}), удаление черновика (DELETE), проведение POST /{supplier_bill}/post и аннулирование POST /{supplier_bill}/void. Поля — как в ответе: налоговый период YYYY-MM, курс строкой, налоги сверх НДС — additional_taxes, реквизиты ARCA — в ar. В ответе и записи появился ar.import — реквизиты импорта товаров или услуг. Проведение может потребовать согласия vendor_tax_id или close_returns. Новый отказ supplier_bill_refused: команда не подходит состоянию счёта.",
            "operations": [
                "supplier_bills.create",
                "supplier_bills.update",
                "supplier_bills.delete",
                "supplier_bills.post",
                "supplier_bills.void"
            ]
        },
        {
            "key": "procurement-purchase-orders-write",
            "date": "2026-11-16",
            "kind": "added",
            "title": "Запись заказов поставщику",
            "description": "Под procurement:write: черновик заказа поставщику (POST /v1/purchase-orders), правка под If-Match (PATCH /v1/purchase-orders/{purchase_order}) — черновика целиком, размещённого — строк, даты и примечания с ревизией и сообщением поставщику, — удаление черновика (DELETE) и переходы POST /{purchase_order}/place, /cancel, /close. Количество и единица цены строки — строкой в базовой единице варианта, как в ответе. Работает у магазина с включёнными закупками, иначе 403 capability_disabled. Новый отказ purchase_order_refused: команда не подходит состоянию заказа.",
            "operations": [
                "purchase_orders.create",
                "purchase_orders.update",
                "purchase_orders.delete",
                "purchase_orders.place",
                "purchase_orders.cancel",
                "purchase_orders.close"
            ]
        },
        {
            "key": "kitchen-modifiers",
            "date": "2026-11-16",
            "kind": "added",
            "title": "Модификаторы",
            "description": "Группы модификаторов с опциями под catalog:read и catalog:write: лента GET /v1/modifier-groups, группа по id и по id в вашей системе, создание, правка под If-Match, upsert PATCH /v1/modifier-groups/by-external-id/{external_id} и архив с согласием modifier_group_archive. Опции — набор группы: строка находит опцию по id или external_id, опция, которой нет в наборе, уходит в архив. Правка, снижающая минимум выбора у товаров, просит согласия modifier_product_minimum. GET и PUT /v1/products/{product}/modifier-groups читают и заменяют группы товара с правилом выбора и надбавками опций по вариантам; карточка товара получила поле modifier_groups. Тех-карта варианта получила option_recipes — закладки опций с расходом по блюду. Потолок групп магазина — record_limit_reached.",
            "operations": [
                "modifier_groups.list",
                "modifier_groups.get",
                "modifier_groups.get_by_external_id",
                "modifier_groups.create",
                "modifier_groups.update",
                "modifier_groups.upsert",
                "modifier_groups.delete",
                "products.list",
                "products.get",
                "products.get_by_external_id",
                "products.create",
                "products.update",
                "products.upsert",
                "products.replace_options",
                "products.get_modifier_groups",
                "products.replace_modifier_groups",
                "variants.get_recipe",
                "variants.replace_recipe"
            ]
        },
        {
            "key": "procurement-suppliers-write",
            "date": "2026-11-16",
            "kind": "added",
            "title": "Запись поставщиков",
            "description": "Новый scope procurement:write. Создание поставщика (POST /v1/suppliers), правка под If-Match (PATCH /v1/suppliers/{supplier}) и создание или правка по id в вашей системе (PATCH /v1/suppliers/by-external-id/{external_id}); найти поставщика по нему — GET /v1/suppliers/by-external-id/{external_id} под procurement:read. Пишутся те же поля, что приходят в ответе, кроме customer_id. У поставщика появилось поле external_id. Новый отказ record_limit_reached: магазин достиг потолка записей этого вида, который не зависит от тарифа, — его возвращают POST /v1/suppliers и POST /v1/recommendation-rules.",
            "operations": [
                "suppliers.list",
                "suppliers.get",
                "suppliers.get_by_external_id",
                "suppliers.create",
                "suppliers.update",
                "suppliers.upsert",
                "recommendation_rules.create",
                "events.list"
            ]
        },
        {
            "key": "kitchen-catalog",
            "date": "2026-11-16",
            "kind": "added",
            "title": "Сырьё, заготовки и тех-карты",
            "description": "POST /v1/products и upsert заводят сырьё и заготовки (type ingredient, prep) с stock_unit — базовой единицей остатков и тех-карт и тарой закупки; stock_unit есть в каждом ответе товара. GET и PUT /v1/variants/{variant}/recipe читают и заменяют тех-карту варианта: состав с закладкой в единице каждого компонента и выход заготовки, под версией товара. Норма труда, шаги производства, метод списания и побочные выходы остаются в панели магазина: API их не трогает.",
            "operations": [
                "products.list",
                "products.get",
                "products.get_by_external_id",
                "products.create",
                "products.update",
                "products.upsert",
                "products.replace_options",
                "variants.get_recipe",
                "variants.replace_recipe"
            ]
        },
        {
            "key": "tax-withholdings",
            "date": "2026-11-16",
            "kind": "added",
            "title": "Удержания и перцепции",
            "description": "Под fiscal:read: реестр удержаний и перцепций (GET /v1/tax-withholdings, фильтр direction) — налог, удержанный у магазина (suffered: провайдер расчёта, банк, покупатель-агент), и удержанный магазином при оплате поставщику (practiced): вид, налог и юрисдикция, сумма, база и ставка, контрагент, налог и месяц зачёта, номер сертификата, источник и аннулирование. Сертификат, который магазин выдаёт контрагенту, — GET /v1/tax-withholdings/{tax_withholding}/certificate (PDF). Запись журнала счёта покупателя вида withholding получила tax_withholding_id — справку в реестре. Новые события: tax_withholding.created, tax_withholding.updated, tax_withholding.annulled и tax_withholding.deleted.",
            "operations": [
                "tax_withholdings.list",
                "tax_withholdings.get",
                "tax_withholdings.get_certificate",
                "customer_account_entries.list",
                "customer_account_entries.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "consignment-settlements",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Акты реализации",
            "description": "Под procurement:read: акты реализации (GET /v1/consignment-settlements, фильтр supplier_id) — что из товара на реализации продано за период, списано за счёт магазина и доплачено за цену, исправленную корректировкой приёмки: подытоги разделов и строки с вариантом, приёмкой, количеством в базовой единице варианта и ценой поставки — в валюте акта и в валюте магазина. Счёт поставщика уже ссылается на акт полем consignment_settlement_id. Новые события: consignment_settlement.created, consignment_settlement.updated, consignment_settlement.posted и consignment_settlement.voided.",
            "operations": [
                "consignment_settlements.list",
                "consignment_settlements.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "procurement-documents",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Заказы поставщику, приёмки и возвраты поставщику",
            "description": "Под procurement:read: заказы поставщику (GET /v1/purchase-orders, фильтр supplier_id) — строки с заказанным, подтверждённым поставщиком и принятым количеством; приёмки (GET /v1/goods-receipts, фильтры supplier_id и purchase_order_id) — строки с ценой накладной, ценой в валюте магазина и себестоимостью после налога, корректировки «было → стало»; возвраты поставщику (GET /v1/supplier-returns, фильтры supplier_id и goods_receipt_id) — строки, ожидаемая и полученная компенсация, корректировки. Количества — строкой в базовой единице варианта. Счёт поставщика получил goods_receipt_ids, purchase_order_ids и supplier_return_ids. Новые события: purchase_order.created, purchase_order.updated, purchase_order.status_changed, purchase_order.deleted, goods_receipt.created, goods_receipt.updated, goods_receipt.voided, supplier_return.created, supplier_return.updated, supplier_return.status_changed и supplier_return.deleted.",
            "operations": [
                "purchase_orders.list",
                "purchase_orders.get",
                "goods_receipts.list",
                "goods_receipts.get",
                "supplier_returns.list",
                "supplier_returns.get",
                "supplier_bills.list",
                "supplier_bills.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "procurement-settlements",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Сальдо, акт сверки и взаимозачёты",
            "description": "Под procurement:read: сальдо поставщика (GET /v1/suppliers/{id}/balance) — семь слагаемых долга, раскладка просрочки и итог; акт сверки (GET /v1/suppliers/{id}/statement) — сальдо на начало и конец периода и строки с нарастающим остатком; оба со срезом legal_entity_id. Взаимозачёты (GET /v1/settlement-offsets), их строки отдельной лентой (GET /v1/settlement-offset-lines) и соглашения о зачёте (GET /v1/settlement-agreements). Счёт поставщика получил paid_total и outstanding в валюте документа. Запись книги долгов покупателей получила settlement_offset_id. customer_id поставщика теперь только под customers:read. Новые события: settlement_agreement.created, settlement_agreement.updated, settlement_agreement.deleted, settlement_offset.created, settlement_offset.updated и settlement_offset.voided.",
            "operations": [
                "suppliers.get_balance",
                "suppliers.get_statement",
                "suppliers.list",
                "suppliers.get",
                "settlement_agreements.list",
                "settlement_agreements.get",
                "settlement_offsets.list",
                "settlement_offsets.get",
                "settlement_offset_lines.list",
                "settlement_offset_lines.get",
                "supplier_bills.list",
                "supplier_bills.get",
                "customer_account_entries.list",
                "customer_account_entries.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "procurement-payables",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Поставщики и счета поставщиков",
            "description": "Новый scope procurement:read. Поставщики (GET /v1/suppliers) — реквизиты и условия расчётов, без контактного лица и заметок. Счета поставщиков (GET /v1/supplier-bills, фильтр supplier_id) — фактуры, ноты и долги по поставкам без фактуры (fiscal: false) с НДС общей налоговой строкой, перцепциями и удержаниями списком additional_taxes, строками и реквизитами ARCA в ar. Оплаты счетов (GET /v1/supplier-bill-payments, фильтр supplier_bill_id) — деньгами, зачётом, нотой кредита, авансом по заказу, расходом журнала или вне системы. Новые события: supplier.created, supplier.updated, supplier.deleted, supplier_bill.created, supplier_bill.updated, supplier_bill.posted, supplier_bill.voided, supplier_bill.deleted, supplier_bill_payment.created, supplier_bill_payment.updated и supplier_bill_payment.deleted.",
            "operations": [
                "suppliers.list",
                "suppliers.get",
                "supplier_bills.list",
                "supplier_bills.get",
                "supplier_bill_payments.list",
                "supplier_bill_payments.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "money-write",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Запись журнала денег и погашение долгов",
            "description": "Новый scope finance:write. Ручной доход или расход (POST /v1/money-transactions), правка и удаление движения под If-Match: у движения с документом-источником меняются только статья, контрагент и описание, остальное — 409 money_transaction_locked. Суммы в валюте счёта — десятичной строкой, лишние знаки — 422. Перевод между счетами — POST, GET, PATCH и DELETE /v1/money-transfers. Массовые операции money_transactions.create и money_transactions.update — проводка и разноска журнала пачкой. Погашение долга покупателя деньгами, которые уже пришли, — POST /v1/customer-accounts/{customer_account}/payments, со справками об удержаниях. У журнала счетов покупателей — фильтр order_id: записи погашения связаны с заказом-погашением, а не с платежом.",
            "operations": [
                "money_transactions.create",
                "money_transactions.update",
                "money_transactions.delete",
                "money_transfers.create",
                "money_transfers.get",
                "money_transfers.update",
                "money_transfers.delete",
                "customer_accounts.record_payment",
                "customer_account_entries.list",
                "bulk_operations.create",
                "bulk_operations.list",
                "bulk_operations.get"
            ]
        },
        {
            "key": "customer-accounts",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Книга долгов покупателей",
            "description": "Под finance:read появились счета покупателей (GET /v1/customer-accounts) — остаток, равный сумме записей счёта, кредитный лимит (null — без лимита) и срок оплаты, — журнал счетов (GET /v1/customer-account-entries, фильтры customer_account_id и payment_id) с суммой со знаком, сроком оплаты начисления и связями с заказом, платежом и возвратом, и выписка за период (GET /v1/customer-accounts/{customer_account}/statement) с нарастающим остатком и открытыми долгами со сроками. Покупатель customer_id и заметка о нём — под customers:read. Новые события: customer_account.created, customer_account.updated, customer_account_entry.created и customer_account_entry.updated — перенос записи на счёт оставшегося покупателя при слиянии покупателей.",
            "operations": [
                "customer_accounts.list",
                "customer_accounts.get",
                "customer_accounts.get_statement",
                "customer_account_entries.list",
                "customer_account_entries.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "gift-cards",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Подарочные карты и их журнал",
            "description": "Под finance:read появились подарочные карты (GET /v1/gift-cards) — номинал, остаток и outstanding, долг магазина по карте: у неоплаченной карты он 0, у заблокированной и истёкшей равен остатку, — и журнал карт (GET /v1/gift-card-transactions, фильтры gift_card_id и payment_id) с суммой со знаком и остатком после строки. Владелец карты customer_id — под customers:read. Новые события: gift_card.created, gift_card.updated и gift_card_transaction.created.",
            "operations": [
                "gift_cards.list",
                "gift_cards.get",
                "gift_card_transactions.list",
                "gift_card_transactions.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "pos-shifts",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Кассовые смены и журнал денежного ящика",
            "description": "Под finance:read появились кассовые смены (GET /v1/pos-shifts) со сверкой ящика по каждой валюте — фонд открытия, ожидание, пересчёт, расхождение и оставленный размен, — журнал денежного ящика (GET /v1/pos-cash-movements, фильтр shift_id) и справочник причин внесения и выдачи (GET /v1/pos-cash-reasons). У платежей и возвратов — поле и фильтр pos_shift_id: смена, принявшая деньги, по ней сверяется выручка смены. Новые события: pos_shift.opened, pos_shift.closed, pos_shift.updated и pos_cash_movement.created.",
            "operations": [
                "pos_shifts.list",
                "pos_shifts.get",
                "pos_cash_movements.list",
                "pos_cash_movements.get",
                "pos_cash_reasons.list",
                "payments.list",
                "payments.get",
                "payments.confirm",
                "refunds.list",
                "refunds.get",
                "refunds.create",
                "refunds.confirm",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "exchange-rates",
            "date": "2026-11-14",
            "kind": "added",
            "title": "Курс дня учёта",
            "description": "Новая операция GET /v1/exchange-rates/{currency} под finance:read отдаёт курс дня учёта на дату — тот, по которому журнал денег пересчитывает в валюту магазина движения по счёту в этой валюте: десятичной строкой, с днём фиксации (rate_date) и источником рыночного курса из правила магазина.",
            "operations": [
                "exchange_rates.get"
            ]
        },
        {
            "key": "money-journal",
            "date": "2026-11-14",
            "kind": "added",
            "title": "Денежный журнал: счета, статьи и движения",
            "description": "Новый scope finance:read открывает денежные счета магазина с остатком в валюте счёта, статьи движений с кодами системных статей и журнал движений — с суммой проводки в валюте магазина и в валюте счёта, учётной датой, записью-источником (source) и первичным документом (document); ноги перевода связывает transfer_id. Новые события: money_transaction.created, money_transaction.updated и money_transaction.deleted.",
            "operations": [
                "money_accounts.list",
                "money_accounts.get",
                "money_categories.list",
                "money_transactions.list",
                "money_transactions.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "payment-provider-charges",
            "date": "2026-11-14",
            "kind": "added",
            "title": "Комиссия провайдера и удержанный налог платежа",
            "description": "Платёж получает provider_fee_amount и provider_withheld_tax_amount — комиссию платёжного провайдера и налог, который он удержал как агент, — и их доли, возвращённые провайдером при возврате покупателю: refunded_provider_fee_amount и refunded_provider_withheld_tax_amount.",
            "operations": [
                "payments.list",
                "payments.get",
                "payments.confirm",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "payment-money",
            "date": "2026-11-14",
            "kind": "added",
            "title": "Деньги платежа, юрлицо продажи и события платежей и возвратов",
            "description": "Платёж получает tender — оплату в чужой валюте с курсом, его режимом, источником, рыночной базой и надбавкой магазина, — received_asset (монету, которая пришла на самом деле) и legal_entity_id; заказ — legal_entity_id. Новые события: payment.created, payment.succeeded, payment.status_changed, payment.updated, refund.completed, refund.status_changed и refund.updated.",
            "operations": [
                "payments.list",
                "payments.get",
                "payments.confirm",
                "orders.list",
                "orders.get",
                "orders.cancel",
                "orders.set_status",
                "draft_orders.complete",
                "bulk_operations.get_result",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "fiscal-records",
            "date": "2026-11-14",
            "kind": "added",
            "title": "Юрлица, фискальные документы и налоговые периоды",
            "description": "Новый scope fiscal:read открывает юрлица магазина, фискальные документы во всех статусах — с налогом, авторизованным налоговой, учётной датой, реквизитами ARCA и PDF — и налоговые периоды юрлиц у магазинов Аргентины. Получатель документа — со scope customers:read. Новые события: fiscal_document.created, fiscal_document.updated, fiscal_document.issued, fiscal_document.failed, fiscal_document.annulled и tax_period.status_changed.",
            "operations": [
                "legal_entities.list",
                "fiscal_documents.list",
                "fiscal_documents.get",
                "fiscal_documents.get_pdf",
                "tax_periods.list",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "sale-taxes",
            "date": "2026-11-13",
            "kind": "added",
            "title": "Налог продажи и себестоимость позиций заказа",
            "description": "Заказ получает tax_lines, delivery_tax_lines и tax_lines каждой позиции, возврат — tax_lines: налог продажи по классификации товаров в одной форме TaxLine. Со scope costs:read позиции заказа получают cost_amount и cost_basis.",
            "operations": [
                "orders.list",
                "orders.get",
                "orders.cancel",
                "orders.set_status",
                "draft_orders.complete",
                "refunds.list",
                "refunds.get",
                "refunds.create",
                "refunds.confirm",
                "bulk_operations.get_result"
            ]
        },
        {
            "key": "tax-classes",
            "date": "2026-11-13",
            "kind": "added",
            "title": "Налоговые классы товаров",
            "description": "Новый адрес /v1/tax-classes отдаёт налоговые классы магазина: природу налога (taxed, exempt, untaxed) и ставку в базисных пунктах. У товара новое поле tax_class_id — его читают и пишут при создании, правке и upsert; null — класс магазина по умолчанию. Раньше товар, созданный через API, всегда получал класс по умолчанию.",
            "operations": [
                "tax_classes.list",
                "products.list",
                "products.get",
                "products.get_by_external_id",
                "products.create",
                "products.update",
                "products.upsert",
                "products.replace_options"
            ]
        },
        {
            "key": "customer-marketing-consents-by-channel",
            "date": "2026-11-13",
            "kind": "added",
            "title": "Согласие на рекламу по каналам",
            "description": "У покупателя новое поле marketing_consents — согласие на рекламу по каналам (email, telegram, whatsapp, instagram): строка канала, где покупатель явно согласился (subscribed) или отказался (unsubscribed), и момент последнего явного согласия. Отказ в одном канале больше не снимает рекламу в остальных. В WhatsApp магазин пишет рекламу только при subscribed, в любом режиме согласия.",
            "operations": [
                "customers.list",
                "customers.get",
                "customers.get_by_external_id",
                "customers.create",
                "customers.update",
                "customers.upsert"
            ]
        },
        {
            "key": "customer-accepts-marketing-deprecated",
            "date": "2026-11-13",
            "kind": "deprecated",
            "title": "accepts_marketing и marketing_consent_at устарели",
            "description": "Поля покупателя accepts_marketing и marketing_consent_at устарели и теперь значат согласие на рекламу по почте. Согласие по каналам — marketing_consents. Поля работают, пока работает /v1.",
            "operations": [
                "customers.list",
                "customers.get",
                "customers.get_by_external_id",
                "customers.create",
                "customers.update",
                "customers.upsert"
            ]
        },
        {
            "key": "membership-renewal-void",
            "date": "2026-11-13",
            "kind": "added",
            "title": "Счёт продления абонемента",
            "description": "У заказа новая системная причина отмены cancel_reason = membership_renewal_void: счёт продления абонемента погашен, потому что абонемент отменили или он закончился без оплаты. Денег по такому счёту не было.",
            "operations": [
                "orders.list",
                "orders.get"
            ]
        },
        {
            "key": "draft-order-currency",
            "date": "2026-11-13",
            "kind": "added",
            "title": "Валюта итога при оформлении черновика",
            "description": "Оформление черновика принимает необязательное поле currency — валюту, в которой приложение прочитало итог. Магазин без заказов может сменить валюту, и итог совпал бы числом в другой валюте; теперь такое оформление получает 422, и заказ не создаётся.",
            "operations": [
                "draft_orders.complete"
            ]
        },
        {
            "key": "service-package-expiry",
            "date": "2026-11-13",
            "kind": "added",
            "title": "Сгорание пакета визитов",
            "description": "Визиты пакета, срок которого вышел, становятся продажей дня — заказом, оплаченным способом service_package. Продление срока отменяет такую продажу системой: у заказа появляется причина отмены service_package_term_extended, визиты возвращаются в пакет.",
            "operations": [
                "orders.list",
                "orders.get"
            ]
        },
        {
            "key": "operation-problem-types",
            "date": "2026-11-12",
            "kind": "added",
            "title": "Отказы у каждого метода",
            "description": "У каждого метода в спецификации появилось поле x-problem-types — типы отказов, которые возвращает именно он: свои отказы метода и те, что следуют из его устройства (ключ идемпотентности, версия в If-Match, курсор ленты, диапазон результата, удаление, согласие на последствия). Общие отказы — токен, доступ, проверка входа, лимит запросов, сбои сервера — может вернуть любой метод, их по-прежнему перечисляет каталог x-problem-types документа. Тип stocktake_location_occupied убран из каталога: ни один метод его не возвращал. Методы, которые отвечают конфликтом без ключа идемпотентности, теперь описывают ответ 409.",
            "operations": []
        },
        {
            "key": "rejected-requests-limit",
            "date": "2026-11-12",
            "kind": "changed",
            "title": "Лимит отклонённых запросов",
            "description": "Запросы, отклонённые на входе, — 401 и 403 неразрешённого адреса или тарифа без API — теперь считаются по адресу. Сверх лимита rejected_requests_per_minute адрес получает 429 too_many_requests с policy равным rejected и заголовком Retry-After до конца минуты. Запросы с действующим токеном не считаются, и этот лимит их не отклоняет.",
            "operations": []
        },
        {
            "key": "service-package-redemption",
            "date": "2026-11-12",
            "kind": "added",
            "title": "Визиты из пакетов",
            "description": "Способ оплаты service_package — визит, погашенный пакетом визитов клиента: строку заказа оплатил визит, купленный раньше вместе с пакетом. Деньги за него магазин получил при продаже пакета, поэтому в кассу и на счета этот платёж не приходит, а выручкой заказа визит становится сейчас. Возврат такой строки возвращает визит в пакет — проводка возврата с целью service_package, денег она не двигает.",
            "operations": [
                "payments.list",
                "payments.get",
                "refunds.list",
                "refunds.get",
                "refunds.create",
                "refunds.calculate",
                "orders.list",
                "orders.get",
                "draft_orders.complete"
            ]
        },
        {
            "key": "service-packages",
            "date": "2026-11-12",
            "kind": "added",
            "title": "Пакеты визитов",
            "description": "Вид товара service_package — пакет визитов: набор визитов услуг, который магазин продаёт вперёд. У заказа появилось поле service_package_issue_amount — сумма проданных в нём пакетов. Пакет — обязательство магазина визитами, а не выручка: выручкой становится визит, погашенный пакетом. Вычитайте поле из итога вместе с gift_card_issue_amount, reservation_deposit_amount и account_payment_amount.",
            "operations": [
                "orders.list",
                "orders.get",
                "orders.set_status",
                "orders.cancel",
                "draft_orders.complete",
                "bulk_operations.get_result",
                "products.list",
                "products.create",
                "products.get",
                "products.update",
                "products.get_by_external_id",
                "products.upsert",
                "products.replace_options"
            ]
        },
        {
            "key": "v1",
            "date": "2026-11-11",
            "kind": "released",
            "title": "API для интеграций v1",
            "description": "Первая версия контракта: магазин и его точки, каталог, остатки, заказы и их статусы, черновики заказов, платежи и возвраты, покупатели, загрузки и массовые операции, события и вебхуки. Каждое следующее изменение контракта появится в этом журнале.",
            "operations": []
        }
    ],
    "paths": {
        "/bulk-operations": {
            "get": {
                "operationId": "bulk_operations.list",
                "summary": "Массовые операции приложения, изменённые с указанного момента: прогресс и исходы",
                "tags": [
                    "BulkOperations"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "inventory.set",
                                "products.upsert",
                                "money_transactions.create",
                                "money_transactions.update",
                                "orders.export",
                                "libro_iva.export",
                                "accountant_package.export"
                            ]
                        },
                        "description": "Только операции этого вида."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "pending",
                                "running",
                                "cancelling",
                                "completed",
                                "cancelled",
                                "failed"
                            ]
                        },
                        "description": "Только операции в этом статусе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "bulk:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/BulkOperation"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "bulk_operations.create",
                "summary": "Начать массовую операцию по загрузке или адресу входа, выгрузку ленты или сборку файла",
                "tags": [
                    "BulkOperations"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateBulkOperationRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "bulk:write"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Принято: исход — по адресу из Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BulkOperation"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "bulk_operation_queue_full",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/bulk-operations/{operation}": {
            "get": {
                "operationId": "bulk_operations.get",
                "summary": "Массовая операция",
                "tags": [
                    "BulkOperations"
                ],
                "parameters": [
                    {
                        "name": "operation",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID массовой операции."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "bulk:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BulkOperation"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/bulk-operations/{operation}/result": {
            "get": {
                "operationId": "bulk_operations.get_result",
                "summary": "Результат массовой операции — NDJSON, строка на строку входа или элемент выгрузки, либо ZIP операции-файла; докачка — по Range",
                "tags": [
                    "BulkOperations"
                ],
                "parameters": [
                    {
                        "name": "operation",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID массовой операции."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/Range"
                    },
                    {
                        "$ref": "#/components/parameters/IfRange"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "bulk:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Accept-Ranges": {
                                "$ref": "#/components/headers/AcceptRanges"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ResultETag"
                            }
                        },
                        "content": {
                            "application/x-ndjson": {
                                "schema": {
                                    "anyOf": [
                                        {
                                            "type": "object",
                                            "properties": {
                                                "line": {
                                                    "type": "integer",
                                                    "description": "Номер строки входа, с 1."
                                                },
                                                "status": {
                                                    "type": "integer",
                                                    "description": "HTTP-статус, который строка получила бы отдельным запросом."
                                                },
                                                "body": {
                                                    "type": "object",
                                                    "additionalProperties": true,
                                                    "description": "Ответ на строку: запись в том виде, в каком её отдаёт одиночный запрос, или отказ problem+json."
                                                }
                                            },
                                            "required": [
                                                "line",
                                                "status",
                                                "body"
                                            ]
                                        },
                                        {
                                            "$ref": "#/components/schemas/Order"
                                        }
                                    ]
                                }
                            },
                            "application/zip": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "206": {
                        "description": "Часть результата по Range",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Accept-Ranges": {
                                "$ref": "#/components/headers/AcceptRanges"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ResultETag"
                            },
                            "Content-Range": {
                                "$ref": "#/components/headers/ContentRange"
                            }
                        },
                        "content": {
                            "application/x-ndjson": {
                                "schema": {
                                    "anyOf": [
                                        {
                                            "type": "object",
                                            "properties": {
                                                "line": {
                                                    "type": "integer",
                                                    "description": "Номер строки входа, с 1."
                                                },
                                                "status": {
                                                    "type": "integer",
                                                    "description": "HTTP-статус, который строка получила бы отдельным запросом."
                                                },
                                                "body": {
                                                    "type": "object",
                                                    "additionalProperties": true,
                                                    "description": "Ответ на строку: запись в том виде, в каком её отдаёт одиночный запрос, или отказ problem+json."
                                                }
                                            },
                                            "required": [
                                                "line",
                                                "status",
                                                "body"
                                            ]
                                        },
                                        {
                                            "$ref": "#/components/schemas/Order"
                                        }
                                    ]
                                }
                            },
                            "application/zip": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "416": {
                        "$ref": "#/components/responses/RangeNotSatisfiable"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "bulk_operation_result_unavailable",
                    "range_not_satisfiable"
                ]
            }
        },
        "/bulk-operations/{operation}/cancel": {
            "post": {
                "operationId": "bulk_operations.cancel",
                "summary": "Отменить массовую операцию на границе строки",
                "tags": [
                    "BulkOperations"
                ],
                "parameters": [
                    {
                        "name": "operation",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID массовой операции."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "bulk:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BulkOperation"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "bulk_operation_finished",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/categories": {
            "get": {
                "operationId": "categories.list",
                "summary": "Категории каталога, изменённые с указанного момента",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Category"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "categories.create",
                "summary": "Создать категорию каталога",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateCategoryRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Category"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "plan_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/categories/{category}": {
            "get": {
                "operationId": "categories.get",
                "summary": "Категория каталога",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "name": "category",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID категории."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Category"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "categories.update",
                "summary": "Изменить категорию каталога",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "name": "category",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID категории."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateCategoryRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Category"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "categories.delete",
                "summary": "Архивировать категорию каталога",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "name": "category",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID категории."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "category_archive": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Архив категории отвязывает её товары, поднимает подкатегории на уровень выше и снимает её с маршрутов печати, скидок и подборок."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/categories/by-external-id/{external_id}": {
            "get": {
                "operationId": "categories.get_by_external_id",
                "summary": "Категория каталога по внешнему id",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Внешний id — id записи в вашей системе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Category"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "categories.upsert",
                "summary": "Создать или изменить категорию каталога по внешнему id",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Внешний id — id записи в вашей системе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatchUpsert"
                    },
                    {
                        "$ref": "#/components/parameters/IfNoneMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpsertCategoryRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Category"
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Category"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_archived",
                    "idempotency_key_in_use",
                    "plan_limit_reached",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/consignment-settlements": {
            "get": {
                "operationId": "consignment_settlements.list",
                "summary": "Акты реализации: проданный, списанный за счёт магазина и переоценённый товар на реализации за период",
                "tags": [
                    "ConsignmentSettlements"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только документы этого поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ConsignmentSettlement"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/consignment-settlements/{consignment_settlement}": {
            "get": {
                "operationId": "consignment_settlements.get",
                "summary": "Акт реализации",
                "tags": [
                    "ConsignmentSettlements"
                ],
                "parameters": [
                    {
                        "name": "consignment_settlement",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID акта реализации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConsignmentSettlement"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/customer-account-entries": {
            "get": {
                "operationId": "customer_account_entries.list",
                "summary": "Журнал счетов покупателей: продажа в долг, погашение, возврат, списание, взаимозачёт, удержание и сторно",
                "tags": [
                    "CustomerAccountEntries"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "customer_account_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только записи этого счёта покупателя."
                    },
                    {
                        "name": "payment_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только строки этого платежа."
                    },
                    {
                        "name": "order_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только записи этого заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CustomerAccountEntry"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/customer-account-entries/{customer_account_entry}": {
            "get": {
                "operationId": "customer_account_entries.get",
                "summary": "Запись журнала счёта покупателя",
                "tags": [
                    "CustomerAccountEntries"
                ],
                "parameters": [
                    {
                        "name": "customer_account_entry",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID записи журнала счёта покупателя."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAccountEntry"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/customer-accounts": {
            "get": {
                "operationId": "customer_accounts.list",
                "summary": "Счета покупателей в книге долгов: остаток, кредитный лимит и срок оплаты",
                "tags": [
                    "CustomerAccounts"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CustomerAccount"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/customer-accounts/{customer_account}": {
            "get": {
                "operationId": "customer_accounts.get",
                "summary": "Счёт покупателя",
                "tags": [
                    "CustomerAccounts"
                ],
                "parameters": [
                    {
                        "name": "customer_account",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID счёта покупателя."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAccount"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/customer-accounts/{customer_account}/statement": {
            "get": {
                "operationId": "customer_accounts.get_statement",
                "summary": "Выписка по счёту покупателя за период: долг на начало и конец, движения с нарастающим остатком и открытые долги со сроками",
                "tags": [
                    "CustomerAccounts"
                ],
                "parameters": [
                    {
                        "name": "customer_account",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID счёта покупателя."
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Первый день периода YYYY-MM-DD в часовом поясе магазина; по умолчанию — день первой операции счёта."
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Последний день периода YYYY-MM-DD в часовом поясе магазина; по умолчанию сегодня."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAccountStatement"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/customer-accounts/{customer_account}/payments": {
            "post": {
                "operationId": "customer_accounts.record_payment",
                "summary": "Погашение долга покупателя деньгами, которые уже пришли: запись в книгу долгов со справками об удержаниях",
                "tags": [
                    "CustomerAccounts"
                ],
                "parameters": [
                    {
                        "name": "customer_account",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID счёта покупателя."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/RecordCustomerAccountPaymentRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAccountEntry"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/customers/{customer}/addresses/{address}": {
            "get": {
                "operationId": "customer_addresses.get",
                "summary": "Адрес из книги покупателя",
                "tags": [
                    "CustomerAddresses"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID покупателя."
                    },
                    {
                        "name": "address",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID адреса в адресной книге покупателя."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAddress"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "customer_addresses.update",
                "summary": "Изменить адрес покупателя",
                "tags": [
                    "CustomerAddresses"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID покупателя."
                    },
                    {
                        "name": "address",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID адреса в адресной книге покупателя."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateCustomerAddressRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAddress"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "customer_addresses.delete",
                "summary": "Удалить адрес из книги покупателя",
                "tags": [
                    "CustomerAddresses"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID покупателя."
                    },
                    {
                        "name": "address",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID адреса в адресной книге покупателя."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/customers/{customer}/addresses": {
            "post": {
                "operationId": "customer_addresses.create",
                "summary": "Добавить адрес в книгу покупателя",
                "tags": [
                    "CustomerAddresses"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID покупателя."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateCustomerAddressRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAddress"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "address_book_full",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/customers/{customer}/fiscal-profile": {
            "get": {
                "operationId": "customer_fiscal_profiles.get",
                "summary": "Фискальные реквизиты покупателя",
                "tags": [
                    "CustomerFiscalProfiles"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID покупателя."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerFiscalProfile"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "put": {
                "operationId": "customer_fiscal_profiles.replace",
                "summary": "Заменить фискальные реквизиты покупателя целиком; null — розничный покупатель",
                "tags": [
                    "CustomerFiscalProfiles"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID покупателя."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ReplaceCustomerFiscalProfileRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerFiscalProfile"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/customer-groups": {
            "get": {
                "operationId": "customer_groups.list",
                "summary": "Группы покупателей магазина: имя, описание и активность",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CustomerGroup"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "customer_groups.create",
                "summary": "Создать группу покупателей",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateCustomerGroupRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "record_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/customer-groups/{customer_group}": {
            "get": {
                "operationId": "customer_groups.get",
                "summary": "Группа покупателей",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "name": "customer_group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID группы покупателей."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "customer_groups.update",
                "summary": "Изменить имя, описание или активность группы",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "name": "customer_group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID группы покупателей."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "customer_groups.delete",
                "summary": "Удалить группу: членство уходит с ней, правила скидок и рассылки от неё отвязываются",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "name": "customer_group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID группы покупателей."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/customer-groups/{customer_group}/members": {
            "post": {
                "operationId": "customer_groups.add_members",
                "summary": "Добавить покупателей в группу",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "name": "customer_group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID группы покупателей."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ChangeCustomerGroupMembersRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/customer-groups/{customer_group}/members/remove": {
            "post": {
                "operationId": "customer_groups.remove_members",
                "summary": "Снять покупателей с группы",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "name": "customer_group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID группы покупателей."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ChangeCustomerGroupMembersRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/customers": {
            "get": {
                "operationId": "customers.list",
                "summary": "Покупатели, изменённые с указанного момента: контакты, согласие на рассылки, адреса и группы; поиск по телефону, email и группе",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "phone",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 32
                        },
                        "description": "Только покупатели с этим телефоном в формате E.164."
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 254
                        },
                        "description": "Только покупатели с этим email."
                    },
                    {
                        "name": "group_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только покупатели этой группы — её состав сейчас."
                    },
                    {
                        "name": "wholesale_price_list_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только покупатели, которым назначен этот оптовый прайс-лист."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Customer"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "customers.create",
                "summary": "Создать покупателя: имя и хотя бы один контакт",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateCustomerRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "customer_contact_in_use",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/customers/{customer}": {
            "get": {
                "operationId": "customers.get",
                "summary": "Покупатель",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID покупателя."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "customers.update",
                "summary": "Изменить имя, язык и внешний id покупателя",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID покупателя."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateCustomerRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "customer_contact_in_use",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/customers/by-external-id/{external_id}": {
            "get": {
                "operationId": "customers.get_by_external_id",
                "summary": "Покупатель по внешнему id",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Внешний id — id записи в вашей системе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "customers.upsert",
                "summary": "Создать или изменить покупателя по внешнему id",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Внешний id — id записи в вашей системе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatchUpsert"
                    },
                    {
                        "$ref": "#/components/parameters/IfNoneMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpsertCustomerRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "customer_contact_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/customers/{customer}/wholesale-price-list": {
            "post": {
                "operationId": "customers.set_wholesale_price_list",
                "summary": "Назначить покупателю оптовый прайс-лист или снять его",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID покупателя."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SetCustomerWholesalePriceListRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write",
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/delivery-methods": {
            "get": {
                "operationId": "delivery_methods.list",
                "summary": "Способы доставки магазина",
                "tags": [
                    "DeliveryMethods"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/DeliveryMethod"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/draft-orders/{draft}": {
            "get": {
                "operationId": "draft_orders.get",
                "summary": "Черновик заказа: позиции, итоги и что мешает оформлению",
                "tags": [
                    "DraftOrders"
                ],
                "parameters": [
                    {
                        "name": "draft",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID черновика заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DraftOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "draft_orders.update",
                "summary": "Изменить черновик заказа: покупателя, доставку, способ оплаты и позиции",
                "tags": [
                    "DraftOrders"
                ],
                "parameters": [
                    {
                        "name": "draft",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID черновика заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateDraftOrderRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DraftOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "draft_order_closed",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "draft_orders.delete",
                "summary": "Удалить черновик заказа",
                "tags": [
                    "DraftOrders"
                ],
                "parameters": [
                    {
                        "name": "draft",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID черновика заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/draft-orders": {
            "post": {
                "operationId": "draft_orders.create",
                "summary": "Создать черновик заказа для покупателя",
                "tags": [
                    "DraftOrders"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateDraftOrderRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DraftOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/draft-orders/{draft}/complete": {
            "post": {
                "operationId": "draft_orders.complete",
                "summary": "Оформить заказ из черновика: выставить счёт покупателю или записать оплату полученной",
                "tags": [
                    "DraftOrders"
                ],
                "parameters": [
                    {
                        "name": "draft",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID черновика заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CompleteDraftOrderRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "draft_order_closed",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/events": {
            "get": {
                "operationId": "events.list",
                "summary": "События магазина за 30 дней: что изменилось в заказах, платежах, возвратах, фискальных документах, налоговых периодах, товарах, остатках и покупателях — с записью в её нынешнем виде",
                "tags": [
                    "Events"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "order.created",
                                "order.updated",
                                "order.status_changed",
                                "order.paid",
                                "order.cancelled",
                                "payment.created",
                                "payment.succeeded",
                                "payment.status_changed",
                                "payment.updated",
                                "refund.created",
                                "refund.completed",
                                "refund.status_changed",
                                "refund.updated",
                                "fiscal_document.created",
                                "fiscal_document.updated",
                                "fiscal_document.issued",
                                "fiscal_document.failed",
                                "fiscal_document.annulled",
                                "tax_period.status_changed",
                                "money_transaction.created",
                                "money_transaction.updated",
                                "money_transaction.deleted",
                                "pos_shift.opened",
                                "pos_shift.closed",
                                "pos_shift.updated",
                                "pos_cash_movement.created",
                                "gift_card.created",
                                "gift_card.updated",
                                "gift_card_transaction.created",
                                "customer_account.created",
                                "customer_account.updated",
                                "customer_account_entry.created",
                                "customer_account_entry.updated",
                                "supplier.created",
                                "supplier.updated",
                                "supplier.deleted",
                                "supplier_bill.created",
                                "supplier_bill.updated",
                                "supplier_bill.posted",
                                "supplier_bill.voided",
                                "supplier_bill.deleted",
                                "supplier_bill_payment.created",
                                "supplier_bill_payment.updated",
                                "supplier_bill_payment.deleted",
                                "settlement_agreement.created",
                                "settlement_agreement.updated",
                                "settlement_agreement.deleted",
                                "settlement_offset.created",
                                "settlement_offset.updated",
                                "settlement_offset.voided",
                                "purchase_order.created",
                                "purchase_order.updated",
                                "purchase_order.status_changed",
                                "purchase_order.deleted",
                                "goods_receipt.created",
                                "goods_receipt.updated",
                                "goods_receipt.voided",
                                "supplier_return.created",
                                "supplier_return.updated",
                                "supplier_return.status_changed",
                                "supplier_return.deleted",
                                "consignment_settlement.created",
                                "consignment_settlement.updated",
                                "consignment_settlement.posted",
                                "consignment_settlement.voided",
                                "tax_withholding.created",
                                "tax_withholding.updated",
                                "tax_withholding.annulled",
                                "tax_withholding.deleted",
                                "product.created",
                                "product.updated",
                                "product.deleted",
                                "inventory_level.updated",
                                "stock_movement.created",
                                "stock_movement.updated",
                                "lot.created",
                                "lot.updated",
                                "lot.deleted",
                                "location_transfer.created",
                                "location_transfer.updated",
                                "stocktake.created",
                                "stocktake.status_changed",
                                "stocktake.updated",
                                "customer.created",
                                "customer.updated",
                                "customer.deleted",
                                "customer_group.created",
                                "customer_group.updated",
                                "customer_group.deleted",
                                "price_list.created",
                                "price_list.updated",
                                "price_list.deleted",
                                "bulk_operation.finished"
                            ]
                        },
                        "description": "Только события этого типа, например order.paid."
                    },
                    {
                        "name": "created_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только события, созданные после этого момента."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Event"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/exchange-rates/{currency}": {
            "get": {
                "operationId": "exchange_rates.get",
                "summary": "Курс дня учёта валюты на дату: по нему журнал денег пересчитывает движения по валютным счетам",
                "tags": [
                    "ExchangeRates"
                ],
                "parameters": [
                    {
                        "name": "currency",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Код валюты ISO 4217 или актива (USDT, USDC) из набора валют денежного счёта."
                    },
                    {
                        "name": "date",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Учётная дата YYYY-MM-DD в часовом поясе магазина; по умолчанию сегодня."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ExchangeRate"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/fiscal-documents": {
            "get": {
                "operationId": "fiscal_documents.list",
                "summary": "Фискальные документы, изменённые с указанного момента: фактуры, кредит- и дебет-ноты во всех статусах",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "order_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только записи этого заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/FiscalDocument"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/fiscal-documents/{document}": {
            "get": {
                "operationId": "fiscal_documents.get",
                "summary": "Фискальный документ",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "document",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID фискального документа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FiscalDocument"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/fiscal-documents/{document}/pdf": {
            "get": {
                "operationId": "fiscal_documents.get_pdf",
                "summary": "PDF фискального документа — тот же файл, что получает покупатель",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "document",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID фискального документа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/pdf": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "fiscal_document_pdf_unavailable"
                ]
            }
        },
        "/orders/{order}/invoice": {
            "post": {
                "operationId": "fiscal_documents.issue_invoice",
                "summary": "Выпустить фактуру по закрытой продаже: выпуск идёт в фоне, итог — событием",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKeyRequired"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:write"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Принято: исход — по адресу из Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FiscalDocument"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "invoice_issue_refused",
                    "idempotency_key_required",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/fiscal-documents/{document}/reissue": {
            "post": {
                "operationId": "fiscal_documents.reissue",
                "summary": "Перевыпустить документ после сбоя или отказа налоговой",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "document",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID фискального документа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKeyRequired"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ReissueFiscalDocumentRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "fiscal:write"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Принято: исход — по адресу из Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FiscalDocument"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "fiscal_document_reissue_refused",
                    "idempotency_key_in_use",
                    "idempotency_key_required",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/fiscal-documents/{document}/dismiss": {
            "post": {
                "operationId": "fiscal_documents.dismiss",
                "summary": "Снять отклонённый документ с контроля: выпускать его не будут",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "document",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID фискального документа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/DismissFiscalDocumentRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "fiscal:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FiscalDocument"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "fiscal_document_dismiss_refused",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/fiscal-documents/{document}/annul": {
            "post": {
                "operationId": "fiscal_documents.annul",
                "summary": "Аннулировать выпущенную фактуру кредит-нотой",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "document",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID фискального документа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKeyRequired"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/AnnulFiscalDocumentRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "fiscal:annul"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Принято: исход — по адресу из Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FiscalDocument"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "fiscal_document_annul_refused",
                    "idempotency_key_in_use",
                    "idempotency_key_required",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/gift-card-transactions": {
            "get": {
                "operationId": "gift_card_transactions.list",
                "summary": "Журнал подарочных карт: выпуск, погашение, возврат на карту, корректировка, аннулирование, блокировка и перенос остатка",
                "tags": [
                    "GiftCardTransactions"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "gift_card_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только строки этой подарочной карты."
                    },
                    {
                        "name": "payment_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только строки этого платежа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/GiftCardTransaction"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/gift-card-transactions/{entry}": {
            "get": {
                "operationId": "gift_card_transactions.get",
                "summary": "Строка журнала подарочной карты",
                "tags": [
                    "GiftCardTransactions"
                ],
                "parameters": [
                    {
                        "name": "entry",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID строки журнала подарочной карты."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GiftCardTransaction"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/gift-cards": {
            "get": {
                "operationId": "gift_cards.list",
                "summary": "Подарочные карты: номинал, остаток и долг магазина по каждой карте",
                "tags": [
                    "GiftCards"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/GiftCard"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/gift-cards/{card}": {
            "get": {
                "operationId": "gift_cards.get",
                "summary": "Подарочная карта",
                "tags": [
                    "GiftCards"
                ],
                "parameters": [
                    {
                        "name": "card",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID подарочной карты."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GiftCard"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/goods-receipts": {
            "get": {
                "operationId": "goods_receipts.list",
                "summary": "Приёмки: приход от поставщика со строками, ценами накладной и корректировками",
                "tags": [
                    "GoodsReceipts"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только документы этого поставщика."
                    },
                    {
                        "name": "purchase_order_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только приёмки по этому заказу поставщику."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/GoodsReceipt"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/goods-receipts/{goods_receipt}": {
            "get": {
                "operationId": "goods_receipts.get",
                "summary": "Приёмка",
                "tags": [
                    "GoodsReceipts"
                ],
                "parameters": [
                    {
                        "name": "goods_receipt",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID приёмки."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GoodsReceipt"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/inventory-levels": {
            "get": {
                "operationId": "inventory_levels.list",
                "summary": "Остатки по точкам, изменённые с указанного момента",
                "tags": [
                    "InventoryLevels"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "variant_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только остатки этого варианта."
                    },
                    {
                        "name": "location_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только остатки этой точки."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/InventoryLevel"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/inventory-levels/set": {
            "post": {
                "operationId": "inventory_levels.set",
                "summary": "Установить физический остаток варианта на точке",
                "tags": [
                    "InventoryLevels"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SetInventoryLevelRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "inventory:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/InventoryChange"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "stock_held_by_write_offs",
                    "stock_on_hand_changed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/inventory-levels/adjust": {
            "post": {
                "operationId": "inventory_levels.adjust",
                "summary": "Оприходовать или списать остаток на точке",
                "tags": [
                    "InventoryLevels"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/AdjustInventoryLevelRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "inventory:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/InventoryChange"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/legal-entities": {
            "get": {
                "operationId": "legal_entities.list",
                "summary": "Юрлица магазина: эмитенты фискальных документов и владельцы налоговых периодов",
                "tags": [
                    "LegalEntities"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LegalEntity"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/location-transfers": {
            "get": {
                "operationId": "location_transfers.list",
                "summary": "Акты перемещения товара между точками со строками, изменённые с указанного момента",
                "tags": [
                    "LocationTransfers"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "source_location_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только акты, вывезшие товар с этой точки."
                    },
                    {
                        "name": "destination_location_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только акты, привёзшие товар на эту точку."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LocationTransfer"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/location-transfers/{location_transfer}": {
            "get": {
                "operationId": "location_transfers.get",
                "summary": "Акт перемещения",
                "tags": [
                    "LocationTransfers"
                ],
                "parameters": [
                    {
                        "name": "location_transfer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID акта перемещения."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/LocationTransfer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/locations": {
            "get": {
                "operationId": "locations.list",
                "summary": "Точки магазина, доступные приложению",
                "tags": [
                    "Locations"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "locations:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Location"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/lots": {
            "get": {
                "operationId": "lots.list",
                "summary": "Партии товара: номер, срок годности и статус, изменённые с указанного момента",
                "tags": [
                    "Lots"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "variant_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только партии этого варианта."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Lot"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/lots/{lot}": {
            "get": {
                "operationId": "lots.get",
                "summary": "Партия товара",
                "tags": [
                    "Lots"
                ],
                "parameters": [
                    {
                        "name": "lot",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID партии."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Lot"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/manual-payment-methods": {
            "get": {
                "operationId": "manual_payment_methods.list",
                "summary": "Ручные способы оплаты магазина",
                "tags": [
                    "ManualPaymentMethods"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ManualPaymentMethod"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/me": {
            "get": {
                "operationId": "me.get",
                "summary": "Приложение токена, его доступ и лимиты",
                "tags": [
                    "Me"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Me"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/media-imports": {
            "get": {
                "operationId": "media_imports.list",
                "summary": "Загрузки фото по адресу, изменённые с указанного момента: ждут, загружены или отказ",
                "tags": [
                    "MediaImports"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "product_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только записи этого товара."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "pending",
                                "succeeded",
                                "failed"
                            ]
                        },
                        "description": "Только загрузки в этом статусе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/MediaImport"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/media-imports/{import}": {
            "get": {
                "operationId": "media_imports.get",
                "summary": "Загрузка фото по адресу",
                "tags": [
                    "MediaImports"
                ],
                "parameters": [
                    {
                        "name": "import",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID загрузки фото."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MediaImport"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/modifier-groups": {
            "get": {
                "operationId": "modifier_groups.list",
                "summary": "Группы модификаторов с опциями, изменённые с указанного момента",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ModifierGroup"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "modifier_groups.create",
                "summary": "Создать группу модификаторов с опциями",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateModifierGroupRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ModifierGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "record_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/modifier-groups/{group}": {
            "get": {
                "operationId": "modifier_groups.get",
                "summary": "Группа модификаторов с опциями",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID группы модификаторов."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ModifierGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "modifier_groups.update",
                "summary": "Изменить группу модификаторов и её набор опций",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID группы модификаторов."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "modifier_product_minimum": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "У товаров со своим правилом выбора минимум станет равен числу включённых опций группы, иначе их нельзя будет купить."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateModifierGroupRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ModifierGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "modifier_groups.delete",
                "summary": "Архивировать группу модификаторов",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID группы модификаторов."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "modifier_group_archive": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Архив группы снимает её с товаров, ломает выбор в корзинах покупателей и убирает её опции из открытых черновиков заказов."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/modifier-groups/by-external-id/{external_id}": {
            "get": {
                "operationId": "modifier_groups.get_by_external_id",
                "summary": "Группа модификаторов по внешнему id",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Внешний id — id записи в вашей системе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ModifierGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "modifier_groups.upsert",
                "summary": "Создать или изменить группу модификаторов по внешнему id",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Внешний id — id записи в вашей системе."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "modifier_product_minimum": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "У товаров со своим правилом выбора минимум станет равен числу включённых опций группы, иначе их нельзя будет купить."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatchUpsert"
                    },
                    {
                        "$ref": "#/components/parameters/IfNoneMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpsertModifierGroupRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ModifierGroup"
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ModifierGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "record_limit_reached",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/money-accounts": {
            "get": {
                "operationId": "money_accounts.list",
                "summary": "Денежные счета магазина с текущим остатком: касса, банк, эквайринг, кошелёк",
                "tags": [
                    "MoneyAccounts"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/MoneyAccount"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/money-accounts/{account}": {
            "get": {
                "operationId": "money_accounts.get",
                "summary": "Денежный счёт",
                "tags": [
                    "MoneyAccounts"
                ],
                "parameters": [
                    {
                        "name": "account",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID денежного счёта."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyAccount"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/money-categories": {
            "get": {
                "operationId": "money_categories.list",
                "summary": "Статьи движений денег: дерево приходов и расходов с кодами системных статей",
                "tags": [
                    "MoneyCategories"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/MoneyCategory"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/money-transactions": {
            "get": {
                "operationId": "money_transactions.list",
                "summary": "Движения денег, изменённые с указанного момента: приходы и расходы по счетам с источником и первичным документом",
                "tags": [
                    "MoneyTransactions"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "account_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только движения этого денежного счёта."
                    },
                    {
                        "name": "transfer_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только ноги этого перевода между счетами."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/MoneyTransaction"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "money_transactions.create",
                "summary": "Ручной доход или расход по денежному счёту",
                "tags": [
                    "MoneyTransactions"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateMoneyTransactionRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyTransaction"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/money-transactions/{transaction}": {
            "get": {
                "operationId": "money_transactions.get",
                "summary": "Движение денег",
                "tags": [
                    "MoneyTransactions"
                ],
                "parameters": [
                    {
                        "name": "transaction",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID движения денег."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyTransaction"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "money_transactions.update",
                "summary": "Правка движения денег: у движения с документом-источником — только статья, контрагент и описание",
                "tags": [
                    "MoneyTransactions"
                ],
                "parameters": [
                    {
                        "name": "transaction",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID движения денег."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateMoneyTransactionRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyTransaction"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "money_transaction_locked",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "money_transactions.delete",
                "summary": "Удаление ручного движения денег с возвратом остатка счёта",
                "tags": [
                    "MoneyTransactions"
                ],
                "parameters": [
                    {
                        "name": "transaction",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID движения денег."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "money_transaction_locked",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/money-transfers/{money_transfer}": {
            "get": {
                "operationId": "money_transfers.get",
                "summary": "Перевод между денежными счетами",
                "tags": [
                    "MoneyTransfers"
                ],
                "parameters": [
                    {
                        "name": "money_transfer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID перевода — transfer_id его частей в журнале движений."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyTransfer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "money_transfers.update",
                "summary": "Правка перевода целиком на месте: счета, суммы, комиссия, дата и описание",
                "tags": [
                    "MoneyTransfers"
                ],
                "parameters": [
                    {
                        "name": "money_transfer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID перевода — transfer_id его частей в журнале движений."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateMoneyTransferRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyTransfer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "money_transfers.delete",
                "summary": "Удаление перевода со всеми его частями",
                "tags": [
                    "MoneyTransfers"
                ],
                "parameters": [
                    {
                        "name": "money_transfer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID перевода — transfer_id его частей в журнале движений."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/money-transfers": {
            "post": {
                "operationId": "money_transfers.create",
                "summary": "Перевод между денежными счетами, с комиссией или без",
                "tags": [
                    "MoneyTransfers"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateMoneyTransferRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyTransfer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/order-statuses": {
            "get": {
                "operationId": "order_statuses.list",
                "summary": "Статусы заказа магазина и переходы между ними",
                "tags": [
                    "OrderStatuses"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/OrderStatus"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/orders": {
            "get": {
                "operationId": "orders.list",
                "summary": "Заказы, изменённые с указанного момента: позиции, суммы, статус заказа и статус оплаты",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "number",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 16
                        },
                        "description": "Только заказ с этим номером."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Order"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/orders/{order}": {
            "get": {
                "operationId": "orders.get",
                "summary": "Заказ",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/orders/{order}/shipment/label": {
            "get": {
                "operationId": "orders.get_shipment_label",
                "summary": "Наклейка текущего отправления заказа у перевозчика, PDF; на ней данные получателя, поэтому нужен и customers:read",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read",
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/pdf": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "shipment_label_unavailable",
                    "carrier_unavailable"
                ]
            }
        },
        "/orders/{order}/status": {
            "post": {
                "operationId": "orders.set_status",
                "summary": "Перевести заказ в другой статус магазина",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SetOrderStatusRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "order_transition_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/orders/{order}/cancel": {
            "post": {
                "operationId": "orders.cancel",
                "summary": "Отменить заказ",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "order_cancel": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Отмена заказа возвращает полученные деньги покупателю, в подписку или в бронь, выпускает кредит-ноту на фискальный документ, отменяет отправление перевозчика и оставляет уже собранный товар в потерях."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CancelOrderRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "order_cancel_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/orders/{order}/shipment": {
            "post": {
                "operationId": "orders.create_shipment",
                "summary": "Выпустить отправление у перевозчика заказа: запрос исполняется в фоне, итог — в заказе и событием order.updated",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Принято: исход — по адресу из Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "shipment_in_progress",
                    "shipment_outcome_unknown",
                    "shipment_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/orders/{order}/shipment/tracking": {
            "post": {
                "operationId": "orders.set_shipment_tracking",
                "summary": "Записать номер отслеживания у службы доставки без интеграции: номер, ссылку и название службы",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SetOrderShipmentTrackingRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "shipment_in_progress",
                    "shipment_tracking_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/orders/{order}/shipment/tracking/clear": {
            "post": {
                "operationId": "orders.clear_shipment_tracking",
                "summary": "Снять номер отслеживания, записанный вручную",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "shipment_in_progress",
                    "shipment_tracking_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/payments": {
            "get": {
                "operationId": "payments.list",
                "summary": "Платежи по заказам, изменённые с указанного момента",
                "tags": [
                    "Payments"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "order_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только записи этого заказа."
                    },
                    {
                        "name": "pos_shift_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только записи, принятые этой кассовой сменой."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "payments:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Payment"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/payments/{payment}": {
            "get": {
                "operationId": "payments.get",
                "summary": "Платёж по заказу",
                "tags": [
                    "Payments"
                ],
                "parameters": [
                    {
                        "name": "payment",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID платежа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "payments:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Payment"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/payments/{payment}/confirm": {
            "post": {
                "operationId": "payments.confirm",
                "summary": "Подтвердить, что деньги по ожидающему счёту получены",
                "tags": [
                    "Payments"
                ],
                "parameters": [
                    {
                        "name": "payment",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID платежа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ConfirmPaymentRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "payments:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Payment"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "payment_not_confirmable",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/pos-cash-movements": {
            "get": {
                "operationId": "pos_cash_movements.list",
                "summary": "Журнал денежного ящика: продажи и возвраты налом, внесения, выдачи, сдача в сейф, размен и сторно",
                "tags": [
                    "PosCashMovements"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "shift_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только движения этой кассовой смены."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PosCashMovement"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/pos-cash-movements/{movement}": {
            "get": {
                "operationId": "pos_cash_movements.get",
                "summary": "Движение денежного ящика",
                "tags": [
                    "PosCashMovements"
                ],
                "parameters": [
                    {
                        "name": "movement",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID движения денежного ящика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PosCashMovement"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/pos-cash-reasons": {
            "get": {
                "operationId": "pos_cash_reasons.list",
                "summary": "Причины внесения и выдачи наличных со статьёй журнала денег",
                "tags": [
                    "PosCashReasons"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PosCashReason"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/pos-shifts": {
            "get": {
                "operationId": "pos_shifts.list",
                "summary": "Кассовые смены, изменённые с указанного момента: сверка денежного ящика по каждой валюте",
                "tags": [
                    "PosShifts"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PosShift"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/pos-shifts/{shift}": {
            "get": {
                "operationId": "pos_shifts.get",
                "summary": "Кассовая смена",
                "tags": [
                    "PosShifts"
                ],
                "parameters": [
                    {
                        "name": "shift",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID кассовой смены."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PosShift"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/price-list-items": {
            "get": {
                "operationId": "price_list_items.list",
                "summary": "Ручные цены вариантов в прайс-листах, изменённые с указанного момента",
                "tags": [
                    "PriceListItems"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "price_list_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только цены этого прайс-листа."
                    },
                    {
                        "name": "variant_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только цены этого варианта во всех листах."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PriceListItem"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/price-list-items/{price_list_item}": {
            "get": {
                "operationId": "price_list_items.get",
                "summary": "Ручная цена варианта в прайс-листе",
                "tags": [
                    "PriceListItems"
                ],
                "parameters": [
                    {
                        "name": "price_list_item",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID ручной цены в прайс-листе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceListItem"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/price-lists/{price_list}/items": {
            "post": {
                "operationId": "price_lists.set_items",
                "summary": "Задать ручные цены вариантов в прайс-листе пачкой",
                "tags": [
                    "PriceListItems"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID прайс-листа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SetPriceListItemsRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    },
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/price-lists/{price_list}/items/remove": {
            "post": {
                "operationId": "price_lists.remove_items",
                "summary": "Снять ручные цены вариантов в прайс-листе пачкой",
                "tags": [
                    "PriceListItems"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID прайс-листа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/RemovePriceListItemsRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    },
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/price-list-modifier-items": {
            "get": {
                "operationId": "price_list_modifier_items.list",
                "summary": "Ручные надбавки опций модификаторов в прайс-листах, изменённые с указанного момента",
                "tags": [
                    "PriceListModifierItems"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "price_list_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только надбавки этого прайс-листа."
                    },
                    {
                        "name": "modifier_option_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только надбавки этой опции во всех листах."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PriceListModifierItem"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/price-list-modifier-items/{price_list_modifier_item}": {
            "get": {
                "operationId": "price_list_modifier_items.get",
                "summary": "Ручная надбавка опции в прайс-листе",
                "tags": [
                    "PriceListModifierItems"
                ],
                "parameters": [
                    {
                        "name": "price_list_modifier_item",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID ручной надбавки в прайс-листе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceListModifierItem"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/price-lists/{price_list}/modifier-items": {
            "post": {
                "operationId": "price_lists.set_modifier_items",
                "summary": "Задать ручные надбавки опций в прайс-листе пачкой",
                "tags": [
                    "PriceListModifierItems"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID прайс-листа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SetPriceListModifierItemsRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    },
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/price-lists/{price_list}/modifier-items/remove": {
            "post": {
                "operationId": "price_lists.remove_modifier_items",
                "summary": "Снять ручные надбавки опций в прайс-листе пачкой",
                "tags": [
                    "PriceListModifierItems"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID прайс-листа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/RemovePriceListModifierItemsRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    },
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/price-lists": {
            "get": {
                "operationId": "price_lists.list",
                "summary": "Прайс-листы магазина: листы точек и оптовые, их правило и округление",
                "tags": [
                    "PriceLists"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "kind",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "location",
                                "wholesale"
                            ]
                        },
                        "description": "Только листы этого вида: location — листы точек, wholesale — оптовые."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PriceList"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "price_lists.create",
                "summary": "Завести оптовый прайс-лист",
                "tags": [
                    "PriceLists"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreatePriceListRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/price-lists/{price_list}": {
            "get": {
                "operationId": "price_lists.get",
                "summary": "Прайс-лист",
                "tags": [
                    "PriceLists"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID прайс-листа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "price_lists.update",
                "summary": "Изменить прайс-лист: процент и округление, у оптового — и имя; правило листа точки меняет цены во всех его точках",
                "tags": [
                    "PriceLists"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID прайс-листа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdatePriceListRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    },
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "price_lists.delete",
                "summary": "Удалить оптовый прайс-лист; назначение покупателям снимается с согласия",
                "tags": [
                    "PriceLists"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID прайс-листа."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "wholesale_price_list_buyers": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Оптовый лист назначен покупателям: удаление снимает назначение, и их оптовые продажи пойдут по базовым ценам. buyers — сколько покупателей затронет."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/products/{product}/media/{media}": {
            "get": {
                "operationId": "product_media.get",
                "summary": "Фото галереи товара",
                "tags": [
                    "ProductMedia"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID товара."
                    },
                    {
                        "name": "media",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID фото — id в media товара."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ProductMedia"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "product_media.update",
                "summary": "Переставить фото в галерее или сделать главным",
                "tags": [
                    "ProductMedia"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID товара."
                    },
                    {
                        "name": "media",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID фото — id в media товара."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateProductMediaRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ProductMedia"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "product_media.delete",
                "summary": "Убрать фото из галереи товара",
                "tags": [
                    "ProductMedia"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID товара."
                    },
                    {
                        "name": "media",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID фото — id в media товара."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/products/{product}/media": {
            "post": {
                "operationId": "product_media.create",
                "summary": "Добавить фото в галерею товара по адресу картинки",
                "tags": [
                    "ProductMedia"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID товара."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateProductMediaRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Принято: исход — по адресу из Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MediaImport"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/products/{product}/modifier-groups": {
            "get": {
                "operationId": "products.get_modifier_groups",
                "summary": "Группы модификаторов товара и надбавки их опций по вариантам",
                "tags": [
                    "ProductModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID товара."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ProductModifierGroups"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "put": {
                "operationId": "products.replace_modifier_groups",
                "summary": "Заменить группы модификаторов товара и надбавки их опций по вариантам",
                "tags": [
                    "ProductModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID товара."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ReplaceProductModifierGroupsRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ProductModifierGroups"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/products": {
            "get": {
                "operationId": "products.list",
                "summary": "Товары: категории, опции и фото, без вариантов",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Product"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "products.create",
                "summary": "Создать товар вместе с вариантами",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateProductRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "plan_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/products/{product}": {
            "get": {
                "operationId": "products.get",
                "summary": "Товар",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID товара."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "products.update",
                "summary": "Изменить карточку товара: поля, категории, внешний id",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID товара."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateProductRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "products.delete",
                "summary": "Архивировать товар вместе с вариантами",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID товара."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "recipe_ingredient": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Позиция — ингредиент действующих техкарт и уйдёт из них."
                                },
                                "production_draft": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Черновики производственных актов с позицией будут отменены."
                                },
                                "program_menu": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Блюдо уйдёт из меню программ питания по подписке."
                                },
                                "live_subscriptions": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Программа с действующими подписками уйдёт из продажи."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/products/by-external-id/{external_id}": {
            "get": {
                "operationId": "products.get_by_external_id",
                "summary": "Товар по внешнему id",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Внешний id — id записи в вашей системе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "products.upsert",
                "summary": "Создать или изменить товар вместе с вариантами по внешнему id",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Внешний id — id записи в вашей системе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatchUpsert"
                    },
                    {
                        "$ref": "#/components/parameters/IfNoneMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpsertProductRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "plan_limit_reached",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/products/{product}/options": {
            "put": {
                "operationId": "products.replace_options",
                "summary": "Заменить опции товара целиком и разложить по ним его варианты",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID товара."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "variant_axes": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Варианты с одинаковой комбинацией сольются, а названные к архиву уйдут в архив вместе со своими зависимостями."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ReplaceProductOptionsRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/purchase-orders": {
            "get": {
                "operationId": "purchase_orders.list",
                "summary": "Заказы поставщику: заказано, подтверждено поставщиком и принято по строкам",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только документы этого поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PurchaseOrder"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "purchase_orders.create",
                "summary": "Создать черновик заказа поставщику",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreatePurchaseOrderRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PurchaseOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/purchase-orders/{purchase_order}": {
            "get": {
                "operationId": "purchase_orders.get",
                "summary": "Заказ поставщику",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "purchase_order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа поставщику."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PurchaseOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "purchase_orders.update",
                "summary": "Изменить заказ поставщику: черновик целиком, размещённый — строки, дату и примечание с ревизией",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "purchase_order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа поставщику."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PurchaseOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "idempotency_key_in_use",
                    "purchase_order_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "purchase_orders.delete",
                "summary": "Удалить черновик заказа поставщику",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "purchase_order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа поставщику."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "purchase_order_follow_up": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Черновик — дозаказ по решению «докупим у другого» в ответе поставщика другого заказа: удаление снимает это решение, и расхождение исходного заказа снова ждёт решения. source_orders — сколько исходных заказов затронет."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "consent_required",
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "purchase_order_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/purchase-orders/{purchase_order}/place": {
            "post": {
                "operationId": "purchase_orders.place",
                "summary": "Отметить черновик размещённым у поставщика",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "purchase_order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа поставщику."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PurchaseOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "idempotency_key_in_use",
                    "purchase_order_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/purchase-orders/{purchase_order}/cancel": {
            "post": {
                "operationId": "purchase_orders.cancel",
                "summary": "Отменить размещённый заказ поставщику",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "purchase_order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа поставщику."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PurchaseOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "idempotency_key_in_use",
                    "purchase_order_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/purchase-orders/{purchase_order}/close": {
            "post": {
                "operationId": "purchase_orders.close",
                "summary": "Закрыть принятый заказ поставщику",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "purchase_order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа поставщику."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PurchaseOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "idempotency_key_in_use",
                    "purchase_order_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/recommendation-rules": {
            "get": {
                "operationId": "recommendation_rules.list",
                "summary": "Правила рекомендаций, изменённые с указанного момента",
                "tags": [
                    "RecommendationRules"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/RecommendationRule"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "recommendation_rules.create",
                "summary": "Создать правило рекомендаций",
                "tags": [
                    "RecommendationRules"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateRecommendationRuleRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/RecommendationRule"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "record_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/recommendation-rules/{rule}": {
            "get": {
                "operationId": "recommendation_rules.get",
                "summary": "Правило рекомендаций",
                "tags": [
                    "RecommendationRules"
                ],
                "parameters": [
                    {
                        "name": "rule",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID правила рекомендаций."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/RecommendationRule"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "recommendation_rules.update",
                "summary": "Изменить правило рекомендаций",
                "tags": [
                    "RecommendationRules"
                ],
                "parameters": [
                    {
                        "name": "rule",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID правила рекомендаций."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateRecommendationRuleRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/RecommendationRule"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "recommendation_rules.delete",
                "summary": "Удалить правило рекомендаций",
                "tags": [
                    "RecommendationRules"
                ],
                "parameters": [
                    {
                        "name": "rule",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID правила рекомендаций."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/refunds": {
            "get": {
                "operationId": "refunds.list",
                "summary": "Возвраты по заказам, изменённые с указанного момента: позиции и проводки по платежам",
                "tags": [
                    "Refunds"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "order_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только записи этого заказа."
                    },
                    {
                        "name": "pos_shift_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только записи, принятые этой кассовой сменой."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "refunds:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Refund"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/refunds/{refund}": {
            "get": {
                "operationId": "refunds.get",
                "summary": "Возврат по заказу",
                "tags": [
                    "Refunds"
                ],
                "parameters": [
                    {
                        "name": "refund",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID возврата."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "refunds:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Refund"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/orders/{order}/refunds/calculate": {
            "post": {
                "operationId": "refunds.calculate",
                "summary": "Рассчитать возврат по заказу и остаток к возврату — ничего не пишет",
                "tags": [
                    "Refunds"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CalculateRefundRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "refunds:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/RefundCalculation"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "refund_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/orders/{order}/refunds": {
            "post": {
                "operationId": "refunds.create",
                "summary": "Вернуть позиции и доставку заказа: деньги — по способам оплаты, товар — на склад",
                "tags": [
                    "Refunds"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateRefundRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "refunds:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Refund"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "refund_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/refunds/{refund}/confirm": {
            "post": {
                "operationId": "refunds.confirm",
                "summary": "Подтвердить, что деньги возврата отданы вне системы",
                "tags": [
                    "Refunds"
                ],
                "parameters": [
                    {
                        "name": "refund",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID возврата."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "refunds:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Refund"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "refund_not_confirmable",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/settlement-agreements": {
            "get": {
                "operationId": "settlement_agreements.list",
                "summary": "Соглашения о взаимозачёте: стороны, вид, реквизиты договора, срок и расписание",
                "tags": [
                    "SettlementAgreements"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только документы этого поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SettlementAgreement"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/settlement-agreements/{settlement_agreement}": {
            "get": {
                "operationId": "settlement_agreements.get",
                "summary": "Соглашение о взаимозачёте",
                "tags": [
                    "SettlementAgreements"
                ],
                "parameters": [
                    {
                        "name": "settlement_agreement",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID соглашения о взаимозачёте."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SettlementAgreement"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/settlement-offset-lines": {
            "get": {
                "operationId": "settlement_offset_lines.list",
                "summary": "Строки взаимозачётов: зачтённые долги покупателя и счета поставщика",
                "tags": [
                    "SettlementOffsetLines"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "settlement_offset_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только строки этого взаимозачёта."
                    },
                    {
                        "name": "order_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только строки, закрывшие долг этого заказа."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SettlementOffsetLine"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/settlement-offset-lines/{settlement_offset_line}": {
            "get": {
                "operationId": "settlement_offset_lines.get",
                "summary": "Строка взаимозачёта",
                "tags": [
                    "SettlementOffsetLines"
                ],
                "parameters": [
                    {
                        "name": "settlement_offset_line",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID строки взаимозачёта."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SettlementOffsetLine"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/settlement-offsets": {
            "get": {
                "operationId": "settlement_offsets.list",
                "summary": "Взаимозачёты: встречные долги покупателя и поставщика, закрытые документом зачёта",
                "tags": [
                    "SettlementOffsets"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только документы этого поставщика."
                    },
                    {
                        "name": "agreement_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только зачёты по этому соглашению."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SettlementOffset"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/settlement-offsets/{settlement_offset}": {
            "get": {
                "operationId": "settlement_offsets.get",
                "summary": "Взаимозачёт",
                "tags": [
                    "SettlementOffsets"
                ],
                "parameters": [
                    {
                        "name": "settlement_offset",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID взаимозачёта."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SettlementOffset"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/stock-movements": {
            "get": {
                "operationId": "stock_movements.list",
                "summary": "Журнал движений склада: каждое изменение физического остатка точки",
                "tags": [
                    "StockMovements"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "variant_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только движения этого варианта."
                    },
                    {
                        "name": "location_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только движения этой точки."
                    },
                    {
                        "name": "lot_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только движения этой партии."
                    },
                    {
                        "name": "document_type",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "goods_receipt",
                                "stocktake",
                                "stock_write_off",
                                "production_order",
                                "location_transfer",
                                "group_transfer",
                                "supplier_return",
                                "order"
                            ]
                        },
                        "description": "Вид первичного документа, вместе с document_id: только движения, у которых этот документ — первичный."
                    },
                    {
                        "name": "document_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "ID первичного документа, вместе с document_type."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StockMovement"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/stock-movements/{stock_movement}": {
            "get": {
                "operationId": "stock_movements.get",
                "summary": "Движение склада",
                "tags": [
                    "StockMovements"
                ],
                "parameters": [
                    {
                        "name": "stock_movement",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID движения склада."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/StockMovement"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/stocktake-lines": {
            "get": {
                "operationId": "stocktake_lines.list",
                "summary": "Строки ревизий: учёт, факт, расхождение и коррекция, изменённые с указанного момента",
                "tags": [
                    "StocktakeLines"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "stocktake_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только строки этой ревизии."
                    },
                    {
                        "name": "variant_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только строки этого варианта."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StocktakeLine"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/stocktake-lines/{stocktake_line}": {
            "get": {
                "operationId": "stocktake_lines.get",
                "summary": "Строка ревизии",
                "tags": [
                    "StocktakeLines"
                ],
                "parameters": [
                    {
                        "name": "stocktake_line",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID строки ревизии."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/StocktakeLine"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/stocktakes": {
            "get": {
                "operationId": "stocktakes.list",
                "summary": "Ревизии остатков: охват, статус и даты, изменённые с указанного момента",
                "tags": [
                    "Stocktakes"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "location_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только ревизии этой точки."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Stocktake"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/stocktakes/{stocktake}": {
            "get": {
                "operationId": "stocktakes.get",
                "summary": "Ревизия остатков",
                "tags": [
                    "Stocktakes"
                ],
                "parameters": [
                    {
                        "name": "stocktake",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID ревизии."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Stocktake"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/store": {
            "get": {
                "operationId": "store.get",
                "summary": "Магазин: валюта, часовой пояс и языки",
                "tags": [
                    "Store"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Store"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/supplier-bill-payments": {
            "get": {
                "operationId": "supplier_bill_payments.list",
                "summary": "Оплаты счетов поставщиков: деньгами, зачётом, нотой кредита, авансом, расходом журнала или вне системы",
                "tags": [
                    "SupplierBillPayments"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "supplier_bill_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только оплаты этого счёта поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SupplierBillPayment"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/supplier-bill-payments/{supplier_bill_payment}": {
            "get": {
                "operationId": "supplier_bill_payments.get",
                "summary": "Оплата счёта поставщика",
                "tags": [
                    "SupplierBillPayments"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill_payment",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID оплаты счёта поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBillPayment"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/supplier-bills/{supplier_bill}/payments/out-of-band": {
            "post": {
                "operationId": "supplier_bills.record_out_of_band_payment",
                "summary": "Отметить счёт поставщика оплаченным вне системы",
                "tags": [
                    "SupplierBillPayments"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID счёта поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/RecordOutOfBandSupplierBillPaymentRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:pay"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBillPayment"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-bills/{supplier_bill}/payments/{supplier_bill_payment}": {
            "delete": {
                "operationId": "supplier_bills.delete_payment",
                "summary": "Отменить оплату счёта поставщика",
                "tags": [
                    "SupplierBillPayments"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID счёта поставщика."
                    },
                    {
                        "name": "supplier_bill_payment",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID оплаты счёта поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:pay"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "supplier_bill_payment_locked",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-bills": {
            "get": {
                "operationId": "supplier_bills.list",
                "summary": "Счета поставщиков: фактуры, ноты и долги по поставкам без фактуры с налогом и строками",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только документы этого поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SupplierBill"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "supplier_bills.create",
                "summary": "Создать черновик счёта поставщика",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateSupplierBillRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/supplier-bills/{supplier_bill}": {
            "get": {
                "operationId": "supplier_bills.get",
                "summary": "Счёт поставщика",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID счёта поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "supplier_bills.update",
                "summary": "Изменить черновик счёта поставщика",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID счёта поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateSupplierBillRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "supplier_bills.delete",
                "summary": "Удалить черновик счёта поставщика",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID счёта поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-bills/{supplier_bill}/post": {
            "post": {
                "operationId": "supplier_bills.post",
                "summary": "Провести счёт поставщика: он войдёт в кредиторку и книгу покупок",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID счёта поставщика."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "vendor_tax_id": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Счёт прислал поставщик без налогового номера в карточке: проведение запишет в карточку CUIT из фактуры. suppliers — сколько карточек изменится."
                                },
                                "close_returns": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Нота кредита покрыла возвраты поставщику целиком: проведение закроет их. supplier_returns — сколько возвратов закроется."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/PostSupplierBillCommandRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-bills/{supplier_bill}/void": {
            "post": {
                "operationId": "supplier_bills.void",
                "summary": "Аннулировать счёт поставщика вместе с его оплатами и зачётами",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID счёта поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-bills/{supplier_bill}/approve": {
            "post": {
                "operationId": "supplier_bills.approve",
                "summary": "Одобрить проведённый счёт поставщика к оплате",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID счёта поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:approve"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-bills/{supplier_bill}/revoke-approval": {
            "post": {
                "operationId": "supplier_bills.revoke_approval",
                "summary": "Отозвать одобрение счёта поставщика к оплате",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID счёта поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:approve"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-returns": {
            "get": {
                "operationId": "supplier_returns.list",
                "summary": "Возвраты поставщику: отгруженный обратно товар и компенсация за него",
                "tags": [
                    "SupplierReturns"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только документы этого поставщика."
                    },
                    {
                        "name": "goods_receipt_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только возвраты из этой приёмки."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SupplierReturn"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/supplier-returns/{supplier_return}": {
            "get": {
                "operationId": "supplier_returns.get",
                "summary": "Возврат поставщику",
                "tags": [
                    "SupplierReturns"
                ],
                "parameters": [
                    {
                        "name": "supplier_return",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID возврата поставщику."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierReturn"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/suppliers": {
            "get": {
                "operationId": "suppliers.list",
                "summary": "Поставщики магазина: реквизиты и условия расчётов",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Supplier"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "suppliers.create",
                "summary": "Создать поставщика: реквизиты и условия расчётов",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateSupplierRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Supplier"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "record_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/suppliers/{supplier}": {
            "get": {
                "operationId": "suppliers.get",
                "summary": "Поставщик",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "supplier",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Supplier"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "suppliers.update",
                "summary": "Изменить реквизиты, условия расчётов и внешний id поставщика",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "supplier",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID поставщика."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateSupplierRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Supplier"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/suppliers/by-external-id/{external_id}": {
            "get": {
                "operationId": "suppliers.get_by_external_id",
                "summary": "Поставщик по внешнему id",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Внешний id — id записи в вашей системе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Supplier"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "suppliers.upsert",
                "summary": "Создать или изменить поставщика по внешнему id",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Внешний id — id записи в вашей системе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatchUpsert"
                    },
                    {
                        "$ref": "#/components/parameters/IfNoneMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Supplier"
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Supplier"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "record_limit_reached",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/suppliers/{supplier}/balance": {
            "get": {
                "operationId": "suppliers.get_balance",
                "summary": "Сальдо поставщика: сколько магазин должен сейчас, по слагаемым и срокам оплаты",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "supplier",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID поставщика."
                    },
                    {
                        "name": "legal_entity_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Только долг перед этим юрлицом магазина."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBalance"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/suppliers/{supplier}/statement": {
            "get": {
                "operationId": "suppliers.get_statement",
                "summary": "Акт сверки с поставщиком за период: сальдо на начало и конец, строки с нарастающим остатком",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "supplier",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID поставщика."
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Первый день периода YYYY-MM-DD в часовом поясе магазина; по умолчанию — день первой строки акта."
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Последний день периода YYYY-MM-DD в часовом поясе магазина; по умолчанию сегодня."
                    },
                    {
                        "name": "legal_entity_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Акт по этому юрлицу магазина: строки и сальдо только его доли."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierStatement"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/tax-classes": {
            "get": {
                "operationId": "tax_classes.list",
                "summary": "Налоговые классы магазина: природа и ставка налога, с которыми продаётся товар",
                "tags": [
                    "TaxClasses"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/TaxClass"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/tax-periods": {
            "get": {
                "operationId": "tax_periods.list",
                "summary": "Налоговые периоды юрлиц: какие месяцы закрыты и окончательны",
                "tags": [
                    "TaxPeriods"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/TaxPeriod"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "cursor_expired"
                ]
            }
        },
        "/tax-withholdings": {
            "get": {
                "operationId": "tax_withholdings.list",
                "summary": "Удержания и перцепции, изменённые с указанного момента: удержанное у магазина к зачёту и удержанное магазином к перечислению",
                "tags": [
                    "TaxWithholdings"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "direction",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "suffered",
                                "practiced"
                            ]
                        },
                        "description": "Только одна сторона реестра: suffered — удержанное у магазина, practiced — удержанное магазином."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/TaxWithholding"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/tax-withholdings/{tax_withholding}": {
            "get": {
                "operationId": "tax_withholdings.get",
                "summary": "Удержание или перцепция",
                "tags": [
                    "TaxWithholdings"
                ],
                "parameters": [
                    {
                        "name": "tax_withholding",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID удержания или перцепции."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TaxWithholding"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/tax-withholdings/{tax_withholding}/certificate": {
            "get": {
                "operationId": "tax_withholdings.get_certificate",
                "summary": "PDF сертификата удержания, который магазин выдаёт контрагенту",
                "tags": [
                    "TaxWithholdings"
                ],
                "parameters": [
                    {
                        "name": "tax_withholding",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID удержания или перцепции."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/pdf": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "tax_withholding_certificate_unavailable"
                ]
            }
        },
        "/uploads/{upload}": {
            "get": {
                "operationId": "uploads.get",
                "summary": "Загрузка файла частями: сколько принято",
                "tags": [
                    "Uploads"
                ],
                "parameters": [
                    {
                        "name": "upload",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID загрузки."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "bulk:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Upload"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/uploads": {
            "post": {
                "operationId": "uploads.create",
                "summary": "Начать загрузку файла частями — вход массовой операции",
                "tags": [
                    "Uploads"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateUploadRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "bulk:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Upload"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/uploads/{upload}/chunks": {
            "post": {
                "operationId": "upload_chunks.create",
                "summary": "Дописать часть файла сырым телом",
                "tags": [
                    "Uploads"
                ],
                "parameters": [
                    {
                        "name": "upload",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID загрузки."
                    },
                    {
                        "name": "offset",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "minimum": 0
                        },
                        "description": "С какого байта файла начинается часть: равен received загрузки, иначе 409 upload_offset_mismatch. Сама часть — сырое тело запроса."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/octet-stream": {
                            "schema": {
                                "type": "string",
                                "format": "binary"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "bulk:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Upload"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "upload_offset_mismatch",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/variants": {
            "get": {
                "operationId": "variants.list",
                "summary": "Варианты товаров: артикул, штрихкоды, цены и единицы",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "name": "product_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Только записи этого товара."
                    },
                    {
                        "name": "sku",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 64
                        },
                        "description": "Только вариант с этим артикулом."
                    },
                    {
                        "name": "barcode",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 512
                        },
                        "description": "Только варианты с этим штрихкодом."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Variant"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "variants.create",
                "summary": "Добавить вариант в товар",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateVariantRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Variant"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/variants/{variant}": {
            "get": {
                "operationId": "variants.get",
                "summary": "Вариант товара",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "variant",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID варианта."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Variant"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "variants.update",
                "summary": "Изменить вариант товара",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "variant",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID варианта."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "measure_change": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Вариант меняет способ продажи (поштучно или мерой): его остаток, цены и границы пересчитываются."
                                },
                                "piece_mode_off": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Упаковки варианта уйдут в архив, когда он перестаёт продаваться упаковками."
                                },
                                "stock_source": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Свой остаток варианта переходит на базовый вариант, и дальше он продаётся из остатка базы."
                                },
                                "program_menu": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Блюдо уйдёт из меню программ питания по подписке."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateVariantRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Variant"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "variants.delete",
                "summary": "Архивировать вариант товара",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "variant",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID варианта."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "recipe_ingredient": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Позиция — ингредиент действующих техкарт и уйдёт из них."
                                },
                                "production_draft": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Черновики производственных актов с позицией будут отменены."
                                },
                                "program_menu": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Блюдо уйдёт из меню программ питания по подписке."
                                },
                                "stock_dependents": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Упаковки, которые продаются из остатка этого варианта, станут обычными вариантами с нулевым остатком."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "last_variant_of_product",
                    "precondition_required"
                ]
            }
        },
        "/variants/by-external-id/{external_id}": {
            "get": {
                "operationId": "variants.get_by_external_id",
                "summary": "Вариант товара по внешнему id",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Внешний id — id записи в вашей системе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Variant"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "variants.upsert",
                "summary": "Создать или изменить вариант по внешнему id",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Внешний id — id записи в вашей системе."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "measure_change": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Вариант меняет способ продажи (поштучно или мерой): его остаток, цены и границы пересчитываются."
                                },
                                "piece_mode_off": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Упаковки варианта уйдут в архив, когда он перестаёт продаваться упаковками."
                                },
                                "stock_source": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Свой остаток варианта переходит на базовый вариант, и дальше он продаётся из остатка базы."
                                },
                                "program_menu": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Блюдо уйдёт из меню программ питания по подписке."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatchUpsert"
                    },
                    {
                        "$ref": "#/components/parameters/IfNoneMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpsertVariantRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Variant"
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Variant"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "external_id_archived",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/variants/{variant}/recipe": {
            "get": {
                "operationId": "variants.get_recipe",
                "summary": "Тех-карта варианта: состав и выход заготовки",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "variant",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID варианта."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/VariantRecipe"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "put": {
                "operationId": "variants.replace_recipe",
                "summary": "Заменить тех-карту варианта: состав и выход заготовки",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "variant",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID варианта."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ReplaceVariantRecipeRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/VariantRecipe"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/webhook-endpoints/{endpoint}/deliveries": {
            "get": {
                "operationId": "webhook_deliveries.list",
                "summary": "Доставки адреса вебхука: что ушло, что ждёт повтора, что не доставлено",
                "tags": [
                    "WebhookDeliveries"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID адреса вебхука."
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "pending",
                                "succeeded",
                                "failed"
                            ]
                        },
                        "description": "Только доставки в этом статусе."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/WebhookDelivery"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/webhook-deliveries/{delivery}": {
            "get": {
                "operationId": "webhook_deliveries.get",
                "summary": "Доставка вебхука со всеми попытками и ответами получателя",
                "tags": [
                    "WebhookDeliveries"
                ],
                "parameters": [
                    {
                        "name": "delivery",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID доставки вебхука."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookDelivery"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/webhook-endpoints/{endpoint}/test": {
            "post": {
                "operationId": "webhook_endpoints.test",
                "summary": "Отправить на адрес тестовое событие ping — одна попытка, подписанная текущим секретом",
                "tags": [
                    "WebhookDeliveries"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID адреса вебхука."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Принято: исход — по адресу из Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookDelivery"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/webhook-deliveries/{delivery}/retry": {
            "post": {
                "operationId": "webhook_deliveries.retry",
                "summary": "Повторить доставку сейчас — тем же телом и с тем же webhook-id",
                "tags": [
                    "WebhookDeliveries"
                ],
                "parameters": [
                    {
                        "name": "delivery",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID доставки вебхука."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Принято: исход — по адресу из Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookDelivery"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/webhook-endpoints": {
            "get": {
                "operationId": "webhook_endpoints.list",
                "summary": "Адреса вебхуков приложения",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/WebhookEndpoint"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "webhook_endpoints.create",
                "summary": "Добавить адрес вебхука и подписать его на типы событий",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateWebhookEndpointRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Создано",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookEndpoint"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "webhook_endpoint_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/webhook-endpoints/{endpoint}": {
            "get": {
                "operationId": "webhook_endpoints.get",
                "summary": "Адрес вебхука",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID адреса вебхука."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookEndpoint"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "webhook_endpoints.update",
                "summary": "Изменить адрес вебхука: URL, подпись, типы событий, включение",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID адреса вебхука."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateWebhookEndpointRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookEndpoint"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "webhook_endpoints.delete",
                "summary": "Удалить адрес вебхука",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID адреса вебхука."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/webhook-endpoints/{endpoint}/rotate-secret": {
            "post": {
                "operationId": "webhook_endpoints.rotate_secret",
                "summary": "Выпустить новый секрет подписи: прежний ещё 24 часа подписывает доставки вместе с ним",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID адреса вебхука."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookEndpoint"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/webhook-endpoints/{endpoint}/secret": {
            "get": {
                "operationId": "webhook_endpoints.get_secret",
                "summary": "Секрет подписи доставок адреса вебхука",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID адреса вебхука."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookEndpointSecret"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/write-off-reasons": {
            "get": {
                "operationId": "write_off_reasons.list",
                "summary": "Причины списания магазина",
                "tags": [
                    "WriteOffReasons"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Размер страницы: до 250 записей; по умолчанию 50."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Непрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Успешно",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/WriteOffReason"
                                            },
                                            "description": "Записи страницы."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID стёртой записи."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Когда запись стёрта."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Записи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Курсор следующей страницы; null на последней."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true, если есть следующая страница."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "На последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        }
    },
    "components": {
        "schemas": {
            "AdjustInventoryLevelRequest": {
                "type": "object",
                "properties": {
                    "variant_id": {
                        "type": "integer",
                        "description": "ID варианта. Вместе с location_id определяет уровень остатка; у пары, которой нет в списке, остаток нулевой."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID точки магазина."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Комментарий движения; обязателен, если его требует причина списания."
                    },
                    "lot_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "У прихода варианта с учётом партий — партия; новая получает expires_at. Без номера товар ложится в новую партию с автономером, как при приёмке."
                    },
                    "expires_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Срок годности новой партии, в часовом поясе магазина."
                    },
                    "reason": {
                        "type": "string",
                        "enum": [
                            "restock",
                            "write_off"
                        ],
                        "description": "restock — товар пришёл, delta больше нуля; write_off — товар списывается по причине магазина (write_off_reason_id), delta меньше нуля."
                    },
                    "delta": {
                        "type": "string",
                        "pattern": "^-?\\d{1,15}(\\.\\d{1,15})?$",
                        "maxLength": 32,
                        "description": "Изменение физического остатка, десятичной строкой в единице варианта. Уменьшить остаток без причины списания нельзя: исправление неверного пересчёта — через установку остатка."
                    },
                    "write_off_reason_id": {
                        "type": "integer",
                        "description": "У write_off — причина (/v1/write-off-reasons); она должна быть selectable."
                    }
                },
                "required": [
                    "variant_id",
                    "location_id",
                    "reason",
                    "delta"
                ]
            },
            "AnnulFiscalDocumentRequest": {
                "type": "object",
                "properties": {
                    "reason": {
                        "type": "string",
                        "minLength": 3,
                        "maxLength": 500,
                        "description": "Почему фактура снимается, своими словами, от 3 до 500 символов: уходит на аннулирующую ноту и в историю заказа."
                    }
                },
                "required": [
                    "reason"
                ]
            },
            "BulkOperation": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "app_id": {
                        "type": "integer",
                        "description": "ID приложения, создавшего операцию."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "inventory.set",
                            "products.upsert",
                            "money_transactions.create",
                            "money_transactions.update",
                            "orders.export",
                            "libro_iva.export",
                            "accountant_package.export"
                        ],
                        "description": "Вид операции: inventory.set — установка остатков; products.upsert — создание или обновление товаров с вариантами; money_transactions.create — ручные доходы и расходы; money_transactions.update — правка движений денег, например разноска по статьям; orders.export — выгрузка заказов; libro_iva.export — книги Libro IVA Digital юрлица за месяц; accountant_package.export — пакет бухгалтера юрлица за месяц."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "running",
                            "cancelling",
                            "completed",
                            "cancelled",
                            "failed"
                        ],
                        "description": "pending — ждёт запуска; running — идёт; cancelling — остановится после текущей строки; completed — вход пройден целиком или файл собран; cancelled — отменена; failed — остановилась до конца входа или не собрала файл (error)."
                    },
                    "input": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "source": {
                                "type": "string",
                                "enum": [
                                    "upload",
                                    "url"
                                ],
                                "description": "upload — загрузка частями (/v1/uploads); url — файл, скачанный по адресу."
                            },
                            "url": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Адрес, с которого скачивается вход; null у загрузки."
                            },
                            "file_name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Имя загруженного файла; null у адреса."
                            },
                            "bytes": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "Размер входа в байтах, развёрнутого, если он пришёл в gzip; null, пока неизвестен."
                            },
                            "processed_bytes": {
                                "type": "integer",
                                "description": "Сколько байт входа пройдено: их доля — прогресс."
                            }
                        },
                        "required": [
                            "source",
                            "url",
                            "file_name",
                            "bytes",
                            "processed_bytes"
                        ],
                        "description": "Вход операции: загрузка частями или адрес. null у выгрузки и файла — входа у них нет."
                    },
                    "params": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": true,
                        "description": "Параметры выгрузки или файла, как их приняло создание: у orders.export — фильтры ленты GET /v1/orders (updated_since, number), у libro_iva.export — legal_entity_id, period и books, у accountant_package.export — legal_entity_id и period. null у операции со входом."
                    },
                    "lines": {
                        "type": "object",
                        "properties": {
                            "read": {
                                "type": "integer",
                                "description": "Прочитано строк."
                            },
                            "succeeded": {
                                "type": "integer",
                                "description": "Исполнено успешно."
                            },
                            "failed": {
                                "type": "integer",
                                "description": "Отказано строк."
                            }
                        },
                        "required": [
                            "read",
                            "succeeded",
                            "failed"
                        ],
                        "description": "Строки входа: прочитано (вместе с пустыми), исполнено успешно и с отказом. Отказ строки операцию не останавливает, его причина — в результате. У выгрузки — элементы ленты, записанные в результат: read и succeeded равны, failed — 0. У файла — нули: его исход — status, содержимое — архив."
                    },
                    "error": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "code": {
                                "type": "string",
                                "enum": [
                                    "invalid_url",
                                    "blocked_address",
                                    "unreachable",
                                    "too_large",
                                    "access_denied",
                                    "not_found",
                                    "rate_limited",
                                    "http_error",
                                    "input_corrupt",
                                    "app_unavailable",
                                    "scope_revoked",
                                    "processing_failed",
                                    "capability_disabled",
                                    "locations_restricted",
                                    "legal_entity_deleted",
                                    "libro_iva_not_applicable",
                                    "libro_iva_incomplete"
                                ],
                                "description": "invalid_url, blocked_address, unreachable, too_large, access_denied, not_found, rate_limited, http_error — вход не скачался (source_status — у ответа его сервера с ошибкой); input_corrupt — вход не читается, например битый gzip; app_unavailable — приложение удалено или потеряло доступ; scope_revoked — у приложения сняли scope, нужный операции; capability_disabled — у магазина больше нет налогового учёта, который держит данные файла; locations_restricted — приложение ограничили точками, а файл собирается по юрлицу целиком; legal_entity_deleted — юрлицо удалено после создания операции; libro_iva_not_applicable — юрлицо не ведёт Libro IVA Digital; libro_iva_incomplete — документы периода не описать записью книги (documents); processing_failed — внутренний сбой."
                            },
                            "message": {
                                "type": "string",
                                "description": "Причина словами, на языке запроса."
                            },
                            "source_status": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "HTTP-статус, которым ответил сервер входа, у access_denied, not_found, rate_limited и http_error; иначе null."
                            },
                            "documents": {
                                "type": [
                                    "array",
                                    "null"
                                ],
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "type": {
                                            "type": "string",
                                            "enum": [
                                                "fiscal_document",
                                                "supplier_bill"
                                            ],
                                            "description": "fiscal_document — фискальный документ из книги продаж; supplier_bill — счёт поставщика из книги покупок или импорта."
                                        },
                                        "id": {
                                            "type": "integer",
                                            "description": "ID записи, уникальный среди записей своего вида в магазине."
                                        },
                                        "reason": {
                                            "type": "string",
                                            "enum": [
                                                "missing_request",
                                                "missing_number",
                                                "unknown_document_type",
                                                "other_ledger_file",
                                                "broker_fields_required",
                                                "currency_code_unconfirmed",
                                                "unsupported_currency",
                                                "missing_exchange_rate",
                                                "invalid_vendor_tax_id",
                                                "unknown_tax_rate",
                                                "missing_despacho",
                                                "unknown_rate",
                                                "missing_import_document_kind",
                                                "missing_import_document_description",
                                                "unsupported_service_rate",
                                                "missing_import_tax_payment"
                                            ],
                                            "description": "Почему документ не описать: missing_request, missing_number — у фискального документа нет запроса ARCA или номера; unknown_document_type, other_ledger_file, broker_fields_required — тип счёта не для этой книги или нужны реквизиты корредора; currency_code_unconfirmed, unsupported_currency, missing_exchange_rate — валюта без кода ARCA или без курса; invalid_vendor_tax_id — неверный CUIT продавца; unknown_tax_rate — ставку не разложить по алькуотам; missing_despacho, unknown_rate — у импорта товаров нет номера оформления или ставки; missing_import_document_kind, missing_import_document_description, unsupported_service_rate, missing_import_tax_payment — у импорта услуг не заполнен документ исполнителя, ставка или уплата налога."
                                        }
                                    },
                                    "required": [
                                        "type",
                                        "id",
                                        "reason"
                                    ]
                                },
                                "description": "У libro_iva_incomplete — документы периода, которые не описать записью книги; их нужно исправить в магазине и создать операцию заново. Иначе null."
                            }
                        },
                        "required": [
                            "code",
                            "message",
                            "source_status",
                            "documents"
                        ],
                        "description": "У failed — почему операция не дошла до конца входа или не собрала файл. У идущей — последний сбой скачивания входа, который ещё повторяется. Иначе null."
                    },
                    "result_url": {
                        "type": "string",
                        "description": "Адрес результата: NDJSON, строка на каждую строку входа по порядку, с исходами уже пройденных строк; у выгрузки — по элементу ленты на строку; у файла — ZIP законченной операции. Докачивается диапазонами."
                    },
                    "result_scopes": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Scopes, без которых результат не отдаётся: чтение данных вида и scopes полей, с которыми операция создана, например customers:read у выгрузки заказов с данными покупателей. Набор закреплён при создании; снятый scope останавливает операцию (scope_revoked)."
                    },
                    "sync_cursor": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "У завершённой выгрузки — курсор синхронизации ленты, из которой она собрана (GET /v1/orders с теми же params): лента отдаёт по нему изменённое после выгрузки. Иначе null."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    },
                    "started_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда операция началась; null, пока в pending."
                    },
                    "finished_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда операция закончилась; null до окончания."
                    }
                },
                "required": [
                    "id",
                    "app_id",
                    "type",
                    "status",
                    "input",
                    "params",
                    "lines",
                    "error",
                    "result_url",
                    "result_scopes",
                    "sync_cursor",
                    "created_at",
                    "updated_at",
                    "started_at",
                    "finished_at"
                ]
            },
            "CalculateRefundRequest": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "order_item_id": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "description": "ID позиции заказа (items в /v1/orders)."
                                },
                                "quantity": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "description": "Количество десятичной строкой в unit: штуки или вся мера весовой или объёмной позиции."
                                }
                            },
                            "required": [
                                "order_item_id",
                                "quantity"
                            ]
                        },
                        "maxItems": 200,
                        "uniqueItems": true,
                        "description": "Возвращённые позиции."
                    },
                    "shipping_amount": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100000000000000,
                        "description": "Часть amount, которая возвращает доставку."
                    },
                    "irreversible_to": {
                        "type": "string",
                        "enum": [
                            "manual",
                            "balance"
                        ],
                        "description": "Куда идёт доля необратимого способа (перевод, крипта, ручной способ): manual — магазин выплачивает её вручную и подтверждает (POST /v1/refunds/{refund}/confirm); balance — на баланс покупателя (balance_available расчёта)."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "CancelOrderRequest": {
                "type": "object",
                "properties": {
                    "status": {
                        "type": "string",
                        "maxLength": 50,
                        "description": "Статус заказа: код из списка статусов магазина (/v1/order-statuses). Магазин может добавлять свои статусы; постоянный смысл даёт status_group."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Причина отмены словами, остаётся в истории заказа."
                    }
                }
            },
            "Category": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID родительской категории; null у категории верхнего уровня. Категории приходят плоским списком, дерево строится по этому полю."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "description": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Описание по языкам в Markdown (GitHub Flavored): объект заполненных языков."
                    },
                    "slug": {
                        "type": "string",
                        "description": "Адрес категории на витрине, уникальный в магазине."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Позиция среди соседних категорий: меньшая идёт первой."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false скрывает категорию с витрины."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда категория отправлена в архив; null у живой."
                    }
                },
                "required": [
                    "id",
                    "external_id",
                    "version",
                    "parent_id",
                    "name",
                    "description",
                    "slug",
                    "position",
                    "is_active",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "ChangeCustomerGroupMembersRequest": {
                "type": "object",
                "properties": {
                    "customer_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "minItems": 1,
                        "maxItems": 1000,
                        "uniqueItems": true,
                        "description": "ID покупателей магазина, без повторов, до 1000 за запрос. Уже состоящие (при добавлении) и не состоящие (при снятии) пропускаются."
                    }
                },
                "required": [
                    "customer_ids"
                ]
            },
            "CompleteDraftOrderRequest": {
                "type": "object",
                "properties": {
                    "mode": {
                        "type": "string",
                        "enum": [
                            "invoice",
                            "after_picking",
                            "mark_paid"
                        ],
                        "description": "invoice — заказ ждёт оплаты, реквизиты уходят покупателю каналами магазина, страница оплаты — в payment_url платежа; after_picking — покупатель получает счёт на точный итог после сборки, для весового товара; mark_paid — деньги уже получены ручным способом, нужен scope payments:write."
                    },
                    "expected_total": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100000000000000,
                        "description": "Итог, который вы прочитали в черновике: цены, скидки или доставка могли смениться после чтения. Если он другой, запрос получит 422, и заказ не создастся."
                    },
                    "currency": {
                        "type": "string",
                        "minLength": 3,
                        "maxLength": 3,
                        "description": "Валюта, в которой вы прочитали итог: поле currency черновика. Магазин без заказов может сменить валюту, а числа цен смена не трогает; если валюта другая, запрос получит 422, и заказ не создастся. Без поля валюта не сверяется."
                    }
                },
                "required": [
                    "mode",
                    "expected_total"
                ]
            },
            "ConfirmPaymentRequest": {
                "type": "object",
                "properties": {
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Комментарий к подтверждению, остаётся в истории заказа."
                    }
                }
            },
            "ConflictProblem": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "description": "Машинный тип отказа: стабильный код для ветвления, например insufficient_scope. У каждого типа есть страница в каталоге ошибок."
                    },
                    "title": {
                        "type": "string",
                        "description": "Краткое описание отказа на языке запроса."
                    },
                    "status": {
                        "type": "integer",
                        "description": "HTTP-статус ответа."
                    },
                    "detail": {
                        "type": "string",
                        "description": "Объяснение этого случая на языке запроса."
                    },
                    "current": {
                        "type": "object",
                        "additionalProperties": true,
                        "description": "Запись сейчас — поля, о которых конфликт: on_hand у stock_on_hand_changed, status у отказа в смене заказа, status и order_id у закрытого черновика."
                    },
                    "external_id": {
                        "type": "string",
                        "description": "У external_id_in_use и external_id_archived — занятый внешний id."
                    },
                    "consent_kind": {
                        "type": "string",
                        "description": "У consent_required — вид последствия, на который нужно согласие."
                    },
                    "consequences": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "integer",
                            "minimum": 0
                        },
                        "description": "У consent_required — что изменится: вид данных → число записей."
                    },
                    "consent_token": {
                        "type": "string",
                        "description": "У consent_required — отпечаток показанных последствий. Повторите запрос с consent[<consent_kind>]=<consent_token>."
                    },
                    "variant_id": {
                        "type": "integer",
                        "description": "У consent_required для строки варианта в записи товара — вариант: согласие даётся правкой этого варианта (PATCH /v1/variants/{variant})."
                    },
                    "limit": {
                        "type": "integer",
                        "minimum": 0,
                        "description": "У plan_limit_reached, address_book_full, bulk_operation_queue_full и webhook_endpoint_limit_reached — потолок."
                    },
                    "field": {
                        "type": "string",
                        "enum": [
                            "phone",
                            "email"
                        ],
                        "description": "У customer_contact_in_use — контакт, который принадлежит другому покупателю: phone или email."
                    },
                    "existing_customer_id": {
                        "type": "integer",
                        "description": "У customer_contact_in_use — покупатель, которому принадлежит контакт."
                    },
                    "received": {
                        "type": "integer",
                        "minimum": 0,
                        "description": "У upload_offset_mismatch — сколько байт загрузка уже приняла: смещение, с которого продолжить."
                    },
                    "operation_status": {
                        "type": "string",
                        "description": "У bulk_operation_finished — статус, с которым операция закончилась."
                    }
                },
                "required": [
                    "type",
                    "title",
                    "status"
                ]
            },
            "ConsignmentLossPolicy": {
                "type": "string",
                "enum": [
                    "return_to_supplier",
                    "our_cost"
                ]
            },
            "ConsignmentSettlement": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "number": {
                        "type": "string",
                        "description": "Номер акта."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "posted",
                            "void"
                        ],
                        "description": "draft — период собран для сверки, продажи ещё не закреплены за актом, период можно менять; posted — согласован с поставщиком: продажи периода закреплены за актом, по нему выставляется счёт; void — аннулирован: его продажи освобождены и войдут в следующий акт."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID поставщика (/v1/suppliers)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Юрлицо магазина, которому поставщик выставляет фактуру (/v1/legal-entities); null у старых актов — юрлицо по умолчанию."
                    },
                    "supplier_bill_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Счёт по акту (/v1/supplier-bills); null — счёт ещё не выставлен или аннулирован, и акт можно выставить заново. Аннулированный счёт хранит связь в своём consignment_settlement_id."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта акта, ISO 4217, — валюта цен поставки: в ней цены и суммы строк и итог."
                    },
                    "period_from": {
                        "type": "string",
                        "description": "Первый день периода, YYYY-MM-DD."
                    },
                    "period_to": {
                        "type": "string",
                        "description": "Последний день периода, YYYY-MM-DD."
                    },
                    "subtotal": {
                        "type": "integer",
                        "description": "Итог акта в его валюте — сумма строк, то, что поставщик выставит в фактуре."
                    },
                    "base_subtotal": {
                        "type": "integer",
                        "description": "Тот же итог в валюте магазина."
                    },
                    "sections": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "sale",
                                        "loss",
                                        "price_adjustment"
                                    ],
                                    "description": "sale — продано; loss — просрочка и недостача, которые по политике поставщика оплачивает магазин; price_adjustment — доплата за цену, исправленную корректировкой приёмки после начисления."
                                },
                                "subtotal": {
                                    "type": "integer",
                                    "description": "Подытог раздела в валюте акта."
                                }
                            },
                            "required": [
                                "kind",
                                "subtotal"
                            ]
                        },
                        "description": "Подытоги по разделам в порядке документа; пустые разделы не выводятся."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID записи, уникальный среди записей своего вида в магазине."
                                },
                                "position": {
                                    "type": "integer",
                                    "description": "Номер строки в документе."
                                },
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "sale",
                                        "loss",
                                        "price_adjustment"
                                    ],
                                    "description": "Раздел строки — коды sections[].kind."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID варианта товара (/v1/variants)."
                                },
                                "lot_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID партии строки (/v1/lots); null — товар без партий."
                                },
                                "goods_receipt_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Приёмка, с которой пришёл товар (/v1/goods-receipts)."
                                },
                                "name": {
                                    "type": "string",
                                    "description": "Название позиции, как в документе: снято при сборке акта и не меняется при переименовании товара."
                                },
                                "sku": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Артикул варианта, снятый вместе с названием; null, если его нет."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Базовая единица количества строки: pcs — штуки, g — граммы, ml — миллилитры."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Сколько продано, списано или переоценено — десятичная строка в базовой единице; продажа, отменённая в том же периоде, вычтена."
                                },
                                "unit_cost": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Цена поставки в валюте акта за cost_per_quantity; у строки price_adjustment — новая цена. null — у приёмки нет цены, строка начислена по нулю."
                                },
                                "cost_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Количество в базовой единице, за которое указана цена: \"1000\" у весового товара — за килограмм."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Сумма строки в валюте акта; у строки price_adjustment — разница к уже начисленному. Строки складываются в subtotal."
                                },
                                "base_amount": {
                                    "type": "integer",
                                    "description": "Сумма строки в валюте магазина."
                                }
                            },
                            "required": [
                                "id",
                                "position",
                                "kind",
                                "variant_id",
                                "lot_id",
                                "goods_receipt_id",
                                "name",
                                "sku",
                                "unit",
                                "quantity",
                                "unit_cost",
                                "cost_per_quantity",
                                "amount",
                                "base_amount"
                            ]
                        },
                        "description": "Строки акта в порядке документа: вариант × приёмка × цена."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка сотрудника; null, если её нет."
                    },
                    "posted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда акт проведён; null у черновика."
                    },
                    "voided_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда акт аннулирован; null у действующего."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "status",
                    "supplier_id",
                    "legal_entity_id",
                    "supplier_bill_id",
                    "currency",
                    "period_from",
                    "period_to",
                    "subtotal",
                    "base_subtotal",
                    "sections",
                    "lines",
                    "note",
                    "posted_at",
                    "voided_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "CreateBulkOperationRequest": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "inventory.set",
                            "products.upsert",
                            "money_transactions.create",
                            "money_transactions.update",
                            "orders.export",
                            "libro_iva.export",
                            "accountant_package.export"
                        ],
                        "description": "Вид операции: inventory.set — установка остатков; products.upsert — создание или обновление товаров с вариантами; money_transactions.create — ручные доходы и расходы; money_transactions.update — правка движений денег, например разноска по статьям; orders.export — выгрузка заказов; libro_iva.export — книги Libro IVA Digital юрлица за месяц; accountant_package.export — пакет бухгалтера юрлица за месяц."
                    },
                    "input": {
                        "type": "object",
                        "properties": {
                            "upload_id": {
                                "type": "integer",
                                "minimum": 1,
                                "description": "ID собранной загрузки частями (/v1/uploads)."
                            },
                            "url": {
                                "type": "string",
                                "maxLength": 2048,
                                "description": "Адрес, с которого скачивается вход; null у загрузки."
                            }
                        },
                        "description": "Вход операции: загрузка частями или адрес. null у выгрузки и файла — входа у них нет."
                    },
                    "params": {
                        "type": "object",
                        "properties": {
                            "updated_since": {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$",
                                "description": "У orders.export — заказы, изменённые после этого момента."
                            },
                            "include_deleted": {
                                "type": "boolean",
                                "description": "У orders.export — ещё и удалённые заказы."
                            },
                            "number": {
                                "type": "string",
                                "maxLength": 16,
                                "description": "У orders.export — только заказ с этим номером."
                            },
                            "legal_entity_id": {
                                "type": "integer",
                                "description": "У libro_iva.export и accountant_package.export — юрлицо, чей файл собирается."
                            },
                            "period": {
                                "type": "string",
                                "description": "У libro_iva.export и accountant_package.export — месяц вида YYYY-MM, не позже текущего месяца магазина."
                            },
                            "books": {
                                "type": "array",
                                "items": {
                                    "type": "string",
                                    "enum": [
                                        "ventas",
                                        "compras"
                                    ]
                                },
                                "minItems": 1,
                                "maxItems": 2,
                                "uniqueItems": true,
                                "description": "У libro_iva.export — книги: ventas (продажи) и compras (покупки вместе с файлами импорта), одна или обе."
                            }
                        },
                        "description": "Параметры выгрузки или файла, как их приняло создание: у orders.export — фильтры ленты GET /v1/orders (updated_since, number), у libro_iva.export — legal_entity_id, period и books, у accountant_package.export — legal_entity_id и period. null у операции со входом."
                    }
                },
                "required": [
                    "type"
                ]
            },
            "CreateCategoryRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 50000
                        },
                        "description": "Описание по языкам в Markdown (GitHub Flavored): объект заполненных языков."
                    },
                    "slug": {
                        "type": "string",
                        "maxLength": 120,
                        "description": "Адрес категории на витрине, уникальный в магазине."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID родительской категории; null у категории верхнего уровня. Категории приходят плоским списком, дерево строится по этому полю."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Позиция среди соседних категорий: меньшая идёт первой."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false скрывает категорию с витрины."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "CreateCustomerAddressRequest": {
                "type": "object",
                "properties": {
                    "label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Название адреса, например «Дом» или «Работа»; null, если не задано."
                    },
                    "street": {
                        "type": "string",
                        "maxLength": 255,
                        "description": "Улица."
                    },
                    "house": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Номер дома."
                    },
                    "apartment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Квартира или офис."
                    },
                    "floor": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 16,
                        "description": "Этаж."
                    },
                    "entrance": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 16,
                        "description": "Подъезд."
                    },
                    "district": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Район."
                    },
                    "postal_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 16,
                        "description": "Почтовый индекс."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Комментарий для курьера, например как пройти; null, если не задан."
                    },
                    "location": {
                        "type": "object",
                        "properties": {
                            "lat": {
                                "type": "number",
                                "minimum": -90,
                                "maximum": 90,
                                "description": "Широта в градусах."
                            },
                            "lng": {
                                "type": "number",
                                "minimum": -180,
                                "maximum": 180,
                                "description": "Долгота в градусах."
                            }
                        },
                        "required": [
                            "lat",
                            "lng"
                        ],
                        "description": "Точка адреса на карте; null, если адрес перенесён из другой системы и ещё не уточнён."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "Основной адрес покупателя. Когда основной адрес удаляют, основным становится самый свежий."
                    }
                },
                "required": [
                    "street",
                    "location"
                ]
            },
            "CreateCustomerGroupRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "description": "Имя группы, до 120 символов; уникально в магазине без учёта регистра."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Описание для сотрудников, до 500 символов; null или без поля — без описания."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "Активна ли группа; по умолчанию true."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "CreateCustomerRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "pattern": "\\S",
                        "maxLength": 120,
                        "description": "Имя покупателя; null, если неизвестно."
                    },
                    "language": {
                        "$ref": "#/components/schemas/Locale",
                        "description": "Язык, на котором магазин пишет покупателю: ru, en или es."
                    },
                    "phone": {
                        "type": "string",
                        "maxLength": 32,
                        "description": "Основной телефон покупателя в формате E.164, например +5491123456789; null, если неизвестен."
                    },
                    "email": {
                        "type": "string",
                        "maxLength": 254,
                        "description": "Email покупателя; null, если неизвестен."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id покупателя — его id в вашей системе; null, если не задан. После слияния двух покупателей ID поглощённого тоже находит выжившего; в ответе — основной ID."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "CreateDraftOrderRequest": {
                "type": "object",
                "properties": {
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Покупатель черновика (/v1/customers); null, пока не выбран."
                    },
                    "delivery_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Способ доставки (/v1/delivery-methods); null, пока не выбран."
                    },
                    "address_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Адрес из адресной книги покупателя — для способа с доставкой; null, пока не выбран."
                    },
                    "pickup_location_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Пункт самовывоза для способа самовывоза. Единственный пункт способ берёт сам; из нескольких черновик должен назвать один."
                    },
                    "delivery_slots": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "from": {
                                    "type": "string",
                                    "description": "Начало окна."
                                },
                                "to": {
                                    "type": "string",
                                    "description": "Конец окна."
                                }
                            },
                            "required": [
                                "from",
                                "to"
                            ]
                        },
                        "maxItems": 50,
                        "description": "Окна доставки, выбранные для способа, который работает с окнами."
                    },
                    "delivery_cost_override": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Цена доставки, названная вручную, вместо расчёта способа; null — по правилам способа."
                    },
                    "payment_method": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "cash",
                            "mercadopago",
                            "crypto",
                            "bybit",
                            "trc20",
                            "balance",
                            "modo",
                            "payway",
                            "mercadopago_qr",
                            "mercadopago_point",
                            "mercadopago_transfer",
                            "gift_card",
                            "subscription",
                            "deposit",
                            "external",
                            "manual",
                            "offset",
                            "on_account",
                            "exchange_credit",
                            "bonpunto",
                            "service_package",
                            null
                        ],
                        "description": "Способ оплаты, которым черновик оформится: от него зависят скидки за способ и совместимость с доставкой."
                    },
                    "manual_payment_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "description": "Ручной способ оплаты магазина, когда payment_method — manual; иначе null."
                    },
                    "promocode": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Промокод черновика; null, если нет."
                    },
                    "customer_comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Комментарий покупателя к заказу. Только со scope customers:read."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Внутренняя заметка магазина: уходит в заказ, покупатель её не видит."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID строки в черновике."
                                },
                                "variant_id": {
                                    "type": "integer",
                                    "description": "Вариант строки; null у свободной строки."
                                },
                                "quantity": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "description": "Количество десятичной строкой в unit: штуки у штучной позиции, мера у весовой или объёмной (\"480\" граммов)."
                                },
                                "modifiers": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "option_id": {
                                                "type": "integer",
                                                "description": "ID варианта добавки."
                                            },
                                            "quantity": {
                                                "type": "integer",
                                                "minimum": 1,
                                                "maximum": 99,
                                                "description": "Сколько раз добавка добавлена."
                                            }
                                        },
                                        "required": [
                                            "option_id"
                                        ]
                                    },
                                    "maxItems": 50,
                                    "description": "Добавки строки, например топпинги блюда."
                                }
                            },
                            "required": [
                                "variant_id",
                                "quantity"
                            ]
                        },
                        "maxItems": 200,
                        "uniqueItems": true,
                        "description": "Позиции черновика. Открытый черновик считается живьём по каталогу, скидкам и доставке; закрытый хранит позиции без цен."
                    }
                }
            },
            "CreateModifierGroupRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "min_select": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 99,
                        "description": "Сколько опций покупатель обязан выбрать: 0 — группа необязательна. Товар может задать своё правило (selection_rule)."
                    },
                    "max_select": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 99,
                        "description": "Сколько опций можно выбрать всего, с повторами; null — без предела."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — группа выключена: на товарах её не предлагают."
                    },
                    "adds_ingredients": {
                        "type": "boolean",
                        "description": "Меняют ли опции группы состав блюда; опция без своего состава при true делает состав позиции неизвестным (аллергены)."
                    },
                    "options": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                                },
                                "name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255
                                    },
                                    "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                                },
                                "price_delta": {
                                    "type": "integer",
                                    "minimum": -100000000,
                                    "maximum": 100000000,
                                    "description": "Надбавка к цене позиции за одну порцию опции, целым в минорных единицах валюты магазина; отрицательная — скидка. Товар может задать свою надбавку по варианту."
                                },
                                "max_quantity": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 99,
                                    "description": "Сколько раз можно взять эту опцию в одной позиции; null — без своего предела, держит только max_select группы."
                                },
                                "duration_minutes": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 5,
                                    "maximum": 120,
                                    "description": "На сколько минут опция удлиняет услугу по записи, кратно 5; null — не удлиняет. У позиций других видов не действует."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false — опция выключена и не предлагается."
                                },
                                "is_default": {
                                    "type": "boolean",
                                    "description": "Опция выбрана заранее: витрина и касса отмечают её сразу, обязательную группу без выбора ею заполняет сервер."
                                },
                                "adds_ingredients": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "Меняет ли эта опция состав; null — как у группы (adds_ingredients)."
                                },
                                "recipe_per_variant": {
                                    "type": "boolean",
                                    "description": "Расход зависит от блюда: общего состава нет, закладку задаёт тех-карта каждого варианта (option_recipes); без неё на варианте опция не предлагается."
                                },
                                "nutrition": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "kcal": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 1000000,
                                            "description": "Энергия, ккал."
                                        },
                                        "protein_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Белки, мг."
                                        },
                                        "fat_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Жиры, мг."
                                        },
                                        "carbs_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Углеводы, мг."
                                        }
                                    },
                                    "description": "Пищевая ценность одного применения опции, заявленная магазином: все четыре числа или null — тогда её считает состав опции."
                                },
                                "recipe": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "variant_id": {
                                                "type": "integer",
                                                "description": "ID варианта товара."
                                            },
                                            "quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "maxLength": 32,
                                                "description": "Закладка компонента на одно применение опции, десятичной строкой в единице компонента; null — по вкусу: в составе, но не списывается."
                                            }
                                        },
                                        "required": [
                                            "variant_id",
                                            "quantity"
                                        ]
                                    },
                                    "maxItems": 100,
                                    "description": "Общий состав опции — что она списывает в любом блюде: сырьё и заготовки с закладкой. У опции с расходом по блюду пуст. В записи — список целиком, пустой очищает; без поля состав не трогается."
                                }
                            }
                        },
                        "minItems": 1,
                        "maxItems": 100,
                        "uniqueItems": true,
                        "description": "Опции по порядку показа. В записи — набор целиком: строка находит опцию по id или external_id, у найденной пишутся пришедшие поля, строка без опции — новая и несёт name; опция, которой нет в наборе, уходит в архив и снимается из открытых черновиков заказов."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    }
                },
                "required": [
                    "name",
                    "options"
                ]
            },
            "CreateMoneyTransactionRequest": {
                "type": "object",
                "properties": {
                    "account_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID денежного счёта движения."
                    },
                    "direction": {
                        "$ref": "#/components/schemas/MoneyTransactionDirection",
                        "description": "income — приход на счёт; expense — расход со счёта."
                    },
                    "account_amount": {
                        "type": "string",
                        "maxLength": 37,
                        "description": "Сумма в валюте счёта, десятичной строкой."
                    },
                    "amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 100000000000000,
                        "description": "Сумма проводки в минимальных единицах валюты магазина, всегда положительная: направление задаёт direction. У счёта в чужой валюте — пересчёт по курсу снимка."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Учётная дата, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Момент движения."
                    },
                    "category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID статьи; null — перевод между счетами или движение без статьи."
                    },
                    "supplier_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID поставщика-контрагента; null, если его нет."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Комментарий к движению, как его записал человек или документ; null, если его нет."
                    }
                },
                "required": [
                    "account_id",
                    "direction",
                    "account_amount"
                ]
            },
            "CreateMoneyTransferRequest": {
                "type": "object",
                "properties": {
                    "from_account_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID денежного счёта, с которого списаны деньги."
                    },
                    "to_account_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID денежного счёта, на который зачислены деньги."
                    },
                    "from_amount": {
                        "type": "string",
                        "maxLength": 37,
                        "description": "Списано со счёта from_account_id в его валюте, десятичной строкой."
                    },
                    "to_amount": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 37,
                        "description": "Зачислено на счёт to_account_id в его валюте, десятичной строкой. В одной валюте равно from_amount: разница — это комиссия fee."
                    },
                    "fee": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 37,
                        "description": "Комиссия перевода в валюте счёта списания, десятичной строкой — расход на системной статье bank_fees; null, если комиссии нет."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Учётная дата перевода, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Момент перевода."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Описание перевода; null, если не задано."
                    }
                },
                "required": [
                    "from_account_id",
                    "to_account_id",
                    "from_amount"
                ]
            },
            "CreatePriceListRequest": {
                "type": "object",
                "properties": {
                    "kind": {
                        "type": "string",
                        "enum": [
                            "wholesale"
                        ],
                        "description": "Вид листа: только wholesale — оптовый. Лист точки заводит точка в панели."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "description": "Имя оптового листа, до 120 символов: его видят в панели в карточке покупателя."
                    },
                    "adjustment_bp": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 50000,
                        "description": "Наценка к себестоимости в базисных пунктах (1 % = 100), от 0 до 50000: 0 — по себестоимости, ниже неё оптовый лист не продаёт."
                    },
                    "rounding": {
                        "type": "object",
                        "properties": {
                            "mode": {
                                "$ref": "#/components/schemas/DiscountRoundingMode",
                                "description": "Как округлять: nearest — к ближайшему, up — вверх, down — вниз."
                            },
                            "precision": {
                                "type": "integer",
                                "enum": [
                                    "1",
                                    "0",
                                    "-1",
                                    "-2",
                                    "-3",
                                    "-4",
                                    "-5",
                                    "-6",
                                    "2"
                                ],
                                "description": "Разряд округления в минорных единицах валюты магазина; разряд самой минорной единицы — без округления."
                            }
                        },
                        "description": "Округление штучной цены — парой mode и precision. Без поля лист берёт округление прайса магазина."
                    }
                },
                "required": [
                    "kind",
                    "name",
                    "adjustment_bp"
                ]
            },
            "CreateProductMediaRequest": {
                "type": "object",
                "properties": {
                    "url": {
                        "type": "string",
                        "maxLength": 2048,
                        "description": "Публичный адрес файла."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000,
                        "description": "Место в галерее, с нуля."
                    },
                    "is_primary": {
                        "type": "boolean",
                        "description": "Главное фото: витрина показывает его первым."
                    }
                },
                "required": [
                    "url"
                ]
            },
            "CreateProductRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "short_description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 500
                        },
                        "description": "Краткое описание по языкам, простой текст для списков товаров."
                    },
                    "description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 50000
                        },
                        "description": "Описание по языкам в Markdown (GitHub Flavored): объект заполненных языков."
                    },
                    "slug": {
                        "type": "string",
                        "maxLength": 160,
                        "description": "Адрес товара на витрине, уникальный в магазине."
                    },
                    "brand_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID бренда товара; null, если не задан."
                    },
                    "tax_class_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID налогового класса товара (/v1/tax-classes); null — класс магазина по умолчанию. Продажа запоминает ставку позиции: смена класса меняет только будущие продажи."
                    },
                    "category_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "ID категорий товара по возрастанию."
                    },
                    "primary_category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Основная категория из category_ids; null, если основная не выбрана."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false снимает товар с продажи и скрывает его с витрины."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда товар появляется на витрине; null — сразу."
                    },
                    "unpublished_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда товар уходит с витрины; null — остаётся."
                    },
                    "sale_schedule": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "days": {
                                    "type": "array",
                                    "items": {
                                        "type": "integer",
                                        "minimum": 1,
                                        "maximum": 7
                                    },
                                    "minItems": 1,
                                    "maxItems": 7,
                                    "description": "Дни окна по ISO: 1 — понедельник, 7 — воскресенье."
                                },
                                "from": {
                                    "type": "string",
                                    "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$|^24:00$",
                                    "description": "Начало окна, «HH:MM» по часам магазина."
                                },
                                "to": {
                                    "type": "string",
                                    "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$|^24:00$",
                                    "description": "Конец окна, «HH:MM», сам момент не входит; «24:00» — до конца дня. Конец раньше начала — окно через полночь, оно принадлежит дню начала."
                                }
                            },
                            "required": [
                                "days",
                                "from",
                                "to"
                            ]
                        },
                        "maxItems": 14,
                        "description": "Когда позицию можно заказать — окна недели в часовом поясе магазина; null — всегда. Вне окна товар виден и кладётся в корзину, а оформление сверяет расписание со временем исполнения заказа."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "goods",
                            "dish",
                            "ingredient",
                            "prep"
                        ],
                        "description": "Вид товара: goods — товар для продажи; dish — блюдо, готовится под заказ; ingredient — сырьё для техкарт; prep — полуфабрикат собственного приготовления; manufactured — продукция собственного производства; meal_program — программа питания по подписке; bundle — набор из других товаров; gift_card — подарочная карта; service — услуга по записи."
                    },
                    "stock_unit": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml",
                                    "pcs"
                                ],
                                "description": "Базовая единица: g — граммы, ml — миллилитры, pcs — штуки. Количества вариантов товара — десятичные строки в этой единице."
                            },
                            "purchase_unit": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 16,
                                "description": "Название тары закупки, например кг или коробка; null — позицию закупают в базовой единице."
                            },
                            "purchase_quantity": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 32,
                                "description": "Сколько базовых единиц в одной таре закупки, десятичной строкой: например, 1000 для килограмма позиции, которую учитывают в граммах."
                            }
                        },
                        "description": "Единица учёта позиции со складом по мере (сырьё, заготовка, производимый товар): в ней остатки, тех-карты и выход. null у товара и блюда — их единица задаётся осью продажи варианта."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    },
                    "variants": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Внешний id варианта — его id в вашей системе: ключ, по которому находится строка."
                                },
                                "sku": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 64,
                                    "description": "Артикул (SKU); null, если не задан."
                                },
                                "name": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255
                                    },
                                    "description": "Название варианта по языкам, например {\"es\": \"Grande\"}."
                                },
                                "price": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Цена за price_per_quantity единиц, целым в минимальных единицах currency."
                                },
                                "track_inventory": {
                                    "type": "boolean",
                                    "description": "Магазин ведёт остаток варианта; false — продаёт без учёта остатка."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false снимает вариант с продажи."
                                },
                                "position": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Позиция среди вариантов товара: меньшая идёт первой."
                                },
                                "list_price": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Цена, как её назначил владелец, в минимальных единицах list_price_currency; null — цена назначена в деньгах учёта (price). У такой позиции price считает система по курсу прайса и во входе его не принимает."
                                },
                                "list_price_currency": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "ARS",
                                        "USD",
                                        "BRL",
                                        "CLP",
                                        "COP",
                                        "MXN",
                                        "PEN",
                                        "RUB",
                                        null
                                    ],
                                    "description": "Валюта назначенной цены (прайс магазина в чужой валюте); null — цена в валюте магазина currency. Во входе — валюта прайса магазина или currency."
                                },
                                "compare_at_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "maximum": 10000000000,
                                    "description": "Цена до скидки, показывается зачёркнутой; null, если скидки нет."
                                },
                                "weight_grams": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Вес для доставки в граммах; null, если не задан."
                                },
                                "length_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Длина упаковки в миллиметрах; null, если не задана."
                                },
                                "width_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Ширина упаковки в миллиметрах; null, если не задана."
                                },
                                "height_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Высота упаковки в миллиметрах; null, если не задана."
                                },
                                "sale_starts_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Когда начинается распродажа: compare_at_price показывается с этого момента; null — без начала."
                                },
                                "sale_ends_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Когда распродажа заканчивается; null — без конца."
                                },
                                "sold_by": {
                                    "type": "string",
                                    "enum": [
                                        "each",
                                        "weight",
                                        "volume"
                                    ],
                                    "description": "Как продаётся вариант: each — поштучно; weight — на вес; volume — на объём."
                                },
                                "price_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "За сколько единиц цена, десятичной строкой: за одну штуку или за 1000 — цена килограмма у весового варианта. null, если у весового или объёмного варианта она не задана."
                                },
                                "measure_step": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Шаг количества в строке весового или объёмного варианта, в его единице; null, если не задан."
                                },
                                "min_measure_qty": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Наименьшее количество в строке весового или объёмного варианта; null, если не задано."
                                },
                                "max_measure_qty": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Наибольшее количество в строке весового или объёмного варианта; null, если не задано."
                                },
                                "net_content": {
                                    "type": "object",
                                    "properties": {
                                        "quantity": {
                                            "type": "string",
                                            "maxLength": 32,
                                            "description": "Мера десятичной строкой в unit: \"500\", \"0.5\"."
                                        },
                                        "unit": {
                                            "type": "string",
                                            "enum": [
                                                "g",
                                                "ml"
                                            ],
                                            "description": "Единица меры: g — граммы; ml — миллилитры."
                                        }
                                    },
                                    "description": "Мера нетто одной штуки: пачка 500 г, бутылка 1000 мл. У упаковки из нескольких единиц другого варианта выводится из него, у фасованной штуки — из её меры; записать можно только у обычного штучного варианта. null у весового и объёмного и у штуки без меры."
                                },
                                "barcodes": {
                                    "type": [
                                        "array",
                                        "null"
                                    ],
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "type": "string",
                                                "enum": [
                                                    "ean13",
                                                    "ean8",
                                                    "upca",
                                                    "upce",
                                                    "code128",
                                                    "code39",
                                                    "gtin",
                                                    "itf",
                                                    "qr",
                                                    "datamatrix",
                                                    "other"
                                                ],
                                                "description": "Символика: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix или other."
                                            },
                                            "value": {
                                                "type": "string",
                                                "description": "Штрихкод."
                                            },
                                            "is_primary": {
                                                "type": [
                                                    "boolean",
                                                    "null"
                                                ],
                                                "description": "Основной штрихкод варианта: его печатают этикетки и чеки."
                                            }
                                        },
                                        "required": [
                                            "type",
                                            "value"
                                        ]
                                    },
                                    "maxItems": 20,
                                    "description": "Штрихкоды варианта."
                                }
                            },
                            "required": [
                                "price"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 200,
                        "description": "Строки вариантов, записываемые вместе с карточкой. Строка находится по своему external_id: вариант товара с этим ID правится присланными полями, без такого — заводится; неупомянутые варианты не трогаются. Для создания товара нужна хотя бы одна строка с ценой."
                    }
                },
                "required": [
                    "name",
                    "variants"
                ]
            },
            "CreatePurchaseOrderRequest": {
                "type": "object",
                "properties": {
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID поставщика (/v1/suppliers)."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID точки, куда ждём поставку (/v1/locations)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID юрлица магазина-покупателя (/v1/legal-entities); null у заказа, заведённого до юрлиц магазина."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта заказа, ISO 4217: в ней цены строк и итоги."
                    },
                    "prices_include_tax": {
                        "type": "boolean",
                        "description": "true — цены строк с налогом; false — без налога."
                    },
                    "expected_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Когда магазин ждёт поставку, YYYY-MM-DD; null, если дата не задана."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Заметка сотрудника; null, если её нет."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID варианта товара (/v1/variants)."
                                },
                                "ordered_quantity": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "description": "Заказано, десятичной строкой в базовой единице."
                                },
                                "unit_cost": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Цена в валюте заказа за cost_per_quantity; null — цена не указана."
                                },
                                "cost_per_quantity": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "description": "За какое количество в базовой единице указана цена: \"1000\" у весового товара — за килограмм."
                                }
                            },
                            "required": [
                                "variant_id",
                                "ordered_quantity"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 500,
                        "uniqueItems": true,
                        "description": "Строки заказа по порядку."
                    }
                },
                "required": [
                    "supplier_id",
                    "location_id",
                    "currency",
                    "lines"
                ]
            },
            "CreateRecommendationRuleRequest": {
                "type": "object",
                "properties": {
                    "source_type": {
                        "$ref": "#/components/schemas/RecommendationRuleSource",
                        "description": "К чему правило: category — к товарам категории и её подкатегорий; collection — к товарам подборки."
                    },
                    "source_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID категории или подборки, к товарам которой правило. У источника правило одно."
                    },
                    "target_collection_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID подборки, товары которой правило предлагает после своих; null — без подборки."
                    },
                    "product_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 20,
                        "uniqueItems": true,
                        "description": "ID товаров, которые правило предлагает, в порядке полки; не больше 20."
                    },
                    "exclusive": {
                        "type": "boolean",
                        "description": "true — «только это правило»: правила ниже и автоподбор полку не добирают; без товаров и подборки скрывает полку."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false выключает правило: оно хранится, но не действует."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Приоритет: правило с меньшим значением применяется раньше."
                    }
                },
                "required": [
                    "source_type",
                    "source_id"
                ]
            },
            "CreateRefundRequest": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "order_item_id": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "description": "ID позиции заказа (items в /v1/orders)."
                                },
                                "quantity": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "description": "Количество десятичной строкой в unit: штуки или вся мера весовой или объёмной позиции."
                                }
                            },
                            "required": [
                                "order_item_id",
                                "quantity"
                            ]
                        },
                        "maxItems": 200,
                        "uniqueItems": true,
                        "description": "Возвращённые позиции."
                    },
                    "shipping_amount": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100000000000000,
                        "description": "Часть amount, которая возвращает доставку."
                    },
                    "irreversible_to": {
                        "type": "string",
                        "enum": [
                            "manual",
                            "balance"
                        ],
                        "description": "Куда идёт доля необратимого способа (перевод, крипта, ручной способ): manual — магазин выплачивает её вручную и подтверждает (POST /v1/refunds/{refund}/confirm); balance — на баланс покупателя (balance_available расчёта)."
                    },
                    "expected_amount": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100000000000000,
                        "description": "Сумма из расчёта (/v1/orders/{order}/refunds/calculate), которую вы подтверждаете. Разнесённая скидка, прошлые возвраты или правка заказа меняют её после чтения; возврат на другую сумму не исполняется."
                    }
                },
                "required": [
                    "items",
                    "expected_amount"
                ]
            },
            "CreateSupplierBillRequest": {
                "type": "object",
                "properties": {
                    "kind": {
                        "type": "string",
                        "enum": [
                            "invoice",
                            "debit_note",
                            "credit_note"
                        ],
                        "description": "invoice — фактура; debit_note — нота дебета: увеличивает долг; credit_note — нота кредита: уменьшает долг (возврат, скидка, исправление). Суммы документа всегда положительные, знак задаёт kind."
                    },
                    "fiscal": {
                        "type": "boolean",
                        "description": "false — долг по поставке без фактуры: реквизитов ARCA нет, в книгу покупок не входит; true — фактура или нота."
                    },
                    "legal_entity_id": {
                        "type": "integer",
                        "description": "ID юрлица магазина-покупателя (/v1/legal-entities)."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID поставщика (/v1/suppliers)."
                    },
                    "related_bill_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID документа, который корректирует нота; null у фактуры и у ноты без ссылки."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 20,
                        "description": "Номер документа, как его ввёл магазин; null у долга без фактуры."
                    },
                    "issued_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Дата документа, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "tax_period": {
                        "type": "string",
                        "description": "Налоговый период, в котором документ учтён в книге покупок, YYYY-MM."
                    },
                    "due_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Срок оплаты, YYYY-MM-DD в часовом поясе магазина; null — срок не задан."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта документа, ISO 4217: в ней все суммы, кроме base_total."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "pattern": "^\\d{1,14}(\\.\\d{1,10})?$",
                        "maxLength": 1000000000000,
                        "description": "Курс валюты документа к валюте магазина десятичной строкой; null у документа в валюте магазина."
                    },
                    "net_taxed": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Облагаемая база НДС."
                    },
                    "net_exempt": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Освобождённая от НДС сумма."
                    },
                    "net_untaxed": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Не облагаемая НДС сумма."
                    },
                    "tax_total": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "НДС документа."
                    },
                    "total": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Итог документа: база, налоги и перцепции."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Заметка сотрудника; null, если её нет."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "description": {
                                    "type": "string",
                                    "maxLength": 300,
                                    "description": "Описание строки, как в документе."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID варианта товара (/v1/variants); null у строки не о товаре."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "pattern": "^\\d{1,14}(\\.\\d{1,6})?$",
                                    "minLength": 0,
                                    "maxLength": 1000000000000,
                                    "description": "Количество десятичной строкой; null, если не указано."
                                },
                                "unit_amount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Цена за единицу без налога; null, если не указана."
                                },
                                "net_amount": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Сумма строки без налога."
                                },
                                "tax_kind": {
                                    "type": "string",
                                    "enum": [
                                        "taxed",
                                        "exempt",
                                        "untaxed"
                                    ],
                                    "description": "taxed — облагается по ставке; exempt — освобождено; untaxed — не облагается."
                                },
                                "rate_bps": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000,
                                    "description": "Ставка НДС в базисных пунктах: 2100 — это 21 %."
                                },
                                "tax_amount": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "НДС строки."
                                }
                            },
                            "required": [
                                "description",
                                "net_amount",
                                "tax_kind"
                            ]
                        },
                        "maxItems": 500,
                        "description": "Строки документа по порядку; у документа, введённого итогами, строк нет."
                    },
                    "additional_taxes": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "perception",
                                        "withholding",
                                        "internal",
                                        "other"
                                    ],
                                    "description": "perception — перцепция: увеличивает сумму к оплате и зачитывается магазином; withholding — удержание: магазин удерживает его при оплате и платит в бюджет, сумма к перечислению уменьшается; internal — внутренние налоги (акцизы); other — прочие."
                                },
                                "regime": {
                                    "type": "string",
                                    "enum": [
                                        "vat",
                                        "income",
                                        "turnover",
                                        "municipal",
                                        "internal",
                                        "social",
                                        "other"
                                    ],
                                    "description": "Какой налог: vat — НДС, income — налог на прибыль, turnover — оборотный (Ingresos Brutos), municipal — муниципальный и другие."
                                },
                                "jurisdiction": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "pattern": "^[A-Z]{2}-[A-Z0-9]{1,5}$",
                                    "maxLength": 8,
                                    "description": "Юрисдикция налога, например провинция Ingresos Brutos; null, если налогу она не нужна."
                                },
                                "amount": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Сумма налога."
                                },
                                "certificate_number": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 64,
                                    "description": "Номер справки об удержании или перцепции; null, если её нет."
                                }
                            },
                            "required": [
                                "kind",
                                "regime",
                                "amount"
                            ]
                        },
                        "maxItems": 50,
                        "description": "Налоги сверх НДС: перцепции, удержания, внутренние и прочие. У них в документе только сумма, без базы и ставки."
                    },
                    "goods_receipt_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 100,
                        "description": "ID приёмок, которые покрывает документ (/v1/goods-receipts): поставки, сверенные с фактурой, или поставка долга."
                    },
                    "purchase_order_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 100,
                        "description": "ID заказов поставщику, к которым относится документ (/v1/purchase-orders)."
                    },
                    "supplier_return_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 100,
                        "description": "ID возвратов поставщику, за которые выставлена нота кредита (/v1/supplier-returns)."
                    },
                    "ar": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "document_type_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 3,
                                "description": "Код типа comprobante ARCA: 001 — фактура A, 006 — фактура B, 011 — фактура C; null, если не указан."
                            },
                            "point_of_sale": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "minimum": 0,
                                "maximum": 99999,
                                "description": "Точка продаж поставщика (punto de venta); null, если не указана."
                            },
                            "authorization_kind": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "CAE",
                                    "CAEA",
                                    "CAI",
                                    null
                                ],
                                "description": "CAE — электронный документ; CAEA — код, выданный на период; CAI — печатный бланк; null — без авторизации (например, зарубежный документ)."
                            },
                            "authorization_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 14,
                                "description": "Код авторизации; null, если не указан."
                            },
                            "authorization_expires_on": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date",
                                "description": "Срок действия кода авторизации, YYYY-MM-DD; null, если не указан."
                            },
                            "credit_fiscal_amount": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "minimum": 0,
                                "maximum": 10000000000,
                                "description": "Зачитываемая часть НДС при пропорциональном зачёте; null — зачитывается весь налог."
                            },
                            "import": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "kind": {
                                        "type": "string",
                                        "enum": [
                                            "goods",
                                            "services"
                                        ],
                                        "description": "goods — импорт товаров по таможенному оформлению; services — услуги исполнителя из-за рубежа."
                                    },
                                    "customs_declaration": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 16,
                                        "description": "Номер таможенного оформления (despacho) импорта товаров; null, если не указан."
                                    },
                                    "document_kind": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "enum": [
                                            "invoice",
                                            "contract",
                                            "other",
                                            null
                                        ],
                                        "description": "Документ исполнителя услуг: invoice — фактура, contract — договор, other — прочее (с описанием); null, если не указан."
                                    },
                                    "document_description": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 20,
                                        "description": "Описание документа вида other; null у прочих."
                                    },
                                    "provider_tax_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 20,
                                        "description": "Налоговый номер исполнителя в его стране; null, если не указан."
                                    },
                                    "tax_paid_on": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "format": "date",
                                        "description": "Дата уплаты НДС за импорт услуг, YYYY-MM-DD; null, если не указана."
                                    },
                                    "tax_paid_amount": {
                                        "type": [
                                            "integer",
                                            "null"
                                        ],
                                        "minimum": 0,
                                        "maximum": 10000000000,
                                        "description": "Уплаченный НДС за импорт услуг в валюте документа; null, если не указан."
                                    },
                                    "payment_reference": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 20,
                                        "description": "Идентификатор платежа налога; null, если не указан."
                                    },
                                    "payment_entity_tax_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 11,
                                        "description": "CUIT банка, через который внесён налог; null, если не указан."
                                    }
                                },
                                "description": "Импорт товаров или услуг — своя раскладка книги импорта ARCA; null у внутреннего документа."
                            }
                        },
                        "description": "Реквизиты ARCA фактуры или ноты; null у долга по поставке без фактуры."
                    }
                },
                "required": [
                    "kind",
                    "fiscal",
                    "legal_entity_id",
                    "supplier_id",
                    "issued_on",
                    "currency",
                    "total"
                ]
            },
            "CreateSupplierRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 200,
                        "description": "Название поставщика, как его видит магазин."
                    },
                    "tax_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Налоговый номер, как его ввёл магазин (CUIT в Аргентине); null, если не задан."
                    },
                    "tax_id_country": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "AR",
                            "BR",
                            "CL",
                            "CO",
                            "MX",
                            "PE",
                            "RU",
                            null
                        ],
                        "description": "Страна налогового номера, ISO 3166-1 alpha-2; null, если номер не задан."
                    },
                    "legal_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200,
                        "description": "Юридическое наименование; null, если не задано."
                    },
                    "settlement_mode": {
                        "$ref": "#/components/schemas/SupplierSettlementMode",
                        "description": "on_receipt — обычная закупка: долг возникает при приёмке; on_sale — реализация: магазин платит за проданное по акту реализации."
                    },
                    "consignment_loss_policy": {
                        "$ref": "#/components/schemas/ConsignmentLossPolicy",
                        "description": "Кто платит за просрочку и недостачу товара на реализации: return_to_supplier — товар возвращается поставщику; our_cost — потеря магазина."
                    },
                    "prices_include_tax": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "true — поставщик называет цены с налогом, false — без налога; null — по правилу магазина."
                    },
                    "payment_term_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 365,
                        "description": "Отсрочка оплаты в днях: из неё считается срок счёта due_on. null — отсрочки нет."
                    },
                    "min_order_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "maximum": 100000000000000,
                        "description": "Минимальная сумма заказа в минимальных единицах currency; null — минимума нет."
                    },
                    "lead_time_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 365,
                        "description": "Срок поставки в днях от заказа; null, если не задан."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — поставщик выключен: новые заказы ему не делают, документы остаются."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта закупки у поставщика, ISO 4217: в ней min_order_amount и цены его заказов."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "CreateUploadRequest": {
                "type": "object",
                "properties": {
                    "file_name": {
                        "type": "string",
                        "maxLength": 255,
                        "description": "Имя файла, данное при начале загрузки."
                    },
                    "size": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 268435456,
                        "description": "Размер всего файла в байтах."
                    }
                },
                "required": [
                    "file_name",
                    "size"
                ]
            },
            "CreateVariantRequest": {
                "type": "object",
                "properties": {
                    "product_id": {
                        "type": "integer",
                        "description": "ID товара."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    },
                    "sku": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Артикул (SKU); null, если не задан."
                    },
                    "name": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название варианта по языкам, например {\"es\": \"Grande\"}."
                    },
                    "price": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Цена за price_per_quantity единиц, целым в минимальных единицах currency."
                    },
                    "track_inventory": {
                        "type": "boolean",
                        "description": "Магазин ведёт остаток варианта; false — продаёт без учёта остатка."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false снимает вариант с продажи."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Позиция среди вариантов товара: меньшая идёт первой."
                    },
                    "list_price": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Цена, как её назначил владелец, в минимальных единицах list_price_currency; null — цена назначена в деньгах учёта (price). У такой позиции price считает система по курсу прайса и во входе его не принимает."
                    },
                    "list_price_currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB",
                            null
                        ],
                        "description": "Валюта назначенной цены (прайс магазина в чужой валюте); null — цена в валюте магазина currency. Во входе — валюта прайса магазина или currency."
                    },
                    "compare_at_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "maximum": 10000000000,
                        "description": "Цена до скидки, показывается зачёркнутой; null, если скидки нет."
                    },
                    "weight_grams": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Вес для доставки в граммах; null, если не задан."
                    },
                    "length_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Длина упаковки в миллиметрах; null, если не задана."
                    },
                    "width_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Ширина упаковки в миллиметрах; null, если не задана."
                    },
                    "height_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Высота упаковки в миллиметрах; null, если не задана."
                    },
                    "sale_starts_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда начинается распродажа: compare_at_price показывается с этого момента; null — без начала."
                    },
                    "sale_ends_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда распродажа заканчивается; null — без конца."
                    },
                    "sold_by": {
                        "type": "string",
                        "enum": [
                            "each",
                            "weight",
                            "volume"
                        ],
                        "description": "Как продаётся вариант: each — поштучно; weight — на вес; volume — на объём."
                    },
                    "price_per_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "За сколько единиц цена, десятичной строкой: за одну штуку или за 1000 — цена килограмма у весового варианта. null, если у весового или объёмного варианта она не задана."
                    },
                    "measure_step": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Шаг количества в строке весового или объёмного варианта, в его единице; null, если не задан."
                    },
                    "min_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Наименьшее количество в строке весового или объёмного варианта; null, если не задано."
                    },
                    "max_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Наибольшее количество в строке весового или объёмного варианта; null, если не задано."
                    },
                    "net_content": {
                        "type": "object",
                        "properties": {
                            "quantity": {
                                "type": "string",
                                "maxLength": 32,
                                "description": "Мера десятичной строкой в unit: \"500\", \"0.5\"."
                            },
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml"
                                ],
                                "description": "Единица меры: g — граммы; ml — миллилитры."
                            }
                        },
                        "description": "Мера нетто одной штуки: пачка 500 г, бутылка 1000 мл. У упаковки из нескольких единиц другого варианта выводится из него, у фасованной штуки — из её меры; записать можно только у обычного штучного варианта. null у весового и объёмного и у штуки без меры."
                    },
                    "barcodes": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string",
                                    "enum": [
                                        "ean13",
                                        "ean8",
                                        "upca",
                                        "upce",
                                        "code128",
                                        "code39",
                                        "gtin",
                                        "itf",
                                        "qr",
                                        "datamatrix",
                                        "other"
                                    ],
                                    "description": "Символика: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix или other."
                                },
                                "value": {
                                    "type": "string",
                                    "description": "Штрихкод."
                                },
                                "is_primary": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "Основной штрихкод варианта: его печатают этикетки и чеки."
                                }
                            },
                            "required": [
                                "type",
                                "value"
                            ]
                        },
                        "maxItems": 20,
                        "description": "Штрихкоды варианта."
                    },
                    "option_values": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID опции из options товара."
                                },
                                "value_id": {
                                    "type": "integer",
                                    "description": "ID значения из values этой опции."
                                }
                            },
                            "required": [
                                "option_id",
                                "value_id"
                            ]
                        },
                        "maxItems": 10,
                        "description": "Значения опций варианта: по одному значению каждой опции товара."
                    },
                    "stock_source_variant_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "У упаковки из нескольких единиц другого варианта — этот вариант. Упаковка продаётся из его остатка, своих уровней остатка у неё нет. null у обычного варианта."
                    },
                    "stock_source_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Сколько базового варианта забирает одна штука упаковки, десятичной строкой в единице базового варианта; null у обычного варианта."
                    },
                    "sibling_name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название по языкам единственного варианта товара, который этот запрос делает одним из нескольких: у единственного варианта своего названия нет, у одного из нескольких оно обязательно."
                    }
                },
                "required": [
                    "product_id",
                    "price"
                ]
            },
            "CreateWebhookEndpointRequest": {
                "type": "object",
                "properties": {
                    "url": {
                        "type": "string",
                        "maxLength": 2048,
                        "description": "HTTPS-адрес, на который уходят доставки."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Описание адреса; null, если не задано."
                    },
                    "enabled_events": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "enum": [
                                "order.created",
                                "order.updated",
                                "order.status_changed",
                                "order.paid",
                                "order.cancelled",
                                "payment.created",
                                "payment.succeeded",
                                "payment.status_changed",
                                "payment.updated",
                                "refund.created",
                                "refund.completed",
                                "refund.status_changed",
                                "refund.updated",
                                "fiscal_document.created",
                                "fiscal_document.updated",
                                "fiscal_document.issued",
                                "fiscal_document.failed",
                                "fiscal_document.annulled",
                                "tax_period.status_changed",
                                "money_transaction.created",
                                "money_transaction.updated",
                                "money_transaction.deleted",
                                "pos_shift.opened",
                                "pos_shift.closed",
                                "pos_shift.updated",
                                "pos_cash_movement.created",
                                "gift_card.created",
                                "gift_card.updated",
                                "gift_card_transaction.created",
                                "customer_account.created",
                                "customer_account.updated",
                                "customer_account_entry.created",
                                "customer_account_entry.updated",
                                "supplier.created",
                                "supplier.updated",
                                "supplier.deleted",
                                "supplier_bill.created",
                                "supplier_bill.updated",
                                "supplier_bill.posted",
                                "supplier_bill.voided",
                                "supplier_bill.deleted",
                                "supplier_bill_payment.created",
                                "supplier_bill_payment.updated",
                                "supplier_bill_payment.deleted",
                                "settlement_agreement.created",
                                "settlement_agreement.updated",
                                "settlement_agreement.deleted",
                                "settlement_offset.created",
                                "settlement_offset.updated",
                                "settlement_offset.voided",
                                "purchase_order.created",
                                "purchase_order.updated",
                                "purchase_order.status_changed",
                                "purchase_order.deleted",
                                "goods_receipt.created",
                                "goods_receipt.updated",
                                "goods_receipt.voided",
                                "supplier_return.created",
                                "supplier_return.updated",
                                "supplier_return.status_changed",
                                "supplier_return.deleted",
                                "consignment_settlement.created",
                                "consignment_settlement.updated",
                                "consignment_settlement.posted",
                                "consignment_settlement.voided",
                                "tax_withholding.created",
                                "tax_withholding.updated",
                                "tax_withholding.annulled",
                                "tax_withholding.deleted",
                                "product.created",
                                "product.updated",
                                "product.deleted",
                                "inventory_level.updated",
                                "stock_movement.created",
                                "stock_movement.updated",
                                "lot.created",
                                "lot.updated",
                                "lot.deleted",
                                "location_transfer.created",
                                "location_transfer.updated",
                                "stocktake.created",
                                "stocktake.status_changed",
                                "stocktake.updated",
                                "customer.created",
                                "customer.updated",
                                "customer.deleted",
                                "customer_group.created",
                                "customer_group.updated",
                                "customer_group.deleted",
                                "price_list.created",
                                "price_list.updated",
                                "price_list.deleted",
                                "bulk_operation.finished"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 93,
                        "uniqueItems": true,
                        "description": "Типы событий, на которые подписан адрес, например order.created; типы — те же, что в GET /v1/events. Тип, scope чтения которого приложение потеряло, не доставляется."
                    }
                },
                "required": [
                    "url",
                    "enabled_events"
                ]
            },
            "Customer": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id покупателя — его id в вашей системе; null, если не задан. После слияния двух покупателей ID поглощённого тоже находит выжившего; в ответе — основной ID."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Имя покупателя; null, если неизвестно."
                    },
                    "phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Основной телефон покупателя в формате E.164, например +5491123456789; null, если неизвестен."
                    },
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Email покупателя; null, если неизвестен."
                    },
                    "language": {
                        "type": "string",
                        "enum": [
                            "ru",
                            "en",
                            "es"
                        ],
                        "description": "Язык, на котором магазин пишет покупателю: ru, en или es."
                    },
                    "is_blocked": {
                        "type": "boolean",
                        "description": "Магазин заблокировал покупателя: войти на витрину он не может."
                    },
                    "marketing_consents": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "channel": {
                                    "type": "string",
                                    "enum": [
                                        "email",
                                        "telegram",
                                        "whatsapp",
                                        "instagram"
                                    ],
                                    "description": "Канал рекламы: email, telegram, whatsapp или instagram."
                                },
                                "status": {
                                    "type": "string",
                                    "enum": [
                                        "subscribed",
                                        "unsubscribed"
                                    ],
                                    "description": "subscribed — покупатель явно согласился на рекламу в канале, unsubscribed — отказался."
                                },
                                "consented_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Когда покупатель последний раз явно согласился на рекламу в канале; отказ это время не стирает. null, если не соглашался."
                                }
                            },
                            "required": [
                                "channel",
                                "status",
                                "consented_at"
                            ]
                        },
                        "description": "Согласие на рекламу по каналам (email, telegram, whatsapp, instagram): строка канала, где покупатель явно согласился (subscribed) или отказался (unsubscribed), и момент последнего явного согласия. Канала нет — согласие подразумеваемое: магазин с marketing_consent_mode: opt_out пишет в такой канал, с opt_in — нет. В WhatsApp — только при subscribed."
                    },
                    "accepts_marketing": {
                        "type": "boolean",
                        "description": "Устарело, см. marketing_consents: покупатель не отписался от рекламы по почте."
                    },
                    "marketing_consent_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Устарело, см. marketing_consents: когда покупатель явно согласился на рекламу по почте; null, если не соглашался."
                    },
                    "balance": {
                        "type": "integer",
                        "description": "Баланс покупателя в магазине: им можно оплачивать заказы. В минимальных единицах валюты магазина."
                    },
                    "addresses": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID адреса."
                                },
                                "customer_id": {
                                    "type": "integer",
                                    "description": "ID покупателя, которому принадлежит адрес."
                                },
                                "label": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Название адреса, например «Дом» или «Работа»; null, если не задано."
                                },
                                "street": {
                                    "type": "string",
                                    "description": "Улица."
                                },
                                "house": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Номер дома."
                                },
                                "apartment": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Квартира или офис."
                                },
                                "floor": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Этаж."
                                },
                                "entrance": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Подъезд."
                                },
                                "district": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Район."
                                },
                                "postal_code": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Почтовый индекс."
                                },
                                "comment": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Комментарий для курьера, например как пройти; null, если не задан."
                                },
                                "location": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "lat": {
                                            "type": "number",
                                            "description": "Широта в градусах."
                                        },
                                        "lng": {
                                            "type": "number",
                                            "description": "Долгота в градусах."
                                        }
                                    },
                                    "required": [
                                        "lat",
                                        "lng"
                                    ],
                                    "description": "Точка адреса на карте; null, если адрес перенесён из другой системы и ещё не уточнён."
                                },
                                "is_default": {
                                    "type": "boolean",
                                    "description": "Основной адрес покупателя. Когда основной адрес удаляют, основным становится самый свежий."
                                },
                                "created_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "Когда запись создана."
                                },
                                "updated_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "Когда запись менялась последний раз."
                                }
                            },
                            "required": [
                                "id",
                                "customer_id",
                                "label",
                                "street",
                                "house",
                                "apartment",
                                "floor",
                                "entrance",
                                "district",
                                "postal_code",
                                "comment",
                                "location",
                                "is_default",
                                "created_at",
                                "updated_at"
                            ]
                        },
                        "description": "Адресная книга покупателя, её размер ограничивает магазин. Удалённого адреса просто нет в списке."
                    },
                    "group_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "Группы покупателя по возрастанию id. Членство пишут команды группы: его смена сдвигает покупателя в ленте и шлёт customer.updated, а version и updated_at не меняет."
                    },
                    "wholesale_price_list_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Оптовый прайс-лист покупателя-юрлица: по нему считаются его оптовые продажи. null — оптом по базовым ценам. Сам лист виден только с costs:read."
                    },
                    "merged_into_customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Покупатель, в которого влит этот: ему перешли контакты, адреса и заказы. null, если не влит."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда запись отправлена в архив; null у живой записи."
                    }
                },
                "required": [
                    "id",
                    "external_id",
                    "version",
                    "name",
                    "phone",
                    "email",
                    "language",
                    "is_blocked",
                    "marketing_consents",
                    "accepts_marketing",
                    "marketing_consent_at",
                    "balance",
                    "addresses",
                    "group_ids",
                    "wholesale_price_list_id",
                    "merged_into_customer_id",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "CustomerAccount": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "active",
                            "suspended"
                        ],
                        "description": "Состояние: active — покупатель берёт в долг в пределах лимита; suspended — новые продажи в долг закрыты, долг остаётся и гасится."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "balance": {
                        "type": "integer",
                        "description": "Остаток в минимальных единицах валюты: плюс — покупатель должен, минус — переплата. Равен сумме amount всех записей счёта (/v1/customer-account-entries)."
                    },
                    "credit_limit": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Кредитный лимит в минимальных единицах валюты; null — без лимита. Сверх лимита и при просрочке продают в долг только с подтверждением менеджера."
                    },
                    "payment_terms_days": {
                        "type": "integer",
                        "description": "Срок оплаты продажи в долг, дней: срок начисления (due_on) — день продажи плюс этот срок."
                    },
                    "customer_id": {
                        "type": "integer",
                        "description": "ID покупателя (/v1/customers). Только с доступом к покупателям."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка сотрудника о покупателе; null, если её нет. Только с доступом к покупателям: удаление покупателя её стирает."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "status",
                    "currency",
                    "balance",
                    "credit_limit",
                    "payment_terms_days",
                    "created_at",
                    "updated_at"
                ]
            },
            "CustomerAccountEntry": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "customer_account_id": {
                        "type": "integer",
                        "description": "ID счёта покупателя (/v1/customer-accounts). Меняется только при слиянии покупателей: запись переезжает на счёт оставшегося."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "charge",
                            "opening_balance",
                            "opening_credit",
                            "payment",
                            "return",
                            "write_off",
                            "offset",
                            "withholding",
                            "reversal"
                        ],
                        "description": "Вид записи: charge — продажа в долг; opening_balance — долг из прежнего учёта; opening_credit — переплата из прежнего учёта; payment — погашение; return — возврат товара по долговой продаже; write_off — списание безнадёжного долга; offset — взаимозачёт с покупателем как поставщиком; withholding — налог, удержанный покупателем-агентом при погашении; reversal — сторно записи reverses_entry_id."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Сумма со знаком в минимальных единицах валюты: плюс — долг вырос, минус — уменьшился."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID юрлица магазина (/v1/legal-entities), перед которым долг: погашение закрывает долги только своего юрлица. null, если юрлицо не задано."
                    },
                    "due_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Срок оплаты начисления, YYYY-MM-DD в часовом поясе магазина: со следующего дня долг просрочен. null у уменьшений долга."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Момент операции. Долг из прежнего учёта датирован задним числом: порядок операций — по этому полю, а не по порядку записи."
                    },
                    "order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID заказа (/v1/orders): продажа в долг или заказ-погашение с account_payment_amount; null, если заказа нет."
                    },
                    "payment_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID платежа (/v1/payments) способом on_account у продажи в долг; null у остальных записей. Деньги погашения — платёж его заказа order_id."
                    },
                    "refund_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID возврата (/v1/refunds), которым товар вернули по долговой продаже; null у других записей."
                    },
                    "reverses_entry_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID записи, которую гасит это сторно; null у обычной записи."
                    },
                    "settlement_offset_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID взаимозачёта (/v1/settlement-offsets) у записи вида offset; null у остальных. Сторно зачёта ссылается на запись (reverses_entry_id)."
                    },
                    "tax_withholding_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID справки в реестре удержаний (/v1/tax-withholdings, scope fiscal:read) у записи вида withholding; null у остальных и когда справку сняли из реестра — сторно записи снимает справку, заведённую погашением."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка сотрудника: основание списания, переноса или сторно; null, если её нет."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись внесена в журнал."
                    }
                },
                "required": [
                    "id",
                    "customer_account_id",
                    "kind",
                    "amount",
                    "currency",
                    "legal_entity_id",
                    "due_on",
                    "occurred_at",
                    "order_id",
                    "payment_id",
                    "refund_id",
                    "reverses_entry_id",
                    "settlement_offset_id",
                    "tax_withholding_id",
                    "note",
                    "created_at"
                ]
            },
            "CustomerAccountStatement": {
                "type": "object",
                "properties": {
                    "customer_account_id": {
                        "type": "integer",
                        "description": "ID счёта покупателя (/v1/customer-accounts)."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "from": {
                        "type": "string",
                        "description": "Первый день периода, YYYY-MM-DD в часовом поясе магазина; без from в запросе — день первой операции счёта."
                    },
                    "to": {
                        "type": "string",
                        "description": "Последний день периода, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "opening_balance": {
                        "type": "integer",
                        "description": "Долг на начало периода: сумма операций до from."
                    },
                    "closing_balance": {
                        "type": "integer",
                        "description": "Долг на конец периода: opening_balance плюс строки периода."
                    },
                    "charged": {
                        "type": "integer",
                        "description": "Сумма увеличений долга за период."
                    },
                    "reduced": {
                        "type": "integer",
                        "description": "Сумма уменьшений долга за период, положительным числом."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "entry_id": {
                                    "type": "integer",
                                    "description": "ID записи журнала (/v1/customer-account-entries)."
                                },
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "charge",
                                        "opening_balance",
                                        "opening_credit",
                                        "payment",
                                        "return",
                                        "write_off",
                                        "offset",
                                        "withholding",
                                        "reversal"
                                    ],
                                    "description": "Вид записи, те же значения, что у kind записи журнала."
                                },
                                "occurred_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "Момент операции."
                                },
                                "order_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID заказа (/v1/orders); null, если заказа нет."
                                },
                                "due_on": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date",
                                    "description": "Срок оплаты начисления; null у уменьшений долга."
                                },
                                "note": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Заметка сотрудника; null, если её нет."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Сумма со знаком: плюс — долг вырос, минус — уменьшился."
                                },
                                "balance": {
                                    "type": "integer",
                                    "description": "Долг после этой строки."
                                }
                            },
                            "required": [
                                "entry_id",
                                "kind",
                                "occurred_at",
                                "order_id",
                                "due_on",
                                "note",
                                "amount",
                                "balance"
                            ]
                        },
                        "description": "Записи периода в порядке операций (occurred_at) с нарастающим остатком."
                    },
                    "open_items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "entry_id": {
                                    "type": "integer",
                                    "description": "ID начисления (/v1/customer-account-entries)."
                                },
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "charge",
                                        "opening_balance"
                                    ],
                                    "description": "charge — продажа в долг; opening_balance — долг из прежнего учёта."
                                },
                                "occurred_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "Момент операции."
                                },
                                "order_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID заказа (/v1/orders); null, если заказа нет."
                                },
                                "due_on": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date",
                                    "description": "Срок оплаты начисления, YYYY-MM-DD в часовом поясе магазина."
                                },
                                "open_amount": {
                                    "type": "integer",
                                    "description": "Недоплаченная часть начисления на конец периода."
                                },
                                "overdue": {
                                    "type": "boolean",
                                    "description": "Срок оплаты прошёл до to: на конец периода долг просрочен."
                                }
                            },
                            "required": [
                                "entry_id",
                                "kind",
                                "occurred_at",
                                "order_id",
                                "due_on",
                                "open_amount",
                                "overdue"
                            ]
                        },
                        "description": "Начисления, не закрытые на конец периода, по сроку оплаты. Какое погашение закрыло какое начисление, решает распределение FIFO в пределах юрлица."
                    }
                },
                "required": [
                    "customer_account_id",
                    "currency",
                    "from",
                    "to",
                    "opening_balance",
                    "closing_balance",
                    "charged",
                    "reduced",
                    "lines",
                    "open_items"
                ]
            },
            "CustomerAddress": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID адреса."
                    },
                    "customer_id": {
                        "type": "integer",
                        "description": "ID покупателя, которому принадлежит адрес."
                    },
                    "label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Название адреса, например «Дом» или «Работа»; null, если не задано."
                    },
                    "street": {
                        "type": "string",
                        "description": "Улица."
                    },
                    "house": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Номер дома."
                    },
                    "apartment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Квартира или офис."
                    },
                    "floor": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Этаж."
                    },
                    "entrance": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Подъезд."
                    },
                    "district": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Район."
                    },
                    "postal_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Почтовый индекс."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Комментарий для курьера, например как пройти; null, если не задан."
                    },
                    "location": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "lat": {
                                "type": "number",
                                "description": "Широта в градусах."
                            },
                            "lng": {
                                "type": "number",
                                "description": "Долгота в градусах."
                            }
                        },
                        "required": [
                            "lat",
                            "lng"
                        ],
                        "description": "Точка адреса на карте; null, если адрес перенесён из другой системы и ещё не уточнён."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "Основной адрес покупателя. Когда основной адрес удаляют, основным становится самый свежий."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "customer_id",
                    "label",
                    "street",
                    "house",
                    "apartment",
                    "floor",
                    "entrance",
                    "district",
                    "postal_code",
                    "comment",
                    "location",
                    "is_default",
                    "created_at",
                    "updated_at"
                ]
            },
            "CustomerFiscalProfile": {
                "type": "object",
                "properties": {
                    "customer_id": {
                        "type": "integer",
                        "description": "ID покупателя."
                    },
                    "receptor": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id_type": {
                                "type": "string",
                                "enum": [
                                    "tax_id",
                                    "personal_id",
                                    "national_id",
                                    "passport",
                                    "none"
                                ],
                                "description": "Вид идентификатора: tax_id — налоговый номер организации (CUIT в Аргентине); personal_id — налоговый номер физлица (CUIL); national_id — удостоверение личности (DNI); passport — паспорт; none — без идентификатора."
                            },
                            "id_number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Номер идентификатора; null, когда id_type — none."
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Наименование или полное имя для документа; null, если не задано."
                            },
                            "tax_status": {
                                "type": "string",
                                "enum": [
                                    "registered",
                                    "small_taxpayer",
                                    "exempt",
                                    "final_consumer",
                                    "not_categorized",
                                    "foreign"
                                ],
                                "description": "Налоговый статус: registered — плательщик НДС (Responsable Inscripto в Аргентине); small_taxpayer — упрощённый режим (Monotributo); exempt — освобождён от НДС; final_consumer — конечный потребитель; not_categorized — без категории; foreign — иностранный покупатель."
                            },
                            "address": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Фискальный адрес одной строкой; null, если не задан."
                            }
                        },
                        "required": [
                            "id_type",
                            "id_number",
                            "name",
                            "tax_status",
                            "address"
                        ],
                        "description": "Реквизиты, под которыми выписываются документы новых заказов; null — розничный покупатель без реквизитов. Оформленный заказ хранит свою копию (fiscal_receptor заказа)."
                    }
                },
                "required": [
                    "customer_id",
                    "receptor"
                ]
            },
            "CustomerGroup": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "name": {
                        "type": "string",
                        "description": "Имя группы — ярлык магазина, покупатель его не видит. Уникально в магазине без учёта регистра."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Описание группы для сотрудников; null, если не задано."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "Активна ли группа. Неактивная группа никого не выбирает: скидки и рассылки её участников не видят, членство сохраняется."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "name",
                    "description",
                    "is_active",
                    "created_at",
                    "updated_at"
                ]
            },
            "DeliveryMethod": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "code": {
                        "type": "string",
                        "description": "Код записи, уникальный в магазине: не меняется при переименовании."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Название способа доставки по языкам."
                    },
                    "fulfilment_type": {
                        "type": "string",
                        "enum": [
                            "self_pickup",
                            "home_delivery",
                            "parcel_locker",
                            "mail_post",
                            "pos",
                            "aggregator",
                            "manual_courier"
                        ],
                        "description": "Как способ доставляет, те же значения, что у fulfilment_type заказа."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — покупатели не могут выбрать способ."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Позиция при сортировке: меньшая идёт первой."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда запись отправлена в архив; null у живой записи."
                    }
                },
                "required": [
                    "id",
                    "code",
                    "name",
                    "fulfilment_type",
                    "is_active",
                    "position",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "DiscountRoundingMode": {
                "type": "string",
                "enum": [
                    "nearest",
                    "up",
                    "down"
                ]
            },
            "DismissFiscalDocumentRequest": {
                "type": "object",
                "properties": {
                    "reason": {
                        "type": "string",
                        "minLength": 3,
                        "maxLength": 500,
                        "description": "Почему документ не будут выпускать, своими словами, от 3 до 500 символов: её спросит налоговый аудит."
                    }
                },
                "required": [
                    "reason"
                ]
            },
            "DraftOrder": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Ревизия черновика: её сдвигает любая правка, в том числе сотрудником в панели. Под ней черновик правится, удаляется и оформляется."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "open",
                            "completed",
                            "cancelled"
                        ],
                        "description": "open — правится и оформляется; completed — оформлен, заказ в order_id; cancelled — отменён без заказа."
                    },
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Покупатель черновика (/v1/customers); null, пока не выбран."
                    },
                    "order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Заказ, оформленный из черновика; null до оформления."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID строки в черновике."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Вариант строки; null у свободной строки."
                                },
                                "product_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Товар строки; null у свободной строки."
                                },
                                "product_name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "string"
                                    },
                                    "description": "Название товара на момент продажи, по языкам."
                                },
                                "variant_name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "string"
                                    },
                                    "description": "Название варианта на момент продажи, по языкам; пустой объект, если у варианта не было названия."
                                },
                                "custom_name": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Название свободной строки, которую сотрудник завёл без товара; null у строки с вариантом."
                                },
                                "quantity": {
                                    "type": "string",
                                    "description": "Количество десятичной строкой в unit: штуки у штучной позиции, мера у весовой или объёмной (\"480\" граммов)."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "pcs",
                                        "g",
                                        "ml",
                                        null
                                    ],
                                    "description": "Единица quantity: pcs, g или ml; null, если вариант больше не знает единицу своей меры."
                                },
                                "unit_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Цена единицы с добавками; null у закрытого черновика."
                                },
                                "discount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Уценка строки; null у закрытого черновика."
                                },
                                "total": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Сумма строки до уценки; null у закрытого черновика."
                                },
                                "modifiers": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "option_id": {
                                                "type": "integer",
                                                "description": "ID варианта добавки."
                                            },
                                            "quantity": {
                                                "type": "integer",
                                                "description": "Сколько раз добавка добавлена."
                                            }
                                        },
                                        "required": [
                                            "option_id",
                                            "quantity"
                                        ]
                                    },
                                    "description": "Добавки строки, например топпинги блюда."
                                }
                            },
                            "required": [
                                "id",
                                "variant_id",
                                "product_id",
                                "product_name",
                                "variant_name",
                                "custom_name",
                                "quantity",
                                "unit",
                                "unit_price",
                                "discount",
                                "total",
                                "modifiers"
                            ]
                        },
                        "description": "Позиции черновика. Открытый черновик считается живьём по каталогу, скидкам и доставке; закрытый хранит позиции без цен."
                    },
                    "delivery_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Способ доставки (/v1/delivery-methods); null, пока не выбран."
                    },
                    "address_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Адрес из адресной книги покупателя — для способа с доставкой; null, пока не выбран."
                    },
                    "pickup_location_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Пункт самовывоза для способа самовывоза. Единственный пункт способ берёт сам; из нескольких черновик должен назвать один."
                    },
                    "delivery_slots": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "from": {
                                    "type": "string",
                                    "description": "Начало окна."
                                },
                                "to": {
                                    "type": "string",
                                    "description": "Конец окна."
                                }
                            },
                            "required": [
                                "from",
                                "to"
                            ]
                        },
                        "description": "Окна доставки, выбранные для способа, который работает с окнами."
                    },
                    "delivery_cost_override": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Цена доставки, названная вручную, вместо расчёта способа; null — по правилам способа."
                    },
                    "payment_method": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "cash",
                            "mercadopago",
                            "crypto",
                            "bybit",
                            "trc20",
                            "balance",
                            "modo",
                            "payway",
                            "mercadopago_qr",
                            "mercadopago_point",
                            "mercadopago_transfer",
                            "gift_card",
                            "subscription",
                            "deposit",
                            "external",
                            "manual",
                            "offset",
                            "on_account",
                            "exchange_credit",
                            "bonpunto",
                            "service_package",
                            null
                        ],
                        "description": "Способ оплаты, которым черновик оформится: от него зависят скидки за способ и совместимость с доставкой."
                    },
                    "manual_payment_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Ручной способ оплаты магазина, когда payment_method — manual; иначе null."
                    },
                    "promocode": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Промокод черновика; null, если нет."
                    },
                    "customer_comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Комментарий покупателя к заказу. Только со scope customers:read."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внутренняя заметка магазина: уходит в заказ, покупатель её не видит."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "items_total": {
                        "type": "integer",
                        "description": "Сумма строк до скидки заказа."
                    },
                    "discount": {
                        "type": "integer",
                        "description": "Скидка заказа."
                    },
                    "delivery_cost": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Доставка к оплате; null, если её ещё нельзя посчитать."
                    },
                    "total": {
                        "type": "integer",
                        "description": "Сумма к оплате."
                    },
                    "issues": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "code": {
                                    "type": "string",
                                    "enum": [
                                        "customer_required",
                                        "phone_required",
                                        "items_empty",
                                        "import_lines_pending",
                                        "import_parse_running",
                                        "items_unavailable",
                                        "modifier_invalid",
                                        "price_missing",
                                        "measure_required",
                                        "insufficient_stock",
                                        "presale_not_ready",
                                        "presale_plan_short",
                                        "gift_card_sales_disabled",
                                        "delivery_method_required",
                                        "address_required",
                                        "branch_required",
                                        "pickup_location_required",
                                        "pickup_location_none",
                                        "pickup_location_mismatch",
                                        "slot_required",
                                        "slot_invalid",
                                        "delivery_not_applicable",
                                        "delivery_cost_required",
                                        "promocode_invalid",
                                        "payment_delivery_incompatible"
                                    ],
                                    "description": "customer_required — нет покупателя; phone_required — у покупателя нет телефона; items_empty — нет строк; import_lines_pending, import_parse_running — импортированные строки ещё не готовы; items_unavailable — товар не продаётся; modifier_invalid — добавка не подходит к позиции; price_missing — у товара нет цены; measure_required — весовой или объёмной позиции нужна мера; insufficient_stock — не хватает остатка; presale_not_ready, presale_plan_short — товар предзаказа не готов или его осталось меньше заказанного; gift_card_sales_disabled — магазин не продаёт подарочные карты; delivery_method_required — нет способа доставки; address_required — доставке нужен адрес; branch_required — способу нужен пункт выдачи перевозчика; pickup_location_required — у способа несколько пунктов самовывоза, назовите один; pickup_location_none — у способа нет доступного пункта; pickup_location_mismatch — пункт не обслуживается способом; slot_required — способу нужно окно доставки; slot_invalid — окно недоступно; delivery_not_applicable — способ не доставляет этот заказ; delivery_cost_required — способу нужна цена доставки вручную; promocode_invalid — промокод не применяется; payment_delivery_incompatible — способ оплаты не работает с этим способом доставки."
                                },
                                "line_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Строка, о которой проблема; null у проблемы черновика целиком."
                                }
                            },
                            "required": [
                                "code",
                                "line_id"
                            ]
                        },
                        "description": "Что мешает оформлению; пусто, если ничего, и у закрытого черновика."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "status",
                    "customer_id",
                    "order_id",
                    "lines",
                    "delivery_method_id",
                    "address_id",
                    "pickup_location_id",
                    "delivery_slots",
                    "delivery_cost_override",
                    "payment_method",
                    "manual_payment_method_id",
                    "promocode",
                    "note",
                    "currency",
                    "items_total",
                    "discount",
                    "delivery_cost",
                    "total",
                    "issues",
                    "created_at",
                    "updated_at"
                ]
            },
            "Event": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID события; доставки передают его как webhook-id. События хранятся 30 дней."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "order.created",
                            "order.updated",
                            "order.status_changed",
                            "order.paid",
                            "order.cancelled",
                            "payment.created",
                            "payment.succeeded",
                            "payment.status_changed",
                            "payment.updated",
                            "refund.created",
                            "refund.completed",
                            "refund.status_changed",
                            "refund.updated",
                            "fiscal_document.created",
                            "fiscal_document.updated",
                            "fiscal_document.issued",
                            "fiscal_document.failed",
                            "fiscal_document.annulled",
                            "tax_period.status_changed",
                            "money_transaction.created",
                            "money_transaction.updated",
                            "money_transaction.deleted",
                            "pos_shift.opened",
                            "pos_shift.closed",
                            "pos_shift.updated",
                            "pos_cash_movement.created",
                            "gift_card.created",
                            "gift_card.updated",
                            "gift_card_transaction.created",
                            "customer_account.created",
                            "customer_account.updated",
                            "customer_account_entry.created",
                            "customer_account_entry.updated",
                            "supplier.created",
                            "supplier.updated",
                            "supplier.deleted",
                            "supplier_bill.created",
                            "supplier_bill.updated",
                            "supplier_bill.posted",
                            "supplier_bill.voided",
                            "supplier_bill.deleted",
                            "supplier_bill_payment.created",
                            "supplier_bill_payment.updated",
                            "supplier_bill_payment.deleted",
                            "settlement_agreement.created",
                            "settlement_agreement.updated",
                            "settlement_agreement.deleted",
                            "settlement_offset.created",
                            "settlement_offset.updated",
                            "settlement_offset.voided",
                            "purchase_order.created",
                            "purchase_order.updated",
                            "purchase_order.status_changed",
                            "purchase_order.deleted",
                            "goods_receipt.created",
                            "goods_receipt.updated",
                            "goods_receipt.voided",
                            "supplier_return.created",
                            "supplier_return.updated",
                            "supplier_return.status_changed",
                            "supplier_return.deleted",
                            "consignment_settlement.created",
                            "consignment_settlement.updated",
                            "consignment_settlement.posted",
                            "consignment_settlement.voided",
                            "tax_withholding.created",
                            "tax_withholding.updated",
                            "tax_withholding.annulled",
                            "tax_withholding.deleted",
                            "product.created",
                            "product.updated",
                            "product.deleted",
                            "inventory_level.updated",
                            "stock_movement.created",
                            "stock_movement.updated",
                            "lot.created",
                            "lot.updated",
                            "lot.deleted",
                            "location_transfer.created",
                            "location_transfer.updated",
                            "stocktake.created",
                            "stocktake.status_changed",
                            "stocktake.updated",
                            "customer.created",
                            "customer.updated",
                            "customer.deleted",
                            "customer_group.created",
                            "customer_group.updated",
                            "customer_group.deleted",
                            "price_list.created",
                            "price_list.updated",
                            "price_list.deleted",
                            "bulk_operation.finished"
                        ],
                        "description": "Тип события: order.created, order.updated, order.status_changed, order.paid, order.cancelled; payment.created, payment.succeeded, payment.status_changed, payment.updated; refund.created, refund.completed, refund.status_changed, refund.updated; product.created, product.updated, product.deleted; inventory_level.updated; customer.created, customer.updated, customer.deleted; fiscal_document.created, fiscal_document.updated, fiscal_document.issued, fiscal_document.failed, fiscal_document.annulled; tax_period.status_changed; bulk_operation.finished."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда произошло изменение."
                    },
                    "actor": {
                        "type": "object",
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "integration_app",
                                    "operator",
                                    "customer",
                                    "courier",
                                    "device",
                                    "supplier",
                                    "system"
                                ],
                                "description": "integration_app — приложение (actor.id — его id из /v1/me); operator — сотрудник; customer — покупатель; courier — курьер; device — касса или другое устройство магазина; supplier — поставщик; system — автоматика."
                            },
                            "id": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "ID автора среди записей его вида; null у system."
                            }
                        },
                        "required": [
                            "type",
                            "id"
                        ],
                        "description": "Кто сделал изменение."
                    },
                    "request_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID запроса этого приложения, которым сделано изменение (X-Request-Id): по нему приложение узнаёт свои изменения. null, если изменение сделало не оно."
                    },
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer",
                                "description": "ID записи."
                            },
                            "object": {
                                "anyOf": [
                                    {
                                        "$ref": "#/components/schemas/Order"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Payment"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Refund"
                                    },
                                    {
                                        "$ref": "#/components/schemas/FiscalDocument"
                                    },
                                    {
                                        "$ref": "#/components/schemas/TaxPeriod"
                                    },
                                    {
                                        "$ref": "#/components/schemas/TaxWithholding"
                                    },
                                    {
                                        "$ref": "#/components/schemas/MoneyTransaction"
                                    },
                                    {
                                        "$ref": "#/components/schemas/PosShift"
                                    },
                                    {
                                        "$ref": "#/components/schemas/PosCashMovement"
                                    },
                                    {
                                        "$ref": "#/components/schemas/GiftCard"
                                    },
                                    {
                                        "$ref": "#/components/schemas/GiftCardTransaction"
                                    },
                                    {
                                        "$ref": "#/components/schemas/CustomerAccount"
                                    },
                                    {
                                        "$ref": "#/components/schemas/CustomerAccountEntry"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Supplier"
                                    },
                                    {
                                        "$ref": "#/components/schemas/SupplierBill"
                                    },
                                    {
                                        "$ref": "#/components/schemas/SupplierBillPayment"
                                    },
                                    {
                                        "$ref": "#/components/schemas/SettlementAgreement"
                                    },
                                    {
                                        "$ref": "#/components/schemas/SettlementOffset"
                                    },
                                    {
                                        "$ref": "#/components/schemas/PurchaseOrder"
                                    },
                                    {
                                        "$ref": "#/components/schemas/GoodsReceipt"
                                    },
                                    {
                                        "$ref": "#/components/schemas/SupplierReturn"
                                    },
                                    {
                                        "$ref": "#/components/schemas/ConsignmentSettlement"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Product"
                                    },
                                    {
                                        "$ref": "#/components/schemas/InventoryLevel"
                                    },
                                    {
                                        "$ref": "#/components/schemas/StockMovement"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Lot"
                                    },
                                    {
                                        "$ref": "#/components/schemas/LocationTransfer"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Stocktake"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Customer"
                                    },
                                    {
                                        "$ref": "#/components/schemas/CustomerGroup"
                                    },
                                    {
                                        "$ref": "#/components/schemas/PriceList"
                                    },
                                    {
                                        "$ref": "#/components/schemas/BulkOperation"
                                    },
                                    {
                                        "type": "null"
                                    }
                                ],
                                "x-open-variants": true,
                                "description": "Запись сейчас: тот же объект, что отдаёт чтение этой записи в /v1, с полями по scopes приложения. null, если записи уже нет. События приходят не по порядку: свежесть показывает version объекта."
                            },
                            "previous_attributes": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "status": {
                                        "type": "string",
                                        "description": "Прежний статус: заказа у order.status_changed, налогового периода у tax_period.status_changed, документа у fiscal_document.failed."
                                    }
                                },
                                "required": [
                                    "status"
                                ],
                                "description": "Прежние значения полей, о смене которых событие; null, если таких нет."
                            }
                        },
                        "required": [
                            "id",
                            "object",
                            "previous_attributes"
                        ],
                        "description": "О чём событие."
                    }
                },
                "required": [
                    "id",
                    "type",
                    "created_at",
                    "actor",
                    "request_id",
                    "data"
                ]
            },
            "ExchangeRate": {
                "type": "object",
                "properties": {
                    "currency": {
                        "type": "string",
                        "description": "Валюта курса — код ISO 4217 или актива (USDT): 1 единица этой валюты = rate единиц валюты магазина."
                    },
                    "store_currency": {
                        "type": "string",
                        "description": "Валюта магазина, код ISO 4217."
                    },
                    "date": {
                        "type": "string",
                        "description": "Учётная дата запроса, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Курс дня учёта десятичной строкой: 1 currency = rate валюты магазина — им журнал денег пересчитывает движения по счёту в этой валюте на эту дату. null — курс дня ещё не зафиксирован (его фиксирует первая валютная операция дня) или пару не котирует ни один источник. У валюты магазина — \"1\"."
                    },
                    "rate_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "День, которым курс зафиксирован: на дату без своего курса журнал берёт ближайший прошлый, на дату раньше первой фиксации — первый. null — курса нет."
                    },
                    "source": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "coingecko",
                            "criptoya_p2p",
                            "ar_oficial",
                            "ar_blue",
                            "ar_mep",
                            "ar_ccl",
                            "ar_mayorista",
                            "cbr",
                            null
                        ],
                        "description": "Источник рыночного курса из правила магазина: coingecko, criptoya_p2p, ar_oficial, ar_blue, ar_mep, ar_ccl, ar_mayorista, cbr. null — пару не котирует ни один источник (магазин принимает её только по ручному курсу) или это валюта магазина."
                    }
                },
                "required": [
                    "currency",
                    "store_currency",
                    "date",
                    "rate",
                    "rate_date",
                    "source"
                ]
            },
            "FiscalDocument": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "invoice",
                            "credit_note",
                            "debit_note"
                        ],
                        "description": "invoice — фактура продажи; credit_note — кредит-нота: возврат, уменьшение заказа или аннулирование фактуры; debit_note — дебет-нота: увеличение заказа после фактуры."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "issued",
                            "rejected",
                            "failed",
                            "voided"
                        ],
                        "description": "issued — авторизован налоговой; pending — ждёт выпуска; failed — сбой выпуска, повторяется сам; rejected — отказ налоговой, нужна правка данных; voided — выпуск отменён вместе с продажей, юридического следа нет."
                    },
                    "status_reason": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Почему документ в этом статусе — отказ налоговой, сбой или отмена — по языкам магазина; null у выпущенного и ожидающего."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID юрлица-эмитента; null — документ до разделения продаж по юрлицам, его эмитент — юрлицо по умолчанию."
                    },
                    "order_id": {
                        "type": "integer",
                        "description": "ID заказа."
                    },
                    "refund_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID возврата, который документирует кредит-нота; null у остальных документов."
                    },
                    "related_document_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID фактуры, которую корректирует нота; null у фактуры."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Номер, как он напечатан в документе, например 0004-00000013; null, пока документ не выпущен."
                    },
                    "issued_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Учётная дата документа, YYYY-MM-DD в часовом поясе магазина: по ней документ попадает в налоговый период. null, пока документ не выпущен."
                    },
                    "issued_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда налоговая авторизовала документ; null, пока не выпущен."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "total": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Сумма документа с налогом; null у документов, созданных до того, как магазин стал хранить сумму."
                    },
                    "tax_lines": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "$ref": "#/components/schemas/TaxLine"
                        },
                        "description": "Налог, авторизованный налоговой, — юридически значимый: его определяет режим юрлица-эмитента, и он может не совпадать с налогом заказа. null, если документ не выпущен, налог не выделяет (фактура C монотрибутиста) или разбивку не восстановить."
                    },
                    "annulment": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "annulled_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "Когда фактура снята."
                            },
                            "document_id": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "ID аннулирующей кредит-ноты."
                            },
                            "reason": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "order_cancelled",
                                    "advance_applied",
                                    "manual",
                                    null
                                ],
                                "description": "Почему снята: order_cancelled — продажу отменили; advance_applied — аванс брони зачтён в чек, его документирует фактура чека; manual — решение человека или приложения, причина словами — в comment. null, если аннулирующую ноту не найти."
                            },
                            "comment": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Причина словами того, кто снял фактуру, у manual; null у снятия системой."
                            }
                        },
                        "required": [
                            "annulled_at",
                            "document_id",
                            "reason",
                            "comment"
                        ],
                        "description": "Фактура снята аннулирующей нотой: в налоговой она осталась, но для продажи больше не действует. null, если не снята."
                    },
                    "dismissal": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "dismissed_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "Когда документ снят с контроля."
                            },
                            "reason": {
                                "type": "string",
                                "description": "Причина словами того, кто снял."
                            }
                        },
                        "required": [
                            "dismissed_at",
                            "reason"
                        ],
                        "description": "Документ снят с контроля: налоговая его отклонила (или не приняла информирование под CAEA), и выпускать его не будут. Статус документа не меняется. null, если не снимали."
                    },
                    "receptor": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id_type": {
                                "type": "string",
                                "enum": [
                                    "tax_id",
                                    "personal_id",
                                    "national_id",
                                    "passport",
                                    "none"
                                ],
                                "description": "Вид идентификатора: tax_id — налоговый номер организации (CUIT в Аргентине); personal_id — налоговый номер физлица (CUIL); national_id — удостоверение личности (DNI); passport — паспорт; none — без идентификатора."
                            },
                            "id_number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Номер идентификатора; null, когда id_type — none."
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Наименование или полное имя для документа; null, если не задано."
                            },
                            "tax_status": {
                                "type": "string",
                                "enum": [
                                    "registered",
                                    "small_taxpayer",
                                    "exempt",
                                    "final_consumer",
                                    "not_categorized",
                                    "foreign"
                                ],
                                "description": "Налоговый статус: registered — плательщик НДС (Responsable Inscripto в Аргентине); small_taxpayer — упрощённый режим (Monotributo); exempt — освобождён от НДС; final_consumer — конечный потребитель; not_categorized — без категории; foreign — иностранный покупатель."
                            },
                            "address": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Фискальный адрес одной строкой; null, если не задан."
                            }
                        },
                        "required": [
                            "id_type",
                            "id_number",
                            "name",
                            "tax_status",
                            "address"
                        ],
                        "description": "Кому выписан документ; null — розничная продажа без реквизитов. Только со scope customers:read."
                    },
                    "ar": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "document_type_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Код типа comprobante ARCA: 001 — фактура A, 006 — фактура B, 011 — фактура C; 003, 008, 013 — кредит-ноты A, B, C."
                            },
                            "point_of_sale": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "Точка продаж (punto de venta)."
                            },
                            "sequence_number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Порядковый номер документа в точке продаж, 8 цифр."
                            },
                            "authorization_kind": {
                                "type": "string",
                                "enum": [
                                    "CAE",
                                    "CAEA"
                                ],
                                "description": "CAE — код выдан при выпуске онлайн; CAEA — заранее выданный код, выпуск в контингенции."
                            },
                            "authorization_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Код авторизации: CAE или CAEA."
                            },
                            "authorization_expires_on": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date",
                                "description": "Срок действия кода авторизации, YYYY-MM-DD; null, если неизвестен."
                            },
                            "testing": {
                                "type": "boolean",
                                "description": "true — выпущен тестовой средой ARCA (homologación): юридической силы нет, проводить как продажу нельзя."
                            }
                        },
                        "required": [
                            "document_type_code",
                            "point_of_sale",
                            "sequence_number",
                            "authorization_kind",
                            "authorization_code",
                            "authorization_expires_on",
                            "testing"
                        ],
                        "description": "Реквизиты ARCA; null у магазина другой страны, у невыпущенного документа и если реквизиты не восстановить из сохранённого провайдером."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "type",
                    "status",
                    "status_reason",
                    "legal_entity_id",
                    "order_id",
                    "refund_id",
                    "related_document_id",
                    "number",
                    "issued_on",
                    "issued_at",
                    "currency",
                    "total",
                    "tax_lines",
                    "annulment",
                    "dismissal",
                    "ar",
                    "created_at",
                    "updated_at"
                ]
            },
            "ForbiddenProblem": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "description": "Машинный тип отказа: стабильный код для ветвления, например insufficient_scope. У каждого типа есть страница в каталоге ошибок."
                    },
                    "title": {
                        "type": "string",
                        "description": "Краткое описание отказа на языке запроса."
                    },
                    "status": {
                        "type": "integer",
                        "description": "HTTP-статус ответа."
                    },
                    "detail": {
                        "type": "string",
                        "description": "Объяснение этого случая на языке запроса."
                    },
                    "required_scope": {
                        "type": "string",
                        "description": "У insufficient_scope — scope, который нужен методу."
                    },
                    "accepted_scopes": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "У insufficient_scope — scopes, которые метод принимает: хватит любого. У метода с одним scope — он один."
                    }
                },
                "required": [
                    "type",
                    "title",
                    "status"
                ]
            },
            "GiftCard": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "last4": {
                        "type": "string",
                        "description": "Последние четыре символа кода карты — по ним её узнают в руках покупателя. Сам код не хранится."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "active",
                            "pending_payment",
                            "disabled",
                            "deactivated"
                        ],
                        "description": "Состояние: active — принимается к оплате, пока есть остаток и не истёк срок; pending_payment — продана безналичным способом, оплата ещё не подтверждена; disabled — заблокирована (утеряна, спор), долг сохраняется; deactivated — аннулирована, остаток погашен."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "initial_amount": {
                        "type": "integer",
                        "description": "Номинал при выпуске, в минимальных единицах валюты."
                    },
                    "balance": {
                        "type": "integer",
                        "description": "Остаток на карте в минимальных единицах валюты — сумма строк её журнала (/v1/gift-card-transactions)."
                    },
                    "outstanding": {
                        "type": "integer",
                        "description": "Долг магазина по карте: остаток, кроме неоплаченной карты (pending_payment) — за неё денег не поступало. Заблокированная и истёкшая карта долг сохраняют."
                    },
                    "expires_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Конец срока действия; null — бессрочная. Истёкшая карта к оплате не принимается."
                    },
                    "issued_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда карта выпущена."
                    },
                    "issued_order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID заказа (/v1/orders), которым карту продали; null — выпуск без продажи (компенсация, промо)."
                    },
                    "reissued_from_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID карты, с которой перевыпуском перенесён остаток; null у обычного выпуска."
                    },
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID покупателя-владельца (/v1/customers); null — карта на предъявителя. Только с доступом к покупателям."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка сотрудника при выпуске; null, если её нет."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "last4",
                    "status",
                    "currency",
                    "initial_amount",
                    "balance",
                    "outstanding",
                    "expires_at",
                    "issued_at",
                    "issued_order_id",
                    "reissued_from_id",
                    "note",
                    "created_at",
                    "updated_at"
                ]
            },
            "GiftCardTransaction": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "gift_card_id": {
                        "type": "integer",
                        "description": "ID подарочной карты (/v1/gift-cards)."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "issue",
                            "redeem",
                            "refund",
                            "adjust",
                            "void",
                            "block",
                            "unblock",
                            "transfer_out",
                            "transfer_in"
                        ],
                        "description": "Вид строки: issue — выпуск; redeem — оплата картой; refund — возврат покупки на карту; adjust — ручная корректировка; void — аннулирование (карту вернули или не оплатили); block и unblock — блокировка и её снятие, без суммы; transfer_out и transfer_in — перенос остатка перевыпуском со старой карты на новую."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Сумма со знаком в минимальных единицах валюты: плюс — долг вырос, минус — уменьшился, 0 — блокировка и её снятие."
                    },
                    "balance_after": {
                        "type": "integer",
                        "description": "Остаток карты после этой строки."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID заказа."
                    },
                    "payment_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID платежа (/v1/payments): оплата картой способом gift_card или оплата продажи карты; null, если платежа нет."
                    },
                    "refund_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID возврата (/v1/refunds), вернувшего деньги на карту или за саму карту; null, если возврата нет."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Причина корректировки или заметка сотрудника; null, если её нет."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    }
                },
                "required": [
                    "id",
                    "gift_card_id",
                    "type",
                    "amount",
                    "balance_after",
                    "currency",
                    "order_id",
                    "payment_id",
                    "refund_id",
                    "note",
                    "created_at"
                ]
            },
            "GoodsReceipt": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Номер приёмки; null у приёмки, заведённой до нумерации."
                    },
                    "supplier_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID поставщика (/v1/suppliers); null у приёмки без поставщика."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID точки, куда принят товар (/v1/locations)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID юрлица магазина-покупателя (/v1/legal-entities): его налоговый режим решает, зачитывается ли налог закупки; null у старых приёмок."
                    },
                    "purchase_order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID заказа поставщику, по которому принимали (/v1/purchase-orders); null — приёмка без заказа."
                    },
                    "received_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда товар принят."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта приёмки, ISO 4217: в ней цены накладной, суммы строк и итоги."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Курс валюты приёмки к валюте магазина десятичной строкой, снимок на приёмке; null у приёмки без снимка курса."
                    },
                    "settlement_mode": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "on_receipt",
                            "on_sale",
                            null
                        ],
                        "description": "Как магазин рассчитывается за поставку: on_receipt — за принятое; on_sale — по факту продажи, актом реализации; null у старых приёмок."
                    },
                    "supplier_document": {
                        "type": "object",
                        "properties": {
                            "type_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Код типа документа у налогового провайдера страны магазина (в Аргентине — код comprobante ARCA); null — документа нет."
                            },
                            "number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Номер накладной; null, если не указан."
                            },
                            "date": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Дата накладной, YYYY-MM-DD; null, если не указана."
                            }
                        },
                        "required": [
                            "type_code",
                            "number",
                            "date"
                        ],
                        "description": "Накладная поставщика, как её подтвердил сотрудник."
                    },
                    "prices_include_tax": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "true — цены строк с налогом; false — без налога; null — база цен не указана."
                    },
                    "input_tax_treatment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "recoverable",
                            "cost",
                            null
                        ],
                        "description": "Куда ушёл налог в цене закупки: recoverable — зачитывается, себестоимость без налога; cost — зачесть некуда, налог в себестоимости; null — себестоимость как введена."
                    },
                    "lines_subtotal": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "На сколько принято: сумма line_total строк в валюте приёмки; null — цен в документе нет."
                    },
                    "payable_total": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Причитается поставщику в валюте приёмки; null — сумма неизвестна."
                    },
                    "voided_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда приёмку сторнировали: товар снят с остатка, долг по поставке аннулирован; null у действующей."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка сотрудника; null, если её нет."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID записи, уникальный среди записей своего вида в магазине."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID варианта товара (/v1/variants)."
                                },
                                "lot_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID партии строки (/v1/lots); null — товар без партий."
                                },
                                "purchase_order_line_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID строки заказа поставщику (lines[].id заказа), против которой принята строка; null без заказа."
                                },
                                "added_by_correction_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID корректировки (corrections[].id), которая добавила строку; null у строки из проведения."
                                },
                                "supplier_description": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Наименование позиции, как в накладной; null, если не записано."
                                },
                                "supplier_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Количество, как в накладной, в единице supplier_unit, десятичной строкой; null, если не записано."
                                },
                                "supplier_unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Единица накладной, как в документе: «кг», «15 кг», «шт»; null, если не указана."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Базовая единица quantity и cost_per_quantity: pcs — штуки, g — граммы, ml — миллилитры."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Принято на склад, десятичной строкой в базовой единице."
                                },
                                "unit_cost": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Цена накладной в валюте приёмки за cost_per_quantity; null — цена не указана."
                                },
                                "cost_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "За какое количество в базовой единице указана цена: \"1000\" у весового товара — за килограмм."
                                },
                                "line_total": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Сумма строки в валюте приёмки: цена на количество накладной; null без цены или количества накладной."
                                },
                                "store_unit_cost_micro": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Цена строки в валюте магазина по курсу приёмки за cost_per_quantity, в миллионных долях минорной единицы; null без цены."
                                },
                                "tax_rate_bps": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Ставка налога, по которой считалась себестоимость, в базисных пунктах; null — трактовки налога не было."
                                },
                                "landed_unit_cost_micro": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Себестоимость после трактовки налога, которую строка выставила в карточку позиции: валюта магазина, за cost_per_quantity, в миллионных долях минорной единицы; null без цены."
                                }
                            },
                            "required": [
                                "id",
                                "variant_id",
                                "lot_id",
                                "purchase_order_line_id",
                                "added_by_correction_id",
                                "supplier_description",
                                "supplier_quantity",
                                "supplier_unit",
                                "unit",
                                "quantity",
                                "unit_cost",
                                "cost_per_quantity",
                                "line_total",
                                "store_unit_cost_micro",
                                "tax_rate_bps",
                                "landed_unit_cost_micro"
                            ]
                        },
                        "description": "Строки приёмки; значения — после корректировок."
                    },
                    "corrections": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID записи, уникальный среди записей своего вида в магазине."
                                },
                                "number": {
                                    "type": "string",
                                    "description": "Номер корректировки."
                                },
                                "reason": {
                                    "type": "string",
                                    "description": "Почему исправили, словами сотрудника."
                                },
                                "subtotal_before": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "lines_subtotal до корректировки; null — цен не было."
                                },
                                "subtotal_after": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "lines_subtotal после корректировки; null — цен нет."
                                },
                                "consumed_variance": {
                                    "type": "integer",
                                    "description": "Разница цены по уже ушедшему со склада, в валюте магазина: она легла в себестоимость проданного."
                                },
                                "lines": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "goods_receipt_line_id": {
                                                "type": "integer",
                                                "description": "ID строки приёмки (lines[].id)."
                                            },
                                            "quantity_before": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Принято до корректировки, в базовой единице."
                                            },
                                            "quantity_after": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Принято после корректировки, в базовой единице."
                                            },
                                            "supplier_quantity_before": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Количество накладной до корректировки; null, если не было."
                                            },
                                            "supplier_quantity_after": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Количество накладной после корректировки; null, если нет."
                                            },
                                            "unit_cost_before": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "Цена накладной до корректировки; null — цены не было."
                                            },
                                            "unit_cost_after": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "Цена накладной после корректировки; null — цены нет."
                                            },
                                            "store_unit_cost_before_micro": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "Цена в валюте магазина до корректировки, в миллионных долях минорной единицы."
                                            },
                                            "store_unit_cost_after_micro": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "Цена в валюте магазина после корректировки, в миллионных долях минорной единицы."
                                            },
                                            "consumed_quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Сколько из принятого по строке уже ушло со склада к моменту корректировки."
                                            },
                                            "consumed_variance": {
                                                "type": "integer",
                                                "description": "Разница цены по ушедшему со склада, в валюте магазина."
                                            }
                                        },
                                        "required": [
                                            "goods_receipt_line_id",
                                            "quantity_before",
                                            "quantity_after",
                                            "supplier_quantity_before",
                                            "supplier_quantity_after",
                                            "unit_cost_before",
                                            "unit_cost_after",
                                            "store_unit_cost_before_micro",
                                            "store_unit_cost_after_micro",
                                            "consumed_quantity",
                                            "consumed_variance"
                                        ]
                                    },
                                    "description": "Исправленные строки: было и стало."
                                },
                                "created_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "Когда корректировку провели."
                                }
                            },
                            "required": [
                                "id",
                                "number",
                                "reason",
                                "subtotal_before",
                                "subtotal_after",
                                "consumed_variance",
                                "lines",
                                "created_at"
                            ]
                        },
                        "description": "Корректировки проведённой приёмки по порядку: что исправили и почему."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "supplier_id",
                    "location_id",
                    "legal_entity_id",
                    "purchase_order_id",
                    "received_at",
                    "currency",
                    "exchange_rate",
                    "settlement_mode",
                    "supplier_document",
                    "prices_include_tax",
                    "input_tax_treatment",
                    "lines_subtotal",
                    "payable_total",
                    "voided_at",
                    "note",
                    "lines",
                    "corrections",
                    "created_at",
                    "updated_at"
                ]
            },
            "InventoryChange": {
                "type": "object",
                "properties": {
                    "status": {
                        "type": "string",
                        "enum": [
                            "applied",
                            "unchanged",
                            "pending_approval"
                        ],
                        "description": "Исход записи: applied — остаток изменился; unchanged — остаток уже был таким; pending_approval — списание ждёт подтверждения в магазине: on_hand ещё прежний, а available уже без удержанного количества."
                    },
                    "inventory_level": {
                        "$ref": "#/components/schemas/InventoryLevel",
                        "description": "Уровень остатка пары после записи."
                    }
                },
                "required": [
                    "status",
                    "inventory_level"
                ]
            },
            "InventoryLevel": {
                "type": "object",
                "properties": {
                    "variant_id": {
                        "type": "integer",
                        "description": "ID варианта. Вместе с location_id определяет уровень остатка; у пары, которой нет в списке, остаток нулевой."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID точки магазина."
                    },
                    "on_hand": {
                        "type": "string",
                        "description": "Физический остаток точки по всем её ячейкам, десятичной строкой в единице варианта. Установка остатка называет и сверяет именно его."
                    },
                    "reserved": {
                        "type": "string",
                        "description": "Количество, зарезервированное под заказы, десятичной строкой в единице варианта."
                    },
                    "available": {
                        "type": "string",
                        "description": "Сколько можно продать: остаток, доступный к отбору, минус резерв, десятичной строкой. Отрицательный, если продано больше, чем было."
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда остаток менялся последний раз; null, если по паре ещё не было движений."
                    }
                },
                "required": [
                    "variant_id",
                    "location_id",
                    "on_hand",
                    "reserved",
                    "available",
                    "updated_at"
                ]
            },
            "LegalEntity": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "name": {
                        "type": "string",
                        "description": "Наименование юрлица, как в налоговой регистрации."
                    },
                    "tax_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Налоговый номер в стране магазина (CUIT в Аргентине, 11 цифр); null, если не задан."
                    },
                    "tax_status": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "registered",
                            "small_taxpayer",
                            "exempt",
                            null
                        ],
                        "description": "Налоговый статус: registered — плательщик НДС (Responsable Inscripto в Аргентине); small_taxpayer — упрощённый режим (Monotributo); exempt — освобождён от НДС. null, если не задан."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "Юрлицо по умолчанию: ему уходят продажи, не распределённые другим юрлицам, и документы без эмитента."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — юрлицо выключено: новых продаж не получает, его документы и периоды остаются."
                    },
                    "issues_fiscal_documents": {
                        "type": "boolean",
                        "description": "Выпускает ли юрлицо фискальные документы; false — его продажи идут без документа."
                    },
                    "ar": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "tax_condition": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "responsable_inscripto",
                                    "monotributo",
                                    "exento",
                                    null
                                ],
                                "description": "Condición frente al IVA: responsable_inscripto, monotributo или exento; null, если не задана."
                            },
                            "regime_category": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Категория Monotributo (A…K); null, если не задана."
                            },
                            "regime_activity_kind": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "services",
                                    "goods",
                                    null
                                ],
                                "description": "Вид деятельности монотрибутиста, от него зависит взнос: services — услуги, goods — продажа товаров; null, если не задан."
                            }
                        },
                        "required": [
                            "tax_condition",
                            "regime_category",
                            "regime_activity_kind"
                        ],
                        "description": "Специфика Аргентины; null у магазина другой страны."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "name",
                    "tax_id",
                    "tax_status",
                    "is_default",
                    "is_active",
                    "issues_fiscal_documents",
                    "ar",
                    "created_at",
                    "updated_at"
                ]
            },
            "Locale": {
                "type": "string",
                "enum": [
                    "ru",
                    "en",
                    "es"
                ]
            },
            "Location": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "address": {
                        "type": "string",
                        "description": "Адрес точки одной строкой."
                    },
                    "coordinates": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "lat": {
                                "type": "number",
                                "description": "Широта в градусах."
                            },
                            "lng": {
                                "type": "number",
                                "description": "Долгота в градусах."
                            }
                        },
                        "required": [
                            "lat",
                            "lng"
                        ],
                        "description": "Точка на карте; null, если не задана. Точка без координат не показывается на карте витрины."
                    },
                    "phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Телефон точки; null, если не задан."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false, если магазин выключил точку."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "Основная точка магазина: заказы с доставкой списывают остаток с неё, если другая точка не выбрана. У магазина она одна."
                    },
                    "is_pickup_point": {
                        "type": "boolean",
                        "description": "Покупатели могут забирать заказы в этой точке."
                    },
                    "is_stock_source": {
                        "type": "boolean",
                        "description": "Точка хранит товар: у неё есть остатки, она принимает поставки, проводит ревизии и перемещения."
                    },
                    "fulfills_online_orders": {
                        "type": "boolean",
                        "description": "Остаток точки продаётся покупателям онлайн. Значим только при is_stock_source = true: кухня хранит товар, но не продаёт его."
                    },
                    "price_list_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Прайс-лист точки: цены продаж в ней поверх базовых. null — точка продаёт по базовым ценам. Один лист может служить нескольким точкам."
                    },
                    "working_hours": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "array",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "from": {
                                        "type": "string",
                                        "description": "Начало интервала, ЧЧ:ММ."
                                    },
                                    "to": {
                                        "type": "string",
                                        "description": "Конец интервала, ЧЧ:ММ. Конец раньше начала значит, что интервал переходит через полночь."
                                    }
                                },
                                "required": [
                                    "from",
                                    "to"
                                ]
                            }
                        },
                        "description": "Часы работы: день недели (mon, tue, wed, thu, fri, sat, sun) → список интервалов в часовом поясе магазина. День без интервалов — выходной."
                    },
                    "temporarily_closed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда точка временно закрылась; null, если она работает."
                    },
                    "reopens_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Дата, когда временно закрытая точка откроется снова, в часовом поясе магазина; null, если точка работает или дата неизвестна."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "name",
                    "address",
                    "coordinates",
                    "phone",
                    "is_active",
                    "is_default",
                    "is_pickup_point",
                    "is_stock_source",
                    "fulfills_online_orders",
                    "price_list_id",
                    "working_hours",
                    "temporarily_closed_at",
                    "reopens_on",
                    "created_at",
                    "updated_at"
                ]
            },
            "LocationTransfer": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "number": {
                        "type": "string",
                        "description": "Номер акта в магазине."
                    },
                    "source_location_id": {
                        "type": "integer",
                        "description": "ID точки, с которой товар ушёл (/v1/locations)."
                    },
                    "destination_location_id": {
                        "type": "integer",
                        "description": "ID точки, на которую товар пришёл (/v1/locations)."
                    },
                    "origin": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "location_drain",
                            "reversal",
                            null
                        ],
                        "description": "Откуда акт, если его завёл не человек: location_drain — вывоз остатка при отключении точки; reversal — возврат проведённого акта. null — акт завёл сотрудник."
                    },
                    "reverses_location_transfer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID акта, который этот возвращает; null у обычного акта."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Комментарий сотрудника; null, если его нет."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID записи, уникальный среди записей своего вида в магазине."
                                },
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID варианта товара (/v1/variants)."
                                },
                                "lot_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID партии (/v1/lots); null — товар без партий."
                                },
                                "quantity": {
                                    "type": "string",
                                    "description": "Перемещённое количество, десятичной строкой в единице варианта."
                                }
                            },
                            "required": [
                                "id",
                                "variant_id",
                                "lot_id",
                                "quantity"
                            ]
                        },
                        "description": "Строки акта: что и сколько перемещено. Движения склада акта — расход на точке-источнике и приход на точке-получателе с document.type = location_transfer."
                    },
                    "executed_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Момент проведения акта."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "source_location_id",
                    "destination_location_id",
                    "origin",
                    "reverses_location_transfer_id",
                    "comment",
                    "lines",
                    "executed_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "Lot": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "variant_id": {
                        "type": "integer",
                        "description": "ID варианта товара (/v1/variants)."
                    },
                    "number": {
                        "type": "string",
                        "description": "Номер партии — с упаковки поставщика или присвоенный магазином; у варианта не повторяется."
                    },
                    "expires_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Годен до, учётной датой YYYY-MM-DD; null — без срока годности."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "available",
                            "hold",
                            "quarantine"
                        ],
                        "description": "Доступность: available — продаётся; hold — задержана; quarantine — карантин. Задержанная и карантинная партия остаётся на складе, но не продаётся и не собирается."
                    },
                    "received_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Момент, когда партия пришла на склад."
                    },
                    "document": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "goods_receipt",
                                    "production_order",
                                    "stocktake"
                                ],
                                "description": "Вид документа: goods_receipt — приёмка (/v1/goods-receipts); production_order — производственный акт; stocktake — инвентаризация, нашедшая товар."
                            },
                            "id": {
                                "type": "integer",
                                "description": "ID документа."
                            }
                        },
                        "required": [
                            "type",
                            "id"
                        ],
                        "description": "Документ, которым партия пришла; null — партия присвоена остатку без документа."
                    },
                    "merged_into_lot_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID партии, в которую эта слита: остаток и движения дальше идут по ней; null — партия самостоятельна."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "variant_id",
                    "number",
                    "expires_on",
                    "status",
                    "received_at",
                    "document",
                    "merged_into_lot_id",
                    "created_at",
                    "updated_at"
                ]
            },
            "ManualPaymentMethod": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "code": {
                        "type": "string",
                        "description": "Код записи, уникальный в магазине: не меняется при переименовании."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Название способа оплаты по языкам."
                    },
                    "settlement_currency": {
                        "type": "string",
                        "description": "Валюта, в которой поступают деньги способа, код ISO 4217."
                    },
                    "settles_on_receipt": {
                        "type": "boolean",
                        "description": "Покупатель платит при получении заказа, например переводом курьеру; false — до сборки заказа."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — покупатели не могут выбрать способ."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Позиция при сортировке: меньшая идёт первой."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда запись отправлена в архив; null у живой записи."
                    }
                },
                "required": [
                    "id",
                    "code",
                    "name",
                    "settlement_currency",
                    "settles_on_receipt",
                    "is_active",
                    "position",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "Me": {
                "type": "object",
                "properties": {
                    "app": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer",
                                "description": "ID приложения."
                            },
                            "name": {
                                "type": "string",
                                "description": "Название приложения, данное магазином."
                            },
                            "description": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Описание приложения; null, если магазин его не написал."
                            },
                            "scopes": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                },
                                "description": "Scopes приложения: что его токены могут читать и менять."
                            },
                            "allowed_ips": {
                                "type": [
                                    "array",
                                    "null"
                                ],
                                "items": {
                                    "type": "string"
                                },
                                "description": "IP-адреса и диапазоны CIDR, с которых приложению можно обращаться; null — с любого адреса."
                            },
                            "all_locations": {
                                "type": "boolean",
                                "description": "true, если приложение работает со всеми точками магазина, включая добавленные позже."
                            },
                            "location_ids": {
                                "type": [
                                    "array",
                                    "null"
                                ],
                                "items": {
                                    "type": "integer"
                                },
                                "description": "Точки, с которыми работает приложение, когда all_locations — false; null, если со всеми."
                            },
                            "created_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "Когда приложение создано."
                            }
                        },
                        "required": [
                            "id",
                            "name",
                            "description",
                            "scopes",
                            "allowed_ips",
                            "all_locations",
                            "location_ids",
                            "created_at"
                        ],
                        "description": "Приложение, которому принадлежит токен."
                    },
                    "token": {
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string",
                                "description": "Название токена, данное при выпуске."
                            },
                            "prefix": {
                                "type": "string",
                                "description": "Видимый префикс токена: различает токены, не раскрывая их."
                            },
                            "expires_at": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date-time",
                                "description": "Когда истекает срок токена; null, если срока нет."
                            }
                        },
                        "required": [
                            "name",
                            "prefix",
                            "expires_at"
                        ],
                        "description": "Токен этого запроса."
                    },
                    "store_id": {
                        "type": "integer",
                        "description": "ID магазина, которому принадлежит токен."
                    },
                    "rate_limits": {
                        "type": "object",
                        "properties": {
                            "app": {
                                "type": "object",
                                "properties": {
                                    "per_minute": {
                                        "type": "integer",
                                        "description": "Сколько запросов в минуту восполняет корзина."
                                    },
                                    "burst": {
                                        "type": "integer",
                                        "description": "Сколько запросов можно отправить подряд, прежде чем вступит поминутный темп."
                                    }
                                },
                                "required": [
                                    "per_minute",
                                    "burst"
                                ],
                                "description": "Корзина приложения, общая для всех его токенов."
                            },
                            "store": {
                                "type": "object",
                                "properties": {
                                    "per_minute": {
                                        "type": "integer",
                                        "description": "Сколько запросов в минуту восполняет корзина."
                                    },
                                    "burst": {
                                        "type": "integer",
                                        "description": "Сколько запросов можно отправить подряд, прежде чем вступит поминутный темп."
                                    }
                                },
                                "required": [
                                    "per_minute",
                                    "burst"
                                ],
                                "description": "Корзина магазина, общая для всех его приложений."
                            }
                        },
                        "required": [
                            "app",
                            "store"
                        ],
                        "description": "Лимиты запросов приложения."
                    }
                },
                "required": [
                    "app",
                    "token",
                    "store_id",
                    "rate_limits"
                ]
            },
            "MediaImport": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "app_id": {
                        "type": "integer",
                        "description": "ID приложения, попросившего загрузку."
                    },
                    "product_id": {
                        "type": "integer",
                        "description": "ID товара, в галерею которого идёт фото."
                    },
                    "url": {
                        "type": "string",
                        "description": "Адрес, с которого скачивается фото."
                    },
                    "position": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Место в галерее, с нуля; null — в конец."
                    },
                    "is_primary": {
                        "type": "boolean",
                        "description": "Фото станет главным."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "succeeded",
                            "failed"
                        ],
                        "description": "pending — ждёт или скачивается; succeeded — фото в галерее (media_id); failed — фото не добавлено (error)."
                    },
                    "media_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Фото в галерее — id в media товара; есть при status = succeeded."
                    },
                    "error": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "code": {
                                "type": "string",
                                "enum": [
                                    "invalid_url",
                                    "blocked_address",
                                    "unreachable",
                                    "too_large",
                                    "access_denied",
                                    "not_found",
                                    "rate_limited",
                                    "http_error",
                                    "not_an_image",
                                    "image_dimensions_exceeded",
                                    "media_quota_exceeded",
                                    "product_deleted",
                                    "processing_failed"
                                ],
                                "description": "invalid_url — адрес не http и не https; blocked_address — адрес ведёт в частную сеть; unreachable — сервер не ответил; too_large — файл больше допустимого; access_denied, not_found, rate_limited, http_error — сервер ответил ошибкой (source_status); not_an_image — файл не картинка; image_dimensions_exceeded — у картинки слишком много пикселей; media_quota_exceeded — медиатека магазина заполнена; product_deleted — товар отправлен в архив раньше, чем пришло фото; processing_failed — картинку не удалось обработать."
                            },
                            "message": {
                                "type": "string",
                                "description": "Причина словами, на языке запроса."
                            },
                            "source_status": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "HTTP-статус, которым ответил сервер фото, у access_denied, not_found, rate_limited и http_error; иначе null."
                            }
                        },
                        "required": [
                            "code",
                            "message",
                            "source_status"
                        ],
                        "description": "Почему фото не добавлено; есть при status = failed."
                    },
                    "attempts": {
                        "type": "integer",
                        "description": "Сколько раз загрузку брали в работу: сбои сети и источника повторяются."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    },
                    "finished_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда загрузка завершилась; null, пока она в pending."
                    }
                },
                "required": [
                    "id",
                    "app_id",
                    "product_id",
                    "url",
                    "position",
                    "is_primary",
                    "status",
                    "media_id",
                    "error",
                    "attempts",
                    "created_at",
                    "updated_at",
                    "finished_at"
                ]
            },
            "ModifierGroup": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "min_select": {
                        "type": "integer",
                        "description": "Сколько опций покупатель обязан выбрать: 0 — группа необязательна. Товар может задать своё правило (selection_rule)."
                    },
                    "max_select": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Сколько опций можно выбрать всего, с повторами; null — без предела."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — группа выключена: на товарах её не предлагают."
                    },
                    "adds_ingredients": {
                        "type": "boolean",
                        "description": "Меняют ли опции группы состав блюда; опция без своего состава при true делает состав позиции неизвестным (аллергены)."
                    },
                    "options": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID записи, уникальный среди записей своего вида в магазине."
                                },
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                                },
                                "name": {
                                    "type": "object",
                                    "additionalProperties": true,
                                    "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                                },
                                "price_delta": {
                                    "type": "integer",
                                    "description": "Надбавка к цене позиции за одну порцию опции, целым в минорных единицах валюты магазина; отрицательная — скидка. Товар может задать свою надбавку по варианту."
                                },
                                "max_quantity": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Сколько раз можно взять эту опцию в одной позиции; null — без своего предела, держит только max_select группы."
                                },
                                "duration_minutes": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "На сколько минут опция удлиняет услугу по записи, кратно 5; null — не удлиняет. У позиций других видов не действует."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false — опция выключена и не предлагается."
                                },
                                "is_default": {
                                    "type": "boolean",
                                    "description": "Опция выбрана заранее: витрина и касса отмечают её сразу, обязательную группу без выбора ею заполняет сервер."
                                },
                                "adds_ingredients": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "Меняет ли эта опция состав; null — как у группы (adds_ingredients)."
                                },
                                "recipe_per_variant": {
                                    "type": "boolean",
                                    "description": "Расход зависит от блюда: общего состава нет, закладку задаёт тех-карта каждого варианта (option_recipes); без неё на варианте опция не предлагается."
                                },
                                "nutrition": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "kcal": {
                                            "type": "integer",
                                            "description": "Энергия, ккал."
                                        },
                                        "protein_mg": {
                                            "type": "integer",
                                            "description": "Белки, мг."
                                        },
                                        "fat_mg": {
                                            "type": "integer",
                                            "description": "Жиры, мг."
                                        },
                                        "carbs_mg": {
                                            "type": "integer",
                                            "description": "Углеводы, мг."
                                        }
                                    },
                                    "required": [
                                        "kcal",
                                        "protein_mg",
                                        "fat_mg",
                                        "carbs_mg"
                                    ],
                                    "description": "Пищевая ценность одного применения опции, заявленная магазином: все четыре числа или null — тогда её считает состав опции."
                                },
                                "recipe": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "variant_id": {
                                                "type": "integer",
                                                "description": "ID варианта товара."
                                            },
                                            "quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Закладка компонента на одно применение опции, десятичной строкой в единице компонента; null — по вкусу: в составе, но не списывается."
                                            }
                                        },
                                        "required": [
                                            "variant_id",
                                            "quantity"
                                        ]
                                    },
                                    "description": "Общий состав опции — что она списывает в любом блюде: сырьё и заготовки с закладкой. У опции с расходом по блюду пуст. В записи — список целиком, пустой очищает; без поля состав не трогается."
                                }
                            },
                            "required": [
                                "id",
                                "external_id",
                                "name",
                                "price_delta",
                                "max_quantity",
                                "duration_minutes",
                                "is_active",
                                "is_default",
                                "adds_ingredients",
                                "recipe_per_variant",
                                "nutrition",
                                "recipe"
                            ]
                        },
                        "description": "Опции по порядку показа. В записи — набор целиком: строка находит опцию по id или external_id, у найденной пишутся пришедшие поля, строка без опции — новая и несёт name; опция, которой нет в наборе, уходит в архив и снимается из открытых черновиков заказов."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда запись отправлена в архив; null у живой записи."
                    }
                },
                "required": [
                    "id",
                    "external_id",
                    "version",
                    "name",
                    "min_select",
                    "max_select",
                    "is_active",
                    "adds_ingredients",
                    "options",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "MoneyAccount": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "name": {
                        "type": "string",
                        "description": "Название счёта, как его видит магазин."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "bank",
                            "cash",
                            "acquiring",
                            "ewallet",
                            "crypto",
                            "advance",
                            "transit",
                            "group_share"
                        ],
                        "description": "Вид счёта: bank — банк; cash — наличные; acquiring — эквайринг (платёжный провайдер); ewallet — электронный кошелёк; crypto — криптокошелёк; advance — подотчётные суммы точки; transit — деньги в пути (инкассация); group_share — доля в общем счёте группы магазинов: деньги лежат у держателя, остаток — расчёт с группой."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта счёта: код ISO 4217 или актива (USDT). Может отличаться от валюты магазина."
                    },
                    "balance": {
                        "type": "string",
                        "description": "Текущий остаток в валюте счёта, десятичной строкой, например \"12345.5\"."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID юрлица, которому принадлежит счёт; null — счёт магазина без юрлица."
                    },
                    "location_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID точки счёта; null — общий счёт магазина."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "Счёт по умолчанию для своей валюты."
                    },
                    "is_system": {
                        "type": "boolean",
                        "description": "Системный счёт кассы (advance, transit): движется только документами кассы."
                    },
                    "archived_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда счёт отправлен в архив: новых движений не принимает, история остаётся. null у действующего."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "name",
                    "type",
                    "currency",
                    "balance",
                    "legal_entity_id",
                    "location_id",
                    "is_default",
                    "is_system",
                    "archived_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "MoneyCategory": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID родительской статьи; null у статьи верхнего уровня."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "income",
                            "expense"
                        ],
                        "description": "income — статья приходов; expense — статья расходов."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "system_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "sales",
                            "tips",
                            "other_income",
                            "carrier_claims",
                            "supplier_refunds",
                            "financing_surcharge",
                            "cash_overage",
                            "exchange_gain",
                            "customer_refunds",
                            "cash_shortage",
                            "exchange_loss",
                            "goods_purchase",
                            "payroll",
                            "rent",
                            "utilities",
                            "marketplace_fees",
                            "acquiring_fees",
                            "bank_fees",
                            "taxes",
                            "logistics",
                            "advertising",
                            "other_expense",
                            null
                        ],
                        "description": "Код системной статьи — по нему опознают статью, а не по имени: sales — продажи, acquiring_fees — комиссии эквайринга, taxes — налоги, cash_shortage и cash_overage — недостача и излишек кассы и другие. null у статьи, заведённой магазином."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Позиция при сортировке: меньшая идёт первой."
                    },
                    "archived_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда статья отправлена в архив: новые движения в неё не проводятся. null у действующей."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "parent_id",
                    "kind",
                    "name",
                    "system_code",
                    "position",
                    "archived_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "MoneyTransaction": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "account_id": {
                        "type": "integer",
                        "description": "ID денежного счёта движения."
                    },
                    "direction": {
                        "type": "string",
                        "enum": [
                            "income",
                            "expense"
                        ],
                        "description": "income — приход на счёт; expense — расход со счёта."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Сумма проводки в минимальных единицах валюты магазина, всегда положительная: направление задаёт direction. У счёта в чужой валюте — пересчёт по курсу снимка."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "account_amount": {
                        "type": "string",
                        "description": "Сумма в валюте счёта, десятичной строкой."
                    },
                    "account_currency": {
                        "type": "string",
                        "description": "Валюта счёта: код ISO 4217 или актива (USDT)."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Курс снимка: 1 единица валюты счёта = exchange_rate единиц валюты магазина, десятичной строкой. null у счёта в валюте магазина."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Момент движения."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Учётная дата, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID статьи; null — перевод между счетами или движение без статьи."
                    },
                    "supplier_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID поставщика-контрагента; null, если его нет."
                    },
                    "transfer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Общий id ног перевода между счетами: у расхода с одного счёта и прихода на другой он один. null — не перевод."
                    },
                    "reverses_transaction_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID движения, которое это сторнирует; null у обычного движения."
                    },
                    "origin": {
                        "type": "string",
                        "enum": [
                            "manual",
                            "statement",
                            "sales",
                            "refunds",
                            "disputes",
                            "pos",
                            "suppliers",
                            "payroll",
                            "opening_balance",
                            "exchange_differences",
                            "group_stores"
                        ],
                        "description": "Класс источника: manual — внесено человеком; sales — продажи; refunds — возвраты; disputes — споры; pos — касса и сейф; suppliers — поставщики; payroll — зарплата; statement — выписка; opening_balance — начальный остаток; exchange_differences — курсовые разницы; group_stores — операции магазинов группы на общем счёте."
                    },
                    "source": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "payment",
                                    "payment_tip",
                                    "payment_tip_refund",
                                    "payment_surcharge",
                                    "payment_surcharge_refund",
                                    "payment_overpayment",
                                    "payment_change",
                                    "payment_change_counter",
                                    "payment_provider_fee",
                                    "payment_provider_fee_refund",
                                    "payment_withheld_tax",
                                    "payment_withheld_tax_refund",
                                    "refund",
                                    "dispute",
                                    "pos_shift",
                                    "pos_shift_drawer",
                                    "pos_cash_transfer",
                                    "pos_cash_transfer_counter",
                                    "pos_cash_shared_safe",
                                    "pos_cash_shared_safe_counter",
                                    "pos_cash_movement",
                                    "pos_drawer_movement",
                                    "pos_cash_advance_expense",
                                    "pos_cash_advance_expense_void",
                                    "pos_cash_bank_credit",
                                    "pos_cash_bank_credit_counter",
                                    "pos_cash_bank_credit_difference",
                                    "payroll_period",
                                    "purchase_order",
                                    "supplier_bill_payment",
                                    "supplier_return_refund",
                                    "statement_line",
                                    "opening_balance",
                                    "exchange_difference",
                                    "group_member_operation"
                                ],
                                "description": "Вид проводки. payment и payment_* — приход оплаты и её части (чаевые, надбавка, сдача, комиссия провайдера, удержанный налог); refund — выплата возврата; pos_* — документы кассы; supplier_bill_payment — оплата счёта поставщика; exchange_difference — курсовая разница."
                            },
                            "id": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "ID записи-источника: у payment и payment_* — ID платежа, у refund — ID из transactions[] возврата, у exchange_difference — ID движения-расхода; у остальных — внутренний ID."
                            }
                        },
                        "required": [
                            "type",
                            "id"
                        ],
                        "description": "Запись, которая провела движение; null — внесено вручную."
                    },
                    "document": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "order",
                                    "dispute",
                                    "pos_shift",
                                    "pos_safe",
                                    "purchase_order",
                                    "supplier_bill",
                                    "supplier_return",
                                    "payroll",
                                    "statement_import",
                                    "money_accounts"
                                ],
                                "description": "Вид документа: order — заказ; pos_shift — смена кассы; supplier_bill — счёт поставщика; purchase_order — заказ поставщику; supplier_return — возврат поставщику; dispute — спор; payroll — зарплатный период; pos_safe — сейф кассы; statement_import — импорт выписки; money_accounts — начальный остаток счёта."
                            },
                            "id": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "ID документа; null у реестров без своей записи: pos_safe, statement_import, money_accounts."
                            }
                        },
                        "required": [
                            "type",
                            "id"
                        ],
                        "description": "Первичный документ движения; null — внесено вручную или документ в учёте другого магазина группы."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Комментарий к движению, как его записал человек или документ; null, если его нет."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "account_id",
                    "direction",
                    "amount",
                    "currency",
                    "account_amount",
                    "account_currency",
                    "exchange_rate",
                    "occurred_at",
                    "occurred_on",
                    "category_id",
                    "supplier_id",
                    "transfer_id",
                    "reverses_transaction_id",
                    "origin",
                    "source",
                    "document",
                    "description",
                    "created_at",
                    "updated_at"
                ]
            },
            "MoneyTransactionDirection": {
                "type": "string",
                "enum": [
                    "income",
                    "expense"
                ]
            },
            "MoneyTransfer": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID перевода — transfer_id его частей в журнале движений (/v1/money-transactions)."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "from_account_id": {
                        "type": "integer",
                        "description": "ID денежного счёта, с которого списаны деньги."
                    },
                    "to_account_id": {
                        "type": "integer",
                        "description": "ID денежного счёта, на который зачислены деньги."
                    },
                    "from_amount": {
                        "type": "string",
                        "description": "Списано со счёта from_account_id в его валюте, десятичной строкой."
                    },
                    "from_currency": {
                        "type": "string",
                        "description": "Валюта счёта списания: код ISO 4217 или код криптовалюты."
                    },
                    "to_amount": {
                        "type": "string",
                        "description": "Зачислено на счёт to_account_id в его валюте, десятичной строкой. В одной валюте равно from_amount: разница — это комиссия fee."
                    },
                    "to_currency": {
                        "type": "string",
                        "description": "Валюта счёта зачисления."
                    },
                    "fee": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Комиссия перевода в валюте счёта списания, десятичной строкой — расход на системной статье bank_fees; null, если комиссии нет."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Стоимость перевода в минимальных единицах валюты магазина: её несут обе части. Курсовую разницу обмена валют журнал пишет отдельным движением."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Момент перевода."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Учётная дата перевода, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Описание перевода; null, если не задано."
                    },
                    "from_transaction_id": {
                        "type": "integer",
                        "description": "ID движения-расхода на счёте списания."
                    },
                    "to_transaction_id": {
                        "type": "integer",
                        "description": "ID движения-прихода на счёте зачисления."
                    },
                    "fee_transaction_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID движения комиссии; null, если комиссии нет."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "from_account_id",
                    "to_account_id",
                    "from_amount",
                    "from_currency",
                    "to_amount",
                    "to_currency",
                    "fee",
                    "amount",
                    "currency",
                    "occurred_at",
                    "occurred_on",
                    "description",
                    "from_transaction_id",
                    "to_transaction_id",
                    "fee_transaction_id",
                    "created_at"
                ]
            },
            "Order": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Номер заказа, который видят покупатель и сотрудники; null, пока номера ещё нет."
                    },
                    "channel": {
                        "type": "string",
                        "enum": [
                            "web",
                            "pos",
                            "marketplace",
                            "external",
                            "manual",
                            "subscription"
                        ],
                        "description": "Откуда пришёл заказ: web — витрина; pos — касса; marketplace — маркетплейс, например Mercado Libre; external — учётная система магазина; manual — черновик заказа сотрудника или приложения; subscription — день подписки на питание."
                    },
                    "app_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Приложение, оформившее заказ своим черновиком (/v1/draft-orders), — его id из /v1/me; null у заказов витрины, кассы и сотрудников."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "Точка, которая обслуживает заказ: пункт самовывоза или точка, с которой списывается остаток."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Юрлицо, на которое оформлена продажа (/v1/legal-entities); null — продажа не распределена между юрлицами, её юрлицо — юрлицо магазина по умолчанию."
                    },
                    "status": {
                        "type": "string",
                        "description": "Статус заказа: код из списка статусов магазина (/v1/order-statuses). Магазин может добавлять свои статусы; постоянный смысл даёт status_group."
                    },
                    "status_group": {
                        "type": "string",
                        "enum": [
                            "pos_open",
                            "placed",
                            "pending_payment",
                            "paid",
                            "confirmed",
                            "preparing",
                            "ready",
                            "ready_for_pickup",
                            "out_for_delivery",
                            "delivery_failed",
                            "delivered",
                            "completed",
                            "cancelled",
                            "refunded"
                        ],
                        "description": "Постоянный смысл статуса: pos_open — открытый счёт на кассе; placed — оформлен; pending_payment — ждёт оплаты; paid — оплачен; confirmed — принят магазином; preparing — готовится; ready — готов; ready_for_pickup — готов к выдаче; out_for_delivery — в пути; delivery_failed — доставка не удалась; delivered — доставлен; completed — завершён; cancelled — отменён; refunded — возвращён."
                    },
                    "payment_status": {
                        "type": "string",
                        "enum": [
                            "unpaid",
                            "partial",
                            "paid",
                            "partially_refunded",
                            "refunded"
                        ],
                        "description": "Оплата заказа: unpaid — не оплачен; partial — оплачен частично; paid — оплачен; partially_refunded — частично возвращён; refunded — возвращён."
                    },
                    "sale_type": {
                        "type": "string",
                        "enum": [
                            "retail",
                            "staff",
                            "wholesale"
                        ],
                        "description": "retail — продажа покупателю; staff — продажа сотруднику; wholesale — оптовая продажа."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "items_total": {
                        "type": "integer",
                        "description": "Сумма позиций до скидки заказа."
                    },
                    "discount": {
                        "type": "integer",
                        "description": "Скидка заказа на товары: сумма applied_discounts[].amount и items[].discount."
                    },
                    "applied_discounts": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "Строка журнала; на неё ссылается items[].discount_allocations[].applied_discount_id."
                                },
                                "source": {
                                    "type": "string",
                                    "enum": [
                                        "promocode",
                                        "automatic",
                                        "pick",
                                        "manual",
                                        "offline_capture",
                                        "loyalty_program",
                                        "external_pos"
                                    ],
                                    "description": "Как скидка попала в заказ: automatic — правило магазина; pick — правило, которое отметил кассир; promocode — промокод покупателя; manual — ручная скидка кассира; offline_capture — расхождение офлайн-продажи кассы с расчётом сервера, не решение продавца; loyalty_program — бонусная программа; external_pos — внешняя касса, которая провела продажу."
                                },
                                "kind": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "promo",
                                        "employee",
                                        "expiry",
                                        "payment_method",
                                        "markdown",
                                        "goodwill",
                                        "comp",
                                        "other",
                                        null
                                    ],
                                    "description": "За что скидка: promo — акция; employee — сотруднику; expiry — уценка по сроку годности; payment_method — за способ оплаты; markdown — уценка товара по состоянию; goodwill — навстречу покупателю; comp — за счёт заведения; other — иное. null — скидка внешней кассы, офлайн-расхождение или скидка до появления этой оси."
                                },
                                "name": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "additionalProperties": true,
                                    "description": "Имя правила или бонусной программы на момент продажи; null у промокода, ручной скидки, офлайн-расхождения и внешней кассы."
                                },
                                "code": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Промокод, который ввёл покупатель; null — скидка не по промокоду."
                                },
                                "reason": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Причина ручной скидки словами кассира; null у остальных."
                                },
                                "order_item_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Позиция, которую уценили отдельно; null — скидка на заказ, её доли по позициям — в items[].discount_allocations."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Сумма скидки."
                                }
                            },
                            "required": [
                                "id",
                                "source",
                                "kind",
                                "name",
                                "code",
                                "reason",
                                "order_item_id",
                                "amount"
                            ]
                        },
                        "description": "Состав скидки на товары — журнал применённых скидок. Строки переписываются при пересчёте заказа: id живёт до пересчёта."
                    },
                    "delivery_cost": {
                        "type": "integer",
                        "description": "Доставка к оплате — после скидки на доставку."
                    },
                    "delivery_discount": {
                        "type": "integer",
                        "description": "Снято с доставки скидкой: цена доставки до скидки — delivery_cost + delivery_discount."
                    },
                    "delivery_discounts": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "Строка журнала скидок доставки."
                                },
                                "source": {
                                    "type": "string",
                                    "enum": [
                                        "promocode",
                                        "automatic",
                                        "pick",
                                        "manual",
                                        "offline_capture",
                                        "loyalty_program",
                                        "external_pos"
                                    ],
                                    "description": "Как скидка попала в заказ — значения как у applied_discounts[].source."
                                },
                                "kind": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "promo",
                                        "employee",
                                        "expiry",
                                        "payment_method",
                                        "markdown",
                                        "goodwill",
                                        "comp",
                                        "other",
                                        null
                                    ],
                                    "description": "За что скидка — значения как у applied_discounts[].kind."
                                },
                                "name": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "additionalProperties": true,
                                    "description": "Имя правила на момент продажи; null — скидка по промокоду."
                                },
                                "code": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Промокод, который ввёл покупатель; null — скидка не по промокоду."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Сумма скидки на доставку."
                                }
                            },
                            "required": [
                                "id",
                                "source",
                                "kind",
                                "name",
                                "code",
                                "amount"
                            ]
                        },
                        "description": "Состав скидки на доставку: сумма amount равна delivery_discount."
                    },
                    "delivery_tax_lines": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "$ref": "#/components/schemas/TaxLine"
                        },
                        "description": "Налог доставки по классу магазина по умолчанию — её доля налога своей ставки в tax_lines; null — доставки к оплате нет или налог неизвестен."
                    },
                    "platform_discount": {
                        "type": "integer",
                        "description": "Скидка за счёт площадки-агрегатора: продажу магазина не уменьшает."
                    },
                    "platform_service_fee": {
                        "type": "integer",
                        "description": "Сервисный сбор площадки-агрегатора: входит в total, но не продажа магазина."
                    },
                    "platform_delivery_fee": {
                        "type": "integer",
                        "description": "Доставка, которую везёт площадка-агрегатор: входит в total, но не продажа магазина."
                    },
                    "total": {
                        "type": "integer",
                        "description": "Сумма заказа к оплате."
                    },
                    "tax_lines": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "$ref": "#/components/schemas/TaxLine"
                        },
                        "description": "Налог продажи по классификации товаров на момент продажи: облагаемая часть заказа (позиции, кроме продажи подарочных карт, визиты сверх оплаченного пакетом, доставка) по ставкам. По каждой ставке tax_lines позиций и delivery_tax_lines в сумме дают строку заказа. Юридически значимый налог — в фискальном документе: его определяет юрлицо-эмитент по своему налоговому статусу. null — у магазина нет налоговых классов или облагаемой части у заказа нет."
                    },
                    "gift_card_issue_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Номинал подарочной карты, которую продаёт заказ: обязательство магазина, не выручка; null, если заказ не продаёт карту."
                    },
                    "reservation_deposit_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Аванс брони стола или записи на услугу: предоплата, не выручка; null, если заказ не аванс."
                    },
                    "account_payment_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Погашение долга покупателя: деньги в счёт долга, не выручка; null, если заказ не погашение."
                    },
                    "service_package_issue_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Проданные в заказе пакеты визитов: обязательство магазина визитами, не выручка — выручкой становится визит, погашенный пакетом; null, если пакетов в заказе нет."
                    },
                    "payment_method": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "cash",
                            "mercadopago",
                            "crypto",
                            "bybit",
                            "trc20",
                            "balance",
                            "modo",
                            "payway",
                            "mercadopago_qr",
                            "mercadopago_point",
                            "mercadopago_transfer",
                            "gift_card",
                            "subscription",
                            "deposit",
                            "external",
                            "manual",
                            "offset",
                            "on_account",
                            "exchange_credit",
                            "bonpunto",
                            "service_package",
                            null
                        ],
                        "description": "Способ оплаты, выбранный при оформлении: manual — ручной способ магазина (manual_payment_method_id). Фактические оплаты — в /v1/payments. null, если способ не выбран."
                    },
                    "manual_payment_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Ручной способ оплаты магазина (/v1/manual-payment-methods), когда payment_method — manual; иначе null."
                    },
                    "delivery_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Способ доставки магазина (/v1/delivery-methods); null, если у заказа его нет, например у продажи на кассе."
                    },
                    "fulfilment_type": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "self_pickup",
                            "home_delivery",
                            "parcel_locker",
                            "mail_post",
                            "pos",
                            "aggregator",
                            "manual_courier",
                            null
                        ],
                        "description": "Как заказ доходит до покупателя — по способу доставки на момент заказа: self_pickup — самовывоз с точки; home_delivery — доставка по адресу; parcel_locker — постамат; mail_post — почта; pos — выдача на кассе; aggregator — доставка площадкой-агрегатором; manual_courier — курьер, которого магазин находит сам. null, если неизвестно."
                    },
                    "delivery_slots": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "from": {
                                    "type": "string",
                                    "description": "Начало окна."
                                },
                                "to": {
                                    "type": "string",
                                    "description": "Конец окна."
                                }
                            },
                            "required": [
                                "from",
                                "to"
                            ]
                        },
                        "description": "Окна доставки, выбранные покупателем, по возрастанию начала; пусто — без окна."
                    },
                    "shipment": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "carrier": {
                                "type": "string",
                                "enum": [
                                    "andreani",
                                    "correo_argentino",
                                    "uber_direct",
                                    "mercadolibre",
                                    "courier_service"
                                ],
                                "description": "Перевозчик — ключ модуля: andreani, correo_argentino, uber_direct, mercadolibre (Mercado Envíos); courier_service — служба без интеграции, номер вписал магазин (POST /v1/orders/{order}/shipment/tracking), служба — в carrier_name, статусов нет."
                            },
                            "carrier_name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Служба, как её назвал магазин, у номера, вписанного вручную; null — у перевозчика с интеграцией (его называет carrier) или магазин службу не назвал."
                            },
                            "tracking_number": {
                                "type": "string",
                                "description": "Номер отправления у перевозчика: по нему его ищут в кабинете перевозчика и отслеживают."
                            },
                            "tracking_url": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Страница отслеживания у перевозчика; null — перевозчик её не дал."
                            },
                            "status": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "accepted",
                                    "preparing",
                                    "courier_assigned",
                                    "picked_up",
                                    "in_transit",
                                    "arrived_at_branch",
                                    "out_for_delivery",
                                    "delivery_failed",
                                    "delivered",
                                    "not_delivered",
                                    "returned",
                                    "lost",
                                    "cancelled",
                                    "unknown",
                                    null
                                ],
                                "description": "Последний статус: accepted — принято, посылка у магазина; preparing — перевозчик готовит отправку; courier_assigned — курьер едет за посылкой; picked_up — курьер забрал; in_transit — в пути; arrived_at_branch — ждёт в отделении; out_for_delivery — у курьера на последней миле; delivery_failed — попытка вручения не удалась, перевозчик повторит; delivered — вручено; not_delivered — перевозчик окончательно не вручил; returned — возвращено отправителю; lost — потеряно; cancelled — отменено; unknown — статус перевозчика вне набора, его текст — в events[].description. null — статуса ещё нет. Поздний промежуточный статус не отменяет delivered, cancelled, returned и lost."
                            },
                            "status_at": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date-time",
                                "description": "Момент последнего статуса."
                            },
                            "events": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "enum": [
                                                "accepted",
                                                "preparing",
                                                "courier_assigned",
                                                "picked_up",
                                                "in_transit",
                                                "arrived_at_branch",
                                                "out_for_delivery",
                                                "delivery_failed",
                                                "delivered",
                                                "not_delivered",
                                                "returned",
                                                "lost",
                                                "cancelled",
                                                "unknown"
                                            ],
                                            "description": "Статус — значения как у shipment.status."
                                        },
                                        "description": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Статус словами перевозчика; null — перевозчик текста не дал."
                                        },
                                        "occurred_at": {
                                            "type": "string",
                                            "format": "date-time",
                                            "description": "Момент события у перевозчика."
                                        }
                                    },
                                    "required": [
                                        "status",
                                        "description",
                                        "occurred_at"
                                    ]
                                },
                                "description": "История статусов по времени события у перевозчика."
                            },
                            "label_available": {
                                "type": "boolean",
                                "description": "Наклейку можно скачать: файл у магазина или перевозчик выдаёт её по запросу."
                            }
                        },
                        "required": [
                            "carrier",
                            "carrier_name",
                            "tracking_number",
                            "tracking_url",
                            "status",
                            "status_at",
                            "events",
                            "label_available"
                        ],
                        "description": "Отправление у перевозчика или номер службы без интеграции, вписанный магазином; null — у заказа его нет. Наклейка — GET /v1/orders/{order}/shipment/label при label_available."
                    },
                    "previous_shipments": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "carrier": {
                                    "type": "string",
                                    "enum": [
                                        "andreani",
                                        "correo_argentino",
                                        "uber_direct",
                                        "mercadolibre",
                                        "courier_service"
                                    ],
                                    "description": "Перевозчик — значения как у shipment.carrier."
                                },
                                "carrier_name": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Служба у номера, вписанного вручную, — как у shipment.carrier_name."
                                },
                                "tracking_number": {
                                    "type": "string",
                                    "description": "Номер отправления у перевозчика."
                                },
                                "tracking_url": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Страница отслеживания у перевозчика; null — перевозчик её не дал."
                                },
                                "status": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "accepted",
                                        "preparing",
                                        "courier_assigned",
                                        "picked_up",
                                        "in_transit",
                                        "arrived_at_branch",
                                        "out_for_delivery",
                                        "delivery_failed",
                                        "delivered",
                                        "not_delivered",
                                        "returned",
                                        "lost",
                                        "cancelled",
                                        "unknown",
                                        null
                                    ],
                                    "description": "Последний статус — значения как у shipment.status."
                                },
                                "status_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Момент последнего статуса."
                                },
                                "events": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "status": {
                                                "type": "string",
                                                "enum": [
                                                    "accepted",
                                                    "preparing",
                                                    "courier_assigned",
                                                    "picked_up",
                                                    "in_transit",
                                                    "arrived_at_branch",
                                                    "out_for_delivery",
                                                    "delivery_failed",
                                                    "delivered",
                                                    "not_delivered",
                                                    "returned",
                                                    "lost",
                                                    "cancelled",
                                                    "unknown"
                                                ],
                                                "description": "Статус — значения как у shipment.status."
                                            },
                                            "description": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Статус словами перевозчика; null — перевозчик текста не дал."
                                            },
                                            "occurred_at": {
                                                "type": "string",
                                                "format": "date-time",
                                                "description": "Момент события у перевозчика."
                                            }
                                        },
                                        "required": [
                                            "status",
                                            "description",
                                            "occurred_at"
                                        ]
                                    },
                                    "description": "История статусов по времени события у перевозчика."
                                }
                            },
                            "required": [
                                "carrier",
                                "carrier_name",
                                "tracking_number",
                                "tracking_url",
                                "status",
                                "status_at",
                                "events"
                            ]
                        },
                        "description": "Отправления, заменённые перевыпуском (прежнее отменили и выпустили новое), от старых к новым; форма — как у shipment, без label_available."
                    },
                    "shipment_attempt": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "state": {
                                "type": "string",
                                "enum": [
                                    "queued",
                                    "in_progress",
                                    "outcome_unknown",
                                    "failed"
                                ],
                                "description": "queued — выпуск запрошен через API и ждёт очереди; in_progress — запрос к перевозчику идёт прямо сейчас; outcome_unknown — связь с перевозчиком оборвалась после запроса, и неизвестно, создано ли отправление: новый выпуск закрыт, пока магазин не сверится с перевозчиком в панели; failed — запрошенный выпуск не удался, отправления нет, причина — в error."
                            },
                            "started_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "Когда выпуск запрошен или начался."
                            },
                            "error": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "code": {
                                        "type": "string",
                                        "enum": [
                                            "no_carrier",
                                            "not_shippable",
                                            "awaits_bill_payment",
                                            "carrier_rejected",
                                            "shipment_data_invalid",
                                            "request_expired",
                                            "internal_error"
                                        ],
                                        "description": "Причина машинным кодом: no_carrier — у способа доставки нет перевозчика с интеграцией; not_shippable — заказ уже не отгружается; awaits_bill_payment — счёт не оплачен; carrier_rejected — перевозчик отказал; shipment_data_invalid — данных заказа или настроек перевозчика не хватает; request_expired — запрос не дождался исполнения; internal_error — сбой сервиса до обращения к перевозчику."
                                    },
                                    "message": {
                                        "type": "string",
                                        "description": "Причина словами магазина на языке ответа; если отказал перевозчик — с его словами."
                                    }
                                },
                                "required": [
                                    "code",
                                    "message"
                                ],
                                "description": "Почему запрошенный выпуск не удался; null — если не отказ."
                            }
                        },
                        "required": [
                            "state",
                            "started_at",
                            "error"
                        ],
                        "description": "Незакрытый выпуск отправления; null — его нет."
                    },
                    "merged_into_order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Заказ, в который влит этот при объединении счетов стола: его позиции и оплаты — там, а этот остаётся пустой отменённой записью. null, если не влит."
                    },
                    "cancel_reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "payment_init_failed",
                            "payment_declined",
                            "cashier_void",
                            "shift_closed",
                            "order_timeout",
                            "merged",
                            "items_moved",
                            "sale_void",
                            "subscription_day_unserved",
                            "booking_forfeit_reverted",
                            "service_package_term_extended",
                            "membership_renewal_void",
                            null
                        ],
                        "description": "Системная причина отмены: payment_init_failed — оплата не запустилась; payment_declined — оплата отклонена; cashier_void — аннулирован на кассе; shift_closed — смена кассы закрыта; order_timeout — не оплачен вовремя; merged — влит в другой заказ; items_moved — позиции перенесены в другой заказ; sale_void — продажа аннулирована; subscription_day_unserved — день подписки не обслужен; booking_forfeit_reverted — удержание брони отменено; service_package_term_extended — срок пакета визитов продлили, сгорание отменено; membership_renewal_void — счёт продления абонемента погашен: договор отменён или окончен. null, если заказ не отменён или причину указал человек."
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID позиции."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Вариант позиции; null у позиции без варианта, например у подарочной карты, проданной на кассе."
                                },
                                "product_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Товар позиции; null у позиции без варианта."
                                },
                                "product_name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "string"
                                    },
                                    "description": "Название товара на момент продажи, по языкам."
                                },
                                "variant_name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "string"
                                    },
                                    "description": "Название варианта на момент продажи, по языкам; пустой объект, если у варианта не было названия."
                                },
                                "quantity": {
                                    "type": "string",
                                    "description": "Количество десятичной строкой в unit: штуки у штучной позиции, мера у весовой или объёмной (\"480\" граммов)."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "pcs",
                                        "g",
                                        "ml",
                                        null
                                    ],
                                    "description": "Единица quantity: pcs, g или ml; null, если вариант больше не знает единицу своей меры."
                                },
                                "unit_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Цена одной штуки; null у весовой или объёмной позиции — её сумма в total."
                                },
                                "total": {
                                    "type": "integer",
                                    "description": "Сумма позиции."
                                },
                                "discount": {
                                    "type": "integer",
                                    "description": "Скидка на позицию."
                                },
                                "discount_allocations": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "applied_discount_id": {
                                                "type": "integer",
                                                "description": "Строка applied_discounts этого заказа."
                                            },
                                            "amount": {
                                                "type": "integer",
                                                "description": "Доля этой скидки на позиции."
                                            }
                                        },
                                        "required": [
                                            "applied_discount_id",
                                            "amount"
                                        ]
                                    },
                                    "description": "Из каких скидок журнала сложилась скидка позиции: сумма amount равна items[].discount."
                                },
                                "is_gift": {
                                    "type": "boolean",
                                    "description": "Подарок акции или промокода: позиция с ценой и скидкой 100 %."
                                },
                                "tax_lines": {
                                    "type": [
                                        "array",
                                        "null"
                                    ],
                                    "items": {
                                        "$ref": "#/components/schemas/TaxLine"
                                    },
                                    "description": "Налог позиции — её доля налога своей ставки в tax_lines заказа. Описывает облагаемую часть позиции: визит, частью оплаченный пакетом, — только остатком. null — позиция вне продажи (продажа подарочной карты, визит, целиком оплаченный пакетом, позиция с полной скидкой) или налог неизвестен."
                                },
                                "cost_amount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Себестоимость позиции на момент продажи: сумма в минимальных единицах currency за всю позицию, а не ставка. null — не посчитана. Только со scope costs:read."
                                },
                                "cost_basis": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "variant",
                                        "recipe",
                                        "unknown",
                                        "backfill",
                                        "standard",
                                        "partial",
                                        "external",
                                        null
                                    ],
                                    "description": "Чем посчитана себестоимость: variant — себестоимость варианта; recipe — сумма тех-карты; standard — по нормативной тех-карте, оценка; partial — только известная часть тех-карты, нижняя граница; backfill — оценена позже по цене каталога, а не на момент продажи; external — взята из внешней кассы, которая провела продажу; unknown — считать не из чего. Только со scope costs:read."
                                }
                            },
                            "required": [
                                "id",
                                "variant_id",
                                "product_id",
                                "product_name",
                                "variant_name",
                                "quantity",
                                "unit",
                                "unit_price",
                                "total",
                                "discount",
                                "discount_allocations",
                                "is_gift",
                                "tax_lines"
                            ]
                        },
                        "description": "Позиции заказа: исторический факт, названия — на момент продажи."
                    },
                    "customer": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id": {
                                "type": "integer",
                                "description": "ID записи, уникальный среди записей своего вида в магазине."
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Имя покупателя; null, если неизвестно."
                            },
                            "phone": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Основной телефон покупателя в формате E.164, например +5491123456789; null, если неизвестен."
                            },
                            "email": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Email покупателя; null, если неизвестен."
                            }
                        },
                        "required": [
                            "id",
                            "name",
                            "phone",
                            "email"
                        ],
                        "description": "Покупатель заказа; null у заказа без покупателя. Только со scope customers:read."
                    },
                    "delivery_address": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "kind": {
                                "type": "string",
                                "enum": [
                                    "address",
                                    "branch"
                                ],
                                "description": "address — адрес покупателя; branch — пункт выдачи перевозчика (branch, address_line)."
                            },
                            "recipient": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Кто получает заказ; null, если не указан."
                            },
                            "phone": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Телефон получателя; null, если не указан."
                            },
                            "street": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Улица."
                            },
                            "house": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Номер дома."
                            },
                            "apartment": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Квартира или офис."
                            },
                            "floor": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Этаж."
                            },
                            "entrance": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Подъезд."
                            },
                            "district": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Район."
                            },
                            "city": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Город."
                            },
                            "province": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Провинция или область."
                            },
                            "postal_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Почтовый индекс."
                            },
                            "address_line": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Адрес пункта выдачи перевозчика одной строкой; null у адреса покупателя."
                            },
                            "comment": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Комментарий покупателя к адресу, например как пройти."
                            },
                            "location": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "lat": {
                                        "type": "number",
                                        "description": "Широта в градусах."
                                    },
                                    "lng": {
                                        "type": "number",
                                        "description": "Долгота в градусах."
                                    }
                                },
                                "required": [
                                    "lat",
                                    "lng"
                                ],
                                "description": "Точка адреса на карте; null, если неизвестна."
                            },
                            "branch": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "external_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "ID пункта выдачи в системе перевозчика."
                                    },
                                    "name": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "Название пункта выдачи."
                                    }
                                },
                                "required": [
                                    "external_id",
                                    "name"
                                ],
                                "description": "Пункт выдачи перевозчика, когда kind — branch; иначе null."
                            }
                        },
                        "required": [
                            "kind",
                            "recipient",
                            "phone",
                            "street",
                            "house",
                            "apartment",
                            "floor",
                            "entrance",
                            "district",
                            "city",
                            "province",
                            "postal_code",
                            "address_line",
                            "comment",
                            "location",
                            "branch"
                        ],
                        "description": "Адрес доставки на момент заказа; null у самовывоза — пункт выдачи в location_id. Только со scope customers:read."
                    },
                    "customer_comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Комментарий покупателя к заказу. Только со scope customers:read."
                    },
                    "fiscal_receptor": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id_type": {
                                "type": "string",
                                "enum": [
                                    "tax_id",
                                    "personal_id",
                                    "national_id",
                                    "passport",
                                    "none"
                                ],
                                "description": "Вид идентификатора: tax_id — налоговый номер организации (CUIT в Аргентине); personal_id — налоговый номер физлица (CUIL); national_id — удостоверение личности (DNI); passport — паспорт; none — без идентификатора."
                            },
                            "id_number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Номер идентификатора; null, когда id_type — none."
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Наименование или полное имя для документа; null, если не задано."
                            },
                            "tax_status": {
                                "type": "string",
                                "enum": [
                                    "registered",
                                    "small_taxpayer",
                                    "exempt",
                                    "final_consumer",
                                    "not_categorized",
                                    "foreign"
                                ],
                                "description": "Налоговый статус: registered — плательщик НДС (Responsable Inscripto в Аргентине); small_taxpayer — упрощённый режим (Monotributo); exempt — освобождён от НДС; final_consumer — конечный потребитель; not_categorized — без категории; foreign — иностранный покупатель."
                            },
                            "address": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Фискальный адрес одной строкой; null, если не задан."
                            }
                        },
                        "required": [
                            "id_type",
                            "id_number",
                            "name",
                            "tax_status",
                            "address"
                        ],
                        "description": "Кому выписывается фискальный документ заказа, зафиксировано на заказе; null — розничная продажа без реквизитов. Только со scope customers:read."
                    },
                    "external_fiscal_document": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "issuer": {
                                "type": "string",
                                "description": "Касса, выпускающая документ: fudo — FuDo, poster — Poster."
                            },
                            "status": {
                                "type": "string",
                                "enum": [
                                    "pending",
                                    "issued"
                                ],
                                "description": "pending — счёт в кассе открыт, документ касса выпустит при закрытии; issued — касса документ выпустила."
                            },
                            "number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Номер документа в кассе; null, пока документ не выпущен или если касса номер не отдаёт."
                            }
                        },
                        "required": [
                            "issuer",
                            "status",
                            "number"
                        ],
                        "description": "Документ продажи во внешней кассе: заказ ушёл в кассу магазина или пришёл из неё, и документ выпускает касса, а не мы — фискальных документов по такому заказу нет. null — документа кассы нет: документ наш или касса о нём не сообщила. Только со scope fiscal:read."
                    },
                    "placed_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда заказ оформлен."
                    },
                    "confirmed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда магазин подтвердил заказ; null до подтверждения."
                    },
                    "completed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда заказ завершён; null до завершения."
                    },
                    "cancelled_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда заказ отменён; null, если не отменён."
                    },
                    "refunded_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда заказ возвращён полностью; null, если не возвращён."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "channel",
                    "app_id",
                    "location_id",
                    "legal_entity_id",
                    "status",
                    "status_group",
                    "payment_status",
                    "sale_type",
                    "currency",
                    "items_total",
                    "discount",
                    "applied_discounts",
                    "delivery_cost",
                    "delivery_discount",
                    "delivery_discounts",
                    "delivery_tax_lines",
                    "platform_discount",
                    "platform_service_fee",
                    "platform_delivery_fee",
                    "total",
                    "tax_lines",
                    "gift_card_issue_amount",
                    "reservation_deposit_amount",
                    "account_payment_amount",
                    "service_package_issue_amount",
                    "payment_method",
                    "manual_payment_method_id",
                    "delivery_method_id",
                    "fulfilment_type",
                    "delivery_slots",
                    "shipment",
                    "previous_shipments",
                    "shipment_attempt",
                    "merged_into_order_id",
                    "cancel_reason",
                    "items",
                    "placed_at",
                    "confirmed_at",
                    "completed_at",
                    "cancelled_at",
                    "refunded_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "OrderStatus": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "code": {
                        "type": "string",
                        "description": "Код статуса — значение status заказа. Коды системных статусов одинаковы во всех магазинах."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Название статуса по языкам, как его показывает магазин."
                    },
                    "status_group": {
                        "type": "string",
                        "enum": [
                            "pos_open",
                            "placed",
                            "pending_payment",
                            "paid",
                            "confirmed",
                            "preparing",
                            "ready",
                            "ready_for_pickup",
                            "out_for_delivery",
                            "delivery_failed",
                            "delivered",
                            "completed",
                            "cancelled",
                            "refunded"
                        ],
                        "description": "Постоянный смысл статуса, те же значения, что у status_group заказа."
                    },
                    "allowed_next": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Коды статусов, в которые заказ переходит из этого, по правилам переходов магазина. Переход ещё сверяется с заказом: самовывоз не передают курьеру, доставке нужен курьер, завершению — оплата."
                    },
                    "is_system": {
                        "type": "boolean",
                        "description": "Системный статус: по одному на каждый смысл status_group, одинаковый во всех магазинах. У статусов, добавленных магазином, — false."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Позиция в списке статусов магазина."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда магазин вывел статус из обихода: заказы в него больше не переходят, прошлые заказы его показывают. null у действующего статуса."
                    }
                },
                "required": [
                    "id",
                    "code",
                    "name",
                    "status_group",
                    "allowed_next",
                    "is_system",
                    "position",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "Payment": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "order_id": {
                        "type": "integer",
                        "description": "ID заказа."
                    },
                    "pos_shift_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID кассовой смены (/v1/pos-shifts), принявшей деньги: по нему Z-отчёт относит платёж к смене. null — платёж не кассы."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Юрлицо, получающее деньги (/v1/legal-entities), — юрлицо заказа; null — продажа не распределена между юрлицами, деньги получает юрлицо магазина по умолчанию."
                    },
                    "method": {
                        "type": "string",
                        "enum": [
                            "cash",
                            "mercadopago",
                            "crypto",
                            "bybit",
                            "trc20",
                            "balance",
                            "modo",
                            "payway",
                            "mercadopago_qr",
                            "mercadopago_point",
                            "mercadopago_transfer",
                            "gift_card",
                            "subscription",
                            "deposit",
                            "external",
                            "manual",
                            "offset",
                            "on_account",
                            "exchange_credit",
                            "bonpunto",
                            "service_package"
                        ],
                        "description": "Способ оплаты. manual — ручной способ магазина (manual_payment_method_id); balance — баланс покупателя; on_account — в долг, сумму должен покупатель; gift_card — подарочная карта; остальные значения называют платёжного провайдера или вид оплаты."
                    },
                    "manual_payment_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Ручной способ оплаты магазина (/v1/manual-payment-methods), когда method — manual; иначе null."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "processing",
                            "succeeded",
                            "failed",
                            "partially_refunded",
                            "refunded",
                            "expired",
                            "voided"
                        ],
                        "description": "pending — ждёт денег; processing — провайдер обрабатывает; succeeded — оплачен; failed — не прошёл; partially_refunded — частично возвращён; refunded — возвращён; expired — ссылка на оплату истекла; voided — отменён до прихода денег."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Сумма к оплате по этому платежу."
                    },
                    "received_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Фактически получено; null, пока деньги не пришли. Получено по заказу — сумма received_amount минус refunded_amount его платежей."
                    },
                    "refunded_amount": {
                        "type": "integer",
                        "description": "Возвращено из полученного."
                    },
                    "tip_amount": {
                        "type": "integer",
                        "description": "Чаевые сверх суммы заказа."
                    },
                    "refunded_tip_amount": {
                        "type": "integer",
                        "description": "Возвращено из чаевых."
                    },
                    "surcharge_amount": {
                        "type": "integer",
                        "description": "Надбавка за оплату в рассрочку сверх суммы заказа."
                    },
                    "refunded_surcharge_amount": {
                        "type": "integer",
                        "description": "Возвращено из надбавки."
                    },
                    "provider_fee_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Комиссия платёжного провайдера, которую он списал из платежа до зачисления магазину. null — провайдер начислений не сообщает: наличные, ручной способ, платёж, деньги по которому не списаны."
                    },
                    "refunded_provider_fee_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Доля комиссии, которую провайдер вернул при возврате покупателю, — по его данным, а не пропорцией от refunded_amount: возврат мимо провайдера комиссию не возвращает."
                    },
                    "provider_withheld_tax_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Налог, который провайдер удержал из платежа как налоговый агент (у MercadoPago — Ingresos Brutos). Удержание с его юрисдикцией — в налоговом реестре магазина."
                    },
                    "refunded_provider_withheld_tax_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Доля удержанного налога, которую провайдер вернул."
                    },
                    "tender": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "currency": {
                                "type": "string",
                                "description": "Валюта способа оплаты: код ISO 4217 или код криптоактива, например USDT."
                            },
                            "amount": {
                                "type": "string",
                                "description": "Сумма счёта в валюте способа, десятичной строкой: покрывает amount вместе с чаевыми и надбавкой. Произведение на курс может не сойтись с amount на округлении и на части счёта, выставленной в валюте способа прямо из прайса."
                            },
                            "received_amount": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Получено в валюте способа, десятичной строкой; null — полученное ведётся только в валюте магазина (received_amount) либо пришла другая монета (received_asset)."
                            },
                            "tendered_amount": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Наличные в чужой валюте: сколько купюр дали, десятичной строкой. Сдачу выдают в валюте магазина. null у остальных способов."
                            },
                            "exchange_rate": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "rate": {
                                        "type": "string",
                                        "description": "Курс десятичной строкой: 1 единица валюты способа = rate единиц валюты магазина."
                                    },
                                    "mode": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "enum": [
                                            "auto",
                                            "fixed",
                                            "pegged",
                                            null
                                        ],
                                        "description": "Как получен курс: auto — рыночный курс источника с надбавкой магазина; fixed — курс задан магазином; pegged — магазин привязал валюту способа к другой валюте (peg), и курс — её курс, умноженный на коэффициент привязки. null у счетов, выставленных до правил курса."
                                    },
                                    "source": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "enum": [
                                            "coingecko",
                                            "criptoya_p2p",
                                            "ar_oficial",
                                            "ar_blue",
                                            "ar_mep",
                                            "ar_ccl",
                                            "ar_mayorista",
                                            "cbr",
                                            null
                                        ],
                                        "description": "Источник рыночного курса: coingecko — агрегированная цена CoinGecko; criptoya_p2p — медиана P2P-площадок; ar_oficial, ar_blue, ar_mep, ar_ccl, ar_mayorista — курсы доллара в Аргентине; cbr — Банк России. null, если источник не записан."
                                    },
                                    "base": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "Рыночный курс источника до надбавки магазина, десятичной строкой; null, если рыночной базы нет."
                                    },
                                    "markup_bps": {
                                        "type": [
                                            "integer",
                                            "null"
                                        ],
                                        "description": "Надбавка магазина к рыночному курсу в базисных пунктах (100 — это 1 %), бывает отрицательной. null у курса, заданного магазином, и у счетов до правил курса."
                                    },
                                    "peg": {
                                        "type": [
                                            "object",
                                            "null"
                                        ],
                                        "properties": {
                                            "currency": {
                                                "type": "string",
                                                "description": "Валюта, к которой привязана валюта способа (ISO 4217)."
                                            },
                                            "rate": {
                                                "type": "string",
                                                "description": "Коэффициент привязки десятичной строкой: сколько единиц peg.currency стоит единица валюты способа."
                                            }
                                        },
                                        "required": [
                                            "currency",
                                            "rate"
                                        ],
                                        "description": "Привязка валюты способа к другой валюте: 1 единица валюты способа = peg.rate единиц peg.currency (например, 1 USDT = 1 USD). Цены, назначенные в этой валюте, входят в счёт как есть. null, если курс не привязан."
                                    }
                                },
                                "required": [
                                    "rate",
                                    "mode",
                                    "source",
                                    "base",
                                    "markup_bps",
                                    "peg"
                                ],
                                "description": "Курс, по которому сумма в валюте способа стала суммой платежа, — снимок на момент выставления; null, если курса нет."
                            }
                        },
                        "required": [
                            "currency",
                            "amount",
                            "received_amount",
                            "tendered_amount",
                            "exchange_rate"
                        ],
                        "description": "Оплата в валюте, отличной от валюты магазина: счёт в USDT, перевод в долларах, наличные в чужой валюте. null — платёж в валюте магазина. Суммы платежа (amount и остальные) остаются в валюте магазина, учёт ведётся по ним."
                    },
                    "received_asset": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "asset": {
                                "type": "string",
                                "description": "Код монеты, например USDC."
                            },
                            "amount": {
                                "type": "string",
                                "description": "Сколько монет пришло, десятичной строкой."
                            },
                            "rate": {
                                "type": "string",
                                "description": "Курс зачёта десятичной строкой: 1 монета = rate единиц валюты магазина."
                            },
                            "rate_source": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Источник курса зачёта; manual — курс задан вручную."
                            },
                            "rate_as_of": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Момент котировки или версии ручного курса."
                            },
                            "tx_id": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "ID перевода в блокчейне или на бирже — для сверки."
                            }
                        },
                        "required": [
                            "asset",
                            "amount",
                            "rate",
                            "rate_source",
                            "rate_as_of",
                            "tx_id"
                        ],
                        "description": "Монета, которая пришла на самом деле, когда покупатель перевёл не то, что в счёте, и её оценили отдельно; null — пришло выставленное."
                    },
                    "provider_payment_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID операции у платёжного провайдера — для сверки с его выпиской; null, если провайдера нет."
                    },
                    "payment_url": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Страница оплаты у провайдера, пока платёж ждёт денег: ссылку можно отправить покупателю. null у оплаченного или отменённого платежа и у ручного способа."
                    },
                    "confirmable": {
                        "type": "boolean",
                        "description": "Платёж можно подтвердить вручную сейчас (POST /v1/payments/{payment}/confirm): он ждёт денег, приход которых подтверждает человек, а не провайдер."
                    },
                    "replaces_payment_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Платёж, который этот заменил при исправлении способа оплаты; иначе null."
                    },
                    "confirmed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда деньги получены; null, пока не получены."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "order_id",
                    "pos_shift_id",
                    "legal_entity_id",
                    "method",
                    "manual_payment_method_id",
                    "status",
                    "currency",
                    "amount",
                    "received_amount",
                    "refunded_amount",
                    "tip_amount",
                    "refunded_tip_amount",
                    "surcharge_amount",
                    "refunded_surcharge_amount",
                    "provider_fee_amount",
                    "refunded_provider_fee_amount",
                    "provider_withheld_tax_amount",
                    "refunded_provider_withheld_tax_amount",
                    "tender",
                    "received_asset",
                    "provider_payment_id",
                    "payment_url",
                    "confirmable",
                    "replaces_payment_id",
                    "confirmed_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "PosCashMovement": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "shift_id": {
                        "type": "integer",
                        "description": "ID кассовой смены (/v1/pos-shifts)."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "pay_in",
                            "pay_out",
                            "sale_cash_in",
                            "refund_cash_out",
                            "courier_shortage",
                            "waiter_cash_in",
                            "sale_reversal",
                            "no_sale",
                            "float_in",
                            "drop_out",
                            "pay_in_reversal",
                            "pay_out_reversal",
                            "drop_out_reversal",
                            "float_in_reversal",
                            "change_out",
                            "change_out_reversal"
                        ],
                        "description": "Вид движения: sale_cash_in — продажа налом; refund_cash_out — возврат налом; sale_reversal — нал, отданный при отмене незавершённой продажи; change_out — сдача в валюте магазина при оплате купюрами чужой валюты; pay_in и pay_out — внесение и выдача по причине; drop_out — сдача в сейф; float_in — размен из сейфа; waiter_cash_in — нал, сданный официантом; courier_shortage — недосдача курьера; no_sale — ящик открыт без продажи; *_reversal — сторно."
                    },
                    "direction": {
                        "type": "string",
                        "enum": [
                            "in",
                            "out",
                            "none"
                        ],
                        "description": "Знак в ожидании ящика: in — деньги легли в ящик; out — вышли из него; none — ящик открыт без денег."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Сумма в минимальных единицах валюты движения, всегда неотрицательная: знак задаёт direction."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта ящика, который меняет движение, код ISO 4217."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Момент события по времени кассы: движение, записанное без связи, доезжает позже."
                    },
                    "order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID заказа."
                    },
                    "payment_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID платежа (/v1/payments) продажи или возврата налом; null у ручных движений."
                    },
                    "reverses_movement_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID движения, которое это сторнирует; null у обычного движения."
                    },
                    "cash_transfer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID конверта сейфа — сдачи или размена: журнал денег ссылается на него source вида pos_cash_transfer. null, если конверта нет."
                    },
                    "cash_reason_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID причины внесения или выдачи (/v1/pos-cash-reasons); у прочих видов null."
                    },
                    "supplier_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID поставщика, которому выданы деньги; null, если выдача не поставщику."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Комментарий кассира; null, если его нет."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    }
                },
                "required": [
                    "id",
                    "shift_id",
                    "type",
                    "direction",
                    "amount",
                    "currency",
                    "occurred_at",
                    "order_id",
                    "payment_id",
                    "reverses_movement_id",
                    "cash_transfer_id",
                    "cash_reason_id",
                    "supplier_id",
                    "comment",
                    "created_at"
                ]
            },
            "PosCashReason": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "direction": {
                        "type": "string",
                        "enum": [
                            "pay_in",
                            "pay_out"
                        ],
                        "description": "pay_in — причина внесения; pay_out — причина выдачи."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "system_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "other",
                            null
                        ],
                        "description": "Код системной причины: other — «Прочее», по одной на направление. null у причины, заведённой магазином."
                    },
                    "category_id": {
                        "type": "integer",
                        "description": "ID статьи журнала денег (/v1/money-categories), которой проводится движение по причине."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Позиция при сортировке: меньшая идёт первой."
                    },
                    "archived_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда причина отправлена в архив: на кассе её не выбрать, история остаётся. null у действующей."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "direction",
                    "name",
                    "system_code",
                    "category_id",
                    "position",
                    "archived_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "PosShift": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Номер смены в реестре кассы, например Z-0044; null у смен старше нумерации."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID точки магазина."
                    },
                    "register_id": {
                        "type": "integer",
                        "description": "ID кассы точки. Справочника касс в API нет: для учёта смена группируется по точке."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "open",
                            "closed"
                        ],
                        "description": "open — смена идёт; closed — ящик пересчитан, смена закрыта."
                    },
                    "opened_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда смена открыта."
                    },
                    "closed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда смена закрыта; null у открытой."
                    },
                    "notes": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка закрывшего смену; null, если её нет."
                    },
                    "drawers": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID ящика смены: расхождение ящика чужой валюты журнал денег проводит с source вида pos_shift_drawer и этим ID."
                                },
                                "currency": {
                                    "type": "string",
                                    "enum": [
                                        "ARS",
                                        "USD",
                                        "BRL",
                                        "CLP",
                                        "COP",
                                        "MXN",
                                        "PEN",
                                        "RUB"
                                    ],
                                    "description": "Валюта ящика, код ISO 4217: суммы ящика — в её минимальных единицах."
                                },
                                "opening_float": {
                                    "type": "integer",
                                    "description": "Разменный фонд при открытии."
                                },
                                "expected": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Сколько должно было быть в ящике при закрытии; null у открытой смены."
                                },
                                "counted": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Сколько насчитали при закрытии; null у открытой смены."
                                },
                                "difference": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Расхождение: counted минус expected — излишек с плюсом, недостача с минусом. Журнал денег проводит его с документом-сменой. null у открытой смены."
                                },
                                "carried_float": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Оставлено в ящике разменом следующей смене; сдано в сейф — counted минус carried_float. null у открытой смены и у смены, закрытой до учёта сейфа."
                                }
                            },
                            "required": [
                                "id",
                                "currency",
                                "opening_float",
                                "expected",
                                "counted",
                                "difference",
                                "carried_float"
                            ]
                        },
                        "description": "Денежный ящик на каждую валюту, побывавшую в нём; первым — валюта магазина. Ожидание ящика — opening_float плюс движения его валюты со знаком direction."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "location_id",
                    "register_id",
                    "status",
                    "opened_at",
                    "closed_at",
                    "notes",
                    "drawers",
                    "created_at",
                    "updated_at"
                ]
            },
            "PostSupplierBillCommandRequest": {
                "type": "object",
                "properties": []
            },
            "PriceList": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "location",
                            "wholesale"
                        ],
                        "description": "Вид листа: location — цены продаж в точках листа поверх базовой цены, wholesale — оптовые цены покупателя-юрлица от себестоимости. Не меняется."
                    },
                    "name": {
                        "type": "string",
                        "description": "Ярлык листа в панели магазина; у листа точки — имя точки, при которой лист заведён."
                    },
                    "adjustment_bp": {
                        "type": "integer",
                        "description": "Поправка правила в базисных пунктах: +20 % — 2000, −10 % — -1000. У листа точки — к базовой цене варианта (от -9000 до 50000), у оптового — наценка к себестоимости единицы (от 0 до 50000)."
                    },
                    "rounding": {
                        "type": "object",
                        "properties": {
                            "mode": {
                                "type": "string",
                                "enum": [
                                    "nearest",
                                    "up",
                                    "down"
                                ],
                                "description": "Направление округления: nearest — к ближайшему, up — вверх, down — вниз."
                            },
                            "precision": {
                                "type": "integer",
                                "description": "Разряд округления в знаках мажорных единиц: 2 — до сотых, 0 — до целых, -2 — до сотен."
                            }
                        },
                        "required": [
                            "mode",
                            "precision"
                        ],
                        "description": "Округление цены по правилу листа. Ручные цены и цены позиций на вес и объём не округляются."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "kind",
                    "name",
                    "adjustment_bp",
                    "rounding",
                    "created_at",
                    "updated_at"
                ]
            },
            "PriceListItem": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "price_list_id": {
                        "type": "integer",
                        "description": "ID прайс-листа."
                    },
                    "variant_id": {
                        "type": "integer",
                        "description": "ID варианта, у которого в листе ручная цена; вариант может быть в архиве."
                    },
                    "price": {
                        "type": "integer",
                        "description": "Цена в минимальных единицах currency — назначенная цена в деньгах учёта магазина."
                    },
                    "compare_at_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Цена до скидки, показывается зачёркнутой; null, если скидки нет. У оптового листа всегда null."
                    },
                    "list_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Цена, как её назначил владелец, в минимальных единицах list_price_currency; null — цена назначена в деньгах учёта (price)."
                    },
                    "list_compare_at_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Цена до скидки в валюте list_price_currency; null — скидки нет или цена назначена в деньгах учёта."
                    },
                    "list_price_currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Валюта назначенной цены (прайс в чужой валюте); null — цена в валюте магазина currency."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "tare_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Тара, за которую назначена оптовая цена сырья или полуфабриката, в единице варианта unit — снимком на момент назначения; null — цена за price_per_quantity варианта."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "price_list_id",
                    "variant_id",
                    "price",
                    "compare_at_price",
                    "list_price",
                    "list_compare_at_price",
                    "list_price_currency",
                    "currency",
                    "tare_quantity",
                    "created_at",
                    "updated_at"
                ]
            },
            "PriceListModifierItem": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "price_list_id": {
                        "type": "integer",
                        "description": "ID прайс-листа."
                    },
                    "modifier_option_id": {
                        "type": "integer",
                        "description": "ID опции модификатора."
                    },
                    "variant_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Вариант позиции, для которого надбавка своя; null — надбавка для всех вариантов."
                    },
                    "price_delta": {
                        "type": "integer",
                        "description": "Надбавка опции в минимальных единицах currency — назначенная надбавка в деньгах учёта магазина."
                    },
                    "list_price_delta": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Надбавка, как её назначил владелец, в минимальных единицах list_price_currency; null — назначена в деньгах учёта (price_delta)."
                    },
                    "list_price_currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Валюта назначенной надбавки; null — надбавка в валюте магазина currency."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "price_list_id",
                    "modifier_option_id",
                    "variant_id",
                    "price_delta",
                    "list_price_delta",
                    "list_price_currency",
                    "currency",
                    "created_at",
                    "updated_at"
                ]
            },
            "Problem": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "description": "Машинный тип отказа: стабильный код для ветвления, например insufficient_scope. У каждого типа есть страница в каталоге ошибок."
                    },
                    "title": {
                        "type": "string",
                        "description": "Краткое описание отказа на языке запроса."
                    },
                    "status": {
                        "type": "integer",
                        "description": "HTTP-статус ответа."
                    },
                    "detail": {
                        "type": "string",
                        "description": "Объяснение этого случая на языке запроса."
                    }
                },
                "required": [
                    "type",
                    "title",
                    "status"
                ]
            },
            "Product": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "goods",
                            "dish",
                            "ingredient",
                            "prep",
                            "manufactured",
                            "meal_program",
                            "bundle",
                            "gift_card",
                            "service",
                            "service_package"
                        ],
                        "description": "Вид товара: goods — товар для продажи; dish — блюдо, готовится под заказ; ingredient — сырьё для техкарт; prep — полуфабрикат собственного приготовления; manufactured — продукция собственного производства; meal_program — программа питания по подписке; bundle — набор из других товаров; gift_card — подарочная карта; service — услуга по записи."
                    },
                    "stock_unit": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml",
                                    "pcs"
                                ],
                                "description": "Базовая единица: g — граммы, ml — миллилитры, pcs — штуки. Количества вариантов товара — десятичные строки в этой единице."
                            },
                            "purchase_unit": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Название тары закупки, например кг или коробка; null — позицию закупают в базовой единице."
                            },
                            "purchase_quantity": {
                                "type": "string",
                                "description": "Сколько базовых единиц в одной таре закупки, десятичной строкой: например, 1000 для килограмма позиции, которую учитывают в граммах."
                            }
                        },
                        "required": [
                            "unit",
                            "purchase_unit",
                            "purchase_quantity"
                        ],
                        "description": "Единица учёта позиции со складом по мере (сырьё, заготовка, производимый товар): в ней остатки, тех-карты и выход. null у товара и блюда — их единица задаётся осью продажи варианта."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "short_description": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Краткое описание по языкам, простой текст для списков товаров."
                    },
                    "description": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Описание по языкам в Markdown (GitHub Flavored): объект заполненных языков."
                    },
                    "slug": {
                        "type": "string",
                        "description": "Адрес товара на витрине, уникальный в магазине."
                    },
                    "brand_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID бренда товара; null, если не задан."
                    },
                    "tax_class_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID налогового класса товара (/v1/tax-classes); null — класс магазина по умолчанию. Продажа запоминает ставку позиции: смена класса меняет только будущие продажи."
                    },
                    "category_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "ID категорий товара по возрастанию."
                    },
                    "primary_category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Основная категория из category_ids; null, если основная не выбрана."
                    },
                    "options": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID опции."
                                },
                                "key": {
                                    "type": "string",
                                    "description": "Машинный ключ опции, уникальный в товаре, например size."
                                },
                                "name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "string"
                                    },
                                    "description": "Название опции по языкам."
                                },
                                "position": {
                                    "type": "integer",
                                    "description": "Позиция опции: меньшая идёт первой."
                                },
                                "values": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "integer",
                                                "description": "ID значения. Варианты ссылаются на него в option_values."
                                            },
                                            "value": {
                                                "type": "object",
                                                "additionalProperties": {
                                                    "type": "string"
                                                },
                                                "description": "Значение по языкам, например {\"es\": \"Rojo\", \"ru\": \"Красный\"}."
                                            },
                                            "swatch_color": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Цвет образца, шестнадцатеричный код вида #C0392B; null, если у значения нет образца."
                                            },
                                            "position": {
                                                "type": "integer",
                                                "description": "Позиция значения: меньшая идёт первой."
                                            }
                                        },
                                        "required": [
                                            "id",
                                            "value",
                                            "swatch_color",
                                            "position"
                                        ]
                                    },
                                    "description": "Значения опции по порядку."
                                }
                            },
                            "required": [
                                "id",
                                "key",
                                "name",
                                "position",
                                "values"
                            ]
                        },
                        "description": "Опции, которыми различаются варианты, например размер или цвет, по порядку."
                    },
                    "modifier_groups": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "group_id": {
                                    "type": "integer",
                                    "description": "ID группы модификаторов (/v1/modifier-groups)."
                                },
                                "selection_rule": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "min_select": {
                                            "type": "integer",
                                            "description": "Сколько опций обязательно выбрать на этом товаре."
                                        },
                                        "max_select": {
                                            "type": [
                                                "integer",
                                                "null"
                                            ],
                                            "description": "Сколько опций можно выбрать на этом товаре; null — без предела."
                                        }
                                    },
                                    "required": [
                                        "min_select",
                                        "max_select"
                                    ],
                                    "description": "Правило выбора на этом товаре вместо правила группы; null — правило группы."
                                }
                            },
                            "required": [
                                "group_id",
                                "selection_rule"
                            ]
                        },
                        "description": "Группы модификаторов товара по порядку показа с правилом выбора на этом товаре. Надбавки опций по вариантам — GET /v1/products/{product}/modifier-groups; заменяет группы PUT того же адреса."
                    },
                    "media": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID файла в медиатеке. Файл стоит в галерее товара не больше одного раза."
                                },
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "image",
                                        "video"
                                    ],
                                    "description": "image — фото, video — видео."
                                },
                                "url": {
                                    "type": "string",
                                    "description": "Публичный адрес файла."
                                },
                                "mime": {
                                    "type": "string",
                                    "description": "MIME-тип файла, например image/webp."
                                },
                                "alt": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "string"
                                    },
                                    "description": "Альтернативный текст по языкам — для экранных чтецов и поисковиков."
                                },
                                "position": {
                                    "type": "integer",
                                    "description": "Место в галерее, с нуля."
                                },
                                "is_primary": {
                                    "type": "boolean",
                                    "description": "Главное фото: витрина показывает его первым."
                                }
                            },
                            "required": [
                                "id",
                                "kind",
                                "url",
                                "mime",
                                "alt",
                                "position",
                                "is_primary"
                            ]
                        },
                        "description": "Фото и видео галереи по порядку: те же объекты, что в /v1/products/{product}/media."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false снимает товар с продажи и скрывает его с витрины."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда товар появляется на витрине; null — сразу."
                    },
                    "unpublished_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда товар уходит с витрины; null — остаётся."
                    },
                    "sale_schedule": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "days": {
                                    "type": "array",
                                    "items": {
                                        "type": "integer"
                                    },
                                    "description": "Дни окна по ISO: 1 — понедельник, 7 — воскресенье."
                                },
                                "from": {
                                    "type": "string",
                                    "description": "Начало окна, «HH:MM» по часам магазина."
                                },
                                "to": {
                                    "type": "string",
                                    "description": "Конец окна, «HH:MM», сам момент не входит; «24:00» — до конца дня. Конец раньше начала — окно через полночь, оно принадлежит дню начала."
                                }
                            },
                            "required": [
                                "days",
                                "from",
                                "to"
                            ]
                        },
                        "description": "Когда позицию можно заказать — окна недели в часовом поясе магазина; null — всегда. Вне окна товар виден и кладётся в корзину, а оформление сверяет расписание со временем исполнения заказа."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда товар отправлен в архив вместе с вариантами; null у живого товара."
                    }
                },
                "required": [
                    "id",
                    "external_id",
                    "version",
                    "type",
                    "stock_unit",
                    "name",
                    "short_description",
                    "description",
                    "slug",
                    "brand_id",
                    "tax_class_id",
                    "category_ids",
                    "primary_category_id",
                    "options",
                    "modifier_groups",
                    "media",
                    "is_active",
                    "published_at",
                    "unpublished_at",
                    "sale_schedule",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "ProductMedia": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID файла в медиатеке. Файл стоит в галерее товара не больше одного раза."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "image",
                            "video"
                        ],
                        "description": "image — фото, video — видео."
                    },
                    "url": {
                        "type": "string",
                        "description": "Публичный адрес файла."
                    },
                    "mime": {
                        "type": "string",
                        "description": "MIME-тип файла, например image/webp."
                    },
                    "alt": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Альтернативный текст по языкам — для экранных чтецов и поисковиков."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Место в галерее, с нуля."
                    },
                    "is_primary": {
                        "type": "boolean",
                        "description": "Главное фото: витрина показывает его первым."
                    }
                },
                "required": [
                    "id",
                    "kind",
                    "url",
                    "mime",
                    "alt",
                    "position",
                    "is_primary"
                ]
            },
            "ProductModifierGroups": {
                "type": "object",
                "properties": {
                    "product_id": {
                        "type": "integer",
                        "description": "ID товара. Группы версионируются на его карточке: ETag и If-Match несут версию товара."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "groups": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "group_id": {
                                    "type": "integer",
                                    "description": "ID группы модификаторов (/v1/modifier-groups)."
                                },
                                "selection_rule": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "min_select": {
                                            "type": "integer",
                                            "description": "Сколько опций обязательно выбрать на этом товаре."
                                        },
                                        "max_select": {
                                            "type": [
                                                "integer",
                                                "null"
                                            ],
                                            "description": "Сколько опций можно выбрать на этом товаре; null — без предела."
                                        }
                                    },
                                    "required": [
                                        "min_select",
                                        "max_select"
                                    ],
                                    "description": "Правило выбора на этом товаре вместо правила группы; null — правило группы."
                                }
                            },
                            "required": [
                                "group_id",
                                "selection_rule"
                            ]
                        },
                        "description": "Группы модификаторов товара по порядку показа. В записи — набор целиком."
                    },
                    "option_prices": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID опции из групп товара."
                                },
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID варианта товара."
                                },
                                "is_available": {
                                    "type": "boolean",
                                    "description": "false — на этом варианте опция не предлагается; надбавки у такой строки нет."
                                },
                                "price_delta": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Надбавка опции на этом варианте, целым в минорных единицах валюты магазина; null только у недоступной опции."
                                }
                            },
                            "required": [
                                "option_id",
                                "variant_id",
                                "is_available",
                                "price_delta"
                            ]
                        },
                        "description": "Надбавка и доступность опций на вариантах товара вместо надбавки опции. В записи заменяет переопределения целиком; без поля прежние остаются, кроме принадлежавших снятым группам."
                    }
                },
                "required": [
                    "product_id",
                    "version",
                    "groups",
                    "option_prices"
                ]
            },
            "PurchaseOrder": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Номер заказа; null у заказа, заведённого до нумерации."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "sent",
                            "partial",
                            "received",
                            "closed",
                            "cancelled"
                        ],
                        "description": "draft — черновик: поставщику не отправлен; sent — размещён, ждём поставку; partial — принят частично; received — принят полностью; closed — закрыт магазином: принят целиком или с недопоставкой (closed_short); cancelled — отменён."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID поставщика (/v1/suppliers)."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID точки, куда ждём поставку (/v1/locations)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID юрлица магазина-покупателя (/v1/legal-entities); null у заказа, заведённого до юрлиц магазина."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта заказа, ISO 4217: в ней цены строк и итоги."
                    },
                    "prices_include_tax": {
                        "type": "boolean",
                        "description": "true — цены строк с налогом; false — без налога."
                    },
                    "ordered_total": {
                        "type": "integer",
                        "description": "Стоимость заказанного в силе; по закрытой строке — принятого."
                    },
                    "received_total": {
                        "type": "integer",
                        "description": "Стоимость принятого по заказу."
                    },
                    "expected_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Когда магазин ждёт поставку, YYYY-MM-DD; null, если дата не задана."
                    },
                    "next_delivery_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Ближайшая ожидаемая поставка с учётом дат, обещанных поставщиком, YYYY-MM-DD; null, если ждать нечего."
                    },
                    "placed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда заказ впервые отправлен поставщику; null у черновика и у отменённого до отправки."
                    },
                    "closed_short": {
                        "type": "boolean",
                        "description": "true — заказ закрыт с недопоставкой: остаток больше не ждём."
                    },
                    "supplier_response": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "awaiting",
                            "confirmed",
                            "changed",
                            "declined",
                            null
                        ],
                        "description": "Ответ поставщика: awaiting — ждём; confirmed — подтвердил как есть; changed — подтвердил с изменениями (confirmed_quantity и promised_on строк); declined — отказал; null — ответ не отслеживается."
                    },
                    "revision": {
                        "type": "integer",
                        "description": "Ревизия условий заказа, которую видит поставщик: растёт с каждой правкой размещённого заказа."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка сотрудника; null, если её нет."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID записи, уникальный среди записей своего вида в магазине."
                                },
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID варианта товара (/v1/variants)."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Базовая единица количеств строки: pcs — штуки, g — граммы, ml — миллилитры."
                                },
                                "ordered_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Заказано, десятичной строкой в базовой единице."
                                },
                                "confirmed_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Подтвердил поставщик; null — ответа по строке нет."
                                },
                                "received_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Принято приёмками по строке."
                                },
                                "unit_cost": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Цена в валюте заказа за cost_per_quantity; null — цена не указана."
                                },
                                "cost_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "За какое количество в базовой единице указана цена: \"1000\" у весового товара — за килограмм."
                                },
                                "ordered_amount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Стоимость заказанного в силе по строке; null без цены. Сумма по строкам — ordered_total."
                                },
                                "received_amount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Стоимость принятого по строке; null без цены. Сумма по строкам — received_total."
                                },
                                "promised_on": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date",
                                    "description": "Дата поставки, обещанная поставщиком, YYYY-MM-DD; null — не обещана, ждём к expected_on."
                                },
                                "closed_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Когда строку закрыли и перестали ждать остаток; null у открытой строки."
                                }
                            },
                            "required": [
                                "id",
                                "variant_id",
                                "unit",
                                "ordered_quantity",
                                "confirmed_quantity",
                                "received_quantity",
                                "unit_cost",
                                "cost_per_quantity",
                                "ordered_amount",
                                "received_amount",
                                "promised_on",
                                "closed_at"
                            ]
                        },
                        "description": "Строки заказа по порядку."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "number",
                    "status",
                    "supplier_id",
                    "location_id",
                    "legal_entity_id",
                    "currency",
                    "prices_include_tax",
                    "ordered_total",
                    "received_total",
                    "expected_on",
                    "next_delivery_on",
                    "placed_at",
                    "closed_short",
                    "supplier_response",
                    "revision",
                    "note",
                    "lines",
                    "created_at",
                    "updated_at"
                ]
            },
            "RateLimitProblem": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "description": "Машинный тип отказа: стабильный код для ветвления, например insufficient_scope. У каждого типа есть страница в каталоге ошибок."
                    },
                    "title": {
                        "type": "string",
                        "description": "Краткое описание отказа на языке запроса."
                    },
                    "status": {
                        "type": "integer",
                        "description": "HTTP-статус ответа."
                    },
                    "detail": {
                        "type": "string",
                        "description": "Объяснение этого случая на языке запроса."
                    },
                    "policy": {
                        "type": "string",
                        "enum": [
                            "app",
                            "store",
                            "rejected"
                        ],
                        "description": "Какая корзина исчерпана: app — приложения; store — магазина, общая для всех его приложений; rejected — запросов с одного адреса, отклонённых на входе."
                    }
                },
                "required": [
                    "type",
                    "title",
                    "status",
                    "policy"
                ]
            },
            "RecommendationRule": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Приоритет: правило с меньшим значением применяется раньше."
                    },
                    "source_type": {
                        "type": "string",
                        "enum": [
                            "category",
                            "collection"
                        ],
                        "description": "К чему правило: category — к товарам категории и её подкатегорий; collection — к товарам подборки."
                    },
                    "source_id": {
                        "type": "integer",
                        "description": "ID категории или подборки, к товарам которой правило. У источника правило одно."
                    },
                    "target_collection_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID подборки, товары которой правило предлагает после своих; null — без подборки."
                    },
                    "product_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "ID товаров, которые правило предлагает, в порядке полки; не больше 20."
                    },
                    "exclusive": {
                        "type": "boolean",
                        "description": "true — «только это правило»: правила ниже и автоподбор полку не добирают; без товаров и подборки скрывает полку."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false выключает правило: оно хранится, но не действует."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "position",
                    "source_type",
                    "source_id",
                    "target_collection_id",
                    "product_ids",
                    "exclusive",
                    "is_active",
                    "created_at",
                    "updated_at"
                ]
            },
            "RecommendationRuleSource": {
                "type": "string",
                "enum": [
                    "category",
                    "collection"
                ]
            },
            "RecordCustomerAccountPaymentRequest": {
                "type": "object",
                "properties": {
                    "amount": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 10000000000,
                        "description": "Сколько денег пришло в счёт долга, в минимальных единицах валюты магазина."
                    },
                    "payment_method": {
                        "type": "string",
                        "enum": [
                            "cash",
                            "mercadopago",
                            "crypto",
                            "bybit",
                            "trc20",
                            "balance",
                            "modo",
                            "payway",
                            "mercadopago_qr",
                            "mercadopago_point",
                            "mercadopago_transfer",
                            "gift_card",
                            "subscription",
                            "deposit",
                            "external",
                            "manual",
                            "offset",
                            "on_account",
                            "exchange_credit",
                            "bonpunto",
                            "service_package"
                        ],
                        "description": "Способ, которым пришли деньги: он должен гасить долг и подтверждаться руками — например наличные или ручной способ manual."
                    },
                    "manual_payment_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "description": "ID ручного способа оплаты (/v1/manual-payment-methods) при payment_method=manual, например банковского перевода."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID точки магазина."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID юрлица магазина (/v1/legal-entities), чей долг гасят: нужен, когда покупатель должен нескольким юрлицам."
                    },
                    "withholdings": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "regime": {
                                    "type": "string",
                                    "description": "Налог удержания: vat, turnover, income и другие коды TaxRegime."
                                },
                                "jurisdiction": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "pattern": "^[A-Z]{2}-[A-Z0-9]{1,5}$",
                                    "maxLength": 8,
                                    "description": "Юрисдикция провинциального или муниципального налога, например AR-B; у налогов страны — null."
                                },
                                "amount": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "description": "Сумма удержания в минимальных единицах валюты магазина."
                                },
                                "certificate_number": {
                                    "type": "string",
                                    "maxLength": 64,
                                    "description": "Номер справки об удержании."
                                }
                            },
                            "required": [
                                "regime",
                                "amount",
                                "certificate_number"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 2000,
                        "description": "Справки об удержаниях, которые покупатель-агент отдал вместе с деньгами: закрывают долг наравне с деньгами."
                    },
                    "withheld_on": {
                        "type": "string",
                        "format": "date",
                        "description": "День удержания, YYYY-MM-DD: по нему справка ложится в налоговый период, закрытый период — отказ."
                    },
                    "withholding_agent_tax_id": {
                        "type": "string",
                        "maxLength": 20,
                        "description": "CUIT покупателя-агента, удержавшего налог."
                    }
                },
                "required": [
                    "amount",
                    "payment_method",
                    "location_id"
                ]
            },
            "RecordOutOfBandSupplierBillPaymentRequest": {
                "type": "object",
                "properties": {
                    "amount": {
                        "type": "integer",
                        "maximum": 10000000000,
                        "description": "Сколько долга закрыто, в минимальных единицах валюты счёта поставщика: не больше остатка (outstanding). Удержания входят в эту сумму — поставщик получил amount минус удержания."
                    },
                    "paid_on": {
                        "type": "string",
                        "format": "date",
                        "description": "День оплаты, YYYY-MM-DD в часовом поясе магазина, не в будущем: по нему удержания ложатся в налоговый период, закрытый период — отказ."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Заметка к оплате, например номер платёжки банка; null — без заметки."
                    },
                    "withholdings": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "regime": {
                                    "type": "string",
                                    "enum": [
                                        "vat",
                                        "income",
                                        "turnover",
                                        "municipal",
                                        "internal",
                                        "social",
                                        "other"
                                    ],
                                    "description": "Налог удержания: vat, turnover, income и другие коды TaxRegime."
                                },
                                "amount": {
                                    "type": "integer",
                                    "maximum": 10000000000,
                                    "description": "Сумма удержания в минимальных единицах валюты счёта поставщика; сумма удержаний меньше amount. Её вычитают из оплаты поставщику. У счёта в чужой валюте в ленту tax-withholdings уходит эквивалент в валюте магазина по курсу дня оплаты; курса нет — 422."
                                },
                                "jurisdiction": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "pattern": "^[A-Z]{2}-[A-Z0-9]{1,5}$",
                                    "maxLength": 8,
                                    "description": "Юрисдикция провинциального или муниципального налога, например AR-B: у turnover и municipal обязательна. У налогов страны — null."
                                },
                                "certificate_number": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 64,
                                    "description": "Номер сертификата удержания, выданного поставщику; null — номер выдаст магазин из своего ряда."
                                },
                                "rate_bps": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 10000,
                                    "description": "Ставка удержания в сотых долях процента (250 — 2,5 %); null — ставка не известна."
                                },
                                "rate_source": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "padron",
                                        "default",
                                        "manual",
                                        null
                                    ],
                                    "description": "Откуда ставка: padron — из падрона ARCA или провинции, default — ставка по умолчанию, manual — введена вручную; null — не указано."
                                }
                            },
                            "required": [
                                "regime",
                                "amount"
                            ]
                        },
                        "maxItems": 20,
                        "description": "Удержания, которые магазин практиковал при этой выплате поставщику. У юрлица — агента удержаний состав обязателен: пустой список — «удержания не было», отсутствие поля — отказ. У остальных юрлиц поле не нужно."
                    }
                },
                "required": [
                    "amount",
                    "paid_on"
                ]
            },
            "Refund": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "order_id": {
                        "type": "integer",
                        "description": "ID заказа."
                    },
                    "pos_shift_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID кассовой смены (/v1/pos-shifts), оформившей возврат; null — возврат не на кассе."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "return",
                            "adjustment",
                            "overpayment",
                            "tip"
                        ],
                        "description": "return — возврат товара; adjustment — корректировка суммы без товара; overpayment — возврат переплаты; tip — возврат чаевых."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "completed",
                            "failed",
                            "reversed"
                        ],
                        "description": "pending — ждёт провайдера или ручной выплаты; completed — выполнен; failed — не прошёл; reversed — отменён после выполнения."
                    },
                    "app_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Приложение, оформившее возврат (/v1/orders/{order}/refunds или отмена заказа), — его id из /v1/me; null у возврата кассы, сотрудника, покупателя или автоматики."
                    },
                    "confirmable": {
                        "type": "boolean",
                        "description": "Возврат ждёт подтверждения, что деньги выплачены вне системы (POST /v1/refunds/{refund}/confirm)."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Сумма возврата: позиции и доставка."
                    },
                    "shipping_amount": {
                        "type": "integer",
                        "description": "Часть amount, которая возвращает доставку."
                    },
                    "tax_lines": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "$ref": "#/components/schemas/TaxLine"
                        },
                        "description": "Налог возвращённого по классификации товаров — состав кредит-ноты возврата: возвращённые позиции, кроме подарочных карт, и доставка; у возврата суммой без позиций — облагаемая часть по классу магазина по умолчанию. null — у магазина нет налоговых классов или облагаемого не вернули (подарочную карту)."
                    },
                    "exchanged_to_order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Заказ, выданный взамен (обмен); null у обычного возврата."
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "order_item_id": {
                                    "type": "integer",
                                    "description": "ID позиции заказа (items в /v1/orders)."
                                },
                                "quantity": {
                                    "type": "string",
                                    "description": "Количество десятичной строкой в unit: штуки или вся мера весовой или объёмной позиции."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "pcs",
                                        "g",
                                        "ml",
                                        null
                                    ],
                                    "description": "Единица quantity: pcs, g или ml; null, если вариант больше не знает единицу своей меры."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Сумма, возвращённая за позицию."
                                }
                            },
                            "required": [
                                "order_item_id",
                                "quantity",
                                "unit",
                                "amount"
                            ]
                        },
                        "description": "Возвращённые позиции."
                    },
                    "transactions": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID проводки."
                                },
                                "payment_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Платёж заказа, по которому возвращаются деньги; null, если такого платежа нет, например при возврате на баланс."
                                },
                                "method": {
                                    "type": "string",
                                    "enum": [
                                        "cash",
                                        "mercadopago",
                                        "crypto",
                                        "bybit",
                                        "trc20",
                                        "balance",
                                        "modo",
                                        "payway",
                                        "mercadopago_qr",
                                        "mercadopago_point",
                                        "mercadopago_transfer",
                                        "gift_card",
                                        "subscription",
                                        "deposit",
                                        "external",
                                        "manual",
                                        "offset",
                                        "on_account",
                                        "exchange_credit",
                                        "bonpunto",
                                        "service_package"
                                    ],
                                    "description": "Способ оплаты проводки, те же значения, что у method платежа."
                                },
                                "target": {
                                    "type": "string",
                                    "enum": [
                                        "card",
                                        "cash",
                                        "balance",
                                        "gift_card",
                                        "account",
                                        "manual",
                                        "exchange",
                                        "subscription",
                                        "deposit",
                                        "service_package"
                                    ],
                                    "description": "Куда уходят деньги: card — обратно на карту через провайдера; cash — наличными; balance — на баланс покупателя; gift_card — на подарочную карту; account — в счёт долга покупателя; manual — выплачено вручную вне системы; exchange — в заказ обмена; subscription — в подписку; deposit — в депозит."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Сумма проводки."
                                },
                                "status": {
                                    "type": "string",
                                    "enum": [
                                        "pending",
                                        "completed",
                                        "failed",
                                        "reversed"
                                    ],
                                    "description": "pending, completed, failed или reversed — как status возврата."
                                },
                                "provider_refund_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "ID возврата у платёжного провайдера — для сверки с его выпиской; null, если провайдера нет."
                                }
                            },
                            "required": [
                                "id",
                                "payment_id",
                                "method",
                                "target",
                                "amount",
                                "status",
                                "provider_refund_id"
                            ]
                        },
                        "description": "Куда ушли деньги: проводки по платежам заказа."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "order_id",
                    "pos_shift_id",
                    "kind",
                    "status",
                    "app_id",
                    "confirmable",
                    "currency",
                    "amount",
                    "shipping_amount",
                    "tax_lines",
                    "exchanged_to_order_id",
                    "items",
                    "transactions",
                    "created_at",
                    "updated_at"
                ]
            },
            "RefundCalculation": {
                "type": "object",
                "properties": {
                    "order_id": {
                        "type": "integer",
                        "description": "ID заказа."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Сумма, которая вернётся за выбранные позиции и доставку."
                    },
                    "shipping_amount": {
                        "type": "integer",
                        "description": "Часть amount, которая возвращает доставку."
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "order_item_id": {
                                    "type": "integer",
                                    "description": "ID позиции заказа (items в /v1/orders)."
                                },
                                "quantity": {
                                    "type": "string",
                                    "description": "Количество десятичной строкой в unit: штуки или вся мера весовой или объёмной позиции."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "pcs",
                                        "g",
                                        "ml",
                                        null
                                    ],
                                    "description": "Единица quantity: pcs, g или ml; null, если вариант больше не знает единицу своей меры."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Сумма, возвращённая за позицию."
                                }
                            },
                            "required": [
                                "order_item_id",
                                "quantity",
                                "unit",
                                "amount"
                            ]
                        },
                        "description": "Позиции, которые будут возвращены."
                    },
                    "transactions": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "payment_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Платёж заказа, по которому возвращаются деньги; null, если такого платежа нет, например при возврате на баланс."
                                },
                                "method": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "cash",
                                        "mercadopago",
                                        "crypto",
                                        "bybit",
                                        "trc20",
                                        "balance",
                                        "modo",
                                        "payway",
                                        "mercadopago_qr",
                                        "mercadopago_point",
                                        "mercadopago_transfer",
                                        "gift_card",
                                        "subscription",
                                        "deposit",
                                        "external",
                                        "manual",
                                        "offset",
                                        "on_account",
                                        "exchange_credit",
                                        "bonpunto",
                                        "service_package",
                                        null
                                    ],
                                    "description": "Способ оплаты доли; null у доли без платежа."
                                },
                                "target": {
                                    "type": "string",
                                    "enum": [
                                        "card",
                                        "cash",
                                        "balance",
                                        "gift_card",
                                        "account",
                                        "manual",
                                        "exchange",
                                        "subscription",
                                        "deposit",
                                        "service_package"
                                    ],
                                    "description": "Куда уходят деньги: card — обратно на карту через провайдера; cash — наличными; balance — на баланс покупателя; gift_card — на подарочную карту; account — в счёт долга покупателя; manual — выплачено вручную вне системы; exchange — в заказ обмена; subscription — в подписку; deposit — в депозит."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Сумма проводки."
                                }
                            },
                            "required": [
                                "payment_id",
                                "method",
                                "target",
                                "amount"
                            ]
                        },
                        "description": "Куда уйдут деньги: доли по платежам заказа — ровно так, как их проведёт возврат."
                    },
                    "balance_available": {
                        "type": "boolean",
                        "description": "Долю необратимого способа (перевод, крипта, ручной способ) можно вернуть на баланс покупателя — irreversible_to: balance в возврате: такая доля в расчёте есть, у покупателя есть аккаунт, и магазин работает с балансами."
                    },
                    "refundable": {
                        "type": "object",
                        "properties": {
                            "items": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "order_item_id": {
                                            "type": "integer",
                                            "description": "ID позиции заказа (items в /v1/orders)."
                                        },
                                        "quantity": {
                                            "type": "string",
                                            "description": "Сколько ещё можно вернуть, десятичной строкой в unit."
                                        },
                                        "unit": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "enum": [
                                                "pcs",
                                                "g",
                                                "ml",
                                                null
                                            ],
                                            "description": "Единица quantity: pcs, g или ml; null, если вариант больше не знает единицу своей меры."
                                        }
                                    },
                                    "required": [
                                        "order_item_id",
                                        "quantity",
                                        "unit"
                                    ]
                                },
                                "description": "Позиции, по которым ещё есть что вернуть."
                            },
                            "shipping_amount": {
                                "type": "integer",
                                "description": "Сколько доставки ещё можно вернуть."
                            }
                        },
                        "required": [
                            "items",
                            "shipping_amount"
                        ],
                        "description": "Что по заказу ещё можно вернуть: позиции с невозвращённым количеством и остаток доставки. Отменённый возврат его не уменьшает."
                    }
                },
                "required": [
                    "order_id",
                    "currency",
                    "amount",
                    "shipping_amount",
                    "items",
                    "transactions",
                    "balance_available",
                    "refundable"
                ]
            },
            "ReissueFiscalDocumentRequest": {
                "type": "object",
                "properties": {
                    "receptor": {
                        "type": "object",
                        "properties": {
                            "id_type": {
                                "type": "string",
                                "enum": [
                                    "tax_id",
                                    "personal_id",
                                    "national_id",
                                    "passport",
                                    "none"
                                ],
                                "description": "Вид идентификатора: tax_id — налоговый номер организации (CUIT в Аргентине); personal_id — налоговый номер физлица (CUIL); national_id — удостоверение личности (DNI); passport — паспорт; none — без идентификатора."
                            },
                            "id_number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 32,
                                "description": "Номер идентификатора; null, когда id_type — none."
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 255,
                                "description": "Наименование или полное имя для документа; null, если не задано."
                            },
                            "tax_status": {
                                "type": "string",
                                "enum": [
                                    "registered",
                                    "small_taxpayer",
                                    "exempt",
                                    "final_consumer",
                                    "not_categorized",
                                    "foreign"
                                ],
                                "description": "Налоговый статус: registered — плательщик НДС (Responsable Inscripto в Аргентине); small_taxpayer — упрощённый режим (Monotributo); exempt — освобождён от НДС; final_consumer — конечный потребитель; not_categorized — без категории; foreign — иностранный покупатель."
                            },
                            "address": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 255,
                                "description": "Фискальный адрес одной строкой; null, если не задан."
                            }
                        },
                        "description": "Исправленные реквизиты получателя отклонённой фактуры; переписывают и реквизиты заказа. Только у фактуры: ноты наследуют получателя своей фактуры. Не передавайте, если реквизиты не меняются."
                    },
                    "refresh_receptor": {
                        "type": "boolean",
                        "description": "true — перечитать реквизиты из текущего профиля покупателя заказа (PUT /v1/customers/{customer}/fiscal-profile). Вместе с receptor нельзя."
                    }
                }
            },
            "RemovePriceListItemsRequest": {
                "type": "object",
                "properties": {
                    "variant_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "minItems": 1,
                        "maxItems": 1000,
                        "uniqueItems": true,
                        "description": "ID вариантов, ручные цены которых снять, без повторов, до 1000 за запрос. Вариант без ручной цены пропускается."
                    }
                },
                "required": [
                    "variant_ids"
                ]
            },
            "RemovePriceListModifierItemsRequest": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "modifier_option_id": {
                                    "type": "integer",
                                    "description": "ID опции модификатора."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Вариант, надбавку которого снять; null или без поля — надбавку для всех вариантов."
                                }
                            },
                            "required": [
                                "modifier_option_id"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 1000,
                        "description": "Ручные надбавки, которые снять, до 1000 за запрос. Пара без ручной надбавки пропускается."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "ReplaceCustomerFiscalProfileRequest": {
                "type": "object",
                "properties": {
                    "receptor": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id_type": {
                                "type": "string",
                                "enum": [
                                    "tax_id",
                                    "personal_id",
                                    "national_id",
                                    "passport",
                                    "none"
                                ],
                                "description": "Вид идентификатора: tax_id — налоговый номер организации (CUIT в Аргентине); personal_id — налоговый номер физлица (CUIL); national_id — удостоверение личности (DNI); passport — паспорт; none — без идентификатора."
                            },
                            "id_number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 32,
                                "description": "Номер идентификатора; null, когда id_type — none."
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 255,
                                "description": "Наименование или полное имя для документа; null, если не задано."
                            },
                            "tax_status": {
                                "type": "string",
                                "enum": [
                                    "registered",
                                    "small_taxpayer",
                                    "exempt",
                                    "final_consumer",
                                    "not_categorized",
                                    "foreign"
                                ],
                                "description": "Налоговый статус: registered — плательщик НДС (Responsable Inscripto в Аргентине); small_taxpayer — упрощённый режим (Monotributo); exempt — освобождён от НДС; final_consumer — конечный потребитель; not_categorized — без категории; foreign — иностранный покупатель."
                            },
                            "address": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 255,
                                "description": "Фискальный адрес одной строкой; null, если не задан."
                            }
                        },
                        "description": "Реквизиты, под которыми выписываются документы новых заказов; null — розничный покупатель без реквизитов. Оформленный заказ хранит свою копию (fiscal_receptor заказа)."
                    }
                },
                "required": [
                    "receptor"
                ]
            },
            "ReplaceProductModifierGroupsRequest": {
                "type": "object",
                "properties": {
                    "groups": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "group_id": {
                                    "type": "integer",
                                    "description": "ID группы модификаторов (/v1/modifier-groups)."
                                },
                                "selection_rule": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "min_select": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 99,
                                            "description": "Сколько опций обязательно выбрать на этом товаре."
                                        },
                                        "max_select": {
                                            "type": [
                                                "integer",
                                                "null"
                                            ],
                                            "minimum": 1,
                                            "maximum": 99,
                                            "description": "Сколько опций можно выбрать на этом товаре; null — без предела."
                                        }
                                    },
                                    "description": "Правило выбора на этом товаре вместо правила группы; null — правило группы."
                                }
                            },
                            "required": [
                                "group_id"
                            ]
                        },
                        "maxItems": 50,
                        "uniqueItems": true,
                        "description": "Группы модификаторов товара по порядку показа. В записи — набор целиком."
                    },
                    "option_prices": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID опции из групп товара."
                                },
                                "is_available": {
                                    "type": "boolean",
                                    "description": "false — на этом варианте опция не предлагается; надбавки у такой строки нет."
                                },
                                "price_delta": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": -100000000,
                                    "maximum": 100000000,
                                    "description": "Надбавка опции на этом варианте, целым в минорных единицах валюты магазина; null только у недоступной опции."
                                },
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID варианта товара."
                                }
                            },
                            "required": [
                                "option_id",
                                "is_available",
                                "variant_id"
                            ]
                        },
                        "maxItems": 2000,
                        "description": "Надбавка и доступность опций на вариантах товара вместо надбавки опции. В записи заменяет переопределения целиком; без поля прежние остаются, кроме принадлежавших снятым группам."
                    }
                },
                "required": [
                    "groups"
                ]
            },
            "ReplaceProductOptionsRequest": {
                "type": "object",
                "properties": {
                    "options": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "key": {
                                    "type": "string",
                                    "pattern": "^[a-z][a-z0-9_]*$",
                                    "maxLength": 32,
                                    "description": "Машинный ключ опции, уникальный в товаре, например size."
                                },
                                "name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 120
                                    },
                                    "description": "Название опции по языкам."
                                },
                                "values": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "value": {
                                                "type": "object",
                                                "additionalProperties": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ],
                                                    "maxLength": 120
                                                },
                                                "description": "Значение по языкам, например {\"es\": \"Rojo\", \"ru\": \"Красный\"}."
                                            },
                                            "swatch_color": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "pattern": "^#(?:[0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$",
                                                "maxLength": 16,
                                                "description": "Цвет образца, шестнадцатеричный код вида #C0392B; null, если у значения нет образца."
                                            },
                                            "id": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "ID значения. Варианты ссылаются на него в option_values."
                                            }
                                        },
                                        "required": [
                                            "value"
                                        ]
                                    },
                                    "minItems": 1,
                                    "maxItems": 50,
                                    "description": "Значения опции по порядку."
                                },
                                "id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID опции."
                                }
                            },
                            "required": [
                                "key",
                                "name",
                                "values"
                            ]
                        },
                        "maxItems": 10,
                        "description": "Опции, которыми различаются варианты, например размер или цвет, по порядку."
                    },
                    "variants": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID варианта."
                                },
                                "archive": {
                                    "type": "boolean",
                                    "description": "true — отправить вариант в архив вместо значений."
                                },
                                "value_indexes": {
                                    "type": "array",
                                    "items": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 49
                                    },
                                    "maxItems": 10,
                                    "description": "Значения варианта: для каждой опции — индекс значения в options[i].values этого запроса, так называются и новые значения без id."
                                }
                            },
                            "required": [
                                "id"
                            ]
                        },
                        "maxItems": 200,
                        "description": "Раскладка каждого живого варианта товара: комбинация значений или архив. Вариант, которого нет в раскладке, — отказ: его могли создать после того, как вы прочитали товар."
                    }
                },
                "required": [
                    "options",
                    "variants"
                ]
            },
            "ReplaceVariantRecipeRequest": {
                "type": "object",
                "properties": {
                    "components": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "variant_id": {
                                    "type": "integer",
                                    "description": "Id варианта-компонента: сырья или заготовки магазина."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Закладка компонента на порцию блюда или на партию заготовки, десятичной строкой в единице компонента (stock_unit его товара); null — по вкусу: компонент в составе, но не списывается."
                                },
                                "measure_mode": {
                                    "type": "string",
                                    "enum": [
                                        "fixed",
                                        "captured",
                                        "proportional",
                                        "by_output"
                                    ],
                                    "description": "Как производство замеряет компонент: fixed — по плану; captured — взвешивается при производстве; proportional — пересчитывается от взвешенного. Читает только производство заготовок."
                                }
                            },
                            "required": [
                                "variant_id",
                                "quantity"
                            ]
                        },
                        "maxItems": 100,
                        "description": "Состав по порядку: сырьё и заготовки с закладкой. Список целиком заменяет тех-карту, пустой список очищает её."
                    },
                    "yield_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Выход одной партии заготовки, десятичной строкой в единице заготовки. Обязателен у заготовки; у блюда — null. Если в шагах производства есть контрольные точки выхода, выход задают они."
                    },
                    "option_recipes": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "Id опции с расходом по блюду из групп модификаторов товара."
                                },
                                "components": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "variant_id": {
                                                "type": "integer",
                                                "description": "ID варианта товара."
                                            },
                                            "quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "maxLength": 32,
                                                "description": "Закладка компонента на одно применение опции, десятичной строкой в единице компонента; null — по вкусу."
                                            }
                                        },
                                        "required": [
                                            "variant_id",
                                            "quantity"
                                        ]
                                    },
                                    "maxItems": 100,
                                    "description": "Что списывает опция, когда её берут к этому варианту: сырьё и заготовки с закладкой."
                                }
                            },
                            "required": [
                                "option_id",
                                "components"
                            ]
                        },
                        "maxItems": 50,
                        "uniqueItems": true,
                        "description": "Закладки опций с расходом по блюду (recipe_per_variant) в этом варианте: блок на каждую такую опцию групп товара. Пустой состав — закладки нет, и на этом варианте опция не предлагается. В записи блок задаёт закладку опции целиком, пустой состав снимает её; опции, которых нет в списке, и раздел без поля не трогаются."
                    }
                },
                "required": [
                    "components"
                ]
            },
            "SetCustomerWholesalePriceListRequest": {
                "type": "object",
                "properties": {
                    "price_list_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Оптовый прайс-лист покупателя; null снимает назначение — оптовые продажи покупателю идут по базовым ценам."
                    }
                },
                "required": [
                    "price_list_id"
                ]
            },
            "SetInventoryLevelRequest": {
                "type": "object",
                "properties": {
                    "variant_id": {
                        "type": "integer",
                        "description": "ID варианта. Вместе с location_id определяет уровень остатка; у пары, которой нет в списке, остаток нулевой."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID точки магазина."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Комментарий движения."
                    },
                    "lot_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Партия, в которую идёт разница, у варианта с учётом партий."
                    },
                    "expires_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Срок годности новой партии, в часовом поясе магазина."
                    },
                    "on_hand": {
                        "type": "string",
                        "pattern": "^-?\\d{1,15}(\\.\\d{1,15})?$",
                        "maxLength": 32,
                        "description": "Физический остаток точки по всем её ячейкам, десятичной строкой в единице варианта. Установка остатка называет и сверяет именно его."
                    },
                    "expected_on_hand": {
                        "type": "string",
                        "pattern": "^-?\\d{1,15}(\\.\\d{1,15})?$",
                        "maxLength": 32,
                        "description": "Физический остаток, от которого вы считали, десятичной строкой. Если остаток с тех пор изменился, запрос получит 409 stock_on_hand_changed и ничего не изменит."
                    }
                },
                "required": [
                    "variant_id",
                    "location_id",
                    "on_hand",
                    "expected_on_hand"
                ]
            },
            "SetOrderShipmentTrackingRequest": {
                "type": "object",
                "properties": {
                    "tracking_number": {
                        "type": "string",
                        "pattern": "^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} .\\/_-]*[\\p{L}\\p{N}])?$",
                        "maxLength": 64,
                        "description": "Номер у службы доставки: буквы и цифры, внутри — пробел, точка, косая черта, дефис и подчёркивание; до 64 символов."
                    },
                    "tracking_url": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uri",
                        "maxLength": 500,
                        "description": "Страница отслеживания у службы, http или https; null или без поля — ссылки нет."
                    },
                    "carrier_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 100,
                        "description": "Название службы, как его увидит покупатель: «Correo Argentino», «OCA»; null или без поля — без названия."
                    }
                },
                "required": [
                    "tracking_number"
                ]
            },
            "SetOrderStatusRequest": {
                "type": "object",
                "properties": {
                    "status": {
                        "type": "string",
                        "maxLength": 50,
                        "description": "Статус заказа: код из списка статусов магазина (/v1/order-statuses). Магазин может добавлять свои статусы; постоянный смысл даёт status_group."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Комментарий к смене, остаётся в истории заказа."
                    },
                    "delivery_failure_reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "customer_absent",
                            "refused",
                            "wrong_address",
                            "no_contact",
                            "other",
                            null
                        ],
                        "description": "При переходе в статус группы delivery_failed — почему: customer_absent — никого нет по адресу; refused — покупатель отказался от заказа; wrong_address — адрес не найден; no_contact — с покупателем не удалось связаться; other — другая причина, объяснённая в comment."
                    }
                },
                "required": [
                    "status"
                ]
            },
            "SetPriceListItemsRequest": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID варианта (/v1/variants). Подарочная карта и программа питания цены точки не имеют."
                                },
                                "price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 10000000000,
                                    "description": "Цена в минорных единицах валюты магазина, больше нуля, — у строки в деньгах магазина: list_price_currency строки null, у новой строки — у варианта."
                                },
                                "compare_at_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 10000000000,
                                    "description": "Цена до скидки в валюте магазина, выше price; null или без поля — без неё. У оптового листа её нет."
                                },
                                "list_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 10000000000,
                                    "description": "Цена в минорных единицах валюты прайса, больше нуля, — у строки в валюте прайса (list_price_currency строки, у новой строки — варианта). Цену в деньгах магазина считает система по курсу."
                                },
                                "list_compare_at_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 10000000000,
                                    "description": "Цена до скидки в валюте прайса, выше list_price; null или без поля — без неё. У оптового листа её нет."
                                }
                            },
                            "required": [
                                "variant_id"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 1000,
                        "uniqueItems": true,
                        "description": "Ручные цены, до 1000 за запрос, вариант — один раз. Строка, которая уже есть, получает новую цену; пачка пишется целиком или не пишется вовсе."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "SetPriceListModifierItemsRequest": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "modifier_option_id": {
                                    "type": "integer",
                                    "description": "ID опции модификатора (/v1/modifier-groups)."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Вариант, для которого надбавка своя; null или без поля — для всех вариантов позиции. Опцию должна предлагать позиция варианта."
                                },
                                "price_delta": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": -10000000000,
                                    "maximum": 10000000000,
                                    "description": "Надбавка в минорных единицах валюты магазина, может быть отрицательной, — у строки в деньгах магазина: list_price_currency строки null, у новой строки — у опции."
                                },
                                "list_price_delta": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": -10000000000,
                                    "maximum": 10000000000,
                                    "description": "Надбавка в минорных единицах валюты прайса, может быть отрицательной, — у строки в валюте прайса. В деньгах магазина её считает система по курсу."
                                }
                            },
                            "required": [
                                "modifier_option_id"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 1000,
                        "description": "Ручные надбавки, до 1000 за запрос, пара «опция, вариант» — один раз. Строка, которая уже есть, получает новую надбавку; пачка пишется целиком или не пишется вовсе."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "SettlementAgreement": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "bilateral",
                            "tripartite"
                        ],
                        "description": "bilateral — двусторонний зачёт: поставщик и покупатель — одно лицо; tripartite — трёхсторонний: долг покупателя зачитывается в долг магазина перед другим лицом-поставщиком по согласию трёх сторон."
                    },
                    "legal_entity_id": {
                        "type": "integer",
                        "description": "ID юрлица магазина, стороны соглашения (/v1/legal-entities)."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID поставщика-кредитора (/v1/suppliers)."
                    },
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID покупателя-должника (/v1/customers); null, если покупатель стёрт. Только с доступом к покупателям."
                    },
                    "customer_name": {
                        "type": "string",
                        "description": "Имя покупателя на момент заведения соглашения. Только с доступом к покупателям."
                    },
                    "reference": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Номер подписанного соглашения; null, если не указан."
                    },
                    "signed_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Дата подписания, YYYY-MM-DD; null, если не указана."
                    },
                    "valid_from": {
                        "type": "string",
                        "description": "Начало срока действия, YYYY-MM-DD."
                    },
                    "valid_until": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Конец срока действия, YYYY-MM-DD включительно; null — бессрочно."
                    },
                    "schedule": {
                        "type": "string",
                        "enum": [
                            "manual",
                            "weekly",
                            "monthly"
                        ],
                        "description": "Регулярный зачёт: manual — только вручную; weekly — раз в неделю; monthly — раз в месяц."
                    },
                    "schedule_day": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "День прогона: у weekly — день недели ISO (1 — понедельник), у monthly — число месяца 1–31 (в коротком месяце — последнее); null у manual."
                    },
                    "next_run_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Дата следующего регулярного зачёта, YYYY-MM-DD в часовом поясе магазина; null — прогонов не будет."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка сотрудника; null, если её нет."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "kind",
                    "legal_entity_id",
                    "supplier_id",
                    "reference",
                    "signed_on",
                    "valid_from",
                    "valid_until",
                    "schedule",
                    "schedule_day",
                    "next_run_on",
                    "note",
                    "created_at",
                    "updated_at"
                ]
            },
            "SettlementOffset": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "number": {
                        "type": "string",
                        "description": "Номер документа зачёта."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "posted",
                            "voided"
                        ],
                        "description": "posted — проведён; voided — аннулирован: погашения, созданные зачётом, сняты, долги снова открыты."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "bilateral",
                            "tripartite"
                        ],
                        "description": "bilateral — двусторонний зачёт; tripartite — трёхсторонний, по соглашению agreement_id."
                    },
                    "legal_entity_id": {
                        "type": "integer",
                        "description": "ID юрлица магазина, от которого проведён зачёт (/v1/legal-entities)."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID поставщика (/v1/suppliers)."
                    },
                    "agreement_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID соглашения о зачёте (/v1/settlement-agreements); null у двустороннего зачёта без соглашения."
                    },
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID покупателя (/v1/customers); null, если покупатель стёрт. Только с доступом к покупателям."
                    },
                    "customer_name": {
                        "type": "string",
                        "description": "Имя покупателя на момент проведения. Только с доступом к покупателям."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Дата зачёта, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "total": {
                        "type": "integer",
                        "description": "Сумма зачёта: столько зачтено и по долгам покупателя, и по счетам поставщика."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка сотрудника; null, если её нет."
                    },
                    "posted_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда зачёт проведён."
                    },
                    "voided_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда зачёт аннулирован; null у проведённого."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "status",
                    "kind",
                    "legal_entity_id",
                    "supplier_id",
                    "agreement_id",
                    "occurred_on",
                    "total",
                    "currency",
                    "note",
                    "posted_at",
                    "voided_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "SettlementOffsetLine": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "settlement_offset_id": {
                        "type": "integer",
                        "description": "ID взаимозачёта (/v1/settlement-offsets)."
                    },
                    "side": {
                        "type": "string",
                        "enum": [
                            "receivable",
                            "payable"
                        ],
                        "description": "receivable — долг покупателя магазину (заказ или долг по книге долгов); payable — долг магазина поставщику (счёт)."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Позиция при сортировке: меньшая идёт первой."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Зачтённая сумма."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID заказа, долг по которому зачтён (/v1/orders); null у других строк."
                    },
                    "customer_account_entry_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID записи книги долгов вида offset, которой зачёт уменьшил долг покупателя по счёту (/v1/customer-account-entries); null у других строк. Аннулирование пишет её сторно."
                    },
                    "payment_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID платежа заказа, созданного зачётом (/v1/payments); null у других строк и после аннулирования."
                    },
                    "supplier_bill_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID счёта поставщика (/v1/supplier-bills); null у строк покупателя. Если долг по поставке заменён фактурой — фактура."
                    },
                    "supplier_bill_payment_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID оплаты счёта, созданной зачётом (/v1/supplier-bill-payments); null у строк покупателя и после аннулирования."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "settlement_offset_id",
                    "side",
                    "position",
                    "amount",
                    "currency",
                    "order_id",
                    "customer_account_entry_id",
                    "payment_id",
                    "supplier_bill_id",
                    "supplier_bill_payment_id",
                    "created_at",
                    "updated_at"
                ]
            },
            "StockMovement": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "variant_id": {
                        "type": "integer",
                        "description": "ID варианта товара (/v1/variants)."
                    },
                    "location_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID точки движения (/v1/locations); null — движение журнала до точек, его видит только приложение без ограничения точками."
                    },
                    "lot_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID партии (/v1/lots); null — товар без партий."
                    },
                    "quantity": {
                        "type": "string",
                        "description": "Изменение физического остатка точки со знаком, десятичной строкой в единице варианта: больше нуля — пришло, меньше — ушло. Сумма по паре вариант × точка — её on_hand."
                    },
                    "on_hand_after": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Физический остаток точки после движения — тот же, что on_hand уровня остатка, десятичной строкой; null у движения журнала до точек."
                    },
                    "reason": {
                        "type": "string",
                        "enum": [
                            "order_reserve",
                            "order_release",
                            "restock",
                            "refund_restock",
                            "return_restock",
                            "pos_tab_round",
                            "order_edit",
                            "spoilage",
                            "short_pick",
                            "manual_adjust",
                            "shrinkage",
                            "internal_use",
                            "type_change_writeoff",
                            "prep_consumption_writeoff",
                            "unit_merge",
                            "measure_basis_change",
                            "piece_reweigh",
                            "piece_shrinkage",
                            "external_inbound",
                            "external_reconcile",
                            "receipt_void",
                            "receipt_correction",
                            "supplier_return",
                            "supplier_return_void",
                            "supplier_return_correction",
                            "import_revert",
                            "lot_relabel",
                            "stocktake",
                            "bin_transfer",
                            "location_transfer",
                            "group_transfer_out",
                            "group_transfer_in",
                            "group_transfer_return",
                            "production_consume",
                            "production_output",
                            "production_void",
                            "restock_void",
                            "spoilage_void",
                            "shrinkage_void",
                            "internal_use_void",
                            "manual_adjust_void",
                            "short_pick_void"
                        ],
                        "description": "Причина движения — полный перечень склада. Группировать удобнее по category: новая причина приходит в одной из известных граф."
                    },
                    "category": {
                        "type": "string",
                        "enum": [
                            "sale",
                            "receipt",
                            "external",
                            "production_output",
                            "production_consume",
                            "spoilage",
                            "shrinkage",
                            "internal_use",
                            "stocktake",
                            "correction",
                            "supplier_return",
                            "transfer",
                            "group_transfer",
                            "technical"
                        ],
                        "description": "Графа оборотной ведомости: sale — продажа и её возвраты; receipt — приёмка и её сторно; external — импорт и сверка с внешней системой; production_output и production_consume — выпуск и расход производства; spoilage — порча; shrinkage — недостача; internal_use — собственные нужды; stocktake — расхождение ревизии; correction — правка учёта; supplier_return — возврат поставщику; transfer — перекладка и перемещение; group_transfer — перемещение между магазинами группы, по себестоимости; technical — смена единицы учёта."
                    },
                    "document": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "goods_receipt",
                                    "stocktake",
                                    "stock_write_off",
                                    "production_order",
                                    "location_transfer",
                                    "group_transfer",
                                    "supplier_return",
                                    "order"
                                ],
                                "description": "Вид документа: goods_receipt — приёмка (/v1/goods-receipts); stocktake — ревизия (/v1/stocktakes); stock_write_off — акт списания; production_order — производственный акт; location_transfer — перемещение между точками (/v1/location-transfers); group_transfer — перемещение между магазинами группы, своя копия документа; supplier_return — возврат поставщику (/v1/supplier-returns); order — заказ (/v1/orders). Движение заказа внутри акта относится к акту."
                            },
                            "id": {
                                "type": "integer",
                                "description": "ID документа."
                            }
                        },
                        "required": [
                            "type",
                            "id"
                        ],
                        "description": "Первичный документ движения; null — ручная правка, сборка, техническое движение."
                    },
                    "write_off_reason_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID причины списания (/v1/write-off-reasons); у прочих движений null."
                    },
                    "reverses_movement_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID движения, которое это сторнирует; null у обычного движения."
                    },
                    "posting_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Проводка: один UUID у всех движений одной операции; null — движение до проводок."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Комментарий сотрудника к ручной правке; null, если его нет."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    }
                },
                "required": [
                    "id",
                    "variant_id",
                    "location_id",
                    "lot_id",
                    "quantity",
                    "on_hand_after",
                    "reason",
                    "category",
                    "document",
                    "write_off_reason_id",
                    "reverses_movement_id",
                    "posting_id",
                    "comment",
                    "created_at"
                ]
            },
            "Stocktake": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Номер ревизии в магазине."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID точки ревизии (/v1/locations)."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "committing",
                            "committed",
                            "voided"
                        ],
                        "description": "draft — идёт счёт; committing — коррекции пишутся фоном; committed — проведена, коррекции — движения склада с document.type = stocktake; voided — черновик отменён, движений нет. Сбой проведения возвращает ревизию в draft."
                    },
                    "blind": {
                        "type": "boolean",
                        "description": "Слепой счёт: пока ревизия в draft, учёт и расхождение её строк — null."
                    },
                    "coverage": {
                        "type": "object",
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "full",
                                    "category",
                                    "selection"
                                ],
                                "description": "full — вся точка; category — выбранные категории; selection — позиции, набранные в ходе счёта."
                            },
                            "category_ids": {
                                "type": [
                                    "array",
                                    "null"
                                ],
                                "items": {
                                    "type": "integer"
                                },
                                "description": "ID категорий (/v1/categories) у охвата category; у прочих null."
                            }
                        },
                        "required": [
                            "type",
                            "category_ids"
                        ],
                        "description": "Что считают."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка к ревизии; null, если её нет."
                    },
                    "submitted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда счётчик передал ревизию на проведение; null — не передавал."
                    },
                    "committed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда применены коррекции; null — ревизия не проведена."
                    },
                    "voided_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда черновик отменили; null — не отменяли."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "location_id",
                    "status",
                    "blind",
                    "coverage",
                    "note",
                    "submitted_at",
                    "committed_at",
                    "voided_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "StocktakeLine": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "stocktake_id": {
                        "type": "integer",
                        "description": "ID ревизии (/v1/stocktakes)."
                    },
                    "variant_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID варианта товара (/v1/variants). null — позицию стёрли из каталога до того, как строки ревизий стали её удерживать (ноябрь 2026); количеств у такой строки нет."
                    },
                    "lot_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID партии (/v1/lots); null — беспартийная ось. У точки с ячейками у позиции по строке на ячейку и партию — по точке их сумма."
                    },
                    "expected": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Учётный остаток оси на момент счёта, десятичной строкой в единице варианта, — база расхождения. null у слепой ревизии, пока она в draft."
                    },
                    "counted": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Посчитано на оси; null — позицию ещё не посчитали, и проведение такую строку не трогает."
                    },
                    "variance": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Расхождение: counted минус expected. null, пока строка не посчитана или учёт скрыт."
                    },
                    "adjustment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Коррекция, применённая проведением, со знаком. Может отличаться от variance: продажи между счётом и проведением и упаковки фасовки под заказом в неё не входят. null до проведения."
                    },
                    "on_hand_after": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Физический остаток точки по позиции сразу после проведения — у всех строк позиции один. null до проведения и у пропущенной строки."
                    },
                    "skip_reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "variant_deleted",
                            "not_tracked",
                            null
                        ],
                        "description": "Почему проведение пропустило посчитанную строку: variant_deleted — позицию удалили; not_tracked — у позиции выключили учёт остатка. null — строка не пропущена."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "stocktake_id",
                    "variant_id",
                    "lot_id",
                    "expected",
                    "counted",
                    "variance",
                    "adjustment",
                    "on_hand_after",
                    "skip_reason",
                    "created_at",
                    "updated_at"
                ]
            },
            "Store": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID магазина."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Название магазина по языкам."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта магазина, код ISO 4217. Все денежные суммы API — целые числа в её минимальных единицах: центах для USD, ARS или BRL, целых песо для CLP."
                    },
                    "timezone": {
                        "type": "string",
                        "description": "Часовой пояс магазина, имя IANA. Календарные даты API, например reopens_on, — даты в этом поясе."
                    },
                    "country": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Страна магазина, код ISO 3166-1 alpha-2; null, если не задана."
                    },
                    "default_locale": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Основной язык контента магазина; null, если не задан."
                    },
                    "supported_locales": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Языки, на которых магазин заполняет контент."
                    },
                    "marketing_consent_mode": {
                        "type": "string",
                        "enum": [
                            "opt_out",
                            "opt_in"
                        ],
                        "description": "Какое согласие на рассылки магазин считает достаточным: opt_out — все, кто не отписался; opt_in — только покупатели, согласившиеся явно (marketing_consents покупателя). В WhatsApp — в любом режиме только явно согласившиеся."
                    }
                },
                "required": [
                    "id",
                    "name",
                    "currency",
                    "timezone",
                    "country",
                    "default_locale",
                    "supported_locales",
                    "marketing_consent_mode"
                ]
            },
            "Supplier": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    },
                    "name": {
                        "type": "string",
                        "description": "Название поставщика, как его видит магазин."
                    },
                    "legal_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Юридическое наименование; null, если не задано."
                    },
                    "tax_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Налоговый номер, как его ввёл магазин (CUIT в Аргентине); null, если не задан."
                    },
                    "tax_id_country": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Страна налогового номера, ISO 3166-1 alpha-2; null, если номер не задан."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — поставщик выключен: новые заказы ему не делают, документы остаются."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта закупки у поставщика, ISO 4217: в ней min_order_amount и цены его заказов."
                    },
                    "payment_term_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Отсрочка оплаты в днях: из неё считается срок счёта due_on. null — отсрочки нет."
                    },
                    "prices_include_tax": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "true — поставщик называет цены с налогом, false — без налога; null — по правилу магазина."
                    },
                    "settlement_mode": {
                        "type": "string",
                        "enum": [
                            "on_receipt",
                            "on_sale"
                        ],
                        "description": "on_receipt — обычная закупка: долг возникает при приёмке; on_sale — реализация: магазин платит за проданное по акту реализации."
                    },
                    "consignment_loss_policy": {
                        "type": "string",
                        "enum": [
                            "return_to_supplier",
                            "our_cost"
                        ],
                        "description": "Кто платит за просрочку и недостачу товара на реализации: return_to_supplier — товар возвращается поставщику; our_cost — потеря магазина."
                    },
                    "lead_time_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Срок поставки в днях от заказа; null, если не задан."
                    },
                    "min_order_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Минимальная сумма заказа в минимальных единицах currency; null — минимума нет."
                    },
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID того же контрагента как покупателя (/v1/customers): по нему магазин зачитывает встречные долги. null, если связи нет. Только с доступом к покупателям."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "external_id",
                    "name",
                    "legal_name",
                    "tax_id",
                    "tax_id_country",
                    "is_active",
                    "currency",
                    "payment_term_days",
                    "prices_include_tax",
                    "settlement_mode",
                    "consignment_loss_policy",
                    "lead_time_days",
                    "min_order_amount",
                    "created_at",
                    "updated_at"
                ]
            },
            "SupplierBalance": {
                "type": "object",
                "properties": {
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID поставщика (/v1/suppliers)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID юрлица магазина, по которому взят срез; null — по всем юрлицам."
                    },
                    "as_of": {
                        "type": "string",
                        "description": "День магазина, на который разложена просрочка, YYYY-MM-DD."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "total_due": {
                        "type": "integer",
                        "description": "Итог долга: bills_outstanding + settled_pending_bill + accrued_unsettled + received_unbilled − returns_expected − advances_unapplied − payments_unapplied."
                    },
                    "has_open_items": {
                        "type": "boolean",
                        "description": "Есть ли незакрытые позиции: итог может быть нулевым при встречных позициях."
                    },
                    "bills_outstanding": {
                        "type": "integer",
                        "description": "Непогашенные проведённые счета — то, что можно платить сейчас; нота кредита уменьшает."
                    },
                    "overdue": {
                        "type": "integer",
                        "description": "Из bills_outstanding просрочено по сроку оплаты; по возрасту просрочки раскладывается на overdue_1_30, overdue_31_60, overdue_61_90 и overdue_90_plus, в сумме они дают overdue."
                    },
                    "overdue_1_30": {
                        "type": "integer",
                        "description": "Корзина возраста просрочки из overdue; границы в днях календаря магазина — в имени поля."
                    },
                    "overdue_31_60": {
                        "type": "integer",
                        "description": "Корзина возраста просрочки из overdue; границы в днях календаря магазина — в имени поля."
                    },
                    "overdue_61_90": {
                        "type": "integer",
                        "description": "Корзина возраста просрочки из overdue; границы в днях календаря магазина — в имени поля."
                    },
                    "overdue_90_plus": {
                        "type": "integer",
                        "description": "Последняя корзина возраста просрочки из overdue: всё, что старше overdue_61_90."
                    },
                    "not_due": {
                        "type": "integer",
                        "description": "Из bills_outstanding срок ещё не наступил (сегодня и позже)."
                    },
                    "due_soon": {
                        "type": "integer",
                        "description": "Из not_due к оплате в ближайшую неделю."
                    },
                    "no_due_date": {
                        "type": "integer",
                        "description": "Из bills_outstanding без срока оплаты."
                    },
                    "settled_pending_bill": {
                        "type": "integer",
                        "description": "Признано актом реализации, проведённого счёта ещё нет."
                    },
                    "accrued_unsettled": {
                        "type": "integer",
                        "description": "Продано по реализации и ещё не сведено актом."
                    },
                    "received_unbilled": {
                        "type": "integer",
                        "description": "Принято по поставкам, которые не покрыл ни один проведённый счёт: долг без документа."
                    },
                    "returns_expected": {
                        "type": "integer",
                        "description": "Встречное требование по отгруженным возвратам, ещё не компенсированным; уменьшает долг."
                    },
                    "advances_unapplied": {
                        "type": "integer",
                        "description": "Авансы по заказам поставщику, ещё не зачтённые в счета; уменьшают долг."
                    },
                    "payments_unapplied": {
                        "type": "integer",
                        "description": "Выплаты из журнала денег, ещё не зачтённые в счета, за вычетом денег, которые вернул поставщик; уменьшают долг."
                    }
                },
                "required": [
                    "supplier_id",
                    "legal_entity_id",
                    "as_of",
                    "currency",
                    "total_due",
                    "has_open_items",
                    "bills_outstanding",
                    "overdue",
                    "overdue_1_30",
                    "overdue_31_60",
                    "overdue_61_90",
                    "overdue_90_plus",
                    "not_due",
                    "due_soon",
                    "no_due_date",
                    "settled_pending_bill",
                    "accrued_unsettled",
                    "received_unbilled",
                    "returns_expected",
                    "advances_unapplied",
                    "payments_unapplied"
                ]
            },
            "SupplierBill": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "invoice",
                            "debit_note",
                            "credit_note"
                        ],
                        "description": "invoice — фактура; debit_note — нота дебета: увеличивает долг; credit_note — нота кредита: уменьшает долг (возврат, скидка, исправление). Суммы документа всегда положительные, знак задаёт kind."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "posted",
                            "void"
                        ],
                        "description": "draft — черновик: в учёт не входит; posted — проведён: входит в кредиторку и книгу покупок и не меняется; void — аннулирован: не входит никуда."
                    },
                    "fiscal": {
                        "type": "boolean",
                        "description": "false — долг по поставке без фактуры: реквизитов ARCA нет, в книгу покупок не входит; true — фактура или нота."
                    },
                    "legal_entity_id": {
                        "type": "integer",
                        "description": "ID юрлица магазина-покупателя (/v1/legal-entities)."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID поставщика (/v1/suppliers)."
                    },
                    "related_bill_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID документа, который корректирует нота; null у фактуры и у ноты без ссылки."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Номер документа, как его ввёл магазин; null у долга без фактуры."
                    },
                    "issued_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Дата документа, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "tax_period": {
                        "type": "string",
                        "description": "Налоговый период, в котором документ учтён в книге покупок, YYYY-MM."
                    },
                    "due_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Срок оплаты, YYYY-MM-DD в часовом поясе магазина; null — срок не задан."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта документа, ISO 4217: в ней все суммы, кроме base_total."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Курс валюты документа к валюте магазина десятичной строкой; null у документа в валюте магазина."
                    },
                    "net_taxed": {
                        "type": "integer",
                        "description": "Облагаемая база НДС."
                    },
                    "net_exempt": {
                        "type": "integer",
                        "description": "Освобождённая от НДС сумма."
                    },
                    "net_untaxed": {
                        "type": "integer",
                        "description": "Не облагаемая НДС сумма."
                    },
                    "tax_total": {
                        "type": "integer",
                        "description": "НДС документа."
                    },
                    "perceptions_total": {
                        "type": "integer",
                        "description": "Перцепции: суммы, которые поставщик добавил к оплате в счёт будущих налогов магазина."
                    },
                    "other_taxes_total": {
                        "type": "integer",
                        "description": "Внутренние и прочие налоги документа."
                    },
                    "total": {
                        "type": "integer",
                        "description": "Итог документа: база, налоги и перцепции."
                    },
                    "base_total": {
                        "type": "integer",
                        "description": "Итог в валюте магазина по курсу документа."
                    },
                    "paid_total": {
                        "type": "integer",
                        "description": "Сколько закрыто погашениями в валюте документа: деньгами, зачётом, нотой кредита, авансом, выплатой журнала, вне системы. Любое погашение сдвигает счёт в ленте."
                    },
                    "outstanding": {
                        "type": "integer",
                        "description": "Непогашенная часть в валюте документа: total − paid_total. У ноты кредита — незачтённый кредит; у переплаченного документа отрицательна."
                    },
                    "tax_lines": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "$ref": "#/components/schemas/TaxLine"
                        },
                        "description": "НДС по ставкам: облагаемое, освобождённое и не облагаемое. null — в документе нет налога или ставку облагаемой части не определить."
                    },
                    "additional_taxes": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "perception",
                                        "withholding",
                                        "internal",
                                        "other"
                                    ],
                                    "description": "perception — перцепция: увеличивает сумму к оплате и зачитывается магазином; withholding — удержание: магазин удерживает его при оплате и платит в бюджет, сумма к перечислению уменьшается; internal — внутренние налоги (акцизы); other — прочие."
                                },
                                "regime": {
                                    "type": "string",
                                    "enum": [
                                        "vat",
                                        "income",
                                        "turnover",
                                        "municipal",
                                        "internal",
                                        "social",
                                        "other"
                                    ],
                                    "description": "Какой налог: vat — НДС, income — налог на прибыль, turnover — оборотный (Ingresos Brutos), municipal — муниципальный и другие."
                                },
                                "jurisdiction": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Юрисдикция налога, например провинция Ingresos Brutos; null, если налогу она не нужна."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Сумма налога."
                                },
                                "certificate_number": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Номер справки об удержании или перцепции; null, если её нет."
                                }
                            },
                            "required": [
                                "kind",
                                "regime",
                                "jurisdiction",
                                "amount",
                                "certificate_number"
                            ]
                        },
                        "description": "Налоги сверх НДС: перцепции, удержания, внутренние и прочие. У них в документе только сумма, без базы и ставки."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "description": {
                                    "type": "string",
                                    "description": "Описание строки, как в документе."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID варианта товара (/v1/variants); null у строки не о товаре."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Количество десятичной строкой; null, если не указано."
                                },
                                "unit_amount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Цена за единицу без налога; null, если не указана."
                                },
                                "net_amount": {
                                    "type": "integer",
                                    "description": "Сумма строки без налога."
                                },
                                "tax_kind": {
                                    "type": "string",
                                    "enum": [
                                        "taxed",
                                        "exempt",
                                        "untaxed"
                                    ],
                                    "description": "taxed — облагается по ставке; exempt — освобождено; untaxed — не облагается."
                                },
                                "rate_bps": {
                                    "type": "integer",
                                    "description": "Ставка НДС в базисных пунктах: 2100 — это 21 %."
                                },
                                "tax_amount": {
                                    "type": "integer",
                                    "description": "НДС строки."
                                }
                            },
                            "required": [
                                "description",
                                "variant_id",
                                "quantity",
                                "unit_amount",
                                "net_amount",
                                "tax_kind",
                                "rate_bps",
                                "tax_amount"
                            ]
                        },
                        "description": "Строки документа по порядку; у документа, введённого итогами, строк нет."
                    },
                    "vendor": {
                        "type": "object",
                        "properties": {
                            "tax_id": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Налоговый номер поставщика в документе; null, если не указан."
                            },
                            "legal_name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Наименование поставщика в документе; null, если не указано."
                            }
                        },
                        "required": [
                            "tax_id",
                            "legal_name"
                        ],
                        "description": "Реквизиты поставщика, как они стоят в документе: остаются прежними, если карточку поставщика потом исправили."
                    },
                    "goods_receipt_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID приёмки, которая завела этот долг по поставке; null, если документ заведён не приёмкой."
                    },
                    "goods_receipt_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "ID приёмок, которые покрывает документ (/v1/goods-receipts): поставки, сверенные с фактурой, или поставка долга."
                    },
                    "purchase_order_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "ID заказов поставщику, к которым относится документ (/v1/purchase-orders)."
                    },
                    "supplier_return_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "ID возвратов поставщику, за которые выставлена нота кредита (/v1/supplier-returns)."
                    },
                    "consignment_settlement_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID акта реализации, по которому выставлен документ; null у остальных."
                    },
                    "match_status": {
                        "type": "string",
                        "enum": [
                            "unmatched",
                            "matched",
                            "flagged"
                        ],
                        "description": "Сверка с приёмкой: unmatched — не связан с приёмкой; matched — связан и сходится; flagged — связан и расходится. Оплату не блокирует."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка сотрудника; null, если её нет."
                    },
                    "approved_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда документ одобрен к оплате; null, если не одобрен."
                    },
                    "posted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда документ проведён; null у черновика."
                    },
                    "voided_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда документ аннулирован; null, если не аннулирован."
                    },
                    "ar": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "document_type_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Код типа comprobante ARCA: 001 — фактура A, 006 — фактура B, 011 — фактура C; null, если не указан."
                            },
                            "point_of_sale": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "Точка продаж поставщика (punto de venta); null, если не указана."
                            },
                            "authorization_kind": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "CAE",
                                    "CAEA",
                                    "CAI",
                                    null
                                ],
                                "description": "CAE — электронный документ; CAEA — код, выданный на период; CAI — печатный бланк; null — без авторизации (например, зарубежный документ)."
                            },
                            "authorization_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Код авторизации; null, если не указан."
                            },
                            "authorization_expires_on": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date",
                                "description": "Срок действия кода авторизации, YYYY-MM-DD; null, если не указан."
                            },
                            "verification_status": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "verified",
                                    "rejected",
                                    "unavailable",
                                    "pending",
                                    null
                                ],
                                "description": "Проверка документа в ARCA: verified — подтверждён; rejected — ARCA его не признала; unavailable — проверить не удалось; pending — ждёт проверки; null — не проверялся."
                            },
                            "credit_fiscal_amount": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "Зачитываемая часть НДС при пропорциональном зачёте; null — зачитывается весь налог."
                            },
                            "import": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "kind": {
                                        "type": "string",
                                        "enum": [
                                            "goods",
                                            "services"
                                        ],
                                        "description": "goods — импорт товаров по таможенному оформлению; services — услуги исполнителя из-за рубежа."
                                    },
                                    "customs_declaration": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "Номер таможенного оформления (despacho) импорта товаров; null, если не указан."
                                    },
                                    "document_kind": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "enum": [
                                            "invoice",
                                            "contract",
                                            "other",
                                            null
                                        ],
                                        "description": "Документ исполнителя услуг: invoice — фактура, contract — договор, other — прочее (с описанием); null, если не указан."
                                    },
                                    "document_description": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "Описание документа вида other; null у прочих."
                                    },
                                    "provider_tax_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "Налоговый номер исполнителя в его стране; null, если не указан."
                                    },
                                    "tax_paid_on": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "format": "date",
                                        "description": "Дата уплаты НДС за импорт услуг, YYYY-MM-DD; null, если не указана."
                                    },
                                    "tax_paid_amount": {
                                        "type": [
                                            "integer",
                                            "null"
                                        ],
                                        "description": "Уплаченный НДС за импорт услуг в валюте документа; null, если не указан."
                                    },
                                    "payment_reference": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "Идентификатор платежа налога; null, если не указан."
                                    },
                                    "payment_entity_tax_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "CUIT банка, через который внесён налог; null, если не указан."
                                    }
                                },
                                "required": [
                                    "kind",
                                    "customs_declaration",
                                    "document_kind",
                                    "document_description",
                                    "provider_tax_id",
                                    "tax_paid_on",
                                    "tax_paid_amount",
                                    "payment_reference",
                                    "payment_entity_tax_id"
                                ],
                                "description": "Импорт товаров или услуг — своя раскладка книги импорта ARCA; null у внутреннего документа."
                            }
                        },
                        "required": [
                            "document_type_code",
                            "point_of_sale",
                            "authorization_kind",
                            "authorization_code",
                            "authorization_expires_on",
                            "verification_status",
                            "credit_fiscal_amount",
                            "import"
                        ],
                        "description": "Реквизиты ARCA фактуры или ноты; null у долга по поставке без фактуры."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "kind",
                    "status",
                    "fiscal",
                    "legal_entity_id",
                    "supplier_id",
                    "related_bill_id",
                    "number",
                    "issued_on",
                    "tax_period",
                    "due_on",
                    "currency",
                    "exchange_rate",
                    "net_taxed",
                    "net_exempt",
                    "net_untaxed",
                    "tax_total",
                    "perceptions_total",
                    "other_taxes_total",
                    "total",
                    "base_total",
                    "paid_total",
                    "outstanding",
                    "tax_lines",
                    "additional_taxes",
                    "lines",
                    "vendor",
                    "goods_receipt_id",
                    "goods_receipt_ids",
                    "purchase_order_ids",
                    "supplier_return_ids",
                    "consignment_settlement_id",
                    "match_status",
                    "note",
                    "approved_at",
                    "posted_at",
                    "voided_at",
                    "ar",
                    "created_at",
                    "updated_at"
                ]
            },
            "SupplierBillPayment": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "supplier_bill_id": {
                        "type": "integer",
                        "description": "ID счёта поставщика (/v1/supplier-bills)."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "money",
                            "offset",
                            "credit_note",
                            "advance",
                            "journal",
                            "out_of_band"
                        ],
                        "description": "Чем закрыт долг: money — деньгами с денежного счёта; offset — взаимозачётом встречного долга; credit_note — нотой кредита (строка есть и на фактуре, и на ноте); advance — авансом по заказу поставщику; journal — расходом, уже записанным в журнале денег; out_of_band — оплачено вне системы, без денежного счёта."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Гасимая сумма в валюте счёта поставщика."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта счёта поставщика, ISO 4217."
                    },
                    "withheld_amount": {
                        "type": "integer",
                        "description": "Удержано при оплате в валюте счёта поставщика; поставщику перечислено amount минус withheld_amount."
                    },
                    "money_account_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID денежного счёта (/v1/money-accounts), с которого заплатили; null у оплат без денег магазина."
                    },
                    "account_amount": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Перечислено с денежного счёта, в его валюте, десятичной строкой; null, если денежного счёта нет."
                    },
                    "base_amount": {
                        "type": "integer",
                        "description": "Эквивалент в валюте магазина на дату оплаты."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Курс на дату оплаты десятичной строкой; null, если пересчёта не было."
                    },
                    "paid_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Дата оплаты, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "settlement_offset_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID документа взаимозачёта у вида offset; null у остальных."
                    },
                    "counterpart_bill_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID встречного документа у вида credit_note: у фактуры — нота, у ноты — фактура; null у остальных."
                    },
                    "purchase_order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID заказа поставщику, чей аванс погасил документ, у вида advance; null у остальных."
                    },
                    "money_transaction_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID расхода журнала денег (/v1/money-transactions), зачтённого в счёт, у вида journal; null у остальных. Деньги вида money — движение журнала с source supplier_bill_payment и id этой оплаты."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка сотрудника; null, если её нет."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "supplier_bill_id",
                    "kind",
                    "amount",
                    "currency",
                    "withheld_amount",
                    "money_account_id",
                    "account_amount",
                    "base_amount",
                    "exchange_rate",
                    "paid_on",
                    "settlement_offset_id",
                    "counterpart_bill_id",
                    "purchase_order_id",
                    "money_transaction_id",
                    "note",
                    "created_at",
                    "updated_at"
                ]
            },
            "SupplierReturn": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "number": {
                        "type": "string",
                        "description": "Номер возврата."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "shipped",
                            "closed",
                            "void"
                        ],
                        "description": "draft — черновик: остаток не тронут, строки правятся; shipped — отгружен поставщику: остаток списан, ждём компенсацию; closed — закрыт: компенсация получена или отказ отработан; void — аннулирован: остаток возвращён."
                    },
                    "reason": {
                        "type": "string",
                        "enum": [
                            "defect",
                            "wrong_item",
                            "surplus",
                            "recall",
                            "expiry",
                            "other"
                        ],
                        "description": "Причина возврата: defect — брак; wrong_item — не тот товар; surplus — излишек; recall — отзыв партии; expiry — истёк срок годности; other — другое."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID поставщика (/v1/suppliers)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID юрлица магазина, на которое ждём ноту кредита (/v1/legal-entities); null у старых возвратов."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID точки, откуда уехал товар (/v1/locations)."
                    },
                    "goods_receipt_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID исходной приёмки (/v1/goods-receipts); null — возврат без приёмки, цена из себестоимости."
                    },
                    "purchase_order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID заказа поставщику (/v1/purchase-orders); null без заказа."
                    },
                    "issued_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Дата документа — день в акте сверки и на бумаге, YYYY-MM-DD; null у черновика."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта возврата, ISO 4217: в ней цены строк, subtotal и settled_amount."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Курс валюты возврата к валюте магазина десятичной строкой, снимок на отгрузке; null до отгрузки."
                    },
                    "subtotal": {
                        "type": "integer",
                        "description": "Стоимость строк возврата в валюте возврата."
                    },
                    "base_subtotal": {
                        "type": "integer",
                        "description": "Стоимость строк в валюте магазина по курсу-снимку."
                    },
                    "expected_settlement": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "credit_note",
                            "replacement",
                            "refund",
                            "rejected",
                            "none",
                            null
                        ],
                        "description": "Чего ждём от поставщика, задаётся на отгрузке: credit_note — нота кредита; replacement — замена товаром; refund — деньги; none — без компенсации; null — не задано."
                    },
                    "settlement": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "credit_note",
                            "replacement",
                            "refund",
                            "rejected",
                            "none",
                            null
                        ],
                        "description": "Что получили на закрытии: credit_note — нота кредита; replacement — замена; refund — деньги; rejected — поставщик отказал; none — без компенсации; null — возврат не закрыт."
                    },
                    "settled_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Сколько признал поставщик, в валюте возврата; null — ещё не признано."
                    },
                    "base_settled_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Признанное поставщиком в валюте магазина по курсу-снимку; null — ещё не признано."
                    },
                    "shipped_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда товар отгружен поставщику; null у черновика."
                    },
                    "closed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда возврат закрыт; null у незакрытого."
                    },
                    "voided_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда возврат аннулирован; null у действующего."
                    },
                    "void_reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Почему возврат аннулировали; null у действующего и у старых документов."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка сотрудника; null, если её нет."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID записи, уникальный среди записей своего вида в магазине."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID варианта товара (/v1/variants)."
                                },
                                "lot_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID партии строки (/v1/lots); null — товар без партий."
                                },
                                "goods_receipt_line_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID строки исходной приёмки (lines[].id приёмки), откуда взята цена; null у строки без приёмки."
                                },
                                "purchase_order_line_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID строки заказа поставщику (lines[].id заказа); null без заказа."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Базовая единица количеств строки: pcs — штуки, g — граммы, ml — миллилитры."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Сколько уехало поставщику, десятичной строкой в базовой единице."
                                },
                                "settled_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Сколько из уехавшего признал поставщик."
                                },
                                "unit_cost": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Цена в валюте возврата за cost_per_quantity; null — цены нет."
                                },
                                "cost_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "За какое количество в базовой единице указана цена: \"1000\" у весового товара — за килограмм."
                                },
                                "store_unit_cost_micro": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Та же цена в валюте магазина, в миллионных долях минорной единицы; null — цены нет."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Стоимость уехавшего по цене строки; сумма по строкам — subtotal."
                                },
                                "settled_amount": {
                                    "type": "integer",
                                    "description": "Стоимость признанного поставщиком по цене строки."
                                },
                                "reason": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "defect",
                                        "wrong_item",
                                        "surplus",
                                        "recall",
                                        "expiry",
                                        "other",
                                        null
                                    ],
                                    "description": "Причина строки теми же кодами, что reason документа; null — причина документа."
                                },
                                "note": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Заметка к строке; null, если её нет."
                                }
                            },
                            "required": [
                                "id",
                                "variant_id",
                                "lot_id",
                                "goods_receipt_line_id",
                                "purchase_order_line_id",
                                "unit",
                                "quantity",
                                "settled_quantity",
                                "unit_cost",
                                "cost_per_quantity",
                                "store_unit_cost_micro",
                                "amount",
                                "settled_amount",
                                "reason",
                                "note"
                            ]
                        },
                        "description": "Строки возврата."
                    },
                    "corrections": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID записи, уникальный среди записей своего вида в магазине."
                                },
                                "number": {
                                    "type": "string",
                                    "description": "Номер корректировки."
                                },
                                "reason": {
                                    "type": "string",
                                    "description": "Почему исправили; печатается на акте и видна поставщику."
                                },
                                "subtotal_before": {
                                    "type": "integer",
                                    "description": "subtotal до корректировки."
                                },
                                "subtotal_after": {
                                    "type": "integer",
                                    "description": "subtotal после корректировки."
                                },
                                "lines": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "supplier_return_line_id": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "ID строки возврата (lines[].id); null — корректировка строку сняла."
                                            },
                                            "variant_id": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "ID варианта товара строки (/v1/variants)."
                                            },
                                            "quantity_before": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Количество до корректировки, в базовой единице."
                                            },
                                            "quantity_after": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Количество после корректировки, в базовой единице."
                                            },
                                            "reason_before": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "enum": [
                                                    "defect",
                                                    "wrong_item",
                                                    "surplus",
                                                    "recall",
                                                    "expiry",
                                                    "other",
                                                    null
                                                ],
                                                "description": "Причина строки до корректировки; null — причина документа."
                                            },
                                            "reason_after": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "enum": [
                                                    "defect",
                                                    "wrong_item",
                                                    "surplus",
                                                    "recall",
                                                    "expiry",
                                                    "other",
                                                    null
                                                ],
                                                "description": "Причина строки после корректировки; null — причина документа."
                                            }
                                        },
                                        "required": [
                                            "supplier_return_line_id",
                                            "variant_id",
                                            "quantity_before",
                                            "quantity_after",
                                            "reason_before",
                                            "reason_after"
                                        ]
                                    },
                                    "description": "Исправленные строки: было и стало."
                                },
                                "created_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "Когда корректировку провели."
                                }
                            },
                            "required": [
                                "id",
                                "number",
                                "reason",
                                "subtotal_before",
                                "subtotal_after",
                                "lines",
                                "created_at"
                            ]
                        },
                        "description": "Корректировки отгруженного возврата по порядку."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "status",
                    "reason",
                    "supplier_id",
                    "legal_entity_id",
                    "location_id",
                    "goods_receipt_id",
                    "purchase_order_id",
                    "issued_on",
                    "currency",
                    "exchange_rate",
                    "subtotal",
                    "base_subtotal",
                    "expected_settlement",
                    "settlement",
                    "settled_amount",
                    "base_settled_amount",
                    "shipped_at",
                    "closed_at",
                    "voided_at",
                    "void_reason",
                    "note",
                    "lines",
                    "corrections",
                    "created_at",
                    "updated_at"
                ]
            },
            "SupplierSettlementMode": {
                "type": "string",
                "enum": [
                    "on_receipt",
                    "on_sale"
                ]
            },
            "SupplierStatement": {
                "type": "object",
                "properties": {
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID поставщика (/v1/suppliers)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID юрлица магазина, по которому построен акт; null — по всем юрлицам."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "from": {
                        "type": "string",
                        "description": "Первый день периода, YYYY-MM-DD в часовом поясе магазина; без from в запросе — день первой строки акта."
                    },
                    "to": {
                        "type": "string",
                        "description": "Последний день периода, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "opening_balance": {
                        "type": "integer",
                        "description": "Долг на начало периода: сумма строк до from."
                    },
                    "closing_balance": {
                        "type": "integer",
                        "description": "Долг на конец периода: opening_balance плюс строки периода. На сегодня равен total_due сальдо."
                    },
                    "increase_total": {
                        "type": "integer",
                        "description": "Сумма увеличений долга за период."
                    },
                    "decrease_total": {
                        "type": "integer",
                        "description": "Сумма уменьшений долга за период, положительным числом."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "date": {
                                    "type": "string",
                                    "description": "Дата строки, YYYY-MM-DD в часовом поясе магазина."
                                },
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "bill",
                                        "credit_note",
                                        "payment",
                                        "offset",
                                        "out_of_band_payment",
                                        "journal_payment",
                                        "supplier_refund",
                                        "advance",
                                        "fx_difference",
                                        "unbilled_receipt",
                                        "settlement",
                                        "accrual",
                                        "return_claim"
                                    ],
                                    "description": "bill — проведённая фактура или нота дебета; credit_note — нота кредита; payment — оплата деньгами из карточки счёта; offset — взаимозачёт; out_of_band_payment — оплата вне системы; journal_payment — выплата из журнала денег; supplier_refund — деньги, которые вернул поставщик; advance — аванс по заказу; fx_difference — курсовая разница; unbilled_receipt — поставка без проведённого счёта; settlement — акт реализации без проведённого счёта; accrual — продано и не сведено актом; return_claim — отгруженный возврат без компенсации."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Сумма строки со знаком: плюс — долг вырос, минус — уменьшился."
                                },
                                "balance": {
                                    "type": "integer",
                                    "description": "Долг после строки."
                                },
                                "document": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "type": {
                                            "type": "string",
                                            "enum": [
                                                "supplier_bill",
                                                "money_transaction",
                                                "purchase_order",
                                                "goods_receipt",
                                                "consignment_settlement",
                                                "supplier_return"
                                            ],
                                            "description": "Вид документа: supplier_bill, money_transaction, purchase_order, goods_receipt, consignment_settlement или supplier_return."
                                        },
                                        "id": {
                                            "type": "integer",
                                            "description": "ID документа."
                                        },
                                        "number": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Номер документа; null, если номера нет."
                                        }
                                    },
                                    "required": [
                                        "type",
                                        "id",
                                        "number"
                                    ],
                                    "description": "Документ строки; null у начисленного по реализации."
                                },
                                "supplier_bill_payment_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID оплаты счёта (/v1/supplier-bill-payments) у строки payment; null у остальных."
                                },
                                "money_transaction_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID движения журнала денег (/v1/money-transactions), которым заплачен аванс, у строки advance; null у остальных."
                                },
                                "settlement_offset_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID взаимозачёта (/v1/settlement-offsets) у строки offset; null у остальных."
                                },
                                "document_amount": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "currency": {
                                            "type": "string",
                                            "description": "Валюта документа, ISO 4217."
                                        },
                                        "amount": {
                                            "type": "integer",
                                            "description": "Сумма в минорных единицах валюты документа."
                                        }
                                    },
                                    "required": [
                                        "currency",
                                        "amount"
                                    ],
                                    "description": "Сумма в валюте документа, если она не валюта магазина; null — в валюте магазина."
                                }
                            },
                            "required": [
                                "date",
                                "kind",
                                "amount",
                                "balance",
                                "document",
                                "supplier_bill_payment_id",
                                "money_transaction_id",
                                "settlement_offset_id",
                                "document_amount"
                            ]
                        },
                        "description": "Строки периода по дате: в один день сначала то, что создаёт долг, затем то, что его гасит."
                    }
                },
                "required": [
                    "supplier_id",
                    "legal_entity_id",
                    "currency",
                    "from",
                    "to",
                    "opening_balance",
                    "closing_balance",
                    "increase_total",
                    "decrease_total",
                    "lines"
                ]
            },
            "TaxClass": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Название налогового класса по языкам, как его показывает магазин."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "taxed",
                            "exempt",
                            "untaxed"
                        ],
                        "description": "Природа налога: taxed — облагается по ставке; exempt — освобождён законом; untaxed — вне периметра налога. Фискальные документы различают освобождённое и необлагаемое."
                    },
                    "rate_bps": {
                        "type": "integer",
                        "description": "Ставка в базисных пунктах: 2100 — 21 %. У exempt и untaxed — 0."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "Класс магазина по умолчанию: по нему облагаются товары без своего класса и доставка. Классом по умолчанию бывает не больше одного класса магазина."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "name",
                    "kind",
                    "rate_bps",
                    "is_default",
                    "created_at",
                    "updated_at"
                ]
            },
            "TaxLine": {
                "type": "object",
                "properties": {
                    "regime": {
                        "type": "string",
                        "enum": [
                            "vat",
                            "income",
                            "turnover",
                            "municipal",
                            "internal",
                            "social",
                            "other"
                        ],
                        "description": "Какой налог: vat — налог на добавленную стоимость (IVA); income — на прибыль; turnover — оборотный (Ingresos Brutos); municipal — муниципальный сбор; internal — акциз; social — социальные взносы; other — прочее. Налог продажи — vat: класс налога товара классифицирует НДС."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "taxed",
                            "exempt",
                            "untaxed"
                        ],
                        "description": "taxed — по ставке; exempt — освобождено законом; untaxed — вне периметра налога. У строк exempt и untaxed rate_bps 0 и amount 0: сумма — в base."
                    },
                    "rate_bps": {
                        "type": "integer",
                        "description": "Ставка в базисных пунктах: 2100 — это 21 %."
                    },
                    "base": {
                        "type": "integer",
                        "description": "База налога, без налога. Цены — с налогом: base + amount — сколько покупатель заплатил за эту часть."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Сумма налога. Налог продажи считается по ставке для всего заказа: база к ближайшей единице, налог остатком; позиции и доставка получают доли, поэтому их строки в сумме дают строку заказа."
                    },
                    "jurisdiction": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Провинция или муниципалитет у налогов, которым они нужны (turnover, municipal); иначе null."
                    }
                },
                "required": [
                    "regime",
                    "kind",
                    "rate_bps",
                    "base",
                    "amount",
                    "jurisdiction"
                ]
            },
            "TaxPeriod": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "legal_entity_id": {
                        "type": "integer",
                        "description": "ID юрлица периода."
                    },
                    "regime": {
                        "type": "string",
                        "enum": [
                            "vat",
                            "income",
                            "turnover",
                            "municipal",
                            "internal",
                            "social",
                            "other"
                        ],
                        "description": "Налог периода, вид налоговой строки: vat — НДС (IVA), turnover — оборотный (Ingresos Brutos) и другие."
                    },
                    "period": {
                        "type": "string",
                        "description": "Месяц периода, YYYY-MM."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "open",
                            "closed"
                        ],
                        "description": "closed — отчётность сдана: документы с датой в периоде не меняются, данные окончательны; open — период открыт снова. Месяц без строки открыт."
                    },
                    "closed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда период закрыт; null у открытого."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "legal_entity_id",
                    "regime",
                    "period",
                    "status",
                    "closed_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "TaxWithholding": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID юрлица магазина (/v1/legal-entities), у которого удержали или которое удержало; null, если юрлицо удалено."
                    },
                    "direction": {
                        "type": "string",
                        "enum": [
                            "suffered",
                            "practiced"
                        ],
                        "description": "suffered — удержали у магазина (провайдер расчёта, банк, покупатель-агент): его аванс по налогу; practiced — удержал магазин, заплатив поставщику меньше: обязательство перечислить в бюджет, зачёта не даёт."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "withholding",
                            "perception"
                        ],
                        "description": "withholding — удержание: удержано из выплаты; perception — перцепция: добавлена к сумме к оплате."
                    },
                    "regime": {
                        "type": "string",
                        "enum": [
                            "vat",
                            "income",
                            "turnover",
                            "municipal",
                            "internal",
                            "social",
                            "other"
                        ],
                        "description": "Какой налог удержан: vat — НДС (IVA), income — налог на прибыль (Ganancias), turnover — оборотный (Ingresos Brutos), municipal — муниципальный и другие."
                    },
                    "jurisdiction": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Провинция или муниципалитет у налогов, которым они нужны (turnover, municipal); иначе null."
                    },
                    "credit_regime": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "vat",
                            "income",
                            "turnover",
                            "municipal",
                            "internal",
                            "social",
                            "other",
                            null
                        ],
                        "description": "В какой налог магазин зачитывает удержание; null — зачесть некуда (сумма к возврату) или удержал магазин (practiced)."
                    },
                    "credit_period": {
                        "type": "string",
                        "description": "Месяц зачёта, YYYY-MM: может отличаться от месяца удержания."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Удержанная сумма в минимальных единицах валюты магазина."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта сумм, код ISO 4217: валюта магазина."
                    },
                    "base_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Облагаемая база, с которой удержано, в минимальных единицах валюты; null, если в основании её нет."
                    },
                    "rate_bps": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Ставка в сотых долях процента: 250 — 2,5 %; null, если ставки в основании нет."
                    },
                    "rate_source": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "padron",
                            "default",
                            "manual",
                            "import",
                            null
                        ],
                        "description": "Откуда ставка: padron — падрон налоговой; default — ставка по умолчанию в настройках агента; manual — сумму задал сотрудник; import — ставка с бумаги агента. null, если ставки нет."
                    },
                    "counterparty_tax_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Налоговый номер контрагента: агента, который удержал у магазина, или поставщика, у которого удержал магазин; null, если неизвестен."
                    },
                    "counterparty_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Наименование контрагента на момент удержания — так оно напечатано в сертификате; null, если неизвестно."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Дата удержания, YYYY-MM-DD."
                    },
                    "certificate_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Номер сертификата: у удержанного у магазина — номер бумаги агента, у удержанного магазином — номер из его ряда; null, если сертификата нет."
                    },
                    "source": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "payment_settlement",
                                    "supplier_bill_payment",
                                    "money_transaction",
                                    "statement_line",
                                    "import_row",
                                    "account_payment_withholding"
                                ],
                                "description": "payment_settlement — расчёт провайдера по платежу (id — /v1/payments); supplier_bill_payment — оплата счёта поставщика (id — /v1/supplier-bill-payments); money_transaction — выплата в журнале денег (id — /v1/money-transactions); statement_line — строка банковской выписки; import_row — строка загруженного реестра агента; account_payment_withholding — справка погашения долга покупателя: на неё ссылается запись журнала счёта покупателя полем tax_withholding_id. У трёх последних id — внутренний."
                            },
                            "id": {
                                "type": "integer",
                                "description": "ID записи-источника."
                            }
                        },
                        "required": [
                            "type",
                            "id"
                        ],
                        "description": "Запись, которая провела удержание; null — внесено сотрудником."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Заметка сотрудника; null, если её нет."
                    },
                    "annulled_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда магазин аннулировал свой сертификат: сумма больше не к перечислению, номер остаётся занятым. null у действующей записи."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "legal_entity_id",
                    "direction",
                    "kind",
                    "regime",
                    "jurisdiction",
                    "credit_regime",
                    "credit_period",
                    "amount",
                    "currency",
                    "base_amount",
                    "rate_bps",
                    "rate_source",
                    "counterparty_tax_id",
                    "counterparty_name",
                    "occurred_on",
                    "certificate_number",
                    "source",
                    "note",
                    "annulled_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "UpdateCategoryRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 50000
                        },
                        "description": "Описание по языкам в Markdown (GitHub Flavored): объект заполненных языков."
                    },
                    "slug": {
                        "type": "string",
                        "maxLength": 120,
                        "description": "Адрес категории на витрине, уникальный в магазине."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID родительской категории; null у категории верхнего уровня. Категории приходят плоским списком, дерево строится по этому полю."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Позиция среди соседних категорий: меньшая идёт первой."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false скрывает категорию с витрины."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    }
                }
            },
            "UpdateCustomerAddressRequest": {
                "type": "object",
                "properties": {
                    "label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Название адреса, например «Дом» или «Работа»; null, если не задано."
                    },
                    "street": {
                        "type": "string",
                        "maxLength": 255,
                        "description": "Улица."
                    },
                    "house": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Номер дома."
                    },
                    "apartment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Квартира или офис."
                    },
                    "floor": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 16,
                        "description": "Этаж."
                    },
                    "entrance": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 16,
                        "description": "Подъезд."
                    },
                    "district": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Район."
                    },
                    "postal_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 16,
                        "description": "Почтовый индекс."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Комментарий для курьера, например как пройти; null, если не задан."
                    },
                    "location": {
                        "type": "object",
                        "properties": {
                            "lat": {
                                "type": "number",
                                "minimum": -90,
                                "maximum": 90,
                                "description": "Широта в градусах."
                            },
                            "lng": {
                                "type": "number",
                                "minimum": -180,
                                "maximum": 180,
                                "description": "Долгота в градусах."
                            }
                        },
                        "description": "Точка адреса на карте; null, если адрес перенесён из другой системы и ещё не уточнён."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "Основной адрес покупателя. Когда основной адрес удаляют, основным становится самый свежий."
                    }
                }
            },
            "UpdateCustomerRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "pattern": "\\S",
                        "maxLength": 120,
                        "description": "Имя покупателя; null, если неизвестно."
                    },
                    "language": {
                        "$ref": "#/components/schemas/Locale",
                        "description": "Язык, на котором магазин пишет покупателю: ru, en или es."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id покупателя — его id в вашей системе; null, если не задан. После слияния двух покупателей ID поглощённого тоже находит выжившего; в ответе — основной ID."
                    }
                }
            },
            "UpdateDraftOrderRequest": {
                "type": "object",
                "properties": {
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Покупатель черновика (/v1/customers); null, пока не выбран."
                    },
                    "delivery_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Способ доставки (/v1/delivery-methods); null, пока не выбран."
                    },
                    "address_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Адрес из адресной книги покупателя — для способа с доставкой; null, пока не выбран."
                    },
                    "pickup_location_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Пункт самовывоза для способа самовывоза. Единственный пункт способ берёт сам; из нескольких черновик должен назвать один."
                    },
                    "delivery_slots": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "from": {
                                    "type": "string",
                                    "description": "Начало окна."
                                },
                                "to": {
                                    "type": "string",
                                    "description": "Конец окна."
                                }
                            },
                            "required": [
                                "from",
                                "to"
                            ]
                        },
                        "maxItems": 50,
                        "description": "Окна доставки, выбранные для способа, который работает с окнами."
                    },
                    "delivery_cost_override": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Цена доставки, названная вручную, вместо расчёта способа; null — по правилам способа."
                    },
                    "payment_method": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "cash",
                            "mercadopago",
                            "crypto",
                            "bybit",
                            "trc20",
                            "balance",
                            "modo",
                            "payway",
                            "mercadopago_qr",
                            "mercadopago_point",
                            "mercadopago_transfer",
                            "gift_card",
                            "subscription",
                            "deposit",
                            "external",
                            "manual",
                            "offset",
                            "on_account",
                            "exchange_credit",
                            "bonpunto",
                            "service_package",
                            null
                        ],
                        "description": "Способ оплаты, которым черновик оформится: от него зависят скидки за способ и совместимость с доставкой."
                    },
                    "manual_payment_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "description": "Ручной способ оплаты магазина, когда payment_method — manual; иначе null."
                    },
                    "promocode": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Промокод черновика; null, если нет."
                    },
                    "customer_comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Комментарий покупателя к заказу. Только со scope customers:read."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Внутренняя заметка магазина: уходит в заказ, покупатель её не видит."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID строки в черновике."
                                },
                                "variant_id": {
                                    "type": "integer",
                                    "description": "Вариант строки; null у свободной строки."
                                },
                                "quantity": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "description": "Количество десятичной строкой в unit: штуки у штучной позиции, мера у весовой или объёмной (\"480\" граммов)."
                                },
                                "modifiers": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "option_id": {
                                                "type": "integer",
                                                "description": "ID варианта добавки."
                                            },
                                            "quantity": {
                                                "type": "integer",
                                                "minimum": 1,
                                                "maximum": 99,
                                                "description": "Сколько раз добавка добавлена."
                                            }
                                        },
                                        "required": [
                                            "option_id"
                                        ]
                                    },
                                    "maxItems": 50,
                                    "description": "Добавки строки, например топпинги блюда."
                                }
                            },
                            "required": [
                                "variant_id",
                                "quantity"
                            ]
                        },
                        "maxItems": 200,
                        "uniqueItems": true,
                        "description": "Позиции черновика. Открытый черновик считается живьём по каталогу, скидкам и доставке; закрытый хранит позиции без цен."
                    }
                }
            },
            "UpdateModifierGroupRequest": {
                "type": "object",
                "properties": {
                    "options": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID записи, уникальный среди записей своего вида в магазине."
                                },
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                                },
                                "name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255
                                    },
                                    "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                                },
                                "price_delta": {
                                    "type": "integer",
                                    "minimum": -100000000,
                                    "maximum": 100000000,
                                    "description": "Надбавка к цене позиции за одну порцию опции, целым в минорных единицах валюты магазина; отрицательная — скидка. Товар может задать свою надбавку по варианту."
                                },
                                "max_quantity": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 99,
                                    "description": "Сколько раз можно взять эту опцию в одной позиции; null — без своего предела, держит только max_select группы."
                                },
                                "duration_minutes": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 5,
                                    "maximum": 120,
                                    "description": "На сколько минут опция удлиняет услугу по записи, кратно 5; null — не удлиняет. У позиций других видов не действует."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false — опция выключена и не предлагается."
                                },
                                "is_default": {
                                    "type": "boolean",
                                    "description": "Опция выбрана заранее: витрина и касса отмечают её сразу, обязательную группу без выбора ею заполняет сервер."
                                },
                                "adds_ingredients": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "Меняет ли эта опция состав; null — как у группы (adds_ingredients)."
                                },
                                "recipe_per_variant": {
                                    "type": "boolean",
                                    "description": "Расход зависит от блюда: общего состава нет, закладку задаёт тех-карта каждого варианта (option_recipes); без неё на варианте опция не предлагается."
                                },
                                "nutrition": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "kcal": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 1000000,
                                            "description": "Энергия, ккал."
                                        },
                                        "protein_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Белки, мг."
                                        },
                                        "fat_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Жиры, мг."
                                        },
                                        "carbs_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Углеводы, мг."
                                        }
                                    },
                                    "description": "Пищевая ценность одного применения опции, заявленная магазином: все четыре числа или null — тогда её считает состав опции."
                                },
                                "recipe": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "variant_id": {
                                                "type": "integer",
                                                "description": "ID варианта товара."
                                            },
                                            "quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "maxLength": 32,
                                                "description": "Закладка компонента на одно применение опции, десятичной строкой в единице компонента; null — по вкусу: в составе, но не списывается."
                                            }
                                        },
                                        "required": [
                                            "variant_id",
                                            "quantity"
                                        ]
                                    },
                                    "maxItems": 100,
                                    "description": "Общий состав опции — что она списывает в любом блюде: сырьё и заготовки с закладкой. У опции с расходом по блюду пуст. В записи — список целиком, пустой очищает; без поля состав не трогается."
                                }
                            }
                        },
                        "minItems": 1,
                        "maxItems": 100,
                        "uniqueItems": true,
                        "description": "Опции по порядку показа. В записи — набор целиком: строка находит опцию по id или external_id, у найденной пишутся пришедшие поля, строка без опции — новая и несёт name; опция, которой нет в наборе, уходит в архив и снимается из открытых черновиков заказов."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "min_select": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 99,
                        "description": "Сколько опций покупатель обязан выбрать: 0 — группа необязательна. Товар может задать своё правило (selection_rule)."
                    },
                    "max_select": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 99,
                        "description": "Сколько опций можно выбрать всего, с повторами; null — без предела."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — группа выключена: на товарах её не предлагают."
                    },
                    "adds_ingredients": {
                        "type": "boolean",
                        "description": "Меняют ли опции группы состав блюда; опция без своего состава при true делает состав позиции неизвестным (аллергены)."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    }
                }
            },
            "UpdateMoneyTransactionRequest": {
                "type": "object",
                "properties": {
                    "account_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID денежного счёта движения."
                    },
                    "direction": {
                        "$ref": "#/components/schemas/MoneyTransactionDirection",
                        "description": "income — приход на счёт; expense — расход со счёта."
                    },
                    "account_amount": {
                        "type": "string",
                        "maxLength": 37,
                        "description": "Сумма в валюте счёта, десятичной строкой."
                    },
                    "amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 100000000000000,
                        "description": "Сумма проводки в минимальных единицах валюты магазина, всегда положительная: направление задаёт direction. У счёта в чужой валюте — пересчёт по курсу снимка."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Учётная дата, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Момент движения."
                    },
                    "category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID статьи; null — перевод между счетами или движение без статьи."
                    },
                    "supplier_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID поставщика-контрагента; null, если его нет."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Комментарий к движению, как его записал человек или документ; null, если его нет."
                    }
                }
            },
            "UpdateMoneyTransferRequest": {
                "type": "object",
                "properties": {
                    "from_account_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID денежного счёта, с которого списаны деньги."
                    },
                    "to_account_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID денежного счёта, на который зачислены деньги."
                    },
                    "from_amount": {
                        "type": "string",
                        "maxLength": 37,
                        "description": "Списано со счёта from_account_id в его валюте, десятичной строкой."
                    },
                    "to_amount": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 37,
                        "description": "Зачислено на счёт to_account_id в его валюте, десятичной строкой. В одной валюте равно from_amount: разница — это комиссия fee."
                    },
                    "fee": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 37,
                        "description": "Комиссия перевода в валюте счёта списания, десятичной строкой — расход на системной статье bank_fees; null, если комиссии нет."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Учётная дата перевода, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Момент перевода."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Описание перевода; null, если не задано."
                    }
                }
            },
            "UpdatePriceListRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "description": "Новое имя оптового листа, до 120 символов. У листа точки имя даёт точка — поле отклоняется."
                    },
                    "adjustment_bp": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 50000,
                        "description": "Новый процент в базисных пунктах (1 % = 100): к базовой цене у листа точки, от −9000 до 50000; к себестоимости у оптового, от 0. Без поля — не меняется."
                    },
                    "rounding": {
                        "type": "object",
                        "properties": {
                            "mode": {
                                "$ref": "#/components/schemas/DiscountRoundingMode",
                                "description": "Направление округления: nearest — к ближайшему, up — вверх, down — вниз."
                            },
                            "precision": {
                                "type": "integer",
                                "description": "Разряд округления в знаках мажорных единиц: 2 — до сотых, 0 — до целых, -2 — до сотен. Допустимы разряды из настроек цен магазина и разряд минорной единицы валюты — «без округления»."
                            }
                        },
                        "description": "Новое округление цены по правилу листа — парой mode и precision; без поля — не меняется. Ручные цены и цены позиций на вес и объём не округляются."
                    }
                }
            },
            "UpdateProductMediaRequest": {
                "type": "object",
                "properties": {
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000,
                        "description": "Место в галерее, с нуля."
                    },
                    "is_primary": {
                        "type": "boolean",
                        "description": "Главное фото: витрина показывает его первым."
                    }
                }
            },
            "UpdateProductRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "short_description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 500
                        },
                        "description": "Краткое описание по языкам, простой текст для списков товаров."
                    },
                    "description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 50000
                        },
                        "description": "Описание по языкам в Markdown (GitHub Flavored): объект заполненных языков."
                    },
                    "slug": {
                        "type": "string",
                        "maxLength": 160,
                        "description": "Адрес товара на витрине, уникальный в магазине."
                    },
                    "brand_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID бренда товара; null, если не задан."
                    },
                    "tax_class_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID налогового класса товара (/v1/tax-classes); null — класс магазина по умолчанию. Продажа запоминает ставку позиции: смена класса меняет только будущие продажи."
                    },
                    "category_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "ID категорий товара по возрастанию."
                    },
                    "primary_category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Основная категория из category_ids; null, если основная не выбрана."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false снимает товар с продажи и скрывает его с витрины."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда товар появляется на витрине; null — сразу."
                    },
                    "unpublished_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда товар уходит с витрины; null — остаётся."
                    },
                    "sale_schedule": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "days": {
                                    "type": "array",
                                    "items": {
                                        "type": "integer",
                                        "minimum": 1,
                                        "maximum": 7
                                    },
                                    "minItems": 1,
                                    "maxItems": 7,
                                    "description": "Дни окна по ISO: 1 — понедельник, 7 — воскресенье."
                                },
                                "from": {
                                    "type": "string",
                                    "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$|^24:00$",
                                    "description": "Начало окна, «HH:MM» по часам магазина."
                                },
                                "to": {
                                    "type": "string",
                                    "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$|^24:00$",
                                    "description": "Конец окна, «HH:MM», сам момент не входит; «24:00» — до конца дня. Конец раньше начала — окно через полночь, оно принадлежит дню начала."
                                }
                            },
                            "required": [
                                "days",
                                "from",
                                "to"
                            ]
                        },
                        "maxItems": 14,
                        "description": "Когда позицию можно заказать — окна недели в часовом поясе магазина; null — всегда. Вне окна товар виден и кладётся в корзину, а оформление сверяет расписание со временем исполнения заказа."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    },
                    "variants": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Внешний id варианта — его id в вашей системе: ключ, по которому находится строка."
                                },
                                "sku": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 64,
                                    "description": "Артикул (SKU); null, если не задан."
                                },
                                "name": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255
                                    },
                                    "description": "Название варианта по языкам, например {\"es\": \"Grande\"}."
                                },
                                "price": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Цена за price_per_quantity единиц, целым в минимальных единицах currency."
                                },
                                "track_inventory": {
                                    "type": "boolean",
                                    "description": "Магазин ведёт остаток варианта; false — продаёт без учёта остатка."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false снимает вариант с продажи."
                                },
                                "position": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Позиция среди вариантов товара: меньшая идёт первой."
                                },
                                "list_price": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Цена, как её назначил владелец, в минимальных единицах list_price_currency; null — цена назначена в деньгах учёта (price). У такой позиции price считает система по курсу прайса и во входе его не принимает."
                                },
                                "list_price_currency": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "ARS",
                                        "USD",
                                        "BRL",
                                        "CLP",
                                        "COP",
                                        "MXN",
                                        "PEN",
                                        "RUB",
                                        null
                                    ],
                                    "description": "Валюта назначенной цены (прайс магазина в чужой валюте); null — цена в валюте магазина currency. Во входе — валюта прайса магазина или currency."
                                },
                                "compare_at_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "maximum": 10000000000,
                                    "description": "Цена до скидки, показывается зачёркнутой; null, если скидки нет."
                                },
                                "weight_grams": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Вес для доставки в граммах; null, если не задан."
                                },
                                "length_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Длина упаковки в миллиметрах; null, если не задана."
                                },
                                "width_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Ширина упаковки в миллиметрах; null, если не задана."
                                },
                                "height_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Высота упаковки в миллиметрах; null, если не задана."
                                },
                                "sale_starts_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Когда начинается распродажа: compare_at_price показывается с этого момента; null — без начала."
                                },
                                "sale_ends_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Когда распродажа заканчивается; null — без конца."
                                },
                                "sold_by": {
                                    "type": "string",
                                    "enum": [
                                        "each",
                                        "weight",
                                        "volume"
                                    ],
                                    "description": "Как продаётся вариант: each — поштучно; weight — на вес; volume — на объём."
                                },
                                "price_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "За сколько единиц цена, десятичной строкой: за одну штуку или за 1000 — цена килограмма у весового варианта. null, если у весового или объёмного варианта она не задана."
                                },
                                "measure_step": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Шаг количества в строке весового или объёмного варианта, в его единице; null, если не задан."
                                },
                                "min_measure_qty": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Наименьшее количество в строке весового или объёмного варианта; null, если не задано."
                                },
                                "max_measure_qty": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Наибольшее количество в строке весового или объёмного варианта; null, если не задано."
                                },
                                "net_content": {
                                    "type": "object",
                                    "properties": {
                                        "quantity": {
                                            "type": "string",
                                            "maxLength": 32,
                                            "description": "Мера десятичной строкой в unit: \"500\", \"0.5\"."
                                        },
                                        "unit": {
                                            "type": "string",
                                            "enum": [
                                                "g",
                                                "ml"
                                            ],
                                            "description": "Единица меры: g — граммы; ml — миллилитры."
                                        }
                                    },
                                    "description": "Мера нетто одной штуки: пачка 500 г, бутылка 1000 мл. У упаковки из нескольких единиц другого варианта выводится из него, у фасованной штуки — из её меры; записать можно только у обычного штучного варианта. null у весового и объёмного и у штуки без меры."
                                },
                                "barcodes": {
                                    "type": [
                                        "array",
                                        "null"
                                    ],
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "type": "string",
                                                "enum": [
                                                    "ean13",
                                                    "ean8",
                                                    "upca",
                                                    "upce",
                                                    "code128",
                                                    "code39",
                                                    "gtin",
                                                    "itf",
                                                    "qr",
                                                    "datamatrix",
                                                    "other"
                                                ],
                                                "description": "Символика: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix или other."
                                            },
                                            "value": {
                                                "type": "string",
                                                "description": "Штрихкод."
                                            },
                                            "is_primary": {
                                                "type": [
                                                    "boolean",
                                                    "null"
                                                ],
                                                "description": "Основной штрихкод варианта: его печатают этикетки и чеки."
                                            }
                                        },
                                        "required": [
                                            "type",
                                            "value"
                                        ]
                                    },
                                    "maxItems": 20,
                                    "description": "Штрихкоды варианта."
                                },
                                "option_values": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "option_id": {
                                                "type": "integer",
                                                "description": "ID опции из options товара."
                                            },
                                            "value_id": {
                                                "type": "integer",
                                                "description": "ID значения из values этой опции."
                                            }
                                        },
                                        "required": [
                                            "option_id",
                                            "value_id"
                                        ]
                                    },
                                    "maxItems": 10,
                                    "description": "Значения опций варианта: по одному значению каждой опции товара."
                                }
                            }
                        },
                        "minItems": 1,
                        "maxItems": 200,
                        "description": "Строки вариантов, записываемые вместе с карточкой. Строка находится по своему external_id: вариант товара с этим ID правится присланными полями, без такого — заводится; неупомянутые варианты не трогаются. Для создания товара нужна хотя бы одна строка с ценой."
                    }
                }
            },
            "UpdateRecommendationRuleRequest": {
                "type": "object",
                "properties": {
                    "source_type": {
                        "$ref": "#/components/schemas/RecommendationRuleSource",
                        "description": "К чему правило: category — к товарам категории и её подкатегорий; collection — к товарам подборки."
                    },
                    "source_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID категории или подборки, к товарам которой правило. У источника правило одно."
                    },
                    "target_collection_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID подборки, товары которой правило предлагает после своих; null — без подборки."
                    },
                    "product_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 20,
                        "uniqueItems": true,
                        "description": "ID товаров, которые правило предлагает, в порядке полки; не больше 20."
                    },
                    "exclusive": {
                        "type": "boolean",
                        "description": "true — «только это правило»: правила ниже и автоподбор полку не добирают; без товаров и подборки скрывает полку."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false выключает правило: оно хранится, но не действует."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Приоритет: правило с меньшим значением применяется раньше."
                    }
                }
            },
            "UpdateSupplierBillRequest": {
                "type": "object",
                "properties": {
                    "kind": {
                        "type": "string",
                        "enum": [
                            "invoice",
                            "debit_note",
                            "credit_note"
                        ],
                        "description": "invoice — фактура; debit_note — нота дебета: увеличивает долг; credit_note — нота кредита: уменьшает долг (возврат, скидка, исправление). Суммы документа всегда положительные, знак задаёт kind."
                    },
                    "fiscal": {
                        "type": "boolean",
                        "description": "false — долг по поставке без фактуры: реквизитов ARCA нет, в книгу покупок не входит; true — фактура или нота."
                    },
                    "legal_entity_id": {
                        "type": "integer",
                        "description": "ID юрлица магазина-покупателя (/v1/legal-entities)."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID поставщика (/v1/suppliers)."
                    },
                    "related_bill_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID документа, который корректирует нота; null у фактуры и у ноты без ссылки."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 20,
                        "description": "Номер документа, как его ввёл магазин; null у долга без фактуры."
                    },
                    "issued_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Дата документа, YYYY-MM-DD в часовом поясе магазина."
                    },
                    "tax_period": {
                        "type": "string",
                        "description": "Налоговый период, в котором документ учтён в книге покупок, YYYY-MM."
                    },
                    "due_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Срок оплаты, YYYY-MM-DD в часовом поясе магазина; null — срок не задан."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Валюта документа, ISO 4217: в ней все суммы, кроме base_total."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "pattern": "^\\d{1,14}(\\.\\d{1,10})?$",
                        "maxLength": 1000000000000,
                        "description": "Курс валюты документа к валюте магазина десятичной строкой; null у документа в валюте магазина."
                    },
                    "net_taxed": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Облагаемая база НДС."
                    },
                    "net_exempt": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Освобождённая от НДС сумма."
                    },
                    "net_untaxed": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Не облагаемая НДС сумма."
                    },
                    "tax_total": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "НДС документа."
                    },
                    "total": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Итог документа: база, налоги и перцепции."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Заметка сотрудника; null, если её нет."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "description": {
                                    "type": "string",
                                    "maxLength": 300,
                                    "description": "Описание строки, как в документе."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID варианта товара (/v1/variants); null у строки не о товаре."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "pattern": "^\\d{1,14}(\\.\\d{1,6})?$",
                                    "minLength": 0,
                                    "maxLength": 1000000000000,
                                    "description": "Количество десятичной строкой; null, если не указано."
                                },
                                "unit_amount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Цена за единицу без налога; null, если не указана."
                                },
                                "net_amount": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Сумма строки без налога."
                                },
                                "tax_kind": {
                                    "type": "string",
                                    "enum": [
                                        "taxed",
                                        "exempt",
                                        "untaxed"
                                    ],
                                    "description": "taxed — облагается по ставке; exempt — освобождено; untaxed — не облагается."
                                },
                                "rate_bps": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000,
                                    "description": "Ставка НДС в базисных пунктах: 2100 — это 21 %."
                                },
                                "tax_amount": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "НДС строки."
                                }
                            },
                            "required": [
                                "description",
                                "net_amount",
                                "tax_kind"
                            ]
                        },
                        "maxItems": 500,
                        "description": "Строки документа по порядку; у документа, введённого итогами, строк нет."
                    },
                    "additional_taxes": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "perception",
                                        "withholding",
                                        "internal",
                                        "other"
                                    ],
                                    "description": "perception — перцепция: увеличивает сумму к оплате и зачитывается магазином; withholding — удержание: магазин удерживает его при оплате и платит в бюджет, сумма к перечислению уменьшается; internal — внутренние налоги (акцизы); other — прочие."
                                },
                                "regime": {
                                    "type": "string",
                                    "enum": [
                                        "vat",
                                        "income",
                                        "turnover",
                                        "municipal",
                                        "internal",
                                        "social",
                                        "other"
                                    ],
                                    "description": "Какой налог: vat — НДС, income — налог на прибыль, turnover — оборотный (Ingresos Brutos), municipal — муниципальный и другие."
                                },
                                "jurisdiction": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "pattern": "^[A-Z]{2}-[A-Z0-9]{1,5}$",
                                    "maxLength": 8,
                                    "description": "Юрисдикция налога, например провинция Ingresos Brutos; null, если налогу она не нужна."
                                },
                                "amount": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Сумма налога."
                                },
                                "certificate_number": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 64,
                                    "description": "Номер справки об удержании или перцепции; null, если её нет."
                                }
                            },
                            "required": [
                                "kind",
                                "regime",
                                "amount"
                            ]
                        },
                        "maxItems": 50,
                        "description": "Налоги сверх НДС: перцепции, удержания, внутренние и прочие. У них в документе только сумма, без базы и ставки."
                    },
                    "goods_receipt_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 100,
                        "description": "ID приёмок, которые покрывает документ (/v1/goods-receipts): поставки, сверенные с фактурой, или поставка долга."
                    },
                    "purchase_order_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 100,
                        "description": "ID заказов поставщику, к которым относится документ (/v1/purchase-orders)."
                    },
                    "supplier_return_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 100,
                        "description": "ID возвратов поставщику, за которые выставлена нота кредита (/v1/supplier-returns)."
                    },
                    "ar": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "document_type_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 3,
                                "description": "Код типа comprobante ARCA: 001 — фактура A, 006 — фактура B, 011 — фактура C; null, если не указан."
                            },
                            "point_of_sale": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "minimum": 0,
                                "maximum": 99999,
                                "description": "Точка продаж поставщика (punto de venta); null, если не указана."
                            },
                            "authorization_kind": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "CAE",
                                    "CAEA",
                                    "CAI",
                                    null
                                ],
                                "description": "CAE — электронный документ; CAEA — код, выданный на период; CAI — печатный бланк; null — без авторизации (например, зарубежный документ)."
                            },
                            "authorization_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 14,
                                "description": "Код авторизации; null, если не указан."
                            },
                            "authorization_expires_on": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date",
                                "description": "Срок действия кода авторизации, YYYY-MM-DD; null, если не указан."
                            },
                            "credit_fiscal_amount": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "minimum": 0,
                                "maximum": 10000000000,
                                "description": "Зачитываемая часть НДС при пропорциональном зачёте; null — зачитывается весь налог."
                            },
                            "import": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "kind": {
                                        "type": "string",
                                        "enum": [
                                            "goods",
                                            "services"
                                        ],
                                        "description": "goods — импорт товаров по таможенному оформлению; services — услуги исполнителя из-за рубежа."
                                    },
                                    "customs_declaration": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 16,
                                        "description": "Номер таможенного оформления (despacho) импорта товаров; null, если не указан."
                                    },
                                    "document_kind": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "enum": [
                                            "invoice",
                                            "contract",
                                            "other",
                                            null
                                        ],
                                        "description": "Документ исполнителя услуг: invoice — фактура, contract — договор, other — прочее (с описанием); null, если не указан."
                                    },
                                    "document_description": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 20,
                                        "description": "Описание документа вида other; null у прочих."
                                    },
                                    "provider_tax_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 20,
                                        "description": "Налоговый номер исполнителя в его стране; null, если не указан."
                                    },
                                    "tax_paid_on": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "format": "date",
                                        "description": "Дата уплаты НДС за импорт услуг, YYYY-MM-DD; null, если не указана."
                                    },
                                    "tax_paid_amount": {
                                        "type": [
                                            "integer",
                                            "null"
                                        ],
                                        "minimum": 0,
                                        "maximum": 10000000000,
                                        "description": "Уплаченный НДС за импорт услуг в валюте документа; null, если не указан."
                                    },
                                    "payment_reference": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 20,
                                        "description": "Идентификатор платежа налога; null, если не указан."
                                    },
                                    "payment_entity_tax_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 11,
                                        "description": "CUIT банка, через который внесён налог; null, если не указан."
                                    }
                                },
                                "description": "Импорт товаров или услуг — своя раскладка книги импорта ARCA; null у внутреннего документа."
                            }
                        },
                        "description": "Реквизиты ARCA фактуры или ноты; null у долга по поставке без фактуры."
                    }
                }
            },
            "UpdateSupplierRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 200,
                        "description": "Название поставщика, как его видит магазин."
                    },
                    "legal_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200,
                        "description": "Юридическое наименование; null, если не задано."
                    },
                    "tax_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Налоговый номер, как его ввёл магазин (CUIT в Аргентине); null, если не задан."
                    },
                    "tax_id_country": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Страна налогового номера, ISO 3166-1 alpha-2; null, если номер не задан."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — поставщик выключен: новые заказы ему не делают, документы остаются."
                    },
                    "payment_term_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 365,
                        "description": "Отсрочка оплаты в днях: из неё считается срок счёта due_on. null — отсрочки нет."
                    },
                    "prices_include_tax": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "true — поставщик называет цены с налогом, false — без налога; null — по правилу магазина."
                    },
                    "settlement_mode": {
                        "$ref": "#/components/schemas/SupplierSettlementMode",
                        "description": "on_receipt — обычная закупка: долг возникает при приёмке; on_sale — реализация: магазин платит за проданное по акту реализации."
                    },
                    "consignment_loss_policy": {
                        "$ref": "#/components/schemas/ConsignmentLossPolicy",
                        "description": "Кто платит за просрочку и недостачу товара на реализации: return_to_supplier — товар возвращается поставщику; our_cost — потеря магазина."
                    },
                    "lead_time_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 365,
                        "description": "Срок поставки в днях от заказа; null, если не задан."
                    },
                    "min_order_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Минимальная сумма заказа в минимальных единицах currency; null — минимума нет."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта закупки у поставщика, ISO 4217: в ней min_order_amount и цены его заказов."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    }
                }
            },
            "UpdateVariantRequest": {
                "type": "object",
                "properties": {
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    },
                    "sku": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Артикул (SKU); null, если не задан."
                    },
                    "name": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название варианта по языкам, например {\"es\": \"Grande\"}."
                    },
                    "price": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Цена за price_per_quantity единиц, целым в минимальных единицах currency."
                    },
                    "track_inventory": {
                        "type": "boolean",
                        "description": "Магазин ведёт остаток варианта; false — продаёт без учёта остатка."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false снимает вариант с продажи."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Позиция среди вариантов товара: меньшая идёт первой."
                    },
                    "list_price": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Цена, как её назначил владелец, в минимальных единицах list_price_currency; null — цена назначена в деньгах учёта (price). У такой позиции price считает система по курсу прайса и во входе его не принимает."
                    },
                    "list_price_currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB",
                            null
                        ],
                        "description": "Валюта назначенной цены (прайс магазина в чужой валюте); null — цена в валюте магазина currency. Во входе — валюта прайса магазина или currency."
                    },
                    "compare_at_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "maximum": 10000000000,
                        "description": "Цена до скидки, показывается зачёркнутой; null, если скидки нет."
                    },
                    "weight_grams": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Вес для доставки в граммах; null, если не задан."
                    },
                    "length_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Длина упаковки в миллиметрах; null, если не задана."
                    },
                    "width_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Ширина упаковки в миллиметрах; null, если не задана."
                    },
                    "height_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Высота упаковки в миллиметрах; null, если не задана."
                    },
                    "sale_starts_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда начинается распродажа: compare_at_price показывается с этого момента; null — без начала."
                    },
                    "sale_ends_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда распродажа заканчивается; null — без конца."
                    },
                    "sold_by": {
                        "type": "string",
                        "enum": [
                            "each",
                            "weight",
                            "volume"
                        ],
                        "description": "Как продаётся вариант: each — поштучно; weight — на вес; volume — на объём."
                    },
                    "price_per_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "За сколько единиц цена, десятичной строкой: за одну штуку или за 1000 — цена килограмма у весового варианта. null, если у весового или объёмного варианта она не задана."
                    },
                    "measure_step": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Шаг количества в строке весового или объёмного варианта, в его единице; null, если не задан."
                    },
                    "min_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Наименьшее количество в строке весового или объёмного варианта; null, если не задано."
                    },
                    "max_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Наибольшее количество в строке весового или объёмного варианта; null, если не задано."
                    },
                    "net_content": {
                        "type": "object",
                        "properties": {
                            "quantity": {
                                "type": "string",
                                "maxLength": 32,
                                "description": "Мера десятичной строкой в unit: \"500\", \"0.5\"."
                            },
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml"
                                ],
                                "description": "Единица меры: g — граммы; ml — миллилитры."
                            }
                        },
                        "description": "Мера нетто одной штуки: пачка 500 г, бутылка 1000 мл. У упаковки из нескольких единиц другого варианта выводится из него, у фасованной штуки — из её меры; записать можно только у обычного штучного варианта. null у весового и объёмного и у штуки без меры."
                    },
                    "barcodes": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string",
                                    "enum": [
                                        "ean13",
                                        "ean8",
                                        "upca",
                                        "upce",
                                        "code128",
                                        "code39",
                                        "gtin",
                                        "itf",
                                        "qr",
                                        "datamatrix",
                                        "other"
                                    ],
                                    "description": "Символика: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix или other."
                                },
                                "value": {
                                    "type": "string",
                                    "description": "Штрихкод."
                                },
                                "is_primary": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "Основной штрихкод варианта: его печатают этикетки и чеки."
                                }
                            },
                            "required": [
                                "type",
                                "value"
                            ]
                        },
                        "maxItems": 20,
                        "description": "Штрихкоды варианта."
                    },
                    "option_values": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID опции из options товара."
                                },
                                "value_id": {
                                    "type": "integer",
                                    "description": "ID значения из values этой опции."
                                }
                            },
                            "required": [
                                "option_id",
                                "value_id"
                            ]
                        },
                        "maxItems": 10,
                        "description": "Значения опций варианта: по одному значению каждой опции товара."
                    },
                    "stock_source_variant_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "У упаковки из нескольких единиц другого варианта — этот вариант. Упаковка продаётся из его остатка, своих уровней остатка у неё нет. null у обычного варианта."
                    },
                    "stock_source_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Сколько базового варианта забирает одна штука упаковки, десятичной строкой в единице базового варианта; null у обычного варианта."
                    }
                }
            },
            "UpdateWebhookEndpointRequest": {
                "type": "object",
                "properties": {
                    "url": {
                        "type": "string",
                        "maxLength": 2048,
                        "description": "HTTPS-адрес, на который уходят доставки."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Описание адреса; null, если не задано."
                    },
                    "enabled_events": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "enum": [
                                "order.created",
                                "order.updated",
                                "order.status_changed",
                                "order.paid",
                                "order.cancelled",
                                "payment.created",
                                "payment.succeeded",
                                "payment.status_changed",
                                "payment.updated",
                                "refund.created",
                                "refund.completed",
                                "refund.status_changed",
                                "refund.updated",
                                "fiscal_document.created",
                                "fiscal_document.updated",
                                "fiscal_document.issued",
                                "fiscal_document.failed",
                                "fiscal_document.annulled",
                                "tax_period.status_changed",
                                "money_transaction.created",
                                "money_transaction.updated",
                                "money_transaction.deleted",
                                "pos_shift.opened",
                                "pos_shift.closed",
                                "pos_shift.updated",
                                "pos_cash_movement.created",
                                "gift_card.created",
                                "gift_card.updated",
                                "gift_card_transaction.created",
                                "customer_account.created",
                                "customer_account.updated",
                                "customer_account_entry.created",
                                "customer_account_entry.updated",
                                "supplier.created",
                                "supplier.updated",
                                "supplier.deleted",
                                "supplier_bill.created",
                                "supplier_bill.updated",
                                "supplier_bill.posted",
                                "supplier_bill.voided",
                                "supplier_bill.deleted",
                                "supplier_bill_payment.created",
                                "supplier_bill_payment.updated",
                                "supplier_bill_payment.deleted",
                                "settlement_agreement.created",
                                "settlement_agreement.updated",
                                "settlement_agreement.deleted",
                                "settlement_offset.created",
                                "settlement_offset.updated",
                                "settlement_offset.voided",
                                "purchase_order.created",
                                "purchase_order.updated",
                                "purchase_order.status_changed",
                                "purchase_order.deleted",
                                "goods_receipt.created",
                                "goods_receipt.updated",
                                "goods_receipt.voided",
                                "supplier_return.created",
                                "supplier_return.updated",
                                "supplier_return.status_changed",
                                "supplier_return.deleted",
                                "consignment_settlement.created",
                                "consignment_settlement.updated",
                                "consignment_settlement.posted",
                                "consignment_settlement.voided",
                                "tax_withholding.created",
                                "tax_withholding.updated",
                                "tax_withholding.annulled",
                                "tax_withholding.deleted",
                                "product.created",
                                "product.updated",
                                "product.deleted",
                                "inventory_level.updated",
                                "stock_movement.created",
                                "stock_movement.updated",
                                "lot.created",
                                "lot.updated",
                                "lot.deleted",
                                "location_transfer.created",
                                "location_transfer.updated",
                                "stocktake.created",
                                "stocktake.status_changed",
                                "stocktake.updated",
                                "customer.created",
                                "customer.updated",
                                "customer.deleted",
                                "customer_group.created",
                                "customer_group.updated",
                                "customer_group.deleted",
                                "price_list.created",
                                "price_list.updated",
                                "price_list.deleted",
                                "bulk_operation.finished"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 93,
                        "uniqueItems": true,
                        "description": "Типы событий, на которые подписан адрес, например order.created; типы — те же, что в GET /v1/events. Тип, scope чтения которого приложение потеряло, не доставляется."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "enabled",
                            "disabled"
                        ],
                        "description": "enabled — доставки идут; disabled — выключен приложением или платформой (disabled_reason)."
                    }
                }
            },
            "Upload": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "file_name": {
                        "type": "string",
                        "description": "Имя файла, данное при начале загрузки."
                    },
                    "size": {
                        "type": "integer",
                        "description": "Размер всего файла в байтах."
                    },
                    "received": {
                        "type": "integer",
                        "description": "Принято байт: смещение следующей части."
                    },
                    "complete": {
                        "type": "boolean",
                        "description": "Файл собран: массовая операция может взять его по id. После этого загрузки больше нет."
                    },
                    "chunk_bytes": {
                        "type": "integer",
                        "description": "Наибольший размер одной части в байтах."
                    },
                    "expires_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "После этого момента незабранная загрузка удаляется."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    }
                },
                "required": [
                    "id",
                    "file_name",
                    "size",
                    "received",
                    "complete",
                    "chunk_bytes",
                    "expires_at",
                    "created_at"
                ]
            },
            "UpsertCategoryRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 50000
                        },
                        "description": "Описание по языкам в Markdown (GitHub Flavored): объект заполненных языков."
                    },
                    "slug": {
                        "type": "string",
                        "maxLength": 120,
                        "description": "Адрес категории на витрине, уникальный в магазине."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID родительской категории; null у категории верхнего уровня. Категории приходят плоским списком, дерево строится по этому полю."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Позиция среди соседних категорий: меньшая идёт первой."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false скрывает категорию с витрины."
                    }
                }
            },
            "UpsertCustomerRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "pattern": "\\S",
                        "maxLength": 120,
                        "description": "Имя покупателя; null, если неизвестно."
                    },
                    "language": {
                        "$ref": "#/components/schemas/Locale",
                        "description": "Язык, на котором магазин пишет покупателю: ru, en или es."
                    },
                    "phone": {
                        "type": "string",
                        "maxLength": 32,
                        "description": "Основной телефон покупателя в формате E.164, например +5491123456789; null, если неизвестен."
                    },
                    "email": {
                        "type": "string",
                        "maxLength": 254,
                        "description": "Email покупателя; null, если неизвестен."
                    }
                }
            },
            "UpsertModifierGroupRequest": {
                "type": "object",
                "properties": {
                    "options": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID записи, уникальный среди записей своего вида в магазине."
                                },
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                                },
                                "name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255
                                    },
                                    "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                                },
                                "price_delta": {
                                    "type": "integer",
                                    "minimum": -100000000,
                                    "maximum": 100000000,
                                    "description": "Надбавка к цене позиции за одну порцию опции, целым в минорных единицах валюты магазина; отрицательная — скидка. Товар может задать свою надбавку по варианту."
                                },
                                "max_quantity": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 99,
                                    "description": "Сколько раз можно взять эту опцию в одной позиции; null — без своего предела, держит только max_select группы."
                                },
                                "duration_minutes": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 5,
                                    "maximum": 120,
                                    "description": "На сколько минут опция удлиняет услугу по записи, кратно 5; null — не удлиняет. У позиций других видов не действует."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false — опция выключена и не предлагается."
                                },
                                "is_default": {
                                    "type": "boolean",
                                    "description": "Опция выбрана заранее: витрина и касса отмечают её сразу, обязательную группу без выбора ею заполняет сервер."
                                },
                                "adds_ingredients": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "Меняет ли эта опция состав; null — как у группы (adds_ingredients)."
                                },
                                "recipe_per_variant": {
                                    "type": "boolean",
                                    "description": "Расход зависит от блюда: общего состава нет, закладку задаёт тех-карта каждого варианта (option_recipes); без неё на варианте опция не предлагается."
                                },
                                "nutrition": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "kcal": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 1000000,
                                            "description": "Энергия, ккал."
                                        },
                                        "protein_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Белки, мг."
                                        },
                                        "fat_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Жиры, мг."
                                        },
                                        "carbs_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Углеводы, мг."
                                        }
                                    },
                                    "description": "Пищевая ценность одного применения опции, заявленная магазином: все четыре числа или null — тогда её считает состав опции."
                                },
                                "recipe": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "variant_id": {
                                                "type": "integer",
                                                "description": "ID варианта товара."
                                            },
                                            "quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "maxLength": 32,
                                                "description": "Закладка компонента на одно применение опции, десятичной строкой в единице компонента; null — по вкусу: в составе, но не списывается."
                                            }
                                        },
                                        "required": [
                                            "variant_id",
                                            "quantity"
                                        ]
                                    },
                                    "maxItems": 100,
                                    "description": "Общий состав опции — что она списывает в любом блюде: сырьё и заготовки с закладкой. У опции с расходом по блюду пуст. В записи — список целиком, пустой очищает; без поля состав не трогается."
                                }
                            }
                        },
                        "minItems": 1,
                        "maxItems": 100,
                        "uniqueItems": true,
                        "description": "Опции по порядку показа. В записи — набор целиком: строка находит опцию по id или external_id, у найденной пишутся пришедшие поля, строка без опции — новая и несёт name; опция, которой нет в наборе, уходит в архив и снимается из открытых черновиков заказов."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "min_select": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 99,
                        "description": "Сколько опций покупатель обязан выбрать: 0 — группа необязательна. Товар может задать своё правило (selection_rule)."
                    },
                    "max_select": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 99,
                        "description": "Сколько опций можно выбрать всего, с повторами; null — без предела."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — группа выключена: на товарах её не предлагают."
                    },
                    "adds_ingredients": {
                        "type": "boolean",
                        "description": "Меняют ли опции группы состав блюда; опция без своего состава при true делает состав позиции неизвестным (аллергены)."
                    }
                }
            },
            "UpsertProductRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "short_description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 500
                        },
                        "description": "Краткое описание по языкам, простой текст для списков товаров."
                    },
                    "description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 50000
                        },
                        "description": "Описание по языкам в Markdown (GitHub Flavored): объект заполненных языков."
                    },
                    "slug": {
                        "type": "string",
                        "maxLength": 160,
                        "description": "Адрес товара на витрине, уникальный в магазине."
                    },
                    "brand_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID бренда товара; null, если не задан."
                    },
                    "tax_class_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID налогового класса товара (/v1/tax-classes); null — класс магазина по умолчанию. Продажа запоминает ставку позиции: смена класса меняет только будущие продажи."
                    },
                    "category_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "ID категорий товара по возрастанию."
                    },
                    "primary_category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Основная категория из category_ids; null, если основная не выбрана."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false снимает товар с продажи и скрывает его с витрины."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда товар появляется на витрине; null — сразу."
                    },
                    "unpublished_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда товар уходит с витрины; null — остаётся."
                    },
                    "sale_schedule": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "days": {
                                    "type": "array",
                                    "items": {
                                        "type": "integer",
                                        "minimum": 1,
                                        "maximum": 7
                                    },
                                    "minItems": 1,
                                    "maxItems": 7,
                                    "description": "Дни окна по ISO: 1 — понедельник, 7 — воскресенье."
                                },
                                "from": {
                                    "type": "string",
                                    "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$|^24:00$",
                                    "description": "Начало окна, «HH:MM» по часам магазина."
                                },
                                "to": {
                                    "type": "string",
                                    "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$|^24:00$",
                                    "description": "Конец окна, «HH:MM», сам момент не входит; «24:00» — до конца дня. Конец раньше начала — окно через полночь, оно принадлежит дню начала."
                                }
                            },
                            "required": [
                                "days",
                                "from",
                                "to"
                            ]
                        },
                        "maxItems": 14,
                        "description": "Когда позицию можно заказать — окна недели в часовом поясе магазина; null — всегда. Вне окна товар виден и кладётся в корзину, а оформление сверяет расписание со временем исполнения заказа."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "goods",
                            "dish",
                            "ingredient",
                            "prep"
                        ],
                        "description": "Вид товара: goods — товар для продажи; dish — блюдо, готовится под заказ; ingredient — сырьё для техкарт; prep — полуфабрикат собственного приготовления; manufactured — продукция собственного производства; meal_program — программа питания по подписке; bundle — набор из других товаров; gift_card — подарочная карта; service — услуга по записи."
                    },
                    "stock_unit": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml",
                                    "pcs"
                                ],
                                "description": "Базовая единица: g — граммы, ml — миллилитры, pcs — штуки. Количества вариантов товара — десятичные строки в этой единице."
                            },
                            "purchase_unit": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 16,
                                "description": "Название тары закупки, например кг или коробка; null — позицию закупают в базовой единице."
                            },
                            "purchase_quantity": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 32,
                                "description": "Сколько базовых единиц в одной таре закупки, десятичной строкой: например, 1000 для килограмма позиции, которую учитывают в граммах."
                            }
                        },
                        "description": "Единица учёта позиции со складом по мере (сырьё, заготовка, производимый товар): в ней остатки, тех-карты и выход. null у товара и блюда — их единица задаётся осью продажи варианта."
                    },
                    "variants": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Внешний id варианта — его id в вашей системе: ключ, по которому находится строка."
                                },
                                "sku": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 64,
                                    "description": "Артикул (SKU); null, если не задан."
                                },
                                "name": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255
                                    },
                                    "description": "Название варианта по языкам, например {\"es\": \"Grande\"}."
                                },
                                "price": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Цена за price_per_quantity единиц, целым в минимальных единицах currency."
                                },
                                "track_inventory": {
                                    "type": "boolean",
                                    "description": "Магазин ведёт остаток варианта; false — продаёт без учёта остатка."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false снимает вариант с продажи."
                                },
                                "position": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Позиция среди вариантов товара: меньшая идёт первой."
                                },
                                "list_price": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Цена, как её назначил владелец, в минимальных единицах list_price_currency; null — цена назначена в деньгах учёта (price). У такой позиции price считает система по курсу прайса и во входе его не принимает."
                                },
                                "list_price_currency": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "ARS",
                                        "USD",
                                        "BRL",
                                        "CLP",
                                        "COP",
                                        "MXN",
                                        "PEN",
                                        "RUB",
                                        null
                                    ],
                                    "description": "Валюта назначенной цены (прайс магазина в чужой валюте); null — цена в валюте магазина currency. Во входе — валюта прайса магазина или currency."
                                },
                                "compare_at_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "maximum": 10000000000,
                                    "description": "Цена до скидки, показывается зачёркнутой; null, если скидки нет."
                                },
                                "weight_grams": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Вес для доставки в граммах; null, если не задан."
                                },
                                "length_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Длина упаковки в миллиметрах; null, если не задана."
                                },
                                "width_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Ширина упаковки в миллиметрах; null, если не задана."
                                },
                                "height_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Высота упаковки в миллиметрах; null, если не задана."
                                },
                                "sale_starts_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Когда начинается распродажа: compare_at_price показывается с этого момента; null — без начала."
                                },
                                "sale_ends_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Когда распродажа заканчивается; null — без конца."
                                },
                                "sold_by": {
                                    "type": "string",
                                    "enum": [
                                        "each",
                                        "weight",
                                        "volume"
                                    ],
                                    "description": "Как продаётся вариант: each — поштучно; weight — на вес; volume — на объём."
                                },
                                "price_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "За сколько единиц цена, десятичной строкой: за одну штуку или за 1000 — цена килограмма у весового варианта. null, если у весового или объёмного варианта она не задана."
                                },
                                "measure_step": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Шаг количества в строке весового или объёмного варианта, в его единице; null, если не задан."
                                },
                                "min_measure_qty": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Наименьшее количество в строке весового или объёмного варианта; null, если не задано."
                                },
                                "max_measure_qty": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Наибольшее количество в строке весового или объёмного варианта; null, если не задано."
                                },
                                "net_content": {
                                    "type": "object",
                                    "properties": {
                                        "quantity": {
                                            "type": "string",
                                            "maxLength": 32,
                                            "description": "Мера десятичной строкой в unit: \"500\", \"0.5\"."
                                        },
                                        "unit": {
                                            "type": "string",
                                            "enum": [
                                                "g",
                                                "ml"
                                            ],
                                            "description": "Единица меры: g — граммы; ml — миллилитры."
                                        }
                                    },
                                    "description": "Мера нетто одной штуки: пачка 500 г, бутылка 1000 мл. У упаковки из нескольких единиц другого варианта выводится из него, у фасованной штуки — из её меры; записать можно только у обычного штучного варианта. null у весового и объёмного и у штуки без меры."
                                },
                                "barcodes": {
                                    "type": [
                                        "array",
                                        "null"
                                    ],
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "type": "string",
                                                "enum": [
                                                    "ean13",
                                                    "ean8",
                                                    "upca",
                                                    "upce",
                                                    "code128",
                                                    "code39",
                                                    "gtin",
                                                    "itf",
                                                    "qr",
                                                    "datamatrix",
                                                    "other"
                                                ],
                                                "description": "Символика: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix или other."
                                            },
                                            "value": {
                                                "type": "string",
                                                "description": "Штрихкод."
                                            },
                                            "is_primary": {
                                                "type": [
                                                    "boolean",
                                                    "null"
                                                ],
                                                "description": "Основной штрихкод варианта: его печатают этикетки и чеки."
                                            }
                                        },
                                        "required": [
                                            "type",
                                            "value"
                                        ]
                                    },
                                    "maxItems": 20,
                                    "description": "Штрихкоды варианта."
                                },
                                "option_values": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "option_id": {
                                                "type": "integer",
                                                "description": "ID опции из options товара."
                                            },
                                            "value_id": {
                                                "type": "integer",
                                                "description": "ID значения из values этой опции."
                                            }
                                        },
                                        "required": [
                                            "option_id",
                                            "value_id"
                                        ]
                                    },
                                    "maxItems": 10,
                                    "description": "Значения опций варианта: по одному значению каждой опции товара."
                                }
                            }
                        },
                        "minItems": 1,
                        "maxItems": 200,
                        "description": "Строки вариантов, записываемые вместе с карточкой. Строка находится по своему external_id: вариант товара с этим ID правится присланными полями, без такого — заводится; неупомянутые варианты не трогаются. Для создания товара нужна хотя бы одна строка с ценой."
                    }
                }
            },
            "UpsertVariantRequest": {
                "type": "object",
                "properties": {
                    "product_id": {
                        "type": "integer",
                        "description": "ID товара."
                    },
                    "sku": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Артикул (SKU); null, если не задан."
                    },
                    "name": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название варианта по языкам, например {\"es\": \"Grande\"}."
                    },
                    "price": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Цена за price_per_quantity единиц, целым в минимальных единицах currency."
                    },
                    "track_inventory": {
                        "type": "boolean",
                        "description": "Магазин ведёт остаток варианта; false — продаёт без учёта остатка."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false снимает вариант с продажи."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Позиция среди вариантов товара: меньшая идёт первой."
                    },
                    "list_price": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Цена, как её назначил владелец, в минимальных единицах list_price_currency; null — цена назначена в деньгах учёта (price). У такой позиции price считает система по курсу прайса и во входе его не принимает."
                    },
                    "list_price_currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB",
                            null
                        ],
                        "description": "Валюта назначенной цены (прайс магазина в чужой валюте); null — цена в валюте магазина currency. Во входе — валюта прайса магазина или currency."
                    },
                    "compare_at_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "maximum": 10000000000,
                        "description": "Цена до скидки, показывается зачёркнутой; null, если скидки нет."
                    },
                    "weight_grams": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Вес для доставки в граммах; null, если не задан."
                    },
                    "length_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Длина упаковки в миллиметрах; null, если не задана."
                    },
                    "width_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Ширина упаковки в миллиметрах; null, если не задана."
                    },
                    "height_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Высота упаковки в миллиметрах; null, если не задана."
                    },
                    "sale_starts_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда начинается распродажа: compare_at_price показывается с этого момента; null — без начала."
                    },
                    "sale_ends_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда распродажа заканчивается; null — без конца."
                    },
                    "sold_by": {
                        "type": "string",
                        "enum": [
                            "each",
                            "weight",
                            "volume"
                        ],
                        "description": "Как продаётся вариант: each — поштучно; weight — на вес; volume — на объём."
                    },
                    "price_per_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "За сколько единиц цена, десятичной строкой: за одну штуку или за 1000 — цена килограмма у весового варианта. null, если у весового или объёмного варианта она не задана."
                    },
                    "measure_step": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Шаг количества в строке весового или объёмного варианта, в его единице; null, если не задан."
                    },
                    "min_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Наименьшее количество в строке весового или объёмного варианта; null, если не задано."
                    },
                    "max_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Наибольшее количество в строке весового или объёмного варианта; null, если не задано."
                    },
                    "net_content": {
                        "type": "object",
                        "properties": {
                            "quantity": {
                                "type": "string",
                                "maxLength": 32,
                                "description": "Мера десятичной строкой в unit: \"500\", \"0.5\"."
                            },
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml"
                                ],
                                "description": "Единица меры: g — граммы; ml — миллилитры."
                            }
                        },
                        "description": "Мера нетто одной штуки: пачка 500 г, бутылка 1000 мл. У упаковки из нескольких единиц другого варианта выводится из него, у фасованной штуки — из её меры; записать можно только у обычного штучного варианта. null у весового и объёмного и у штуки без меры."
                    },
                    "barcodes": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string",
                                    "enum": [
                                        "ean13",
                                        "ean8",
                                        "upca",
                                        "upce",
                                        "code128",
                                        "code39",
                                        "gtin",
                                        "itf",
                                        "qr",
                                        "datamatrix",
                                        "other"
                                    ],
                                    "description": "Символика: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix или other."
                                },
                                "value": {
                                    "type": "string",
                                    "description": "Штрихкод."
                                },
                                "is_primary": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "Основной штрихкод варианта: его печатают этикетки и чеки."
                                }
                            },
                            "required": [
                                "type",
                                "value"
                            ]
                        },
                        "maxItems": 20,
                        "description": "Штрихкоды варианта."
                    },
                    "option_values": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID опции из options товара."
                                },
                                "value_id": {
                                    "type": "integer",
                                    "description": "ID значения из values этой опции."
                                }
                            },
                            "required": [
                                "option_id",
                                "value_id"
                            ]
                        },
                        "maxItems": 10,
                        "description": "Значения опций варианта: по одному значению каждой опции товара."
                    },
                    "stock_source_variant_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "У упаковки из нескольких единиц другого варианта — этот вариант. Упаковка продаётся из его остатка, своих уровней остатка у неё нет. null у обычного варианта."
                    },
                    "stock_source_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Сколько базового варианта забирает одна штука упаковки, десятичной строкой в единице базового варианта; null у обычного варианта."
                    },
                    "sibling_name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Название по языкам единственного варианта товара, который этот запрос делает одним из нескольких: у единственного варианта своего названия нет, у одного из нескольких оно обязательно."
                    }
                }
            },
            "ValidationProblem": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "description": "Машинный тип отказа: стабильный код для ветвления, например insufficient_scope. У каждого типа есть страница в каталоге ошибок."
                    },
                    "title": {
                        "type": "string",
                        "description": "Краткое описание отказа на языке запроса."
                    },
                    "status": {
                        "type": "integer",
                        "description": "HTTP-статус ответа."
                    },
                    "detail": {
                        "type": "string",
                        "description": "Объяснение этого случая на языке запроса."
                    },
                    "errors": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        },
                        "description": "Поля с ошибками: имя поля (вложенные — через точку, например variants.0.price) → сообщения."
                    }
                },
                "required": [
                    "type",
                    "title",
                    "status",
                    "errors"
                ]
            },
            "Variant": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Внешний id — id записи в вашей системе; null, если приложение его не задало. Каждое приложение видит только свои ID."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия карточки товара: варианты правятся под общей версией карточки, поэтому правка любого варианта или карточки сдвигает её."
                    },
                    "product_id": {
                        "type": "integer",
                        "description": "ID товара."
                    },
                    "sku": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Артикул (SKU); null, если не задан."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Название варианта по языкам, например {\"es\": \"Grande\"}."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Позиция среди вариантов товара: меньшая идёт первой."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false снимает вариант с продажи."
                    },
                    "barcodes": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "value": {
                                    "type": "string",
                                    "description": "Штрихкод."
                                },
                                "type": {
                                    "type": "string",
                                    "description": "Символика: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix или other."
                                },
                                "is_primary": {
                                    "type": "boolean",
                                    "description": "Основной штрихкод варианта: его печатают этикетки и чеки."
                                }
                            },
                            "required": [
                                "value",
                                "type",
                                "is_primary"
                            ]
                        },
                        "description": "Штрихкоды варианта."
                    },
                    "option_values": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID опции из options товара."
                                },
                                "value_id": {
                                    "type": "integer",
                                    "description": "ID значения из values этой опции."
                                }
                            },
                            "required": [
                                "option_id",
                                "value_id"
                            ]
                        },
                        "description": "Значения опций варианта: по одному значению каждой опции товара."
                    },
                    "sold_by": {
                        "type": "string",
                        "enum": [
                            "each",
                            "weight",
                            "volume"
                        ],
                        "description": "Как продаётся вариант: each — поштучно; weight — на вес; volume — на объём."
                    },
                    "unit": {
                        "type": "string",
                        "enum": [
                            "pcs",
                            "g",
                            "ml"
                        ],
                        "description": "Единица всех количеств варианта: pcs — штуки; g — граммы; ml — миллилитры."
                    },
                    "quantity_decimals": {
                        "type": "integer",
                        "enum": [
                            0,
                            3
                        ],
                        "description": "Знаков после запятой в количествах варианта: 0 у штучного, 3 у весового и объёмного."
                    },
                    "price": {
                        "type": "integer",
                        "description": "Цена за price_per_quantity единиц, целым в минимальных единицах currency."
                    },
                    "compare_at_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Цена до скидки, показывается зачёркнутой; null, если скидки нет."
                    },
                    "list_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Цена, как её назначил владелец, в минимальных единицах list_price_currency; null — цена назначена в деньгах учёта (price). У такой позиции price считает система по курсу прайса и во входе его не принимает."
                    },
                    "list_price_currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Валюта назначенной цены (прайс магазина в чужой валюте); null — цена в валюте магазина currency. Во входе — валюта прайса магазина или currency."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Валюта цен, код ISO 4217: валюта магазина."
                    },
                    "price_per_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "За сколько единиц цена, десятичной строкой: за одну штуку или за 1000 — цена килограмма у весового варианта. null, если у весового или объёмного варианта она не задана."
                    },
                    "measure_step": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Шаг количества в строке весового или объёмного варианта, в его единице; null, если не задан."
                    },
                    "min_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Наименьшее количество в строке весового или объёмного варианта; null, если не задано."
                    },
                    "max_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Наибольшее количество в строке весового или объёмного варианта; null, если не задано."
                    },
                    "net_content": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "quantity": {
                                "type": "string",
                                "description": "Мера десятичной строкой в unit: \"500\", \"0.5\"."
                            },
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml"
                                ],
                                "description": "Единица меры: g — граммы; ml — миллилитры."
                            }
                        },
                        "required": [
                            "quantity",
                            "unit"
                        ],
                        "description": "Мера нетто одной штуки: пачка 500 г, бутылка 1000 мл. У упаковки из нескольких единиц другого варианта выводится из него, у фасованной штуки — из её меры; записать можно только у обычного штучного варианта. null у весового и объёмного и у штуки без меры."
                    },
                    "sale_starts_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда начинается распродажа: compare_at_price показывается с этого момента; null — без начала."
                    },
                    "sale_ends_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда распродажа заканчивается; null — без конца."
                    },
                    "cost_price_micro": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Себестоимость за cost_per_quantity единиц в миллионных долях минимальной единицы currency: 1,50 USD = 150000000. Только со scope costs:read."
                    },
                    "cost_per_quantity": {
                        "type": "string",
                        "description": "За сколько единиц себестоимость, десятичной строкой: закупочная единица, например 1000 г. Только со scope costs:read."
                    },
                    "track_inventory": {
                        "type": "boolean",
                        "description": "Магазин ведёт остаток варианта; false — продаёт без учёта остатка."
                    },
                    "stock_source_variant_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "У упаковки из нескольких единиц другого варианта — этот вариант. Упаковка продаётся из его остатка, своих уровней остатка у неё нет. null у обычного варианта."
                    },
                    "stock_source_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Сколько базового варианта забирает одна штука упаковки, десятичной строкой в единице базового варианта; null у обычного варианта."
                    },
                    "weight_grams": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Вес для доставки в граммах; null, если не задан."
                    },
                    "length_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Длина упаковки в миллиметрах; null, если не задана."
                    },
                    "width_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Ширина упаковки в миллиметрах; null, если не задана."
                    },
                    "height_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Высота упаковки в миллиметрах; null, если не задана."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда запись отправлена в архив; null у живой записи."
                    }
                },
                "required": [
                    "id",
                    "external_id",
                    "version",
                    "product_id",
                    "sku",
                    "name",
                    "position",
                    "is_active",
                    "barcodes",
                    "option_values",
                    "sold_by",
                    "unit",
                    "quantity_decimals",
                    "price",
                    "compare_at_price",
                    "list_price",
                    "list_price_currency",
                    "currency",
                    "price_per_quantity",
                    "measure_step",
                    "min_measure_qty",
                    "max_measure_qty",
                    "net_content",
                    "sale_starts_at",
                    "sale_ends_at",
                    "track_inventory",
                    "stock_source_variant_id",
                    "stock_source_quantity",
                    "weight_grams",
                    "length_mm",
                    "width_mm",
                    "height_mm",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "VariantRecipe": {
                "type": "object",
                "properties": {
                    "variant_id": {
                        "type": "integer",
                        "description": "Id варианта, которому принадлежит тех-карта: блюдо, заготовка или другая позиция из компонентов."
                    },
                    "product_id": {
                        "type": "integer",
                        "description": "Id товара варианта. Тех-карта версионируется на его карточке: ETag и If-Match несут версию товара."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия карточки товара — счётчик, который сверяет If-Match. Правка тех-карты сдвигает её, тот же состав ещё раз — нет."
                    },
                    "components": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "variant_id": {
                                    "type": "integer",
                                    "description": "Id варианта-компонента: сырья или заготовки магазина."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Закладка компонента на порцию блюда или на партию заготовки, десятичной строкой в единице компонента (stock_unit его товара); null — по вкусу: компонент в составе, но не списывается."
                                },
                                "measure_mode": {
                                    "type": "string",
                                    "enum": [
                                        "fixed",
                                        "captured",
                                        "proportional"
                                    ],
                                    "description": "Как производство замеряет компонент: fixed — по плану; captured — взвешивается при производстве; proportional — пересчитывается от взвешенного. Читает только производство заготовок."
                                }
                            },
                            "required": [
                                "variant_id",
                                "quantity",
                                "measure_mode"
                            ]
                        },
                        "description": "Состав по порядку: сырьё и заготовки с закладкой. Список целиком заменяет тех-карту, пустой список очищает её."
                    },
                    "yield_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Выход одной партии заготовки, десятичной строкой в единице заготовки. Обязателен у заготовки; у блюда — null. Если в шагах производства есть контрольные точки выхода, выход задают они."
                    },
                    "option_recipes": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "Id опции с расходом по блюду из групп модификаторов товара."
                                },
                                "components": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "variant_id": {
                                                "type": "integer",
                                                "description": "ID варианта товара."
                                            },
                                            "quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Закладка компонента на одно применение опции, десятичной строкой в единице компонента; null — по вкусу."
                                            }
                                        },
                                        "required": [
                                            "variant_id",
                                            "quantity"
                                        ]
                                    },
                                    "description": "Что списывает опция, когда её берут к этому варианту: сырьё и заготовки с закладкой."
                                }
                            },
                            "required": [
                                "option_id",
                                "components"
                            ]
                        },
                        "description": "Закладки опций с расходом по блюду (recipe_per_variant) в этом варианте: блок на каждую такую опцию групп товара. Пустой состав — закладки нет, и на этом варианте опция не предлагается. В записи блок задаёт закладку опции целиком, пустой состав снимает её; опции, которых нет в списке, и раздел без поля не трогаются."
                    }
                },
                "required": [
                    "variant_id",
                    "product_id",
                    "version",
                    "components",
                    "yield_quantity",
                    "option_recipes"
                ]
            },
            "WebhookDelivery": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "endpoint_id": {
                        "type": "integer",
                        "description": "ID адреса вебхука."
                    },
                    "event_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID события в GET /v1/events, он же webhook-id доставки; null у тестового события."
                    },
                    "event_type": {
                        "type": "string",
                        "description": "Тип события; ping — тестовое событие."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "succeeded",
                            "failed"
                        ],
                        "description": "pending — ждёт попытки; succeeded — получатель ответил 2xx; failed — повторы исчерпаны."
                    },
                    "attempt_count": {
                        "type": "integer",
                        "description": "Сделано попыток."
                    },
                    "next_attempt_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда следующая попытка; null, если доставка закрыта."
                    },
                    "last_attempt": {
                        "anyOf": [
                            {
                                "$ref": "#/components/schemas/WebhookDeliveryAttempt"
                            },
                            {
                                "type": "null"
                            }
                        ],
                        "description": "Последняя попытка; null до первой. Только в списке."
                    },
                    "attempts": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/WebhookDeliveryAttempt"
                        },
                        "description": "Все попытки по порядку. Только у одной доставки."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "endpoint_id",
                    "event_id",
                    "event_type",
                    "status",
                    "attempt_count",
                    "next_attempt_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "WebhookDeliveryAttempt": {
                "type": "object",
                "properties": {
                    "number": {
                        "type": "integer",
                        "description": "Номер попытки, с 1."
                    },
                    "manual": {
                        "type": "boolean",
                        "description": "Попытка по запросу повтора, а не по расписанию."
                    },
                    "started_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда попытка началась."
                    },
                    "duration_ms": {
                        "type": "integer",
                        "description": "Сколько длилась попытка, в миллисекундах."
                    },
                    "response_status": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "HTTP-статус ответа получателя; null, если ответа не было."
                    },
                    "response_body": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Начало тела ответа получателя; null, если тела не было."
                    },
                    "error": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "invalid_url",
                            "blocked",
                            "dns",
                            "connection",
                            "tls",
                            "timeout",
                            "unreachable",
                            "redirect",
                            "http_error",
                            null
                        ],
                        "description": "Почему попытка не удалась; null, если получатель ответил 2xx. redirect — ответ 3xx, редиректы не выполняются; http_error — другой статус; timeout — ответа не было 10 секунд; tls, connection, dns, unreachable — сеть; blocked — адрес ведёт во внутреннюю сеть; invalid_url — адрес не проходит проверку."
                    }
                },
                "required": [
                    "number",
                    "manual",
                    "started_at",
                    "duration_ms",
                    "response_status",
                    "response_body",
                    "error"
                ]
            },
            "WebhookEndpoint": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match."
                    },
                    "url": {
                        "type": "string",
                        "description": "HTTPS-адрес, на который уходят доставки."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Описание адреса; null, если не задано."
                    },
                    "enabled_events": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Типы событий, на которые подписан адрес, например order.created; типы — те же, что в GET /v1/events. Тип, scope чтения которого приложение потеряло, не доставляется."
                    },
                    "api_version": {
                        "type": "string",
                        "const": "v1",
                        "description": "Версия API, формату которой следует тело доставок; закреплена при создании адреса."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "enabled",
                            "disabled"
                        ],
                        "description": "enabled — доставки идут; disabled — выключен приложением или платформой (disabled_reason)."
                    },
                    "disabled_reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "failing",
                            null
                        ],
                        "description": "Почему платформа выключила адрес: failing — 72 часа доставки шли без единого успеха. null, если адрес включён или его выключило приложение. Включение снимает причину."
                    },
                    "failing_since": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "С какого момента доставки на адрес идут без единого успеха; через 72 часа платформа его выключит. null, если последняя доставка успешна."
                    },
                    "previous_secret_expires_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "После смены секрета доставки до этого момента подписываются ещё и прежним; null, если прежнего секрета нет."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "url",
                    "description",
                    "enabled_events",
                    "api_version",
                    "status",
                    "disabled_reason",
                    "failing_since",
                    "previous_secret_expires_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "WebhookEndpointSecret": {
                "type": "object",
                "properties": {
                    "endpoint_id": {
                        "type": "integer",
                        "description": "ID адреса вебхука."
                    },
                    "secret": {
                        "type": "string",
                        "description": "Секрет подписи по Standard Webhooks: whsec_ и base64 ключа HMAC-SHA256. Храните его только на своём сервере."
                    }
                },
                "required": [
                    "endpoint_id",
                    "secret"
                ]
            },
            "WriteOffReason": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID записи, уникальный среди записей своего вида в магазине."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Название по языкам: объект заполненных языков, например {\"es\": \"Café\", \"ru\": \"Кофе\"}."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "spoilage",
                            "shrinkage",
                            "internal_use"
                        ],
                        "description": "Учётный вид списания: spoilage — товар испорчен или повреждён; shrinkage — товара не хватает; internal_use — магазин потратил товар на свои нужды."
                    },
                    "requires_comment": {
                        "type": "boolean",
                        "description": "Списание с этой причиной требует комментария."
                    },
                    "selectable": {
                        "type": "boolean",
                        "description": "Причину можно указать в новом списании: она не в архиве и не системная, которую пишет только сам магазин."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Позиция при сортировке: меньшая идёт первой."
                    },
                    "archived_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Когда причина отправлена в архив; null у действующей. Архивная причина остаётся в списке: на неё ссылаются прошлые списания."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись создана."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Когда запись менялась последний раз."
                    }
                },
                "required": [
                    "id",
                    "name",
                    "kind",
                    "requires_comment",
                    "selectable",
                    "position",
                    "archived_at",
                    "created_at",
                    "updated_at"
                ]
            }
        },
        "responses": {
            "Unauthenticated": {
                "description": "Токена нет, он неверен, истёк или отозван",
                "headers": {
                    "WWW-Authenticate": {
                        "$ref": "#/components/headers/WwwAuthenticate"
                    },
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            },
            "Forbidden": {
                "description": "Запрос не разрешают тариф, IP-адрес или scopes токена",
                "headers": {
                    "WWW-Authenticate": {
                        "$ref": "#/components/headers/WwwAuthenticateOptional"
                    },
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/ForbiddenProblem"
                        }
                    }
                }
            },
            "NotFound": {
                "description": "Объекта нет или он недоступен приложению",
                "headers": {
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            },
            "Conflict": {
                "description": "Запрос с тем же ключом идемпотентности ещё исполняется, данные изменились после чтения, внешний id у другой записи, исчерпан лимит тарифа или адресов вебхуков, или правке нужно согласие на последствия",
                "headers": {
                    "Retry-After": {
                        "$ref": "#/components/headers/RetryAfterOptional"
                    },
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/ConflictProblem"
                        }
                    }
                }
            },
            "PreconditionFailed": {
                "description": "Запись изменилась после чтения: версия в If-Match не текущая",
                "headers": {
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            },
            "PreconditionRequired": {
                "description": "Запросу нужен If-Match с ETag записи",
                "headers": {
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            },
            "RangeNotSatisfiable": {
                "description": "Диапазон начинается за концом записанного результата",
                "headers": {
                    "Content-Range": {
                        "$ref": "#/components/headers/ContentRange"
                    },
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            },
            "CursorExpired": {
                "description": "Курсор синхронизации старше срока хранения удалений или выдан до восстановления базы",
                "headers": {
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            },
            "ValidationFailed": {
                "description": "Параметр неверен или неизвестен",
                "headers": {
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/ValidationProblem"
                        }
                    }
                }
            },
            "TooManyRequests": {
                "description": "Лимит запросов исчерпан",
                "headers": {
                    "Retry-After": {
                        "$ref": "#/components/headers/RetryAfter"
                    },
                    "RateLimit": {
                        "$ref": "#/components/headers/RateLimit"
                    },
                    "RateLimit-Policy": {
                        "$ref": "#/components/headers/RateLimitPolicy"
                    },
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/RateLimitProblem"
                        }
                    }
                }
            },
            "ServiceUnavailable": {
                "description": "Магазин временно недоступен",
                "headers": {
                    "Retry-After": {
                        "$ref": "#/components/headers/RetryAfterOptional"
                    },
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            }
        },
        "parameters": {
            "AcceptLanguage": {
                "name": "Accept-Language",
                "in": "header",
                "required": false,
                "description": "Язык текстов ошибок: es, en или ru. По умолчанию английский.",
                "schema": {
                    "type": "string",
                    "examples": [
                        "es"
                    ]
                }
            },
            "IdempotencyKey": {
                "name": "Idempotency-Key",
                "in": "header",
                "required": false,
                "description": "Уникальный ключ попытки, например UUID. Повтор с тем же ключом и телом получает сохранённый ответ вместо второй записи. Ключ живёт 24 часа.",
                "schema": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "examples": [
                        "8e03978e-40d5-43e8-bc93-6894a57f9324"
                    ]
                }
            },
            "IdempotencyKeyRequired": {
                "name": "Idempotency-Key",
                "in": "header",
                "required": true,
                "description": "Обязательный ключ попытки, например UUID: дубль этой команды в налоговой не отменить. Повтор с тем же ключом и телом получает сохранённый ответ. Ключ живёт 24 часа.",
                "schema": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "examples": [
                        "8e03978e-40d5-43e8-bc93-6894a57f9324"
                    ]
                }
            },
            "IfMatch": {
                "name": "If-Match",
                "in": "header",
                "required": true,
                "description": "ETag записи из последнего чтения, например \"7\". Правка применится, только если запись с тех пор никто не менял, иначе 412. Без заголовка — 428.",
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"7\""
                    ]
                }
            },
            "IfMatchUpsert": {
                "name": "If-Match",
                "in": "header",
                "required": false,
                "description": "ETag записи из последнего чтения. Обязателен, если запись с этим внешним id уже есть (иначе 428), и не передаётся, если её нет.",
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"7\""
                    ]
                }
            },
            "IfNoneMatch": {
                "name": "If-None-Match",
                "in": "header",
                "required": false,
                "description": "* — только создать: если запись с этим внешним id уже есть, запрос получит 412.",
                "schema": {
                    "type": "string",
                    "enum": [
                        "*"
                    ]
                }
            },
            "Range": {
                "name": "Range",
                "in": "header",
                "required": false,
                "description": "Один диапазон байт для докачки: bytes=<с>- или bytes=<с>-<по>. Результат идущей операции только дописывается: продолжение — bytes=<скачано>- без If-Range, 416 — новых строк пока нет. Несколько диапазонов — ответ целиком.",
                "schema": {
                    "type": "string",
                    "examples": [
                        "bytes=1048576-"
                    ]
                }
            },
            "IfRange": {
                "name": "If-Range",
                "in": "header",
                "required": false,
                "description": "ETag результата из прошлого ответа. Диапазон отдаётся, только если результат с тех пор не дописывался, иначе — целиком (200).",
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"52428800\""
                    ]
                }
            }
        },
        "headers": {
            "RateLimit": {
                "description": "Сколько запросов пройдёт подряд и через сколько секунд корзина снова полна — по каждой политике.",
                "required": true,
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"app\";r=87;t=3, \"store\";r=390;t=1"
                    ]
                }
            },
            "RateLimitPolicy": {
                "description": "Политики лимитов: квота на окно в секундах.",
                "required": true,
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"app\";q=300;w=60, \"store\";q=1200;w=60"
                    ]
                }
            },
            "RequestId": {
                "description": "Идентификатор запроса. Назовите его, когда пишете в поддержку.",
                "required": true,
                "schema": {
                    "type": "string"
                }
            },
            "IdempotentReplayed": {
                "description": "true, когда это сохранённый ответ более раннего запроса с тем же Idempotency-Key.",
                "required": false,
                "schema": {
                    "type": "string",
                    "enum": [
                        "true"
                    ]
                }
            },
            "ETag": {
                "description": "Версия записи. Передайте её в If-Match, чтобы изменить запись.",
                "required": true,
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"7\""
                    ]
                }
            },
            "Location": {
                "description": "Адрес созданной записи, а у принятого к исполнению (202) — адрес, где следить за исходом.",
                "required": true,
                "schema": {
                    "type": "string",
                    "format": "uri"
                }
            },
            "AcceptRanges": {
                "description": "bytes — результат отдаётся диапазонами. У сжатого ответа (Content-Encoding: gzip) заголовка нет: его не докачивают.",
                "required": false,
                "schema": {
                    "type": "string",
                    "enum": [
                        "bytes"
                    ]
                }
            },
            "ContentRange": {
                "description": "Отданный диапазон и записанная длина: bytes 0-1023/52428800; у 416 — bytes */52428800.",
                "required": true,
                "schema": {
                    "type": "string",
                    "examples": [
                        "bytes 1048576-52428799/52428800"
                    ]
                }
            },
            "ResultETag": {
                "description": "Тег результата: меняется, когда результат дописывается. Передайте его в If-Range, чтобы докачать эту же версию. У сжатого ответа тег слабый (W/) и для If-Range не годится.",
                "required": true,
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"52428800\""
                    ]
                }
            },
            "RetryAfter": {
                "description": "Сколько секунд подождать перед повтором.",
                "required": true,
                "schema": {
                    "type": "integer",
                    "minimum": 0
                }
            },
            "RetryAfterOptional": {
                "description": "Сколько секунд подождать перед повтором.",
                "required": false,
                "schema": {
                    "type": "integer",
                    "minimum": 0
                }
            },
            "WwwAuthenticate": {
                "description": "Схема аутентификации (RFC 6750).",
                "required": true,
                "schema": {
                    "type": "string",
                    "examples": [
                        "Bearer"
                    ]
                }
            },
            "WwwAuthenticateOptional": {
                "description": "Схема аутентификации (RFC 6750).",
                "required": false,
                "schema": {
                    "type": "string",
                    "examples": [
                        "Bearer error=\"insufficient_scope\", scope=\"locations:read\""
                    ]
                }
            }
        },
        "securitySchemes": {
            "apiToken": {
                "type": "http",
                "scheme": "bearer",
                "description": "Токен приложения из настроек магазина в заголовке Authorization: Bearer <token>."
            }
        }
    }
}
