Пока у продавца на Uzum Market пара десятков товаров, остатки и цены можно править в кабинете вручную. Когда SKU становятся сотнями, а продажи идут ещё и через сайт, бот и офлайн-точку, ручное обновление превращается в постоянный источник ошибок. Решение — Uzum Market API: официальный интерфейс для продавцов, через который остатки, цены, заказы и финансы автоматически синхронизируются с вашей 1С, Smartup, складской программой или сайтом.
Коротко: API умеет обновлять остатки и цены существующих SKU, получать и обрабатывать FBS- и DBS-заказы, выгружать накладные и отчёты о продажах. Создание карточек товаров пока остаётся в кабинете. Ниже — что именно доступно, как строится интеграция и где чаще всего ошибаются.
Что такое Uzum Market API
Uzum предоставляет продавцам seller OpenAPI — документацию в формате OpenAPI (Swagger) с сервером api-seller.uzum.uz. Доступ — по токену: он создаётся в кабинете продавца в разделе API настроек и передаётся в каждом запросе в заголовке Authorization без префикса Bearer.
У одного продавца может быть несколько магазинов, и почти все методы требуют идентификатор магазина. Поэтому интеграция обычно начинается с получения списка магазинов.
FBO, FBS и DBS: в чём разница для API
Набор доступных методов зависит от схемы работы, поэтому сначала договоримся о терминах.
| Схема | Где товар | Кто доставляет | Что есть в API |
|---|---|---|---|
| FBO | На складе Uzum | Uzum | Накладные поставки, возвраты, продажи |
| FBS | На складе продавца | Uzum, через пункт приёма | Остатки, заказы, этикетки, накладные передачи |
| DBS | На складе продавца | Сам продавец | Остатки, заказы, статусы доставки и выдачи |
Если вы работаете только по FBO, интеграция в основном про отчёты и финансы. При FBS и DBS нужно управлять остатками и заказами почти в реальном времени — и здесь API приносит больше всего пользы.
Когда интеграция нужна
- SKU так много, что ручное обновление остатков отнимает часы каждый день;
- один и тот же товар продаётся в нескольких каналах;
- ручной перенос заказов в 1С или Smartup приводит к ошибкам;
- нужно собирать продажи и расходы, чтобы видеть маржу по каждому товару.
Если товаров немного и они продаются только на Uzum, кабинета может быть достаточно. Интеграцию всегда можно добавить, когда бизнес вырастет.
Возможности Uzum seller API
Методы в официальной документации разбиты на несколько групп.
Товары и цены
- получение списка SKU по магазину;
- изменение цен SKU;
- печать этикеток со штрихкодами SKU.
Остатки FBS и DBS
API позволяет читать и обновлять остатки FBS и DBS, то есть товара на вашем собственном складе. Остатки FBO, то есть товара на складе Uzum, формируются через накладные поставки, а не выставляются через API напрямую.
Заказы FBS и DBS
- получение заказов по статусу и их количества;
- подтверждение и отмена заказа;
- этикетка для FBS-заказа;
- передача DBS-заказа в доставку, подтверждение выдачи и оформление возврата.
Накладные и возвраты
Накладные поставки FBO и их состав, накладные передачи FBS (создание, изменение состава, печать акта приёмки), накладные возврата.
Финансы
Список продаж и расходов продавца, удержанных Uzum. Эти данные нужны для бухгалтерии и расчёта маржи по каждому товару.
Как устроена интеграция с Uzum API
Надёжнее всего ставить между Uzum и учётной системой небольшой промежуточный сервис. Он устойчивее, чем модуль внутри 1С, и упрощает подключение новых каналов продаж.
- Выбрать главную систему. Где ведутся остатки и цены: в 1С, Smartup или складской программе. Uzum обновляется только из этого источника.
- Сопоставить SKU. Каждый SKU на Uzum связывается с товаром в учётной системе по артикулу или штрихкоду. Обычно это самый трудоёмкий этап.
- Передавать остатки и цены. Сервис забирает изменения из учётной системы, отправляет их в Uzum и пишет ошибки в журнал.
- Собирать заказы. Новые FBS- и DBS-заказы регулярно забираются и создаются документом в учётной системе; подтверждение — автоматически или через менеджера.
- Сверять финансы. Продажи и расходы выгружаются в отчёты или бухгалтерию.
- Мониторить. Если токен перестал работать или запросы отклоняются, ответственный получает уведомление в Telegram.
Подробно о способах обмена с учётными системами — в статье Интеграция 1С с сайтом, CRM и маркетплейсами.
Маркетплейс в Узбекистане и другие каналы: единый остаток
Многие продавцы в Узбекистане торгуют одновременно на Uzum Market, на своём сайте, через Telegram-бот и в офлайн-магазине. Без общего остатка последний товар продаётся в двух каналах сразу, и заказ приходится отменять. А отмены могут ухудшать показатели продавца на маркетплейсе.
Выход — подключить все каналы к одному складскому учёту. Как устроена такая программа, мы разбирали в статье Программа для учёта склада, а про запуск собственного магазина — в статье Как открыть интернет-магазин.
Документы и налоговая часть
Счета-фактуры и другие документы по продажам на Uzum — отдельный процесс. Если вы выставляете электронные счета-фактуры через Didox, их тоже можно автоматизировать: подробнее в статье Интеграция Didox и ЭСФ. Конкретный порядок учёта согласуйте со своим бухгалтером.
Частые ошибки
Токен «на всех»
Токен действует от имени продавца. Не пересылайте его в чатах, храните на сервере как секрет и перевыпускайте, когда уходит сотрудник с доступом.
Слишком частые запросы
Опрос остатков каждую секунду быстро упирается в лимиты. Достаточно собирать изменённые SKU и отправлять их пакетом, а заказы забирать с разумным интервалом.
Несопоставленные SKU
Если один товар заведён в кабинете несколькими SKU или артикулы не совпадают, интеграция будет отправлять неверные остатки. Наведите порядок в каталоге до запуска.
Устаревшие методы
API развивается: часть методов помечается устаревшими, появляются новые. Например, прежняя версия метода получения остатков в документации уже помечена как устаревшая. Периодически сверяйте код интеграции с официальной документацией.
Интеграция с Uzum Market в SyncLab
Мы связываем Uzum Market с 1С, Smartup, складской программой, сайтом и Telegram-ботом: передаём остатки и цены, собираем FBS- и DBS-заказы, выгружаем финансы в отчёты. Интеграции оцениваются по проекту в рамках разработки ПО на заказ. Если кроме маркетплейса нужен свой магазин, по созданию интернет-магазина тоже после короткого брифа присылаем письменное предложение с объёмом работ, сроками и фиксированной стоимостью. В проекте Wallner мы интегрировали ERP со Smartup, так что с учётными системами работаем не впервые.
Частые вопросы
Что такое Uzum Market API?
Это официальный программный интерфейс для продавцов Uzum Market (seller OpenAPI). Через него ваша система может работать с магазинами, списком SKU, остатками FBS и DBS, ценами, заказами, накладными и финансовыми данными.
Где получить токен Uzum seller API?
Токен создаётся в личном кабинете продавца, в разделе API настроек. Он передаётся в заголовке Authorization без префикса Bearer. Храните токен как пароль и передавайте его только разработчику, который делает интеграцию.
Можно ли через API создать карточку товара на Uzum?
По состоянию на октябрь 2026 года в официальной документации seller OpenAPI нет метода создания карточек: они создаются в кабинете продавца, а API работает с уже существующими SKU, остатками, ценами и заказами. Методы могут добавить, поэтому сверяйтесь с документацией.
Как связать Uzum Market с 1С или Smartup?
Обычно через промежуточный сервис: он забирает остатки и цены из 1С или Smartup и отправляет их в Uzum, а из Uzum собирает новые заказы и продажи и передаёт в учётную систему.
Сколько стоит интеграция с Uzum Market?
Цена зависит от того, какие данные синхронизируются, сколько магазинов и какая учётная система подключается, поэтому считается по проекту. Сначала разбираем задачу, затем даём точную оценку.
