Подключите кабинеты Uzum по официальному Seller API. Oborot сверит магазины, загрузит рейтинг карточек и операционные данные, покажет продажи, выплаты, остатки и потребность в дозакупке по каждому товару.
Контракт проверен 28 августа 2026 года
Discovery получает доступные магазины и формирует отдельный поток синхронизации для каждого из них. Предложения связываются с внутренней номенклатурой и себестоимостью, а официальный рейтинг карточки Uzum виден рядом с каждым SKU каталога.
Заказы проходят общую модель статусов Oborot с сохранением исходного статуса Uzum. Разрешённые действия выполняются через очередь команд, повторно проверяют состояние заказа и фиксируют автора, причину и результат.
Снимки FBS и FBO показывают доступное количество и свежесть данных. Запись остатка и цены включается по capability подключения. Pricing policy рассчитывает безопасный порог и блокирует цену с неизвестной экономикой.
FBS-поставка собирается из выбранных заказов, точки сдачи и доступного временного слота. Накладные, документы поставки и возвраты покупателя остаются отдельными сущностями с точной связью с магазином и заказом.
Селлер создаёт отдельный API-токен в кабинете Uzum и добавляет его в Oborot. Значение уходит в зашифрованное хранилище Taska Core и после сохранения больше не возвращается интерфейсу. Адаптер передаёт токен в заголовке Authorization в формате, который требует Uzum Seller API. Логи, ответы API и пользовательский аудит содержат только безопасные коды ошибок.
Сначала Oborot выполняет validate, затем discover. Discovery получает магазины, сохраняет доступные capabilities и ставит первичную загрузку в очередь. Синхронизация каталога переносит SellerProductCard.rating в метаданные каждого SKU карточки и показывает значение на desktop и mobile. Ротация токена запускает новый discovery, сохраняя ранее загруженные товары, заказы и финансовые операции.
Менеджер видит новые заказы, позиции, схему исполнения, магазин и время последнего обновления. Для FBS доступны документы отгрузки и маркировка IMEI или ASL BELGISI, когда товар и контракт площадки этого требуют. Полные значения маркировки хранятся только до успешной отправки. После выполнения job оставляет хеш, количество строк и безопасные метаданные.
DBS-команды используют тот же durable worker и idempotency key. Перед сменой статуса адаптер читает актуальное состояние и блокирует переход, который уже устарел. Успешная команда подтверждается ответом площадки. Временная ошибка сохраняет retryable status и cursor, поэтому сотрудник продолжает операцию с проверенной точки, а журнал первой попытки остаётся доступен для разбора.
Oborot связывает предложение Uzum с товаром Inventory и считает дни покрытия по фактической скорости продаж. Правило учитывает срок поставки, страховой запас, минимальную партию и кратность заказа. Рекомендация показывает дату риска и количество. После подтверждения закупщик создаёт черновик Purchase Order и сохраняет исходный расчёт рядом с решением.
Для Uzum FBS менеджер выбирает заказы одного магазина, точку сдачи и слот. Система проверяет terminal-статусы, повторное назначение и наличие идентификатора слота до provider call. Создание и отмена проходят через очередь. После успеха поставка materialize-ится в общей модели, заказы получают связь, а PDF или ZIP документов возвращается по запросу с запретом браузерного кеширования.
Финансовая синхронизация хранит начисления и удержания отдельно от суммы заказа. Сверка сравнивает ожидаемые proceeds завершённых заказов со связанными операциями, учитывает задержку выплаты и допустимое расхождение. Отчёт разделяет совпадения, ожидаемые выплаты, отсутствующие операции и несовпадение суммы. Валюты считаются независимо.
Прибыль по SKU добавляет известную себестоимость, комиссию, логистику, возвраты и рекламный расход Taska Marketing. Кампания связывается с конкретным offer и распределяет расход по весам, если продвигает несколько товаров. Строка с неизвестной себестоимостью остаётся видимой, но итоговая прибыль получает пустое значение и понятную причину вместо вымышленной цифры.
Доступность операции зависит от текущего Uzum Seller API, прав токена, схемы исполнения и статуса заказа. Oborot показывает capability после проверки подключения и повторяет серверную проверку перед каждой записью. Интерфейс скрывает действие при отсутствии возможности.
Рейтинг относится к карточке товара и повторяется у связанных SKU. Это агрегированное значение Uzum. Закреплённая Seller OpenAPI 1.0 не публикует список отзывов, ответы на отзывы и webhooks, поэтому Oborot не обещает эти операции и не получает их через scraping.
Токен, опубликованный в переписке или логе, считается раскрытым. Его нужно отозвать на стороне Uzum, выпустить новый и повторить discovery. В репозитории хранится только публичный versioned OpenAPI snapshot и контрактные тесты без рабочих секретов.
Telegram подтвердит личность. Для новой компании Oborot запросит название и адрес, создаст отдельное рабочее пространство и откроет подключение магазина. Токен площадки хранится в зашифрованном хранилище.
