Yandex Commerce Protocol (YCP) для OpenCart: как принимать заказы из Алисы AI и поиска Яндекса

Покупатели всё чаще начинают выбор товара не с перехода в конкретный интернет-магазин, а с вопроса поисковой системе или ИИ-помощнику. Пользователь может попросить Алису AI подобрать товар с нужными характеристиками, сравнить несколько вариантов и сразу перейти к покупке. Для магазина это означает появление нового канала продаж, в котором путь от запроса до оформления заказа становится заметно короче.

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

Что такое Yandex Commerce Protocol

Yandex Commerce Protocol - стандарт интеграции интернет-магазинов с Алисой AI, Поиском Яндекса и рекомендательной лентой Яндекс Ритма. После подключения рядом с подходящими предложениями магазина может отображаться кнопка «Купить в 1 клик».

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

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

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

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

Как покупка выглядит для клиента

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

Дальнейший сценарий выглядит так:

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

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

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

Как YCP работает со стороны OpenCart

Для полноценной интеграции нужны две связанные, но разные части.

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

Яндекс должен заранее получить сведения о товарах: названия, ссылки, изображения, цены, наличие, характеристики и другие данные. Для этого магазин загружает фид в Яндекс Товары. Кнопка быстрой покупки может показываться только для переданных в фиде предложений.

Чтобы разрешить оформление через YCP, в товарных предложениях передаётся параметр is_checkout_enabled со значением true. Подготовить такой фид можно с помощью модуля LiveYML - экспорт в Яндекс.Маркет и Яндекс Товары для OpenCart 3 и 2.

2. Обмен данными о корзине и заказе через API

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

Эту часть выполняет модуль YCP для OpenCart. Он принимает защищённые запросы Яндекса, обращается к данным магазина и создаёт подтверждённый заказ в OpenCart.

Таким образом, товарный фид отвечает на вопрос «что продаёт магазин», а API-интеграция — «можно ли купить выбранный товар сейчас и как оформить заказ».

Возможности модуля YCP для OpenCart

Для подключения подготовлены отдельные версии модуля для OpenCart, ocStore и LiveStore 3 и для OpenCart и ocStore 2.3.

Модуль обеспечивает:

• защищённое подключение 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.