Синхронизация Opencart и Мой Склад

Внимание!
После 1 декабря 2023 года модуль (в случае если он был скачан и установлен до обновления 11.11.2023) может перестать работать из-за переезда API сервиса МойСклад на новый домен. Чтобы модуль продолжал работать необходимо обновить файлы модуля и сохранить после этого настройки модуля. Обновить файлы можно 3-мя способами:
1. Если никаких доработок модуля не выполнялось, то можно заново скачать архив с модулем на сайте и установить модуль по новой. Все файлы модуля обновятся автоматически.
2. Если выполнялись доработки модуля, то есть возможность установить отдельный мини-модуль (модификатор), который можно скачать на вкладке "Файлы". Он автоматически внесет в файлы модуля все необходимые изменения. 
3. Также можно внести изменения в файлы модуля вручную с помощью инструкции ниже.
В файлах admin/controller/extension/module/syncms.php и catalog/controller/extension/module/syncms.php необходимо:
1) Заменить online.moysklad.ru на api.moysklad.ru
2) Заменить "Content-Type: application/json" на "Content-Type: application/json", "Accept-Encoding: gzip"
3) Добавить после строки curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); строку curl_setopt($ch, CURLOPT_ENCODING, 'gzip');
После внесения изменений в файлы любым из способов выше сбросятся некоторые настройки модуля: "Склад" и "Организация" в разделе "Синхронизация заказов" и склады, выбранные в настройке "Выгружать остатки из".
После внесения изменений в файлы любым из способов выше нужно сохранить настройки модуля!
Также для обновления файлов можно обратиться к автору модуля (для этого потребуются доступы к админ-панели сайта и/или ftp)

Возможности модуля (краткое описание)

• Добавление категорий в Opencart
  
• Обновление категорий в Opencart
  
• Добавление товаров в Opencart
  
• Обновление товаров в Opencart
  
• Обновление остатков товаров в Opencart
  
• Обновление цен товаров в Opencart
  
• Удаление/обновление лишних товаров Opencart
  
• Добавление/обновление изображений у товаров в Opencart
  
• Обновление заказов в Opencart
  
• Добавление заказов в Мой Склад
  
• Обновление заказов в Моем Складе
  
• Добавление товаров в Мой Склад
• Добавление категорий в Мой Склад
• Выполнение всех вышеперечисленных действия автоматически через Cron (планировщик заданий)

Возможности модуля (подробное описание)

• Добавление категорий в Opencart - перенос категорий (групп) из Моего Склада в Opencart. Переносятся следующие данные категорий: Наименование, Родительская категория. При добавлении категорий можно включить заполнение следующих полей: URL категории (генерируется из наименования товара), Meta-title, Meta-description, Meta-keyword. Возможные виды связывания категорий: по Наименованиям, по ID из Моего Склада. При выборе связи по ID из Моего Склада категории добавленные не через модуль синхронизироваться не будут!
• Обновление категорий в Opencart - обновление данных у категорий в Opencart в соответствии с группами в Моем Складе. Обновляются следующие данные категорий: Наименование, Родительская категория, Meta-title, Meta-description, Meta-keyword.
• Добавление товаров в Opencart - перенос товаров (комплектов) из Моего Склада в Opencart. Есть возможность переносить следующие данные товаров: Наименование, Описание, Категория (Группа), Цена (можно выбрать цену в Моем Складе), Количество (можно выбрать Склад в Моем Складе), Артикул, Модель (Код товара), Вес, Производитель (нужно дополнительное поле в Моем Складе). При добавлении товаров можно включить заполнение следующих полей: URL товара (генерируется из наименования товара), Статус при отсутствии на складе, Вычитать со склада, Единица измерения веса, Meta-title, Meta-description, Meta-keyword. Возможные виды связывания товаров (Opencart - Мой Склад): Модель (Код товара) - Код, Модель (Код товара) - Внешний код, Модель (Код товара) - Артикул, Артикул - Артикул, Артикул - Код. Также товары можно дополнительно связывать по Наименованию. Из Моего Склада переносятся только Товары и Комплекты, Услуги не переносятся. Комплекты переносятся в Opencart как обычные товары.
• Обновление товаров в Opencart - обновление данных у товаров в Opencart в соответствии с товарами (комплектами) в Моем Складе. Есть возможность обновлять следующие данные товаров: Наименование, Описание, Категория (Группа), Артикул, Модель (Код товара), Вес, Производитель (нужно дополнительное поле в Моем Складе), Статус при отсутствии на складе, Вычитать со склада, Единица измерения веса, Meta-title, Meta-description, Meta-keyword.
• Обновление остатков товаров в Opencart - обновление остатков у товаров в Opencart в соответствии с остатками товаров (комплектов) в Моем Складе. Остатки из Моего Склада берутся с учетом резерва, то есть из поля Доступно. Остатки Комплектов вычисляются на основании остатков Компонентов (товаров входящих в Комплект). Есть возможность указать Склад в Моем Складе, из которого будут браться остатки товаров.
• Обновление цен товаров в Opencart - обновление цен у товаров в Opencart в соответствии с ценами товаров (комплектов) в Моем Складе. Есть возможность указать цену из Моего Склада, которая будет переноситься товарам в Opencart. Также есть возможность переносить и обновлять сразу несколько видов цен из Моего Склада для различных групп клиентов в Opencart (Отдельные цены для групп клиентов).
• Удаление/обновление лишних товаров Opencart -  удаление или обновление товаров в Opencart, которые не были найдены в Моем Складе (поиск осуществляется исходя из выбранного вида связывания товаров). Есть возможность выбрать действие, которое будет осуществляться с лишними товарами: Удалять/Обнулять остатки/Обнулять остатки и ставить статус "Нет в наличии".
  
• Добавление/обновление изображений у товаров в Opencart - перенос и обновление изображений у товаров Opencart в соответствии с изображениями товаров в Моем Складе. Синхронизируются все изображения товаров, а не только первые. Изображения скачиваются и хранятся в директории /image/catalog/demo/syncms. Есть возможность включить удаление изображений товаров в Opencart, если у соответствующих им товаров в Моем Складе изображения отсутствуют. Скачивание большого количества изображений на север может занять много времени. Файлам изображений присваиваются названия, состоящие из id товара в Opencart и порядкового номера изображения. Порядок изображений из Моего Склада также передается в Opencart (с помощью поля Порядок сортировки)
  
• Добавление/обновление атрибутов и опций у товаров в Opencart - перенос или обновление опций и атрибутов товаров в Opencart в соответствии с модификациями и дополнительными полями товаров в Моем Складе. Опциям товаров в Opencart соответствуют только модификации товаров в Моем Складе, при обновлении происходит обновление цен и остатков опций. Атрибутам могут соответствовать как модификации, в описании которых указано слово Атрибут так и дополнительные поля товаров, названия которых указаны в настройках модуля (Названия дополнительных полей с атрибутами). При обновлении происходит обновление значений атрибутов. Есть следующие дополнительные возможности: рассчитывать цену опции как разницу между ценой модификации и ценой товара и заносить в остатки товаров суммы остатков их опций. Добавленные опции не являются связанными, поэтому можно будет выбрать любое сочетание опций. Связывание опций и атрибутов с модификациями осуществляется только по наименованию.
• Обновление заказов в Opencart -  обновление статусов заказов в Opencart в соответствии со статусами заказов в Моем Складе. Если статус заказа из Моего Склада будет отсутствовать в Opencart, то он будет создан.
• Добавление заказов в Мой Склад - перенос заказов из Opencart в Мой Склад. Возможные виды связывания заказов: № заказа в Opencart - № заказа в Моем Складе, № заказа в Opencart - Комментарий заказа в Моем Складе. Если выбрана связь через комментарий заказа, то в комментарий заказа можно дописывать текст через пробел после номера заказа. Есть следующие возможности: 1) Выбрать организацию и склад, которые будут указаны в заказах в Моем Складе. 2) Указать префикс для номера заказа, который будет указан у заказов в Моем Складе. 3) Добавлять и обновлять только заказы, которые были добавлены за последние n дней (количество дней можно указать в настройках модуля). 4) Ставить товары в заказе в резерв. 5) Добавлять услугу доставки в заказ (если услуги с названием доставки не будет в Моем Складе, то она будет создана). 6) Проводить заказы. 7) Использовать оперативный режим (оперативный режим ускоряет добавление заказов в случае если заказы выгружаются регулярно в небольших количествах. Если в заказе Opencart  будут присутствовать товары, которые не будут найдены в Моем Складе (поиск осуществляется исходя из выбранного вида связывания товаров), то этот заказ не будет добавлен в Мой Склад.
• Обновление заказов в Моем Складе -  обновление статусов заказов в Моем Складе в соответствии со статусами заказов в Opencart. Если статус заказа из Opencart будет отсутствовать в Моем Складе, то он будет создан.
• Добавление товаров в Мой Склад - перенос товаров из Opencart в Мой Склад. Есть возможность переносить следующие данные товаров: Наименование, Описание, Категория (Группа), Цена (можно выбрать цену в Моем Складе), Количество (нужно указать внешний код поставщика, в результате переноса будет создана приемка с остатками товаров из Opencart, организация и склад будут взяты настроек модуля), Артикул, Код товара, Внешний код, Вес, Производитель (нужно дополнительное поле в Моем Складе), Изображения, Опции. Возможные виды связывания товаров (Opencart - Мой Склад): Модель (Код товара) - Код, Модель (Код товара) - Внешний код, Модель (Код товара) - Артикул, Артикул - Артикул, Артикул - Код. Также товары можно дополнительно связывать по Наименованию.
• Добавление категорий в Мой Склад  - перенос категорий из Opencart в Мой Склад. Переносятся следующие данные: наименование, родительская категория. Поиск категорий в Моем Складе осуществляется по наименованию категорий.
• Выполнение всех вышеперечисленных действия автоматически через Cron (планировщик заданий)

Информация о модуле

• Название модуля в Opencart: Синхронизация с Мой Склад [by Sa1det]
• Обмен данными происходит через API Моего Склада (JSON API 1.2)
• Модуль имеет открытый код
• После любых изменений настроек модуля необходимо выполнить их сохранение
• На вкладке Лог можно посмотреть подробную информацию о результатах выполнения каждой синхронизации (операции), при этом выводится только часть файла с логами (последний записи). Расположение файла с логами: catalog/controller/extension/module/syncms_log.txt

Ошибки

• При большом количестве сущностей: товаров, модификаций, заказов, категорий и т.д. или при скачивании большого количества изображений из-за долгого выполнения синхронизации может возникать ошибка 504 Gateway Time Out, если на хостинге есть ограничение на время выполнения скриптов. В таком случае необходимо обратиться в техподдержку хостинга с просьбой увеличить значение max_execution_time для php (максимальное время выполнения скрипта) или сделать это самостоятельно в панели управления хостингом (если есть такая возможность)
• При большом количестве сущностей: товаров, модификаций, заказов, категорий и т.д. из-за недостаточного объема выделенной на сервере памяти может возникать ошибка Fatal error: Allowed memory size of [доступнйы объем памяти] bytes exhausted (tried to allocate [память, которое не хватает] bytes). В таком случае необходимо обратиться в техподдержку хостинга с просьбой увеличить значение memory_limit для php (максимальная выделяемая память) или сделать это самостоятельно в панели управления хостингом (если есть такая возможность).
  
• Ошибка! В Моем Складе есть товары/категории дубликаты - данная ошибка возникает, когда в Моем Складе было обнаружено несколько товаров/категорий с одинаковыми значениями в полях, выбранных для связывания (наименование, код товара, внешний код, артикул и т.д.). После двоеточия выводятся товары/категории, которые являются дубликатами. Модуль не будет работать в случае, когда в Моем Складе есть товары или категории дубликаты, так как из-за дублей могут происходить обновления не тех товаров/категорий. Решением является установка уникальных значений полям, которые выбраны для связывания или выбор других полей для связывания
• Ошибка! В Opencart есть товары/категории дубликаты - данная ошибка возникает, когда в Opencart было обнаружено несколько товаров/категорий с одинаковыми значениями в полях, выбранных для связывания (наименование, код товара, внешний код, артикул и т.д.). После двоеточия выводятся товары/категории, которые являются дубликатами. Также данная ошибка может возникнуть в случае когда один товар входит в несколько категорий (для решения можно отключить обновление категорий или оставить у товара только одну категорию). Модуль не будет работать в случае, когда в Opencart есть товары или категории дубликаты, так как из-за дублей могут происходить обновления не тех товаров/категорий. Решением является установка уникальных значений полям, которые выбраны для связывания или выбор других полей для связывания

Установка
Установка данного модуля может осуществляться двумя способами (автоматически и вручную):

1. Через функцию "Установка расширений". Необходимо перейти Модули/Расширения -> Установка расширений, нажать на "Загрузить файл" и выбрать архив с модулем (архив с расширением ocmod.zip)
2. Перенести содержимое архива с модулем (папки admin и catalog) в корневую папку сайта

Обновление версии модуля
Обновление версии модуля осуществляется также как и установка: необходимо загрузить архив с новой версией модуля через Установщик расширений или перенести содержимое архива с новой версией модуля в корневую папку сайта. После обновления версии необходимо сохранить настройки модуля.
Первые шаги при работе с модулем

1. Ввод данных от Моего Склада (логин и пароль или токен доступа, который генерируется в настройках Моего Склада) на вкладке Настройки
2. Выбор настроек модуля (выбор вида связи товаров, выбор вида связи категорий, полей товаров для синхронизации, цены продажи, склада для выгрузки остатков, организации и склада в заказах и т.д.)
3. Выполнять синхронизацию можно: 1) вручную, нажимая на кнопки или 2) автоматически, добавив команды для планировщика Cron и задав время их выполнения.

Работа с Cron (автоматическое выполнение синхронизации)
1. Перейти на вкладку Cron в панели управления хостингом
2. Нажать "Добавить команду"
3. Вставить команду для крона из модуля
4. Выбрать интервал выполнения команды (рекомендуется не ставить выполнение большого количества команд в одно и то же время)
5. Сохранить команду
Повторить вышеперечисленные действия для всех нужных команд
Требования
Модуль работает на версиях: Opencart (OcStore) 2.3 - 3.0
Демонстрационный сайт
Перейти на сайт
Логин и пароль от Opencart:
demo
demo
Логин и пароль от Мой Склад:
admin@syncms
syncms_demo
Тип лицензии
На один домен и поддомены
Доработка
Есть возможность доработки модуля на платной основе, по поводу доработки можно обращаться в личные сообщения
Поддержка
По всем возникающим вопросам можно обращаться через личные сообщения или в теме обсуждения

Пікір Жазу

Сіздің атыңыз:


Сіздің пікір Назар аударыңыз: HTML қолдау көрсетілмейді! Пайдаланыңыз қарапайым мәтін!

Рейтингі Жаман           Жақсы

entry_captcha