Коннекторы загружают данные, приводят их к единому формату и открывают только те действия, которые реально разрешены токеном и API маркетплейса.
Магазины, товары, рейтинг карточек, заказы FBS/DBS, остатки, финансы и накладные поставок.
Цены, FBS/DBS-остатки, подтверждение и отмена заказа, доставка, выдача и возврат DBS.
Адаптер закреплён за версионированным снимком официального Seller OpenAPI. Рейтинг карточки читается из SellerProductCard, а отзывы и webhooks остаются выключены до появления официальных методов.
Возможности Uzum MarketКарточки, заказы, склады, остатки, финансовые операции, поставки и отзывы в рамках доступных методов кабинета.
Обновление цены, остатка на выбранном складе и ответ на отзыв через официальные seller API.
Oborot учитывает разные API-хосты Wildberries, лимиты запросов и отдельные права токена по категориям методов.
Возможности WildberriesТовары, заказы, остатки, начисления, FBO-поставки, акты приёмки и отзывы по Client ID и API-ключу.
Обновление цены и остатка с указанием склада. Команды проходят очередь и фиксируются в журнале.
Client ID хранится отдельно от API-ключа. Акт завершённой FBO-поставки сверяется по supply_id и скачивается как bounded PDF с домена Ozon.
Возможности OzonКампании и магазины, предложения, заказы, остатки, финансы и отзывы согласно правам API-ключа.
Цены и ответы на отзывы в тех бизнесах и кампаниях, где метод открыт площадкой.
Business ID задается при подключении. Возможности подключения определяются после проверки доступа и сохраняются в capability-профиле.
Возможности Яндекс МаркетЗагрузка идет страницами с сохранением курсора. Большая выгрузка продолжится со следующего участка. Повторная страница обновляет существующие записи по внешним идентификаторам и не создает дубликаты.
Ограничение частоты, временная ошибка и недоступность API получают управляемый retry. Ошибка авторизации переводит подключение в отдельный статус. Сырые секреты и ответы провайдера не попадают в пользовательский журнал ошибок.
Webhook принимает событие только после проверки подписи или токена подключения. Затем Oborot ставит точечную синхронизацию в очередь. Полный reconcile по расписанию остается страховкой от пропущенных событий.
Одинаковая сущность Oborot может иметь разные операции на площадках. Один API разрешает менять остаток, другой требует конкретный склад, третий оставляет метод только для чтения. После подключения адаптер публикует capabilities: товары, заказы, остатки, финансы, поставки, отзывы, webhooks и доступные команды записи.
Кнопка появляется только при соответствующей возможности и праве сотрудника. Сервер повторяет проверку перед созданием задания. Поэтому обновление коннектора добавляет функцию контролируемо и не открывает действие всем существующим tenant. Для массового изменения система сначала показывает выборку и расчет, затем создает отдельные идемпотентные команды.
Все провайдеры нормализуют данные в одну модель, сохраняя raw status и безопасные метаданные. Общий статус нужен отчетам и автоматизациям, исходный статус помогает разобрать спорную операцию. Финансовая сумма хранит знак, тип, дату и внешний идентификатор. Заказ сохраняет строки товара, схему исполнения и ключевые даты.
Сотрудник создает токен в кабинете площадки с минимально нужными правами и добавляет его в Oborot. Система шифрует значение, проверяет доступ и показывает найденные возможности. Ключ можно отозвать на стороне маркетплейса в любой момент.
Для production-магазина рекомендуем отдельный токен интеграции, регламент ротации и тестовое подключение перед первой записью цены или остатка. История команд позволяет восстановить автора, причину, время и результат каждого изменения.
Токен, отправленный в переписку или открытый журнал, следует считать раскрытым и заменить. В документацию и Git попадает только версия публичной API-схемы. Тестовые фикстуры используют вымышленные значения. Реальный секрет передается приложению через зашифрованное хранилище и никогда не возвращается интерфейсу после сохранения.
Площадки меняют методы, статусы и лимиты. Для критичного коннектора хранится версия официальной OpenAPI-схемы или зафиксированная документация. При обновлении сравниваются пути, параметры, тела запросов и правила авторизации. Контрактные тесты проверяют используемые операции адаптера.
После тестов новая версия проходит canary на отдельном магазине. Сначала запускается чтение, затем безопасная команда на тестовом SKU. Метрики отслеживают процент успешных заданий, задержку, ограничение частоты и ошибки авторизации. Отклонение останавливает rollout, сохраняя предыдущую версию адаптера.
Такой процесс особенно важен для цен и остатков. Ошибка чтения задерживает отчет, ошибка массовой записи влияет на продажи. Разделение команд, журнал и подтверждение человека уменьшают радиус воздействия.
Oborot использует официальные методы и учитывает ограничения площадок. Полнота истории, скорость обновления и операции записи зависят от seller API, тарифа и прав токена. Система показывает эти ограничения в подключении. Если метод временно недоступен, команда продолжает работать с последним подтвержденным снимком и видит задержку. Новая возможность включается после проверки документации, контрактных тестов и canary, поэтому обещание на сайте совпадает с реальной возможностью адаптера.
Перед production-подключением владелец выбирает магазины и права токена, менеджер проверяет товары и заказы, финансист сверяет завершенный период, склад сопоставляет контрольные остатки. Результаты сохраняются в акте запуска. После проверки включаются расписание, webhooks и разрешенные команды записи. Показатели ошибок и свежести остаются видимыми в кабинете, а ответственный получает Telegram-сигнал до того, как задержка повлияет на ежедневную работу.
Telegram подтвердит личность. Для новой компании Oborot запросит название и адрес, создаст отдельное рабочее пространство и откроет подключение магазина. Токен площадки хранится в зашифрованном хранилище.
