Yandex Commerce Protocol (YCP) для OpenCart: як приймати замовлення з Аліси AI та пошуку Яндекса

Покупці все частіше починають вибір товару не з переходу в конкретний інтернет-магазин, а з пошукової системи або ІІ-помічнику. Користувач може попросити Алісу AI підібрати товар із потрібними характеристиками, порівняти кілька варіантів та одразу перейти до покупки. Для магазину це поява нового каналу продажів, в якому шлях від запиту до оформлення замовлення стає помітно коротшим.

Підключити магазин на OpenCart до таких сценаріїв дозволяє Yandex Commerce Protocol, або YCP. Протокол пов'язує каталог та систему обробки замовлень магазину з сервісами Яндекса, а замовлення, оформлене через універсальний чек, автоматично передається в OpenCart.

Що таке Yandex Commerce Protocol

Покупцеві не потрібно кілька разів переходити між сторінками, реєструватися на новому сайті та вручну заповнювати всі дані. Контактна та платіжна інформація може підставлятися з Yandex ID, а сплатити замовлення можна через Яндекс Пей, у тому числі частинами за допомогою Спліту. При цьому продавцем залишається сам інтернет-магазин: він отримує відомості про покупця та замовлення, самостійно комплектує товар, організує доставку та обслуговує клієнта.

YCP не замінює OpenCart та не переносить керування магазином в окрему систему. Протокол створює додаткову точку входу для покупців, а всі підтверджені замовлення продовжують оброблятись у звичній панелі OpenCart.

YCP іноді називають технологією "продажу без кліка" або "купівлі без переходу на сайт". Це спрощене визначення: покупець все одно вибирає пропозицію, натискає кнопку покупки та перевіряє замовлення. Головна відмінність від звичайного сценарію полягає в іншому — для оформлення йому не потрібно переходити в інтернет-магазин, реєструватися там і наново вводити контактні та платіжні дані.

При цьому YCP є маркетплейсом. Продавцем залишається інтернет-магазин: він отримує інформацію про замовлення та покупця,обробляє покупку у власній системі, керує залишками, доставкою та подальшим спілкуванням з клієнтом.

Як покупка виглядає для клієнта

Покупець формулює запит у Пошуку, Алісі AI або вибирає товар у Яндекс Ритмі. Яндекс може показати відповідні пропозиції магазинів, що передають свій асортимент у Яндекс Товари.

Подальший сценарій має такий вигляд:

1. Покупець обирає відповідний товар в Алісі AI, Пошуку або Яндекс Ритмі.
2. Натискає кнопку «Купити один клік».
3. Перевіряє товар, кількість та доступні варіанти.
4. Вибирає спосіб отримання та відповідну дату доставки.
5. Перевіряєавтоматично заповнені контактні дані.
6. Оплачує покупку доступним способом.

Після підтвердження замовлення передається до інтернет-магазину. Для менеджера він стає звичайним замовленням OpenCart, з яким можна працювати за прийнятим у магазині процесом.

Перехід на сайт продавця зберігається при цьому. YCP додає прискорений варіант оформлення, але не позбавляє покупця можливості відкрити картку товару та оформити замовлення безпосередньо у магазині.

Як YCP працює з боку OpenCart

Для повноцінної інтеграції потрібні дві пов'язані, але різні частини.

1. Передача каталогу через товарний фід

Яндекс повинен заздалегідьотримати відомості про товари: назви, посилання, зображення, ціни, наявність, характеристики та інші дані. Для цього магазин завантажує ФІД в Яндекс Товари. Кнопка швидкої покупки може відображатися тільки для переданих у фіді пропозицій.

Щоб дозволити оформлення через YCP, у товарних пропозиціях передається параметр is_checkout_enabled зі значенням true. Підготувати такий фід можна за допомогою модуля LiveYML — експорт у Яндекс.Маркет та

2. Обмін даними про кошик та замовлення через API

Одногофіда недостатньо. Під час оформлення Яндексу необхідно отримати актуальні ціни та залишки, дізнатися про доступні склади та способи доставки, тимчасово зарезервувати товари, підтвердити замовлення та надалі обмінюватися його статусами.

Цю частину виконує модуль YCP OpenCart. Він приймає захищені запити Яндекса, звертається до даних магазину та створює підтверджене замовлення в OpenCart.

Таким чином, товарний фід відповідає на запитання «що продає магазин», а API-інтеграція – «чи можна купити обраний товар зараз і як оформити замовлення».

Можливості модуля YCP для OpenCart

Для підключення підготовлено окремі версії модуля для

Модуль забезпечує:

• захищене підключення OpenCart до API YCP;
• передачу списку складів та власних точок самовивезення;
• перевірку складу кошика, цін та фактичних залишків;
• резервування товару на час оформлення;
• створення замовлення в OpenCart тільки післяпідтвердження покупки;
• захист від повторного резервування та появи дублікатів замовлень;
• отримання доступних варіантів кур'єрської доставки;
• обробку скасування та повідомлення про доставку;
• зіставлення станів YCP зі статусами OpenCart;
• передачу історії зміни стану замовлення;
• журналування запитів та помилок на панелі адміністратора.

Модуль працює як зі стандартним оформленням замовлення, так і Simple. Якщо в магазині використовується нестандартна логіка доставки, оформлення або обробки замовлень, може знадобитися додаткова адаптація.

Склади, залишки тасамовивіз

YCP повинен розуміти, звідки може бути відвантажений товар і чи є самовивіз. У налаштуваннях модуля можна створити кілька складів, вказавши для кожного адресу, телефон, опис, розклад, часовий пояс та можливість самовивезення.

Загальний залишок товару OpenCart можна розподілити вручну між цими складами. Якщо магазин вже використовує сумісний модуль «Мультисклад + самовивіз», YCP може отримувати реальні склади та залишки з нього.

Власні точки самовивезення передаються складами. При цьому отримання зовнішніх пунктів видачі перевізників у поточній версії інтеграції не реалізовано: відповідний метод повертає порожній список.

Що відбувається із замовленням

Під часоформлення модуль спочатку перевіряє кошик та резервує доступні товари. Саме замовлення OpenCart створюється лише після того, як Яндекс підтвердить оформлення. Такий порядок знижує ризик появи на панелі неоплачених або незавершених замовлень.

Для нового, скасованого та доставленого замовлення адміністратор обирає відповідні статуси OpenCart. Повторні запити обробляються ідемпотентно: модуль не повинен повторно резервувати товар, створювати друге замовлення або дублювати той самий запис в історії статусів.

Що потрібно для підключення

Перед встановленням модуля необхідно переконатись, що магазин відповідає умовам Яндекса. За чинними вимогами YCP доступний інтернет-магазинам, які продають фізичнітовари. Продаж цифрових товарів, послуг, оптові та B2B-продажу поки що не підтримуються.

Для підключення потрібно:

1. Додати магазин в Яндекс Товари та передати товарний фід.
2. Надіслати в товарному фіді параметр is_checkout_enabled=true.
3. Подати заявку на підключення YCP та пройти реєстрацію магазину з боку Яндекса.
4. Встановити відповідну версію модуля YCP у OpenCart.
5. Налаштувати API-токени та передати Яндексу адресу API магазину.
6. Додати склади, самовивіз, вартість та терміни кур'єрської доставки.
7. Порівняти статуси YCP зі статусами замовленьOpenCart.
8. Перевірити з'єднання та провести тестове оформлення.

API магазину має бути доступний Яндексу за HTTPS. Для OpenCart 3 потрібно PHP 7.0 або вище, для OpenCart 2.3 — PHP 5.6 або вище.

Ідентифікатор пропозиції у товарному фіді повинен співпадати з product_id товару OpenCart. Якщо у товару не заповнено вагу або розміри, в налаштуваннях модуля можна встановити значення за замовчуванням. Поділ одного товару на окремі пропозиції щодо поєднань опцій модулем YCP не підтримується, тому структуру ідентифікаторів у фіді слід перевірити до підключення.

Що підготувати всередині магазину

Технічне підключення – лише одначастина запуску. До початку роботи варто перевірити, наскільки сама крамниця готова приймати замовлення з нового каналу.

Ціни та залишки повинні оновлюватися регулярно. Якщо покупець вибере товар, якого вже немає, або побачить при оформленні іншу ціну, замовлення може бути скасовано ще до підтвердження. Не менш важливими є повні характеристики, зрозумілі назви та якісні зображення: саме ці дані допомагають Яндексу зіставляти товари із запитами користувачів.

Менеджерам необхідно розуміти, де з'являються замовлення YCP та як вони мають оброблятися. Такі замовлення надходять до OpenCart і можуть включатися в загальну чергу на підтвердження, збирання та доставку. Бажано заздалегідь визначити відповідальних співробітників та перевірити, що обраністатуси замовлення правильно синхронізуються з YCP.

Кому підійде YCP

Інтеграція особливо цікава роздрібним магазинам з актуальним каталогом, зрозумілими залишками та налагодженою доставкою. Чим точніше передаються ціни, наявність, зображення та характеристики, тим простіше Яндексу зіставити пропозицію із запитом користувача, а покупцеві - ухвалити рішення.

YCP варто розглядати не як заміну сайту, контекстну рекламу або розміщення на маркетплейсах, а як ще один канал продажу. Магазин зберігає прямі відносини з покупцем, отримує замовлення у власній CMS та продовжує керувати асортиментом та обробкою замовлень у OpenCart.