Ecwid — облачная витрина, которую встраивают в любой сайт или соцсеть. Подключение к RetailCRM выполняется через приложение и авторизацию OAuth, после чего заказы уходят в CRM по webhooks, а каталог подтягивается из товаров Ecwid. Разберём порядок настройки.
Особенности Ecwid как SaaS
Ecwid (в новых версиях — Ecom by Lightspeed) отличается от коробочных CMS: у вас нет доступа к файлам и cron магазина. Поэтому обмен строится не на генерации файла на сервере, а на облачном API и уведомлениях.
- Авторизация — через OAuth-приложение, а не по статичному API-ключу магазина.
- Заказы — передаются в реальном времени через webhooks Ecwid.
- Каталог — читается через REST API Ecwid, а не через ICML-файл на диске.
Установка приложения
Подключение начинается с установки приложения-коннектора.
- В панели Ecwid откройте
Приложения → App Marketи найдите приложение RetailCRM (или установите коннектор из каталога интеграций RetailCRM). - Нажмите Установить и подтвердите запрашиваемые разрешения — доступ к заказам, покупателям и товарам.
- Приложение выполнит OAuth-авторизацию и свяжет магазин Ecwid с аккаунтом RetailCRM.
После установки в RetailCRM появится магазин с кодом site, соответствующим витрине Ecwid.
Авторизация и разрешения
OAuth-токен заменяет ручной ввод API-ключа. При установке приложение запрашивает набор прав (scopes), без которых обмен не заработает.
| Разрешение | Зачем нужно |
|---|---|
| read_orders / update_orders | Получать заказы и возвращать смену статуса |
| read_catalog | Читать товары и категории для каталога CRM |
| read_customers | Синхронизировать покупателей без дублей |
Синхронизация заказов через webhooks
Ecwid отправляет уведомление о каждом новом или изменённом заказе. RetailCRM ловит webhook и создаёт либо обновляет заказ с externalId, равным ID заказа Ecwid.
- Новый заказ на витрине — почти мгновенно появляется в CRM.
- Смена статуса в CRM — возвращается в Ecwid через API магазина.
- Данные покупателя сводятся по телефону и e-mail, чтобы не плодить карточки.
Проверить доставку webhooks можно в журнале приложения Ecwid — там видно, что события уходят и получают ответ 200. Если магазин работал до подключения, ранее оформленные заказы webhook не пришлёт: их при необходимости импортируют разово через API Ecwid, а не ждут автоматической подгрузки.
Каталог и сопоставление
Товары Ecwid читаются через API и раскладываются в каталоге RetailCRM. Отдельно сопоставьте служебные словари, иначе заказы будут приходить с пустыми полями.
- Способы оплаты Ecwid → типы оплаты CRM.
- Способы доставки Ecwid → типы доставки CRM.
- Статусы заказов витрины → статусы CRM в обе стороны.
Вариации товара (combinations) в Ecwid переносятся как торговые предложения — это позволяет вести остатки по каждому варианту. Цены и наличие подтягиваются из карточки товара Ecwid, поэтому редактировать их лучше на витрине, а не вручную в CRM, иначе при следующей синхронизации данные разойдутся.
Проверка подключения
После настройки выполните контрольный прогон.
| Шаг | Что проверить |
|---|---|
| Тестовый заказ | Появился в CRM с товаром и суммой |
| Смена статуса | Из CRM вернулась в Ecwid |
| Каталог | Товары и остатки видны в CRM |
| Webhooks | В логе Ecwid ответы 200 |
Если заказы не приходят, начните с журнала webhooks и статуса OAuth-токена — это две самые частые точки отказа.
Итог
Подключение Ecwid к RetailCRM проще, чем у коробочных CMS: нет файлов и cron, всё держится на приложении, OAuth и webhooks. Ключевые моменты — выдать приложению нужные разрешения, свести справочники оплат, доставок и статусов и проверить доставку уведомлений о заказах.
Мы подключаем Ecwid к RetailCRM под ключ, настраиваем двусторонний обмен заказами и статусами и убеждаемся, что ни один заказ не теряется по дороге.
Частые вопросы
Нужен ли доступ к серверу для подключения Ecwid?
Нет. Ecwid — облачная платформа, у неё нет файлов и cron на вашем хостинге. Обмен строится на приложении, OAuth и webhooks, вся периодическая работа идёт на стороне RetailCRM.
Как авторизуется интеграция?
Через OAuth: при установке приложения выдаётся токен с набором разрешений на заказы, товары и покупателей. Статичный API-ключ магазина не используется.
Как быстро заказ попадает в CRM?
Практически сразу. Ecwid отправляет webhook при оформлении заказа, и RetailCRM создаёт его почти в реальном времени.
Переносятся ли вариации товара?
Да. Комбинации (combinations) Ecwid выгружаются как торговые предложения внутри товара, что позволяет вести остатки по каждому варианту отдельно.
Почему заказы перестали приходить?
Чаще всего отозван доступ приложения и аннулирован OAuth-токен, либо webhooks не доходят. Проверьте статус приложения в Ecwid и журнал уведомлений.
Задваиваются ли покупатели?
Нет, если включено сведение по телефону и e-mail. RetailCRM ищет существующего клиента перед созданием новой карточки.
Можно ли подключить несколько витрин Ecwid?
Да, каждая витрина заводится как отдельный магазин с собственным кодом site в RetailCRM.
Поможем с настройкой и поддержкой RetailCRM
Поможем с настройкой, доработкой и поддержкой RetailCRM.