datie – синхронизация WooCommerce с МойСклад

Описание

datie связывает магазин WooCommerce с МойСклад – облачным сервисом складского и торгового учёта, популярным в России и СНГ. Главный источник данных о каталоге – МойСклад: из него на сайт приходят товары с ценами, остатками, изображениями и описаниями, категории, бренды и метки. Заказы уходят обратно в МойСклад.

Плагин работает через JSON API 1.2 МойСклад по токену доступа. Всё происходит на стороне сайта: в самом МойСклад нужно только создать токен.

Каталог

  • Товары, модификации, комплекты и услуги.
  • Категории из групп товаров МойСклад или бренд, категории и метки из доп. полей.
  • Главное изображение и галерея в порядке МойСклад.
  • Тип цены и тип цены распродажи на выбор; цены в иностранной валюте пересчитываются по курсу МойСклад.
  • Остатки – общие или по одному складу, с учётом резерва или без.
  • Вес, габариты и выбранные доп. поля – как характеристики товара.
  • Ставки НДС сопоставляются с налоговыми классами WooCommerce.
  • Товары, пропавшие из МойСклад, уходят в черновики и возвращаются, когда появляются снова.

Заказы

  • Заказы магазина уходят в МойСклад через фоновую очередь; обращение к API не замедляет оформление заказа.
  • Покупатель находится по почте и, если включено, по телефону; пустые поля карточки в МойСклад заполняются из заказа.
  • Номер заказа из МойСклад или приставка для заказов сайта.
  • Доставка передаётся позицией услуги МойСклад – своей для каждого способа доставки.
  • Статусы в обе стороны; изменения, сделанные в МойСклад, возвращаются на сайт через вебхук.

Фоновая работа и диагностика

  • Полная синхронизация по расписанию и быстрая проверка изменений каждые несколько минут.
  • Работа идёт порциями через Action Scheduler и продолжается после обрывов.
  • Индикатор хода синхронизации на странице «Обзор».
  • Список «Требует внимания» собирает сбои, которым нужен человек: остановившуюся синхронизацию, заказ, не дошедший до МойСклад, артикул, уже занятый другим товаром.
  • Ошибки всегда пишутся в журнал WooCommerce; для разбора проблем можно включить подробный журнал.
  • «Здоровье сайта» проверяет токен доступа и вебхук заказов.

Язык интерфейса

Интерфейс на английском и русском. Русский перевод приходит с WordPress.org автоматически.

Внешние сервисы

Плагин работает с МойСклад – облачным сервисом складского и торгового учёта, который предоставляет ООО «Логнекс». Связать магазин WooCommerce с МойСклад – назначение плагина. Пока в настройках не указан токен доступа МойСклад, плагин никуда не обращается, и ни к каким другим сервисам он не обращается.

JSON API МойСклад (api.moysklad.ru)

Используется, чтобы получать каталог из МойСклад и передавать в него заказы магазина.

  • Каждый запрос содержит ваш токен доступа МойСклад.
  • Синхронизация каталога – по расписанию или при ручном запуске: плагин запрашивает товары, модификации, комплекты, услуги, группы товаров, цены, остатки, изображения и доп. поля. Данные магазина и покупателей не передаются.
  • Передача заказов – когда заказ создан или изменён на сайте: номер заказа, дата, позиции, цены, НДС, доставка, имя, почта, телефон и адрес покупателя, примечание покупателя и ссылка на заказ в админке магазина. Чтобы найти существующего покупателя, почта и, если включено, телефон передаются как поисковый запрос.
  • Передача статусов с сайта – если включена, при смене статуса заказа: новый статус заказа.
  • Приём статусов из МойСклад – если включён: плагин регистрирует вебхук на REST API вашего сайта с секретным ключом, и МойСклад присылает на него уведомления об изменении заказов.

Файловое хранилище МойСклад

Изображения товаров скачиваются по ссылкам, которые возвращает API МойСклад. Выполняется только запрос на скачивание; никакие данные магазина не передаются.

Веб-приложение МойСклад (online.moysklad.ru)

Плагин показывает ссылки на веб-приложение МойСклад, например «Вход в МойСклад» и «Посмотреть товар в МойСклад». Они открываются в браузере только по вашему клику; сам плагин туда ничего не отправляет.

Сервис предоставляет ООО «Логнекс»: оферта МойСклад (условия использования), политика конфиденциальности МойСклад. Документация API: dev.moysklad.ru.

datie – независимый плагин, не связанный с ООО «Логнекс» (МойСклад) и Automattic (WooCommerce).

Скриншоты

Установка

  1. Установите и активируйте WooCommerce.
  2. Установите datie на экране «Плагины» или загрузите папку datie в /wp-content/plugins/ и активируйте его.
  3. В МойСклад создайте токен доступа в разделе доступа по API. Надёжнее всего – отдельный пользователь с правами только на товары и заказы.
  4. В WordPress откройте МойСклад Настройки, вставьте токен и сохраните.
  5. Пройдите разделы настроек, затем запустите первую синхронизацию на странице МойСклад Обзор.

Если раньше вы пользовались плагином WooMS, datie подхватит его данные и свяжет уже существующие товары, а не создаст их заново. Перед этим сделайте резервную копию базы.

Часто задаваемые вопросы

Как подключить МойСклад к WooCommerce?

Установите datie, создайте токен доступа в МойСклад, вставьте его на странице настроек плагина и запустите первую синхронизацию. Обмен через CommerceML, выгрузка файлов и сторонние коннекторы не нужны.

Как выгрузить товары из МойСклад в WooCommerce?

Первая синхронизация загружает все товары с ценами, остатками, изображениями, категориями и характеристиками. Дальше каталог обновляется по выбранному расписанию.

Обновляются ли цены и остатки автоматически?

Да. Полная синхронизация идёт по расписанию, а быстрая проверка изменений – каждые несколько минут, так что цены и остатки на сайте следуют за МойСклад.

Передаются ли заказы в МойСклад?

Да. Каждый новый заказ магазина уходит в МойСклад с позициями, доставкой и покупателем, а статусы заказов могут передаваться в обе стороны.

Работают ли вариативные товары?

Да. Модификации МойСклад становятся вариациями WooCommerce; комплекты и услуги тоже поддерживаются.

Как загружать категории, бренды и метки из доп. поля МойСклад?

По умолчанию категории строятся из групп товаров МойСклад. Если группы у вас означают другое, например бренды, создайте в МойСклад доп. поле товара типа «Текст», например «Для сайта», выберите его в МойСклад Настройки Классификация, а у бренда, категорий и меток – источник «Из поля «Для сайта»». В каждой строке поля – тип и значения: brand: Chanel, category: Уход/Лицо, Макияж/Губы, tag: Новинки.

Несколько значений пишутся через запятую или каждое своей строкой; косая черта задаёт вложенную категорию. Бренд, категории и метки можно брать и каждое из своего доп. поля или из групп товаров.

Нужно ли что-то настраивать на стороне МойСклад?

Только токен доступа. Для приёма статусов через вебхук нужен платный тариф МойСклад.

Какие товары синхронизируются?

По умолчанию все товары. Можно синхронизировать только выбранные группы, пропускать товары без артикула или отмечать товары доп. полем-флажком МойСклад, чтобы они не загружались.

Как сопоставляются товары, которые уже есть в магазине?

По идентификатору МойСклад, сохранённому у товара, затем по артикулу (или по коду МойСклад, если так выбрано в настройках). Название и описание товара на сайте перезаписываются, только если вы это включили.

Что будет, если МойСклад недоступен?

Синхронизация останавливается с ошибкой и продолжается при следующем запуске. Из-за сбоя товары не скрываются, а заказы ждут в очереди.

Где журналы?

В WooCommerce Статус Журналы; каждая часть плагина пишет в свой источник. Сбои, требующие внимания, также видны на странице «Обзор» плагина.

Где получить помощь?

На форуме поддержки плагина или напрямую разработчику: почта hello@datie.ru, Telegram https://t.me/kinokentij

Отзывы

Нет отзывов об этом плагине.

Участники и разработчики

«datie – синхронизация WooCommerce с МойСклад» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Участники

«datie – синхронизация WooCommerce с МойСклад» переведён на 1 язык. Благодарим переводчиков за их работу.

Перевести «datie – синхронизация WooCommerce с МойСклад» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

1.0.2

  • Страницы плагина в синем цвете МойСклад.
  • Ссылка «Поддержка» ведёт на форум datie.
  • Понятнее формулировки в русском переводе.

1.0.1

  • Название плагина пишется строчными буквами: datie.
  • В описании появились ответы на частые вопросы.

1.0.0

  • Первый выпуск в каталоге WordPress.org.
  • Интерфейс на английском с русским переводом.
  • Заказы отправляются через фоновую очередь; номер заказа из МойСклад попадает уже в первое письмо покупателю.
  • Поиск покупателя по телефону; о дублях покупателей сообщается.
  • Ставки НДС из МойСклад, включая 22% и модификации.
  • Комплекты и услуги идут общим путём товаров; одно скрытие после полной синхронизации.
  • Защита от скрытия всего каталога во время сбоя МойСклад.
  • Выборка заказов работает и с HPOS, и с прежним хранением заказов.
  • После сбоя МойСклад обходы комплектов и услуг повторяются через 5 минут, а не на каждой загрузке страницы.
  • Новый интерфейс админки с индикатором хода синхронизации и списком «Требует внимания».
  • Ошибки пишутся в журнал всегда; подробный журнал – по желанию.