Модуль Uniseller CRM · Карточки товаров
Кит — не раздел Яндекс Маркета: у него своё дерево категорий, свой словарь характеристик, своя загрузка картинок и свой жизненный цикл заказа. Поэтому интеграция написана под него с нуля. Карточки, цены, остатки и заказы Кита ведутся из вашего каталога Uniseller, рядом с Wildberries, Ozon и Яндекс Маркетом. Подключение — один токен: ни businessId, ни campaignId, ни склада вводить не нужно.
Проблема
Кит выглядит как «ещё один Яндекс», но ведёт себя иначе на каждом шагу. Ровно поэтому его нельзя вести теми же руками и той же выгрузкой, что Маркет.
Совпадают три вещи: есть карточки, есть цены с остатками, есть заказы. Дальше расходится всё: авторизация только по Bearer-токену, магазин определяется самим токеном, категории — своё дерево продавца, характеристики — плоский словарь магазина без схем по категориям. Готовая выгрузка «как на Маркет» здесь не подходит ни одним полем.
Цену подняли в CRM — в Ките она осталась старой. Остаток уехал в ноль на WB — в Ките товар всё ещё продаётся. Каждая площадка, которую ведут руками, добавляет не работу, а расхождение: оверселл и продажу по вчерашней цене замечают уже по заказу.
У магазина лимит 3 запроса в секунду, массовая запись есть только для цен и остатков, а контент уходит поштучно — по запросу на карточку и по запросу на каждое фото. Наивный скрипт «залить всё разом» упирается в лимит и в потолок файлов, который у Кита не сбрасывается никогда.
Модуль «Яндекс KIT» закрывает это целиком: каталог, цены, остатки и заказы Кита ведутся из вашей CRM по расписанию, а темп, порядок вызовов и защита невозвратных ресурсов площадки — внутри модуля, а не в вашей голове.
Как это работает
В мастере интеграции достаточно одного значения — токена магазина Кита. Идентификаторов бизнеса и кампании у площадки нет вовсе, магазин определяется самим токеном, а склад у магазина один и подставляется автоматически при первой отправке остатков
одно поле в мастереДерево вашего каталога связывается с деревом категорий магазина вручную. Нужной категории в Ките нет — она создаётся кнопкой прямо с экрана маппинга, с явным предупреждением: удалить созданную категорию площадка не позволяет, только заархивировать
счётчик «сопоставлено N из M»Характеристики у Кита — плоский глобальный словарь магазина, без схем по категориям. Справочник стартует пустым, автосоздание при экспорте запрещено, а те характеристики, что уже заполнялись у товаров этой категории, поднимаются в списке наверх
подсказки по факту использованияКонтейнер товара с категорией плюс вариант, в который сразу вкладываются название, описание, бренд, артикул, штрихкод, характеристики, цена, остаток, габариты и медиа. Габариты пересчитываются в единицы Кита: целые сантиметры и целые граммы
товар без категории не уедетЕжеминутно, пачками по 500 позиций. Товар без рассчитанной цены пропускается, а не обнуляется; остаток уходит абсолютным числом и уже учитывает активные резервы — повторный вычет как раз и даёт оверселл
массовая операция атомарнаРаз в пять минут модуль обходит страницы заказов и определяет изменения по слепку: фильтров и вебхуков у Кита нет. Заказ попадает в общий список CRM, статусы отображаются на привычные, остаток резервируется тем же движком, что и на Маркете
отгрузка остаётся ручнойДержит категорию магазина и объединяет варианты. Создаётся первым запросом; удалить или заархивировать контейнер площадка не даёт вовсе, поэтому категория выбирается один раз и осознанно.
Всё, чем товар торгует: название, описание, характеристики, медиа, габариты, НДС, цена и остаток. Уезжает одним запросом со всем контентом внутри, обновляется частичным патчем — массивы при этом заменяются целиком, поэтому шлются полностью.
Собирается самим Китом на основе вариантов: этой сущностью управляет площадка, а не продавец. Модуль запоминает её идентификатор в связке — по нему заказ сопоставляется с товаром CRM.
Один товар CRM — это один Product и один Variant, а карточку витрины Кит собирает сам. Модуль хранит эту связку у себя, и не для удобства: в позиции заказа Кит присылает только идентификатор варианта — ни артикула, ни штрихкода. Без сохранённой связки заказ невозможно сопоставить с товаром иначе как походом в API за каждой позицией, а бюджет там — те самые 3 запроса в секунду.
Оценка по вашему каталогу
Арифметика площадки, а не маркетинговое обещание. Контент уходит поштучно: по запросу на карточку и по запросу на каждое новое фото. Цены и остатки — пачками. Всё это делит один бюджет в 3 запроса в секунду на магазин.
Повторный прогон контента не шлёт ничего, если карточка не менялась: модуль сравнивает слепок содержимого. Цена в этот слепок намеренно не входит — иначе каждое изменение цены гнало бы дорогой поштучный пуш карточки вместо дешёвой пачки.
30 000 запросов к API Кита по вашим вводным — модуль растягивает их сам, чтобы магазин не упирался в лимит площадки
Контент дорогой и разовый: массовой записи для карточек у Кита нет, поэтому 5 000 товаров — это 30 000 запросов. Повторный прогон по неизменившимся карточкам не отправит ничего.
Внутри CRM
Слева — настройки интеграции, справа — как они раскладываются по товарам канала. Подвигайте переключатели: вердикты пересчитываются сразу.
Три собственные настройки интеграции: ставка НДС, публиковать ли вариант сразу и сколько фотографий отправлять максимум. Всё остальное модуль выясняет сам — склад у магазина ровно один и подставляется автоматически.
Сопоставление категорий — ручное, и это осознанное решение: созданную в Ките категорию нельзя удалить, только заархивировать. Поэтому кнопка «создать категорию в Ките» на экране маппинга предупреждает о необратимости, а товар без сопоставленной категории не уезжает вовсе и получает понятную причину в журнале, а не оседает «где-нибудь» в чужой ветке витрины.
Возможности
Мастер интеграции спрашивает только токен магазина: идентификаторов бизнеса и кампании у Кита нет, а склад — единственный и подставляется автоматически при первой отправке остатков.
Дерево CRM связывается с деревом магазина, с поиском и фильтром «только несопоставленные». Недостающая категория создаётся кнопкой — с предупреждением, что удалить её площадка не даст.
Справочник магазина зеркалится в CRM и наполняется вами; автосоздание при экспорте запрещено. Характеристики, уже заполнявшиеся в этой категории, поднимаются в списке наверх.
Контейнер товара плюс вариант со всем контентом внутри: описание, бренд, артикул, штрихкод, характеристики, габариты в единицах Кита, цена и остаток. Обновление — частичным патчем.
Картинки грузятся двоично, по контрольной сумме содержимого: одни и те же байты второй раз не отправляются. У магазина потолок 300 000 файлов без возможности удаления — кэш бережёт именно его.
По 500 позиций за раз, ежеминутно. Товар без рассчитанной цены пропускается, отрицательный остаток превращается в ноль, а сбойная пачка повторяется без виновных позиций.
Опрос раз в пять минут, дельта по слепку заказа, статусы отображаются на привычные. Остаток резервируется тем же движком, что и на Яндекс Маркете, а отмена «в процессе» резерв не снимает.
Каждый прогон расписания оставляет отметку, а страница модуля показывает состояние: цены и остатки ходят ежеминутно, заказы — раз в пять минут. Молчание исполнителя видно сразу, а не по пропавшим заказам.
Границы
Четыре вещи, которые честнее сказать до покупки, а не в переписке с поддержкой. Три из них — ограничения самой площадки, и обойти их не может никто.
У заказа Кита всего три перехода: подтвердить, отменить, завершить доставку. Ни ярлыков, ни трек-номеров, ни частичного отказа в его API нет вовсе — событие «передано курьеру» в жизненном цикле отсутствует. Модуль забирает заказы, ведёт их статусы и держит резерв остатка; сборку и передачу заказа делает человек.
Каталог наполняется из CRM: импорта чужих карточек из Кита в подсистеме нет, поэтому тумблер «загружать товары» для этой интеграции даже не рисуется. Если товары уже заведены в кабинете Кита руками, они останутся жить своей жизнью — модуль ведёт те позиции, что уехали из вашего каталога.
Кит принимает не больше 300 000 файлов на магазин, а удаления файлов в его API нет — исчерпать квоту можно только один раз. Поэтому модуль считает контрольную сумму каждой картинки и не заливает одни и те же байты дважды, а если квота всё же кончилась, товар уезжает с теми фото, что успели загрузиться, и факт пишется в журнал.
Цены, остатки, заказы и справочники возит расписание — без запущенного планировщика модуль после покупки не сделает ничего. Именно поэтому состояние исполнителя вынесено в интерфейс: каждый прогон оставляет отметку, и страница модуля прямо говорит «Исполнитель не подключён» вместо молчаливого «всё хорошо». Заведение планировщика — обязательный пункт подключения, он делается на нашей стороне.
Тариф
Яндекс KIT — самостоятельная торговая площадка Яндекса, а не раздел Яндекс Маркета, и это единственное, что нужно понять про интеграцию с ней. Совпадают ровно три вещи: есть карточки товаров, есть цены с остатками, есть заказы. Всё остальное устроено иначе: авторизация только по Bearer-токену, идентификатора магазина в запросах нет вовсе — магазин определяется самим токеном, категории представляют собой собственное дерево продавца, а характеристики — плоский словарь магазина без схем по категориям. Картинки принимаются только двоичной загрузкой, массовая запись существует лишь для цен и остатков, а темп ограничен тремя запросами в секунду на магазин. Поэтому модуль «Яндекс KIT» написан под площадку с нуля, а не склонирован с интеграции Маркета: ни одно поле выгрузки там не совпадает.
Подключение занимает один шаг: в мастере интеграции вводится токен магазина — ни businessId, ни campaignId, ни склад указывать не нужно, склад у магазина Кита один и подставляется автоматически при первой отправке остатков. Дальше категории вашего каталога вручную сопоставляются с деревом магазина, и это сознательное решение, а не недоделка: созданную в Ките категорию нельзя удалить, только заархивировать, поэтому кнопка «создать категорию в Ките» предупреждает о необратимости, а товар без сопоставления просто не экспортируется и получает понятную причину в журнале. Справочник характеристик стартует пустым и наполняется вами: автоматическое создание запрещено ровно по той же причине — словарь глобальный, плоский и без удаления, и «Цвет», «цвет» и «Colour» осели бы в витрине навсегда.
Карточка уезжает двумя основными запросами: контейнер товара с категорией и вариант, в который сразу вкладываются название, описание, бренд, артикул, штрихкод, характеристики, остатки, цена, габариты и медиа. Обновление идёт частичным патчем, а фото загружаются двоично, с проверкой контрольной суммы: одни и те же байты не заливаются дважды. Это не оптимизация, а защита невозвратного ресурса — у магазина потолок 300 000 файлов, и удаления файлов в API Кита нет. Цены и остатки идут пачками по 500 позиций: массовая операция у Кита атомарна, одна битая позиция отменяет всю пачку целиком, поэтому радиус поражения ограничен, а виновные позиции отбрасываются и пачка повторяется. Товар без рассчитанной цены пропускается, а не обнуляется; остаток отправляется абсолютным числом и уже учитывает активные резервы по заказам — повторный вычет резерва как раз и есть классический источник оверселла.
Заказы забираются опросом по расписанию, раз в пять минут: у Кита нет ни вебхуков, ни фильтров по статусу или дате — он молча игнорирует неизвестные параметры запроса и отдаёт всё подряд, поэтому изменения модуль определяет локально, по слепку заказа. Заказ попадает в общий список заказов CRM, его статусы отображаются на привычные, а остаток резервируется тем же движком, что и на Яндекс Маркете. Отгрузка при этом не автоматизирована и автоматизирована быть не может: в жизненном цикле заказа Кита всего три перехода — подтвердить, отменить, завершить доставку, — и ни ярлыков, ни трек-номеров площадка не выдаёт. Стоит модуль 1 000 ₽ в месяц, первые 3 дня — бесплатно; подключается из раздела «Модули» внутри CRM и отключается там же. Весь каталог надстроек — на странице модулей Uniseller CRM, а само ядро — на странице Uniseller CRM. Ещё нет CRM? Разверните её бесплатно на 7 дней.
Подключается из раздела «Модули» внутри CRM, отключается там же — в один клик. 1 000 ₽ в месяц за то, что карточки, цены, остатки и заказы Яндекс KIT живут в том же каталоге, что Wildberries, Ozon и Маркет.