ERPLY конектор Magento 2

ERPLY КОННЕКТОР

ФУНКЦИЯ

Этот модуль представляет собой программный компонент, который добавляется в Magento для обеспечения интеграции с вашей учетной записью Erply и управления системы учета товаров. 

ОСОБЕННОСТИ

• Экспорт продуктов, обновления продуктов Magento
• Экспорт прайс-листов в Magento
• Импорт переводов категорий и товаров из Erply
• Экспорт категорий, групп товаров
• Импорт заказа в Erply, экспорт статуса заказа из Erply
• Маппинг способов оплаты
• Импорт информации клиента в erply
• Настройки импорта
• Журналы, Queue список
• Multi Website поддержка 
• Следующие переводы могут быть импортированны из Erply:
• Наименование товара
• Подробное и краткое описание (webfields)
• Название группы продуктов и услуг
• Название категории товаров

ТРЕБОВАНИЯ

• Система

Для установки модуля должно быть достаточно прав и доступ к файлам.

Коннектор должен иметь возможность связываться с Erply (должен быть подключен к Интернету, без ограничений брандмауэра)

• Magento

Magento 2 Open source

Версия 2.2.6 or below

Предыдущая версия Erply Connector не должна быть установлена(при необходимости удалите)

• PHP / модуль

Версия 7.1 or above.

PHP Curl модуль.

• Cron

Для запуска запланированного импорта / экспорта функция Magento cron должна быть правильно установлена и

настроена. Отсутствие cron означает отсутствие обмена данными.

• Composer

Должен быть установлен -  wazaari/monolog-mysql

УСТАНОВКА

• Подготовительные мероприятия

Необходимо сделать резервную копию!

При необходимости удалите предыдущую версию

• Процесс

К систаме magento подключить manager

“Choose file”, затем выберите “Upload”.

Выберите “Commit Changes”

• Дополнительные мероприятия

Вход и выход

Очистить caches

ВЕРСИЯ, ЖУРНАЛ ИЗМЕНЕНИЙ

• ВЕРСИЯ 0.1.7

Последнее обновление: 12.09.19

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

ГИД ПОЛЬЗОВАТЕЛЯ

ОБЩИЕ НАСТРОЙКИ

Scope: Global

Stores → Configuration → Devall 

• Включить ведение журнала

Devall → Log

В диагностических целях. Эти журналы могут быть полезны для персонала службы поддержки, который занимается устранением неполадок.

• Включить отправку сообщений об ошибках

В случае сбоя импорта (любого запланированного импорта) отправьте уведомление по электронной почте о сообщениях об ошибках рабочего процесса.

• Email

Получатель сообщений об ошибках.

• Шаблон

Marketing → Email templates → New template → Erply error сообщения об ошибке

Шаблон электронной почты для сообщения об ошибке. 

НАСТРОЙКИ УЧЕТНОЙ ЗАПИСИ

• Подключение Erply разрешено

Scope: Website

NO - all connection to Erply is disabled.

• Отключить отправку заказа

Scope: Website

YES - импорт заказов в Erply отключен.

• Код клиента

Scope: Global

Erply код клиента

• Имя пользователя

Scope: Global

Имя пользователя учетной записи Erply с правами администратора.

• Пароль

Scope: Global

Пароль учетной записи Erply

• Test соединение

Scope: Global

Проверьте соединение между Magento и Erply.

NB! В конфигурации по умолчанию варианты магазинов “Use system value” флажок следует снять.

НАСТРОЙКИ КАТЕГОРИИ

• Запрашивать только "web" категории

Scope: Global

YES - будут импортированы только группы Erply, где отмечена галочка «show in webshop».

• Категории URL присваивается всем магазина

Scope: Website

NO - URL категории будет отличаться для каждого магазина - и будет сгенерирован из названия категории магазина.

YES - URL категории будет одинаковым во всех магазина (сгенерирован из имени категории основного магазина - как определено в настройках локализации - default locale)

• Категории определены в Erply как

Scope: Website

• Не использовать Erply - отключить импорт категорий из Erply
• Группа - Категории будут импортированы из Erply “product and service groups”

NB! Если необходимо отключить какую-либо категорию - просто снимите галочку “Show in webshop” в Erply. Не удалять!

• Категория - Категории будут импортированы из Erply “product categories”
• Несколько категорий

Scope: Website

Возможность определить продукты к нескольким категориям в Magento.

Чтобы включить эту функцию, выполните следующие действия: 

• Создать текстовый параметр в Erply 
• Определить группу параметров для всех услуг, групп продуктов
• Добавить имя параметра в модуль Erply → Category settings → Multiple categories
• Найдите “product categories” ID или  “product and service groups” ID в Erply URL.

Напимер: https://s6.erply.com/363958/?lang=eng&section=prodgroup&edit=19 

В этом случае ID группы будет 19.

• Запишите (через запятую) в настройки продукта Erply

НАСТРОЙКИ ЛОКАЛИЗАЦИИ

• Locale маппинг

Scope: Global

Чтобы связать язык Erply с определенным магазиом Magento. Используется для продуктов, категорий, групп продуктов и услуг, локализацию мета автогенерации.

• По умолчанию locale

Scope: Global

Определите основной язык Erply. Настройки Erply → Configuration → Default language

НАСТРОЙКИ ПРОДУКТА

Поддерживаемые типы продуктов в Erply:

• Simple
• Matrix
• Bundle = Magento bundle, функционирует как группа
• Simple,  Non-stock товар или услуга = Magento virtual

• Запрос по "web" продуктам

Scope: Global

YES - будут импортироваться только товары, отмеченные галочкой “show in webshop” . 

Рекомендуемый вариант: NO 

• Набор атрибутов

Scope: Store view

Набор атрибутов, который будет использоваться в качестве шаблонов для записи продукта.

• Налоговый класс

Scope: Website

Отображение налогового класса продукта в Magento и сопоставление ставки НДС с Erply 

(Erply settings → Invoice settings → VAT rates).

При неправильном сопоставлении в Magento продукту будет присвоен налоговый класс -  None.

NB! Импортированной из Erply Net sales price

• URL продукта присвоен для каждого магазина

Scope: Website

NO - URL продукта будет отличаться для каждого магазина - и будет сгенерирован из названия продукта каждого магазина.

YES - URL продукта будет такой же для каждого магазина (и будет сгенерирован из названия продукта главного магазина - как определено в настройках в localization settings- default locale)

NB! Если название продукта изменится, URL также изменится.

• Meta auto-генерации

Scope: Website

Для автоматического создания метаинформации

• Meta title - из имени
• keywords- fиз имени
• description - из long описания. 

NB! Этот параметр не связан с настройкой Magento по умолчанию: Автоматическая генерация полей продукта.

Если вручную отредактировать мета в Magento, она будет перезаписана при следующем импорте продукта (если текущий продукт будет сохранен в Erply)

Если настраиваемый продукт будет создан в Erply или сохранен, мета будет создана также.

• Размеры Matrix продуктов

Scope: Store view

Свяжите child продукты с настраиваемым продуктом.

Devall - Matrix размеры  - атрибуты автоматически импортируются / удаляются из Erply.

Magento атрибут должен быть:

• Global
• Поддерживаются следующие типы атрибутов:
• Dropdown
• Multiple - в интерфейсе действует как dropdown список
• Text swatch 
• Visual swatch

NB! Цвет необходимо подбирать вручную в Magento

NB!! Для visual swatch и text swatch должен быть добавлен заранее одним параметром и имя в описание (ошибка Magento).

NB!! Erply вариации продукта, не связанные с каким-либо матричным продуктом - он не будет отправлен в Magento

• Атрибуты

Scope: Store view

Erply Атрибуты (в tab атрибутов продукта) сопоставляются с атрибутом продукта Magento.

Magento атрибут должен быть:

• Global
• Поддерживаются следующие типы атрибутов:
• Текстовое поле
• Long Атрибут

Scope: Store view

Для хранения строк длиной более 255 символов. 

Он есть не во всех аккаунтах Erply. Erply должен включить эту функцию.

Magento атрибут должен быть:

• Global
• Поддерживаются следующие типы атрибутов:
• Текстовое поле
• Параметры

Scope: Store view

Magento атрибуты сопоставлены с параметрами Erply. 

Для работы с параметрами вам сначала нужно определить "parameter groups" в бэкэнде Erply и связать их с группами продуктов. Каждая группа параметров определяет параметры для определенного типа продукта.

Magento атрибут должен быть:

• Global
• Текстовое полеd → Erply text or number parameter 
• Multiple select → Erply List choice parameter
• Yes / NO → Erply Yes / NO parameter
• Использовать цену из настроек продукта

Scope: Global

• Прайс-лист ID

Scope: Website

• Специальный Прайс-лист ID

Scope: Website

Прайс-лист ID из URL (например: pricelist&edit=2, ID будет 2).

• Склад ID

Scope: Store view

Erply склад ID (Inventory → Locations → Click on location → id из URL, например: section=warehouse&edit=1)

Если в Erply более 1 склада в Magento будет импортировано сопоставимое количество складов но не общиее.

НАСТРОЙКИ ПОЛЬЗОВАТЕЛЯ

Scope: Website

• Тип платежного адреса ID

Сопоставление платежного адреса клиента

Чтобы получить id: Settings → Customer registry settings → Address types → Нажмите на нужный тип адреса → получить ID от URL

• Тип адреса доставки ID

Сопоставление адреса доставки клиента.

Чтобы получить id: Settings → Customer registry settings → Address types → Нажмите на нужный тип адреса → получить ID от URL

• Отображение группы клиентов

Magento сопоставление группы клиентов с группой клиентов Erply.

сли ничего не определено, клиенты по умолчанию переходят в группу Erply Default..

ЗАКАЗАТЬ НАСТРОЙКИ

NB!! Только заказы в статусе processing автоматически отправляются в Erply.

• Тип заказа в Erply

Scope: Website

Настройки имеют следующие возможности порядока импорта :

• Order → Erply Order

NB! Номер заказа Erply появится только после подтверждения заказа 

• Cashinvoice → Erply Invoice, type: waybill
• Waybill → Erply Invoice, type: waybill 
• Invwaibill → Erply Invoice, type: invoice-waybill

• Подтвердите заказ в Erply

Scope: Website

YES - Erply заказ будет автоматически подтвержден в Erply

• Зарезервировать товары в Erply

Scope: Website

YES, товар будет зарезервирован в случайном порядке после создания и подтверждения заказа.

• Проверить статус заказа в Erply

Scope: Website

Запросить обновления статуса заказа в Erply.  

YES - Если статус заказа в Erply - “Complete”, в Magento будет создана отгрузка товара, а статус заказа будет изменен на “Complete”.

• Erply способ оплаты счета

Scope: Global

Способ оплаты Magento сопоставлен с типом оплаты Erply(Erply settings →  Invoice settings → Payment types) и способ оплаты (Erply settings → Invoice settings → Invoice payment methods)  

• Сопоставление складов 

Scope: Global

Сопоставление страны доставки (страны, в которую будет отправлен товар) со складом Erply. По умолчанию количество товара будет уменьшено по состоянию склада, указанного в настройках товара.

• Доставка с НДС для ID

Scope: Website

Размер ставки НДС из ставок НДС в Erply.

Erply settings → Invoice settings → VAT rates → Get ID из URL

Например: Если в Magento ставка НДС 20%, стоимость доставки включает налог, а в настройках модуля Erply идентификатор ставки НДС 9%.

При заказе Erply ставка НДС за доставку составит 9%.

Если поле идентификатора ставки НДС на доставку пусто, в Erply будет указана ставка НДС, как в Magento (если в Erply такая ставка создана, нет, ставка НДС будет 0)

ГРАФИК ОБНОВЛЕНИЯ

Scope: Global

• График обновлений

Crons может быть настроен для:

• Обновление продуктаe
• Обновление изображения продуктаe
• Обновление категории
• Обновление инвентуры (на основе метки времени в Erply)
• Полное обновление инвентуры
• Обновление клиентов
• Обновление прайс-листов

Прайс-лист + Специальный прайс-лист.

При каждом импорте специального прейскуранта b4 очищет все специальные цены после импорта новых цен.

• Обновления статуса заказов

Cron выражения: http://en.wikipedia.org/wiki/Cron

НАСТРОЙКИ ОЧЕРЕДНОСТИ

Scope: Global

• Loops per run

Loops для импорта единичного продукта

Рекомендуемые настройки: 2

• Записи для Loop

Количество товаров для loop.

Рекомендуемые настройкиg: 100

НАСТРОЙКИ ОЧИСТКИ

Scope: Global

• Время жизни записи журналов

Время жизни журналов в админке Erply(Devall → Log)

• Время жизни неактивных записей 

Время жизни неактивных элементов в журнале записей (Devall → Queue list)

• Удалить log file

Удалить файл журнала с сервера. Cron каждый день в 4 часа утра.

СПИСОК ОЧЕРЕДИ

Devall → Queue list 

Позволяет просматривать весь активный / неактивный импорт и вручную планировать импорт.

MATRIX РАЗМЕРЫ

Devall →Matrix dimensions

Список отображаемых размеров matrix.

ПРИМЕЧАНИЯ:

• Если продукт удален из Magento, а затем снова импортирован, склад не будет импортирован (ошибка временной метки Erply), решения:
• Измените инвентарь в Erply и сохраните
• Сделать полный импорт инвентуризации

• Для успешного импорта фотографий в Erply должны быть заполнены все поля с названием товара (для всех языков)

P.S Изображения должены быть установлены :scope Global