Каталог Маркетплейс

1. Установите модуль из Marketplace: «Marketplace ? Установленные решения ? Яндекс Еда: интеграция ритейла ? Установить».
   
2. При установке модуль создаёт свои таблицы, обработчики событий, агенты и правила адресов для API. Он также генерирует client_id и client_secret для Яндекса.
   
3. Откройте настройки модуля: «Настройки ? Настройки продукта ? Настройки модулей ? Яндекс Еда: интеграция ритейла». Страница настроек есть и в меню «Магазин ? Яндекс Еда».
   

• Каталог. Выберите инфоблоки каталога и нажмите «Применить» — появятся списки разделов и свойств. При необходимости ограничьте выгрузку разделами. Укажите, что передавать как идентификатор товара (ID, внешний код или свойство), тип цены, источник старой цены и НДС по умолчанию. Идентификатор товара не меняйте после запуска: Яндекс пересоздаст товары.
  
• Свойства товаров. Сопоставьте поля Яндекса со свойствами инфоблока. Обязательные поля отмечены звёздочкой. Заполните блок «Закон о платформенной экономике». Для весовых товаров укажите признак весового товара и квант.
  

На вкладке «Магазины» добавьте каждую точку. Для неё укажите placeId, согласованный с менеджером Яндекса, а также склад, тип цены и сайт.

• Яндекс Еда ? сайт. Передайте менеджеру Яндекса адрес сервера, client_id и client_secret — они собраны в блоке «Данные для менеджера» на вкладке «Основные». По возможности выделите для API отдельный поддомен или задайте префикс пути.
  
• Проверка IP. Включите её и добавьте в белый список диапазоны Яндекса с yandex.ru/ips.
  
• Сайт ? Яндекс Еда. Если менеджер согласовал отправку остатков и замен, включите push-обмен. Укажите адрес API, client_id и client_secret, выданные Яндексом.
  

• Заказы. Выберите тип плательщика и покупателя: один служебный пользователь или поиск по телефону клиента. Задайте статус нового заказа и правила оплаты, отмены и отгрузки.
  
• Свойства заказа. Укажите, в какие свойства заказа записывать данные клиента и доставки.
  
• Доставка и оплата. Сопоставьте схемы Яндекса со службами доставки, а типы оплаты CARD и CASH — с платёжными системами.
  
• Статусы. Задайте, какой статус Яндекса соответствует каждому статусу заказа на сайте, и наоборот.
  

Сохраните настройки.

1. Откройте «Магазин ? Яндекс Еда ? Инструменты обмена».
   
2. Нажмите «Проверить API модуля». Затем посмотрите «Диагностику каталога»: сколько товаров попадает в выгрузку и почему остальные отсеиваются.
   
3. В «Предпросмотре ответа» проверьте товары, цены и остатки в том виде, в каком их получит Яндекс.
   
4. Создайте тестовый заказ и убедитесь, что он появился в списке заказов сайта. Затем удалите его.
   
5. Если включён push-обмен, нажмите «Проверить получение токена», а для первичной синхронизации — «Отправить все остатки».
   
6. Сообщите менеджеру Яндекса, что интеграция готова к проверке в песочнице.
   

• Переведите агенты сайта на cron: от них зависит регулярная отправка остатков.
  
• Если сервер Apache не передаёт заголовок авторизации, добавьте в .htaccess строку SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1.
  
• Если на сайте включён проактивный фильтр, добавьте пути API в исключения.
  
• При ошибках смотрите «Журнал обмена». Уровень журнала «Все запросы» удобен на время запуска, потом переключите его на «Только ошибки».
  
• Заказы из Яндекс Еды со статусами Яндекса собраны на странице «Магазин ? Яндекс Еда ? Заказы Яндекс Еды». Там же можно вручную предложить клиенту замену товара.