Разбирайте продажи и остатки магазина на Uzum Market

Агент работает через Seller Open API Uzum Market: читает товары магазина, заказы FBS и накладные по ним, остатки по SKU, возвраты и финансовый контур — начисления по заказам и расходы. Из этого он собирает выручку за период с разбивкой по товарам, находит позиции на грани out-of-stock и показывает, сколько от продажи остаётся после комиссий и удержаний маркетплейса.

Всё на Uzum привязано к магазину: под одним токеном продавца их может быть несколько, и почти каждый запрос идёт в контексте конкретного магазина. Поэтому агент начинает со списка магазинов, дальше держит нужный и не смешивает цифры соседних витрин в одной сводке. Разделы API живут в разных версиях — заказы, остатки и накладные обновлялись независимо, — и агент обращается к актуальной для каждого.

Финансовая правда здесь складывается из двух источников: начисления по заказам и расходы лежат порознь, и выручка по заказам — ещё не то, что дойдёт до счёта. Агент берёт оба раздела и отдельно вычитает возвраты, которые уменьшают уже посчитанную продажу. Основная его работа по Uzum — счётная и на чтение; там, где нужно поправить остаток или заказ, он показывает изменение до отправки и перечитывает результат после.

Токен продавца агент подставляет в каждый запрос как есть, без префикса, и держит один на все разделы; отозванный в кабинете токен перестаёт работать в тот же момент, и агент скажет об этом сразу, а не после половины отчёта. Длинные списки заказов и остатков Uzum отдаёт страницами, поэтому период агент проходит постранично и складывает итог сам. Сводку он подписывает именем магазина, чтобы не перепутать витрины, а если раздел пуст, говорит об этом прямо, а не показывает пустую таблицу.