Платформа автозапчастин на OpenCart: TecDoc-імпорт і точний підбір

Продукт і бізнес-задача

Головний біль покупця автозапчастин — невизначеність: «чи підійде ця деталь саме до мого авто?». Ми зробили підбір центром усього досвіду: клієнт обирає автомобіль один раз і бачить лише те, що йому справді пасує.

Кілька каналів пошуку — за автомобілем, за артикулом і крос-номером, за каталогом — ведуть до однакового точного результату. Особистий «Гараж» запам’ятовує авто користувача, щоб повторні покупки займали секунди.

Рушій імпорту TecDoc

Основа платформи — автономний конвеєр імпорту. CSV-фід постачальника (UUID + залишки складів) потрапляє у буферну таблицю-чергу, звідки PHP-контролер порційно звертається до TecDoc через RapidAPI. Щоб не впертися в ліміти платного API, ми додали багаторівневий кеш (ключ — MD5 запиту), а важкі операції винесли в асинхронні черги зі статусами, аби жоден таймаут не «підвішував» сайт.

Дані ми не просто вантажимо, а нормалізуємо: зведення залишків по складах і приведення брендів до єдиного вигляду, чотирикроковий каскад запитів за еталонними характеристиками, автозбірка групи атрибутів, коректний порядок категорій для «хлібних крихт» і жорстке зіставлення UUID → артикул товару.

Якщо API повертає порожнечу — спрацьовує «м’яка посадка»: товар усе одно створюється у службовій категорії, тож імпорт ніколи не падає. Живий імпорт через AJAX і фонова автоматизація через CRON тримають каталог актуальним цілодобово.

Точний пошук і система аналогів

Пошук ми перевели з крихкого текстового зіставлення на маршрутизацію за ідентифікаторами. Фронтенд-воронка «Марка → Модель → Рік → Двигун» збирає масив vehicle_id і через OCMOD-міст віддає користувачеві миттєвий результат, а пошуковику — чисту ЧПУ-адресу через невидимий 301-редирект.

У базі підбір тримається на зв’язці oc_product_to_vehicle — INNER JOIN миттєво відсікає 99% нерелевантних товарів — та окремій індексованій таблиці крос-номерів oc_product_cross замість повільного LIKE-сканування.

Система аналогів двоспрямована: з 50 замінників від TecDoc у видачу потрапляють лише ті, що реально є в наявності. Плюс — динамічне SEO (H1 і Title формуються «на льоту» під обране авто без тисяч дублів категорій), захист верстки через htmlspecialchars і «розумні заглушки», що тримають вітрину цілісною навіть поки дані ще довантажуються.