# Uzum Market Seller API Разбирайте продажи и остатки магазина на Uzum Market Управление товарами, заказами, остатками и финансами на маркетплейсе Uzum Market ## Как агент работает с Uzum Market Seller API Агент работает через Seller Open API Uzum Market: читает товары магазина, заказы FBS и накладные по ним, остатки по SKU, возвраты и финансовый контур — начисления по заказам и расходы. Из этого он собирает выручку за период с разбивкой по товарам, находит позиции на грани out-of-stock и показывает, сколько от продажи остаётся после комиссий и удержаний маркетплейса. Всё на Uzum привязано к магазину: под одним токеном продавца их может быть несколько, и почти каждый запрос идёт в контексте конкретного магазина. Поэтому агент начинает со списка магазинов, дальше держит нужный и не смешивает цифры соседних витрин в одной сводке. Разделы API живут в разных версиях — заказы, остатки и накладные обновлялись независимо, — и агент обращается к актуальной для каждого. Финансовая правда здесь складывается из двух источников: начисления по заказам и расходы лежат порознь, и выручка по заказам — ещё не то, что дойдёт до счёта. Агент берёт оба раздела и отдельно вычитает возвраты, которые уменьшают уже посчитанную продажу. Основная его работа по Uzum — счётная и на чтение; там, где нужно поправить остаток или заказ, он показывает изменение до отправки и перечитывает результат после. Токен продавца агент подставляет в каждый запрос как есть, без префикса, и держит один на все разделы; отозванный в кабинете токен перестаёт работать в тот же момент, и агент скажет об этом сразу, а не после половины отчёта. Длинные списки заказов и остатков Uzum отдаёт страницами, поэтому период агент проходит постранично и складывает итог сам. Сводку он подписывает именем магазина, чтобы не перепутать витрины, а если раздел пуст, говорит об этом прямо, а не показывает пустую таблицу. ## Сценарии интеграции ### Сводка продаж на Uzum Агент соберёт заказы и выручку по товарам за период и покажет динамику продаж магазина на Uzum Market. ### Контроль остатков Агент проверит остатки по складам, найдёт товары на грани out-of-stock и подготовит список к пополнению. ### Финансовая сверка Агент сверит начисления и выплаты маркетплейса с продажами и покажет, где комиссия съедает маржу. ### Откуда идут возвраты Агент соберёт возвраты за период, разложит их по товарам и покажет, какие позиции возвращают чаще прочих и сколько это забирает из уже посчитанной выручки. ### Накладные перед отгрузкой Агент пройдёт по накладным FBS, покажет состав каждой и заказы, которые в неё вошли, чтобы к отгрузке не потерялась ни одна позиция. ### Каждая витрина отдельно Агент пройдёт по всем магазинам токена и сведёт заказы, остатки и расходы по каждому порознь, подписав цифры именем витрины. ## Как подключить **Перед подключением** - Аккаунт продавца Uzum Market с хотя бы одним активным магазином - Права на настройки кабинета — сотруднику без них токен не выпустить - Доступ к разделам товаров, заказов, остатков и финансов ### Войдите в кабинет продавца Uzum Market Откройте seller.uzum.uz под аккаунтом, на который зарегистрирован магазин: токен выпускается на аккаунт целиком, и нужны права на настройки. ### Создайте API-токен в настройках кабинета В настройках профиля откройте раздел API и интеграций и выпустите токен Seller API — он открывает товары, заказы, остатки и финансы. ### Скопируйте токен сразу после создания Значение приходит одной длинной строкой без префикса: слово Bearer не добавляется, пробелов по краям быть не должно. Прежний токен восстановить нельзя. ### Проверьте, что магазин активен Агент сначала берёт список магазинов аккаунта, а потом заказы, остатки и финансы по выбранному. Без активного магазина список пуст. ## Частые вопросы ### Как подключить Uzum Market? API-токеном продавца Uzum Market. Токен вводится один раз, хранится в зашифрованном виде и может быть отозван в кабинете. ### Что агент умеет по Uzum? Читать товары, заказы, остатки и финансы Seller API: собирать отчёты по продажам, контролировать остатки, сверять выплаты. ### Можно ли получать отчёты регулярно? Да — агент работает по расписанию: например, каждое утро присылает сводку заказов и остатков в Telegram. [Открыть Uzum Market Seller API](https://seller.uzum.uz)