Pletora: API-интеграция поставщиков и каталог без складских программ

У этого интернет-магазина не было 1С. Ассортимент приходил напрямую от поставщиков — у каждого свой формат выгрузки, свои категории и свои названия свойств. Мы написали индивидуальные классы импорта под каждый API, собрали справочник сопоставления и за 15 дней после релиза оптимизаций подняли видимость в ТОП-10 с 13% до 31%.

Контекст

Pletora — интернет-магазин сантехники, товаров для дома, мебели для ванных, люстр и систем вентиляции. Ассортимент широкий и собран от десятков поставщиков: Dekomo, Hogart, Rusklimat, Wasserkraft и других.

Особенность проекта — отсутствие складских программ в контуре. Товары, цены и остатки нужно забирать напрямую из систем поставщиков, а значит, для каждого писать свой код. Универсального решения здесь не существует: XML, CSV и JSON-выгрузки отличаются не только форматом, но и логикой.

Задача

• Автоматизировать загрузку товаров от поставщиков — без 1С и «Моего Склада».
• Обновлять цены, остатки и скидки по расписанию, а не вручную.
• Сопоставить категории и свойства поставщиков с тем, что уже есть на сайте.
• Разобраться с одинаковыми артикулами — один и тот же товар может прийти от нескольких поставщиков.
• Закрыть пустые карточки — каталог с описаниями только у части товаров плохо индексируется.

Как строили интеграцию

Аудит API каждого поставщика

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

Сроки в проекте считались не «на интеграцию вообще», а на каждого поставщика отдельно: сложность API различалась в разы.

Две операции вместо одной

Для каждого поставщика мы написали два независимых класса:

• класс импорта — загрузка новых товаров;
• класс обновления — актуализация цен, остатков и скидок.

Разделение принципиальное: новый товар и изменившаяся цена — разные сценарии с разной частотой. Импорт запускается редко, обновление — постоянно.

Интерфейсы в админке

Управление импортом вынесено в административную панель: отдельный интерфейс для загрузки новых товаров и отдельный — для обновления цен, остатков и скидок. В каждом заложена логика работы с XML, CSV и JSON.

Это важно для повседневной работы: менеджер видит, что и когда загрузилось, и может запустить импорт руками, не дожидаясь расписания.

Справочник сопоставления

У поставщиков свои названия категорий и свойств: «смеситель для кухни» у одного может называться «кран кухонный», а «материал» — «состав». Без сопоставления товары ложатся в каталог хаотично, а фильтры перестают работать.

Мы создали справочник, где категории и свойства поставщиков соотносятся с категориями и свойствами сайта. Один раз настроенное соответствие дальше применяется автоматически ко всем загрузкам.

Товары с одинаковыми артикулами

Один и тот же товар приходит от нескольких поставщиков — с разными ценами и остатками. Чтобы при обновлении не затирать данные друг друга, мы задействовали склады: у каждого поставщика свой, а на витрине отображается та цена и наличие, которые актуальны.

Бренды и категории

Отдельной частью работы стал импорт брендов: страницы производителей — это полноценные посадочные страницы, и заполнять их вручную при широком ассортименте нереально.

Автоматизация на агентах

Все процессы работают на агентах 1С-Битрикс — штатном механизме отложенных задач. Цены и остатки обновляются по расписанию, импорт новых позиций запускается без участия человека. Скидки реализованы правилами работы с корзиной.

SEO-часть: как 13% превратились в 31%

Интеграция дала каталог, но сама по себе не приносит трафик. Параллельно мы решили вторую задачу — наполнить карточки и оптимизировать каталог.

• Автогенерация описаний на основе технических характеристик товара — так закрылась проблема пустых карточек.
• Массовая оптимизация метатегов — Title, Description и H1 для товаров и категорий.
• Тексты категорий с перелинковкой и посадочными таблицами свойств.
• Тюнинг сервера и контейнеризация в Docker — для скорости загрузки, которую измеряет Google PageSpeed Insights.

Результат: за 15 дней после релиза оптимизаций видимость в ТОП-10 поисковой выдачи выросла с 13% до 31%.

Стек и решение

Проект работает на 1С-Битрикс с готовым решением «Аспро: Максимум». Такой выбор сэкономил время: в шаблоне уже были готовые модули и элементы интерфейса, которые оставалось адаптировать под специфику магазина, а не разрабатывать с нуля.

Всё контейнеризировано через Docker — развёртывание и масштабирование не зависят от окружения сервера.

Результат

Магазин получил работающий конвейер ассортимента: товары, цены, остатки и бренды приходят от поставщиков автоматически, без складских программ и ручной загрузки. Каталог наполнился описаниями, а видимость в поиске выросла более чем вдвое за две недели.

Дальше проект развивается по плану: подключение новых поставщиков идёт по отработанной схеме — два класса и настройка сопоставления.

Что забрали в другие проекты

• Разделять импорт и обновление. Разные сценарии с разной частотой нельзя решать одним кодом.
• Справочник сопоставления — до первого импорта. Настроить соответствия один раз дешевле, чем чинить разъехавшийся каталог.
• Интеграция и SEO — одна команда. Каталог, наполненный данными, но не оптимизированный, не приносит трафика.

Частые вопросы

Можно ли загружать товары от поставщиков без 1С?

Да. Мы интегрировали сайт напрямую с API поставщиков: для каждого написан свой код загрузки и обновления. Это работает и без складских программ — данные приходят из систем поставщиков по расписанию.

Как быть, если у поставщиков разные форматы выгрузок?

Писать под каждый отдельный класс. Универсальный парсер здесь не работает: XML, CSV и JSON отличаются не только структурой, но и логикой — например, тем, как поставщик помечает отсутствующий товар. Для каждого формата закладывается своя логика, а справочник сопоставления приводит категории и свойства к единому виду.

Что делать, если один товар есть у нескольких поставщиков?

Использовать склады: у каждого поставщика свой склад, и при обновлении данные не затирают друг друга. На витрине показывается актуальная цена и наличие, а правила корзины учитывают, откуда едет товар.

Проект выполнен в рамках услуг «Сайты на АСПРО для 1С-Битрикс» и «SEO для интернет-магазина».